Integração com a API mPm+

Documentação do contrato HTTP da API mPm+ para qualquer sistema parceiro (ERP ou backoffice) que precise enviar cadastros e receber pedidos de vendas mobile.

O que é o mPm+

mPm+ é a plataforma/API de vendas mobile. O sistema parceiro autentica com os headers empresa_id e token (mais metadados de app/dispositivo). Não usa Authorization: Bearer.

URL base:

text

process.env.MPM_API_URL || 'https://mobtef.conexaoapi.com.br'

Para que serve a integração

Objetivo	Direção
Publicar cadastros (grupos, unidades, produtos, clientes, rotas)	Parceiro → mPm+
Associar finalizadoras, planos e funcionários já existentes no mPm+	Parceiro → mPm+ (PUT)
Enviar imagens de produtos/grupos (opcional)	Parceiro → FTP
Consultar e importar pedidos mobile	mPm+ → Parceiro (GET sob demanda)

Fluxo visual

mermaid

flowchart LR
  P[Sistema parceiro / ERP] -->|REST POST/PUT| M[API mPm+]
  P -->|GET pedidos| M
  M -->|JSON status + data| P
  P -->|FTP PNG opcional| F[Servidor FTP]
  F -->|URL pública da imagem| P
  P --> B[(Banco do parceiro)]

mermaid

sequenceDiagram
  participant ERP as Sistema parceiro
  participant API as API mPm+
  participant DB as Banco do parceiro

  Note over ERP,API: Cadastros
  ERP->>API: POST /mpm/... (tag integracao = código interno)
  API-->>ERP: status success + data[0].id
  ERP->>DB: Grava id em mpm_integracao

  Note over ERP,API: Pedidos
  ERP->>API: GET /mpm/pedidos (abertura / fechamento)
  API-->>ERP: lista de pedidos
  ERP->>DB: Persiste pedido e id mPm+ (idempotência)

O que enviar / o que receber

Enviar ao mPm+	Receber do mPm+
Headers de autenticação e metadados do app	`status: success` (ou erro)
Body JSON com dados da entidade	`data[0].id` no POST (ID mPm+)
Tag `integracao` = código interno do ERP (criação)	Lista de pedidos no GET
Header `*_id` no PUT (ex.: `produto_id`)	IDs de cliente, produto, finalizadora etc. nos pedidos

Pré-requisitos

Item	Detalhe
Credenciais	`empresa_id`, `token`, `app_nome`, `app_versao`, `plataforma`
Rede	HTTPS até a URL base da API
Vínculo local	Coluna `mpm_integracao` (INTEGER) nas entidades sincronizadas
FTP (opcional)	Host, porta, usuário e senha — só se for enviar imagens
Homologação	Testar sempre com credenciais de teste antes da produção

Observação

Não há webhook obrigatório: o parceiro consulta pedidos com GET /mpm/pedidos quando desejar importar.

Homologação

Exemplos deste portal usam dados fictícios (TOKEN_FICTICIO, empresa_id 9999, códigos CAF-001). Nunca publique tokens reais.

Por onde começar

Entendendo do zero — conceitos do contrato
Início rápido — primeiros POSTs e GET de pedidos
Guia para parceiros — checklist completo
Autenticação · Arquitetura · Glossário

Recomendação

Em cada entidade do banco do parceiro, mantenha mpm_integracao INTEGER com o ID retornado pelo mPm+. Na criação, envie o código interno do ERP na tag integracao do JSON.

Integração com a API mPm+ ​

O que é o mPm+ ​

Para que serve a integração ​

Fluxo visual ​

O que enviar / o que receber ​

Pré-requisitos ​