Pro vývojáře (API)Pro

API: Faktury

Vytvoření a čtení faktur, pole požadavku, idempotence.

Fakturu vytvoříš POST /faktury. Odběratele zadáš buď jako odberatelId (existující), nebo jako objekt odberatel (vytvoří se / spáruje podle IČO).

POST /faktury

curl -X POST https://zafakturujto.cz/api/v1/faktury \
  -H "Authorization: Bearer fakt_TVUJ_KLIC" \
  -H "Content-Type: application/json" \
  -d '{
    "odberatel": { "nazev": "Firma s.r.o.", "ico": "12345678" },
    "splatnostDny": 14,
    "polozky": [
      { "popis": "Konzultace", "pocet": 2, "jednotkovaCenaBezDPH": 1000, "sazbaDPH": "S_21" }
    ]
  }'

Vybraná pole požadavku

Pole	Význam
`polozky`	povinné; popis, pocet, jednotkovaCenaBezDPH, sazbaDPH
`typDokladu`	FAKTURA (výchozí) nebo ZALOHOVA
`splatnostDny`	splatnost ve dnech (výchozí 14)
`mena`	výchozí CZK; cizí měna dopočte kurz ČNB
`odeslatEmailem`	true = fakturu rovnou odešle odběrateli
`cisloObjednavky`	idempotenční klíč (viz níže)

Idempotence

Opakované POST se stejným cisloObjednavky nevytvoří duplicitu — vrátí původní fakturu. Vhodné pro e-shop konektory.

Stav měníš přes PATCH /faktury/{cislo}/stav, PDF stáhneš z GET /faktury/{cislo}/pdf.