> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ayuda.gestionero.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Importar datos desde CSV

# Importar datos desde CSV

En esta guía vas a ver cómo cargar los datos de tu comercio desde planillas, sin tipear producto por producto.

Gestionero usa planillas **CSV** (un tipo de archivo de planilla que se puede guardar desde Excel). Acá vas a ver:

* El formato de cada importación.
* En qué orden conviene hacerlas.
* Las preguntas más comunes.

## ¿Qué datos puedo importar?

Hay ocho importaciones. Están en **Admin → Importar**, cada una con su botón:

| Botón | Qué importa |
| ---- | ---- |
| **Importar Productos** | Los productos que vendés. |
| **Importar Insumos** | Los productos que usás dentro de combos (caja, moño, bolsa). |
| **Importar Combos** | El contenido de cada combo (qué productos lleva y en qué cantidad). |
| **Importar Stock de Productos** | Las existencias de tus productos. |
| **Importar Stock de Insumos** | Las existencias de tus insumos. |
| **Importar Proveedores** | Tus proveedores. |
| **Importar Gastos** | Tus gastos y compras. |
| **Importar Ventas** | Ventas anteriores (por ejemplo, el historial de tu sistema anterior). |

## Orden de importación

Respetá este orden. Algunas importaciones necesitan que los productos ya estén cargados:

1. Importá tus **productos e insumos**.
2. Importá tus **combos** (necesita productos).
3. Importá tus **movimientos de stock** (necesita productos).
4. Importá tus **proveedores**.
5. Importá tus **gastos**.
6. Importá tus **ventas** (necesita productos).

## Plantillas

Cada importación tiene su plantilla (un archivo modelo).

1. Abrí la importación.
2. Tocá **Descargar plantilla**.
3. Completá las filas.
4. Volvé a subir el archivo.

La plantilla trae el encabezado correcto y filas de ejemplo.

## Reglas generales del formato

* **Delimitador** (el signo que separa las columnas): punto y coma (`;`).
* **Decimales:** escribí los decimales con **coma** (`1.200,50`).
  * El punto separa miles **solo** si el número son todos dígitos agrupados: `1.200` son mil doscientos.
  * No hace falta usar el punto de miles: `4200,50` vale igual que `4.200,50`.
* **Sí / No:** `Si` / `No`.
* **Codificación:** UTF-8 (el formato de texto que hay que elegir al guardar).

La regla es la misma para las ocho importaciones. Si el sistema no entiende un valor, la **vista previa** marca esa fila como **error**. Así la corregís antes de confirmar.

> **Ojo con Excel:** si editás la plantilla en Excel, pueden pasar dos cosas:
> * Los **códigos de barras** largos pasan a notación científica (`7,79E+12`).
> * Los códigos con ceros adelante pierden esos ceros.
>
> Para evitarlo, poné esas columnas en formato **Texto** antes de pegar los datos. Y guardá el archivo como **CSV UTF-8 (delimitado por punto y coma)**.

---

## 1. Productos

Cada fila es un producto que vendés.

| Columna | Descripción | Ejemplo |
| ---- | ---- | ---- |
| Id | Identificador numérico | `1` |
| Categoría | Nombre de la categoría | `Bebidas` |
| Subcategoría | Nombre de la subcategoría (opcional) | `Gaseosas` |
| Código | Código interno (opcional) | `GAS225` |
| Código de barras | Código EAN del producto (opcional) | `7790895000997` |
| Nombre | Nombre del producto | `Gaseosa cola 2,25 L` |
| Descripción | Descripción breve (opcional) | `Botella de 2,25 L` |
| Precio | Precio de venta | `2500,00` |
| Costo | Costo del producto | `1200,00` |
| Activo | Si está disponible | `Si` |

### Ejemplo

```
Id;Categoría;Subcategoría;Código;Código de barras;Nombre;Descripción;Precio;Costo;Activo
1;Bebidas;Gaseosas;GAS225;7790895000997;Gaseosa cola 2,25 L;Botella de 2,25 L;2500,00;1200,00;Si
2;Almacén;Infusiones;YER1K;7790387000107;Yerba mate 1 kg;;5200,50;3100,00;Si
3;Limpieza;;LAV1L;;Lavandina 1 L;;1450,00;700,00;Si
```

> El archivo que descargás trae los valores entre comillas (formato CSV estándar). Funciona igual que el ejemplo.

**Notas:**

* El **Código** es **opcional**. Si lo dejás vacío, Gestionero arma un código único a partir de la categoría. Por ejemplo, `BEB-001`.
* Si cargás a mano un código que ya existe, el sistema te avisa para que no se repita.
* El **Código de barras** es opcional. Si lo cargás, podés escanear el producto en **Vender**. Ver *Código de barras: cargar y escanear productos*.
* Si las categorías y subcategorías no existen, se crean solas.
* Cada subcategoría se crea **dentro de la categoría de su fila**. Por ejemplo, si tenés `Almacén;Sin TACC` y `Kiosco;Sin TACC`, quedan dos subcategorías «Sin TACC», una en cada categoría.
* Si ya existe un producto con el mismo nombre, se cuenta como **actualizado**. No se duplica.
* Si tenés **dos productos con el mismo nombre**, la importación usa siempre el **mismo**: el más reciente. Pasa igual cada vez que importás.
* El stock no se carga desde este archivo. Se importa aparte (ver el punto 4).

---

## 2. Insumos

Cada fila es un insumo: un producto que usás dentro de combos. Por ejemplo, la caja de una canasta.

| Columna | Descripción | Ejemplo |
| ---- | ---- | ---- |
| Id | Identificador numérico | `1` |
| Categoría | Nombre de la categoría | `Packaging` |
| Nombre | Nombre del insumo | `Caja canasta navideña` |
| Costo | Costo por unidad | `850,00` |
| Unidad | Unidad de medida (kg, l, un) | `un` |
| Merma | Porcentaje de merma | `0` |

### Ejemplo

```
Id;Categoría;Nombre;Costo;Unidad;Merma
1;Packaging;Caja canasta navideña;850,00;un;0
2;Packaging;Moño rojo;120,50;un;0
3;Packaging;Papel de regalo;3400,00;un;5
```

**Notas:**

* El código se arma solo.
* Si las categorías no existen, se crean solas.
* La **merma** es el porcentaje que se pierde o se desperdicia.
* Si tenés **dos insumos con el mismo nombre**, la importación usa siempre el mismo: el más reciente.
* El stock se importa aparte (ver el punto 4).

---

## 3. Combos

Cada fila une un producto con el combo que lo contiene. Un combo con 4 productos ocupa 4 filas.

| Columna | Descripción | Ejemplo |
| ---- | ---- | ---- |
| Producto | Nombre del combo (debe existir) | `Canasta navideña` |
| Componente | Nombre del producto o insumo que lleva (debe existir) | `Yerba mate 1 kg` |
| Cantidad | Cantidad de ese producto en el combo | `1` |
| Unidad | Unidad de medida | `un` |

### Ejemplo

```
Producto;Componente;Cantidad;Unidad
Canasta navideña;Yerba mate 1 kg;1;un
Canasta navideña;Alfajor triple;6;un
Canasta navideña;Caja canasta navideña;1;un
Pack 6 gaseosas;Gaseosa cola 2,25 L;6;un
```

El nombre exacto de las columnas de la plantilla de Combos en Gestionero. En la app original son `Producto;Ingrediente;Cantidad;Unidad`, y el glosario indica que en Importar pueden quedar textos como «Importar Recetas». Ajustar la tabla y el ejemplo a lo que traiga la plantilla real. También confirmar si el componente puede ser un producto vendible (no solo un insumo).

**Notas:**

* El combo y cada componente tienen que existir antes. Importá primero los productos e insumos.
* **La columna Unidad se respeta.** Podés cargar la cantidad en otra unidad de la misma familia. Por ejemplo, `500;g` para un producto que está en kg se importa como 0,5 kg.
* Si la unidad es de otra familia (por ejemplo, `l` para un producto en kg), esa fila da **error**.
* Si no se encuentra el combo o el componente, la fila se saltea y se cuenta como error.
* Si hay dos productos con el mismo nombre, se usa siempre el mismo: el más reciente.

---

## 4. Stock

Hay dos importaciones de stock: **Importar Stock de Productos** e **Importar Stock de Insumos**.

### Stock de productos

| Columna | Descripción | Ejemplo |
| ---- | ---- | ---- |
| Id | Identificador numérico | `1` |
| Categoría | Categoría del producto | `Bebidas` |
| Código | Código interno del producto | `GAS225` |
| Nombre | Nombre del producto | `Gaseosa cola 2,25 L` |
| Disponibilidad | Cantidad a ingresar | `48` |

```
Id;Categoría;Código;Nombre;Disponibilidad
1;Bebidas;GAS225;Gaseosa cola 2,25 L;48
2;Almacén;YER1K;Yerba mate 1 kg;24
3;Limpieza;LAV1L;Lavandina 1 L;36
```

### Stock de insumos

Mismo formato, pero sin la columna **Código**.

```
Id;Categoría;Nombre;Disponibilidad
1;Packaging;Caja canasta navideña;50
2;Packaging;Moño rojo;120
3;Packaging;Papel de regalo;8,5
```

**Notas:**

* Solo se importan las filas con **Disponibilidad mayor a 0**.
* El producto tiene que existir con ese código.
* Si reusaste el código de un producto archivado, la importación usa siempre el producto **activo**.
* Cada fila crea un movimiento de **ingreso**. Lo ves en **Productos → Movimientos de Stock**.

Si la plantilla de stock permite identificar el producto por código de barras o cargar stock por variante.

---

## 5. Proveedores

| Columna | Descripción | Ejemplo |
| ---- | ---- | ---- |
| Nombre | Nombre o razón social | `Distribuidora del Centro` |
| Email | Email de contacto (opcional) | `ventas@distcentro.com` |
| Teléfono | Teléfono de contacto | `1145678900` |
| Calle | Calle del domicilio | `Av. Corrientes` |
| Número | Altura | `1234` |
| Piso | Piso/depto (opcional) | `2B` |
| Ciudad | Ciudad | `CABA` |
| Nro. Fiscal | CUIT u otro número fiscal | `30712345678` |
| Balance | Saldo actual con el proveedor | `0,00` |
| Comentario | Comentario libre (opcional) | `Entrega los martes` |
| Activo | Si el proveedor está activo | `Si` |

```
Nombre;Email;Teléfono;Calle;Número;Piso;Ciudad;Nro. Fiscal;Balance;Comentario;Activo
Distribuidora del Centro;ventas@distcentro.com;1145678900;Av. Corrientes;1234;2B;CABA;30712345678;0,00;Entrega los martes;Si
Mayorista Limpieza Sur;;1156781234;Salta;850;;CABA;20345678901;15300,50;;Si
```

**Notas:**

* Al cargar un gasto, solo te aparecen como sugerencia los proveedores **activos**.
* Email, Piso y Comentario pueden quedar vacíos.
* El **CUIT** es el número de identificación fiscal del proveedor.

---

## 6. Gastos

| Columna | Descripción | Ejemplo |
| ---- | ---- | ---- |
| Id | Identificador numérico | `1` |
| Fecha | Fecha del gasto | `15/07/2026` |
| Fecha vencimiento | Fecha de vencimiento (opcional) | `30/07/2026` |
| Proveedor | Nombre del proveedor (debe existir) | `Distribuidora del Centro` |
| Categoría | Clasificación del gasto | `Mercadería` |
| Subcategoría | Subclasificación (opcional) | `Bebidas` |
| Comentario | Comentario libre (opcional) | `Compra semanal` |
| Estado del pago | Pagado / Pendiente | `Pagado` |
| Importe | Monto del gasto | `125400,50` |
| Caja | Caja desde la que se pagó (opcional) | `Caja 1` |
| Medio de pago | Medio de pago usado (opcional) | `Efectivo` |
| Tipo de comprobante | Factura A / Remito / etc. | `Factura A` |
| N° de comprobante | Número del comprobante | `0001-00012345` |
| Cancelado | Si el gasto está cancelado | `No` |

```
Id;Fecha;Fecha vencimiento;Proveedor;Categoría;Subcategoría;Comentario;Estado del pago;Importe;Caja;Medio de pago;Tipo de comprobante;N° de comprobante;Cancelado
1;15/07/2026;30/07/2026;Distribuidora del Centro;Mercadería;Bebidas;Compra semanal;Pagado;125400,50;Caja 1;Efectivo;Factura A;0001-00012345;No
2;16/07/2026;;Mayorista Limpieza Sur;Mercadería;Limpieza;;Pendiente;38200,00;;;Remito;R-00045;No
```

**Notas:**

* El proveedor tiene que existir antes. Importalo en el punto 5.
* Si el gasto todavía no se pagó, Caja y Medio de pago pueden quedar vacíos.

---

## 7. Ventas

Va **una fila por cada producto vendido**. Las filas con la misma **Fecha + Cliente + Total** se juntan en una misma venta.

| Columna | Descripción | Ejemplo |
| ---- | ---- | ---- |
| Fecha | Fecha y hora de la venta | `15/07/2026 10:30` |
| Cliente | Nombre del cliente (opcional) | `Juan Pérez` |
| Total | Total de la venta | `10200,00` |
| Estado | Estado de la venta | `Cerrada` |
| Tipo | Tipo de venta | `Local` |
| Medio de pago | Medio de pago usado | `Efectivo` |
| Producto | Nombre del producto (debe existir) | `Gaseosa cola 2,25 L` |
| Cantidad | Cantidad vendida | `2` |
| Precio | Precio unitario en la venta | `2500,00` |
| Comentario | Comentario libre (opcional) | `Pedido por teléfono` |

```
Fecha;Cliente;Total;Estado;Tipo;Medio de pago;Producto;Cantidad;Precio;Comentario
15/07/2026 10:30;Juan Pérez;10200,00;Cerrada;Local;Efectivo;Gaseosa cola 2,25 L;2;2500,00;
15/07/2026 10:30;Juan Pérez;10200,00;Cerrada;Local;Efectivo;Yerba mate 1 kg;1;5200,00;
15/07/2026 11:15;;1450,00;Cerrada;Local;Efectivo;Lavandina 1 L;1;1450,00;
```

En el ejemplo:

* Las dos primeras filas son la misma venta (misma Fecha, Cliente y Total).
* La tercera es otra venta, sin cliente.

**Notas:**

* Los productos tienen que existir antes. Importalos en el punto 1.
* El Cliente puede quedar vacío.

---

## Preguntas frecuentes

**¿Qué datos puedo importar?**
Productos, insumos, combos, stock de productos, stock de insumos, proveedores, gastos y ventas. Se hace desde **Admin → Importar**.

**¿Dónde descargo la plantilla?**
Abrí la importación (por ejemplo, **Importar Productos**) y tocá **Descargar plantilla**. Completá tus datos en ese archivo y volvé a subirlo.

**¿En qué orden importo los archivos?**
(1) Productos e insumos → (2) Combos → (3) Stock → (4) Proveedores → (5) Gastos → (6) Ventas.

**¿Cuál es el formato del CSV?**
* Punto y coma (`;`) para separar columnas.
* Decimales con coma (`1.200,50`).
* `Si` / `No` para los campos de sí o no.
* Codificación UTF-8.

**¿Qué pasa si un número no se puede interpretar?**
La vista previa marca esa fila como error. La corregís antes de confirmar.

**¿Puedo importar los códigos de barras?**
Sí, como una columna de la plantilla de productos. Ver *Código de barras: cargar y escanear productos*.

**¿Tengo que cargar un código para cada producto?**
No. Si lo dejás vacío, Gestionero arma uno a partir de la categoría.

**Importé un producto que ya existía. ¿Se duplicó?**
No. Si ya hay un producto con el mismo nombre, se actualiza.

**¿Puedo importar la misma subcategoría en dos categorías?**
Sí. Cada subcategoría se crea dentro de la categoría de su fila.

**¿Por qué no se importó el stock de algunos productos?**
Por una de estas dos razones:
* Solo se importan las filas con Disponibilidad mayor a 0.
* El producto tiene que existir con ese código.

**¿Qué pasa si en Combos uso una unidad distinta a la del producto?**
* Si es de la misma familia (g en lugar de kg), se convierte sola.
* Si es de otra familia (l en lugar de kg), la fila da error.

**¿Qué pasa si tengo dos productos con el mismo nombre?**
La importación usa siempre el mismo: el más reciente.

**Vengo de otro sistema. ¿Cómo traigo mis datos?**
1. Exportá tus productos, proveedores y ventas a Excel desde tu sistema anterior.
2. Pasalos a las plantillas de Gestionero.
3. Guardalos como CSV.

Si necesitás ayuda, escribinos desde el chat de soporte.

**¿Puedo cargar mi catálogo con una foto?**
No. Gestionero carga el catálogo a mano o desde planillas CSV.