Saltar al contenido principal

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

PropertyTipoRequeridoDescripción
titlestringNombre visible (por ejemplo Retail Prices).
slugstringIdentificador.
typeenumprice (de cara al cliente) o cost (interno).
is_defaultbooleanNoSi esta es la list por defecto de su tipo.
badge_colorstringNoUn 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:
PropertyTipoRequeridoDescripción
item_code_idreferenceEl item (SKU) que se valora.
price_list_idreferenceLa list a la que pertenece este price.
pricenumberEl valor del precio.
volume_pricesarrayNoTiers por cantidad — ver abajo.

Volume pricing

Un price puede ofrecer precios unitarios más bajos a mayores cantidades:
[
  { "quantity": 10, "price": 87.99 },
  { "quantity": 20, "price": 86.99 },
  { "quantity": 50, "price": 84.99 }
]
La cantidad de cada tier debe ser un número entero mayor que 1 y única; los tiers se ordenan por cantidad. El precio base cubre la cantidad 1.

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.