Crear categoría

Esta operación te permite crear una nueva categoría en el catálogo.

Sigue los principios de la arquitectura REST y cumple con el estándar OData v4.01.

Endpoint [POST] Categories

https://api2.saleslayer.com/rest/Catalog/Categories

Realizar una solicitud

• Usa el método HTTP: POST.
• Incluye la API key en las cabeceras de la solicitud para la autenticación.
• El cuerpo debe enviarse en formato JSON.
• Debes incluir los atributos usando sus identificadores, no los nombres de base de datos.
• El campo cat_ref es obligatorio.

Ejemplo de cuerpo de la solicitud:

{
  "cat_ref": "CAT001",
  "cat_title": "Calzado de hombre",
  "cat_stat": "D",
  "cat_description": "Categoría para productos de calzado de hombre",
  "cat_image": "cat_men.png",
  "cat_parent_id": 2
}

Puedes incluir atributos multidioma y de medios si se han definido previamente en la configuración de tu cuenta.

Respuesta

201 Created

Si la categoría se ha creado correctamente.

Ejemplo de cabeceras de respuesta:

content-length: 0
date: Tue, 27 May 2025 23:06:09 GMT
location: https://api2.saleslayer.com/rest/Catalog/Categories(3)

Ten en cuenta que la respuesta devuelve el cat_id, que te será útil como referencia en el futuro.

400 Bad Request

Se ha producido un error en los datos enviados, por ejemplo, un formato no válido o campos ausentes o incorrectos.

Ejemplo de cuerpo de respuesta

"Attribute cat_ref is mandatory"

O

"Missing file name(s):Cat_men2.png."

Limitaciones

• Solo se puede crear una categoría por solicitud.
• No se admite la creación masiva de categorías.
• Solo se puede asignar un cat_parent_id.
• Las imágenes y los archivos deben existir previamente en la biblioteca multimedia.

Compatibilidad con campos multidioma

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

Realizar una solicitud

• Usa el método HTTP: POST.
• Incluye tu API key en las cabeceras de la solicitud.
• Especifica el idioma preferido usando la cabecera Accept-Language.
• El cuerpo debe enviarse en formato JSON.
• El campo cat_ref es obligatorio.
• Los campos multidioma deben enviarse como objetos JSON con cada idioma compatible como clave.

Ejemplo de cuerpo multidioma:

{
  "cat_ref": "CAT002",
  "cat_title": {
    "es": "Zapatillas",
    "en": "Sneakers"
  },
  "cat_stat": "V",
  "cat_description": {
    "es": "Calzado deportivo y urbano",
    "en": "Urban and sport footwear"
  },
  "cat_image": "sneakers_banner.jpg"
}

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

Condiciones de los campos multidioma

Puedes enviar valores multidioma para campos solo 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