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

# Importar y mapear datos CSV

> Sube un archivo de productos, ventas o competidores y deja que Retailgrid mapee sus columnas a los campos correctos con ayuda de la IA.

La forma más rápida de meter tus propios datos en Retailgrid es subir un archivo CSV o Excel y dejar que Retailgrid mapee sus columnas por ti. Úsala cuando tengas una exportación de un ERP, un archivo de proveedor o una hoja de cálculo y quieras tenerla en un Grid sin escribir código.

> [!NOTE]
>
> Existen otras dos vías para cargar datos. Conecta [Shopify](https://docs.retailgrid.io/es/settings/shopify.md) para una sincronización en vivo y con actualización automática de productos y ventas, o usa la [API REST pública](https://docs.retailgrid.io/es/api-reference/introduction.md) para extracciones programadas e integraciones con ERP/BI. La carga de archivos es la opción adecuada para cargas puntuales y para datos que no tienen una fuente en vivo.

## Qué puedes subir

Retailgrid acepta archivos **CSV** (preferiblemente UTF-8) y **XLSX**, con una fila por registro, para cada uno de los conjuntos de datos principales:

* **Products** - tu catálogo. Consulta la [especificación de datos de Products](https://docs.retailgrid.io/es/data-requirements/products.md).
* **Sales / transactions** - historial de ventas. Consulta la [especificación de datos de ventas](https://docs.retailgrid.io/es/data-requirements/sales.md).
* **Competitor prices** - ofertas de competidores observadas. Consulta la [especificación de datos de precios de competidores](https://docs.retailgrid.io/es/data-requirements/competitors.md).

Limita los archivos a datos en bruto: sin tablas dinámicas, sin fórmulas, un valor por celda.

## Subir y mapear

1. Inicia una carga desde la entrada de datos/carga de Retailgrid (el mismo flujo que usa el paso de creación de un Grid).
2. Elige el conjunto de datos al que pertenece el archivo (Products, Sales o Competitor prices) y selecciona tu archivo `.csv` o `.xlsx`.
3. Retailgrid lee la fila de cabecera y **propone un mapeo** de cada una de tus columnas a un campo de Retailgrid, usando los nombres de columna y los valores de muestra para hacer una propuesta asistida por IA.
4. Revisa el mapeo propuesto columna por columna. Confirma las coincidencias correctas, corrige las que no lo sean y deja una columna sin mapear si no tiene campo en Retailgrid.

La pantalla de mapeo muestra tus columnas de origen junto al campo de Retailgrid al que está mapeada cada una, de modo que puedes ver el mapeo de todo el archivo antes de confirmarlo.

## Campos obligatorios

Un archivo de Products debe resolver los campos obligatorios antes de poder importarse:

* `item_id` - el identificador único a nivel de SKU que vincula los datos de ventas, tiendas y competidores con el artículo.
* `product_name`
* `price` (el precio de venta actual)
* `unit_cost`

Retailgrid reconoce automáticamente muchos nombres de cabecera comunes (por ejemplo *Current Price* o *Actual Price* para `price`), así que el mapeo propuesto normalmente los rellena por ti. Los archivos de ventas y de competidores tienen sus propias claves obligatorias - consulta la especificación de cada conjunto de datos, enlazada arriba. `item_id` debe coincidir exactamente entre archivos, o las transacciones y los precios de competidores no podrán vincularse a los productos.

## Las columnas personalizadas también se conservan

Las columnas que no se mapean a un campo integrado de Retailgrid no se descartan - se conservan como **atributos personalizados** del registro y aparecen como columnas en tu Grid, de modo que puedes filtrar, agrupar y crear fórmulas con ellas. Mantén las columnas personalizadas con un solo valor por celda y un nombre coherente. (Los atributos personalizados se admiten en la carga CSV/XLSX; la API JSON rechaza los campos desconocidos - consulta [Carga mediante la API](https://docs.retailgrid.io/es/data-requirements/products.md).)

## Terminar y encontrar tus datos

Una vez confirmado el mapeo, Retailgrid importa el archivo en el conjunto de datos correspondiente (Products o Transactions). Los Grids construidos sobre ese conjunto de datos recogen las filas nuevas en la siguiente actualización, y las columnas que mapeaste - además de los atributos personalizados - están disponibles en el [panel Columns](https://docs.retailgrid.io/es/grids/configure-grid.md). Desde ahí puedes mostrar las columnas que necesites y empezar a fijar precios.

## Relacionado

* [Especificación de datos de Products](https://docs.retailgrid.io/es/data-requirements/products.md)
* [Especificación de datos de ventas](https://docs.retailgrid.io/es/data-requirements/sales.md)
* [Especificación de datos de precios de competidores](https://docs.retailgrid.io/es/data-requirements/competitors.md)
* [Crear un Grid](https://docs.retailgrid.io/es/grids/create-grid.md)
* [Conectar Shopify](https://docs.retailgrid.io/es/settings/shopify.md)
* [Introducción a la API](https://docs.retailgrid.io/es/api-reference/introduction.md)


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