Tema
Envio: Funcionários (/mpm/funcionarios)
Objetivo
Associar usuários/funcionários listados no mPm+ ao código do funcionário no ERP, enviando integracao no PUT.
Endpoint
| Ação | Método | URL | Header extra |
|---|---|---|---|
| Listar | GET | {base}/mpm/funcionarios | — |
| Associar | PUT | {base}/mpm/funcionarios | funcionario_id |
Base: https://mobtef.conexaoapi.com.br
PUT — associar
json
{
"integracao": "0001"
}| Tag / header | Valor |
|---|---|
Body integracao | Código do funcionário no ERP |
Header funcionario_id | Id do registro na listagem mPm+ (id) |
Qual id gravar em mpm_integracao
Importante para pedidos
No padrão observado, o valor persistido localmente em mpm_integracao não é necessariamente o id usado no header funcionario_id. Em vários casos o campo útil é o usuario_id do registro mPm+.
O parceiro deve gravar o id que a API de pedidos usa em vendedor_id (e, se aplicável, vendedor_prod nos itens). Confirme no payload de pedidos do ambiente qual id aparece e persista esse valor em mpm_integracao.
Fluxo recomendado:
- GET
/mpm/funcionariose escolha o registro. - PUT com header
funcionario_id=idda lista e body{ "integracao": "<codigoERP>" }. - Grave localmente o id correto para matching de
vendedor_id(em geralusuario_iddo item retornado).
Relação com clientes e pedidos
- No sync de clientes,
vendedor_iddeve ser o mesmo id vinculado emmpm_integracaodo funcionário. - Na importação de pedidos,
vendedor_iddo JSON deve bater com esse vínculo.
Sucesso
- HTTP ok +
status === "success"
Erros
- Falha no PUT → falha de integração (ex.: 502).