API de Demander: archivos adjuntos de productos

Este artículo es parte de la documentación API de integración REST.

Documentación para consultar, insertar, actualizar y eliminar archivos adjuntos de productos.

Consulta

Enumera los archivos adjuntos de un producto.

Rota: {host}/public/v1/anexos-do-produto?codProduto={codProduto}
Método: GET

Retorno:

[
  {
    "codIntegracao": "ANX001",
    "codProduto": "PROD-100",
    "tipoAnexo": "imagem",
    "titulo": "Foto principal",
    "descricao": "Imagem da frente do produto",
    "nomeArquivo": "imagem_frente.jpg",
    "urlExterna": null,
    "ordem": 1,
    "dataAlteracao": "2026-07-15 10:00:00"
  }
]

Insertar o actualizar

POST inserción mediante la tecla codIntegracao.

Rota: {host}/public/v1/anexos-do-produto
Método: POST
Body: form/data

Propiedad	Tipo	Tamaño	Obligatorio	Descripción
codIntegracao	cadena	15	✓	Identificador único del archivo adjunto en el ERP. Tecla de inserción.
codProduto	cadena	50	✓	Código de producto al que pertenece el archivo adjunto.
codProdutoGrade	cadena	30		Código de calidad del producto (tabla 25).
tipoAnexo	cadena	20	✓	Opciones: `video`, `imagem`, `documento`, `url`.
título	cadena	255		Título del archivo adjunto (por ejemplo: `Manual do Produto`).
descripción	cadena	2000		Descripción del contenido o finalidad del archivo adjunto.
nomeArquivo	cadena	255	✓	Nombre del archivo en la descarga, con extensión. Opcional cuando `tipoAnexo` es `url`.
metodoArmazenamento	entero		✓	`1`: cárguelo en Demander (`arquivo` o `urlExterna` para copiar). `2`: almacenamiento externo (requiere `urlExterna`).
urlExterna	cadena	255		URL pública del archivo. Obligatorio si no envía `arquivo`, o cuando `metodoArmazenamento=2`. No informar junto con `arquivo`.
archivo	archivo			Archivo multiparte. Usado con `metodoArmazenamento=1`. Máximo 100 MB. No informar junto con `urlExterna`.
orden	entero			Orden de visualización de archivos adjuntos.

Retorno:

{
  "mensagem": "Anexo do produto criado com sucesso.",
  "codIntegracao": "ANX001"
}

Eliminar

Elimina el archivo adjunto.

Rota: {host}/public/v1/anexos-do-produto?codIntegracao={codIntegracao}
Método: DELETE

Retorno:

{
  "mensagem": "Registro excluído com sucesso."
}