accounting_daterequired | string · date | |
|---|
linesrequired | object[] | At most 1000: more is refused as 422 document.too_many_lines. |
|---|
lines[].line_norequired | integer | Position on the invoice. It becomes the movement's ordinal, so a line that creates none leaves a gap. |
|---|
lines[].pnrequired | string | |
|---|
lines[].qtyrequired | string | Base units. A string, not a number. |
|---|
lines[].unit_pricerequired | string | Per base unit, in the document's currency. |
|---|
lines[].vat_amountrequired | string | Required even while the company is not VAT registered. Zero is a value; a supplier not VAT registered charged none. |
|---|
lines[].invoiced_qty | string | What the paper said, if it was in packs. |
|---|
lines[].line_total | string | What the invoice says the line comes to before VAT, in the document's currency, when it states a total rather than a unit price. It is what the line is costed at — quantity × a six-place unit price is a different amount once the quantity is large — and it must agree with qty × unit_price to the sixth place of the price. |
|---|
lines[].location | string | The bin it goes to. A line expensed on purchase (stocked: false) may leave it out: it goes to no shelf. |
|---|
lines[].pack_size | string | |
|---|
lines[].serial | string | The piece's number, for a part tracked by serial number. Such a line is one piece. |
|---|
lines[].stocked | boolean | Default true. False expenses it on purchase — it still takes its share of the charges, and the posting proposal sends what it came to straight to consumption. Only in a company whose settings allow it (expensed_on_purchase), refused otherwise as receipt.expensed_off — but a correction keeps a line the receipt being corrected already expensed, for the same part. |
|---|
lines[].vat_non_deductible | boolean | The line's tax cannot be deducted whoever the company is — reprezentace, for instance: it is part of what the line cost for a VAT payer too, and never in the line's lot, so no claim at registration takes it. Its share of the charges' tax follows it. |
|---|
lines[].weight_g | string | The line's total shipping weight, as a packing list gives it. |
|---|
accounting_no | string | The number the accounting software knows this invoice by. A reference only. |
|---|
charges | object[] | At most 100: more is refused as 422 document.too_many_charges. |
|---|
charges[].amountrequired | string | Never below zero, but for a rounding: the difference between the invoice's total and its lines, which corrects the price paid either way. |
|---|
charges[].kindrequired | string | A vedlejší pořizovací náklad of vyhl. 500/2002 § 49 odst. 1, or a rounding of the invoice. Interest, penalties and anything else that is not part of acquisition cost is not a charge (since 24 October 2026).freightdutyimport_vathandlinginsurancepackagingcommissionrounding |
|---|
charges[].basis | string | Per charge, not per document: freight by weight and duty by value on one receipt is normal.valueweightquantitydirect |
|---|
charges[].currency | string | |
|---|
charges[].direct_line | integer | |
|---|
charges[].duzp | string | The charge's own tax point (DUZP), YYYY-MM-DD — a carrier's or a customs document dated apart from the goods' invoice. Whether its tax and an import VAT are reclaimable is read for it. Empty is the receipt's. |
|---|
charges[].fx | object | The rate as the document prints it. |
|---|
charges[].fx.quoterequired | string | What they are worth in the currency on the right. |
|---|
charges[].fx.unitsrequired | string | How many of the currency on the left: 1, or 100 for a currency quoted per hundred. |
|---|
charges[].fx.inverse | boolean | The company's own currency is on the left — 1 EUR = 25.03 CZK in a euro company reading a crown invoice. |
|---|
charges[].fx_rate | string | The rate as a bare multiplier. fx wins when both are sent. |
|---|
charges[].provisional | boolean | An estimate standing in for an invoice that has not arrived. |
|---|
charges[].vat_amount | string | The tax printed on this charge's own line. Spread with the charge; part of the value only while the company is not VAT registered. Never below zero, but for a rounding. |
|---|
charges[].vat_fx | object | The rate the tax is converted at, when it is not fx. |
|---|
charges[].vat_fx.quoterequired | string | What they are worth in the currency on the right. |
|---|
charges[].vat_fx.unitsrequired | string | How many of the currency on the left: 1, or 100 for a currency quoted per hundred. |
|---|
charges[].vat_fx.inverse | boolean | The company's own currency is on the left — 1 EUR = 25.03 CZK in a euro company reading a crown invoice. |
|---|
closes_order | boolean | Mark the order finished with, in the same request. |
|---|
confirm | boolean | Go ahead even though this moves figures already reported, or is dated ahead. |
|---|
costed | object | What each line came to — its own price in the company's currency, its share of the charges, and the two together — as preview-receipt answers it. Absent when the ledger holds other figures for the receipt than its costing gives today. |
|---|
costed.chargesrequired | string | What the lines took of the charges, together. |
|---|
costed.linesrequired | object[] | |
|---|
costed.lines[].baserequired | string | The invoice line in CZK, plus the tax when it cannot be reclaimed. |
|---|
costed.lines[].chargesrequired | string | Its share of every landed cost on the receipt. |
|---|
costed.lines[].line_norequired | integer | |
|---|
costed.lines[].stockedrequired | boolean | |
|---|
costed.lines[].totalrequired | string | Acquisition cost of the line. |
|---|
costed.lines[].unitrequired | string | That, per base unit. What the part's average will be moved toward. |
|---|
costed.lines[].vatrequired | string | The tax recorded against the line in the company's currency — its own and its share of import VAT — whether or not it is in total. What the line's lot carries for § 79 ZDPH. |
|---|
costed.reclaimable_import_vatrequired | string | Import VAT a company that is VAT registered reclaims, left out of every line's value — a receivable, not stock. Each charge read for its own DUZP. |
|---|
costed.totalrequired | string | Acquisition cost of every line together. |
|---|
costed.vat_payerrequired | boolean | Whether the tax on this receipt's DUZP is reclaimable. For a company not VAT registered it is part of what the stock cost. A charge with a DUZP of its own is read for that one. |
|---|
currency | string | ISO 4217. Empty is the company's own. |
|---|
duzp | string | The tax point (DUZP), YYYY-MM-DD. Empty is the invoice's date, and with none the accounting date. Whether the company is VAT registered is read for this date. |
|---|
fx | object | The rate as the document prints it. |
|---|
fx.quoterequired | string | What they are worth in the currency on the right. |
|---|
fx.unitsrequired | string | How many of the currency on the left: 1, or 100 for a currency quoted per hundred. |
|---|
fx.inverse | boolean | The company's own currency is on the left — 1 EUR = 25.03 CZK in a euro company reading a crown invoice. |
|---|
fx_note | string | |
|---|
fx_rate | string | From the document, never fetched — so this rate and the accounting's agree by construction. A bare multiplier: company currency per one unit of the document's. fx wins when both are sent. |
|---|
invoice_date | string | YYYY-MM-DD. The date the invoice was issued — and its tax point when it states no DUZP. |
|---|
ksef_no | string | The number KSeF gave the purchase invoice, as TNumerKSeF writes it. A reference. |
|---|
occurred_at | string · date-time | |
|---|
position | string | Where this goes among the documents already on a back-dated day.beforeafter |
|---|
price_known | boolean | With without_invoice: the prices are known from a contract or the vendor's delivery note rather than estimated. Ignored without it. |
|---|
purchase_order | string | Order number. |
|---|
reading | string | The reading this was made from. Its document becomes the receipt's attachment. |
|---|
reason | string | From the chart of accounts for receipts; empty for an ordinary purchase. |
|---|
reference | string | The receipt's note. |
|---|
supplier_doc_no | string | |
|---|
vat_fx | object | The rate the lines' tax is converted at, when it is not fx. |
|---|
vat_fx.quoterequired | string | What they are worth in the currency on the right. |
|---|
vat_fx.unitsrequired | string | How many of the currency on the left: 1, or 100 for a currency quoted per hundred. |
|---|
vat_fx.inverse | boolean | The company's own currency is on the left — 1 EUR = 25.03 CZK in a euro company reading a crown invoice. |
|---|
vendor | string | Vendor code. |
|---|
vendor_name | string | The vendor's name. Read-only; the code is what identifies them. |
|---|
vendor_removed | boolean | |
|---|
without_invoice | boolean | The goods arrived before the invoice and are priced by estimate. Cleared by the correction that enters the invoice; read back false as well once a price adjustment in force says it is the invoice. |
|---|