Packs i un aparador comú per a productes

Els packs i l'aparador web ja formen part del contracte públic. Estan disponibles a tots els plans que inclouen productes, des d'Esencial. Esencial admet fins a 5 packs sense arxivar per compte i la resta de plans no té límit.

• Els packs tenen el seu propi recurs: composició, preu, disponibilitat, imatges (fins a 5, amb URL públiques i permanents), view=storefront per a webs, lectures condicionals amb ETag i un desglossament de preu per tarifa, client (client_id), data i channel.
• Els productes comparteixen el contracte d'aparador: channels.web, slug, summary, seo, sale_price{net, tax, gross}, availability i alt, width i height de les imatges. Una operació massiva publica o retira fins a 50 productes.
• Les línies de document admeten {pack_id, quantity, sold_on, unit_price, prices_include_tax, print_mode}. Una venda web cobrada es factura amb el preu cobrat, al cèntim, encara que el pack s'hagi arxivat després.
• Un pack s'imprimeix igual a tots els documents: cada producte a la seva línia, amb el nom del pack, i l'estalvi sota l'última. print_mode només admet full_breakdown.
• Les línies de producte amb unit_price admeten prices_include_tax per línia.
• Els webhooks afegeixen pack.created, pack.updated, pack.archived, pack.restored, pack.deleted i product.deleted.

Llegeix Packs i La teva botiga amb Factuarea.

Esdeveniments

Errors nous: pack_not_found, slug_already_exists, pack_in_use, pack_composition_too_small, invalid_pack_component, duplicate_pack_component, invalid_pack_pricing, pack_price_unreachable, pack_price_allocation_impossible, invalid_pack_status_transition, pack_not_sellable, pack_image_limit_reached, pack_snapshot_invalid, pack_lines_must_be_expanded, pack_line_locked i pack_print_mode_not_allowed.

Contracte al dia

Aquesta publicació també recull els canvis finals del contracte de packs, ofertes i tarifes. Les operacions afectades figuren a la llista de sota.

• Packs. sellable.code és un codi estable i nullable (archived, inactive, out_of_window, no_channel, component_unsellable o price_unreachable) i null quan el pack es pot vendre. Modificar o esborrar les imatges d'un pack d'una altra empresa respon 404 pack_not_found.
• Tarifes. Actualitzar, eliminar o tocar els ítems d'una tarifa d'una altra empresa respon 404 price_list_not_found. Eliminar un ítem inexistent respon el nou 404 price_list_item_not_found, amb param item_id. Els errors de domini duplicate_price_list_name, invalid_price_list_item, inactive_price_list i price_list_in_use porten el seu code i el seu param.
• Idempotència. Les escriptures de packs, ofertes i tarifes (19 escriptures) responen 409 idempotency_key_in_use mentre una altra petició amb la mateixa Idempotency-Key continua en curs. Reintenta passats uns segons amb la mateixa clau i el mateix cos.
• Productes. Un filtre price[gte], price[lte] i similars amb un valor no numèric respon 400 parameter_invalid_format, amb param.
• Límit del pla. Al pla Esencial un compte admet fins a 5 packs sense arxivar, actius o inactius, entre totes les seves empreses. POST /v1/companies/{company}/packs i POST /v1/companies/{company}/packs/{pack}/restore responen 402 plan_limit_exceeded amb details.resource packs, current i limit quan el compte és ple, i no desen res. Arxiva o esborra un pack per alliberar una plaça, o amplia el pla. La resta de plans no té límit.
• Mòduls. Els recursos packs i promotions de la v1 exigeixen el mòdul products a cada petició i responen 403 feature_not_available_in_plan si falta. products i price-lists responen com fins ara. Una línia de pack per pack_id en un document exigeix el mòdul packs.
• Ofertes. El label admet com a màxim 24 caràcters.
• Documents. Els exemples de línia inclouen pack_group: null.