Skip to main content
Estas novedades registran únicamente los cambios de la API pública de Retailgrid. Para los cambios de todo el producto, consulta las novedades principales.

​
2026-07-01 - Precios aprobados: lectura y confirmación

Las decisiones de precios finalizadas ya son accesibles de forma programática. Así, un ERP, una tienda online o un POS pueden extraer los precios aprobados según un calendario, en lugar de esperar una exportación manual. Añadido:
  • GET /v1/approved_prices - lista los precios aprobados en Price Approval, con filtros por Grid, tienda, ítem, SKU, fecha de aprobación y fecha de vigencia. Por defecto, el endpoint devuelve las exportaciones pendientes actuales; pasa history=true para obtener el historial registrado, incluidas las versiones canceladas. Consulta Listar precios aprobados.
  • POST /v1/approved_prices/acknowledge - confirma el procesamiento posterior de hasta 500 ids de aprobación, de modo que esos precios salen del conjunto pendiente. Esto permite que una integración haga el ciclo listar → aplicar → confirmar sin mantener su propia marca de agua. Devuelve 409 cuando el lote entra en conflicto con el estado actual de esas exportaciones.

​
2026-06-22 - Endpoints de producto-tienda; las variantes se integran en los productos

El catálogo se identifica a nivel de SKU (ítem). item_id es el identificador único obligatorio de cada ítem; product_id es ahora un código opcional a nivel de producto que agrupa ítems relacionados. Añadido:
  • Entidad REST Product store (producto-tienda) - GET /v1/product_store (listar), POST /v1/product_store (upsert), POST /v1/product_store/bulk y GET / PATCH / DELETE /v1/product_store/{entity_id} - precios, costos y stock por tienda, mercado o canal. Clave de upsert (item_id, store_id). Consulta Product store.
  • POST /v1/imports/product_store - importación CSV asíncrona para datos a nivel de producto-tienda. Consulta Importar CSV de producto-tienda.
Cambiado:
  • La creación de productos ahora requiere item_id (la clave única a nivel de SKU); product_id es opcional.
Eliminado:
  • POST / PATCH / DELETE /v1/product_variants/* y POST /v1/product_variants/bulk. El nivel de variante es ahora el producto a nivel de ítem, identificado por item_id. Migra las escrituras de variantes a los endpoints de Productos.

​
2026-06-03 - Ingesta a nivel de tienda

La ruta de ingesta ahora admite datos de producto a nivel de tienda. Los clientes que envían datos de forma programática pueden enviar varios precios por producto y por tienda, mercado o canal. Añadido:
  • Los endpoints de ingesta aceptan un store_id junto con item_id - un registro por combinación ítem-tienda, guardado según la especificación de datos de producto-tienda.
  • La semántica de upsert usa (item_id, store_id) como clave natural.
  • Cada registro entrante se valida contra las tiendas y productos existentes; los registros inválidos (tienda desconocida, claves duplicadas dentro de un lote) devuelven un 4xx con un código de error específico por fila.
Compatible con versiones anteriores: los payloads que omiten store_id se tratan a nivel de producto y se comportan exactamente como antes.

​
2026-05-21 - Endpoints de lectura

La API pública ahora lee además de escribir. La asimetría entre entrada y salida que los integradores señalaron en el lanzamiento de v1 queda cerrada. Añadido:
  • GET /v1/products - lista y filtra registros de producto enriquecidos, incluidas las columnas personalizadas de las importaciones de productos. Consulta Listar productos.
  • GET /v1/transactions - lista y filtra transacciones de ventas. Consulta Listar transacciones.
  • GET /v1/grids - lista los Grids de la cuenta, incluido un resumen del esquema de columnas y el número de filas por Grid. Consulta Listar Grids.
  • GET /v1/grids/{grid_id}/rows - exporta el contenido completo de las filas de un Grid (columnas canónicas, personalizadas y de fórmula/calculadas). Consulta Obtener filas del Grid.

​
2026-05-04 - Lanzamiento de v1

La primera versión pública de la API de Retailgrid está disponible en https://clientapi.retailgrid.io. Disponible ahora:
  • Auth - GET /v1/auth/verify para validar la clave. Tokens Bearer con el prefijo rg_live_.
  • Importaciones (CSV asíncrono) - productos, transacciones, precios de competidores.
  • Productos - upsert masivo, crear, modificar (patch), eliminar.
  • Variantes de producto - upsert masivo, crear, modificar (patch), eliminar.
  • Transacciones - upsert masivo, crear, modificar (patch), eliminar.
  • Precios de competidores - upsert masivo, crear, modificar (patch), eliminar.
  • Trabajos (jobs) - GET /v1/jobs/{job_id} para consultar el estado de las importaciones asíncronas.
Carencias conocidas que planeamos cerrar:
  • Compatibilidad con la cabecera Idempotency-Key en creaciones no idempotentes.
  • Un límite de uso documentado.
  • Callbacks por webhook al completarse un trabajo (en sustitución del sondeo).