Resumen
Las Price Lists organizan los precios a los que se venden tus items. Una price list es un tier —Retail, Wholesale, Distributor— o una estructura de costo, y un price enlaza un item con una list a un valor específico. El mismo item puede llevar distintos precios entre lists, incluido volume pricing (descuentos por cantidad). Para el panorama, consulta el overview de Commerce. El pricing tiene tres piezas:- Item Codes — el SKU que conecta un product con el comercio.
- Price Lists — los tiers con nombre (o las cost lists).
- Prices — el valor de un item dentro de una list.
Price List
| Property | Tipo | Requerido | Descripción |
|---|---|---|---|
title | string | Sí | Nombre visible (por ejemplo Retail Prices). |
slug | string | Sí | Identificador. |
type | enum | Sí | price (de cara al cliente) o cost (interno). |
is_default | boolean | No | Si esta es la list por defecto de su tipo. |
badge_color | string | No | Un color para el badge de la list. |
Dos lists son especiales: la default price list y la default cost list.
Las orders nuevas toman de ellas el precio de venta y el costo de un item por
defecto.
Prices
Un price enlaza un item con una price list a un valor:| Property | Tipo | Requerido | Descripción |
|---|---|---|---|
item_code_id | reference | Sí | El item (SKU) que se valora. |
price_list_id | reference | Sí | La list a la que pertenece este price. |
price | number | Sí | El valor del precio. |
volume_prices | array | No | Tiers por cantidad — ver abajo. |
Volume pricing
Un price puede ofrecer precios unitarios más bajos a mayores cantidades:Item Codes
Un Item Code es el SKU que hace que un product sea ordenable, valorable y trackeable en inventory. Lleva el precio por defecto, el costo estándar y un markup calculado a partir de ambos.- El markup es
((precio por defecto − costo estándar) / costo estándar) × 100, recalculado cada vez que cambia el precio o el costo. - Los item codes se crean automáticamente cuando se configura un product con item codes — no por la API directamente.
- El precio y el costo por defecto se mantienen en sync con la default price list y la default cost list (cambia uno y el otro sigue).
Cómo llegan los precios a una order
Cuando agregas un line item, su precio unitario toma por defecto el price del item en la default price list (y su costo de la default cost list). Puedes sobrescribir el precio unitario en el renglón, y el descuento, el impuesto y los totales del renglón se calculan a partir de ahí. Consulta Orders.Seeds
Las price lists y los prices no están soportados actualmente en los Seeds.Gobernanza y permisos
Solo un super admin o un Master puede gestionar las price lists y los prices.Relacionado
Orders
Donde los precios se vuelven montos de line items.
Inventory
Niveles de stock para los mismos items.