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

Precaución

Parámetros

• codProduto — obligatorio

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.

Precaución

Inclusión

• Es necesario enviar todos los atributos que sean obligatorios. Devuelve 200.

Actualización

• Sólo el atributo codIntegracao es obligatorio.
• Devolución 200.

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."
}