Envio: Grupos (/mpm/grupos)

Objetivo

Criar ou atualizar grupos no mPm+ a partir do cadastro equivalente no ERP (ex.: seção/categoria).

Endpoint

Ação	Método	URL	Header extra
Criar	POST	{base}/mpm/grupos	—
Atualizar	PUT	{base}/mpm/grupos	grupo_id

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

Payload (POST)

{
  "nome": "Bebidas",
  "integracao": "01",
  "path_imagem": "https://ftp.exemplo.com/docs/SEC_12345_01.PNG",
  "mobile": true
}

Payload (PUT)

{
  "nome": "Bebidas",
  "path_imagem": "https://ftp.exemplo.com/docs/SEC_12345_01.PNG",
  "mobile": true,
  "ativo": true
}

Dicionário de tags

Tag	Tipo	Regra
nome	string	Obrigatório
integracao	string	Código do grupo no ERP — somente no POST
path_imagem	string	URL pública da imagem; string vazia pode ser enviada como espaço " "
mobile	boolean	Visibilidade no app mobile
ativo	boolean	Somente no PUT

Headers de autenticação

Incluir os headers padrão (empresa_id, token, dispositivo_*, app_*, plataforma, Content-Type). No PUT, adicionar grupo_id com o id mPm+ gravado em mpm_integracao.

Regras

• Se mpm_integracao local já tiver id válido → PUT; caso contrário → POST.
• Após POST bem-sucedido, gravar data[0].id em mpm_integracao.
• Imagem: opcionalmente fazer upload FTP com prefixo SEC_ antes do sync (ver Imagens).

Sucesso

• HTTP ok + body.status === "success"
• POST: ler body.data[0].id e persistir em mpm_integracao

Erros

• Resposta inválida ou status !== "success" → falha de integração (ex.: 502 no cliente do parceiro).

Observação

No mPm+, a entidade se chama grupo. Não existe endpoint /mpm/secoes.