Guia para sistemas parceiros

Checklist e fluxo recomendado para qualquer ERP integrar-se à API mPm+.

Objetivo

Enviar cadastros, associar meios de pagamento/usuários e receber pedidos no mesmo contrato HTTP documentado neste portal.

Princípio central

Importante

Em todas as entidades envolvidas, mantenha mpm_integracao INTEGER com o ID do mPm+. Envie o código interno do ERP na tag integracao na criação/associação.

Entidade	Tag integracao (exemplo)	Coluna local
Grupo	GRP-01	mpm_integracao
Unidade	UN	mpm_integracao
Produto	CAF-001	mpm_integracao
Cliente	CLI-045	mpm_integracao
Rota	RT-12	mpm_integracao
Finalizadora	DIN	mpm_integracao
Plano	PL-01	mpm_integracao
Funcionário	VEN-07	mpm_integracao

Headers obrigatórios

empresa_id: 9999
token: TOKEN_FICTICIO
dispositivo_id: 1
dispositivo_model: 1
dispositivo_tipo: 1
app_versao: 1.0.0
app_nome: MeuERP
plataforma: WEB
Content-Type: application/json

Base: https://mobtef.conexaoapi.com.br (ou MPM_API_URL). Detalhes: Autenticação.

Fluxo mínimo

sequenceDiagram
  participant P as Sistema parceiro
  participant M as API mPm+
  participant B as Banco do parceiro

  P->>B: Lê cadastro sem mpm_integracao
  P->>M: POST /mpm/produtos (integracao = CAF-001)
  M-->>P: status success + data[0].id
  P->>B: UPDATE mpm_integracao = id
  Note over P,M: Alterações futuras
  P->>M: PUT /mpm/produtos + header produto_id
  M-->>P: status success

Ordem sugerida de sincronização

1. Configurar empresa_id, token, app_*
2. Grupos (/mpm/grupos)
3. Unidades (/mpm/unidades)
4. Produtos (/mpm/produtos) — usam grupo_id e unidade_id mPm+
5. Rotas (/mpm/clientes/rotas)
6. Clientes (/mpm/clientes)
7. Associar finalizadoras, planos e funcionários (PUT + { "integracao": "..." })
8. Consultar pedidos (GET /mpm/pedidos)

Importação de pedidos

Não há webhook obrigatório. O parceiro:

1. Faz GET /mpm/pedidos com headers abertura e fechamento
2. Para cada pedido novo, grava localmente
3. Evita duplicidade guardando o id do pedido mPm+

Resolução de vínculos:

Campo do pedido	Resolve via
cliente_id	Cliente onde mpm_integracao = cliente_id
produto_id	Produto onde mpm_integracao = produto_id
finalizadora_id	Finalizadora onde mpm_integracao = finalizadora_id
vendedor_id	Funcionário onde mpm_integracao = vendedor_id
plano_id	Plano onde mpm_integracao = plano_id

Atenção

Sem o vínculo em mpm_integracao, a importação do item/pedido tende a falhar. Associe cadastros antes de processar pedidos.

Checklist do parceiro

[ ] Credenciais de homologação (empresa_id, token, app_*)
[ ] Coluna mpm_integracao (INTEGER) nas entidades envolvidas
[ ] POST envia tag integracao = código interno do ERP
[ ] Guarda data[0].id retornado em mpm_integracao
[ ] PUT usa header *_id com o ID mPm+
[ ] Headers de autenticação completos (sem Bearer)
[ ] Finalizadoras / planos / funcionários associados
[ ] Idempotência de pedidos pelo id mPm+
[ ] FTP (opcional) testado se houver imagens
[ ] Nunca usar produção nos primeiros testes

Métodos por recurso

Recurso	Criar	Atualizar / associar
Grupos, unidades, produtos, clientes, rotas	POST	PUT + header *_id
Finalizadoras, planos, funcionários	—	PUT + { integracao } + header *_id
Pedidos	—	GET com abertura / fechamento

Referências

• Modelo de vínculo
• Início rápido
• Do zero
• Arquitetura