Skip to content

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çãoMétodoURLHeader extra
ListarGET{base}/mpm/funcionarios
AssociarPUT{base}/mpm/funcionariosfuncionario_id

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

PUT — associar

json
{
  "integracao": "0001"
}
Tag / headerValor
Body integracaoCódigo do funcionário no ERP
Header funcionario_idId 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:

  1. GET /mpm/funcionarios e escolha o registro.
  2. PUT com header funcionario_id = id da lista e body { "integracao": "<codigoERP>" }.
  3. Grave localmente o id correto para matching de vendedor_id (em geral usuario_id do item retornado).

Relação com clientes e pedidos

  • No sync de clientes, vendedor_id deve ser o mesmo id vinculado em mpm_integracao do funcionário.
  • Na importação de pedidos, vendedor_id do JSON deve bater com esse vínculo.

Sucesso

  • HTTP ok + status === "success"

Erros

  • Falha no PUT → falha de integração (ex.: 502).

Documentação da API mPm+ para sistemas parceiros. Exemplos com dados fictícios.