Quando o cliente compra, várias confirmações podem ocorrer em momentos diferentes. O pagamento pode ser aprovado antes da reserva, e a autorização fiscal pode chegar depois de um retorno de rede atrasado. Tratar tudo como um único estado chamado vendido dificulta saber o que realmente aconteceu.
O gestor precisa de um percurso que a equipe consiga explicar. Para cada etapa, deve haver responsável, condição de avanço e tratamento de exceção. Essa clareza vale para loja física, site e marketplace, mesmo quando os canais usam sistemas de fornecedores diferentes.
Neste guia
Quais estados precisam ser separados no pedido?
Identifique criação, reserva, pagamento, autorização fiscal, separação, expedição e conclusão, conforme a operação. Preserve também cancelamento, devolução e pendência. Os nomes podem variar, mas o evento que muda cada estado precisa ser definido.
| Etapa | Condição de avanço | Exceção a tratar |
|---|---|---|
| Reserva | Quantidade e origem comprometidas | Última unidade disputada |
| Pagamento | Confirmação válida do provedor | Retorno atrasado ou repetido |
| Fiscal | Documento no estado exigido para a operação | Rejeição ou situação desconhecida |
| Expedição | Condições operacionais atendidas | Item divergente ou documento pendente |
Um evento não deve apagar o histórico anterior. Se houver correção de cadastro ou mudança de origem, registre o motivo e a versão usada. Atendimento e financeiro precisam consultar o mesmo percurso, ainda que trabalhem em telas distintas.
Como proteger a quantidade vendida entre canais?
Defina quando a unidade é reservada e qual ocorrência a libera. Pedido pendente de pagamento, venda no balcão e cancelamento precisam seguir regras compatíveis. Verifique se o saldo recebido representa quantidade física ou quantidade já disponível após reservas.
Simule compras concorrentes e uma notificação de cancelamento entregue duas vezes. A repetição não pode liberar duas unidades quando só uma foi comprometida. Confirme também como a integração responde quando o estoque está indisponível para consulta, evitando apresentar uma certeza que o sistema não possui.
Como tratar repetição e retorno atrasado?
Vincule pedido e transação por identificadores estáveis. Quando houver falha de comunicação, consulte a situação conforme a documentação do provedor antes de criar uma nova cobrança. Mecanismos de idempotência ajudam quando implementados corretamente e dentro das condições previstas.
Em um exemplo hipotético, o pagamento foi aprovado, mas a resposta não chegou à loja. Uma nova tentativa não deve criar outra venda sem investigação. O teste precisa mostrar como o pedido recupera a confirmação original e como a equipe identifica que há apenas uma cobrança válida para aquele evento.
Como impedir que uma falha fiscal vire uma informação falsa?
Diferencie documento em preparação, enviado, autorizado, rejeitado e situação desconhecida, conforme o fluxo utilizado. Uma indisponibilidade de resposta não comprova rejeição. A equipe deve consultar e reconciliar o resultado antes de repetir procedimentos que possam gerar inconsistência.
Na revisão de outubro de 2026, confira as notas técnicas vigentes e o calendário aplicável ao documento e ao regime. O Portal NF-e lista a NT 2025.002 v1.52 de 01/10/2026 para a reforma. Teste a regra pertinente à empresa; não use uma data genérica ou a versão antiga como prova de prontidão.
Quem resolve uma ocorrência que atravessa dois sistemas?
Defina o responsável pelo caso inteiro, mesmo quando fornecedores diferentes investigam partes do problema. A fila deve informar pedido, etapa, última confirmação, ação pendente e prazo de revisão. Alertas sem alguém capaz de agir apenas acumulam notificações.
Inclua cancelamento e devolução no teste de recuperação. O movimento físico, o documento fiscal e o reembolso podem exigir procedimentos próprios. A conclusão do atendimento precisa ser sustentada pelos eventos correspondentes, sem marcar o caso como encerrado quando uma parte relevante permanece pendente.
Que evidência permite aprovar a integração?
Escolha um conjunto de operações representativas e documente resultado esperado. Execute fluxo normal, falta de estoque, pagamento repetido, retorno fiscal atrasado, rejeição corrigível e devolução. Confirme valores e quantidades em cada sistema, além de observar se a tela parece correta.
A aprovação deve incluir os limites do produto contratado, os volumes testados e a responsabilidade pela manutenção. Bases distintas não se tornam uma só porque pertencem ao mesmo fornecedor. Comece com o caso que mais gera retrabalho; considere a correção aceita quando ele termina com estoque, documento e financeiro conciliados, e a equipe consegue recuperar a exceção sem duplicar seus efeitos.