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.

📝 Paso 1: Prepara tu archivo Excel 🔗

Tu archivo debe incluir una fila de cabecera con el nombre de cada columna. Solo es obligatorio añadir 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 lo indicas)
`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, por ejemplo: `ES` o `España`)
`personafisica`	`1` si es persona física, `0` si es empresa
`codpago`	Código de la forma de pago (por ejemplo: `CON`, `TRF`)
`coddivisa`	Código de la divisa (por ejemplo: `EUR`, `USD`)
`observaciones`	Notas internas

Nota: Los nombres de columna en tu Excel pueden ser los que tú quieras. 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 estas 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 tu propio Excel) 🔗

Si vas a usar 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 que tengas el mapeo listo:

Haz clic en Guardar e importar.

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

El sistema procesará el archivo y mostrará un mensaje con el número de proveedores importados.

Si se produce algún error en una fila —por ejemplo, una forma de pago desconocida—, el sistema lo registrará en el log y continuará 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 importará 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 importará 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, lo generará 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 (por ejemplo: EUR, USD). Si la divisa no existe en el sistema, el proveedor se importará con la divisa por defecto.

Relacionado

Última actualización: 28-08-2026 13:05:43