Modulär installation

Delarna i R-GO pratar med varandra över HTTP och WebSocket, så de behöver inte stå på samma maskin. I ett modulärt upplägg står varje del där den gör mest nytta: skrivaren och kontrollenheten på en liten dator vid disken, kassan på en server eller en dator i bakrummet, kassörens skärm på en surfplatta, kunddisplayen på en skärm vid utgången.

Priset är fler saker att hålla ordning på: adresser, brandväggar och fler maskiner som måste vara igång. Ge varje maskin en fast adress i routern

• delarna hittar varandra via adresser i inställningarna, och en adress som byts av routern gör att kassan tappar skrivaren.

Vad som kan flyttas

Kassan och inställningarna kan inte delas upp: de läser och skriver samma datakatalog.

Skrivare och kontrollenhet på en egen maskin

Typfallet: en liten dator (Windows, Linux eller en Raspberry Pi) vid disken med kvittoskrivaren och CleanCash, och kassan någon annanstans.

På skrivarmaskinen installeras bara skrivartjänsten. Den måste lyssna på nätet, inte bara lokalt:

receiptprinter --printer-only --http 0.0.0.0:8088 --config receiptprinter.json

I Windows-paketet: ändra "127.0.0.1:8088" till "0.0.0.0:8088" under receiptprinter i C:\ProgramData\R-GO\services.json och starta om tjänsten. Ställ sedan in skrivaren och CleanCash på http://<skrivarmaskinen>:8088/setup; ändra CleanCash-bryggans WebSocket-adress till 0.0.0.0:8765 och tryck Starta om tjänsten.

På kassans maskin pekas kassan dit, i datakatalogens config/:

• printer_service.json: "base_url": "http://<skrivarmaskinen>:8088"
• cleancash.json: "websocketUrl": "ws://<skrivarmaskinen>:8765/ws"

och kassan startas om.

Brandväggen på skrivarmaskinen: öppna 8088 och 8765, och begränsa dem till kassans adress. Varken skrivartjänsten eller CleanCash-bryggan har någon inloggning utöver lösenordet på /setup.

Exportarkivet för bokföringen ligger hos skrivartjänsten (export/ i dess arbetskatalog) - det är där Z-rapportens verifikat hamnar, och dit Fortnox-tjänsten behöver nå.

Kassörens skärm på en surfplatta eller tunn klient

Kassan är en webbsida, så kassörens skärm kan vara vilken enhet som helst med en webbläsare. Kassan måste då lyssna på nätet med båda portarna:

web_till --data-dir <katalog> --http 0.0.0.0:8090 --ws 0.0.0.0:8091

(i Windows-paketet: services.json under web_till). Webbsidan öppnar sin WebSocket mot samma maskin den hämtades från, så det räcker att öppna http://<kassan>:8090/ på surfplattan.

• iPad: öppna adressen i Safari och lägg till den på hemskärmen - då startar kassan i helskärm utan adressfält.
• Windows tunn klient: installera bara appen rgo-display och ange kassans adress som host i display\kassa.json.
• Äldre enheter (Android 5 och äldre webbvyer): använd http://<kassan>:8090/index.es5.html.

Öppna 8090 och 8091 i kassans brandvägg, gärna bara för de enheter som ska vara kassor.

Kunddisplayen på en egen skärm

Kunddisplayen är sidan /customer/ på kassan. Den kan visas på vilken skärm som helst som når kassan: i en webbläsare i helskärm, eller med rgo-display och display\kunddisplay.json där host är kassans adress och path är /customer.

Inställningarna

Inställningssidan har ingen inloggning och lyssnar därför bara på kassans egen maskin. Når du inte den maskinens skärm, använd en SSH-tunnel eller fjärrskrivbord:

ssh -L 8092:127.0.0.1:8092 <kassans maskin>

och öppna http://127.0.0.1:8092/ på din egen dator.

Kortterminal

• Nets ringer upp kassan: terminalen ställs in med kassans adress och port 20002, och kassans brandvägg släpper in den.
• Worldline rings upp av kassan: kassan behöver nå terminalen, och för att terminalen ska synas automatiskt i inställningarna måste kassans maskin ta emot UDP 8000 från terminalens nät.

Hitta delarna

R-GO-delarna annonserar sig i nätet (mDNS), och inställningssidan kan visa vad som finns - kassor, skrivartjänster med vad de klarar, nätverksskrivare och Worldline-terminaler. Det når bara det egna nätsegmentet; adresserna går alltid att skriva in för hand.