# Importar usuarios de acceso - CSV

{% hint style="info" %}
Si su organización utiliza 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 simultáneamente, 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 de usuarios actual desde Command para usarla como plantilla para su archivo de importación.

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

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

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

***

## Campos obligatorios

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

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

Si está sobrescribiendo usuarios 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 **Verkada Pass** app, y los usuarios asignados a 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, se requieren los siguientes campos:

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

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

***

## Encabezados de columna para carga CSV

En la [**página de Carga**](#h_763fa8346a) de la importación de usuarios, tenga en cuenta algunas cosas:

* **Columnas obligatorias:** Las columnas obligatorias están marcadas con un asterisco . 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 se cargará.
* **Columnas clave:** Las columnas clave están marcadas con un . *Se requiere al menos una* columna clave para coincidir con usuarios existentes si necesita sobrescribir datos de usuarios.
* **Aditivo:** Si una columna está marcada con , al sobrescribir usuarios existentes los nuevos valores se agregarán al perfil del usuario. Los valores existentes no se eliminarán.
* **Formato de fecha de inicio y fin:** MM/DD/AAAA hh:mm:ss AM/PM

{% hint style="warning" %}
Puede agregar más de una **matrícula**, y **Grupo** a un usuario. Cada entrada deberá estar separada por un punto y coma.
{% endhint %}

***

## Importar usuarios en masa

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

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

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

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

{% step %}
**En Cargar:**

a. (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.\
b. Bajo **Cargar CSV,** arrastre un CSV con la información de sus usuarios o elija **seleccionar desde su equipo.**\
c. Haga clic en **Continuar** para proceder a **Configurar**.

**Nota:** Si su archivo CSV contiene caracteres especiales, asegúrese de que esté codificado en la codificación CSV UTF-8.
{% endstep %}

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

a. **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.\
b. **Eliminar usuarios de grupos omitidos:** Seleccione *sí* para eliminar a los 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 a grupos.\
c. **Enviar invitaciones de la app Pass:** Enviar un enlace de descarga de la app Verkada Pass a todos los usuarios, a los usuarios nuevos o a ningún usuario. Recomendamos enviar este enlace a los usuarios nuevos.\
d. Haga clic en **Siguiente, Revisar columnas.**
{% endstep %}

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

a. Revise la información en las columnas que está importando.\
b. Si alguna columna no se puede importar, se mostrará un mensaje en esta pantalla detallando qué columnas no se reconocieron para la importación.\
c. Haga clic en **Siguiente, Revisar filas.**
{% endstep %}

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

a. Si se detecta algún problema en una fila, se mostrará un mensaje describiendo el problema.\
b. Haga clic en **Ver filas** junto a un problema para ver qué filas están afectadas.\
c. 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.

**Nota**: Esta revisión inicial no describe todos los errores posibles, como conflictos con datos de usuarios existentes.
{% endstep %}

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

a. Una vez que la importación haya finalizado, recibirá un correo electrónico con los detalles del éxito de la importación.\
b. Si hay importaciones fallidas, haga clic en **Descargar CSV con errores** para ver los errores que causaron que la importación fallara. [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" %}
Errores menores, como la reasignación de credenciales o números de matrícula inválidos, no bloquearán las cargas de usuarios. Los usuarios creados con estos errores se pueden descargar desde el correo electrónico enviado una vez que la importación se completa. Al corregir los errores, si el usuario no tiene un correo electrónico, puede especificar su **userId** para evitar crear usuarios duplicados.
{% endhint %}


---

# Agent Instructions: 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:

```
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>
```

The question should be specific, self-contained, and written in natural language.
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.
