> ## Documentation Index > Fetch the complete documentation index at: https://docs.retailgrid.io/llms.txt > Use this file to discover all available pages before exploring further. # Novedades de la API > Notas de versión de la API pública de Retailgrid, incluyendo nuevos endpoints, cambios incompatibles y actualizaciones de versión de cada lanzamiento. Estas novedades registran únicamente los cambios de la API pública de Retailgrid. Para los cambios de todo el producto, consulta las [novedades principales](https://docs.retailgrid.io/es/changelog/product-updates.md). ## 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](https://docs.retailgrid.io/es/agents/price-approval.md), 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](https://docs.retailgrid.io/es/api-reference/approved-prices/list.md). * `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](https://docs.retailgrid.io/es/api-reference/product-store/list.md). * `POST /v1/imports/product_store` - importación CSV asíncrona para datos a nivel de producto-tienda. Consulta [Importar CSV de producto-tienda](https://docs.retailgrid.io/es/api-reference/imports/product-store.md). **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](https://docs.retailgrid.io/es/api-reference/products/list.md). ## 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](https://docs.retailgrid.io/es/data-requirements/product-store-data.md). * 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](https://docs.retailgrid.io/es/api-reference/products/list.md). * `GET /v1/transactions` - lista y filtra transacciones de ventas. Consulta [Listar transacciones](https://docs.retailgrid.io/es/api-reference/transactions/list.md). * `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](https://docs.retailgrid.io/es/api-reference/grids/list.md). * `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](https://docs.retailgrid.io/es/api-reference/grids/get-rows.md). ## 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). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.