Envio: Clientes (/mpm/clientes)

Objetivo

Criar ou atualizar clientes no mPm+ a partir do cadastro do ERP.

Endpoint

Ação	Método	URL	Header extra
Criar	POST	{base}/mpm/clientes	—
Atualizar	PUT	{base}/mpm/clientes	cliente_id
Listar / buscar	GET	{base}/mpm/clientes	—

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

Payload (POST)

{
  "razao": "Cliente Exemplo LTDA",
  "fantasia": "Cliente Exemplo",
  "indicador_ie": 1,
  "integracao": "000100",
  "ie_rg": "123456789",
  "email": "cliente@exemplo.com",
  "telefone": "5511999999999",
  "vendedor_id": 55,
  "rota_id": 10,
  "path_imagem": "https://ftp.exemplo.com/docs/CLI_12345_000100.PNG",
  "documento": "12345678000199"
}

Payload (PUT)

{
  "razao": "Cliente Exemplo LTDA",
  "fantasia": "Cliente Exemplo",
  "indicador_ie": 1,
  "integracao": "000100",
  "ie_rg": "123456789",
  "email": "cliente@exemplo.com",
  "telefone": "5511999999999",
  "vendedor_id": 55,
  "rota_id": 10,
  "path_imagem": "https://ftp.exemplo.com/docs/CLI_12345_000100.PNG",
  "mobile": true,
  "ativo": true
}

Dicionário de tags

Tag	Quando	Regra
razao	Sempre	Razão social / nome
fantasia	Sempre	Nome fantasia (fallback = razão)
indicador_ie	Sempre	Indicador de IE (número)
integracao	Sempre	Código do cliente no ERP
documento	Somente POST	CPF/CNPJ; não enviar no PUT
ie_rg	Opcional	IE ou RG
email	Opcional	E-mail
telefone	Opcional	Dígitos com prefixo país 55 (Brasil)
vendedor_id	Opcional	Id mPm+ do vendedor (o mesmo id usado em pedidos)
rota_id	Opcional	Id mPm+ da rota
path_imagem	Opcional	URL pública da imagem
mobile	Somente PUT	Visibilidade mobile
ativo	Somente PUT	Situação ativa

Telefone

Remova caracteres não numéricos. Se o número não começar com 55, prefixe 55.

Exemplos: 11999999999 → 5511999999999; 5511988887777 permanece.

Retry omitindo vendedor/rota

Em erro interno da API (HTTP ≥ 500 ou mensagem de processamento interno), recomenda-se retentar até 3 variantes:

1. Body completo (com vendedor_id e rota_id)
2. Sem vendedor_id
3. Sem vendedor_id e sem rota_id

Regras

• Sem mpm_integracao → POST; com id → PUT + header cliente_id.
• Se a rota ainda não estiver vinculada, sincronize a rota antes (ver Rotas).
• Busca de id: GET /mpm/clientes e localize por integracao ou documento.

Sucesso

• HTTP ok + status === "success"
• POST: data[0].id → mpm_integracao

Erros

• Após esgotar retries → falha de integração (ex.: 502).
• Duplicidade: orientar o operador a informar o id mPm+ já existente em mpm_integracao.