REST API · v1

Baslic'i kendi yığınına bağla.

Fişi yönlendir, KDV'yi satır bazında sınıflandır, VIES'i doğrula ve temiz kayıtları muhasebeye aktar — hepsi programatik olarak. Kimlik doğrulama tek Bearer token. Her şey JSON.

5 dakikalık hızlı başlangıç

İlk fişini tek bir cURL ile gönder.

Çalışma alanı ayarlarından bir API anahtarı al, cURL'ü receipts endpoint'ine yönlendir, satır bazlı KDV, sınıflandırmalar ve ruleId'lerle birlikte ayrıştırılmış bir JSON döndürelim.

API anahtarı al Dokümanları oku

upload-receipt.sh

bash

# Upload a Z-report and get per-line VAT back
curl -X POST https://api.baslic.com/v1/receipts \
  -H "Authorization: Bearer $BASLIC_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/z-report.pdf" \
  -F "workspace=fidanet"

# 200 OK · ~1.4s · returns parsed + classified
{
  "id": "rcp_a1b2c3",
  "vendor": "Ravintola Linnea",
  "lines": [
    {"item": "Food", "vat": "13.5%", "ruleId": "vat-fi-food"},
    {"item": "Beer", "vat": "25.5%", "ruleId": "vat-fi-alcohol"}
  ]
}

Endpoint'ler

Altı endpoint. Genelde ihtiyacın olan kadar.

POST/v1/receipts

Fiş yükle

JPG, PNG, PDF, HEIC kabul eder. Ayrıştırılmış satırlar + Timo'nun satır bazlı KDV sınıflandırmasını ruleId'lerle döndürür.

Referans

POST/v1/invoices

Giden fatura kaydet

Müşterinin KDV numarasına göre ters ibraz ve %0 ihracatı otomatik tespit eder. Uygunsa VIES kanıtını saklar.

Referans

GET/v1/classify

Yükleme yapmadan metin sınıflandır

Fiş metnini ya da fatura açıklamasını gönder, KDV oranı ve ruleId'i geri al. Önizleme için kullanışlıdır.

Referans

GET/v1/vies/:vatId

Canlı VIES doğrulama

AB VIES siciline gider, şirket adı + adres + doğrulama zaman damgasını döndürür. 24 saat önbellekte.

Referans

POST/v1/exports

Muhasebeye aktar

Procountor, Netvisor, e-conomic, Fortnox ya da evrensel CSV/SAF-T'ye dışa aktarım tetikler.

Referans

GET/v1/clients

Müşterileri listele (mali müşavir)

Mali müşavir panelindeki her müşteriyi kanban durumu ve son dışa aktarım zaman damgasıyla döndürür.

Referans

Kimlik doğrulama

Bearer token

Çalışma alanı başına API anahtarları, istediğin zaman yenilenebilir. Okuma, yazma ya da yönetici olarak kapsamlandırılır.

Webhook'lar

Push olayları

receipt.parsed, classification.flagged, export.completed — HMAC-SHA256 ile imzalanır.

Rate limit'ler

Dakikada 60 · günde 5 bin

Business Pro ve özel Muhasebe Firması planlarında daha yüksek limitler. Backoff ile yumuşak yeniden denemeler.

SDK'lar

Yığının için SDK kullan — ya da sadece cURL.

TypeScript

Node

@baslic/sdk

Python 3.10+

Python

baslic

Go 1.22+

github.com/baslic/baslic-go

SDK gerekmez

cURL

any HTTP client

Webhook payload'ı

Fiş ayrıştırıldı → senin endpoint'in.

Çalışma alanı ayarlarından olaylara abone ol. 24 saat boyunca üstel backoff ile yeniden deneriz ve başarısızlıkları panelinde gösteririz.

İmza X-Baslic-Signature

receipt.parsed

json

{
  "event": "receipt.parsed",
  "workspace": "fidanet",
  "data": {
    "id": "rcp_a1b2c3",
    "vendor": "Bauhaus AG",
    "country": "DE",
    "reverseCharge": true,
    "viesVerified": true,
    "viesVerifiedAt": "2026-05-17T10:42:18Z",
    "amount": { "net": 1204.12, "vat": 0, "currency": "EUR" },
    "ruleIds": ["vat-fi-rc-eu-b2b"]
  },
  "created": "2026-05-17T10:42:21Z"
}

API anahtarı al, bir öğleden sonrada yayına çık.

API her ücretli plana dahildir. Ücretsiz planda salt okunur erişim var — entegrasyonu test etmeye yetecek kadar.

API anahtarı al Mühendislikle konuş