Skip to content

Retentativas

Princípios

  • Retente apenas erros transitórios (rede, timeout, HTTP ≥ 500, mensagem de erro interno da API).
  • Não retente em loop erros de autenticação ou validação de negócio óbvios.
  • Use backoff (ex.: 1s, 2s, 4s) e limite máximo de tentativas.

Por fluxo

FluxoSugestão
POST/PUT cadastro2–3 tentativas em erro transitório
POST clienteAté 3 variantes: com vendedor+rota → sem vendedor → sem vendedor e sem rota
GET pedidosRetentar consulta; não duplicar gravação (idempotência pelo id)
Importação localReprocessar só pedidos ainda não gravados

Idempotência

  • Cadastros: após sucesso, mpm_integracao evita novo POST.
  • Pedidos: nunca grave duas vezes o mesmo id mPm+.

WARNING

Retentar POST de criação sem checar vínculo local pode gerar duplicidade. Prefira: falhou → GET por integracao → PUT se achar.

Documentação da API mPm+ para sistemas parceiros. Exemplos com dados fictícios.