Skip to content
Guía del Centro de ayuda
4 min de lecturaVerificado 2026-11-16

Carnés de empleado y pases de acceso

Emite credenciales para personal, contratistas y visitas con fecha de caducidad, control 2D y revocación inmediata.

En esta guía

Descripción general

Las organizaciones utilizan Passinstance para sustituir las tarjetas plásticas físicas y acreditaciones tradicionales por credenciales digitales seguras con imagen de marca en Apple Wallet y Google Wallet. Empleados, contratistas, estudiantes y visitantes acceden a edificios de oficinas, campus compartidos y laboratorios restringidos mediante tornos ópticos con código 2D o lectores NFC sin contacto.

Arquitectura del backend y esquema visual

Los pases de identidad se diseñan con metadatos de empleado de alta visibilidad y protecciones visuales antifalsificación:

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
ACCESO DE EMPLEADOS Y REVOCACIÓN
ACTORES DEL SISTEMA
P1 Sistema RRHH / API REST
P2 API Central Passinstance
P3 Lector puerta / Escáner
P4 Pase en Wallet móvil
PASO 1 SOLICITUD / ACCIÓN POST/api/v1/passes
PASO 2 SOLICITUD / ACCIÓN Aprovisionar pase y NFC
PASO 3 SOLICITUD / ACCIÓN Añadir al Wallet
›
(Foto ID + Biometría)
PASO 4 RESPUESTA Acercar al lector
PASO 5 RESPUESTA POST/api/v1/scans
›
(NFC ISO 14443 / QR)
›
(Verificar ACTIVE y turno)
PASO 6 SOLICITUD / ACCIÓN Acceso concedido (200)
PASO 7 SOLICITUD / ACCIÓN POST/api/v1/passes/voiding/:id/void
PASO 8 SOLICITUD / ACCIÓN Push APNs silencioso
›
(walletVoidStatus)
›
(El torno rechaza
›
siguientes escaneos)

Diseño visual y ranuras de recursos

  • Tipo de pase (pass type): studentId, generic o posterGeneric (Apple Wallet y Google Wallet los presentan con proporciones dedicadas de tarjeta de identidad).
  • Correlación con RRHH y directorio (externalId): Guarde el ID de empleado de su directorio o RRHH en externalId (máx. 255 caracteres, único entre pases activos del inquilino) para que los webhooks automáticos de baja puedan anular o actualizar pases mediante POST /api/v1/passes/upsert-by-external-id o GET /api/v1/passes/by-external-id/:externalId.
  • Plantillas de demostración del catálogo: student-id-card, daily-access-pass y conference-badge.
  • Identificación fotográfica: Suba retratos del personal en la ranura de recursos thumbnail (90x90 pt a @1x, 270x270 px a @3x). Google Wallet la presenta como un avatar circular o cuadrado destacado.
  • Identidad corporativa: logo fijo y banner strip con los colores de la empresa o del campus.
  • Metadatos dinámicos del empleado:

- primaryFields: Nombre completo del empleado ({fullName}). - secondaryFields: Cargo ({title}) y departamento ({department}). - auxiliaryFields: ID de empleado ({employeeId}) y nivel de acceso ({clearanceLevel}). - backFields: Protocolos de emergencia del edificio, teléfonos de contacto de seguridad y enlaces al soporte de TI.

  • Animación dinámica anticaptura (addSecurityAnimation: true): Genera un perímetro visual animado y variable en el tiempo sobre el pase para impedir capturas de pantalla estáticas o fotografías compartidas fraudulentamente.

Mecánicas de control de acceso y seguimiento de asistencia

Para el registro diario de asistencia en instalaciones, control de turnos o seguimiento de vales de comedor, los pases de identidad pueden vincular mecánicas interactivas:

  • Tipo de mecánica: VALID_ONCE_PER_DAY.
  • Resolución de zona horaria (resolveCustomerTimeZone): Pass Mechanics Engine resuelve la zona horaria del edificio del titular (por ejemplo, Europe/London). Tras escanearse en un torno de recepción, los escaneos posteriores en el mismo día natural devuelven una advertencia sin duplicar el registro de asistencia.
  • Modos de escaneo (ScanMode) y resultados (scan status):

- CHECK_IN: Registra la hora de entrada en el acceso al edificio (CHECK_IN_SUCCESS, o ALREADY_CHECKED_IN si ya figura dentro). - CHECK_OUT: Registra la salida en la puerta de salida (CHECK_OUT_SUCCESS, o ALREADY_CHECKED_OUT). - CHECK_IN_CHECK_OUT_TOGGLE: Alterna automáticamente el estado entre presencia dentro y fuera de las instalaciones en cada lectura. - SAVE_ATTENDANCE: Registra eventos repetibles de asistencia sin conmutar el estado de entrada.

Acceso NFC sin contacto en puertas (Apple VAS y Google Smart Tap)

Passinstance admite transmisión de credenciales por hardware sin contacto sobre la capa física ISO/IEC 14443 Tipo A/B:

Diccionario de configuración NFC del pase

Al configurar el acceso a puertas sin contacto, se inyecta el esquema nfc dentro del payload del pase:

JSON
{
  "nfc": {
    "message": "FACILITY_ACCESS_NODE_772",
    "encryptionPublicKey": "04a1b2c3d4e5f6...",
    "requiresAuthentication": true,
    "nfcFaceIdRequired": true,
    "nfcNoBarcode": false
  }
}
  • requiresAuthentication / nfcFaceIdRequired: Solicita al usuario verificación mediante Face ID, Touch ID o código de acceso antes de transmitir el payload NFC al lector de la puerta.
  • nfcNoBarcode: Oculta el código de barras óptico en el anverso del pase al desplegar tornos seguros exclusivos por NFC.
  • Lectores hardware compatibles: Se integra con lectores certified NFC, Identiv e HID emparejados con Passinstance mediante configuraciones hardware reader / reader device.

API de baja instantánea y revocación

Cuando un empleado deja la organización o expira la acreditación temporal de un contratista, el acceso debe revocarse de inmediato:

Endpoint de revocación

POST /api/v1/passes/voiding/:id/void
Cabeceras
X-API-Key <API_KEY>
Content-Type application/json
JSON
{
  "voided": true,
  "options": {
    "reason": "CANCELLED",
    "customReason": "EMPLOYEE_OFFBOARDED",
    "sendPushNotification": false
  }
}

Resultado

  1. 1
    El status del pase cambia a VOIDED, lifecycleStatus (PassLifecycleStatus) pasa a VOIDED y el endpoint devuelve HTTP 204 No Content. Tenga en cuenta que options.reason admite VoidingReason (EXPIRED, CANCELLED, LOST, STOLEN, DUPLICATE, FRAUD, TECHNICAL_ISSUE, CUSTOMER_REQUEST, ADMIN_ACTION, SYSTEM_AUTO, OTHER).
  2. 2
    Todos los escaneos posteriores en tornos de acceso o puntos de control móviles se rechazan con la decisión ALREADY_VOIDED.
  3. 3
    Passinstance actualiza walletVoidStatus (WalletPropagationStatus: NONE -> PENDING -> QUEUED -> SUCCEEDED) a medida que los workers en segundo plano envían la actualización por APNs HTTP/2 y Google Wallet REST API.

Importante: El acceso a puertas sin contacto con Apple Wallet requiere un certificado comercial aprobado de Apple VAS (Value Added Services) emitido por Apple Developer Relations. El escaneo óptico QR/Aztec funciona de forma inmediata sin configuración previa en cámaras estándar y lectores de códigos 2D.

Más información sobre nuestras Soluciones de acceso e identidad.

Documentación de producto y API relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.