Noodkassa (Emergency POS)¶

Doel¶

De noodkassa is een browser-based fallback kassasysteem dat in de fysieke winkel in Woerden gebruikt wordt wanneer het primaire K3/NAV kassasysteem niet beschikbaar is. Het systeem ondersteunt volledig offline gebruik: transacties worden lokaal opgeslagen en later gesynchroniseerd naar zwerfkei.nl zodra de internetverbinding hersteld is.

Systeemoverzicht¶

Het systeem bestaat uit twee applicaties die met elkaar communiceren:

Architectuur¶

sequenceDiagram
    actor Medewerker
    participant Kassa as zwerfkei_intern (browser)
    participant LocalDB as Lokale DB (winkelserver)
    participant API as zwerfkei.nl API
    participant PayNL as Pay.nl
    participant NAV as Microsoft Dynamics NAV

    Note over Kassa,LocalDB: Dagelijkse sync (of bij opstart)
    Kassa->>API: GET /api/webpostransaction?type=variant_lookup
    API-->>Kassa: Productdata (batches van 10.000)
    Kassa->>LocalDB: Sla op in variant_lookup + barcodes

    Note over Medewerker,LocalDB: Verkoop (online of offline)
    Medewerker->>Kassa: Scan barcode
    Kassa->>LocalDB: Zoek product in variant_lookup
    LocalDB-->>Kassa: Productdata
    Medewerker->>Kassa: Kies betaalmethode

    alt QR betaling (online vereist)
        Kassa->>API: GET /api/qr?type=payment_qr
        API->>PayNL: Maak betaling aan
        PayNL-->>API: QR-code URL
        API-->>Kassa: QR-code
        Medewerker->>PayNL: Klant scant QR
        Kassa->>API: GET /api/qr?type=is_paid (polling)
        API-->>Kassa: is_paid = true
    end

    Kassa->>LocalDB: Sla transactie op (pos_transactions)
    Kassa->>Kassa: Print bon (print queue)

    Note over Kassa,NAV: Synchronisatie (achtergrond)
    Kassa->>API: POST /api/webpostransaction (unsynced transacties)
    API->>API: Maak order aan (systeem-klant)
    API->>NAV: Stuur order door
    NAV-->>API: Bevestiging
    API-->>Kassa: { ordernr: "..." }
    Kassa->>LocalDB: Markeer transactie als synced

Huidige situatie (legacy)¶

Betaalmethoden¶

Betaaltype-mapping in de code:

public static $paymentTypes = array(19 => 'cash', 21 => 'pin', 26 => 'qr');

Kassasessie & artikelen toevoegen¶

Een sessie wordt opgestart via Pos::start('Noodkassa') en is gekoppeld aan de PHP-sessie. Artikelen worden toegevoegd via barcode-scan of zoekfunctie:

• Barcode-scan — zoekt op barcodes.barcode → variant_lookup (lokale DB)
• Zoekfunctie — full-text search op variant_lookup.search (merk + naam + kleur + maat)
• Handmatige prijs — medewerker kan prijs overschrijven; negatieve prijs = retour (amount = -2)

QR-betaling (Pay.nl)¶

1. Kassa genereert een unieke temp_reference via MySQL GET_LOCK() (voorkomt botsingen bij meerdere actieve kassa's)
2. zwerfkei.nl maakt een betaalsessie aan bij Pay.nl en retourneert de QR-code
3. Kassa pollt is_paid totdat betaling bevestigd is
4. Bij checkout wordt de temp_reference meegestuurd zodat zwerfkei.nl het bestaande payment-record koppelt aan het nieuwe ordernummer

Lokale opslag & synchronisatie¶

Transacties worden altijd eerst lokaal opgeslagen, ongeacht of er internet is:

Lokale tabellen (zwerfkei_intern DB):

Synchronisatie naar zwerfkei.nl:

De Sync-component stuurt alle transacties met synced IS NULL naar POST /api/webpostransaction. Bij succes wordt synced = time() en ordernr opgeslagen.

Order aanmaken op zwerfkei.nl¶

Elke gesynchroniseerde transactie resulteert in een reguliere order:

Bon printen¶

Na een succesvolle checkout genereert zwerfkei_intern een PDF-bon via Receipt::publish() en stuurt deze naar de print queue (printOutput('b5')). De bon bevat:

• Bonnummer (webpos{datum}-{id})
• Artikelrijen (aantal, barcode, omschrijving, maat, kleur, kortings%, prijs, netto)
• Totaal incl. BTW
• BTW-uitsplitsing (6%, 9%, 21%)
• Betaalmethode

Monitoring & alerts¶

De Sync::checkSync() methode controleert twee zaken en stuurt bij problemen een e-mail naar floris@zwerfkei.nl + marcel@zwerfkei.nl:

Relevante bestanden¶

zwerfkei_intern (scripts/zwerfkei_intern)¶

zwerfkei.nl (zwerfkei_bitbucket)¶

Target situatie¶

Bekende doelen¶

• Integratie met de nieuwe orderflow in zwerfkei-backend
• Behoud van offline-first werking (transacties lokaal opslaan, later sync)
• Betere observeerbaarheid van sync-status (dashboard / alerts)
• Modernere stack voor de POS-client (los van de legacy CodeIgniter-applicatie)

Verbinding met andere features¶

• Order Management — Noodkassa-transacties worden als gewone orders aangemaakt
• POS & Physical Store — Context van de fysieke winkel
• Payment Process — QR-betaling via Pay.nl, webPOS source
• Print Queue — Bon wordt geprint via de print queue