Actualizar variante

Esta operación te permite actualizar una variante existente dentro del catálogo.

Sigue los principios REST y se ajusta al estándar OData v4.01.

[PATCH] Endpoint de variante

https://api2.saleslayer.com/rest/Catalog/variants({variantId})

Realizar una solicitud

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

Ejemplo de cuerpo de la solicitud:

{
  "prod_id": 27,
  "frmt_stat": "V",
  "frmt_image": "variant_blue_color.png",
  "frmt_description": {
    "es": "Variante color azul del producto",
    "en": "Blue color variant of the product"
  }
}

Puedes actualizar uno o varios campos de la variante en la misma solicitud.

Respuesta

204 Sin contenido

La variante se ha actualizado correctamente. No se devuelve contenido adicional.

400 Solicitud incorrecta

Los errores habituales incluyen:

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

"prod_id does not exist or is invalid"

401 No autorizado

API key ausente o no válida.

403 Prohibido

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

404 No encontrado

La variante especificada en variantId 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 variante por llamada.
• Debes proporcionar un variantId válido y existente.
• No se admiten actualizaciones por lote.
• Los archivos y las imágenes deben existir previamente en la biblioteca.
• No es posible asociar más de un producto por variante.
• Todos los cambios realizados se registran automáticamente en el registro de actividad.

Compatibilidad con campos multidioma

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

Ejemplo de cuerpo multidioma:

{
  "frmt_description": {
    "es": "Variante de camiseta roja talla L",
    "en": "Red T-shirt variant size L"
  },
  "frmt_title": {
    "es": "Camiseta Roja L",
    "en": "Red T-Shirt L"
  }
}

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 los campos solo si:

• El campo está definido como multidioma en el Attribute Set.
• Los idiomas utilizados están admitidos en 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 realizas una solicitud PATCH sobre una variante:

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

Ejemplo:

{
  "frmt_ref": "RED-TSHIRT-L"
}

Solo se actualizará frmt_ref. Todos los demás campos de la variante permanecerán sin cambios.

Vaciar valores de campos

Ejemplo:

{
  "frmt_description": ""
}

La descripción de la variante se vaciará y quedará almacenada como un valor vacío.