{"id":294,"date":"2026-07-31T09:42:37","date_gmt":"2026-07-31T12:42:37","guid":{"rendered":"https:\/\/growthlog.com.br\/conteudo\/api-webhook-polling-logistica\/"},"modified":"2026-10-01T00:38:10","modified_gmt":"2026-10-01T03:38:10","slug":"api-webhook-polling-logistica","status":"publish","type":"post","link":"https:\/\/growthlog.com.br\/conteudo\/api-webhook-polling-logistica\/","title":{"rendered":"API, webhook e polling: como sistemas de log\u00edstica conversam de verdade"},"content":{"rendered":"

Pergunte a qualquer fornecedor de sistema se ele integra com o seu. A resposta vem r\u00e1pida: “temos API”. A frase virou selo de qualidade no mercado de log\u00edstica, mas sozinha n\u00e3o diz quase nada.<\/p>\n

“Ter API” pode significar uma integra\u00e7\u00e3o de verdade, que atualiza status em segundos, ou um PDF de documenta\u00e7\u00e3o que ningu\u00e9m nunca testou. Para o gestor de transportadora, a diferen\u00e7a entre uma coisa e outra costuma aparecer depois do contrato assinado, quando trocar de fornecedor j\u00e1 \u00e9 caro.<\/p>\n

Este artigo explica, sem uma linha de c\u00f3digo, como sistemas de log\u00edstica conversam de verdade: API, polling, webhook, tempo real e lote. O objetivo \u00e9 voc\u00ea sair de qualquer reuni\u00e3o de integra\u00e7\u00e3o sabendo o que perguntar e reconhecendo resposta evasiva na hora.<\/p>\n

API \u00e9 o balc\u00e3o: quem precisa do dado vai l\u00e1 e pede<\/h2>\n

Uma API (interface de programa\u00e7\u00e3o de aplica\u00e7\u00f5es) \u00e9 o balc\u00e3o de atendimento de um sistema. Outro sistema chega, se identifica e faz um pedido objetivo: “me d\u00ea o status do conhecimento 4581” ou “crie uma coleta para amanh\u00e3 \u00e0s 8h”. O balc\u00e3o responde na hora, num formato padronizado que m\u00e1quinas entendem.<\/p>\n

O padr\u00e3o mais comum hoje \u00e9 a API REST, que funciona sobre a mesma infraestrutura da web. Cada tipo de informa\u00e7\u00e3o tem um endere\u00e7o pr\u00f3prio (o endpoint), e quem chama precisa se identificar com uma credencial, em geral um token de autentica\u00e7\u00e3o. Nada disso \u00e9 ex\u00f3tico: \u00e9 o mesmo mecanismo que o aplicativo do seu banco usa para falar com o servidor do banco.<\/p>\n

API \u00e9 excelente para dois movimentos: consultar dados quando voc\u00ea precisa deles e criar registros no outro sistema (uma ordem de coleta, um agendamento de doca, uma fatura). O ponto fraco \u00e9 outro: a API n\u00e3o avisa nada por conta pr\u00f3pria. Ela s\u00f3 responde quando algu\u00e9m pergunta, e \u00e9 dessa limita\u00e7\u00e3o que nascem os dois modelos seguintes.<\/p>\n

Polling: ligar de meia em meia hora perguntando se chegou<\/h2>\n

Polling \u00e9 usar o balc\u00e3o no modo insistente. Como a API n\u00e3o avisa, o sistema interessado fica perguntando em intervalos fixos: a cada 30 minutos, “essa entrega j\u00e1 foi baixada?”. Na maioria das vezes a resposta \u00e9 “ainda n\u00e3o”, e a pergunta se repete at\u00e9 o fim dos tempos.<\/p>\n

\u00c9 o equivalente digital do cliente que liga na sua opera\u00e7\u00e3o de meia em meia hora perguntando se a carga chegou. Funciona, no sentido de que a informa\u00e7\u00e3o uma hora aparece. Mas atrasa o dado (o evento pode acontecer um segundo depois da \u00faltima consulta e vai esperar o ciclo inteiro) e sobrecarrega os dois lados com milhares de consultas que voltam vazias.<\/p>\n

Voc\u00ea j\u00e1 viu polling mal calibrado sem saber o nome: \u00e9 aquele portal de rastreamento em que o status da entrega s\u00f3 atualiza de hora em hora. O canhoto foi assinado \u00e0s 9h04 e o embarcador s\u00f3 enxerga \u00e0s 10h. Isso n\u00e3o \u00e9 limita\u00e7\u00e3o da tecnologia, \u00e9 escolha (ou pregui\u00e7a) de quem montou a integra\u00e7\u00e3o.<\/p>\n

Webhook: aconteceu o evento, o sistema avisa na hora<\/h2>\n

O webhook inverte a l\u00f3gica. Em vez de perguntar o tempo todo, o sistema interessado se inscreve para receber avisos: “quando essa entrega for baixada, me notifique neste endere\u00e7o”. No instante em que o evento acontece, o sistema de origem dispara o aviso sozinho, para todos os inscritos.<\/p>\n

\u00c9 o motorista disciplinado que liga para a torre assim que termina a descarga, sem esperar ningu\u00e9m cobrar. \u00c9 por webhook que a entrega realizada aparece no sistema do embarcador em segundos, e n\u00e3o no pr\u00f3ximo ciclo de consulta. Para eventos que importam (entrega, ocorr\u00eancia, cancelamento, chegada ao cliente), webhook \u00e9 o padr\u00e3o de quem leva integra\u00e7\u00e3o a s\u00e9rio.<\/p>\n

H\u00e1 um detalhe t\u00e9cnico que o gestor precisa conhecer: e se o sistema de destino estiver fora do ar na hora do aviso? Fornecedor maduro guarda o evento e tenta entregar de novo (a retentativa, com intervalos crescentes). Fornecedor amador dispara uma vez, falha em sil\u00eancio, e a informa\u00e7\u00e3o some sem deixar rastro.<\/p>\n

Tempo real e lote convivem: o lugar do EDI<\/h2>\n

Nem toda troca de dados precisa ser instant\u00e2nea. O EDI cl\u00e1ssico da log\u00edstica brasileira, com arquivos NOTFIS, OCOREN e CONEMB, \u00e9 integra\u00e7\u00e3o em lote: os documentos acumulam e s\u00e3o transmitidos em blocos, em hor\u00e1rios combinados. Esse mundo tem regras pr\u00f3prias, que detalhamos no guia sobre EDI log\u00edstico<\/a>.<\/p>\n

Lote resolve bem o que \u00e9 volume e concilia\u00e7\u00e3o: o faturamento do dia, o espelho de conhecimentos emitidos, a presta\u00e7\u00e3o de contas semanal. Tempo real resolve o que \u00e9 decis\u00e3o: a ocorr\u00eancia na rota, a entrega baixada, o ve\u00edculo parado h\u00e1 40 minutos. Os dois convivem na mesma opera\u00e7\u00e3o, e muitos embarcadores grandes ainda exigem EDI como condi\u00e7\u00e3o de contrato, como mostramos no artigo sobre integra\u00e7\u00e3o com embarcador<\/a>.<\/p>\n

O erro, portanto, n\u00e3o \u00e9 usar lote. O erro \u00e9 usar lote para o que precisava de evento: descobrir \u00e0s 18h, no arquivo do dia, uma ocorr\u00eancia que aconteceu \u00e0s 10h e que \u00e0s 10h30 ainda tinha solu\u00e7\u00e3o.<\/p>\n

O que isso muda no neg\u00f3cio, n\u00e3o na TI<\/h2>\n

Integra\u00e7\u00e3o parece assunto de tecnologia at\u00e9 voc\u00ea medir onde o dinheiro vaza sem ela. Tr\u00eas efeitos pr\u00e1ticos de uma conversa bem feita entre sistemas:<\/p>\n