Um app de entrega offline guarda cada registro no aparelho e envia quando o sinal volta. Para a entrega não ser registrada duas vezes, cada registro precisa de uma identidade única e o servidor precisa reconhecê-la.
Como funciona um app de entrega offline e como evitar que a entrega seja registrada duas vezes? A resposta está em três pontos: fila local, envio único e conferência.
O que acontece quando o sinal some
O motorista chega ao cliente, colhe foto e assinatura e confirma. Sem sinal, o app não pode depender do servidor para concluir esse passo.
Por isso o registro fica numa fila local no aparelho, com data, hora e itens conferidos. Quando a conexão volta, o app envia o que está na fila, na ordem.
Por que a duplicidade acontece
O problema costuma aparecer na volta do sinal. O app envia, a conexão cai antes da resposta, e ele não sabe se o servidor recebeu. Então envia de novo.
Sem controle, o servidor trata os dois envios como entregas diferentes. Outra causa comum é o motorista tocar duas vezes em "confirmar" porque a tela demorou.
Três regras para o envio único
- Identificador na origem. O app gera um código único para cada registro assim que ele é criado, ainda offline.
- Servidor que reconhece repetição. Se o mesmo código chegar de novo, o servidor devolve o resultado anterior e não grava outra vez. É a ideia de idempotência.
- Status na fila. Cada item aparece como pendente, enviado ou confirmado. Só sai da fila depois da confirmação do servidor.
- Bloqueio de toque duplo. Depois de confirmar, a entrega some da lista de pendentes do motorista.
Quem integra com o ERP via REST deve exigir essa regra também na ponta do ERP. Veja mais em integrar portal e ERP sem dor.
Conferência antes de chegar ao ERP
Mesmo com identificador, vale conferir. Compare o que o app enviou com o que o ERP recebeu: nota, itens e quem assinou.
Se uma entrega já estiver como recebida no ERP, o sistema deve recusar nova baixa e avisar o gestor, em vez de sobrescrever em silêncio. O que a prova precisa conter está em prova de entrega digital.
O app do motorista do Routkey funciona sem sinal, com foto, assinatura e conferência por item, e se conecta ao ERP pelo conector.
O motorista precisa fazer algo quando o sinal volta?
Não deveria. O app envia a fila sozinho. O motorista só precisa ver quais itens ainda estão pendentes.
E se o aparelho quebrar antes do envio?
Os registros que ainda estavam só no aparelho podem se perder. Por isso o envio deve ocorrer assim que houver sinal, e a gestão deve acompanhar entregas pendentes.
Antes de escolher ou revisar seu app de entrega, pergunte à equipe de TI: cada registro tem identificador criado no aparelho, e o servidor recusa repetições? Teste desligando o sinal no meio de um envio.