Entendendo do zero

Explicação didática do contrato da API mPm+ para quem nunca integrou.

O que a integração faz

O mPm+ é a API/app de pedidos móveis. O sistema parceiro:

1. Envia cadastros (grupo, unidade, produto, cliente, rota) e associa finalizadora, plano e funcionário
2. Consulta pedidos sob demanda com GET /mpm/pedidos (sem webhook obrigatório)

flowchart LR
  A[ERP parceiro] -->|POST/PUT cadastros| B[API mPm+]
  B -->|GET pedidos| A

URL e paths

Base:

https://mobtef.conexaoapi.com.br

(ou variável MPM_API_URL)

Paths reais do contrato:

Path	Uso principal
/mpm/grupos	Categorias
/mpm/unidades	Unidades de medida
/mpm/produtos	Produtos
/mpm/clientes	Clientes
/mpm/clientes/rotas	Rotas
/mpm/finalizadoras	Formas de pagamento (associar)
/mpm/finalizadoras/planos	Planos (associar)
/mpm/funcionarios	Vendedores (associar)
/mpm/pedidos	Consulta de pedidos

Headers (sem Bearer)

Toda chamada leva, no mínimo:

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

Não é Bearer

O token vai no header token, não em Authorization: Bearer ….

No PUT, acrescente o ID da entidade, por exemplo:

produto_id: 55001

JSON: criar vs atualizar

Criar (POST) — envia a tag integracao com o código interno do ERP:

{
  "nome": "Café torrado 500g",
  "preco": 24.9,
  "grupo_id": 1001,
  "unidade_id": 2002,
  "integracao": "CAF-001"
}

Resposta esperada (conceito):

{
  "status": "success",
  "data": [{ "id": 55001 }]
}

Grave 55001 na coluna local mpm_integracao.

Atualizar (PUT) — header produto_id: 55001 e body sem depender de reenviar integracao:

{
  "nome": "Café torrado 500g",
  "preco": 25.9,
  "grupo_id": 1001,
  "unidade_id": 2002,
  "ativo": true
}

Tag integracao vs coluna mpm_integracao

	Tag integracao	Coluna mpm_integracao
Onde	JSON enviado ao mPm+	Banco do parceiro
Valor	Código ERP (CAF-001)	ID mPm+ (55001)
Quando	POST / associação	Sempre após sucesso

Analogia

A tag integracao é o RG do registro no seu ERP. A coluna mpm_integracao é o número de matrícula dele no mPm+.

Associação (finalizadora / plano / funcionário)

Esses recursos em geral já existem no mPm+. O parceiro:

1. Lista com GET
2. Escolhe o ID mPm+
3. Faz PUT com header finalizadora_id (ou plano_id / funcionario_id) e body:

{ "integracao": "DIN" }

4. Grava o ID em mpm_integracao local

Pedidos em uma frase

O parceiro consulta GET /mpm/pedidos com período (abertura / fechamento), resolve os IDs via mpm_integracao e grava o pedido localmente, guardando o id mPm+ para não duplicar.

Próximos passos

1. Início rápido — executar os POSTs e o GET
2. Guia para parceiros — checklist completo
3. Autenticação · Modelo de vínculo