Torniquete de discoteca (API Turnstile)¶
La API del torniquete decide, en un torniquete de retención de tarjetas, si una tarjeta de invitado del Disco puede abandonar el recinto. Está deliberadamente concebida de forma sencilla para que un controlador de torniquete pueda llamarla sin inicio de sesión (JWT): la clave API se transmite en la URL.
Configuración¶
Admin → Disco → General → Torniquete (API Turnstile)
- «Generar» crea una clave API (se muestra completa).
- Guardar.
- Copiar la URL de conexión de al lado con «Copiar» y guardarla en el torniquete.
Una clave API vacía desactiva la API del torniquete.
Llamada¶
{key}— la clave API configurada.{kartenId}— el ID de la tarjeta de invitado colocada.
La respuesta es un objeto JSON:
{ "canExit": true, "message": "Karte kann raus — Restguthaben 5,00 €", "refund": 5.0, "status": "ok" }
message está pensado para mostrarse en el torniquete.
Códigos de estado¶
| Código | Significado | Torniquete |
|---|---|---|
| 200 | La tarjeta está cubierta — puede salir (refund = posible saldo restante) |
abrir |
| 402 | Aún queda un importe pendiente — diríjase a caja | bloqueado |
| 423 | La tarjeta está bloqueada | bloqueado |
| 409 | La tarjeta ya está liquidada | bloqueado |
| 404 | Tarjeta desconocida | bloqueado |
| 401 | Falta la clave API o es incorrecta | bloqueado |
Regla en el torniquete: 200 = abrir, todo lo demás = bloqueado y mostrar message.
Liquidación y plaza de licencia¶
Con una tarjeta cubierta (estado 200), el torniquete liquida la tarjeta de inmediato — bajo un usuario propio, creado automáticamente, llamado «Torniquete». Al hacerlo, el torniquete se registra como si fuera un dispositivo de caja y, por tanto, ocupa una plaza de licencia.
Si excepcionalmente la tarjeta no puede liquidarse de inmediato (p. ej. porque no hay ninguna plaza libre), el invitado puede salir de todos modos — la tarjeta se liquidará entonces en el cierre de caja.
Saldo restante
Un saldo restante de la tarjeta (refund) no se paga en el torniquete. El invitado lo recoge en
caja; la contabilización sigue la configuración Saldo restante en tarjetas (pagar / caducidad
del saldo / propina).
Funciones relacionadas¶
Sin torniquete existen dos alternativas móviles en la salida:
- Autocobro (
/disco/selfcheckout) — quiosco: marco verde a pantalla completa «OK, puede salir» si la tarjeta está cubierta, marco rojo con el importe si aún queda algo por pagar. - Caja de salida móvil — la caja del Disco en vista de móvil (pestañas Foto/Posiciones/ Información) para disponer de una caja adicional cuando hay mucha afluencia.