Factuarea APIDevelopers
Mejora

Ofertas sobre una variante y una presentación a la vez

Un artículo de una oferta puede apuntar a una presentación vendida con su variante, como artículo propio con su precio y su precio anterior. Cinco operaciones de ofertas actualizadas y dos tools MCP actualizadas.

5 de noviembre de 2026 — Un producto sin configuraciones declaradas se vende como variante más presentación («Blando · Caja de 12»), y ese par tiene su propio precio. Ahora una oferta puede apuntarle.

  • Campo nuevo en cada artículo — variant_id (UUID, opcional). Con target_type presentation, es la variante del mismo producto con la que se vende la presentación. Omítelo, o envía null, para la presentación sola.
  • Artículo propio — el par es un artículo distinto de la presentación sola y de la variante sola, así que los tres pueden convivir en la misma oferta. Solo cubre ese par y tiene su propio historial de precios y su propio precio anterior legal.
  • Configuraciones declaradas — un producto que declara sus combinaciones sigue apuntando a la configuración con target_type configuration.
  • Valores rechazados — una variante de otro producto, o variant_id con cualquier otro target_type, devuelve 422 invalid_promotion_item con param items.N.target_id.
  • Dónde se devuelve — cada artículo de una oferta devuelve variant_id, null si no hay par, y selection_label dice «Blando · Caja de 12».
  • Tools MCP — create_promotion y update_promotion aceptan variant_id en cada artículo.

Las integraciones que no envían el campo no necesitan cambios: un artículo sin variant_id se comporta como antes.