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). Contarget_typepresentation, es la variante del mismo producto con la que se vende la presentación. Omítelo, o envíanull, 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_typeconfiguration. - Valores rechazados — una variante de otro producto, o
variant_idcon cualquier otrotarget_type, devuelve422invalid_promotion_itemconparamitems.N.target_id. - Dónde se devuelve — cada artículo de una oferta devuelve
variant_id,nullsi no hay par, yselection_labeldice «Blando · Caja de 12». - Tools MCP —
create_promotionyupdate_promotionaceptanvariant_iden cada artículo.
Las integraciones que no envían el campo no necesitan cambios: un artículo sin
variant_id se comporta como antes.
Endpoints actualizados5
| Endpoint | Descripción |
|---|---|
GET/v1/companies/{company}/promotions | Listar todas las ofertas |
POST/v1/companies/{company}/promotions | Crear una oferta |
GET/v1/companies/{company}/promotions/{promotion} | Consultar una oferta |
PATCH/v1/companies/{company}/promotions/{promotion} | Actualizar una oferta |
POST/v1/companies/{company}/promotions/{promotion}/cancel | Cancelar una oferta |