Boas práticas de integração

Cadastros (ERP → mPm+)

Prática	Motivo
Coluna mpm_integracao por entidade	Vínculo estável com o id mPm+
Tag integracao = código ERP no POST	Rastreio e busca de duplicidade
PUT de produto sem integracao	Evita falso positivo de duplicata
Ordem grupo → unidade → produto	Dependências de id
Sync de rota antes do cliente	rota_id válido

Pedidos (mPm+ → ERP)

Prática	Motivo
Idempotência pelo id mPm+	Evita pedido duplicado
Transação única	Cabeçalho + itens + pagamentos atômicos
Sem criação automática de cadastro	Contrato observado; força sync prévio
Regra de troco	valor - troco quando aplicável
Gravar id de vendedor coerente	vendedor_id = valor em mpm_integracao

Operação

• Validar sempre HTTP + status === "success".
• Retentar só erros transitórios; mascarar tokens em log.
• Homologar com a coleção antes de produção.
• Documentar credenciais e FTP fora do repositório público.

TIP

Trate a API mPm+ como sistema externo: timeouts curtos, circuit breaker e fila/outbox se o volume for alto.