Entrega, stock e pagamento: manter a encomenda coerente
Defina quem controla cada dado e trate confirmações, cancelamentos e falhas para que a encomenda permaneça coerente entre sistemas.
A loja indica “pago”, o sistema de stock espera confirmação e a transportadora tem uma etiqueta com a morada antiga. Cada integração pode responder normalmente enquanto a encomenda, no conjunto, está errada.
Comece por acompanhar uma compra de ponta a ponta. Liste os sistemas e indique quem responde pelo preço, disponibilidade, pagamento, preparação e entrega. Dois sistemas a alterar o mesmo dado sem uma regra clara criam divergências difíceis de explicar.
Ligue os registos por referências
Guarde a relação entre o identificador da encomenda, a transação do prestador e o registo de envio. A equipa deve conseguir partir de qualquer um e encontrar os restantes. Não dependa do nome do cliente: uma pessoa repete compras e várias podem ter o mesmo nome.
Defina os dados registados na compra. Morada escolhida, artigos e preço desse momento devem continuar compreensíveis mesmo após alterações ao catálogo ou ao perfil do cliente.
Descreva as transições antes de integrar
Decida quando se reservam unidades, quando se confirma a saída e quando se liberta uma reserva. Num exemplo hipotético, duas pessoas começam a comprar a última unidade quase ao mesmo tempo. O processo precisa de evitar promessas incompatíveis com o stock disponível.
Separe pagamento, preparação e expedição. Criar uma etiqueta não significa entregar a encomenda à transportadora; confirmar o pagamento não significa preparar o produto. Os estados devem orientar a equipa e explicar o que realmente aconteceu.
Conte com mensagens repetidas
A documentação de webhooks da Stripe indica que os eventos podem repetir-se e chegar fora de ordem.
O desenho do sistema precisa de reconhecer trabalho concluído. Reprocessar uma confirmação não deve retirar stock duas vezes nem criar outro envio. Peça à equipa técnica que o demonstre com eventos de teste, além de uma encomenda que seguiu o percurso ideal.
Torne as exceções visíveis
Crie uma lista de encomendas que exigem atenção: paga sem preparação, envio sem etiqueta válida ou cancelamento por confirmar. Registe a última tentativa, a causa da falha e quem a pode resolver. Um erro silencioso só chega ao apoio quando o cliente reclama.
- Interrompa temporariamente a integração de transporte e observe a retoma.
- Repita a confirmação do mesmo pagamento.
- Cancele antes e depois da preparação.
- Altere a morada após a etiqueta e confirme a regra definida.
- Compare saldos e registos no fim de cada cenário.
A integração está pronta quando a encomenda percorre o processo e as exceções podem ser encontradas e resolvidas. O número de sistemas ligados, por si só, não o comprova.
Continue em o percurso de Pix e cartão.
Sobre o autor
Tiago F SantiagoComentários
Ainda sem comentários
Partilhe uma dúvida ou experiência relacionada com o artigo.
Artigos relacionados
