Envio: Produtos (/mpm/produtos)

Objetivo

Criar ou atualizar produtos no mPm+. O produto depende de grupo_id e unidade_id já existentes no mPm+ (ids gravados em mpm_integracao do grupo e da unidade no ERP).

Endpoint

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

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

Payload (POST — com integracao)

{
  "nome": "Refrigerante 2L",
  "preco": 9.9,
  "estoque": 12,
  "grupo_id": 1001,
  "unidade_id": 2002,
  "path_imagem": "https://ftp.exemplo.com/docs/PRO_12345_0001.PNG",
  "cean": "7891000100103",
  "cest": "1700100",
  "ncm": "22021000",
  "caracteristicas": "Garrafa PET",
  "orig": 0,
  "desc_max": 5,
  "valor_entrega": 0,
  "taxa_servico": false,
  "controla_estoque": true,
  "mobile": true,
  "integracao": "0001"
}

Payload (PUT — com ativo, sem integracao)

{
  "nome": "Refrigerante 2L",
  "preco": 9.9,
  "estoque": 12,
  "grupo_id": 1001,
  "unidade_id": 2002,
  "path_imagem": "https://ftp.exemplo.com/docs/PRO_12345_0001.PNG",
  "cean": "7891000100103",
  "cest": "1700100",
  "ncm": "22021000",
  "caracteristicas": "Garrafa PET",
  "orig": 0,
  "desc_max": 5,
  "valor_entrega": 0,
  "taxa_servico": false,
  "controla_estoque": true,
  "mobile": true,
  "ativo": true
}

PUT sem integracao

No PUT, não envie integracao. Inclua ativo. O vínculo permanece pelo header produto_id e pela coluna local mpm_integracao. Reenviar integracao no PUT pode gerar falso positivo de duplicidade na API.

Dicionário de tags

Tag	Tipo	Observação
nome	string	Nome do produto
preco	number	Preço de venda
estoque	number	Saldo / quantidade
grupo_id	number	Id mPm+ do grupo
unidade_id	number	Id mPm+ da unidade
path_imagem	string	URL pública; vazio pode ser " "
cean	string	Código de barras (EAN)
cest	string	CEST
ncm	string	NCM
caracteristicas	string	Texto livre
orig	number	Origem fiscal (default 0)
desc_max	number	Desconto máximo permitido
valor_entrega	number	Fixo observado: 0
taxa_servico	boolean	Fixo observado: false
controla_estoque	boolean	Controle de estoque no app
mobile	boolean	Disponível no mobile
integracao	string	Código do produto no ERP — somente POST
ativo	boolean	Somente PUT

Regras

• Garanta grupo e unidade sincronizados antes do produto (grupo_id / unidade_id válidos).
• Sem mpm_integracao → POST; com id → PUT com header produto_id.
• Em duplicidade no POST, o parceiro pode buscar no GET por integracao e seguir com PUT.

Sucesso

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

Erros

• Falha de criação/atualização → falha de integração (ex.: 502 no cliente).

Recomendação

Sincronize grupo e unidade antes do produto para evitar criação em cascata no mesmo fluxo.