--- title: "Integración con dispositivos de terceros" slug: "integration-with-third-party-device-12" status: "update" updated: 2026-11-02T10:01:37Z published: 2026-11-02T10:01:37Z canonical: "knowledge.akuvox.com/integration-with-third-party-device-12" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.akuvox.com/llms.txt > Use this file to discover all available pages before exploring further. # Integración con dispositivos de terceros ## Integración vía Wiegand La función Wiegand permite que el dispositivo Akuvox actúe como controlador o lector de tarjetas. Configúralo en el dispositivo web **> Wiegand > interfaz Wiegand** . ![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-OJD74HHI.png) - **Modo de visualización Wiegand**: Selecciona el formato de código de tarjeta Wiegand entre las opciones proporcionadas: 8HN, 8H10D, 6H3D5D, 6H8D, 8HN, 8HR, RAW y 8HR10D. - **Modo lector de tarjetas Wiegand**: El formato de transmisión debe ser idéntico entre el teléfono de entrada y el dispositivo de terceros. - **Modo de transferencia Wiegand**: - **Entrada**: El dispositivo funciona como controlador de relé. - **Salida**: El dispositivo actúa como emisor y puede enviar directamente los datos, como un código de tarjeta. - **Convertir a tarjeta No. Salida**: El dispositivo actúa como emisor y no puede enviar directamente los datos, como los datos de la cara. - **Orden de datos de entrada de Wiegand**: Establece la secuencia de datos de entrada de Wiegand entre Predeterminado y Compatible. Si seleccionas Compatible, entonces el número de la tarjeta de entrada se invertirá. - **Orden de los datos de salida de Wiegand:** Determinar la secuencia de datos de la tarjeta tras la conversión de Wiegand. Por ejemplo, si los datos de la tarjeta son 0x11 0x22 0x33 0x44 0x55, se 0x33 0x44 0x55 después de la conversión de Wiegand (por ejemplo, Wiegand 26). Si se selecciona Invertido, los datos de la tarjeta se 0x55 0x44 0x33. - Wiegand **Output CRC Enable**: Está habilitado por defecto para la inspección de datos Wiegand. Desactivarlo puede provocar fallos de integración con dispositivos de terceros. - **Wiegand Input Clear** Time: Cuando el intervalo para introducir contraseñas supere el tiempo. Todas las contraseñas introducidas serán borradas. - **Verificación de tarjeta RF**: Disponible al **Salida** o **Conversión a la tarjeta No. Salida** seleccionada. Cuando está habilitada, el dispositivo verificará si el código de la tarjeta está asignado a un usuario. Si no lo está, aparecerá un aviso "Abriendo puerta fallida" en la pantalla del teléfono portero. Cuando está desactivado, el teléfono no realizará la verificación local. - **Verificación de código PIN/QR**: Disponible cuando se selecciona **Salida** como Modo de Transferencia Wiegand. Cuando está activado, el dispositivo verificará si la credencial está asignada a un usuario. Si no es así, aparecerá un mensaje "Apertura de puerta fallida" en la pantalla del teléfono portero. Cuando está desactivado, el teléfono no realizará verificación local. - **Convertir a salida Wiegand**: Disponible cuando se selecciona **Salida** como Modo de Transferencia Wiegand. Esta opción determina el formato PIN de salida. - Desactivado: Desactiva la función. - 8 bits por dígito: Cuando los usuarios pulsan "1" en el teclado, los datos binarios se transmitirán en 8 bits, "11100001". - 4 bits por dígito: Cuando los usuarios pulsan "1" en el teclado, los datos binarios se transmitirán en 4 bits, "0001". - Todo de golpe: Después de introducir el código PIN completo, los datos se transmitirán según el modo lector de tarjetas Wiegand. Por ejemplo, "123456" se convertirá en "01e240" en Wiegand 26. > [!NOTE] > Nota > > Haz [clic aquí](https://knowledge.akuvox.com/docs/es/wiegand-configuration) para ver más información sobre los ajustes de Wiegand, incluyendo: > > - Los dispositivos Akuvox funcionan como entrada/salida Wiegand; > - Conexión al lector de tarjetas Wiegand. ## Integración mediante HTTP API La API HTTP está diseñada para lograr una integración basada en red entre el dispositivo de terceros y el dispositivo Akuvos. Configúralo en la web **, configurando > interfaz HTTP API** . ![image.png](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-RUCMFDP1.png) - **Habilitado**: Habilitar o desactivar la función API HTTP para integración de terceros. Si la función está desactivada, cualquier solicitud para iniciar la integración será denegada y devolverá el estado de HTTP 403 prohibido. - **Modo de autorización**: Por defecto es Digest. Debes rellenar el nombre de usuario y la contraseña para la autenticación. En el campo de autorización del encabezado de la solicitud HTTP, utiliza el método de codificación Base64 para codificar el nombre de usuario y la contraseña. - **Nombre de usuario**: Introduce el nombre de usuario para autenticación. El valor predeterminado es administrador. - **Contraseña**: Introduce la contraseña para la autenticación. La opción predeterminada es administrador. - **1ª IP-5ª IP**: Introduzca la dirección IP de los dispositivos de terceros cuando se seleccione la autorización **de Lista de Permisos** para la integración. **Por favor, consulte la siguiente descripción para el modo de autenticación:** | Modo de autorización | Descripción | | --- | --- | | Ninguno | No se requiere autenticación. Este modo está pensado solo para pruebas y no se recomienda en entornos de producción. | | Lista de permisos | Autentica las solicitudes basándose en la dirección IP de origen. Añade la dirección IP del dispositivo de terceros a la lista de permisos antes de enviar las solicitudes. Recomendado para entornos LAN de confianza. | | Básico | Autentica las solicitudes usando un nombre de usuario y contraseña. Las credenciales deben estar codificadas en Base64 e incluirse en la cabecera **de autorización** . | | Digest | Autentica las solicitudes usando autenticación HTTP Digest. Solo se soporta el algoritmo **MD5** . | | Ficha | Reservado para el desarrollo y pruebas internas de Akuvox. | ## Integración con un servidor de control de acceso de terceros El dispositivo puede transmitir datos de credenciales de acceso a un servidor de terceros sin realizar ninguna verificación. La generación y verificación de los datos se realiza en el servidor de terceros. Para configurarlo, ve a **Control de Acceso, > Relé > interfaz de Integración de Terceros** . ![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-CUY87I9S.png) - **Ninguno**: Desactiva la función. - **General**: Transmite la URL HTTP vinculada por código QR usando el método de Akuvox. - **URL HTTP**: Introduzca el formato de comando HTTP proporcionado por el proveedor de servicios de terceros. Tras escanear el código QR, el comando HTTP transportará automáticamente la información dinámica del código QR antes de enviarla al servidor de códigos QR para su verificación. Consulte el ejemplo: *http://{IP del servidor}:8090/api/visitor/scan?codeKey={QRCode}&deviceId={DeviceID}.* - **ID de dispositivo**: El ID del dispositivo lo proporciona el servidor de terceros. Se añadirá automáticamente al comando HTTP al usar un código QR para acceder a la puerta. - **Parámetro de éxito**: Recibir este valor indica que abrir la puerta tiene éxito. - **Parámetro fallido**: Recibir este valor indica que abrir la puerta falla. - **Personalizar**: Transmitir datos de credenciales de acceso de forma personalizada. Cuando se **selecciona Cara** , el dispositivo realiza primero el reconocimiento facial local. Si no se detecta ninguna cara coincidente, la autenticación falla. Si se encuentra una coincidencia, el **ID de usuario** o **PIN** asociado se envía al servidor de terceros para su verificación adicional. | Modo de autenticación | Opciones disponibles | | --- | --- | | Cualquier método | Código QR, tarjeta, NIP, rostro | | Cara + PIN | Código QR, Multifactor | | Cara + tarjeta RF | | PIN + Tarjeta RF | | Tarjeta RF + PIN | Cuando se selecciona un **Modo de Autenticación de Dos Factores** , las opciones **de Verificación Remota** se comportan de la siguiente manera: | Opción | Descripción | | --- | --- | | Código QR | El dispositivo escanea el código QR y lo envía directamente al servidor de terceros. | | Multifactor | El dispositivo primero comprueba si el método de autenticación coincide con el método configurado. Si no se empareja → usuario debe usar el método correcto. Si coinciden → Las credenciales recopiladas se envían al servidor para su verificación. | - **Prompt en la pantalla LCD**: Seleccione **Predeterminado** para adoptar el prompt de apertura de puerta del teléfono Akuvox; Seleccione **Return Value** para usar el return value del servidor de terceros como prompt. - **Verificación remota**: Especificar qué credenciales de acceso serán verificadas por el servidor de terceros. En todos los casos, la credencial especificada se envía al servidor tal cual, sin realizar verificación local en el dispositivo. Las opciones disponibles dependen del [Modo de Autenticación](https://knowledge.akuvox.com/docs/es/door-unlock-configuration-8#access-authentication-mode) configurado: - **Modo de Solicitud de Autenticación Multifactor**: Especificar cómo se envían las credenciales recogidas al servidor bajo un Modo de Autenticación de Dos Hechos. - **Solicitudes separadas**: El dispositivo verifica cada credencial por separado tan pronto como se proporciona. No espera a que se introduzcan todas las credenciales requeridas antes de enviar la solicitud de verificación. - **Solicitud combinada única**: El dispositivo espera hasta que se proporcionan todas las credenciales requeridas y luego las envía juntas en una única solicitud de verificación. - **Modo de autorización**: Se utiliza cuando el dispositivo envía solicitudes de verificación al servidor. | Variable | Descripción | | --- | --- | | {Token} | Disponible cuando el **Modo de Solicitud de Autenticación Multifactor** está configurado como **Solicitudes Separadas**. Reemplazado por la credencial recogida en el paso de autenticación actual — el dispositivo envía una solicitud por credencial a medida que se introduce. | | {Carta}, {Pin}, {UsuarioID} | Disponible cuando **el Modo de Solicitud de Autenticación Multifactor** está configurado en **Solicitud Combinada Simple**. {Card} se reemplaza por el número de la tarjeta de lectura, {Pin} por el PIN introducido y {UserID} por el ID de usuario asociado a la cara. | | {Tipo} | Disponible solo bajo un Modo de Autenticación de Dos Factores (ambos modos de solicitud). Indica el tipo de autenticación de dos factores: 1 = Tarjeta RF + PIN 2 = PIN + Tarjeta RF 3 = Carta cara + RF 4 = Cara + PIN | - **Básico**: La solicitud se autentica mediante autenticación HTTP Basic. El **nombre de usuario** y **la contraseña** se combinan, codifican y envían con cada solicitud. - **Resumen**: La solicitud se autentica mediante autenticación HTTP Digest. En lugar de enviar directamente el **nombre de usuario** y **la contraseña** , el dispositivo envía un valor hash generado a partir de las credenciales y un desafío proporcionado por el servidor. - **URL HTTP**: Introduce el formato del comando HTTP proporcionado por el proveedor de servicios de terceros. Tras usar la credencial de acceso, el comando HTTP transportará automáticamente la información dinámica antes de enviarla al servidor para su verificación. **Formato de ejemplo**: *http://{Server IP}:8090/api/visitor/scan?codeKey={QRCode}/{Card}/{UserID}/{Pin}&deviceId={DeviceID}**.* Si un usuario desliza una tarjeta, la URL será [http://192.168.35.123:8090/api/visitor/scan?codeKey={QRCode}/123456/{UserID}/{Pin}&deviceId=1.](http://192.168.35.123:8090/api/visitor/scan?codeKey={QRCode}/123456/{UserID}/{Pin}&deviceId=1.) En el modo **de Autenticación de Dos Factores** , los marcadores de posición disponibles dependen del **Modo de Solicitud de Autenticación Multifactor** seleccionado. - **ID de dispositivo**: El ID de dispositivo lo proporciona el servidor de terceros. Se añadirá automáticamente al comando HTTP. - **Parámetro de éxito**: Recibir este valor indica que abrir la puerta tiene éxito. - **Parámetro fallido**: Recibir este valor indica que abrir la puerta falla. > [!NOTE] > Nota > > Haz [clic aquí](/v1/docs/es/integration-with-third-party-access-control-server) para ver la guía detallada.