🛠 Como funciona a integração com a John Deere
A integração com a John Deere traz para a upCampo o trabalho que as máquinas já registram sozinhas no Operations Center: quantos hectares cada talhão recebeu, em que dia, com qual máquina, em quanto tempo e com quanto de combustível. Em vez de alguém digitar a execução da ordem de serviço no fim do dia, a ordem se preenche com o que o pulverizador, o trator ou a colhedora gravaram no campo.
Este artigo mostra o caminho inteiro, da configuração ao resultado: como conectar a conta John Deere da fazenda, o que precisa estar amarrado entre os dois sistemas, como a upCampo descobre a qual ordem de serviço pertence cada operação da John Deere, o que aparece nas duas guias de execução da ordem e onde esse número termina — nos painéis de operações, produtividade e máquinas.
A configuração é feita uma vez, nesta ordem:
- Conectar a conta John Deere da fazenda e aprovar o acesso da upCampo.
- Ligar a fazenda à organização da John Deere, no cadastro da Fazenda.
- Amarrar cada talhão da upCampo ao talhão correspondente da John Deere.
- Amarrar cada tipo de atividade ao tipo de operação da John Deere.
- Escrever a Ide. Res. da ordem igual ao produto que o operador informa na John Deere.
Daí em diante é automático: a máquina trabalha, a upCampo acha a ordem de serviço e a área e o detalhe por máquina entram nela — e alimentam os painéis.
🧩 O que a integração traz — e o que ela não traz
A integração é de mão única: ela lê a John Deere e escreve na upCampo. Nada do que é digitado na upCampo volta para o Operations Center.
| Ela traz | Ela não traz |
|---|---|
| A área trabalhada em cada talhão, por dia | Não cria ordem de serviço — a ordem tem de existir antes |
| Máquina, horas, litros de diesel, velocidade, largura e taxa aplicada | Não baixa insumo do estoque nem lança custo de produto |
| O rendimento e a quantidade total aplicada ou colhida na operação | Não preenche o operador como funcionário da upCampo |
| Os fardos de algodão gerados pela colhedora | Não mexe em ordem de aplicação aérea |
1. Conectar a conta John Deere
Para ler as operações, a upCampo precisa que o próprio produtor autorize, na John Deere, o acesso aos dados da organização dele. Essa autorização é feita por um link de conexão:
- Peça o link à equipe da upCampo. Ele chega pelo WhatsApp, vale por 7 dias e pode ser usado uma vez só. Quem tem acesso ao cadastro da Fazenda também pode gerá-lo lá (veja o quadro abaixo).
- Abra o link e entre com a sua conta John Deere — a do Operations Center da fazenda, com o seu usuário e a sua senha. O login é feito no site da própria John Deere: a upCampo não vê a senha.
- Aprove o acesso da upCampo na tela que a John Deere mostra em seguida. Ao terminar, a página avisa que a conta foi conectada.
Organização "aguardando aprovação". Uma conta John Deere pode enxergar mais de uma organização. Se alguma delas aparecer como aguardando aprovação no Operations Center, falta um administrador daquela organização aprovar o acesso da upCampo dentro do Operations Center. Enquanto isso não acontece, os dados daquela organização não chegam — as demais seguem normalmente.
Conexão John Deere. No cadastro da
Fazenda, ao lado do campo
ID Jonh Deere (integração), o botão abre a janela
Conexão com a John Deere Operations Center. Ela mostra as contas John Deere já
conectadas da empresa, com as organizações de cada uma marcadas como liberada ou
aguardando aprovação no Operations Center, e tem o botão
Conectar conta John Deere, que gera o mesmo link de conexão — para abrir
(Abrir login da John Deere) ou copiar e mandar para quem tem o usuário John Deere da
fazenda. Depois de concluir a conexão, clique em Atualizar. Quem não tem acesso a esse
cadastro pede o link à equipe da upCampo.2. Ligar a fazenda à organização John Deere
Menu: Arquivo > Fazenda — campo ID Jonh Deere (integração)
Na John Deere, os talhões, as máquinas e as operações de um produtor ficam dentro de uma
organização. O campo ID Jonh Deere (integração) do cadastro da Fazenda diz
qual organização corresponde àquela fazenda — é ele que faz a upCampo buscar os talhões e as operações
certos. (O rótulo tem esse erro de grafia na tela.)
Na janela do botão Conexão John Deere, cada organização liberada tem o botão
Usar nesta filial, que preenche o campo sem precisar digitar o código; depois, é só
salvar a fazenda. Se preferir, a equipe da upCampo faz esse passo junto com a
conexão.
3. O talhão da upCampo é amarrado ao talhão da John Deere
Menu: Lavoura > Talhão — guia Integração
Os dois sistemas têm o mesmo talhão cadastrado, cada um com o seu código interno. A guia Integração do cadastro de Talhão é onde se diz que o talhão 08 – CAMPINAS da upCampo é o mesmo 08 da John Deere. Repita para cada talhão que vai receber operação da John Deere.
Na guia, o botão Integração Jonh Deere ▼ traz o que se usa no dia a dia:
| Opção | O que faz |
|---|---|
| Atualizar Opções | Busca na John Deere a lista atual de talhões da organização. É o primeiro passo quando um talhão novo foi criado lá. |
| Selecionar Talhão JD | Abre a lista de talhões da John Deere (nome, fazenda, tipo e última alteração). Ao escolher um, o ID, a descrição e o setor são preenchidos sozinhos. |
| Abrir ultima Operações JD / Abrir Todas Operações JD | Abrem a janela Resposta da John Deere com o que a John Deere devolve para aquele talhão, no formato técnico em que ela manda. Servem para confirmar que o vínculo responde; para interpretar o conteúdo, peça ajuda à equipe da upCampo. |
A lista da guia mostra o vínculo gravado: Descrição, Setor,
ID (o código do talhão na John Deere) e Tipo, que aqui é
Jonh Deere. A mesma guia atende a outras integrações — por isso o campo Tipo existe.
4. O tipo de atividade é amarrado ao tipo de operação
Menu: Operacional > Tipo Ordem Serviço/Atividade — guia Operação
A John Deere classifica todo trabalho de campo em quatro tipos. A upCampo trabalha com os tipos de atividade da fazenda — Aplicação de Defensivo, Gradagem, Plantio, Colheita. A guia Operação é o de‑para entre os dois:
| Tipo na John Deere | O que é |
|---|---|
Application | Aplicação — defensivo, fertilizante líquido, dessecação |
Seeding | Semeadura / plantio |
Harvest | Colheita |
Tillage | Preparo de solo — gradagem, subsolagem |
Esses quatro nomes são cadastrados uma vez em
Operacional > Operação, e a Descrição ali precisa ser exatamente o nome
que a John Deere usa (Application, Seeding, Harvest,
Tillage) — é por esse texto que os dois lados se reconhecem. Depois, em cada tipo de
atividade, a guia Operação recebe uma linha ligando aquele tipo à operação correspondente. O botão
Importação rápida/dinâmica cria essas linhas de uma vez.
A mesma linha tem o campo Equipamento, que reserva uma frota fixa para o que entrar por essa operação. Como a execução importada não traz a máquina que trabalhou — ela traz a área da operação inteira —, o costume é usar aí uma frota genérica, Integração John Deere, que marca na lista o que veio da integração e o que foi digitado por alguém.
Application.5. A Ide. Res. é o nome do produto na John Deere
Menu: Operacional > Identificação Res. (Sub tipo)
Ide. Res. é como o portal abrevia Identificação Resumida: o subtipo que diferencia uma ordem da outra dentro do mesmo tipo de atividade — 02 DESTRUICAO QUIMICA, FERT KCL, PLANTE E APLIQUE.
Essa é a chave fina da integração. No Operations Center, o operador lança a operação informando o produto aplicado; a John Deere grava esse nome junto da operação. A upCampo lê esse nome e procura a ordem de serviço com a mesma Ide. Res. — texto por texto.
Por isso a regra de campo é curta: o nome do produto na John Deere e a Ide. Res. da ordem precisam ser escritos igual. É assim que uma operação de 8 de setembro no talhão 08 encontra a ordem certa, e não a ordem de outra aplicação no mesmo talhão.
Duas exceções, que não dependem do nome:
- Plantio (
Seeding) — a ordem é encontrada se estiver marcada como ordem de plantio. - Colheita (
Harvest) — idem, se estiver marcada como ordem de colheita.
No preparo de solo, o nome usado é o tipo de preparo informado na John Deere.
🔎 Como a upCampo escolhe a ordem de serviço
De vinte em vinte minutos a upCampo pergunta à John Deere o que há de novo nos talhões amarrados — e a John Deere também avisa quando fecha uma operação. Para cada operação recebida, a busca da ordem obedece a esta lista:
| Condição | Detalhe |
|---|---|
| Mesmo talhão | O talhão amarrado no passo 3, dentro de uma safra ativa |
| Tipo de atividade compatível | Pelo de‑para do passo 4 |
| Mesma Ide. Res. | Ou ordem de plantio/colheita, nos dois casos do passo 5 |
| Ordem não finalizada | Ordem já finalizada não recebe mais área |
| Não pode ser aplicação aérea | Ordem marcada como aérea fica fora da integração |
| Data compatível | A ordem não pode estar programada para mais de 60 dias depois do fim da operação |
Se mais de uma ordem atende a tudo isso, ganha a de data prevista mais próxima do início da operação; persistindo o empate, a cadastrada por último.
6. O que chega na ordem de serviço
Menu: Operacional > Ordem de Serviço/Atividade
A operação encontrada vira registro em duas guias diferentes da ordem, com finalidades diferentes.
Guia 4 - Execução: a área que conta
É a guia normal de execução, a mesma que alguém preencheria à mão. A integração acrescenta ali uma linha por talhão e por dia, com:
| Coluna | O que vem da John Deere |
|---|---|
| Data | O dia do trabalho |
| Área | Os hectares trabalhados naquele talhão |
| Talhão | O talhão amarrado |
| Frota | A frota genérica da integração — não a máquina que trabalhou |
| Qtde Horas | Fica zerada: a hora real está na guia seguinte |
É essa área que soma no % Executado da ordem e na coluna Área exe. da lista — o número que o gerente olha para saber quanto da ordem já foi feito.
Guia 5 - Integração - Execução: máquina a máquina
Esta guia só aparece quando a fazenda tem integração com a John Deere. Ela mostra o detalhe que a guia de execução não carrega: uma linha por máquina e por dia.
| Coluna | O que mostra |
|---|---|
| Data | O dia de trabalho daquela máquina |
| Área | Os hectares que aquela máquina fez naquele dia |
| Qtde Horas | As horas de trabalho efetivo, em decimal |
| Talhão | O talhão |
| Frota | A máquina de verdade, reconhecida pelo chassi ou pelo número de série |
| ID Integração | O código da operação na John Deere |
Acima da lista, o rótulo Área e Qtde totaliza o que está sendo exibido. Junto dela vêm ainda, guardados no registro, o combustível gasto, a velocidade média, a largura de trabalho, a taxa alvo e a taxa aplicada — são esses números que alimentam o painel de máquinas.
Os botões da guia:
| Botão | O que faz |
|---|---|
| Recarregar | Relê a lista, sem ir à John Deere |
| Excluir | Apaga a linha selecionada |
| Abrir Operação na JD | Abre, em outra aba, aquela operação dentro do Operations Center — é o caminho para conferir o número na fonte |
| Forçar nova Integração | Manda a upCampo buscar de novo a operação da linha selecionada |
| Forçar nova Integração - Digitar id da operação | O mesmo, informando à mão o código da operação |
| Problema - Integração | Abre a tela de Problemas de integração sem sair da ordem |
⏱ Quanto tempo leva para aparecer
Depois de configurada, a integração roda sozinha — ninguém precisa apertar botão para ela buscar:
- A cada 20 minutos a upCampo pergunta à John Deere o que há de novo nos talhões amarrados.
- Quando a John Deere avisa que uma operação nova foi registrada, a upCampo busca na hora, sem esperar a rodada seguinte.
As duas guias da ordem, porém, não chegam necessariamente juntas:
| O que | De onde vem | Quando aparece |
|---|---|---|
Área total na guia 4 - Execução | O resumo da operação | Na primeira busca depois que a John Deere registra a operação |
Linhas por máquina e por dia na guia 5 - Integração - Execução | O arquivo de mapa da operação, com o trajeto ponto a ponto de cada máquina | Pode levar mais: a John Deere precisa gerar esse arquivo, e quando ele ainda não está pronto a upCampo tenta de novo numa próxima busca |
Por isso é normal ver a área já lançada na ordem e a guia de máquinas ainda vazia por um tempo. Se
precisar do detalhe antes, o Forçar nova Integração - Digitar id da operação, na guia
5 - Integração - Execução, pede a operação de novo.
⚠️ Quando a operação não encontra ordem
Menu: Arquivo > Problemas de integração
Operação que chega e não acha ordem não é perdida nem inventada: vira um registro nessa tela, com o talhão, o tipo de operação, o texto que veio no lugar da Ide. Res. e a data de início. São dois os motivos que a upCampo registra sozinha:
- Ordem não encontrada — faltou ordem em aberto com aquela Ide. Res. naquele talhão, ou uma das condições da lista acima não foi atendida.
- Área maior que mil hectares — a operação veio com área grande demais para ser verdade num talhão. Nesse caso a upCampo nem procura ordem: registra o problema e espera conferência.
O caminho normal de conserto é acertar o que estava errado — criar a ordem, corrigir a Ide. Res., amarrar o talhão — e usar o Forçar nova Integração na ordem, informando o código da operação.
📊 Onde o resultado aparece
O trabalho importado não fica só dentro da ordem. Ele aparece, no mesmo dia:
- Na lista de ordens de serviço — nas colunas Área exe. e % Executado, que passam a andar sozinhas.
- Nos relatórios de operações — qualquer relatório que some área executada por talhão, por Ide. Res. ou por período já conta com o que veio da integração.
- Nos painéis de TV da fazenda, que a upCampo monta sob medida e publica num endereço próprio.
São três painéis que vivem desses números:
| Painel | O que mostra |
|---|---|
| Resumo geral de operações | Quanto da safra já foi plantado, o avanço por fazenda e a lista das últimas operações — data, talhão, cultura, Ide. Res. com o número da ordem e os hectares. É a integração aparecendo quase em tempo real. |
| Produtividade | Por talhão e por variedade: hectares, fardos e arrobas por hectare. No algodão, os fardos também chegam pela John Deere, lidos da colhedora. |
| Resumo por máquina | Por máquina e por dia: hectares trabalhados, horas de trabalho, horas totais do dia, % do dia em
trabalho, eficiência em ha/h, velocidade média e litros por hora. É a guia
5 - Integração - Execução consolidada. |
- Execução sem digitação — a área sai da máquina, não da memória de quem lembrou de apontar.
- Avanço da ordem em tempo quase real — o % executado anda enquanto o pulverizador está no talhão.
- Custo por talhão mais fiel — a área executada é a que a máquina fez, e é sobre ela que o custo se distribui.
- Desempenho de máquina medido — horas, hectares por hora, litros por hora e velocidade, máquina a máquina, sem planilha.
- Erro visível — o que não casou fica numa tela só, com o motivo, em vez de sumir.
Quer entender o alcance da integração antes de ligar? Veja a página da integração John Deere no site da upCampo.
❓ Perguntas frequentes
Como conecto a minha conta John Deere à upCampo?
Peça à equipe da upCampo o link de conexão: ele chega pelo WhatsApp, vale por 7 dias e
serve para uma conexão só. Abra o link, entre com a sua conta John Deere — a do Operations
Center da fazenda — e aprove o acesso da upCampo. Quem tem acesso ao cadastro da Fazenda também gera o link
pelo botão Conexão John Deere, ao lado do campo ID Jonh Deere (integração).
Uma organização aparece "aguardando aprovação". O que falta?
Falta um administrador daquela organização aprovar o acesso da upCampo dentro do Operations Center da John Deere. A conexão da conta já foi feita; o que está pendente é a liberação daquela organização especificamente. Depois da aprovação, clique em Atualizar organizações na janela de conexão, ou avise a equipe da upCampo.
Por que a John Deere pediu a senha de novo, se eu já estava logado?
É de propósito. O link de conexão sempre pede usuário e senha, para garantir que quem aprova é o dono da conta John Deere da fazenda — e não uma outra conta que por acaso estava aberta no navegador, como a de um consultor ou de outro produtor.
De quanto em quanto tempo a área da John Deere aparece na upCampo?
A upCampo consulta a John Deere a cada 20 minutos, e a John Deere também avisa quando
uma operação nova é fechada. Na prática, o que a máquina fez de manhã já está na ordem de serviço antes
do almoço. Se precisar antes disso, use o Forçar nova Integração na guia
5 - Integração - Execução da ordem.
A operação aconteceu mas não entrou em nenhuma ordem. O que conferir?
Primeiro, a conexão: a conta John Deere da fazenda está conectada e a organização aparece como
liberada (veja a pergunta sobre "aguardando aprovação"). Na ordem: o talhão está amarrado à John Deere, a Ide. Res. está escrita igual ao produto
lançado lá, a ordem ainda não foi finalizada e não é de aplicação aérea. Depois, olhe
Arquivo > Problemas de integração: se a operação chegou e não achou ordem, ela está
registrada ali com o texto que veio — normalmente a diferença de escrita aparece na hora.
Por que a frota da execução aparece como "Integração" e não a máquina que trabalhou?
Porque a guia 4 - Execução registra a área da operação inteira, que pode ter
sido feita por três máquinas ao mesmo tempo — não haveria uma frota só para colocar ali. A máquina real
fica na guia 5 - Integração - Execução, com uma linha por máquina e por dia, e é de lá que
saem as horas e o combustível.
A área da ordem passou de 100%. Isso está errado?
Não necessariamente. A área executada é a que a máquina de fato percorreu, incluindo sobreposição de faixa e cabeceira repassada; a área total da ordem é a área cadastrada do talhão. Passar um pouco de 100% é comum e é justamente a informação que a integração dá de graça. Muito acima disso, vale conferir se a mesma operação não entrou duas vezes e se a área do talhão está atualizada.
Finalizei a ordem e a área parou de crescer. É isso mesmo?
É. Ordem finalizada não recebe mais execução da integração. Se a máquina voltou ao talhão depois de finalizar, o caminho é reabrir a ordem ou abrir a ordem seguinte, com a mesma Ide. Res., e usar o Forçar nova Integração com o código da operação.
Comprei uma máquina nova. O que preciso fazer?
Cadastrar a máquina na Frota / Bem feitoria com o chassi igual ao que a John Deere mostra. É por esse número que a upCampo reconhece de qual equipamento veio cada linha da guia de integração. Sem isso, a área continua entrando na ordem, mas o detalhe por máquina — e o painel de máquinas — ficam sem ela.
Criei um talhão novo na John Deere. Ele entra sozinho?
Não. Abra o talhão correspondente em Lavoura > Talhão, vá à guia Integração,
use Atualizar Opções para trazer a lista nova da John Deere e depois
Selecionar Talhão JD para escolher. Enquanto o vínculo não existir, nenhuma operação
daquele talhão é procurada.
Preciso lançar o insumo no estoque mesmo com a integração ligada?
Precisa. A integração traz o trabalho da máquina — área, horas, combustível —, não o consumo de produto. A baixa de estoque continua sendo feita pela ordem de serviço, do jeito de sempre.
O que a upCampo envia de volta para a John Deere?
Nada. A integração é de mão única: a upCampo lê as operações, as máquinas e os fardos e grava do lado dela. Nenhuma ordem de serviço, receita ou cadastro da upCampo é escrito no Operations Center.