Factuarea APIDevelopers
Millora

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). Amb target_type presentation, és la variant del mateix producte amb què es ven la presentació. Omet-lo, o envia null, 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_type configuration.
  • Valors rebutjats — una variant d’un altre producte, o variant_id amb qualsevol altre target_type, retorna 422 invalid_promotion_item amb param items.N.target_id.
  • On es retorna — cada article d’una oferta retorna variant_id, null si no hi ha parell, i selection_label diu «Tou · Caixa de 12».
  • Tools MCP — create_promotion i update_promotion accepten variant_id a cada article.

Les integracions que no envien el camp no necessiten canvis: un article sense variant_id es comporta com abans.