Tema
Visão dos fluxos de envio
Fluxos em que o sistema parceiro (ERP) envia ou associa cadastros na API mPm+. Imagens usam FTP e URL pública (ver Imagens).
Contrato comum
Base: https://mobtef.conexaoapi.com.br
Sucesso típico: HTTP ok + body.status === "success" + (quando aplicável) data[0].id
Falha de integração: tratar resposta inválida / status !== "success" como erro (ex.: 502 no cliente HTTP do parceiro).
Tabela de fluxos
| Entidade no ERP | Endpoint mPm+ | Método | Uso típico | Grava mpm_integracao |
|---|---|---|---|---|
| Grupo / seção | /mpm/grupos | POST / PUT | Criar ou atualizar grupo | ID do grupo (data[0].id ou id já conhecido) |
| Unidade | /mpm/unidades | POST / PUT | Criar ou atualizar unidade | ID da unidade |
| Produto | /mpm/produtos | POST / PUT | Criar ou atualizar produto | ID do produto |
| Cliente | /mpm/clientes | POST / PUT | Criar ou atualizar cliente | ID do cliente |
| Rota | /mpm/clientes/rotas | POST / PUT | Criar ou atualizar rota | ID da rota |
| Finalizadora | /mpm/finalizadoras | GET + PUT | Listar e associar código ERP | ID mPm+ da finalizadora |
| Plano | /mpm/finalizadoras/planos | GET + PUT | Listar e associar código ERP | ID mPm+ do plano |
| Funcionário / usuário | /mpm/funcionarios | GET + PUT | Listar e associar código ERP | Id usado em vendedor_id nos pedidos (ver Funcionários) |
| Imagens | FTP | upload | Publicar PNG e informar path_imagem | Não altera vínculo; atualiza URL local se o ERP guardar |
Páginas detalhadas
Recomendação
Cada entidade integrada no ERP deve ter coluna local mpm_integracao (inteiro) e enviar o código do ERP na tag JSON integracao no POST (ou no PUT de associação, quando for o caso).
Pré-requisito
Chamadas à API exigem credenciais válidas (empresa_id, token e metadados de app/dispositivo). Sem integração configurada, o parceiro não deve chamar a API externa.