Sincronizar precios

Estos endpoints leen tus listas de precios y fijan precios por SKU y lista. Sirven para mantener los precios de Riqra alineados con tu ERP o sistema de gestión, incluidos precios distintos para grupos de clientes.

Cómo llegan los precios al comprador

Una lista de precios define cuánto cuesta cada variante. El comprador no elige la lista: la política comercial que le corresponde selecciona una, y el segmento al que pertenece la persona asigna esa política. Para que un grupo de clientes (por ejemplo, tus trabajadores o tus clientes VIP) vea precios distintos:

Crea la lista de precios en el panel y cárgala con esta API.
Crea una política comercial que seleccione esa lista.
Crea un segmento con esa política y asigna a las personas.

La API solo escribe precios. Las listas, políticas y segmentos se administran desde el panel. Revisa Listas de precios y Segmentos.

Endpoints

Acción	Endpoint	Scope
Listar listas activas	`GET /prices/lists`	`prices:read`
Fijar precios	`POST /prices/set`	`prices:write`

Listar las listas de precios

GET /prices/lists devuelve las listas activas con el id que necesitas para fijar precios.

curl "https://api-v2.riqra.com/public/v1/prices/lists" \
  -H "Authorization: Bearer rq_live_tu_api_key"

{
  "priceLists": [
    {
      "id": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b",
      "name": "Lista base",
      "sourcePriceListId": null,
      "adjustmentType": "NONE",
      "adjustmentValue": "0"
    },
    {
      "id": "1c3d4e6f-8a9b-4c1d-9e3f-4a5b6c7d8e9f",
      "name": "Empleados",
      "sourcePriceListId": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b",
      "adjustmentType": "PERCENT_DOWN",
      "adjustmentValue": "15.00"
    }
  ]
}

Una lista con sourcePriceListId en null es independiente: el precio de cada SKU es el que tú fijas. Una lista con sourcePriceListId es derivada: toma el precio de la lista origen y le aplica el ajuste (PERCENT_DOWN de 15.00 es un 15 % de descuento). En una lista derivada solo necesitas fijar los SKUs que se apartan de la regla.

Fijar precios

POST /prices/set recibe hasta 100 ítems. Cada ítem identifica un par SKU + lista y lleva exactamente uno de estos campos:

price: precio unitario plano. En una lista independiente es el precio de venta; en una lista derivada es un precio pactado que reemplaza al derivado.
tiers: la escalera completa de tramos por cantidad.

curl -X POST "https://api-v2.riqra.com/public/v1/prices/set" \
  -H "Authorization: Bearer rq_live_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "sku": "SKU-001", "priceListId": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b", "price": "12.50" },
      {
        "sku": "SKU-001",
        "priceListId": "1c3d4e6f-8a9b-4c1d-9e3f-4a5b6c7d8e9f",
        "tiers": [
          { "minQty": 1, "maxQty": 11, "price": "10.50" },
          { "minQty": 12, "maxQty": null, "price": "9.90" }
        ]
      }
    ]
  }'

La respuesta es 200 siempre que el cuerpo sea válido. Cada fila trae su propio status, en el mismo orden del pedido:

{
  "results": [
    { "sku": "SKU-001", "priceListId": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b", "status": 200 },
    { "sku": "SKU-001", "priceListId": "1c3d4e6f-8a9b-4c1d-9e3f-4a5b6c7d8e9f", "status": 200 }
  ]
}

Reglas

La escritura es absoluta: el valor enviado reemplaza al almacenado, no es un incremento.
price y tiers son excluyentes en un mismo ítem, y el que envías reemplaza al otro: un precio plano borra los tramos del par, y una escalera borra el precio plano.
Los precios viajan como string decimal, sin signo y con hasta cuatro decimales. Un tramo debe tener precio mayor a cero. Revisa Montos y moneda.
Una escalera empieza en cantidad 1, es contigua, solo el último tramo queda abierto (maxQty: null) y tiene como máximo 15 tramos. Revisa Tramos por cantidad.
El SKU debe coincidir exactamente con el de la variante, incluidas mayúsculas y minúsculas.
Un par SKU + lista repetido en el mismo pedido responde 400.
La API no elimina precios ni crea listas. Ambas cosas se hacen desde el panel.

Errores por fila

`code`	`status`	Cuándo
`SKU_NOT_FOUND`	`404`	Ninguna variante tiene ese SKU.
`PRICE_LIST_NOT_FOUND`	`404`	La lista no existe en tu organización.
`PRICE_LIST_INACTIVE`	`409`	La lista está inactiva. Actívala desde el panel.

Una fila con error no afecta a las demás: las filas válidas del mismo pedido se guardan.

Flujo recomendado

Resuelve las listas una vez

Llama a GET /prices/lists y guarda el id de cada lista con la que trabajas.

Envía lotes de hasta 100 pares

Agrupa los cambios por SKU y lista. Puedes mezclar precios planos y tramos en un mismo lote.

Revisa las filas con error

Filtra los results con status distinto de 200, corrige la causa (crear el SKU, activar la lista) y reenvía solo esas filas.

Los cambios se reflejan en la tienda de inmediato. El buscador de la tienda se actualiza unos segundos después.

Introducción

API

Temas

Sincronizar precios

Cómo llegan los precios al comprador

Endpoints

Listar las listas de precios

Fijar precios

Reglas

Errores por fila

Flujo recomendado

​Cómo llegan los precios al comprador

​Endpoints

​Listar las listas de precios

​Fijar precios

​Reglas

​Errores por fila

​Flujo recomendado

Cómo llegan los precios al comprador

Endpoints

Listar las listas de precios

Fijar precios

Reglas

Errores por fila

Flujo recomendado