Endpoints da API mPm+

Base: https://mobtef.conexaoapi.com.br

Auth fictícia

Exemplos usam empresa_id: 9999 e token: TOKEN_FICTICIO. Substitua pelas credenciais reais da integração.

Escopo

Esta página lista somente endpoints externos /mpm/*. Não documenta APIs internas de ERPs parceiros.

Cadastros (envio)

Método	Path	Uso
POST / PUT	/mpm/grupos	Criar / atualizar grupo (grupo_id no PUT)
GET	/mpm/grupos	Listar / consultar
POST / PUT	/mpm/unidades	Criar / atualizar unidade (unidade_id no PUT)
GET	/mpm/unidades	Listar / consultar
POST / PUT	/mpm/produtos	Criar / atualizar produto (produto_id no PUT)
GET	/mpm/produtos	Listar / buscar por integracao
POST / PUT	/mpm/clientes	Criar / atualizar cliente (cliente_id no PUT)
GET	/mpm/clientes	Listar / buscar
POST / PUT	/mpm/clientes/rotas	Criar / atualizar rota (rota_id no PUT)
GET	/mpm/clientes/rotas	Listar / consultar

Associação (GET + PUT)

Método	Path	Uso
GET	/mpm/finalizadoras	Listar (header atualizacao)
PUT	/mpm/finalizadoras	Associar integracao (finalizadora_id)
GET	/mpm/finalizadoras/planos	Listar planos
PUT	/mpm/finalizadoras/planos	Associar integracao (plano_id)
GET	/mpm/funcionarios	Listar usuários/funcionários
PUT	/mpm/funcionarios	Associar integracao (funcionario_id)

Pedidos (recebimento)

Método	Path	Uso
GET	/mpm/pedidos	Consultar por período (headers abertura / fechamento)

Headers comuns

Header	Obrigatório	Notas
empresa_id	Sim	Id da empresa
token	Sim	Token da integração
dispositivo_id	Sim	Ex.: 1
dispositivo_model	Sim	Ex.: 1
dispositivo_tipo	Sim	Ex.: 1
app_versao	Sim	Versão do app parceiro
app_nome	Sim	Nome do app parceiro
plataforma	Sim	Ex.: Android, web
Content-Type	Em body JSON	application/json

Não há Authorization: Bearer neste contrato.

Critério de sucesso

• HTTP ok
• body.status === "success"
• Em criação: data[0].id quando aplicável

Falha → tratar como erro de integração (ex.: 502 no cliente HTTP do parceiro).