Erros de integração

Critério de sucesso

Uma chamada à API mPm+ só é sucesso quando:

1. HTTP estiver na faixa de sucesso (2xx), e
2. body.status === "success", e
3. Em criação, existir data[0].id quando o fluxo depender desse id.

Qualquer outra combinação → falha de integração.

Mapeamento sugerido no cliente

Situação	Tratamento sugerido
Timeout / rede	Retentar com backoff (ver Retentativas)
HTTP 4xx de auth	Corrigir empresa_id / token — não retentar às cegas
HTTP 5xx ou body de erro interno	Retentar limitado; em clientes, omitir vendedor_id/rota_id
HTTP ok mas status !== "success"	Falha de integração (ex.: responder 502 na camada do parceiro)
Duplicidade de integracao	Buscar id existente (GET) e fazer PUT, ou gravar id manual em mpm_integracao

Mensagens úteis ao operador

• Credenciais inválidas ou integração não configurada
• Entidade duplicada — informar id mPm+ em mpm_integracao
• Vínculo ausente na importação de pedido (mpm_integracao não encontrado)
• FTP incompleto ao enviar imagem

TIP

Normalize erros para o operador: mensagem clara + código/correlation id nos logs, sem expor token.