Cómo importar proveedores de Excel a factura.city

Esta documentación corresponde al plugin CSVimport. Comprueba si lo tienes activado desde el menú de administrador, plugins.

Esta guía te explica paso a paso cómo subir una lista de proveedores a factura.city usando un archivo Excel o CSV con el plugin CSVimport.

Requisitos previos 🔗

Tener el plugin CSVimport instalado y activado.
Tener permisos de importación en tu cuenta.
Un archivo Excel (.xlsx) o CSV (.csv) con los datos de tus proveedores.

Paso 1: Prepara tu archivo Excel 🔗

El archivo debe tener una fila de cabecera con el nombre de cada columna. Solo es obligatorio incluir al menos uno de estos tres campos:

Campo obligatorio	Descripción
`nombre`	Nombre o razón social del proveedor
`cifnif`	NIF, CIF u otro identificador fiscal
`codproveedor`	Código interno del proveedor (si ya existe en el sistema)

Campos disponibles 🔗

Puedes añadir cualquiera de estas columnas en tu Excel:

Columna en Excel	Descripción
`codproveedor`	Código del proveedor (se genera automáticamente si no se indica)
`nombre`	Nombre o razón social
`cifnif`	NIF / CIF / Pasaporte
`tipoidfiscal`	Tipo de identificador (NIF, CIF, NIE…)
`email`	Correo electrónico
`telefono1`	Teléfono principal
`telefono2`	Teléfono secundario
`fax`	Fax
`web`	Página web
`direccion`	Dirección postal
`codpostal`	Código postal
`ciudad`	Ciudad
`provincia`	Provincia
`codpais`	País (código ISO o nombre, ej: `ES` o `España`)
`personafisica`	`1` si es persona física, `0` si es empresa
`codpago`	Código de la forma de pago (ej: `CON`, `TRF`)
`coddivisa`	Código de la divisa (ej: `EUR`, `USD`)
`observaciones`	Notas internas

Nota: Los nombres de columna en tu Excel pueden ser cualesquiera — en el paso 4 los relacionarás con los campos del sistema.

Paso 2: Accede a la sección de Proveedores 🔗

En el menú principal, ve a Compras > Proveedores.

Paso 3: Abre el modal de importación 🔗

En la lista de proveedores, haz clic en el botón Importar proveedores (icono de archivo con flecha).

Se abrirá un modal con las siguientes opciones:

Opción	Descripción
Archivo	Selecciona tu archivo Excel o CSV
Plantilla	Elige cómo mapear las columnas (ver paso 4)
Modo	`Añadir` (solo añade nuevos) o `Actualizar` (modifica existentes)

Paso 4: Elige la plantilla de importación 🔗

Tienes tres opciones:

Opción A — Nueva plantilla (recomendada para Excel propio) 🔗

Si usas tu propio Excel con nombres de columna personalizados:

Selecciona Nueva plantilla.
Haz clic en Importar.
El sistema te redirigirá a la pantalla de configuración de la plantilla.

Opción B — Plantilla guardada 🔗

Si ya configuraste una plantilla anteriormente, selecciónala de la lista. El sistema la usará sin pedirte nada más.

Paso 5: Configura el mapeo de columnas (solo nueva plantilla) 🔗

Si elegiste Nueva plantilla, verás la pantalla de configuración:

Cada fila representa una columna de tu archivo Excel.
En el desplegable de la derecha, elige a qué campo de factura.city corresponde esa columna.
Si una columna no te interesa, déjala sin asignar.

Consejo: Asegúrate de asignar al menos uno de los campos obligatorios: Nombre, CIF/NIF o Código de proveedor.

Una vez configurado el mapeo:

Haz clic en Guardar e importar.

Paso 6: Espera el resultado de la importación 🔗

El sistema procesa el archivo y muestra un mensaje con el número de proveedores importados.

Si hay algún error en alguna fila (por ejemplo, una forma de pago desconocida), el sistema lo registra en el log y continúa con el resto.

Paso 7: Verifica los proveedores importados 🔗

Vuelve a Compras > Proveedores.
Comprueba que los proveedores aparecen en la lista.
Haz clic en cualquier proveedor para revisar sus datos.

Preguntas frecuentes 🔗

¿Puedo actualizar proveedores que ya existen?
Sí. En el paso 3, selecciona el modo Actualizar en lugar de Añadir. El sistema buscará el proveedor por nombre o cifnif y actualizará sus datos.

¿Cuántos proveedores puedo importar a la vez?
El sistema procesa hasta 500 filas por lote de forma automática. Si tu archivo tiene más, se importa en varias pasadas sin que tengas que hacer nada.

¿Qué pasa si la forma de pago no existe en el sistema?
Si el código de forma de pago (codpago) no existe, el proveedor se importa igualmente pero sin forma de pago asignada. Podrás asignarla manualmente después.

¿Qué pasa si el país no existe en el sistema?
El sistema lo crea automáticamente usando el nombre o código ISO que hayas indicado en la columna codpais.

¿Puedo importar el código del proveedor?
Sí. Si incluyes la columna codproveedor, el sistema usará ese código. Si no la incluyes, genera un código automáticamente. En modo Actualizar, el código se usa para identificar al proveedor existente.

¿Puedo importar la divisa del proveedor?
Sí. Incluye la columna coddivisa con el código ISO de la divisa (ej: EUR, USD). Si la divisa no existe en el sistema, el proveedor se importa con la divisa por defecto.

Soporte 🔗

Si tienes dudas o problemas, contacta con el soporte en factura.city.

Relacionado

Última actualización: 02-07-2026 13:32:43