Início rápido

Passos mínimos para homologar a integração com a API mPm+. Use apenas credenciais de teste.

Só homologação

Exemplos com TOKEN_FICTICIO, empresa_id 9999 e códigos CAF-001. Substitua pelos valores do ambiente de teste.

1. Obter credenciais

Solicite à operadora / ambiente de homologação:

• empresa_id
• token
• app_nome, app_versao, plataforma

URL base:

https://mobtef.conexaoapi.com.br

(ou MPM_API_URL)

2. Criar um grupo

POST /mpm/grupos HTTP/1.1
Host: mobtef.conexaoapi.com.br
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

{
  "nome": "Bebidas",
  "integracao": "GRP-01",
  "mobile": true
}

Guarde data[0].id em mpm_integracao do grupo local (ex.: 1001).

3. Criar uma unidade

POST /mpm/unidades HTTP/1.1
Host: mobtef.conexaoapi.com.br
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

{
  "nome": "Unidade",
  "integracao": "UN",
  "casas_decimais": 0
}

Guarde o ID retornado (ex.: 2002).

4. Criar um produto

Use os IDs mPm+ de grupo e unidade:

POST /mpm/produtos HTTP/1.1
Host: mobtef.conexaoapi.com.br
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

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

Guarde data[0].id em mpm_integracao do produto.

5. Associar uma finalizadora

Liste no mPm+ (GET /mpm/finalizadoras), escolha o finalizadora_id e associe o código interno do ERP:

PUT /mpm/finalizadoras HTTP/1.1
Host: mobtef.conexaoapi.com.br
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
finalizadora_id: 3001
Content-Type: application/json

{
  "integracao": "DIN"
}

Repita o padrão para planos (PUT /mpm/finalizadoras/planos + plano_id) e funcionários (PUT /mpm/funcionarios + funcionario_id).

6. Consultar pedidos

GET /mpm/pedidos HTTP/1.1
Host: mobtef.conexaoapi.com.br
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
abertura: 2026-07-01 00:00:00
fechamento: 2026-07-29 23:59:59
Content-Type: application/json

Para cada pedido:

1. Verifique se o id já foi importado
2. Resolva cliente_id / produto_id / etc. via mpm_integracao
3. Grave no banco do parceiro

Checklist rápido

• [ ] Credenciais de homologação ok
• [ ] Grupo, unidade e produto com mpm_integracao preenchido
• [ ] Finalizadora (e plano/funcionário se necessário) associada
• [ ] GET de pedidos retorna status: success
• [ ] Idempotência pelo id do pedido mPm+

Detalhes didáticos: Do zero · Checklist completo: Parceiros.