Ofertes sobre una variant i una presentació alhora
Un article d’una oferta pot apuntar a una presentació venuda amb la seva variant, com a article propi amb el seu preu i el seu preu anterior. Cinc operacions d’ofertes actualitzades i dues tools MCP actualitzades.
5 de novembre de 2026 — Un producte sense configuracions declarades es ven com a variant més presentació («Tou · Caixa de 12»), i aquest parell té el seu propi preu. Ara una oferta hi pot apuntar.
- Camp nou a cada article —
variant_id(UUID, opcional). Ambtarget_typepresentation, és la variant del mateix producte amb què es ven la presentació. Omet-lo, o envianull, per a la presentació sola. - Article propi — el parell és un article diferent de la presentació sola i de la variant sola, de manera que els tres poden conviure a la mateixa oferta. Només cobreix aquest parell i té el seu propi historial de preus i el seu propi preu anterior legal.
- Configuracions declarades — un producte que declara les seves combinacions
continua apuntant a la configuració amb
target_typeconfiguration. - Valors rebutjats — una variant d’un altre producte, o
variant_idamb qualsevol altretarget_type, retorna422invalid_promotion_itemambparamitems.N.target_id. - On es retorna — cada article d’una oferta retorna
variant_id,nullsi no hi ha parell, iselection_labeldiu «Tou · Caixa de 12». - Tools MCP —
create_promotioniupdate_promotionacceptenvariant_ida cada article.
Les integracions que no envien el camp no necessiten canvis: un article sense
variant_id es comporta com abans.
Endpoints actualitzats5
| Endpoint | Descripció |
|---|---|
GET/v1/companies/{company}/promotions | Llistar totes les ofertes |
POST/v1/companies/{company}/promotions | Crear una oferta |
GET/v1/companies/{company}/promotions/{promotion} | Consultar una oferta |
PATCH/v1/companies/{company}/promotions/{promotion} | Actualitzar una oferta |
POST/v1/companies/{company}/promotions/{promotion}/cancel | Cancel·lar una oferta |