API Dokumentace

REST API v1 pro integraci vašeho systému s FakturačníProgram.cz. Vytvářejte faktury, spravujte kontakty, zaznamenávejte platby a přijímejte webhooky.

Autentizace

Všechny API požadavky vyžadují autentizaci pomocí API klíče v hlavičce Authorization.

curl -H "Authorization: Bearer fpk_live_abc123..." \
  https://app.fakturacniprogram.cz/api/v1/invoices

API klíče vytvoříte v Nastavení → API. Klíče začínají prefixem fpk_live_.

Base URL

https://app.fakturacniprogram.cz/api/v1/

Formát odpovědí

Všechny odpovědi jsou ve formátu JSON. Úspěšné odpovědi vrací data v poli data, seznamy obsahují stránkování v meta.

{
  "data": [...],
  "meta": {
    "page": 1,
    "perPage": 20,
    "total": 42
  }
}

Chybové odpovědi vrací error objekt:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Neplatná data: ..."
  }
}

Rate Limiting

API je omezeno na 1 000 požadavků za minutu na jeden API klíč. Při překročení limitu vrací server 429 Too Many Requests.

Endpointy

Faktury

Metoda	Endpoint	Popis	Parametry
GET	/api/v1/invoices	Seznam faktur s filtrováním a stránkováním	status, contact_id, from, to, page, per_page
POST	/api/v1/invoices	Vytvoření nové faktury	type, contactId, issueDate, dueDate, items[], currency
GET	/api/v1/invoices/:id	Detail faktury včetně položek a plateb	id (UUID)

Kontakty

Metoda	Endpoint	Popis	Parametry
GET	/api/v1/contacts	Seznam kontaktů (odběratelů/dodavatelů)	search, page, per_page
POST	/api/v1/contacts	Vytvoření nového kontaktu	name, ico, dic, address, city, zip, email, phone
GET	/api/v1/contacts/:id	Detail kontaktu	id (UUID)

Platby

Metoda	Endpoint	Popis	Parametry
GET	/api/v1/payments	Seznam plateb	invoice_id, page, per_page
POST	/api/v1/payments	Zaznamenání platby k faktuře	invoiceId, amount, date, method, note

Náklady

Metoda	Endpoint	Popis	Parametry
GET	/api/v1/expenses	Seznam nákladů	category, month, page, per_page

Číselné řady

Metoda	Endpoint	Popis	Parametry
GET	/api/v1/series	Seznam číselných řad	—

Firma

Metoda	Endpoint	Popis	Parametry
GET	/api/v1/company	Firemní profil	—

Webhooky

Metoda	Endpoint	Popis	Parametry
GET	/api/v1/webhooks	Seznam registrovaných webhooků	—
POST	/api/v1/webhooks	Registrace nového webhooku	url, events[]

Webhooky

Registrujte webhook URL a dostávejte notifikace v reálném čase. Každý webhook je podepsán pomocí HMAC-SHA256 v hlavičce X-FP-Signature.

Událost	Popis
invoice.created	Nová faktura vytvořena
invoice.sent	Faktura odeslána odběrateli
invoice.paid	Faktura uhrazena
invoice.overdue	Faktura po splatnosti
payment.received	Platba přijata
contact.created	Nový kontakt vytvořen

Příklad webhook payload

POST /your-webhook-url
Content-Type: application/json
X-FP-Signature: sha256=abc123...

{
  "event": "invoice.paid",
  "data": {
    "id": "uuid-faktury",
    "invoiceNumber": "FV20260001",
    "amount": 12500.00,
    "paidAt": "2026-05-02T10:30:00Z"
  },
  "timestamp": "2026-05-02T10:30:01Z"
}

Začněte s API

Vytvořte si účet zdarma a vygenerujte API klíč v Nastavení.

Vytvořit účet zdarma