Cambios de precio · Documentación de TradeCatalog

Los cambios masivos, programación y correos electrónicos de cambios de precio para clientes requieren Pro. Free puede publicar importaciones de hojas de cálculo de precios estándar de inmediato sin correos electrónicos. Los precios acordados existentes y los cambios programados publicados continúan aplicándose cuando finaliza Pro.

Los precios de lista nunca cambian de forma silenciosa en TradeCatalog. Los nuevos precios van a un cambio de precio para una lista de precios: un borrador que el personal revisa, fecha y publica. Los clientes solo reciben un correo electrónico cuando sus propios precios cambian. Standard es la lista cuando no se nombra otra.

Cómo se realizan los cambios de precioEnlace a esta sección#

Desde la API: PUT /products con un nuevo listPrice para un producto existente lo agrega a un borrador y devuelve el priceChangeId del borrador.
Desde la aplicación: importaciones de hojas de cálculo, y cambios masivos como «+4% en la categoría de Tuercas».

La publicación, programación y cancelación ocurren en la aplicación, bajo Cambios de precio. No hay API para ellos: siempre una persona revisa un cambio de precio antes de que los clientes lo vean.

EstadosEnlace a esta sección#

Estado	Significado
`draft`	No publicado. No han cambiado precios.
`scheduled`	Publicado con una fecha futura. Los precios cambian en esa fecha.
`live`	En vigor.
`cancelled`	Cancelado antes de que entrara en vigor.

El objeto de cambio de precioEnlace a esta sección#

json

{
  "id": "c4d5e6f7-1234-4abc-9def-0123456789ab",
  "source": "import",
  "title": "API import (Sage stock sync)",
  "supplierNote": null,
  "status": "draft",
  "effectiveAt": null,
  "notifyCustomers": true,
  "raiseFixedPrices": false,
  "priceListId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "priceListName": "Standard",
  "createdBy": "Fq3L0cZ7tN1pW9aYx2Rk",
  "publishedAt": null,
  "cancelledAt": null,
  "createdAt": "2026-09-27T02:00:14.000Z",
  "items": 38
}

Campo	Tipo	Descripción
`source`	string	`import` (hoja de cálculo o API) o `bulk` (un cambio porcentual realizado en la aplicación).
`title`	string	Mostrado al personal. Los borradores de API tienen el título «Importación de API (nombre de clave)».
`supplierNote`	string o nulo	Mensaje a los clientes en el correo electrónico de cambio de precio.
`status`	string	Véase estados.
`effectiveAt`	string o nulo	Cuándo aplican los nuevos precios.
`notifyCustomers`	booleano	Si los clientes reciben un correo electrónico con sus nuevos precios.
`raiseFixedPrices`	booleano	Si los precios acordados aumentan en el mismo porcentaje. Esta opción es independiente de la lista.
`priceListId`	string o nulo	La lista a la que se escribe este cambio. Nulo significa Standard, incluyendo cambios realizados antes de que se nombraran listas.
`priceListName`	string	El nombre de esa lista. `Standard` cuando `priceListId` es nulo.
`createdBy`	string o nulo	Id de la persona que lo realizó. Para borradores de API, la persona que creó la clave.
`items`	entero	Cuántos productos cambia. Solo en la lista.

Cambios de precio de listaEnlace a esta sección#

GET/api/v1/price-changes

Más recientes primero. Cubre los 100 cambios de precio más recientes.

Nombre	Tipo	Requerido	Descripción
`limit`	entero	no	1 a 100. Valor predeterminado 100.
`offset`	entero	no	Número de filas a omitir. Valor predeterminado 0.

bash

curl https://tradecatalog.app/api/v1/price-changes \
  -H "Authorization: Bearer $TRADECATALOG_API_KEY"

const res = await fetch('https://tradecatalog.app/api/v1/price-changes', {
  headers: { Authorization: `Bearer ${process.env.TRADECATALOG_API_KEY}` },
})
const { data: changes } = await res.json()
const drafts = changes.filter((change) => change.status === 'draft')

Vista previa de un cambio de precioEnlace a esta sección#

GET/api/v1/price-changes/{id}

Todo lo que el personal ve antes de publicar: cuántos precios suben y bajan, los mayores movimientos, advertencias y cuántos precios acordados afecta. Pase customer para ver los precios propios del cliente antes y después.

Nombre	En	Tipo	Requerido	Descripción
`id`	path	string	sí	Id del cambio de precio.
`customer`	query	string	no	Id del cliente o código de cuenta.

bash

curl "https://tradecatalog.app/api/v1/price-changes/c4d5e6f7-1234-4abc-9def-0123456789ab?customer=OAK01" \
  -H "Authorization: Bearer $TRADECATALOG_API_KEY"

const res = await fetch(
  `https://tradecatalog.app/api/v1/price-changes/${priceChangeId}?customer=OAK01`,
  { headers: { Authorization: `Bearer ${process.env.TRADECATALOG_API_KEY}` } },
)
const { data: preview } = await res.json()
if (preview.warnings.length)
  console.warn('Check these before publishing', preview.warnings)

json

{
  "data": {
    "change": {
      "id": "c4d5e6f7-1234-4abc-9def-0123456789ab",
      "source": "import",
      "title": "API import (Sage stock sync)",
      "supplierNote": null,
      "status": "draft",
      "effectiveAt": null,
      "notifyCustomers": true,
      "raiseFixedPrices": false,
      "priceListId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "priceListName": "Standard",
      "createdBy": "Fq3L0cZ7tN1pW9aYx2Rk",
      "publishedAt": null,
      "cancelledAt": null,
      "createdAt": "2026-09-27T02:00:14.000Z"
    },
    "counts": { "total": 38, "up": 36, "down": 2 },
    "biggest": [
      {
        "productId": "3f8a2c1e-9b4d-4e6f-a7c8-1d2e3f4a5b6c",
        "oldPrice": 1850,
        "newPrice": 1950,
        "sku": "HX-8510",
        "name": "Hex bolt M10 x 50 zinc",
        "changeBp": 541
      }
    ],
    "warnings": [],
    "fixedAffected": 3,
    "customer": {
      "name": "Oakfield Joinery",
      "rows": [
        {
          "sku": "HX-8510",
          "name": "Hex bolt M10 x 50 zinc",
          "before": 1573,
          "after": 1658,
          "label": "Brand discount −15%"
        }
      ]
    }
  },
  "currency": "GBP"
}

Campo	Descripción
`counts`	Productos en el cambio, y cuántos suben y bajan.
`biggest`	Hasta 20 artículos con el mayor porcentaje de cambio. `changeBp` es el cambio en puntos básicos (541 = +5,41%).
`warnings`	Artículos que cambian más del 30% en cualquier dirección, o llegan a cero. Normalmente errores de escritura.
`fixedAffected`	Precios acordados en estos productos que son válidos ahora. Solo cambian si el cambio eleva los precios acordados.
`customer`	Con `customer`: los precios unitarios de este cliente antes y después, de su propia lista y luego su ajuste, para los primeros 50 artículos como máximo. Un cliente en otra lista no se ve afectado. `null` sin él.

404 not_found si no hay ningún cambio de precio en este espacio de trabajo.