Datakatalogen och konfigurationsfilerna

Kassan (web_till), inställningssidan (web_setup) och terminalkassan (interactive) startas med samma datakatalog, --data-dir <katalog>, och läser då exakt samma filer. Sökvägarna räknas ut på ett enda ställe i koden (rust-poc/src/data_paths.rs), så en ny fil syns i alla tre.

Layout

<datakatalog>/
  journal/              fiskal journal, en fil per Z-period
  counters.db           löpnummer (kvitto, Z)
  products.db           produktregistret
  values.db             värdehandlingar (tillgodo) och signeringsnyckeln
  config/*.json         inställningarna, se nedan
  web_client/           kassans webbsidor
  web_client_setup/     inställningssidans webbsidor

Filerna i config/

fil	innehåll	ändras i
`company_info.json`	företagets namn, adress, org.nr - står på kvittot	för hand
`vat_rates.json`	de fyra momssatserna	inställningssidan, Moms
`logic_settings.json`	kassans beteende (t.ex. decimaler vid beloppsinmatning)	för hand
`control_unit.json`	vilken kontrollenhet kassan använder	för hand
`cleancash.json`	anslutning till CleanCash	för hand
`printer_service.json`	var receiptprinter kör (`base_url`), kan vara en annan maskin	för hand
`receipt_logo.json`	loggans placering (på/av, justering, bredd); bilden ligger hos receiptprinter	inställningssidan, Logga
`card_payment.json`	kortterminal: `none`, `nets` eller `worldline`	inställningssidan, Kortterminal
`worldline_keys.json`	Worldline-terminalens adress och nycklar	för hand - se nedan
`chart_of_accounts.json`	kontoplan för bokföringsexporten	inställningssidan, Konton
`extended_product_groups.json`	varugrupper	inställningssidan, Varugrupper
`function_concepts.json`	funktionernas färger på knapparna	inställningssidan
`panel_layout.json`, `panel_positions.json`, `item_area_grid.json`	skärmens panel och artikelytans rutnät	inställningssidan, Knappar
`key_bindings.json`, `keymap.json`, `web_keymap.json`	vad tangenter och knappar gör	inställningssidan, Knappar

Ljud vid knapptryck

Kassan klickar kort när en knapp trycks och ger en lägre ton när den svarar med ett fel. Det styrs i logic_settings.json:

"key_sound": {"click": true, "error": true, "volume": 0.3}

volume är 0-1; 0 stänger av ljudet helt. Saknas avsnittet är båda ljuden på, med låg volym. Ändringen gäller när kassan startas om och kassasidan laddats om.

Fast växelkassa

Den växelkassa som gäller vid Z-rapporten kan föras över till nästa period, så att den inte behöver slås in varje dag:

"change_fund": {"carry_over": true}

Vid Z-rapporten journalförs samma belopp som växelkassa i den nya perioden, med numret på den Z-rapport det kom från, och en remsa skrivs ut. Beloppet kan ändras före periodens första köp, som en vanlig växelkassa. Saknas avsnittet är det avstängt, och växelkassan registreras för hand varje period.

Föreskrifterna (SKVFS 2021:17, 5 kap. 1 § och 7 kap.) kräver att kassan kan registrera växelkassa och förändringar av den, och att X- och Z-rapporten visar den - inte att den slås in varje dag. Stäm ändå av inställningen med er kontrollant eller revisor.

Panelens och knapparnas filer hänger ihop - ett knapp-id finns i flera av dem. Ändra dem i inställningssidan, inte för hand: en handredigerad fil som inte stämmer gör att panelen tyst inte ritas.

Säkerhet

values.db innehåller nyckeln som signerar tillgodokvitton. Den ska aldrig kopieras till git, mejl eller delade kataloger. Säkerhetskopiera den krypterat.
worldline_keys.json innehåller terminalens hemliga nyckel. Filen ska bara kunna läsas av kassans användare (chmod 600) och hålls utanför git.
Kassan lämnar bara ut de filer i config/ som kassasidan behöver - layouten, knapparna, färgerna och knappbilderna. Nycklar, lösenord och logic_settings.json går inte att hämta via kassans webbadress.
Journalen är fiskal och får inte ändras. Säkerhetskopiera hela journal/.