A primeira pergunta que a TI faz quando o assunto é sistema de logística não é sobre funcionalidade. É: "integra com o nosso ERP?" E a pergunta faz sentido, porque a alternativa é digitação dobrada — o mesmo pedido lançado duas vezes, com duas chances de erro e nenhuma garantia de que os dois números vão bater.
Este artigo explica como essa conversa funciona na prática e o que costuma dar errado.
O que deve trafegar, e em qual direção
Integração não é "jogar tudo de um lado para o outro". É definir quais informações são autoridade de cada sistema.
Do ERP para a logística:
- Pedido de venda, com cliente, produto, quantidade e local de entrega
- Cadastro de clientes, filiais e transportadoras
- Nota fiscal emitida
Da logística para o ERP:
- Carga criada e vinculada aos pedidos
- Confirmação de embarque e de entrega
- Custo de frete apurado, para provisão e pagamento
- Documento de transporte conciliado
A regra prática: o ERP é dono do comercial e do fiscal; o sistema logístico é dono da execução. Quando essa fronteira está clara, a integração fica simples. Quando os dois tentam ser donos da mesma informação, o projeto trava.
Conector pronto x integração sob medida
Se o seu ERP é um dos grandes do mercado — SAP ou TOTVS Protheus, por exemplo —, existe caminho já percorrido. O fluxo de criar carga, cancelar, enviar entregas e publicar o custo do frete costuma estar mapeado, e o projeto vira configuração em vez de desenvolvimento.
Isso muda o prazo de forma relevante. Integração que precisa ser desenhada do zero envolve levantamento, homologação e rodadas de teste com o time de TI do cliente. Integração com conector pronto começa a trocar dados em semanas.
Vale perguntar isso cedo na conversa com o fornecedor — e pedir para ver o que exatamente já está pronto, porque "integra com SAP" pode significar muita coisa.
Quando não há conector pronto
A maior parte das operações tem algum sistema que não está na lista. Para esses casos, três caminhos, do mais simples ao mais robusto:
Importação por planilha. Subir pedidos, notas e cargas em lote. Não é elegante, mas resolve volume grande sem projeto de TI, e costuma ser o primeiro passo enquanto a integração definitiva não sai.
Webhook. O sistema externo envia um evento quando algo acontece — um pedido criado, uma nota emitida — e a logística reage. É leve e não exige que os dois lados estejam online ao mesmo tempo.
API. Consulta e escrita sob demanda, para quando o fluxo precisa ser síncrono.
O ponto de atenção aqui é segurança. Um endpoint que recebe dados de fora precisa de autenticação de verdade: chave de API para identificar quem está chamando, e assinatura do conteúdo para garantir que a mensagem não foi alterada no caminho. Integração sem isso é porta aberta.
Os erros que travam projetos
Cadastro divergente. É a causa número um. Se o cliente tem um código no ERP e outro na logística, nada bate. Antes de integrar fluxo, é preciso decidir qual sistema manda no cadastro e alinhar os identificadores.
Integrar tudo de uma vez. Projeto que tenta sincronizar dez entidades no primeiro ciclo não entra em produção. Comece pelo pedido de venda, que é o que destrava a criação da carga, e vá somando.
Não tratar o erro. Toda integração falha em algum momento — rede, indisponibilidade, dado inválido. O que separa uma integração confiável de uma dor de cabeça é ter monitor de integração: onde ver o que falhou, por quê, e reprocessar sem abrir chamado.
Esquecer a operação. Integração é projeto de TI, mas quem sente o resultado é a expedição. Se o pedido chega com o local de entrega errado, o problema aparece no pátio, não no servidor.
E a nota fiscal em papel?
Nem tudo chega por integração. Documento de fornecedor, canhoto, comprovante — muita coisa ainda chega como imagem ou PDF.
Leitura automática por OCR resolve boa parte: o sistema extrai os campos do documento e valida contra o que era esperado, em vez de alguém digitar. É integração também, só que com o mundo de fora.
Conclusão
Integração bem feita não é a que troca mais dados — é a que deixa claro quem é dono de qual informação, começa pequena, trata erro de forma visível e tem um caminho para o que não tem conector pronto.
No SafraControl, as integrações incluem conector pronto para SAP e TOTVS Protheus, leitura de documentos por OCR, webhook de entrada autenticado por chave de API e assinatura, e importação em lote por planilha — com monitor para acompanhar o que passou e o que falhou.