Ana sayfa / Dokümanlar ve API

Dokümanlar ve API

Veriniz, girdiği kadar temiz çıkar.

Fizzy açık bir omurgadır. Her mühürlü satış REST API üzerinden erişilebilir, webhook olayı olarak iletilir ve muhasebecilerin ve vergi idarelerinin zaten kabul ettiği biçimlerde dışa aktarılabilir. Bağımlılık yok, kendi raporunuzu PDF'ten kazımak yok.

API erişimi isteyin Dışa aktarım biçimlerini görün

Model

Altı nesne ve tek kural.

Kural şu: hiçbir şey düzenlenmez. Düzeltmeler eklenir ve zincir baştan sona doğrulanabilir.

Şube

Satış yaptığınız fiziksel ya da çevrimiçi yer. Kendi kasalarına, personeline ve stoğuna sahiptir.

Kasa

Bir kasa örneği. Her kayıt, hangi kasadan çıktığını da yazar.

Satış

Satırlar, miktarlar, fiyatlar ve satır başına KDV; artı ödemeyi yapan ödeme aracı.

Defter kaydı

Bir satışın, iptalin ya da iadenin mühürlü kaydı. Kendinden öncekine hash ile zincirlenir.

Ödeme

Worldline sertifikalı ödeme aracı; kapattığı satışla mutabık.

Gün sonu

Z raporu: o kasanın dizisini kapatan mühürlü günlük özet.

Entegrasyon yüzeyleri

Dışarı açılan dört yol; size uyanı seçin.

REST API

Satışları, defter kayıtlarını, ürünleri ve gün sonlarını kendi programınıza göre çekin. HTTPS üzerinden JSON, kiracı başına anahtarla kimlik doğrulama.

Webhook'lar

Bir satış mühürlendiği ya da gün kapandığı anda bildirim alın. İmzalı, yeniden denemeli ve tekrar oynatmaya güvenli.

Dosya dışa aktarımı

Herhangi bir dönem için SAF-T, Z raporu ve CSV; diğer her şeyle aynı mühürlü kaynaktan üretilir.

Hazır entegrasyonlar

İskandinav muhasebe sistemlerine ve beyan için Baslic'e hazır rotalar.

REST API

Defterinizi kendi veritabanınızmış gibi okuyun.

Kimlik doğrulama, HTTPS üzerinden bearer token olarak gönderilen kiracı başına bir API anahtarıdır. Okumalar sayfalanır ve şube ve döneme göre filtrelenebilir. Yazmalar tasarım gereği sınırlıdır: defter ekleme kabul eder, düzenleme asla; çünkü geçmişi yeniden yazabilen bir API ürünün anlamını ortadan kaldırırdı.

Anahtarlar ortam başına verilir; böylece canlı bir kasaya dokunmadan önce test verisiyle geliştirme yapabilirsiniz.

Anahtar isteyin

Tipik uç noktalar

GET/v1/salesbir dönemdeki satışları listeler

GET/v1/sales/{id}tek satış, satırlarıyla

GET/v1/ledgermühürlü kayıtlar, sırasıyla

GET/v1/day-closeskasa başına Z raporları

GET/v1/productskatalog ve KDV sınıfı

GET/v1/outletsşubeler ve kasalar

Buradaki yapılar modeli örneklemek içindir. Asıl referans, API anahtarınızla birlikte gelir.

Mühürlü bir satışJSON

// 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 olaylarıPUSH

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

Şunu payment.mismatch bir rapor değil, uyarı olarak kullanın. Nadir olmalı ve asla göz ardı edilmemeli.

Dışa aktarım ve bağlayıcılar

Sizi denetleyenlerin zaten okuduğu biçimler.

Z raporu· kasa başına günlük kapanışPDF · JSON

SAF-T· standart denetim dosyasıXML

Satış ve KDV özeti· herhangi bir dönem, şube başınaCSV · XLSX

Tam mühürlü günlük· hash'leriyle kayıtlar, doğrulanabilirCSV · JSON

Ürün kataloğu· KDV sınıfları ve stoklaCSV

Muhasebe sistemleri

Müşterilerimizin kullandığı İskandinav sistemlerine rotalar: Netvisor, Procountor ve e-conomic dahil.

Baslic

Fizzy'den gelen para akışı ile şuradan gelen faturalar Baslic kasadan beyana kadar tek bir denetlenebilir iz oluşturur.

Kendi ERP'niz

HTTP konuşuyorsa ya da dosya okuyorsa beslenebilir. İhtiyacınız olan yapıyı söyleyin, ona eşleyelim.

İnsanlar için yazıldı, müşterilere verilir.

Tam referans, test ortamı bilgileri ve webhook kurulumu API anahtarınızla birlikte gönderilir. Müşteriler, bir müşteri adına çalışan muhasebeciler ve entegrasyon geliştiren iş ortakları anahtar isteyebilir.

Ne geliştirdiğinizi ve verinin hangi yöne akması gerektiğini söyleyin. Hazır bir bağlayıcı varsa söyler, sizi işten kurtarırız.

API erişimi isteyin Bir mühendisle konuşun

Bağlı kaldığımız ilkeler

▪Veriniz sizindir; istediğiniz zaman, ücretsiz dışa aktarılabilir
▪Defter ekler, asla düzenlemez ve API buna uyar
▪Kırıcı değişiklikler yeni bir sürüm alır, salı günü sürpriz olmaz
▪API'nin döndürdüğü her rakam mühürlü satırlara kadar izlenebilir
▪AB'de barındırma, kiracı yalıtımı, tasarımdan gelen GDPR uyumu

Güven Merkezi

Size yalan söyleyemeyecek bir omurga üzerine kurun.

API erişimi isteyin Platformu görün