1. Defina qual decisão a torre precisa apoiar
Escolha uma carteira, região ou operação de last mile e uma pergunta: quais entregas precisam de intervenção agora? A resposta deve trazer pedido, situação, origem, horário da última informação, responsável e ação proposta. A Zild pode conectar o acompanhamento de motoristas e entregas no ESL à coordenação do trabalho.
O piloto precisa distinguir uma entrega atrasada de uma entrega sem informação recente. São problemas diferentes: no primeiro, a operação trata o atraso; no segundo, deve verificar a fonte antes de afirmar o que aconteceu. Defina também quem pode consultar localização, destinatário e comprovante.
2. Estabeleça um contrato de eventos
Defina identificadores de entrega, coleta, rota, motorista ou parceiro e ocorrência, conforme os campos disponíveis. Guarde separadamente o horário do fato, o recebimento pela integração e a consulta. Preserve fuso horário, sistema de origem, tipo do evento, estado anterior e evidência associada.
A GS1 descreve eventos de visibilidade em dimensões como o que aconteceu, quando, onde e em qual contexto de negócio. Usamos essa organização como referência de desenho; isso não significa que o conector ESL ou a implantação Zild sejam certificados em EPCIS. Mapeie os campos reais da sua API antes de definir o contrato.
3. Torne a atualização observável
Tempo real depende da frequência e da qualidade dos dados produzidos pela operação conectada. Mostre a idade da informação e a última sincronização, em vez de apresentar uma posição antiga como atual. Quando a fonte ficar indisponível, mantenha o estado como desatualizado e acione o responsável pela integração.
Defina um limite de atualização por uso: acompanhar uma entrega em execução e conferir documentos no fechamento podem exigir frequências diferentes. Evite consultar um relatório completo a cada pergunta. Planeje filtros, volume de dados, periodicidade e tratamento de limites do provedor.
4. Trate duplicidades e eventos fora de ordem
Uma mesma ocorrência pode chegar novamente após falha de comunicação. Use a identidade do evento ou uma chave de negócio validada para impedir duplicação de tarefas e mensagens. Um evento recebido depois não é necessariamente o fato mais recente. Preserve a sequência da operação e encaminhe contradições para revisão.
Exemplo sintético: a entrega foi concluída às 14h10, mas uma tentativa anterior chega à integração às 14h20. O sistema não deve voltar automaticamente para tentativa de entrega. Registre os dois fatos, mantenha a conclusão se validada e identifique a atualização tardia. A regra precisa ser testada com a semântica real dos status do ESL.
5. Priorize e coordene as exceções
Defina categorias como destinatário ausente, endereço divergente, avaria, comprovante pendente e risco de prazo. Combine prazo contratado, impacto e tempo sem ação para organizar a fila. O agente reúne contexto e propõe encaminhamento; regras aprovadas determinam quem pode reprogramar, negociar ou encerrar uma ocorrência.
Motoristas e terceiros recebem apenas a informação necessária ao serviço. Uma mensagem do campo deve ser relacionada ao pedido e à evidência correspondente antes de atualizar o estado. Reentrega, devolução, aceite de avaria e compensação financeira não devem nascer de uma interpretação sem aprovação definida.
6. Configure o ESL para o escopo do piloto
O guia da Zild separa o token API de Data Export do token de usuário utilizado em ocorrências. Solicite os acessos necessários ao administrador ESL e configure a URL do ambiente. Salvar o conector não comprova que uma consulta ou alteração está autorizada; teste as ferramentas permitidas com dados de homologação.
Para relatórios, confira os templates e sua estrutura antes de montar filtros. Na funcionalidade documentada de cubagem de coleta, a atualização não altera o status e recusa coletas que já possuem cubagem; valores derivados são calculados pelo ESL. Não reutilize essa operação como mecanismo de sobrescrita ou como confirmação de entrega.
7. Construa um benchmark operacional
Reserve casos de entregas normais, eventos duplicados, informações atrasadas, devoluções e fontes indisponíveis. Compare a fila atual e a fila assistida sobre o mesmo conjunto, incluindo revisão humana. Registre tempo do evento até identificação, tempo até a primeira ação, resolução correta, reabertura e falso alerta.
Custo por ocorrência resolvida corretamente = custos de API, processamento e trabalho humano do período ÷ ocorrências com resolução validada. Inclua tentativas frustradas e trabalho de conferência. Compare também atualização dos dados: uma aparente melhora de velocidade pode esconder uso de informação antiga. Não compare carteiras de complexidade diferente sem explicitar essa limitação.
8. Use pesquisa sem transferir resultados indevidamente
O trabalho LaDe, de Wu e coautores, apresenta dados industriais de last mile com informações de encomendas e eventos de tarefas em diferentes cenários e cidades. Ele ilustra por que contexto temporal, localização e diversidade de situações importam na avaliação. A versão consultada é um preprint revisado em 2025.
O conjunto não representa a sua frota, a malha brasileira ou resultados da Zild. Use a pesquisa para orientar o desenho do teste, não para importar uma precisão ou economia prometida. Dados externos exigem verificação de licença e adequação; o critério de implantação deve vir de evidência autorizada da própria operação.
9. Expanda com critérios de saída
Documente antes da execução quais falhas bloqueiam o piloto: exposição entre clientes, mudança incorreta de status, ação duplicada ou ausência de responsável. Defina os limites de atualização e qualidade aceitos pelo gestor. A decisão pode ser ampliar uma rota, manter apenas consultas ou corrigir a integração e repetir.
Traga para a Zild uma amostra de eventos, o dicionário de status, os responsáveis pelas exceções e o escopo de acesso ao ESL. O desenho conecta agentes, ferramentas e pessoas para transformar visibilidade em ação, com rastreabilidade até a resolução.
Referências de dados e pesquisa
- GS1 — EPCIS visibility events Consultada em
- Wu et al. — LaDe, arXiv:2306.10675v3 (2025) Consultada em
Conecte uma exceção da sua operação
Reúna estas informações para desenhar o escopo com a Zild. Na conversa, avaliamos integrações, responsáveis e como medir o resultado.
- Um embarque ou entrega com uma exceção resolvida
- Os eventos e sistemas que mostram o andamento
- O responsável e o prazo para a próxima ação
Descreva o processo no formulário; amostras e documentos podem ser preparados depois, sem dados confidenciais.
O formulário abre com o título deste guia. Você pode editar tudo antes de enviar.