Start / Dokumentation och API

Dokumentation och API

Din data lämnar systemet lika rent som den kom in.

Fizzy är en öppen ryggrad. Varje förseglad försäljning finns tillgänglig via ett REST-API, skickas som webhookhändelser och kan exporteras i de format som redovisningskonsulter och skattemyndigheter redan accepterar. Ingen inlåsning, ingen skrapning av dina egna rapporter ur en PDF.

Begär API-åtkomstSe exportformat

Modellen

Sex objekt och en regel.

Regeln: inget redigeras någonsin. Rättelser läggs till, och kedjan går att verifiera hela vägen.

Enhet

En fysisk eller digital plats där du säljer. Äger sina kassor, sin personal och sitt lager.

Kassa

En enskild kassaplats. Varje post registrerar vilken kassa som skapade den.

Försäljning

Rader, antal, priser och moms per rad, plus betalningen som täckte den.

Journalpost

Den förseglade posten för en försäljning, makulering eller återbetalning. Hashkedjad till sin föregångare.

Betalning

Den Worldline-certifierade betalningen, avstämd mot försäljningen den reglerade.

Dagsavslut

Z-rapporten: en förseglad dagssammanställning som stänger sekvensen för den kassan.

Integrationsytor

Fyra vägar ut, välj den som passar.

01

REST-API

Hämta försäljningar, journalposter, produkter och dagsavslut i din egen takt. JSON över HTTPS, autentiserat med nyckel per kund.

02

Webhookar

Få en avisering i samma stund som en försäljning förseglas eller en dag stängs. Signerat, med omförsök och säkert att spela upp igen.

03

Filexporter

SAF-T, Z-rapporter och CSV för valfri period, genererade ur samma förseglade källa som allt annat.

04

Kopplingar

Färdiga vägar in i nordiska bokföringssystem och in i Baslic för deklaration.

REST-API

Läs din journal som om den vore din egen databas.

Autentiseringen är en API-nyckel per kund som skickas som bearer-token över HTTPS. Läsningar är sidindelade och kan filtreras på enhet och period. Skrivningar är begränsade med avsikt: journalen tar emot tillägg, aldrig ändringar, eftersom ett API som kunde skriva om historien skulle omintetgöra hela produkten.

Nycklar utfärdas per miljö, så du kan utveckla mot testdata innan du rör en kassa i drift.

Begär en nyckel

Typiska endpoints

GET/v1/saleslistar försäljningar i en period
GET/v1/sales/{id}en försäljning med rader
GET/v1/ledgerförseglade poster i ordning
GET/v1/day-closesZ-rapporter per kassa
GET/v1/productssortiment och momsklass
GET/v1/outletsenheter och kassor

Strukturerna här illustrerar modellen. Den bindande referensen följer med din API-nyckel.

En förseglad försäljningJSON
// GET /v1/sales/9f2c41e0 · illustrative
{
  "id": "9f2c41e0",
  "outlet": "kamppi",
  "counter": "pos-02",
  "sealed_at": "2026-08-03T14:22:07Z",
  "currency": "EUR",
  "total": "89.00",
  "lines": [
    { "sku": "MK-4417", "qty": 1,
      "net": "70.91", "vat_rate": "25.5",
      "vat": "18.09" }
  ],
  "payment": {
    "method": "card_contactless",
    "processor": "worldline",
    "reconciled": true
  },
  "seal": {
    "hash": "a3f9…e21",
    "prev": "7c14…b08",
    "staff": "anna.k"
  }
}
WebhookhändelserPUSH
// signed POST to your endpoint · illustrative

sale.sealed       a sale is written and closed
sale.voided       a void is appended, with reason
refund.created    a refund is appended
payment.settled   tender reconciled to the sale
payment.mismatch  money and record disagree
day.closed        Z-report sealed for a counter
export.ready      SAF-T or CSV available

Delivery
  · HMAC signature on every request
  · retried with backoff until 2xx
  · event ids are stable, so replays
    are safe to deduplicate

Använd payment.mismatch som en varning, inte en rapport. Den ska vara sällsynt och får aldrig ignoreras.

Exporter och kopplingar

Format som de som granskar dig redan läser.

Z-rapport· dagsavslut per kassaPDF · JSON
SAF-T· standardiserad revisionsfilXML
Försäljnings- och momssammanställning· valfri period, per enhetCSV · XLSX
Fullständig förseglad journal· poster med hashar, verifierbaraCSV · JSON
Produktkatalog· med momsklasser och lagersaldonCSV

Bokföringssystem

Vägar in i de nordiska system våra kunder använder, bland annat Netvisor, Procountor och e-conomic.

Baslic

Inbetalningar från Fizzy och fakturor från Baslic bildar ett granskningsbart spår, från kassan till deklarationen.

Ditt eget affärssystem

Talar det HTTP eller läser filer går det att mata. Berätta vilket format du behöver så mappar vi till det.

Skrivet för människor, utfärdat till kunder.

Den fullständiga referensen, testmiljöuppgifter och webhookinställningar skickas med din API-nyckel. Kunder, redovisningskonsulter som arbetar för en kund och partner som bygger en integration kan alla begära en.

Berätta vad du bygger och åt vilket håll datan behöver röra sig. Finns kopplingen redan säger vi det och besparar dig arbetet.

Begär API-åtkomstPrata med en utvecklare

Principer vi håller fast vid

  • ▪Din data är din, exporterbar när som helst, utan avgift
  • ▪Loggboken lägger till, den ändrar aldrig, och API:et respekterar det
  • ▪Brytande ändringar får en ny version, inte en överraskning en tisdag
  • ▪Varje siffra API:et returnerar går att spåra till förseglade rader
  • ▪Drift i EU, kundisolering, GDPR inbyggt
Trust Centre

Bygg på en ryggrad som inte kan ljuga för dig.

Begär API-åtkomstSe plattformen