Crear variantes

Esta operación te permite crear una nueva variante de producto en el catálogo.

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

Endpoint de [POST] Variantes

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

Realizar una solicitud

• Usa el método HTTP: POST.
• Incluye tu API key en las cabeceras de la solicitud para la autenticación.
• El cuerpo debe enviarse en formato JSON.
• Usa identificadores de atributos válidos, no nombres de campos de base de datos.
• El campo frmt_ref es obligatorio.

Ejemplo de cuerpo de la solicitud:

{
    "frmt_ref": "VAR001",
    "prod_id": "004",
    "frmt_stat": "D",
    "frmt_tags": "IA",
    "frmt_link": "https://es.wikipedia.org/wiki/Tipo_variante"
}

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

Respuesta

201 Created

Si la variante 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/Variants(4)

Ten en cuenta que la respuesta devuelve el frmt_id, que es útil como referencia para futuras operaciones.

400 Bad Request

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

Ejemplo de cuerpo de respuesta

"Attribute cat_ref is mandatory"

O

"Product 32 not found."

o

"Invalid attribute name: Prod_id"

401 Unauthorized

API key ausente o no válida.

403 Forbidden

El usuario no tiene permisos para crear variantes.

404 Not Found

El producto referenciado (prod_id) no existe o se ha eliminado.

412 Precondition Failed

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

500 Internal Server Error

Fallo inesperado en la ejecución del código o error RPC no identificado.

Limitaciones

• Solo se permite una variante por solicitud.
• La creación masiva de variantes todavía no es compatible.
• El prod_id debe apuntar a un producto válido con estado distinto de X.
• Todos los campos enviados deben existir.
• Las imágenes o archivos deben existir previamente en el sistema. No se admite la carga directa.

Compatibilidad con campos multidioma

Si tu cuenta tiene campos multidioma configurados, puedes incluir valores en varios idiomas por atributo.

Realizar una solicitud

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

Ejemplo de cuerpo multidioma:

{
  "frmt_ref": "VAR002",
  "prod_id": 27,
  "frmt_stat": "V",
  "frmt_title": {
    "es": "Talla M",
    "en": "Size M"
  }
}

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 un campo solo si:

• El campo está definido como multidioma.
• El idioma es compatible con tu cuenta.

Errores habituales:

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