> ## Documentation Index
> Fetch the complete documentation index at: https://docstiendas.apzsoftware.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar desde Excel

> Cargá productos, clientes, precios y más en lote a partir de una plantilla Excel.

Casi todos los módulos de carga de APZ-Tienda aceptan importación masiva desde Excel. El circuito es siempre el mismo: descargás la plantilla del módulo, la completás y la subís.

Usá la importación cuando arrancás con el sistema y tenés que cargar tu catálogo entero, o cuando recibís una lista de precios nueva de un proveedor.

## Módulos que aceptan importación

<Columns cols={2}>
  <Card title="Productos" href="/configuracion/productos" />

  <Card title="Tipos de producto" href="/configuracion/tipos-de-producto" />

  <Card title="Servicios" href="/configuracion/servicios" />

  <Card title="Tipos de servicio" href="/configuracion/tipos-de-servicio" />

  <Card title="Listas de precio" href="/configuracion/listas-de-precio" />

  <Card title="Clientes" href="/configuracion/clientes" />

  <Card title="Stock" href="/operacion/stock" />

  <Card title="Ventas" href="/operacion/ventas" />
</Columns>

## Cómo importar

<Steps>
  <Step title="Descargá la plantilla">
    En la pantalla del módulo, abrí el panel de importación y hacé clic en **Descargar**. Vas a bajar un archivo `.xlsx` con las cabeceras en español ya armadas.

    Descargá la plantilla cada vez, en lugar de reutilizar una vieja. Si el módulo sumó campos, una plantilla desactualizada te va a dar errores.
  </Step>

  <Step title="Completá el archivo">
    Cargá una fila por registro. No cambies los nombres de las cabeceras ni el orden de las columnas: el sistema las usa para saber qué es cada dato.
  </Step>

  <Step title="Subí el archivo">
    Arrastralo al recuadro de carga o hacé clic para elegirlo.

    Solo se aceptan archivos `.xlsx` de hasta 10 MB. Si exportaste desde Google Sheets o desde un sistema viejo, guardá como Excel antes de subir; los `.csv` y los `.xls` no sirven.
  </Step>

  <Step title="Revisá el reporte">
    Al terminar, el sistema te muestra cuántos registros creó, cuántos actualizó y qué filas tuvieron problemas.
  </Step>
</Steps>

## Cómo leer el reporte

El reporte separa el resultado en tres números:

* **Creados**: registros nuevos que no existían.
* **Actualizados**: registros que ya existían y se sobrescribieron con los datos del archivo.
* **Errores**: filas que no se pudieron procesar. Cada una te indica el número de fila y el motivo.

<Info>
  Una importación puede terminar parcialmente bien. Si de 100 filas 95 se cargaron y 5 fallaron, esas 95 quedan guardadas. Corregí las 5 filas en el Excel, borrá las que ya entraron y volvé a subir solo lo que falta.
</Info>

## Actualizar en lote, no solo crear

La importación no sirve únicamente para la carga inicial. Si subís un archivo con registros que ya existen, el sistema los actualiza en lugar de duplicarlos.

Es la forma más rápida de aplicar una lista de precios nueva: exportás, ajustás los valores en Excel y volvés a importar.

### Por qué campo reconoce un registro existente

| Módulo                | Campo que identifica el registro |
| --------------------- | -------------------------------- |
| Productos y servicios | **Código**                       |
| Clientes              | **Documento**                    |
| Listas de precio      | **Código** de la lista           |

Si el valor de ese campo ya existe en tu negocio, la fila actualiza el registro. Si no existe, lo crea.

<Tip>
  La plantilla de productos tiene además una columna **nuevo\_codigo**. Sirve para renombrar el código de un producto: en `codigo` ponés el actual y en `nuevo_codigo` el que querés dejarle. Es la única forma de cambiar un código sin perder el historial del producto.
</Tip>

## Antes de importar muchos registros

<Warning>
  Probá primero con un archivo de tres o cuatro filas. Una importación de 500 productos con un error de formato repetido en todas las filas te deja 500 registros para corregir a mano.
</Warning>

Otras cosas que conviene mirar antes de una carga grande:

* Que los tipos de producto o de servicio ya estén creados. Los productos no se pueden cargar sin su tipo.
* Que los números no tengan separador de miles ni símbolo de moneda.
* Que no haya filas vacías intercaladas ni espacios de más al final de los textos.