Tornello Disco (Turnstile-API)¶
L'API del tornello decide, presso un tornello con trattenuta della carta, se una carta ospite Disco può lasciare il locale. È volutamente semplice, in modo che un controller del tornello possa richiamarla senza autenticazione (JWT): la API key viene passata nell'URL.
Configurazione¶
Admin → Disco → Generale → Tornello (Turnstile-API)
- „Genera" crea una API key (viene mostrata per intero).
- Salvare.
- Riprendere l'URL di collegamento accanto con „Copia" e inserirla nel tornello.
Una API key vuota disattiva l'API del tornello.
Chiamata¶
{key}— la API key configurata.{kartenId}— l'ID della carta ospite presentata.
La risposta è un oggetto JSON:
{ "canExit": true, "message": "Karte kann raus — Restguthaben 5,00 €", "refund": 5.0, "status": "ok" }
message è pensato per la visualizzazione al tornello.
Codici di stato¶
| Codice | Significato | Tornello |
|---|---|---|
| 200 | La carta è coperta — può uscire (refund = eventuale credito residuo) |
si apre |
| 402 | C'è ancora un importo aperto — si prega di passare alla cassa | bloccato |
| 423 | La carta è bloccata | bloccato |
| 409 | La carta è già stata regolata | bloccato |
| 404 | Carta sconosciuta | bloccato |
| 401 | La API key manca o è errata | bloccato |
Regola al tornello: 200 = si apre, tutto il resto = bloccato e mostrare message.
Regolamento e posto licenza¶
Con una carta coperta (stato 200), il tornello regola immediatamente il conto della carta — tramite un utente proprio, creato automaticamente, „Tornello". Il tornello si annuncia in questo caso come un dispositivo di cassa e occupa così un posto licenza (seat).
Se, eccezionalmente, la carta non può essere regolata immediatamente (ad es. perché non c'è alcun posto libero), l'ospite può comunque uscire — la carta viene allora regolata alla chiusura giornaliera.
Credito residuo
Un credito residuo sulla carta (refund) non viene erogato al tornello. L'ospite lo ritira
alla cassa; la registrazione segue l'impostazione Credito residuo sulle carte (Rimborso /
Decadenza del credito / Mancia).
Funzioni correlate¶
Senza tornello esistono due alternative mobili all'uscita:
- Self-checkout (
/disco/selfcheckout) — chiosco: cornice verde a schermo intero „OK ed esci" quando la carta è coperta, cornice rossa con importo se c'è ancora da pagare. - Cassa d'uscita mobile — la cassa Disco come vista da telefono (schede Foto/Posizioni/Info) per una cassa aggiuntiva, quando c'è molta affluenza.