Configuração da integração

O que o sistema parceiro precisa guardar e configurar para falar com a API mPm+. Não há exigência de tabela específica de banco — apenas os valores de credencial e, opcionalmente, FTP.

Credenciais necessárias

Parâmetro	Header / uso	Obrigatório	Exemplo fictício
ID da empresa	empresa_id	Sim	9999
Token	token	Sim	TOKEN_FICTICIO
Nome do app	app_nome	Sim	MeuERP
Versão do app	app_versao	Sim	1.0.0
Plataforma	plataforma	Sim	WEB

Armazenamento

Guarde esses valores de forma segura no sistema parceiro (cofre de segredos, configuração cifrada, etc.). Nunca versionar tokens reais em repositório.

URL base

https://mobtef.conexaoapi.com.br

Ou via variável de ambiente:

MPM_API_URL=https://mobtef.conexaoapi.com.br

Convenção

Remova a barra final da URL base antes de concatenar os paths (/mpm/produtos, etc.).

Metadados de dispositivo

Nas chamadas servidor-a-servidor, os headers abaixo costumam ser enviados com valores fixos:

Header	Valor típico
dispositivo_id	1
dispositivo_model	1
dispositivo_tipo	1

Detalhes: Autenticação.

FTP opcional (imagens)

Se o parceiro for publicar imagens de produtos ou grupos:

Parâmetro	Uso
Host	Servidor FTP
Porta	Em geral 21
Usuário	Login FTP
Senha	Senha FTP

O fluxo típico:

1. Enviar o arquivo (ex. PNG) via FTP
2. Obter/montar a URL pública da imagem
3. Incluir essa URL no campo path_imagem do JSON REST

Atenção

FTP é opcional. Cadastros e pedidos funcionam sem imagens; path_imagem pode ser omitido ou enviado conforme regra do payload de cada entidade.

Checklist de configuração

[ ] empresa_id e token de homologação obtidos
[ ] app_nome, app_versao e plataforma definidos
[ ] MPM_API_URL apontando para o ambiente correto
[ ] Coluna mpm_integracao prevista nas entidades locais
[ ] FTP configurado apenas se houver envio de imagens
[ ] Credenciais de produção isoladas das de teste

Próximos passos: Autenticação · Início rápido.