> ## 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.

# Introducción

> La API pública de Retailgrid te permite enviar y extraer datos de productos, variantes, transacciones y competidores, además de exportar el contenido completo de los Grids, de forma programática.

La API pública de Retailgrid es la contraparte programática de los flujos de carga y exportación de la aplicación. Úsala cuando quieras mantener Retailgrid sincronizado con tus sistemas de origen de forma programada, o devolver datos enriquecidos a tu ERP y tus herramientas de BI, en lugar de subir y descargar archivos CSV a mano.

## URL base

```text theme={null}
https://clientapi.retailgrid.io
```

Todos los endpoints están bajo `/v1`. Los futuros cambios incompatibles se publicarán bajo un nuevo prefijo; las adiciones menores no cambiarán `/v1`.

## Qué puedes hacer hoy

* **Enviar datos del catálogo**: crear, modificar, eliminar y hacer upsert masivo de productos y variantes de producto.
* **Enviar transacciones**: crear, modificar, eliminar y hacer upsert masivo de transacciones de ventas.
* **Enviar precios de competidores**: crear, modificar, eliminar y hacer upsert masivo de precios de competidores observados.
* **Extraer catálogo y transacciones**: listar productos enriquecidos y transacciones de ventas para su ingesta en ERP / BI. Incluye las columnas personalizadas añadidas en el momento de la importación.
* **Extraer precios aprobados**: leer los precios finales que tu equipo aprobó en Price Approval, para sincronizarlos con tu ERP, tienda online o POS.
* **Exportar Grids**: listar los Grids de tu cuenta y extraer el contenido completo de las filas de cualquier Grid, incluidas las columnas canónicas, personalizadas y de fórmula / calculadas.
* **Subir archivos CSV de forma asíncrona**: enviar un CSV multipart a `/v1/imports/*` y consultar el estado de un trabajo (job).
* **Verificar tu clave de API**: comprobar que tu clave funciona antes de conectar una canalización.

> [!NOTE]
>
> Retailgrid indexa el catálogo a nivel de SKU. `item_id` es el identificador único obligatorio de cada artículo y la clave que se usa para vincular las transacciones, los datos a nivel de tienda y los precios de competidores con tu catálogo. `product_id` es un código opcional a nivel de producto que agrupa artículos / variantes relacionados bajo un mismo producto.

## Cuándo usar la API frente a otras vías

> **[API pública](https://docs.retailgrid.io/es/api-reference/quickstart.md)**
>
> Para una sincronización continua, de máquina a máquina, desde tu ERP, PIM o almacén, en cualquiera de los dos sentidos.

> **[Carga de CSV en la aplicación](https://docs.retailgrid.io/es/get-started/quickstart.md)**
>
> Para cargas puntuales o cuando un analista lleva el control. Los mismos datos, con un flujo manual.

> **[Conexiones de IA (MCP)](https://docs.retailgrid.io/es/settings/ai-connections.md)**
>
> Para preguntar a un asistente de IA sobre tus Grids en lenguaje natural y actuar sobre ellos de forma interactiva, en lugar de una sincronización programada.

## Convenciones

Vale la pena leer algunas cosas una vez antes de empezar a integrar:

* [Autenticación](https://docs.retailgrid.io/es/api-reference/authentication.md): cómo funcionan las claves Bearer y dónde emitir una.
* [Convenciones](https://docs.retailgrid.io/es/api-reference/conventions.md): endpoints masivos, trabajos asíncronos, decimales como cadenas, marcas de tiempo en UTC.
* [Importaciones frente a operaciones masivas](https://docs.retailgrid.io/es/api-reference/imports-vs-bulk.md): qué familia de endpoints elegir para cada tarea.
* [Errores](https://docs.retailgrid.io/es/api-reference/errors.md): códigos de estado y la forma de los errores de validación.

## Versionado

La versión actual es `v1`. Los cambios aditivos (campos nuevos, endpoints nuevos, parámetros opcionales nuevos) se publican sin previo aviso. Los cambios incompatibles se anunciarán en las [novedades de la API](https://docs.retailgrid.io/es/api-reference/changelog.md) y se publicarán bajo un nuevo prefijo de versión.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.