Forside / Dokumentation og API

Dokumentation og API

Dine data forlader systemet lige så rene, som de kom ind.

Fizzy er en åben rygrad. Hvert forseglet salg er tilgængeligt via et REST-API, sendes som webhook-hændelser og kan eksporteres i de formater, revisorer og skattemyndigheder allerede accepterer. Ingen fastlåsning, ingen skrabning af dine egne rapporter ud af en PDF.

Anmod om API-adgang Se eksportformater

Modellen

Seks objekter og én regel.

Reglen: intet bliver nogensinde redigeret. Rettelser tilføjes, og kæden kan verificeres hele vejen.

Afdeling

Et fysisk eller digitalt sted, hvor du sælger. Ejer sine egne kasser, sit personale og sit lager.

Kasse

En enkelt kasseplads. Hver postering registrerer, hvilken kasse der skabte den.

Salg

Linjer, antal, priser og moms pr. linje samt den betaling, der dækkede det.

Journalpostering

Den forseglede postering for et salg, en annullering eller en retur. Hashkædet til sin forgænger.

Betaling

Den Worldline-certificerede betaling, afstemt mod det salg, den dækkede.

Dagsafslutning

Z-rapporten: en forseglet dagsopgørelse, der lukker sekvensen for den kasse.

Integrationsflader

Fire veje ud, vælg den, der passer.

REST-API

Hent salg, journalposteringer, varer og dagsafslutninger i dit eget tempo. JSON over HTTPS, godkendt med nøgle pr. kunde.

Webhooks

Få besked i samme øjeblik et salg forsegles, eller en dag lukkes. Signeret, med genforsøg og sikkert at afspille igen.

Fileksporter

SAF-T, Z-rapporter og CSV for en hvilken som helst periode, genereret fra samme forseglede kilde som alt andet.

Forbindelser

Færdige veje ind i nordiske bogføringssystemer og ind i Baslic til angivelse.

REST-API

Læs din journal, som var den din egen database.

Godkendelsen er en API-nøgle pr. kunde, sendt som bearer-token over HTTPS. Læsninger er sideinddelte og kan filtreres på afdeling og periode. Skrivninger er begrænsede med vilje: journalen tager imod tilføjelser, aldrig ændringer, fordi et API, der kunne omskrive historikken, ville underminere hele produktet.

Nøgler udstedes pr. miljø, så du kan udvikle mod testdata, før du rører en kasse i drift.

Anmod om en nøgle

Typiske endpoints

GET/v1/salesviser salg i en periode

GET/v1/sales/{id}ét salg med linjer

GET/v1/ledgerforseglede posteringer i rækkefølge

GET/v1/day-closesZ-rapporter pr. kasse

GET/v1/productsvarekatalog og momsklasse

GET/v1/outletsafdelinger og kasser

Strukturerne her illustrerer modellen. Den bindende dokumentation følger med din API-nøgle.

Et forseglet salgJSON

// 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"
  }
}

Webhook-hæ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

Brug payment.mismatch som en advarsel, ikke en rapport. Den bør være sjælden og må aldrig ignoreres.

Eksporter og forbindelser

Formater, som de, der reviderer dig, allerede læser.

Z-rapport· dagsafslutning pr. kassePDF · JSON

SAF-T· standardiseret revisionsfilXML

Salgs- og momsopgørelse· vilkårlig periode, pr. afdelingCSV · XLSX

Hele den forseglede journal· posteringer med hashværdier, kan verificeresCSV · JSON

Varekatalog· med momsklasser og lagertalCSV

Bogføringssystemer

Veje ind i de nordiske systemer, vores kunder bruger, blandt andet Netvisor, Procountor og e-conomic.

Baslic

Indbetalinger fra Fizzy og fakturaer fra Baslic danner ét reviderbart spor, fra kassen til angivelsen.

Dit eget ERP-system

Taler det HTTP eller læser filer, kan det fodres. Fortæl os, hvilket format du har brug for, så mapper vi til det.

Skrevet til mennesker, udleveret til kunder.

Den fulde dokumentation, testmiljøadgang og webhook-opsætning sendes med din API-nøgle. Kunder, revisorer der arbejder på en kundes vegne, og partnere der bygger en integration kan alle bede om en.

Fortæl os, hvad du bygger, og hvilken vej dataene skal bevæge sig. Findes forbindelsen allerede, siger vi det og sparer dig arbejdet.

Anmod om API-adgang Tal med en udvikler

Principper vi holder fast i

▪Dine data er dine, kan eksporteres når som helst, uden gebyr
▪Journalen tilføjer, den ændrer aldrig, og API'et respekterer det
▪Brydende ændringer får en ny version, ikke en overraskelse en tirsdag
▪Hvert tal, API'et returnerer, kan spores tilbage til forseglede rækker
▪Drift i EU, adskillelse mellem kunder, GDPR indbygget

Trust Centre

Byg på en rygrad, der ikke kan lyve for dig.

Anmod om API-adgang Se platformen