Faktero API pre vývojárov

Faktero API je REST rozhranie, ktoré umožňuje vašej aplikácii vytvárať faktúry, spravovať odberateľov a počúvať na udalosti cez webhooky.

Všetky endpointy bežia pod https://www.faktero.sk/api/v1 a používajú JSON.

1. Otvorte Nastavenia → API kľúče.
2. Kliknite na Vytvoriť nový kľúč a pomenujte ho (napr. „Eshop produkcia").
3. Kľúč sa zobrazí iba raz — uložte ho na bezpečnom mieste.

Kľúč posielajte v hlavičke Authorization: Bearer fkt_….

Pri vytváraní kľúča vyberáte režim:

• Test (sandbox) — faktúry sa nezarátavajú do limitu a nemajú právne účinky.
• Live (produkcia) — reálne faktúry, ktoré sa rátajú do mesačného limitu plánu.

Test kľúče majú prefix fkt_test_, live kľúče fkt_live_.

Príklad cURL volania:

curl -X POST https://www.faktero.sk/api/v1/invoices \
  -H "Authorization: Bearer fkt_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": { "name": "ACME s.r.o.", "ico": "12345678" },
    "items": [
      { "name": "Konzultácia", "quantity": 2, "unit_price": 50, "vat_rate": 23 }
    ],
    "due_date": "2026-07-01"
  }'

Odpoveď obsahuje id, invoice_number a URL na PDF.

Webhooky pošlú HTTP POST na vašu URL, keď nastane udalosť:

• invoice.created
• invoice.sent
• invoice.paid
• invoice.cancelled

Každý webhook je podpísaný hlavičkou X-Faktero-Signature (HMAC SHA-256 z tela správy a tajného kľúča webhooku). Vždy podpis overte pred spracovaním.

Úplný zoznam endpointov, parametrov a chybových kódov nájdete v API dokumentácii.

Volania si viete vyskúšať bez písania kódu v API playgrounde — vyberiete endpoint, doplníte parametre a hneď vidíte odpoveď servera aj hotový príkaz pre curl. Playground volá ostré dáta vašej firmy, takže zápisové volania naozaj vytvárajú doklady.