Actualizar categoría

Esta operación te permite actualizar una categoría existente dentro del catálogo.

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

Endpoint [PATCH] Categories

https://api2.saleslayer.com/rest/Catalog/Categories({categoryId})

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 categoryId es obligatorio. Es el identificador de la categoría que se va a actualizar.

Ejemplo de cuerpo de la solicitud:

{
  "cat_title": {
    "es": "Zapatos Deportivos",
    "en": "Sports Shoes"
  },
  "cat_parent_id": 3,
  "cat_stat": "V",
  "cat_description": "Categoría dedicada exclusivamente al calzado deportivo.",
  "cat_image": "zapatos_deportivos.png"
}

Puedes actualizar uno o varios campos de la categoría al mismo tiempo. No está permitido editar los campos cat_ref, cat_id, cat_creation, cat_parent_ref ni cat_parent_path, ya que son campos generados o gestionados automáticamente.

Respuesta

204 Sin contenido

La categoría se actualizó 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_parent_id does not exist or is invalid"

401 No autorizado

La API key falta o no es válida.

403 Prohibido

El usuario no tiene permisos para actualizar categorías.

404 No encontrado

La categoría indicada en categoryId 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

Fallo inesperado del sistema.

Limitaciones y consideraciones

• Solo se puede actualizar una categoría por solicitud.
• Debes proporcionar un categoryId válido y existente.
• No se admiten actualizaciones en bloque.
• Los archivos y las imágenes deben existir previamente en la biblioteca.
• No se permiten referencias circulares. Una categoría no puede tener como categoría padre a un descendiente directo o indirecto.
• Todos los cambios realizados se registran automáticamente en la actividad.

Compatibilidad con campos multidioma

Puedes incluir valores multidioma para los atributos configurados para admitir varios idiomas.

Ejemplo de cuerpo multidioma:

{
  "cat_title": {
    "es": "Calzado Urbano",
    "en": "Urban Footwear"
  }
}

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

Condiciones para los campos multidioma

Puedes enviar valores multidioma para un campo solo si:

• El campo está definido como multidioma en el attribute set.
• Los idiomas utilizados están admitidos por tu cuenta.

Errores habituales:

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

Comportamiento de la actualización parcial (PATCH)

Cuando haces una solicitud PATCH sobre una categoría:

• Solo se modifican los campos incluidos en el cuerpo de la solicitud.
• El resto de campos de la categoría permanecen sin cambios.

Ejemplo:

{
  "cat_description": "Nueva descripción de la categoría"
}

Solo se actualizará cat_description. El resto de campos de la categoría, como cat_title o cat_image, permanecerán sin cambios.

Vaciar valores de campos

Ejemplo:

{
  "cat_description": ""
}

La descripción de la categoría se vaciará y se guardará como un valor vacío.