> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/access-control/es/usuarios-y-credenciales/add-a-user-to-the-verkada-access-system/import-access-control-users-csv.md).

# Importar usuarios de acceso - CSV

{% hint style="info" %}
Si su organización usa Directorios para el control de acceso, consulte [Administrar usuarios con Directorios](/command/es/usuarios-y-permisos/manage-users-in-your-organization/directories-for-user-group-management.md) antes de realizar cambios. Explica cómo los Directorios afectan dónde se administran los usuarios y qué permisos se aplican.
{% endhint %}

Para ayudar a administrar varios usuarios de control de acceso de Verkada al mismo tiempo, los administradores de acceso pueden exportar, importar y realizar cambios en los usuarios de sus organizaciones mediante un archivo de valores separados por comas (CSV).

{% hint style="warning" %}
Si tiene varios usuarios con el mismo nombre (ya en Command o en el CSV) que no tienen direcciones de correo electrónico, la importación creará usuarios duplicados con el mismo nombre.
{% endhint %}

***

## Exportar usuarios existentes

Para evitar crear manualmente la lista de usuarios cada vez que necesite actualizar usuarios, puede exportar la lista actual de usuarios desde Command para usarla como plantilla para su archivo de importación.

{% stepper %}
{% step %}
**En Verkada Command, vaya a Todos los productos > Acceso.**
{% endstep %}

{% step %}
**En el menú de la izquierda, haga clic en Usuarios y grupos de acceso.**
{% endstep %}

{% step %}
**Haga clic en Exportar > Exportar usuarios para descargar el CSV.**
{% endstep %}
{% endstepper %}

***

## Campos obligatorios

Si está importando usuarios de control de acceso, estos campos son obligatorios:

* **Nombre**
* **Apellido**

Si está sobrescribiendo usuarios de control de acceso, *al menos uno* de estos campos es obligatorio:

* **userId**
* **externalId**
* **correo electrónico**

{% hint style="danger" %}

* El **correo electrónico** campo es obligatorio para que los usuarios accedan a la **app de Verkada Pass** y a los usuarios asignados un [rol de control de acceso](/access-control/es/primeros-pasos/roles-and-permissions-for-access-control.md) en Command.
* El **userId** El campo es generado por Verkada y puede usarse para identificar a los usuarios.
  {% endhint %}

Al asignar números de tarjeta a usuarios, los siguientes campos son obligatorios:

* **cardFormat**
* **facilityCode** (si el formato de la tarjeta lo requiere)
* **cardNumber** (si el formato de la tarjeta lo requiere)
* **cardNumberHex** (si el formato de la tarjeta lo requiere)

{% hint style="warning" %}
Las cargas CSV de usuarios no se pueden usar para eliminar credenciales. Además, las credenciales que pertenecen a usuarios existentes no se reasignarán a nuevos usuarios. Puede reasignar credenciales usando la [importación de credenciales](/access-control/es/usuarios-y-credenciales/commission-access-control-cards/import-and-export-credentials-with-csv-files.md) función.
{% endhint %}

***

## Encabezados de columna para la carga de CSV

En la [**página de carga**](#h_763fa8346a) de la importación de usuarios, aquí hay algunas cosas que tener en cuenta:

* **Columnas obligatorias:** Las columnas obligatorias se marcan con un asterisco <i class="fa-asterisk" style="color:$primary;">:asterisk:</i>. Al menos uno de los campos con un asterisco es obligatorio por fila. Si una fila no tiene ninguna de las columnas obligatorias, ese usuario no podrá cargarse.
* **Columnas clave:** Las columnas clave se marcan con un <i class="fa-key" style="color:$primary;">:key:</i>. *Al menos una* columna clave es necesaria para que coincida con usuarios existentes si necesita sobrescribir los datos del usuario.
* **Aditivo:** Si una columna está marcada con <i class="fa-plus">:plus:</i>, al sobrescribir usuarios existentes, se agregarán nuevos valores al perfil del usuario. Los valores existentes no se eliminarán.
* **Formato de fecha de inicio y fecha de fin:** MM/DD/YYYY hh:mm:ss AM/PM.

{% hint style="warning" %}
Para verificar automáticamente el número de teléfono de un usuario, agregue el número al CSV en uno de los siguientes formatos:

* +1 XXX XXX XXXX&#x20;
* +1 XXX-XXX-XXXX
  {% endhint %}

{% hint style="info" %}
Puede agregar más de una **placa** o **Grupo** a un usuario. Cada entrada debe separarse con un punto y coma.
{% endhint %}

***

## Importar usuarios en lote

{% hint style="warning" %}
La carga CSV admite hasta 20.000 usuarios.
{% endhint %}

{% stepper %}
{% step %}
**En Verkada Command, vaya a Todos los productos > Acceso.**
{% endstep %}

{% step %}
**En el menú de la izquierda, haga clic en Usuarios y grupos de acceso.**
{% endstep %}

{% step %}
**Haga clic en Importar > Importar usuarios.**
{% endstep %}

{% step %}
**Al cargar:**

1. (Opcional) Haga clic en [**Descargar plantilla**](https://verkada.intercom-attachments-2.com/i/o/q5re5q6g/1338754475/5ed2df67ad764a6d5fd2e74fb5fb/UsersTemplate.csv?expires=1760022000\&signature=6b78b69cd9394d3b54e948fc31230545c419470b330cbdd04652f5246c4531f6\&req=dSMkHs57mYVYXPMW3Hu4gVzXus8N8mMmr%2FjcW1UHpNu28VPJSWD4Lb%2FLHNkv%0Afw%3D%3D%0A) para usar la plantilla recomendada por Verkada como base para su carga.
2. Debajo de **Cargar CSV,** arrastre un CSV con la información de sus usuarios o elija **seleccionarlo desde su computadora.**
3. Haga clic en **Continuar** para pasar a **Configurar**.

{% hint style="warning" %}
Si su archivo CSV contiene caracteres especiales, asegúrese de que esté codificado en UTF-8.
{% endhint %}
{% endstep %}

{% step %}
**En Configurar:**

1. **Sobrescribir usuarios existentes:** Si *sí* está seleccionado, entonces cualquier usuario que coincida con **userId, externalId,** o **correo electrónico** (en ese orden jerárquico) se actualizará con la información del CSV.
2. **Eliminar usuarios de grupos omitidos:** Seleccione *sí* para eliminar usuarios de cualquier grupo no especificado en el CSV. Los usuarios sin un grupo especificado (una celda en blanco) no verán modificada su pertenencia al grupo.
3. **Enviar invitaciones a la app de Verkada Pass:** Envíe un enlace de descarga de la app de Verkada Pass a todos los usuarios, a los nuevos usuarios o a ninguno. Recomendamos enviar este enlace a los nuevos usuarios.
4. Haga clic en **A continuación, revise las columnas.**
   {% endstep %}

{% step %}
**En Revisar columnas:**

1. Revise la información de las columnas que está importando.
2. Si alguna columna no se puede importar, se mostrará un mensaje en esta pantalla detallando qué columnas no se reconocieron para la importación.
3. Haga clic en **A continuación, revise las filas.**
   {% endstep %}

{% step %}
**En Revisar filas:**

1. Si se detecta algún problema en una fila, se mostrará un mensaje describiendo el problema.
2. Haga clic en **Ver filas** junto a un problema para ver qué filas se ven afectadas.
3. Corrija los problemas en el CSV y reinicie la carga. Aunque las filas que muestran estos errores pueden cargarse, es muy poco probable que tengan éxito.

{% hint style="warning" %}
Esta revisión inicial no describe todos los errores posibles, como conflictos con los datos de usuario existentes.
{% endhint %}
{% endstep %}

{% step %}
**Haga clic en Continuar con la importación.**

1. Una vez finalizada la importación, recibirá un correo electrónico con detalles sobre el éxito de la importación.
2. Si alguna importación falla, haga clic en **Descargar CSV con errores** para ver los errores que causaron que fallara la importación. [UsersTemplate.csv](https://verkada.intercom-attachments-2.com/i/o/q5re5q6g/1338754475/5ed2df67ad764a6d5fd2e74fb5fb/UsersTemplate.csv?expires=1760022000\&signature=6b78b69cd9394d3b54e948fc31230545c419470b330cbdd04652f5246c4531f6\&req=dSMkHs57mYVYXPMW3Hu4gVzXus8N8mMmr%2FjcW1UHpNu28VPJSWD4Lb%2FLHNkv%0Afw%3D%3D%0A)
   {% endstep %}
   {% endstepper %}

{% hint style="warning" %}
Los errores menores, como credenciales reasignadas o números de placa no válidos, no bloquearán las cargas de usuarios. Los usuarios creados con estos errores se pueden descargar del correo electrónico enviado una vez completada la importación. Al corregir los errores, si el usuario no tiene correo electrónico, puede especificar su **userId** correo electrónico
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.verkada.com/access-control/es/usuarios-y-credenciales/add-a-user-to-the-verkada-access-system/import-access-control-users-csv.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
