API dokumentácia

Integruj ZOLO s vlastnými systémami — vystavuj faktúry cez API, importuj kontakty hromadne, čítaj denník. Bearer authentication, JSON payloady, rate-limited (300 čítaní / 60 zápisov za minútu per API kľúč).

Ako získať API kľúč

Prihlás sa do app.zolo.sk
Nastavenia → Integrácie → API kľúče
Klik "Vygenerovať nový kľúč" → pomenuj (napr. "E-shop integration") → skopíruj hodnotu zk_...
Hodnotu už nikdy viac neuvidíš — ulož si ju bezpečne (napr. do Vercel env, 1Password)

Autentifikácia

Každý request potrebuje Bearer token v Authorization hlavičke:

curl https://app.zolo.sk/api/v1/invoices \
  -H "Authorization: Bearer zk_a1b2c3d4e5f6..."

Endpointy

GET/api/v1/invoices?limit=50&type=invoice

Zoznam vystavených dokladov

POST/api/v1/invoices

Vytvorenie novej FA (auto-post JE + stock)

{
  "customer_name": "Alza.sk s.r.o.",
  "customer_ico": "36562939",
  "customer_ic_dph": "SK2022092116",
  "customer_email": "faktury@alza.sk",
  "issue_date": "2026-07-02",
  "due_date": "2026-07-16",
  "items": [
    {
      "description": "Konzultácia",
      "quantity": 5,
      "unit": "hod",
      "unit_price": 60,
      "vat_rate": 23
    }
  ]
}

GET/api/v1/invoices/[id]

Detail FA

POST/api/v1/invoices/[id]/pay

Označiť FA ako zaplatenú

{ "amount": 369.00, "method": "bank" }

POST/api/v1/invoices/[id]/email

Odoslať FA mailom (PDF + portál link)

{ "to": "klient@firma.sk", "subject": "...", "body": "..." }

GET/api/v1/contacts?limit=100

Zoznam kontaktov

POST/api/v1/contacts

Vytvorenie kontaktu

{
  "name": "Alza.sk s.r.o.",
  "type": "customer",
  "ico": "36562939",
  "ic_dph": "SK2022092116",
  "email": "faktury@alza.sk"
}

GET/api/v1/products?limit=100

Cenník

POST/api/v1/products

Nový produkt

{
  "name": "Konzultácia",
  "sku": "KONZ-01",
  "unit": "hod",
  "vat_rate": 23,
  "selling_price": 60
}

GET/api/v1/journal?entry_type=FA&from=2026-01-01&to=2026-06-30

Účtovný denník

POST/api/v1/journal/post

Manuálny účtovný zápis (validuje MD=D)

{
  "entry_type": "ID",
  "entry_date": "2026-07-02",
  "description": "Prevádzková réžia",
  "lines": [
    { "account_code": "512", "side": "MD", "amount": 100 },
    { "account_code": "211", "side": "D", "amount": 100 }
  ]
}

Chybové kódy

HTTP	Význam
400	Chýba required pole, invalid JSON, nezbalancované MD/D
401	Chýba/neplatný Bearer token
404	Resource neexistuje alebo patrí inej firme
429	Rate limit exceeded (Retry-After header)
500	Databázová alebo iná server-side chyba

Webhooks

Nastav webhook v Nastavenia → Webhooks. ZOLO ti pošle POST s HMAC-SHA256 podpisom v hlavičke X-Zolo-Signature pri týchto udalostiach:

invoice.created — nová FA vystavená
invoice.paid — FA označená ako zaplatená
invoice.overdue — FA prekročila splatnosť (denne o 8:00)
contact.created — nový klient

Signature: HMAC-SHA256(secret, JSON.stringify(payload)). Timeout 8s, retry queue každých 15 min pri fail.

Ďalšie otázky?

Email: podpora@zolo.sk · GitHub issues: github.com/JoeBlackino80/zolo_saas