Precios

TradeCatalog calcula cada precio de cliente en un solo lugar, de la misma forma para la aplicación, el portal comercial, MCP y la API. Nunca calcula precios usted mismo.

Los productos configurados, tarifas medidas, umbrales de cantidad, extras netos y redondeo explícito también utilizan este servicio de precios. Cotice una línea completa con POST /products/{id}/quote; un precio faltante puede significar configurationRequired, mientras que una especificación no cotizada válida es Precio bajo solicitud. Utilice el total de línea devuelto. Vea configuración del catálogo de comercio para ver la precedencia, tratamiento neto y publicación.

¿Cómo se calculan los preciosEnlace a esta sección#

La regla más específica gana, y los ajustes nunca se acumulan:

1. Precio acordado. Si el cliente tiene un precio (fijo) acordado para el producto, ese es el precio.
2. De lo contrario, la precio de lista con un porcentaje, el primero que se aplique. Un porcentaje es un descuento (deducido) o un recargo (añadido):
   1. el porcentaje del cliente para ese producto
   2. el porcentaje del cliente para la categoría del producto (gana el más cercano)
   3. el porcentaje del cliente para la marca del producto
   4. el porcentaje del cliente en la lista completa
3. De lo contrario, el precio de lista.

Un descuento de categoría del 10% y un recargo de lista completa del 5% dan un 10% de descuento, no ambos. La unidad nunca es inferior a cero, y se redondea hacia arriba a una unidad menor entera. El total de la línea es unit × qty.

Los precios de lista y los precios acordados están versionados por fecha. La API siempre proporciona el precio válido ahora. Los precios futuros de un cambio programado se aplican desde su fecha.

Listas de precios y acceso al catálogoEnlace a esta sección#

Standard es el catálogo principal del proveedor. Otras listas de precios pueden contener productos con precios y productos que esperan una cotización. Una falta de precio en una lista asignada no se retrotrae a Standard.

En el espacio de trabajo, abra Listas de precios y elija una lista con nombre. Los clientes asignados pueden ver tiene dos opciones:

• Todos los productos del catálogo permitidos es el predeterminado. La lista establece los precios; los compradores asignados también pueden navegar por otros productos permitidos bajo solicitud de precio.
• Solo los productos de esta lista limita el catálogo, búsquedas, enlaces de productos y descargas, así como los nuevos pedidos de cada comprador asignado a los productos de esa lista. Todavía aplican la visibilidad de otros productos y las restricciones de listas aprobadas. Los clientes en otras listas mantienen su acceso existente.

Cada lista muestra su cantidad de clientes, productos con precio, productos sin precio y total de productos. Los totales incluyen productos inactivos, por lo que pueden superar lo que un comprador actualmente ve. Un precio cero se cuenta como un producto con precio. Un precio futuro se cuenta como un producto sin precio hasta su fecha de inicio.

Para agregar productos, selecciónelos en Productos, elija Agregar a lista de precios, luego copie los precios Estándar con un porcentaje opcional o seleccione Agregar sin precios. Los miembros existentes mantienen sus precios. Los productos sin precio Estándar se agregan como Precio bajo solicitud. En la página de una lista con nombre, guardar un SKU con un precio en blanco lo agrega sin precio o borra su precio actual. Eliminar lo quita de esa lista, manteniendo el producto principal y los pedidos anteriores. Resuelva primero cualquier cambio pendiente de precio para ese producto.

Estos controles requieren la versión Pro y derechos de edición globales de precios. Las listas existentes mantienen su acceso al catálogo hasta que un proveedor lo cambie. Las importaciones de API en una lista nombrada incluyen filas ordinarias de productos con ningún precio como miembros sin precio; una celda vacía en una importación solo de precios deja el acceso sin cambios.

El objeto de precioEnlace a esta sección#

Cada producto tiene price con esta forma. GET /prices devuelve los mismos campos en el nivel superior de data.

{
  "unit": 1573,
  "line": 15730,
  "list": 1850,
  "discountBp": 1500,
  "adjustment": "discount",
  "source": "brand",
  "label": "15% off your list",
  "remark": null
}

Verificar el precio de un clienteEnlace a esta sección#

GET/api/v1/prices

Cuánto paga un cliente por un SKU en una cantidad, y por qué. Úselo para responder "¿Cuánto paga Oakfield por 10 cajas de HX-8510?".

curl "https://tradecatalog.app/api/v1/prices?customer=OAK01&sku=HX-8510&qty=10" \
  -H "Authorization: Bearer $TRADECATALOG_API_KEY"

const params = new URLSearchParams({
  customer: 'OAK01',
  sku: 'HX-8510',
  qty: '10',
})
const res = await fetch(`https://tradecatalog.app/api/v1/prices?${params}`, {
  headers: { Authorization: `Bearer ${process.env.TRADECATALOG_API_KEY}` },
})
const { data: price, currency } = await res.json()

{
  "data": {
    "customer": {
      "id": "7d2e4f0a-1b3c-4d5e-8f90-a1b2c3d4e5f6",
      "accountCode": "OAK01",
      "name": "Oakfield Joinery"
    },
    "sku": "HX-8510",
    "name": "Hex bolt M10 x 50 zinc",
    "qty": 10,
    "unit": 1573,
    "line": 15730,
    "list": 1850,
    "discountBp": 1500,
    "source": "brand",
    "label": "15% off your list",
    "remark": null
  },
  "currency": "GBP"
}

Este punto final verifica solo el precio. No verifica si el cliente puede ver el producto. Para eso, use GET /products/{id}?customer=….

Precios para muchos productosEnlace a esta sección#

Para precioar una página completa de productos para un cliente, use GET /products?customer=OAK01. El price de cada fila es el precio de ese cliente, y los productos exclusivos para otros clientes se omiten. Vea Productos.

Cambiar preciosEnlace a esta sección#

• Precios de lista cambian mediante cambios de precios, por lo que los clientes reciben notificación. Envíe nuevos precios con PUT /products; van a un borrador que publica en la aplicación.
• Recargos, descuentos y precios acordados se establecen por cliente en la aplicación. Léalos con GET /customers/{id}.
• Precios acordados para muchos clientes se establecen con PUT /agreed-prices.
• El porcentaje de toda la lista de un cliente se puede establecer con PUT /customers (discountBp, y opcional adjustment).

Establecer precios acordadosEnlace a esta sección#

PUT/api/v1/agreed-pricesescribir clave

Crear o reemplazar precios acordados para clientes y productos existentes. Envíe hasta 2.000 filas. Los precios son unidades menores enteras. Deje commit en falso para previsualizar: nada se guarda, y cada cuenta o SKU desconocida vuelve como un error de fila. Establezca commit en verdadero para guardar. Guardar cierra el precio acordado válido ahora e inserta el nuevo desde este momento, en lotes de 100. Solo para Pro.

curl -X PUT https://tradecatalog.app/api/v1/agreed-prices \
  -H "Authorization: Bearer $TRADECATALOG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"commit":false,"prices":[{"accountCode":"OAK01","sku":"HX-8510","price":1250,"note":"Contract"}]}'