Crear producto

Esta operación te permite crear un nuevo producto en el catálogo.

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

Endpoint [POST] Products

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

Cómo hacer la petición

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

Ejemplo de body:

{

  "prod_ref": "PROD_001",

  "prod_title": "Auriculares Bluetooth",

  "prod_stat": "V",

  "prod_description": "Auriculares inalámbricos con cancelación de ruido",

  "prod_image": "auriculares01.jpg",

  "cat_id": "12",

  "typ_id": "3"

}

Puedes incluir atributos personalizados siempre que estén definidos previamente en el Attribute Set asociado al producto (typ_id). 

Consulta los atributos del ítem en el endpoint de metadata.

ℹ️ Actualmente solo está permitido vincular el producto a una única categoría (cat_id).

ℹ️ En los campos de imagen o archivo, deben indicarse por nombre si ya están cargados en el sistema. Esta operación no admite cargas directas.

Respuesta

201 Created

Si el producto 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/Products(3)

Ten en cuenta que la respuesta devuelve el prod_id para que pueda consultarse en otro endpoint GET de Product.

400 Bad Request

Hay un error en los datos enviados, como un formato incorrecto o campos no válidos o ausentes.

Ejemplo de body de respuesta

"Attribute prod_ref is mandatory"



//or



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

Limitaciones

• Permite crear un producto por llamada.
• La creación masiva de productos todavía no es compatible.
• Admite una categoría por producto.
• Todavía no admite la carga directa de recursos multimedia.

Compatibilidad con campos multidioma

Puedes incluir valores multidioma en los atributos configurados.

Cómo hacer la petición

• Usa el método HTTP: POST.
• Incluye la API key en las cabeceras de la petición para la autenticación.
• Indica el idioma preferido del contenido de la respuesta en el parámetro Accept-Language.
• El body debe enviarse en formato JSON.
• Debes incluir los atributos usando sus identificadores, no los nombres de base de datos.
• El campo prod_ref es obligatorio. Puedes incluir campos adicionales si ya están definidos en tu estructura de atributos.
• Los campos multidioma deben enviarse como objetos JSON con cada idioma compatible como clave.

Ejemplo de body

{

  "prod_ref": "PROD001",

  "prod_title": {

    "es": "Zapatillas Urbanas",

    "en": "Urban Sneakers"

  },

  "prod_stat": "V",

  "prod_description": {

    "es": "Calzado urbano para uso diario",

    "en": "Urban footwear for everyday use"

  },

  "prod_image": "zapatilla123.jpg",

  "cat_id": "5",

  "typ_id": "2"

}

Comprueba que el atributo admite multidioma y que los idiomas están habilitados en la cuenta.

Condiciones en campos multidioma

Puedes enviar atributos en varios idiomas siempre que:

• El campo esté configurado como multidioma en el Attribute Set (typ_id).
• Los idiomas estén disponibles en tu cuenta.

Errores habituales:

• Idioma no compatible -> Respuesta: 400 - Invalid language code
• El campo no es multidioma -> Respuesta: 400 - Attribute does not support multi-language