Kiosk instellen

Een kiosk is een tablet op locatie (werkvloer, ingang van het magazijn) waarop krachten in- en uitklokken met een persoonlijke pincode. Geen app of mail nodig. Bij uitklokken worden de uren vastgelegd als kioskuren ("Kiosk") op de plaatsing van de kracht.

Details voor ontwikkelaars (Engels): Kiosk.

1. De kiosk aanmaken (beheerder)

1. Ga naar "Regels & koppelingen" → "Kiosk (tablet op locatie)".
2. Vul een naam in (bijv. "Hal 3 – Logistiek Parkstad").
3. Optioneel: kies één opdrachtgever ("Alleen voor opdrachtgever"). Dan kunnen alleen plaatsingen bij die opdrachtgever op deze tablet inklokken. "Alle opdrachtgevers" staat elke actieve plaatsing toe.
4. Klik op "Kiosk toevoegen". Er verschijnt één keer een apparaattoken dat begint met ttk_. Kopieer het nu.

2. De tablet voorbereiden

1. Open dit adres in de browser van de tablet, met je token: https://app.timetracking.tech/kiosk#device=ttk_...
2. De tablet onthoudt het token en haalt het uit de adresbalk. Zet de pagina op het beginscherm.
3. Vergrendel de tablet op deze pagina (iPad: Begeleide toegang; Android: scherm vastzetten of een kioskmodus-app). Houd hem opgeladen en op wifi.

Worden de browsergegevens van de tablet gewist, open dan het adres met het token opnieuw. Token kwijt? Verwijder de kiosk ("Ontkoppelen") en maak een nieuwe.

3. Krachten een pincode geven

1. Ga naar "Medewerkers", open de kracht, vul "Pincode" in en klik op "Pincode opslaan".
2. Pincodes moeten precies 6 cijfers hebben en niet makkelijk te raden zijn: niet allemaal hetzelfde cijfer (111111) en geen reeks (123456, 654321). Elke pincode moet uniek zijn binnen je organisatie. Oudere pincodes van 4–5 cijfers blijven werken tot ze worden gewijzigd.
3. Vertel elke kracht zijn pincode persoonlijk.

4. Dagelijks gebruik

1. De kracht tikt zijn pincode in.
2. De tablet toont zijn plaatsingen op deze locatie. Hij tikt er één aan om in te klokken, of om uit te klokken als hij al is ingeklokt.
3. Bij uitklokken worden de uren vastgelegd met een automatische pauze: meer dan 5,5 uur gewerkt → 30 minuten; meer dan 10 uur → 45 minuten.
4. Kioskuren volgen daarna de normale route: gekoppeld aan andere bronnen, ingediend, goedgekeurd, geëxporteerd.

Veelvoorkomende problemen

Melding / probleem	Oorzaak	Oplossing
"Unknown PIN"	Verkeerde pincode, of de kracht is niet actief	Controleer de pincode bij "Medewerkers"; stel een nieuwe in
"Too many wrong PINs, try again in a few minutes"	5 foute pincodes binnen 15 minuten op deze tablet	Wacht 15 minuten
"Not your placement at this kiosk"	De kiosk hoort bij een andere opdrachtgever, of de plaatsing is vandaag niet actief	Controleer de opdrachtgever van de kiosk en de datums van de plaatsing
"Open punch is older than 16 hours; ask the office to correct it"	De kracht vergat uit te klokken	Vul de echte uren in bij "Uren invoeren"; de kracht kan daarna weer inklokken
"Unknown kiosk"	Kiosk verwijderd, of het token ontbreekt op de tablet	Open het kioskadres opnieuw met het token, of maak een nieuwe kiosk
"This PIN is already used by someone else"	Pincodes moeten uniek zijn	Kies een andere pincode
Pauze afgetrokken terwijl de kracht geen pauze had	Automatische wettelijke minimumpauze (Arbeidstijdenwet)	Corrigeer zo nodig de uren bij "Uren invoeren"

Automatiseren

Pincodes instellen via de API met POST /people/{id}/pin {"pin":"482915"} (sleutel met write-scope). Kioskapparaten via de API aanmaken vraagt een sleutel met admin-scope (of gebruik het dashboard als beheerder).

In English: Kiosk setup.