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

# Importación de pagadores

> Formato Excel, actualización de existentes y carga del teléfono principal

## Alcance

La importación de pagadores está disponible en **Administración > Facturación y catálogo > Pagadores > Importar**. Permite crear pagadores y completar los datos de los que ya existen.

El importador procesa únicamente la primera hoja del libro Excel. La fila 1 debe contener las cabeceras y las filas siguientes, los datos.

## Columnas admitidas

| Columna        | Obligatoria | Uso                                                                          |
| -------------- | ----------: | ---------------------------------------------------------------------------- |
| `nombre`       |          Sí | Nombre corto e identificador para localizar un pagador existente.            |
| `nombre_largo` |          Sí | Nombre completo o razón social.                                              |
| `cif`          |          No | Identificación fiscal.                                                       |
| `direccion`    |          No | Dirección postal.                                                            |
| `ciudad`       |          No | Población o localidad.                                                       |
| `provincia`    |          No | Provincia.                                                                   |
| `cp`           |          No | Código postal. Conviene guardarlo como texto para conservar ceros iniciales. |
| `codigo`       |          No | Código utilizado para relacionar prestaciones y precios con el pagador.      |
| `id_externo`   |          No | Identificador en otro sistema.                                               |
| `color`        |          No | Color hexadecimal `#RRGGBB`; si se omite al crear, se utiliza blanco.        |
| `telefono`     |          No | Teléfono principal del pagador, con un máximo de 16 caracteres.              |

Para `telefono` también se reconocen las cabeceras `telefon`, `tel`, `phone`, `telephone` y `tel1`.

## Creación y actualización

La búsqueda de un pagador existente se realiza por `nombre` exacto dentro de la cuenta actual:

* si no existe, se crea un pagador nuevo;
* si existe, se actualiza el mismo registro;
* en una actualización solo se aplican los campos que tengan valor;
* una celda `telefono` vacía no borra el teléfono ya guardado;
* `nombre_largo` es obligatorio y siempre se actualiza.

El `codigo` no puede pertenecer a otro pagador de la misma cuenta. Los nombres y códigos repetidos dentro del propio fichero se rechazan por fila.

## Resultado y errores

Cada fila se valida de forma independiente. Las filas correctas se guardan aunque otras fallen. Al terminar, Nubidoc muestra cuántos pagadores se han creado, actualizado u omitido y detalla los avisos encontrados.

El fichero de ejemplo descargable desde el diálogo contiene todas las columnas admitidas, incluida `telefono`.
