Etusivu / Dokumentaatio ja rajapinta

Dokumentaatio ja rajapinta

Datasi lähtee yhtä siistinä kuin se saapui.

Fizzy on avoin selkäranka. Jokainen sinetöity myynti on saatavilla REST-rajapinnan kautta, työnnetään webhook-tapahtumina ja on vietävissä muodoissa jotka kirjanpitäjät ja veroviranomaiset jo hyväksyvät. Ei lukkiutumista, ei omien raporttien kaivamista PDF:stä.

Pyydä rajapintapääsyKatso vientimuodot

Malli

Kuusi objektia ja yksi sääntö.

Sääntö: mitään ei koskaan muokata. Korjaukset lisätään perään, ja ketju on todennettavissa päästä päähän.

Toimipiste

Fyysinen tai verkossa oleva paikka jossa myyt. Omistaa omat kassansa, henkilökuntansa ja varastonsa.

Kassa

Yksittäinen kassapiste. Jokainen kirjaus tallentaa, mikä kassa sen tuotti.

Myynti

Rivit, määrät, hinnat ja rivikohtainen ALV sekä maksutapahtuma joka sen maksoi.

Kirjausrivi

Myynnin, mitätöinnin tai hyvityksen sinetöity kirjaus. Tiivisteketjutettu edeltäjäänsä.

Maksu

Worldline-sertifioitu maksutapahtuma, täsmäytettynä siihen myyntiin jonka se kuittasi.

Päivän päätös

Z-raportti: sinetöity päivätiivistelmä joka sulkee kyseisen kassan sarjan.

Integraatiopinnat

Neljä reittiä ulos, valitse sopiva.

01

REST-rajapinta

Hae myynnit, kirjausrivit, tuotteet ja päivän päätökset omaan tahtiisi. JSON HTTPS:n yli, asiakaskohtaisella avaimella tunnistettuna.

02

Webhookit

Saat tiedon heti kun myynti sinetöidään tai päivä suljetaan. Allekirjoitettu, uudelleenyritetty ja turvallinen toistaa.

03

Tiedostoviennit

SAF-T, Z-raportit ja CSV miltä tahansa jaksolta, tuotettuna samasta sinetöidystä lähteestä kuin kaikki muukin.

04

Liittimet

Valmiit reitit pohjoismaisiin kirjanpitojärjestelmiin ja Basliciin ilmoittamista varten.

REST-rajapinta

Lue kirjanpitoasi kuin se olisi oma tietokantasi.

Tunnistautuminen tapahtuu asiakaskohtaisella rajapinta-avaimella, joka lähetetään bearer-tokenina HTTPS:n yli. Luvut on sivutettu ja suodatettavissa toimipisteen ja jakson mukaan. Kirjoitukset ovat tarkoituksella rajattuja: myyntipäiväkirja hyväksyy lisäyksiä, ei koskaan muokkauksia, koska historiaa uudelleen kirjoittava rajapinta tekisi koko tuotteesta turhan.

Avaimet annetaan ympäristökohtaisesti, joten voit kehittää testidataa vasten ennen kuin kosket tuotannon kassaan.

Pyydä avain

Tyypilliset päätepisteet

GET/v1/saleslistaa jakson myynnit
GET/v1/sales/{id}yksi myynti riveineen
GET/v1/ledgersinetöidyt kirjaukset järjestyksessä
GET/v1/day-closesZ-raportit kassoittain
GET/v1/productstuotteet ja ALV-luokka
GET/v1/outletstoimipisteet ja kassat

Tässä näytetyt rakenteet havainnollistavat mallia. Sitova dokumentaatio toimitetaan rajapinta-avaimesi mukana.

Sinetöity myyntiJSON
// 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-tapahtumatPUSH
// 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

Käytä tapahtumaa payment.mismatch hälytyksenä, ei raporttina. Sen pitäisi olla harvinainen, eikä sitä saa koskaan ohittaa.

Viennit ja liittimet

Muotoja, joita sinua tarkastavat lukevat jo valmiiksi.

Z-raportti· päivän päätös kassoittainPDF · JSON
SAF-T· vakiomuotoinen tarkastustiedostoXML
Myynti- ja ALV-yhteenveto· mikä tahansa jakso, toimipisteittäinCSV · XLSX
Koko sinetöity päiväkirja· kirjaukset tiivisteineen, todennettavissaCSV · JSON
Tuoteluettelo· ALV-luokkineen ja varastosaldoineenCSV

Kirjanpitojärjestelmät

Reitit pohjoismaisiin järjestelmiin joita asiakkaamme käyttävät, mukaan lukien Netvisor, Procountor ja e-conomic.

Baslic

Fizzystä tuleva rahavirta ja laskut palvelusta Baslic muodostavat yhden tarkastettavan polun kassalta ilmoitukseen.

Oma toiminnanohjauksesi

Jos se puhuu HTTP:tä tai lukee tiedostoja, sitä voidaan syöttää. Kerro tarvitsemasi muoto, niin kuvaamme datan siihen.

Kirjoitettu ihmisille, annetaan asiakkaille.

Täysi dokumentaatio, testiympäristön tunnukset ja webhook-asetukset lähtevät rajapinta-avaimesi mukana. Sitä voivat pyytää asiakkaat, asiakkaan puolesta työskentelevät kirjanpitäjät ja integraatiota rakentavat kumppanit.

Kerro mitä rakennat ja mihin suuntaan datan pitää liikkua. Jos liitin on jo olemassa, sanomme sen ja säästämme sinulta työn.

Pyydä rajapintapääsyJuttele kehittäjän kanssa

Periaatteet joista pidämme kiinni

  • ▪Datasi on sinun, vietävissä milloin tahansa, maksutta
  • ▪Kirjanpito lisää, ei koskaan muokkaa, ja rajapinta kunnioittaa sitä
  • ▪Rikkovat muutokset saavat uuden version, eivät yllätystä tiistaina
  • ▪Jokainen rajapinnan palauttama luku jäljittyy sinetöityihin riveihin
  • ▪EU-konesalit, asiakkaiden eristys, GDPR sisäänrakennettuna
Luottamuskeskus

Rakenna selkärangan varaan, joka ei voi valehdella sinulle.

Pyydä rajapintapääsyTutustu alustaan