Upnify Documentación API
CRM · /catalogos/productos/imagenes/lote

Catálogos

Carga masiva de imágenes de productos

PUT/catalogos/productos/imagenes/lote

Permite cargar y asociar una imagen a cada producto de un lote mediante una solicitud multipart/form-data. El campo payload debe contener un JSON con el arreglo products; cada elemento requiere tkProducto, imagen y fileKey, y este último debe coincidir con el nombre del archivo multipart. Solo se admiten imágenes PNG, JPG o JPEG de hasta 5 MB.

Parámetros

NombreTipoValidaciónDescripción
payloadStringRequeridoJSON serializado con un arreglo products de al menos un elemento.
productsArray<Object>RequeridoArreglo de productos a procesar dentro de payload. No puede contener productos duplicados.
tkProductoStringRequeridoIdentificador del producto que recibirá la imagen.
imagenStringRequeridoNombre de la imagen que se asociará al producto.
fileKeyStringRequeridoNombre del campo multipart que contiene el archivo correspondiente. No puede repetirse en el lote.
imagen_0FileRequeridoArchivo de imagen cuyo nombre de campo debe coincidir con el fileKey del elemento correspondiente. Sustituye imagen_0 por cada fileKey adicional.

Respuesta

NombreTipoDescripción
codeIntegerCódigo del resultado. Es 200 cuando todo el lote se actualiza correctamente y 207 cuando hay errores parciales.
msgStringMensaje que describe el resultado del lote.
detailsArray<Object>Resumen del lote procesado.
processedIntegerCantidad de productos recibidos en el lote.
updatedIntegerCantidad de productos actualizados correctamente.
errorsArray<Object>Errores por producto. Es un arreglo vacío cuando no hay errores.

Solicitud

Cargar imágenes de productos

curl --request PUT \
  --url 'https://api.upnify.com/v4/catalogos/productos/imagenes/lote' \
  --header 'token: 00000000-0000-4000-8000-000000000001' \
  --form 'payload={"products":[{"tkProducto":"PRO-00000000-0000-4000-8000-000000000010","imagen":"imagen-producto.png","fileKey":"imagen_0"}]}' \
  --form 'imagen_0=@/ruta/a/imagen-producto.png'

Respuesta

Lote actualizado

JSON
[
  {
    "code": 200,
    "msg": "Ok",
    "details": [
      {
        "processed": 1,
        "updated": 1,
        "errors": []
      }
    ]
  }
]