> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoro.sk/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://docs.fintoro.sk/authentication.md) 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](https://docs.fintoro.sk/sandbox-testing.md).

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](https://docs.fintoro.sk/api-reference.md).

## 2. Vytvorte faktúru

```bash theme={null}
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](https://docs.fintoro.sk/reference-tables.md).

Čí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](https://docs.fintoro.sk/errors-and-idempotency.md).

Odpoveď `201 Created` obsahuje vytvorenú faktúru priamo, bez obalu `data`. Skrátený ilustračný príklad:

```json theme={null}
{
  "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:

```bash theme={null}
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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.