Referencia
En esta página
Tablas exhaustivas de Door & Gate Access: todos los estados de eventos, motivos de denegación, configuraciones, valores predeterminados, límites y valores de opciones en un solo lugar. Usa esta página para consultar el significado exacto de un valor; las páginas de guía enlazadas explican cómo usar cada función.
Estados de los eventos de acceso
Se muestran en los Registros de acceso:
| Estado | Significado |
|---|---|
| Request received | La solicitud de desbloqueo llegó y se está evaluando (transitorio) |
| Pending | La solicitud superó las comprobaciones y está pendiente de envío (transitorio) |
| Unlocked | Se informó que el desbloqueo se realizó correctamente |
| Confirmed unlocked | El controlador de la puerta confirmó que el relé se liberó |
| Admin Unlocked | Un administrador activó el desbloqueo desde Performance Hub (anulación de administrador); se registra cuando se envía el comando |
| Denied | La solicitud se rechazó: consulta el motivo de denegación en el evento |
| Timed out | Se envió el comando, pero el controlador no lo confirmó a tiempo |
| Failed | No se pudo completar el desbloqueo debido a un error |
| Locked by staff | El personal usó Lock now mientras el horario de desbloqueo automático mantenía la puerta abierta (un evento del horario, no un intento de desbloqueo) |
| Schedule resumed | El horario de desbloqueo automático volvió a tomar el control (un evento del horario, no un intento de desbloqueo) |
Ciclo de vida del evento: recibido → enviado → desbloqueo confirmado / denegado / tiempo de espera agotado / fallido.
Motivos de denegación
Cada desbloqueo denegado o fallido registra un motivo. La tabla relaciona el motivo con lo que ve el miembro y con cómo solucionarlo:
| Motivo (tal como se registra) | Mensaje que ve el miembro | Causa | Solución |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | El interruptor Access enabled del usuario está desactivado | Vuelve a habilitarlo en el panel del usuario en Users |
no_matching_policy_or_grant | "You don't have access to this door" | Ninguna Access Policy coincidió con Who Y Where Y When, y ninguna vía de concesión acumulativa permitió el acceso | Revisa las Access Policies, los atributos del usuario, los destinos y exclusiones, el horario y las concesiones |
no_matching_policy_target | "You don't have access to this door" | Ninguna Access Policy habilitada tiene esta puerta como destino para la solicitud | Agrega la puerta o su Alcance de acceso a una política, o usa un destino de todas las puertas |
no_matching_policy_audience | "You don't have access to this door" | Hay políticas que tienen la puerta como destino, pero ninguna coincide con el tipo, el estado o las etiquetas de la persona | Revisa la sección Who de la política y el registro de Users |
outside_policy_schedule | "Outside allowed access hours" | Who y Where coinciden, pero todos los horarios de las políticas que coinciden están inactivos o vencidos | Revisa la sección When de la política y la zona horaria de la instalación |
outside_geofence | "Move closer — you're outside the location's geofence." | La ubicación informada supera radio + precisión del GPS + margen desde el centro de la geovalla | El miembro se acerca, o revisa el radio o el pin de la geovalla |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | La precisión del GPS del teléfono es peor que el umbral Require GPS accuracy better than | El miembro vuelve a intentarlo en el exterior o lejos de interferencias, o aumenta el umbral |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | El teléfono no informó una ubicación utilizable | El miembro habilita Location (Precise) para la aplicación |
geofence_misconfigured | Desbloqueo denegado | La geovalla está habilitada, pero falta su centro o pin: el sistema falla de forma cerrada | Coloca el pin de la geovalla en Settings → Geofencing |
device_offline | "Door is offline. Please contact the facility." | El controlador de la puerta no se ha reportado (sin señal de actividad en 5 minutos) | Restablece la alimentación o la red del controlador: consulta Solución de problemas |
user_deleted | "You don't have access…" | Se eliminó el registro de Users | Vuelve a crear o restaura el usuario |
outside_access_time_window | Puerta deshabilitada con la próxima disponibilidad, cuando se conoce | Un período futuro es la única vía de autorización potencial del usuario y todavía no está activo | Revisa la disponibilidad proporcionada, la zona horaria, la actualización del origen y la asignación; las Access Policies y las concesiones se siguen aplicando de forma independiente |
Algunas versiones de la aplicación muestran el mensaje más general "You don't have access to this door" o "Outside allowed access hours" para las denegaciones específicas de las políticas. Los Registros de acceso conservan el motivo detallado para los administradores.
Políticas de acceso
| Propiedad | Significado |
|---|---|
| Estructura de la política | Nombre único, descripción opcional, indicador de habilitación, destinatarios Who, destinos y exclusiones Where, horario When |
| Coincidencia de la política | Who Y Where Y When |
| Varias políticas | O; cualquier política habilitada que coincida permite el acceso |
| Who | Tipo de persona más estados opcionales, O etiquetas sincronizadas o personalizadas; sin estados = cualquier estado |
| Where | Todas las puertas de la instalación, Alcances de acceso, puertas individuales o combinaciones; las exclusiones prevalecen dentro de esa política |
| When | Anytime, o períodos Weekly/One-time combinados con O |
| Otras vías de autorización | Las concesiones permanentes y los períodos de administrador o de integración se mantienen independientes y se suman |
| Seguridad | Se siguen aplicando los usuarios eliminados, deshabilitados o bloqueados por la sincronización, la eliminación o el bloqueo de puertas, el mantenimiento, la geovalla, los límites de frecuencia y las comprobaciones del controlador |
| Configuración existente | Se importa automáticamente a políticas con nombre equivalentes con Who, Where y When explícitos |
Atribución de políticas
Los Registros de acceso identifican por su nombre la política que coincide y pueden mostrar sus destinatarios, su destino y su horario. Las coincidencias programadas también pueden incluir el inicio y el fin concretos activos.
Referencia de las Access Time Windows
| Propiedad | Significado |
|---|---|
| Autorización | Los períodos del horario de una política son el When de la política; los períodos de administrador o de integración son vías de autorización acumulativas independientes |
| Límite absoluto | Instantes UTC enteros en segundos Unix, [from, to) |
| Zona horaria absoluta | Metadatos de visualización y auditoría; no desplaza las marcas de tiempo |
| Límite semanal | Bloques locales HH:mm con finales excluidos |
| Zona horaria semanal | Zona horaria IANA válida que determina el día y la hora local y el horario de verano |
| Límites semanales | Inicio y fin de vigencia opcionales en segundos Unix; el fin se excluye |
| Noche/superposición | No se aceptan; divide los períodos nocturnos entre días y mantén los bloques sin superposiciones |
| Propiedad del usuario | El administrador y cada origen de integración están aislados; uno no puede borrar al otro |
| Alcance de integración | scope_key estable del origen, default de forma predeterminada, asignado a destinos de PH; si es desconocido o no está asignado, falla de forma cerrada |
| Actualización del origen | Se configura según la frecuencia de cada integración; el comportamiento con orígenes obsoletos debe ser explícito |
| Seguridad | Nunca omite a los usuarios deshabilitados, eliminados o en conflicto, blockAllAccess, el mantenimiento, la geovalla, los límites de frecuencia ni las comprobaciones del controlador |
Límites iniciales: 50 períodos por contenedor de política, concesión u origen; duración absoluta máxima de 90 días; 120 caracteres para los identificadores, las etiquetas y las claves de alcance; ocho bloques semanales por día; las entradas nuevas no pueden haber vencido hace más de una hora.
Configuración, valores predeterminados e intervalos
Configuración de las puertas
| Configuración | Valor predeterminado | Intervalo / opciones |
|---|---|---|
| Tiempo de apertura | 10 segundos | 1–30 segundos |
| Modo de mantenimiento | Normal | Normal / Force open / Force closed |
| Sonido de apertura de la puerta | Desactivado | Activado / Desactivado |
| Etiqueta de ubicación de la puerta | — | Texto libre, máximo 64 caracteres |
| Icono | Door | 10 opciones (más abajo) |
| Horario de desbloqueo automático | Desactivado | Horario con personal de la instalación o Custom schedule, zona horaria de la instalación |
| Momento de Unlock / Lock del desbloqueo automático | At opening / At closing | At opening / At closing, o 5, 10, 15, 30, 45, 60, 90 o 120 minutos antes o después |
| Desbloqueo automático en días festivos | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| Autorización de acceso (por puerta) | Access Policies | Muestra las políticas que coinciden y permite blockAllAccess |
| Geovalla (por puerta) | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| Umbral de conexión | — | El controlador se considera en línea si ha enviado una señal de actividad en los últimos 5 minutos |
Iconos de puertas
| Icono | Uso previsto |
|---|---|
| Door | Puerta sencilla estándar (predeterminado) |
| Sliding door | Puerta corrediza o automática |
| Double door | Puerta doble o francesa |
| Garage | Puerta de garaje o enrollable |
| Boom gate | Barrera vehicular o brazo de barrera |
| Pedestrian | Entrada peatonal o del personal |
| Security | Puerta restringida o de seguridad |
| Office | Oficina o sala solo para el personal |
| Delivery | Muelle de carga o zona de entregas |
| Locker | Casillero o almacenamiento |
Configuración de la geovalla
| Configuración | Valor predeterminado | Intervalo |
|---|---|---|
| Geovalla habilitada | Activada (para una configuración de instalación nueva) | Activada / Desactivada |
| Radio | 200 m | 50–5000 m (pasos de 10 m; valores predefinidos de 50 / 200 / 500 / 1000 m) |
| Margen de precisión | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| Fórmula del margen permitido | — | radio + precisión del GPS informada + margen de precisión |
Períodos de gracia de acceso
En Settings → Access Time Windows:
| Configuración | Opciones |
|---|---|
| Allow early access | Off / 5 / 10 / 15 / 30 minutos |
| Allow access after end | Off / 5 / 10 / 15 / 30 minutos |
Configuración del bloqueo de la aplicación
| Configuración | Valor predeterminado | Opciones |
|---|---|---|
| Enforce app lock for this facility | Desactivado | Activado / Desactivado |
| Grace period before re-prompting | 5 minutos | Always prompt / 1 min / 5 min / 15 min / 30 min / 1 hour |
| Comportamiento con varias instalaciones | — | Se exige si cualquier instalación vinculada lo exige; prevalece el período de gracia más corto entre las instalaciones que lo exigen |
Contactos de soporte
| Modo | Comportamiento |
|---|---|
| Smart (default) | Se muestran automáticamente cuando una puerta está desconectada o hay poca información en la interfaz |
| Always show | Siempre en el panel de la aplicación |
| Never show | Nunca se muestran |
Mensajes en la aplicación
| Campo | Límite / opciones |
|---|---|
| Tipo de notificación | Information / Notice / Urgent |
| Título | 120 caracteres |
| Cuerpo | 2000 caracteres (advertencia leve a partir de 500) |
| URL del enlace | Solo http(s), 2000 caracteres |
| Etiqueta del enlace | 80 caracteres, "More info" de forma predeterminada |
| Horario | Starts at / Ends at opcionales |
| Marcadores de posición (reglas automatizadas) | {firstName}, {lastName} |
| Campos de coincidencia de las reglas automatizadas | Membership status / Person type / Tag (las etiquetas coinciden con las sincronizadas y las personalizadas, sin distinguir mayúsculas de minúsculas) / Door visibility |
| Prioridad de las reglas | Prevalece la primera regla habilitada que coincide (orden de la lista) |
Campos de usuario
| Campo | Límite / notas |
|---|---|
| Nombre / apellido | 80 caracteres cada uno |
| Teléfono móvil / correo electrónico | Se requiere al menos uno (se usa para el inicio de sesión con OTP); los teléfonos se normalizan al formato internacional |
| Etiquetas | 80 caracteres por etiqueta; la sincronización sobrescribe las etiquetas sincronizadas, y las etiquetas personalizadas son propiedad del administrador |
| Notas | 2000 caracteres |
| Access enabled | Activado de forma predeterminada; desactivado = se deniegan todos los desbloqueos |
| Concesiones | Para toda la instalación, lista de puertas, lista de alcances, horario de funcionamiento opcional |
| Access Policies | Un usuario puede estar cubierto por una o más políticas con nombre; la lista y el acceso efectivo usan Access granted via policy |
| Access Time Windows | Períodos editables propiedad del administrador, además de períodos de solo lectura propiedad del origen; independientes de los horarios de las políticas |
Orígenes, estados y otras enumeraciones
| Enumeración | Valores |
|---|---|
| Origen del usuario | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| Mosaicos de usuarios | All users / Has access / No access / Not synced |
| Estado de la invitación | Not invited / Invited / Send failed |
| Destinatarios de las invitaciones | Only users with door access / All eligible synced users |
| Campos de las reglas de invitación | Membership status / Person type / Tag / Sync source / Integration; operadores is any of / is not any of |
| Vistas de los Registros de acceso | Door events / No visit recorded |
| Adopción de la aplicación | Active (ha usado la aplicación) / Not yet active |
| Identificador obligatorio (sincronización) | Email OR phone (predeterminado) / Email required / Phone required / Both required |
| Resultados del registro de sincronización | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| Estados de los períodos | Active / Upcoming / Expired / Stale / Unmapped |
| Etiquetas de estado de membresía | Active, Current, Expired, On hold, Cancelled, Pending (además de cualquier valor de tu sistema de origen) |
| Plantillas de Alcance de acceso | Custom, Main entrances, Staff-only, Restricted area, 24/7 access, Business hours, Vehicle access, Service entries |
| Plantillas de mensajes automáticos | No door access, Expired membership, Payment overdue, Account on hold / suspended, Welcome (new member), Trial / prospect, Document / waiver required |
Motivos de omisión de la sincronización
| Motivo que se muestra en el registro de sincronización | Significado |
|---|---|
| Integration sync is turned off for this facility | El interruptor principal del origen está desactivado |
| This integration is turned off in sync settings | Se excluyó la integración concreta |
| No phone or email on the record (a phone or email is required to log in) | El registro no cumple la regla Require identifier |
| Record is decoupled and managed manually | Track source updates está desactivado para este usuario |
| No facility on the source record | El registro de origen no está vinculado a esta instalación |
| No matching user record | El cambio hacía referencia a una persona que no tiene fila aquí |
Límites operativos
| Límite | Valor |
|---|---|
| Importación de CSV | 200 usuarios por importación |
| Invitaciones masivas | Se envían en lotes de 50 |
| Muestra de la vista previa de eliminación masiva | Se muestran los primeros 50 usuarios |
| Consulta de los Registros de acceso | Hasta los 500 eventos más recientes por período |
| Conservación de los eventos de acceso | ~13 meses; después se eliminan automáticamente |
| Validez del comando de desbloqueo de administrador | 30 segundos (el comando vence si no se entrega) |
| Señal de actividad del controlador de la puerta | Cada ~30 segundos; desconectado tras 5 minutos sin señal |
| Solicitudes de código de inicio de sesión | 5 por hora por teléfono o correo electrónico (límite de seguridad, no se puede quitar) |
| Propagación del cierre de sesión de la aplicación | Se revoca de inmediato; hasta 15 minutos para que una sesión activa termine por completo |
| Guardar la configuración de la puerta | Recarga el controlador, normalmente entre 10 y 15 segundos |
| Conservación de No visit recorded | ~13 meses |
| Asignaciones de Access Time Windows | 50 por integración |
| Access Time Windows por contenedor | 50 |
| Duración de un período One-time | 90 días |
| Bloques Weekly | 8 por día de la semana |
| Identificador, etiqueta y clave de alcance del período o del origen | 120 caracteres |
| Access Policies por instalación | 100 |
| Total de períodos de políticas | 500 |
| Nombre o identificador de la Access Policy | 120 caracteres |
| Descripción de la Access Policy | 500 caracteres |
| Configuración de la Access Policy | 300 KiB UTF-8 |