Actualizar producto

Esta operación te permite actualizar un producto existente dentro del catálogo.

Sigue los principios REST y está alineada con el estándar OData v4.01.

Endpoint [PATCH] de producto

https://api2.saleslayer.com/rest/Catalog/Products({productId})

Hacer una solicitud

• Usa el método HTTP: PATCH.
• Incluye la API key en las cabeceras de la solicitud para autenticarte.
• El cuerpo debe enviarse en formato JSON con identificadores válidos para cada campo.
• El parámetro productId es obligatorio. Es el identificador del producto que se va a actualizar.

Ejemplo de cuerpo de la solicitud:

{
  "prod_title": {
    "es": "Zapatillas Urbanas",
    "en": "Urban Sneakers"
  },
  "prod_stat": "V",
  "prod_description": {
    "es": "Calzado urbano con diseño moderno",
    "en": "Urban shoes with modern design"
  },
  "prod_image": "urban_shoes.jpg"
}

Puedes actualizar uno o varios campos del producto en una sola solicitud. No está permitido editar los campos prod_id, prod_clone_id, prod_creation, prod_ref o cat_ref, ya que se generan automáticamente o se gestionan internamente.

Respuesta

204 Sin contenido

El producto se ha actualizado correctamente. No se devuelve contenido.

400 Solicitud incorrecta

Los errores habituales incluyen:

• Formato JSON incorrecto.
• Campos no válidos o ausentes.
• Valores de campo que no cumplen las restricciones.

"cat_id does not exist or is invalid"

401 No autorizado

La API key no existe o no es válida.

403 Prohibido

El usuario no tiene permisos para realizar esta operación.

404 No encontrado

El producto indicado en productId no existe.

412 Error de condición previa

El sistema no está en un estado válido para realizar la operación.

500 Error interno del servidor

Se ha producido un fallo inesperado en el sistema.

Limitaciones y consideraciones

• Solo se puede actualizar un producto por llamada.
• Debes indicar un productId válido y existente.
• No se admiten actualizaciones en lote.
• Los archivos y las imágenes deben existir previamente en la biblioteca.
• Solo se puede vincular una categoría por producto.
• Todas las actualizaciones se registran automáticamente en el changelog.

Compatibilidad con campos multidioma

Puedes incluir valores multidioma en los atributos que estén configurados para admitir varios idiomas.

Ejemplo de cuerpo multidioma:

{
  "prod_title": {
    "es": "Zapatillas Urbanas",
    "en": "Urban Sneakers"
  },
  "prod_description": {
    "es": "Calzado urbano para uso diario",
    "en": "Urban footwear for everyday use"
  }
}

Asegúrate de que el atributo admita varios idiomas y de que esos idiomas estén habilitados en tu cuenta.

Condiciones de los campos multidioma

Solo puedes enviar valores multidioma para campos si:

• El campo está definido como multidioma en el attribute set.
• Los idiomas utilizados son compatibles con tu cuenta.

Errores habituales:

• Idioma no compatible → 400 - Invalid language code
• Campo no multidioma → 400 - Attribute does not support multi-language

Comportamiento de actualización parcial (PATCH)

La API admite actualizaciones parciales mediante el método PATCH.

Cuando realizas una solicitud PATCH sobre un producto:

• Solo se modifican los campos incluidos en el cuerpo de la solicitud.
• Todos los demás campos del producto permanecen sin cambios.

Ejemplo:

{
  "prod_ref": "NEW-REF-001"
}

En este ejemplo, solo se actualizará prod_ref. Todos los demás campos del producto, como prod_title y prod_description, permanecerán sin cambios.

Vaciar valores de campos

Si un campo se envía con un valor vacío, su contenido se eliminará.

Ejemplo:

{
  "prod_description": ""
}

En este caso, la descripción actual del producto se eliminará y quedará guardada como vacía.

Los clientes deben asegurarse de que los valores vacíos se envían de forma intencionada.