2M Designers

Integração

Porque é que os dados de GPS e da contabilidade não batem certo

A plataforma de rastreamento diz que o veículo fez 214 entregas no mês passado. A faturação diz 209. Os dois sistemas estão a funcionar bem. A diferença é real, explica-se e quase nunca é um erro de nenhum deles.

Por 2M Designers · 5 min de leitura · Publicado a

Atualizado a · Política editorial

Esta conversa acontece em todas as empresas que usam mais do que um sistema operacional. As finanças apresentam um número, as operações outro, e a reunião gasta quarenta minutos a decidir qual está errado antes de alguém fazer a pergunta melhor: o que é que cada sistema está exatamente a contar?

Na nossa experiência, a resposta é normalmente que estão a contar coisas diferentes, e bem.

Causa um: a fronteira está definida de forma diferente

O que é uma entrega concluída?

  • Para a plataforma de rastreamento, pode ser: o veículo entrou na zona do cliente e ficou lá mais de três minutos.
  • Para a app do motorista, pode ser: o motorista carregou em «Entregue» e recolheu uma assinatura.
  • Para o sistema de faturação, pode ser: foi recebido um comprovativo de entrega e associado a uma linha de encomenda.

Um veículo que chegou, esperou e saiu sem descarregar porque o cais do cliente estava cheio cumpre a primeira definição e nenhuma das outras. Isso não é um erro de dados. São três equipas a responder a três perguntas diferentes com a mesma palavra.

A correção não é técnica. Acordem uma definição por indicador, escrevam-na e façam cada relatório indicar que definição usa. A maioria destas discussões desaparece assim que as definições ficam alinhadas.

Causa dois: fusos horários e o limite do dia

As plataformas de rastreamento guardam normalmente as horas em UTC, porque os dispositivos comunicam de onde quer que estejam. Os sistemas de contabilidade trabalham normalmente na hora local, porque é isso que significa um dia comercial. Uma entrega concluída às 02:30 hora local pode cair legitimamente em dias diferentes nos dois sistemas.

Num relatório de fim de mês, isto só afeta os dias de fronteira, e é exatamente por isso que é difícil de detetar: a diferença é pequena, muda de sítio e nunca se repete quando a procuramos.

Uma armadilha relacionada que convém conhecer

As definições de idioma podem reescrever os numerais, e não apenas os formatos. Uma aplicação em árabe apresenta uma data como ٢٠٢٦-٠٨-٢١, o que está certo para o leitor e é ilegível para um servidor que espera uma data ISO. Se esse texto chegar a uma API, o pedido falha em silêncio e devolve vazio em vez de dar erro, o que aparece como relatórios que vêm misteriosamente vazios para alguns utilizadores e não para outros.

Causa três: uma sincronização falhou e ninguém foi avisado

É esta que custa mesmo dinheiro.

As integrações costumam ser feitas para o caminho feliz. O sistema A envia para o sistema B, o B aceita, todos ficam satisfeitos. Depois o B está em manutenção durante onze minutos, quarenta e três registos não são enviados e a integração (sem repetições, sem fila e sem alertas) passa ao lote seguinte.

Nada parece avariado. Os dois sistemas estão a funcionar. A diferença é descoberta semanas depois, numa reconciliação, quando já ninguém consegue reconstruir que registos se perderam nem reproduzir as condições.

O que uma integração robusta realmente precisa

  • Repetições com intervalo crescente. As falhas temporárias são o caso comum, e uma nova tentativa segundos depois normalmente resulta.
  • Idempotência. Se uma repetição passar duas vezes, o sistema recetor tem de a reconhecer como o mesmo registo em vez de criar um duplicado, senão um problema de registos perdidos passa a ser um problema de faturação em dobro.
  • Uma fila de mensagens rejeitadas. Os registos que não podem ser processados após as repetições vão para um sítio visível, e não para um ficheiro de log que ninguém lê.
  • Alertas sobre a fila, e não sobre o erro. Alguém deve ser avisado de que há quarenta e três registos parados, no momento em que ficam parados.
  • A reconciliação como funcionalidade. Uma tarefa agendada que compara o número de registos entre sistemas e reporta desvios é pouco vistosa e apanha tudo o que as outras quatro deixam escapar.

Nada disto é difícil. É simplesmente a parte do trabalho de integração que se corta quando o projeto é definido como «ligar estes dois sistemas» em vez de «manter estes dois sistemas de acordo».

Como conduzir a investigação

Da próxima vez que os números não baterem certo, resista ao instinto de procurar o errado. Em vez disso:

  • Peça aos dois sistemas os registos de detalhe, e não os totais. Os totais escondem tudo.
  • Compare os conjuntos e não as contagens. Quer os registos concretos que existem num e faltam no outro.
  • Veja primeiro as horas desses registos. Se se concentram nos limites do dia, aponta para fusos horários; se se concentram numa janela estreita, aponta para uma sincronização falhada.
  • Se estiverem dispersos sem padrão, tem uma diferença de definição. Veja como cada sistema decide que o registo está concluído.

Esta sequência resolve a maioria destes casos numa tarde, e normalmente termina com uma definição escrita e não com código alterado.

Pontos principais

  • Dois sistemas em desacordo são, normalmente, duas respostas certas a duas perguntas diferentes.
  • Acordem uma definição escrita por indicador e façam cada relatório indicar qual usa.
  • As diferenças de fuso horário só aparecem nos limites do dia, e por isso são difíceis de reproduzir.
  • As sincronizações falhadas são a causa cara: crie repetições, idempotência, fila de rejeitados e alertas, ou vai descobrir na reconciliação.
  • Investigue comparando conjuntos de registos e não totais: os totais escondem o padrão que identifica a causa.

Referências técnicas

Dúvidas ou uma correção? Contacte a equipa da 2M. Os exemplos explicam um método; os resultados dependem da sua operação e configuração.

Começar

Fale sobre isto com a nossa equipa

Diga-nos o que é manual, invisível ou lhe custa dinheiro hoje. Daremos uma resposta direta sobre o que é preciso para resolver, mesmo quando a resposta é que não precisa de nós.

01

Consulta gratuita

Sem obrigação nem compromissos escondidos.

02

Âmbito definido

Módulos, integrações e limites da entrega.

03

Resposta clara

Uma resposta útil no prazo de um dia útil.

Uma primeira mensagem útil inclui

  • O seu processo manual atual
  • Utilizadores, filiais, veículos ou campus
  • O resultado que precisa do sistema

Enviar um pedido

Os campos marcados com * são obrigatórios.

Utilizamos estes dados apenas para responder ao seu pedido. Leia a nossa Política de Privacidade.