A diferença entre erro técnico e erro de negócio na integração com o ERP é simples: no técnico a mensagem não chegou ou não foi processada, e reenviar resolve. No de negócio o ERP entendeu e recusou, e só corrigir o dado resolve.
Qual a diferença entre erro técnico e erro de negócio
Erro técnico é falha no caminho: tempo esgotado, ERP fora do ar, conexão caída, serviço indisponível. O pedido pode estar perfeito. A mesma mensagem, enviada de novo mais tarde, tende a passar.
Erro de negócio é uma regra do ERP dizendo não: cliente com crédito bloqueado, produto inativo, alçada insuficiente, campo obrigatório vazio. Reenviar a mesma mensagem mil vezes gera a mesma recusa.
Como classificar a resposta do ERP
Não classifique pelo texto da mensagem. Classifique pelo tipo de resposta e combine isso com a equipe do ERP antes de ir para produção.
- Sem resposta ou falha de rede. Trate como técnico. Reenvie com limite de tentativas e intervalo crescente.
- Resposta de indisponibilidade do servidor. Também técnico. O dado não foi avaliado.
- Resposta de validação com motivo. Negócio. O ERP avaliou e recusou, então o dado precisa mudar.
- Resposta ambígua. Trate como negócio até a equipe do ERP explicar, para não reenviar às cegas.
Um cuidado no reenvio: ele só é seguro se o ERP não criar o registro duas vezes. Por isso a mensagem precisa de um identificador único. O post Integrar um portal ao ERP sem dor detalha esse ponto.
O que o portal deve mostrar ao usuário em cada caso
O usuário não precisa ver código de erro. Precisa saber o que fazer agora.
- Erro técnico. Diga que o pedido está salvo e será reenviado sozinho. Mostre o status "aguardando envio" e, se esgotar as tentativas, avise a equipe de TI, não o cliente final.
- Erro de negócio. Mostre o motivo em linguagem clara, como "cliente com limite de crédito excedido", e aponte o campo ou a ação que corrige. Quem corrige é quem tem o dado: vendedor, financeiro, cadastro.
- Nos dois casos. Mantenha o histórico da tentativa, com data e resposta, para ninguém precisar adivinhar o que aconteceu.
Num portal de vendas como o OrderPro, as regras e validações do ERP são respeitadas em cada operação. Por isso a recusa de negócio aparece na hora, na tela de quem está lançando o pedido.
Erros comuns na hora de separar
- Reenviar tudo automaticamente. Erro de negócio em loop só enche a fila e esconde o problema.
- Mostrar "erro 500" ao usuário. Ele liga para o suporte, e o suporte não sabe o que dizer.
- Corrigir o dado só no portal. Se a regra está no ERP, a correção precisa seguir a regra do ERP.
- Não registrar a resposta original. Sem ela, ninguém prova se o erro foi técnico ou de negócio.
Todo erro técnico pode ser reenviado sem risco?
Só se o reenvio for seguro contra duplicidade. Sem identificador único por operação, um timeout em que o ERP chegou a gravar pode virar pedido duplicado.
Quem deve ser avisado de um erro de negócio?
Quem consegue corrigir o dado: o vendedor, o financeiro ou o cadastro. Avisar só a TI atrasa a correção, porque o problema não está na integração.
Para o próximo passo, levante as últimas respostas de erro da sua integração e classifique cada uma como técnica ou de negócio. Depois confira o que o usuário vê em cada caso e leve as lacunas para a equipe do ERP.