Vystavenie faktúry

Vytvorte faktúru pre existujúceho klienta s jednou ručne zadanou položkou a stiahnite ju ako PDF. Príklady používajú ilustračné údaje a ID.

1. Pripravte klienta a bankový účet

Potrebujete API token s oprávnením write a firmu s nastaveným primárnym číselným radom pre faktúry. Na testovanie môžete použiť sandbox. Cez GET /clients vyberte klienta a cez GET /bank-accounts bankový účet. Oba záznamy musia patriť firme priradenej k tokenu. V príklade nahraďte clientId: 101 a bankAccountId: 201 ich skutočnými ID. Ak klient ešte neexistuje, vytvorte ho cez POST /clients. Parametre týchto endpointov nájdete v API referencii.

2. Vytvorte faktúru

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/invoices \
  --header 'Authorization: Bearer <company-token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: invoice-example-001' \
  --data '{
    "clientId": 101,
    "bankAccountId": 201,
    "currencyId": 1,
    "currencyRate": 1,
    "dueDateDays": 14,
    "items": [
      {
        "name": "Konzultácia",
        "quantity": 1,
        "unitId": 1,
        "unitPrice": 100,
        "vatRate": 23
      }
    ]
  }'

unitPrice je jednotková cena bez DPH, vatRate sadzba DPH v percentách. Hodnoty currencyId: 1 a unitId: 1 označujú euro a kus; ďalšie hodnoty nájdete v číselníkoch. Číslo faktúry sa vygeneruje z primárneho číselného radu. Dátum vystavenia aj dodania bude dnešný a splatnosť 14 dní od vystavenia. Pri opakovaní tej istej požiadavky zachovajte Idempotency-Key aj telo. Pre ďalšiu faktúru použite nový kľúč; podrobnosti sú v pravidlách idempotencie. Odpoveď 201 Created obsahuje vytvorenú faktúru priamo, bez obalu data. Skrátený ilustračný príklad:

{
  "id": 301,
  "number": "20260001",
  "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/invoices/301/pdf"
}

Uložte si vrátené id k záznamu vo svojom systéme. Aktuálny detail získate cez GET /invoices/{id}.

3. Stiahnite PDF

V nasledujúcej požiadavke nahraďte 301 ID z odpovede:

curl --fail \
  --url https://app.fintoro.sk/api/public/v1/invoices/301/pdf \
  --header 'Authorization: Bearer <company-token>' \
  --header 'Accept: application/pdf' \
  --output faktura.pdf

PDF sa uloží do súboru faktura.pdf v aktuálnom priečinku. Rovnaký endpoint je dostupný aj cez pdfDownloadUrl z odpovede; potrebuje rovnaký API token.

Začíname

Práca s API

Webhooky

Príklady

1. Pripravte klienta a bankový účet

2. Vytvorte faktúru

3. Stiahnite PDF