Přejít na obsah
FakturanetAPI v1.0.0
OpenAPI API klíče

Objekty

InvoiceCreate

doc_typestring

Typ dokladu. Doklady s DPH vyžadují, aby firma byla plátce DPH. Hodnoty: invoice_vat – faktura – daňový doklad; invoice_non_vat – faktura neplátce DPH; credit_note – opravný daňový doklad (dobropis); reverse_charge – faktura s přenesenou daňovou povinností; proforma – zálohová faktura; advance – daňový doklad k přijaté platbě; quote_vat – nabídka s DPH; quote_non_vat – nabídka bez DPH.

  • Výchozí: invoice_non_vat
issue_datedate

Datum vystavení. Výchozí dnešní den.

supply_datedate

Datum uskutečnění zdanitelného plnění (DUZP). Výchozí datum vystavení.

due_datedate

Datum splatnosti. Výchozí 14 dní od vystavení.

contact_idinteger

ID kontaktu odběratele. Pokud chybí customer, odběratel se převezme z kontaktu.

customerParty

Odběratel. Bez contact_id se existující kontakt najde podle IČO, bez IČO podle názvu; jinak se založí nový.

Vnořená pole 10
namestring

Název firmy nebo jméno osoby.

  • Max. znaků: 190
company_nostring | null

IČO. Mezery se odstraní.

  • Max. znaků: 20
vat_nostring | null

DIČ.

  • Max. znaků: 30
streetstring | null

Ulice a číslo.

  • Max. znaků: 190
citystring | null

Obec.

  • Max. znaků: 120
zipstring | null

PSČ.

  • Max. znaků: 20
countrystring | null

Kód země ISO 3166-1 alpha-2. Výchozí CZ.

  • Výchozí: CZ
  • Vzorec: ^[A-Za-z]{2}$
emailemail | null

E-mail; použije se jako výchozí příjemce faktury.

  • Max. znaků: 190
phonestring | null

Telefon.

  • Max. znaků: 40
webstring | null

Web.

  • Max. znaků: 190
bank_account_idinteger | null

ID bankovního účtu firmy, který se vytiskne na doklad. Když ho při vytvoření dokladu placeného převodem neuvedete, použije se výchozí účet firmy jako v aplikaci; null doklad vytvoří bez účtu.

payment_methodstring

Způsob úhrady. Hodnoty: bank_transfer – bankovní převod; cash – hotovost; cash_on_delivery – dobírka; card – platební karta; paypal – PayPal; mutual_offset – vzájemný zápočet.

  • Výchozí: bank_transfer
currencystring

Měna ISO 4217.

  • Výchozí: CZK
  • Vzorec: ^[A-Z]{3}$
exchange_ratedecimal

Kurz k CZK. U CZK musí být 1, u jiné měny kurz ČNB ke dni zdanitelného plnění (1 se odmítne).

  • Vzorec: ^-?\d{1,12}(\.\d{1,8})?$
languagestring

Jazyk dokladu. Hodnoty: cs – cs; sk – sk; en – en; de – de; de-AT – de-AT; pl – pl; fr – fr; nl – nl; es – es; uk – uk; sr – sr.

  • Výchozí: cs
vat_treatmentstring

Režim DPH. Výchozí podle toho, zda je firma plátce DPH. Hodnoty: domestic – tuzemské plnění; non_payer – neplátce DPH; eu_goods – dodání zboží do EU; eu_services – služby do EU; domestic_reverse_charge – tuzemské přenesení daňové povinnosti; export – vývoz mimo EU; oss – prodej spotřebiteli v jiném státě EU v režimu OSS (sazba státu spotřeby, vyžaduje registraci k OSS).

roundingstring

Zaokrouhlení celkové částky. Hodnoty: none – bez zaokrouhlení; 0.10 – na desetníky; 0.50 – na padesátníky; 1.00 – na celé koruny.

  • Výchozí: none
templatestring

Vzhled PDF. Hodnoty: modern – moderní; simple – jednoduchý; custom – vlastní.

  • Výchozí: modern
colorstring

Barva dokladu #RRGGBB. Výchozí barva firmy.

  • Vzorec: ^#[0-9A-Fa-f]{6}$
show_qrboolean

Tisknout QR platbu.

  • Výchozí: true
prices_include_vatboolean

Jednotkové ceny jsou včetně DPH.

  • Výchozí: false
discount_pctdecimal

Sleva na celý doklad v procentech (0–100, nejvýše 2 desetinná místa).

  • Vzorec: ^-?\d{1,12}(\.\d{1,8})?$
issued_bystring

Kdo doklad vystavil.

  • Max. znaků: 120
notestring

Poznámka na dokladu.

  • Max. znaků: 10000
reg_numberstring

Evidenční číslo.

  • Max. znaků: 40
order_numberstring

Číslo objednávky odběratele.

  • Max. znaků: 60
variable_symbolstring

Variabilní symbol, nejvýše 10 číslic. Při vystavení se jinak odvodí z čísla dokladu.

  • Vzorec: ^\d{0,10}$
constant_symbolstring

Konstantní symbol.

  • Max. znaků: 10
specific_symbolstring

Specifický symbol.

  • Max. znaků: 20

Položky dokladu (1–500).

  • Min. položek: 1
  • Max. položek: 500
Vnořená pole 6
descriptionstringpovinné v objektu

Popis položky.

  • Max. znaků: 500
quantitydecimal

Množství, nejvýše 4 desetinná místa. Nesmí být 0; záporné jen u opravného dokladu. Výchozí 1.

  • Vzorec: ^-?\d{1,12}(\.\d{1,8})?$
unitstring

Jednotka, například ks, hod. Výchozí ks.

  • Max. znaků: 20
unit_pricedecimalpovinné v objektu

Jednotková cena, nejvýše 4 desetinná místa. Podle prices_include_vat bez DPH, nebo s DPH.

  • Vzorec: ^-?\d{1,12}(\.\d{1,8})?$
vat_ratedecimal

Sazba DPH v procentech (0–100). U dokladů neplátce a přenesené daňové povinnosti se použije 0.

  • Vzorec: ^-?\d{1,12}(\.\d{1,8})?$
discount_pctdecimal

Sleva na položku v procentech (0–100, nejvýše 2 desetinná místa). Uplatní se před slevou na celý doklad. Výchozí 0.

  • Vzorec: ^-?\d{1,12}(\.\d{1,8})?$
numberstring

Vlastní číslo dokladu při vystavení. Bez něj se použije číselná řada.

  • Vzorec: ^[\p{L}\p{N}/._-]{1,60}$
issueboolean

Doklad rovnou vystavit (přidělí číslo). Jinak vznikne koncept.

  • Výchozí: false
related_invoice_idinteger

U opravného dokladu ID opravovaného dokladu.

correction_reasonstring | null

Důvod opravy u opravného daňového dokladu (credit_note). Při vystavení je povinný.

  • Max. znaků: 255
reverse_charge_codestring | null

Předmět plnění při tuzemském přenesení daňové povinnosti (vat_treatment = domestic_reverse_charge), kód podle § 92a ZDPH pro kontrolní hlášení A.1, např. 4 – stavební a montážní práce.

  • Hodnoty: 1 1a 3 3a 4 4a 5 6 7 11 12 13 14 15 16 17 18 19 20 21 null

Hledat v dokumentaci

Hledejte endpoint, pole, objekt, typ chyby nebo téma příručky.