Envio: Imagens (FTP)

Objetivo

Publicar imagens de grupo, produto e cliente em servidor FTP e informar a URL pública no campo path_imagem dos endpoints REST.

Path público

https://{host}/docs/{prefixo}_{empresaId}_{codigo}.PNG

Parte	Descrição
{host}	Host público do FTP / CDN configurado
{prefixo}	Prefixo da entidade (tabela abaixo)
{empresaId}	Id da empresa na integração mPm+
{codigo}	Código da entidade no ERP

Prefixos

Entidade	Prefixo	Exemplo de arquivo
Grupo	SEC_	SEC_12345_01.PNG
Produto	PRO_	PRO_12345_0001.PNG
Cliente	CLI_	CLI_12345_000100.PNG

Exemplos de URL

https://ftp.exemplo.com/docs/SEC_12345_01.PNG
https://ftp.exemplo.com/docs/PRO_12345_0001.PNG
https://ftp.exemplo.com/docs/CLI_12345_000100.PNG

Regras

• Converta/normalize a imagem para PNG antes do upload.
• Credenciais FTP fazem parte da configuração da integração do parceiro (host, usuário, senha, pasta).
• Após o upload, envie a URL completa em path_imagem no POST/PUT da entidade.
• Se não houver imagem, path_imagem pode ser enviado como espaço " ".

Sucesso

• Arquivo acessível pela URL pública e campo path_imagem coerente no cadastro mPm+.

Erros

• FTP incompleto ou falha de upload → não chame a API com URL inválida; trate como falha de integração no fluxo do parceiro.

Ordem sugerida

1. Upload FTP
2. Sync REST com path_imagem preenchido