abFaktura API

Napojte svůj e-shop, CRM nebo účetní program na abFakturu. Přes API vystavíte faktury, zapíšete úhrady, stáhnete PDF a necháte si posílat změny dokladů webhooky.

Co potřebujete

Placený tarif (Plus nebo Neomezeně). V tarifu Zdarma API odpovídá 402 PlanRequired.
API klíč z Nastavení › API klíče v aplikaci, nebo program zaregistrovaný pro OAuth 2.0.

První požadavek

Všechny adresy začínají https://api.abfaktura.cz/api/v1. Klíč pošlete v hlavičce Authorization:

curl https://api.abfaktura.cz/api/v1/invoices?pageSize=5 \
  -H "Authorization: Bearer abf_VAS_KLIC"

Vystavení faktury: stačí odběratel a řádky, číslo, datum, splatnost, dodavatele (vaši firmu), bankovní účet i součty doplní abFaktura sama.

curl https://api.abfaktura.cz/api/v1/invoices \
  -H "Authorization: Bearer abf_VAS_KLIC" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: objednavka-2026-1042" \
  -d '{
    "customer": { "name": "Odběratel s.r.o.", "companyNumber": "12345678", "taxNumber": "CZ12345678",
                  "street": "Hlavní 1", "city": "Praha", "postalCode": "11000", "email": "fakturace@odberatel.cz" },
    "lines": [
      { "name": "Tvorba webu", "quantity": 1, "unitPrice": 25000, "vatRate": 21 },
      { "name": "Hosting na rok", "quantity": 12, "unitPrice": 300, "vatRate": 21 }
    ]
  }'

Odpověď 201 Created obsahuje celý doklad včetně čísla, součtů a rekapitulace DPH. Pak ho můžete poslat e-mailem nebo stáhnout jako PDF.

Základní pravidla

Formát	JSON v UTF-8. Názvy polí jsou camelCase, výčtové hodnoty textové (`invoice`, `creditNote`, `bankTransfer`).
Data	Datum ve tvaru `2026-10-26`, čas podle ISO 8601 v UTC (`2026-10-26T08:30:00Z`). Dny se počítají v českém čase.
Částky	Desetinná čísla v měně dokladu, zaokrouhlená na haléře. Součty vždy počítá server.
Chyby	Formát `application/problem+json` se strojově čitelným kódem, viz Chyby.
Limity	Plus 120 požadavků za minutu a 20 000 za měsíc, Neomezeně 240 a 200 000, viz Limity a opakování.
Verze	Adresa obsahuje verzi `v1`. Nová pole mohou přibývat; nekompatibilní změny přijdou jen v nové verzi.

Kde pokračovat

Přihlášení – API klíče, OAuth 2.0 a oprávnění.
Doklady – Faktury vydané (faktury, zálohy, dobropisy, nabídky), Faktury přijaté, úhrady, PDF.
Webhooky – změny dokladů okamžitě do vašeho programu.
Reference endpointů – všechny adresy a schémata, s možností je hned vyzkoušet.