Autenticação e headers

Toda chamada REST à API mPm+ usa headers customizados. Não há Authorization: Bearer.

Importante

Autenticação = headers empresa_id + token. Enviar Bearer costuma ser ignorado ou rejeitado pelo contrato documentado aqui.

Headers padrão

Montagem genérica (conceito headersMpm):

Header	Origem	Exemplo fictício
empresa_id	Credencial da empresa	9999
token	Credencial da empresa	TOKEN_FICTICIO
dispositivo_id	Fixo / metadado	1
dispositivo_model	Fixo / metadado	1
dispositivo_tipo	Fixo / metadado	1
app_versao	Configuração do parceiro	1.0.0
app_nome	Configuração do parceiro	MeuERP
plataforma	Configuração do parceiro	WEB
Content-Type	Fixo	application/json

Headers extras por operação

Extra	Quando usar
grupo_id	PUT /mpm/grupos
unidade_id	PUT /mpm/unidades
produto_id	PUT /mpm/produtos
cliente_id	PUT /mpm/clientes
rota_id	PUT /mpm/clientes/rotas
finalizadora_id	PUT /mpm/finalizadoras
funcionario_id	PUT /mpm/funcionarios
plano_id	PUT /mpm/finalizadoras/planos
atualizacao	GET de finalizadoras (filtro de data, se aplicável)
abertura	GET /mpm/pedidos (início do período)
fechamento	GET /mpm/pedidos (fim do período)

Exemplo: criar produto (POST)

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"
}

Exemplo: atualizar produto (PUT)

PUT /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
produto_id: 55001
Content-Type: application/json

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

Exemplo: consultar pedidos (GET)

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

Exemplo: associar finalizadora (PUT)

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"
}

Observação

No PUT de atualização de produto/grupo/etc., muitos integradores não reenviam a tag integracao (o vínculo já está no header *_id e na coluna local mpm_integracao), evitando falsos positivos de duplicidade no mPm+.

Atenção

Todos os valores acima são fictícios. Use as credenciais do ambiente de homologação ou produção fornecidas pela operadora.