# Importar y exportar con Excel

La importación añade a una lista registros de un archivo de Excel y actualiza los que ya existen. La exportación guarda todos los registros de una lista en un archivo. Un archivo exportado se puede editar en Excel y volver a cargar sin ninguna preparación.

Los dos botones, «Importar desde Excel» y «Exportar a Excel», están encima de la tabla de registros: en la sección «Listas» del bot, en la sección «Listas» del proyecto y en la ventana de listas que se abre desde un bloque del flujo.

## Preparar un archivo para importar

- **Formato**: un libro de Excel, `.xlsx`, de hasta 50 MB.
- **Hoja**: solo se lee la primera hoja del libro.
- **Fila de encabezados.** Mientras «La primera fila son encabezados» esté marcada en el primer paso, la primera fila del archivo se omite. Si el archivo no tiene encabezados, desmárcala; si no, el primer registro no se cargará.
- **Sin filas vacías.** La importación se detiene en la primera fila en la que todas las columnas elegidas para los campos están vacías.
- **Una fila es un registro**, una columna es un campo de la lista.

Qué debe contener una celda:

| Tipo de campo | Valor en la celda |
|---|---|
| «Texto» | Cualquier valor; se guarda como texto |
| «Número» | Un número |
| «Dinero» | El importe como número, sin el símbolo de la moneda: `1500` o `1500.50` |
| «Sí/No» | `1` = «Sí», `0` = «No». Una celda vacía no cambia el valor; en un registro nuevo es «No» |
| «Fecha», «Fecha y hora» | Una celda con formato de fecha, o texto como `2026-10-02 14:30:00`, `2026-10-02`, `02.10.2026` |
| «Archivo», «Imagen» | Un enlace público al archivo que empiece por `http://` o `https://` |
| «ID del contacto» | El número de un contacto de uno de tus bots |
| «ID del bot» | El número de tu bot |

> [!IMPORTANT]
> La plataforma no descarga los archivos ni las imágenes de los enlaces: el bot entrega el archivo a la persona directamente desde tu dirección. Los enlaces deben seguir funcionando mientras el bot use la lista.

## El campo único

El campo único es el campo por el que la importación reconoce un registro: la referencia de un producto, un número de pedido, un código promocional. Para cada fila del archivo, la importación busca en la lista un registro con el mismo valor de este campo:

- si encuentra el registro, lo actualiza;
- si no existe, añade uno nuevo.

Elegir el campo único es obligatorio. Una fila en la que está vacío se rechaza, salvo que la fila contenga el ID de un registro existente (consulta más abajo).

Una actualización solo cambia los campos que tienen valor en la fila. Una celda vacía no borra el valor anterior, mientras que `0` y «No» sí se escriben.

> [!TIP]
> Para actualizar solo los precios, carga un archivo de dos columnas: A, la referencia; B, el precio nuevo. En el primer paso, asigna la columna A al campo de la referencia, la columna B al campo del precio y, al resto de los campos, columnas que el archivo no tiene. Elige la referencia como campo único. Los demás valores de los registros no cambiarán. Esto funciona si la lista no tiene otros campos obligatorios: un campo obligatorio debe estar relleno en todas las filas del archivo.

## La columna ID

En el primer paso, el campo «ID del registro» selecciona la columna con el identificador del registro, la que añade «Exportar a Excel». Si una fila contiene el ID de un registro de esta lista, se actualiza exactamente ese registro, aunque haya cambiado el valor de su campo único. Las filas con un ID vacío o desconocido se comparan por el campo único, como siempre.

De forma predeterminada es la primera columna a la derecha de todos los campos: ahí la escribe la exportación. Si tu archivo no tiene columna ID, no hay nada que cambiar.

## Iniciar una importación

1. Haz clic en «Importar desde Excel».
2. Comprueba la casilla «La primera fila son encabezados». Para cada campo de la lista, elige la letra de la columna del archivo de la que se tomará el valor. De forma predeterminada, los campos van en orden: el primero de la columna A, el segundo de la B, y así sucesivamente. Debajo, comprueba la columna «ID del registro». Haz clic en «Siguiente».
3. En el campo «Campo único», elige el campo para encontrar los registros existentes. Haz clic en «Siguiente».
4. Sube el archivo y haz clic en «Siguiente»: la importación comienza.

![La ventana «Importar desde Excel», primer paso: columnas del archivo para los campos de la lista y la columna ID](https://support.jetbot24.ru/_media/es/10-lists/_images/import.webp?v=1792562451)

La correspondencia de columnas, la columna ID, la casilla de encabezados y el campo único se recuerdan en la lista: la próxima vez solo tendrás que comprobarlos.

La importación se ejecuta en segundo plano y la ventana muestra su progreso. Al terminar, queda un informe en la ventana:

- «Importación completada»: la fecha y la hora;
- «Filas procesadas»: cuántas filas del archivo se leyeron;
- «Registros nuevos»: cuántos registros se añadieron;
- «Registros actualizados»: cuántos registros se actualizaron;
- «Filas rechazadas»: cuántas filas no superaron la comprobación;
- «Errores»: la lista de errores. Cada uno empieza por la dirección de la celda, por ejemplo `[B7]`.

![Informe de una importación terminada](https://support.jetbot24.ru/_media/es/10-lists/_images/import-report.webp?v=1792562451)

El informe se conserva hasta la siguiente importación. El botón «Importar nuevo archivo» vuelve al primer paso. Cuando termina la importación, la tabla de registros se actualiza sola.

## Por qué se rechazó una fila

Una fila rechazada no entra en la lista; el resto de las filas del archivo se cargan.

| Error en el informe | Qué corregir |
|---|---|
| «El campo único no debe estar vacío.» | Rellena la columna del campo único en la fila |
| «No se encontró el campo único.» | El campo único no está elegido o se ha eliminado de la lista. Vuelve a iniciar la importación y elige el campo en el segundo paso |
| El campo es obligatorio | Un campo obligatorio está vacío en la fila |
| El campo debe ser un número | Hay texto en un campo de número o de dinero |
| «El campo … debe ser 0 o 1.» | El campo lógico contiene algo distinto de `0` y `1` |
| «… no es una fecha válida.» | La fecha está escrita como texto en otro formato: da a la celda formato de fecha o escribe la fecha como `2026-10-02` |
| El formato del campo no es válido | El campo de archivo o de imagen no contiene un enlace `http://` o `https://` |
| El campo debe ser un número entero | El campo «ID del contacto» o «ID del bot» no contiene un número |
| «El bot del campo … debe pertenecer a tu cuenta.» | Se indica el número de un bot ajeno o inexistente |
| «El contacto del campo … debe pertenecer a tu cuenta.» | Se indica el número de un contacto que no es de tu bot |

Otros mensajes:

- **«El procesamiento se detuvo: demasiados errores.»**: el archivo ha acumulado más de 1000 errores. Las filas cargadas antes de la detención se quedan en la lista. La causa más habitual son columnas mal asignadas o una fila de encabezados con «La primera fila son encabezados» desmarcada.
- **«No se puede iniciar una nueva importación mientras la anterior está en curso»**: ya hay una importación en marcha en una de las listas del proyecto; su nombre aparece en el mensaje. Espera a que termine.
- **«Solo se pueden importar archivos xlsx o csv»**: se subió un archivo de otro tipo, por ejemplo un `.xls` antiguo. Guárdalo en Excel como `.xlsx`.

## Exportar a Excel

1. Haz clic en «Exportar a Excel».
2. En la ventana, haz clic en «Iniciar exportación».
3. Cuando termina la exportación, la ventana muestra «Exportación completada» con la fecha, «Filas procesadas» y el enlace «Descargar archivo».

![La ventana «Exportar a Excel» tras una exportación: fecha, número de filas y enlace al archivo](https://support.jetbot24.ru/_media/es/10-lists/_images/export.webp?v=1792562451)

El enlace al último archivo se queda en la ventana hasta la siguiente exportación.

Qué entra en el archivo:

- todos los registros de la lista: la búsqueda y los filtros de la tabla no afectan a la exportación;
- la primera fila son los encabezados: los nombres de los campos, incluidos los ocultos, e «ID»;
- los campos están en las mismas columnas elegidas para la importación (de forma predeterminada, en orden desde la A), y la columna «ID» está a la derecha de los campos;
- un campo lógico: `1` o `0`;
- una fecha: como `2026-10-02 14:30:00`;
- un archivo y una imagen: un enlace al archivo;
- un contacto y un bot: el número;
- un campo de dinero: el importe en las unidades principales de la moneda, como en el formulario del registro: `1500.5`.

En un proyecto solo se ejecuta una exportación a la vez. Si inicias una segunda, aparece el mensaje «No se puede iniciar una nueva exportación mientras la anterior está en curso».

> [!TIP]
> Para corregir muchos registros a la vez, exporta la lista, cambia los valores en Excel y carga el archivo tal cual mediante «Importar desde Excel»: los registros se encuentran por la columna «ID». Las filas sin ID se convierten en registros nuevos si el valor de su campo único no coincide con uno existente.

## Permisos de los miembros del equipo

- La importación cambia la configuración de la lista, por eso requiere el permiso «Editar listas». En la sección del bot, solo los miembros del equipo con este permiso ven el botón «Importar desde Excel».
- La exportación está disponible con el permiso «Ver registros».

Para importar y exportar no hace falta una suscripción Pro.