Integração ApiMp

A ApiMp é uma API REST para o ERP se comunicar com o Demander: consulta, criação e atualização de registros, com autenticação por token e dados em JSON.

O que é a ApiMp

A ApiMp é uma API REST para integrar o ERP ao Demander, no envio e no recebimento de dados.

Ela cobre consulta, criação e atualização em tabelas usadas no dia a dia do sistema, com troca padronizada e autenticada.

Benefícios da integração

O Demander também tem uma API baseada em HTTP com arquivos multipart (TXT em UTF-8). Ela ainda atende muitos cenários, mas pede tratamento extra para ler, gravar e interpretar os arquivos.

Documentação da API TXT

A ApiMp usa HTTPS e JSON, sem arquivo intermediário.

• Facilidade no manuseio de dados: JSON é simples de ler e validar.
• Velocidade: comunicação direta, em tempo real.
• Menos erro de formatação: estrutura padronizada.
• Segurança: token e HTTPS.
• Manutenção: dá para ampliar recursos sem mudar o modelo REST.

Como funciona

As chamadas usam GET, POST e PUT. Todas exigem token e JSON.

Cada endpoint corresponde a uma tabela; os métodos disponíveis mudam conforme a tabela.

Dica

Há uma Collection pronta para simular as chamadas com um token cadastrado (peça o token à equipe Demander).

• Baixar a Collection
• Como importar no Postman

Métodos disponíveis por tabela

Tabela	GET (consulta)	POST (criação)	PUT (atualização)
Vendedores	✔	❌	❌
Grupos de produto	❌	✔	✔
Listas de preço	❌	✔	✔
Status dos pedidos	❌	✔	✔
Preços do produto	❌	✔	✔
Produtos	❌	✔	✔
Pedidos	✔	❌	❌
Clientes	✔	✔	✔
Títulos financeiros	❌	✔	✔
Atualização de status do pedido	❌	✔	❌
Transportadoras	❌	✔	✔

Estrutura das requisições

Requisições HTTPS (GET, POST e PUT) com JSON e token de autenticação. Cabeçalhos e corpos mudam conforme o método e a tabela.

Artigo completo da estrutura da ApiMp

Campos por método e tabela

Cada tabela tem campos obrigatórios e opcionais, diferentes para consulta, criação e atualização.

Lista completa de campos por método e tabela