Packs y un escaparate común para productos

Los packs y el escaparate web ya forman parte del contrato público. Están disponibles en todos los planes que incluyen productos, desde Esencial. Esencial admite hasta 5 packs sin archivar por cuenta y el resto de planes no tiene tope.

• Los packs tienen su propio recurso: composición, precio, disponibilidad, imágenes (hasta 5, con URL públicas y permanentes), view=storefront para webs, lecturas condicionales con ETag y un desglose de precio por tarifa, cliente (client_id), fecha y channel.
• Los productos comparten el contrato de escaparate: channels.web, slug, summary, seo, sale_price{net, tax, gross}, availability y alt, width y height de las imágenes. Una operación masiva publica o retira hasta 50 productos.
• Las líneas de documento admiten {pack_id, quantity, sold_on, unit_price, prices_include_tax, print_mode}. Una venta web cobrada se factura con el precio cobrado, al céntimo, aunque el pack se haya archivado después.
• Un pack se imprime igual en todos los documentos: cada producto en su línea, con el nombre del pack, y el ahorro bajo la última. print_mode solo admite full_breakdown.
• Las líneas de producto con unit_price admiten prices_include_tax por línea.
• Los webhooks añaden pack.created, pack.updated, pack.archived, pack.restored, pack.deleted y product.deleted.

Lee Packs y Tu tienda con Factuarea.

Eventos

Errores nuevos: 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 y pack_print_mode_not_allowed.

Contrato al día

Esta publicación también recoge los cambios finales del contrato de packs, ofertas y tarifas. Las operaciones afectadas figuran en la lista de abajo.

• Packs. sellable.code es un código estable y nullable (archived, inactive, out_of_window, no_channel, component_unsellable o price_unreachable) y null cuando el pack se puede vender. Modificar o borrar las imágenes de un pack de otra empresa responde 404 pack_not_found.
• Tarifas. Actualizar, eliminar o tocar los ítems de una tarifa de otra empresa responde 404 price_list_not_found. Eliminar un ítem inexistente responde el nuevo 404 price_list_item_not_found, con param item_id. Los errores de dominio duplicate_price_list_name, invalid_price_list_item, inactive_price_list y price_list_in_use llevan su code y su param.
• Idempotencia. Las escrituras de packs, ofertas y tarifas (19 escrituras) responden 409 idempotency_key_in_use mientras otra petición con la misma Idempotency-Key sigue en curso. Reintenta pasados unos segundos con la misma clave y el mismo cuerpo.
• Productos. Un filtro price[gte], price[lte] y similares con un valor no numérico responde 400 parameter_invalid_format, con param.
• Tope del plan. En el plan Esencial una cuenta admite hasta 5 packs sin archivar, activos o inactivos, entre todas sus empresas. POST /v1/companies/{company}/packs y POST /v1/companies/{company}/packs/{pack}/restore responden 402 plan_limit_exceeded con details.resource packs, current y limit cuando la cuenta está llena, y no guardan nada. Archiva o borra un pack para liberar una plaza, o amplía el plan. El resto de planes no tiene tope.
• Módulos. Los recursos packs y promotions de la v1 exigen el módulo products en cada petición y responden 403 feature_not_available_in_plan si falta. products y price-lists responden como hasta ahora. Una línea de pack por pack_id en un documento exige el módulo packs.
• Ofertas. El label admite como máximo 24 caracteres.
• Documentos. Los ejemplos de línea incluyen pack_group: null.