InvoiceIssuedParams

Tělo požadavku pro vytvoření nebo editaci faktury vydané.

Není to tvar detailu. Odpověď z GET /invoice_issued/{id} nejde poslat zpět na PUT beze změny — vnořené objekty se při zápisu posílají jako ID a dopočtené částky se neposílají vůbec:

Pole	GET (odpověď)	POST / PUT (požadavek)
zákazník	customer — objekt	customer_id — ID
bankovní účet	bank_account — objekt	bank_account — ID
stav dokladu	document_state — objekt	document_state_id — ID
provozovna	business_premises — objekt	business_premises_id — ID
zálohové faktury	proforma_invoice — pole objektů	proforma_invoice — pole ID
price, price_czk, price_inc_vat, price_inc_vat_czk, to_be_paid	dopočítané	neposílají se

Pole jen pro čtení (id, deleted, accounted, eet, share_link a dopočtené částky) server ignoruje.

sequence_codestringmax. délka 45

Číslo dokladu. Když se nevyplní, přidělí ho číselná řada nastavená ve firmě.

např. DOC20190001

variable_symbolstringmax. délka 10

Variabilní symbol.

např. 20190001

datestring<date>povinné

Datum vystavení.

např. 2019-07-12

date_vatstring<date>

Datum zdanitelného plnění. U neplátce DPH se nevyplňuje.

např. 2019-01-10

maturity_datestring<date>povinné

Datum splatnosti.

např. 2019-01-25

currencyCurrencyCodepovinné

Měna dokladu.

např. CZK

payment_typePaymentTypepovinnétransfercashcashondeliveryreciprocitycreditcard

Způsob úhrady dokladu. Popisy hodnot vrací Metody plateb.

Pro transfer a creditcard je na dokladu povinný bank_account, pro cash, cashondelivery a reciprocity může být null.

date_vat_prevstring<date>

Datum předchozí sazby DPH. Vyplňuje se u dokladů, které spadají do období se změnou sazby.

např. 2019-01-01

descriptionstring

Poznámka na dokladu.

např. Popis

rounding_typeRoundingTypenoneroundupdown

Způsob zaokrouhlení. Když se nevyplní, použije se nastavení firmy.

items object[]povinné

Položky dokladu. Doklad musí mít alespoň jednu.

Array [

textstringpovinnémax. délka 255

Popis položky.

např. Položka A

amountnumberpovinné

Počet jednotek.

např. 1

pricenumber<double>povinné

Cena za jednotku.

např. 50

unit_price_inc_vatboolean

Cena za jednotku je uvedená včetně DPH.

unitstringmax. délka 10

Jednotka.

např. ks

vatnumberpovinné

Sazba DPH v procentech. Platné sazby vrací Sazby DPH.

např. 21

vat_totalnumber<double>

DPH celkem za položku.

např. 0

department_idinteger

ID střediska.

contract_idinteger

ID zakázky.

accountentrytype_idinteger | nullmůže být null

ID typu účetní položky. Přepisuje chart_account_id.

vattype_idinteger | nullmůže být null

ID typu DPH. Přepisuje vat_chart_id.

chart_account_idinteger | nullmůže být null

ID účtu účetní osnovy.

vat_chart_idinteger | nullmůže být null

ID účtu DPH.

]

customer_idintegerpovinné

ID zákazníka.

bank_accountinteger | nullmůže být null

ID bankovního účtu, na který se má platit.

Povinný pro payment_type transfer a creditcard; pro cash, cashondelivery a reciprocity může být null.

document_state_idinteger

ID stavu dokladu.

oss_modeboolean

Doklad je v režimu One Stop Shop. Podmínky režimu popisuje průvodce doklady.

order_idstring | nullmůže být null

ID objednávky, ze které faktura vznikla. V odpovědi je to řetězec, bez navázané objednávky null.

např. 13290

remindersstring<date>[]max. položek 4

Data, kdy se má odeslat upomínka. Nejvýš čtyři a všechna musí být v den splatnosti nebo po něm.

např. ["2019-08-12","2019-08-19"]

proforma_invoiceinteger[]

ID zálohových faktur, které se mají z faktury odečíst (od verze API 1.2).

eetboolean

Odeslat doklad do EET. Funguje jen při vytváření dokladu a je potřeba zároveň poslat business_premises_id. Podrobnosti v průvodci doklady.

eet_statusinteger

ID už odeslané EET zprávy. Alternativa k eet pro doklady evidované mimo iÚčto.

business_premises_idinteger

ID provozovny. Povinné, když je eet nastavené na true.

InvoiceIssuedParams

{
  "sequence_code": "DOC20190001",
  "variable_symbol": "20190001",
  "date": "2019-07-12",
  "date_vat": "2019-01-10",
  "maturity_date": "2019-01-25",
  "currency": "CZK",
  "payment_type": "transfer",
  "date_vat_prev": "2019-01-01",
  "description": "Popis",
  "rounding_type": "round",
  "items": [
    {
      "text": "Položka A",
      "amount": 1,
      "price": 50,
      "unit_price_inc_vat": false,
      "unit": "ks",
      "vat": 21,
      "vat_total": 0,
      "department_id": 1,
      "contract_id": 1,
      "accountentrytype_id": 532,
      "vattype_id": 1,
      "chart_account_id": 46,
      "vat_chart_id": 52
    }
  ],
  "customer_id": 785,
  "bank_account": 456,
  "document_state_id": 67,
  "oss_mode": false,
  "order_id": "13290",
  "reminders": [
    "2019-08-12",
    "2019-08-19"
  ],
  "proforma_invoice": [
    123456
  ],
  "eet": false,
  "eet_status": 12,
  "business_premises_id": 897
}