Přeskočit na hlavní obsah

PaymentReceivedDetail

Detail platby přijaté.

Protistrana je vždy právě jedna — vyplněný je buď customer, nebo supplier. Stejně tak je vyplněný buď bank_account, nebo cash_register podle způsobu úhrady.

_links object

HAL odkaz na samotný zdroj.

self objectpovinné
hrefstringpovinné

Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

idinteger

ID platby.

price_inc_vatnumber<double>povinné

Částka platby celkem včetně DPH v měně platby.

např. 50
deletedboolean

Platba je smazaná.

currencyCurrencyCodepovinné

Měna platby. Přebírá se z bankovního účtu nebo pokladny, zapsat ji nelze.

např. CZK
modifiedstring<date-time>

Datum a čas poslední změny záznamu. Jediné pole, podle kterého jde tenhle seznam řadit (sort=-modified), takže se používá jako vodoznak při inkrementálním stahování.

např. 2026-08-07T19:03:56+02:00
sequence_codestringmax. délka 45

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

např. PP20190001
external_codestringmax. délka 45

Vlastní číslo dokladu z cizího systému.

např. FV3425435
variable_symbolstringmax. délka 10

Variabilní symbol.

např. 20190001
datestring<date>povinné

Datum vystavení. Musí spadat do otevřeného účetního období.

např. 2019-07-12
date_vatstring<date>

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

např. 2019-07-12
proforma_invoice_idinteger

ID zálohové faktury vydané, kterou platba hradí.

oss_modeboolean

Platba je v režimu One Stop Shop. Režim jde zapnout jen u platby navázané na zálohovou fakturu, ostatní pravidla jsou shodná s režimem OSS u faktur. Zapisovatelné (od verze API 1.2), dříve jen pro čtení.

eetbooleanpovinné

Platba byla odeslána do EET. Zapsat true lze jen při vytváření platby s payment_type cash a s pokladnou povolenou pro EET, podrobnosti v průvodci doklady (od verze API 1.1).

pricenumber<double>povinné

Částka bez DPH v měně platby.

např. 50
price_czknumber<double>povinné

Částka bez DPH v CZK.

např. 50
price_inc_vat_czknumber<double>povinné

Částka celkem včetně DPH v CZK.

např. 50
items object[]povinné

Položky platby.

  • Array [
  • idintegerpovinné

    ID položky.

    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
    vatnumber

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

    např. 21
    vat_totalnumber<double>

    DPH celkem za položku.

    např. 0
    department_idinteger
    contract_idinteger
    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
    vat_chart_idinteger | nullmůže být null
  • ]
  • payment_typestringpovinnétransfercash

    Způsob úhrady. Na platbách je množina užší než na dokladech — aplikace pouští jen bankovní převod a hotovost. Popisy hodnot vrací Metody plateb.

    Hodnota musí odpovídat protistraně platby: transfer se páruje s bank_account, cash s cash_register_id.

    date_vat_prevstring<date>

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

    např. 2019-05-05
    descriptionstring

    Poznámka na platbě.

    např. Popis
    rounding_typeRoundingTypenoneroundupdown

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

    reference_markstringmax. délka 45

    Párovací znak platby.

    např. RF
    full_paidboolean

    Platba hradí napárovaný doklad v plné výši.

    liquidation_amount(number | null)<double>může být null

    Částka, kterou platba likviduje z napárovaného dokladu, v měně dokladu. Povinná, když je doklad vystavený v jiné měně než CZK nebo když se měna účtu či pokladny liší od měny dokladu (od verze API 1.2).

    např. 50
    customer object

    Detail zákazníka.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idintegerpovinné

    ID zákazníka.

    namestringpovinnémax. délka 100

    Jméno nebo název zákazníka.

    např. Jan Novák
    comidstringmax. délka 20

    IČO.

    např. 12345679
    emailstringmax. délka 100

    E-mail.

    např. novak.jan@example.org
    phonestringmax. délka 20

    Telefon.

    např. +420123123123
    cellphonestringmax. délka 20

    Mobil.

    např. +420123123123
    customer_group_idinteger
    external_codestringmax. délka 50

    Vlastní identifikátor zákazníka v cizím systému.

    např. CC123
    vat_payerbooleanpovinné

    Zákazník je plátce DPH.

    vatidstringmax. délka 20

    DIČ. Vyplňuje se u plátce DPH.

    např. CZ12345679
    name_displaystringmax. délka 100

    Jméno zobrazované na dokladech, když se liší od názvu.

    např. Jan Novák ml.
    wwwstringmax. délka 40

    Webová adresa.

    např. https://www.iucto.cz
    usual_maturityintegerpovinné

    Obvyklá splatnost ve dnech, předvyplní se na dokladu.

    např. 30
    preferred_payment_methodPreferredPaymentMethodpovinnétransfercashproformacheckcreditcardcashondelivery

    Preferovaný způsob platby kontaktu. Popisy hodnot vrací Preferované metody platby.

    invoice_languageInvoiceLangpovinnécsenskdepl

    Jazyk, ve kterém se tiskne faktura.

    address objectpovinné

    Poštovní adresa kontaktu.

    streetstring

    Ulice a číslo popisné.

    např. Stodolní 123
    citystring

    Město.

    např. Ostrava
    postalcodestring

    Poštovní směrovací číslo.

    např. 385 02
    countryCountryCodepovinné

    Země.

    např. CZ
    notestringmax. délka 1000

    Interní poznámka.

    např. Věrný zákazník
    account_number1string | nullmůže být null

    Číslo bankovního účtu zákazníka.

    např. 1234567890/0100
    account_number2string | nullmůže být null

    Druhé číslo bankovního účtu zákazníka.

    např. 1234-1234567890/4400
    account_number3string | nullmůže být null

    Třetí číslo bankovního účtu zákazníka.

    např. null
    account_number4string | nullmůže být null

    Čtvrté číslo bankovního účtu zákazníka.

    např. null
    default_department_idinteger

    ID střediska předvyplněného na dokladu.

    default_contract_idinteger

    ID zakázky předvyplněné na dokladu.

    supplier object

    Detail dodavatele.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idintegerpovinné

    ID dodavatele.

    namestringpovinnémax. délka 100

    Jméno nebo název dodavatele.

    např. Jan Novák
    comidstringmax. délka 20

    IČO.

    např. 12345679
    emailstringmax. délka 100

    E-mail.

    např. novak.jan@example.org
    phonestringmax. délka 20

    Telefon.

    např. +420123123123
    cellphonestringmax. délka 20

    Mobil.

    např. +420123123123
    supplier_group_idinteger
    external_codestringmax. délka 50

    Vlastní identifikátor dodavatele v cizím systému.

    např. CC123
    vat_payerbooleanpovinné

    Dodavatel je plátce DPH.

    vatidstringmax. délka 20

    DIČ. Vyplňuje se u plátce DPH.

    např. CZ12345679
    name_displaystringmax. délka 100

    Jméno zobrazované na dokladech, když se liší od názvu.

    např. Jan Novák ml.
    wwwstringmax. délka 40

    Webová adresa.

    např. https://www.iucto.cz
    address objectpovinné

    Poštovní adresa kontaktu.

    streetstring

    Ulice a číslo popisné.

    např. Stodolní 123
    citystring

    Město.

    např. Ostrava
    postalcodestring

    Poštovní směrovací číslo.

    např. 385 02
    countryCountryCodepovinné

    Země.

    např. CZ
    notestringmax. délka 1000

    Interní poznámka.

    např. Věrný dodavatel
    account_number1string | nullmůže být null

    Číslo bankovního účtu dodavatele.

    např. 1234567890/0100
    account_number2string | nullmůže být null

    Druhé číslo bankovního účtu dodavatele.

    např. 1234-1234567890/4400
    account_number3string | nullmůže být null

    Třetí číslo bankovního účtu dodavatele.

    např. null
    account_number4string | nullmůže být null

    Čtvrté číslo bankovního účtu dodavatele.

    např. null
    default_department_idinteger

    ID střediska předvyplněného na dokladu.

    default_contract_idinteger

    ID zakázky předvyplněné na dokladu.

    invoice object

    Detail faktury vydané.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    customer objectpovinné

    Detail zákazníka.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idintegerpovinné

    ID zákazníka.

    namestringpovinnémax. délka 100

    Jméno nebo název zákazníka.

    např. Jan Novák
    comidstringmax. délka 20

    IČO.

    např. 12345679
    emailstringmax. délka 100

    E-mail.

    např. novak.jan@example.org
    phonestringmax. délka 20

    Telefon.

    např. +420123123123
    cellphonestringmax. délka 20

    Mobil.

    např. +420123123123
    customer_group_idinteger
    external_codestringmax. délka 50

    Vlastní identifikátor zákazníka v cizím systému.

    např. CC123
    vat_payerbooleanpovinné

    Zákazník je plátce DPH.

    vatidstringmax. délka 20

    DIČ. Vyplňuje se u plátce DPH.

    např. CZ12345679
    name_displaystringmax. délka 100

    Jméno zobrazované na dokladech, když se liší od názvu.

    např. Jan Novák ml.
    wwwstringmax. délka 40

    Webová adresa.

    např. https://www.iucto.cz
    usual_maturityintegerpovinné

    Obvyklá splatnost ve dnech, předvyplní se na dokladu.

    např. 30
    preferred_payment_methodPreferredPaymentMethodpovinnétransfercashproformacheckcreditcardcashondelivery

    Preferovaný způsob platby kontaktu. Popisy hodnot vrací Preferované metody platby.

    invoice_languageInvoiceLangpovinnécsenskdepl

    Jazyk, ve kterém se tiskne faktura.

    address objectpovinné

    Poštovní adresa kontaktu.

    streetstring

    Ulice a číslo popisné.

    např. Stodolní 123
    citystring

    Město.

    např. Ostrava
    postalcodestring

    Poštovní směrovací číslo.

    např. 385 02
    countryCountryCodepovinné

    Země.

    např. CZ
    notestringmax. délka 1000

    Interní poznámka.

    např. Věrný zákazník
    account_number1string | nullmůže být null

    Číslo bankovního účtu zákazníka.

    např. 1234567890/0100
    account_number2string | nullmůže být null

    Druhé číslo bankovního účtu zákazníka.

    např. 1234-1234567890/4400
    account_number3string | nullmůže být null

    Třetí číslo bankovního účtu zákazníka.

    např. null
    account_number4string | nullmůže být null

    Čtvrté číslo bankovního účtu zákazníka.

    např. null
    default_department_idinteger

    ID střediska předvyplněného na dokladu.

    default_contract_idinteger

    ID zakázky předvyplněné na dokladu.

    bank_account object

    Detail bankovního účtu.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idintegerpovinné

    ID účtu.

    numberstringpovinné

    Celé číslo účtu ve tvaru předčíslí-číslo/kód banky.

    např. 19-123457/0100
    balancenumber<double>

    Aktuální zůstatek účtu v měně účtu. (API 1.3+)

    např. 0
    balance_czknumber<double>

    Aktuální zůstatek účtu v CZK. (API 1.3+)

    např. 0
    realtime_payment_fetchboolean

    Účet podporuje načítání plateb v reálném čase. (API 1.3+)

    namestringmax. délka 45

    Název účtu.

    např. Komerční banka
    currencystringpovinnémax. délka 3

    Měna účtu, kód podle ISO 4217. Dostupné hodnoty vrací Měny.

    např. CZK
    isdefaultboolean

    Účet je nastavený jako výchozí.

    account_prefixstring

    Předčíslí účtu. Řetězec, aby se zachovala vedoucí nula.

    např. 19
    account_numberstringpovinné

    Číslo účtu bez předčíslí.

    např. 123457
    bank_codestringpovinné

    Kód banky.

    např. 0100
    swiftstringmax. délka 11

    SWIFT / BIC.

    např. KOMBCZPPXXX
    ibanstringmax. délka 34

    IBAN.

    např. CZ5601000000190000123457
    initial_statenumber<double>

    Počáteční stav účtu.

    např. 0
    chart_account_idinteger

    ID účtu účetní osnovy. Výchozí je 221.

    visibleboolean

    Účet se nabízí v seznamech.

    document_state object

    Stav dokladu.

    idintegerpovinné

    ID stavu.

    namestringpovinné

    Název stavu.

    např. Odesláno
    descriptionstringpovinné

    Popis stavu.

    např. Doklad byl odeslán zákazníkovi
    visibilitybooleanpovinné

    Stav se nabízí u dokladů.

    business_premises object

    Provozovna firmy. Seznam i detail vracejí stejný tvar.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idintegerpovinné

    ID provozovny.

    namestringpovinné

    Název provozovny.

    např. Restaurace u koníčka
    isdefaultboolean

    Provozovna je nastavená jako výchozí.

    eet_status object

    Zkrácený stav EET zprávy, jak se objevuje v detailu dokladu.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idinteger

    ID EET záznamu.

    statusstring

    Stav odeslání zprávy.

    např. ok
    fikstring

    Fiskální identifikační kód přidělený finanční správou.

    např. f26e5172-077e-4aba-9f5c-d0181362a16b-ff
    bkpstring

    Bezpečnostní kód poplatníka.

    např. a983e13d-c6c7ce4a-03198fec-8cc1292c-32134ae9
    pkpstring

    Podpisový kód poplatníka.

    např. awOqOqCmawUNvyDpjFIQGC2YSc/IvbEctZ12FBU6SQ53UshDQacacx62wUgeMyJ63bpyJ+a9Sl2fa+4deEQfIBmah3AB3FwIU+Uxa8A1prlRYmVY1UmcDHAf+62pyLbUmMBgmtj7GArv54aCgaaYJzwV9ZTjuTDel9YUXfB1OWwOsK6z8tblfoWcisTEMbS0QvPubHJFAbe9kHZQH+oU/8V2S8Nxpmen1YY9/ivYDf+97H05qaihLOdzmoqhlNWkfMYHHKI26aCqHuHW9qbffvdbuzwy39zoEXEZbeujVadkbPfptdfY5BnB8VcHSrw3aDsWEooTdPWVRZrXs8AFw==
    to_be_paidnumber<double>povinné

    Kolik z faktury zbývá uhradit, v měně dokladu.

    např. 50
    accountedbooleanpovinné

    Faktura je zaúčtovaná v účetním deníku.

    eetbooleanpovinné

    Faktura byla odeslána do EET.

    share_linkstring | nullmůže být null

    Veřejný odkaz na doklad. Vzniká až voláním PUT /invoice_issued/{id}/share.

    např. https://online.iucto.cz/link/i?s=ukazka-tajny-odkaz-nema-tenhle-tvar
    proforma_invoice object[]

    Zálohové faktury odečtené z této faktury. Při zápisu se posílá pole jejich ID, ne objektů.

  • Array [
  • idinteger
  • ]
  • modifiedstring<date-time>

    Datum a čas poslední změny záznamu. Jediné pole, podle kterého jde tenhle seznam řadit (sort=-modified), takže se používá jako vodoznak při inkrementálním stahování.

    např. 2026-08-07T19:03:56+02:00
    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"]
    idinteger

    ID dokladu.

    price_inc_vatnumber<double>povinné

    Cena celkem včetně DPH v měně dokladu.

    např. 50
    deletedboolean

    Doklad je smazaný.

    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
    pricenumber<double>povinné

    Cena bez DPH v měně dokladu.

    např. 50
    price_czknumber<double>povinné

    Cena bez DPH v CZK.

    např. 50
    price_inc_vat_czknumber<double>povinné

    Cena celkem včetně DPH v CZK.

    např. 50
    items object[]povinné

    Položky dokladu.

  • Array [
  • idintegerpovinné

    ID položky.

    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
    vatnumber

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

    např. 21
    vat_totalnumber<double>

    DPH celkem za položku.

    např. 0
    department_idinteger
    contract_idinteger
    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
    vat_chart_idinteger | nullmůže být null
  • ]
  • 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.

    creditnote object

    Detail opravného daňového dokladu přijatého.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    supplier objectpovinné

    Detail dodavatele.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idintegerpovinné

    ID dodavatele.

    namestringpovinnémax. délka 100

    Jméno nebo název dodavatele.

    např. Jan Novák
    comidstringmax. délka 20

    IČO.

    např. 12345679
    emailstringmax. délka 100

    E-mail.

    např. novak.jan@example.org
    phonestringmax. délka 20

    Telefon.

    např. +420123123123
    cellphonestringmax. délka 20

    Mobil.

    např. +420123123123
    supplier_group_idinteger
    external_codestringmax. délka 50

    Vlastní identifikátor dodavatele v cizím systému.

    např. CC123
    vat_payerbooleanpovinné

    Dodavatel je plátce DPH.

    vatidstringmax. délka 20

    DIČ. Vyplňuje se u plátce DPH.

    např. CZ12345679
    name_displaystringmax. délka 100

    Jméno zobrazované na dokladech, když se liší od názvu.

    např. Jan Novák ml.
    wwwstringmax. délka 40

    Webová adresa.

    např. https://www.iucto.cz
    address objectpovinné

    Poštovní adresa kontaktu.

    streetstring

    Ulice a číslo popisné.

    např. Stodolní 123
    citystring

    Město.

    např. Ostrava
    postalcodestring

    Poštovní směrovací číslo.

    např. 385 02
    countryCountryCodepovinné

    Země.

    např. CZ
    notestringmax. délka 1000

    Interní poznámka.

    např. Věrný dodavatel
    account_number1string | nullmůže být null

    Číslo bankovního účtu dodavatele.

    např. 1234567890/0100
    account_number2string | nullmůže být null

    Druhé číslo bankovního účtu dodavatele.

    např. 1234-1234567890/4400
    account_number3string | nullmůže být null

    Třetí číslo bankovního účtu dodavatele.

    např. null
    account_number4string | nullmůže být null

    Čtvrté číslo bankovního účtu dodavatele.

    např. null
    default_department_idinteger

    ID střediska předvyplněného na dokladu.

    default_contract_idinteger

    ID zakázky předvyplněné na dokladu.

    bank_account object

    Detail bankovního účtu.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idintegerpovinné

    ID účtu.

    numberstringpovinné

    Celé číslo účtu ve tvaru předčíslí-číslo/kód banky.

    např. 19-123457/0100
    balancenumber<double>

    Aktuální zůstatek účtu v měně účtu. (API 1.3+)

    např. 0
    balance_czknumber<double>

    Aktuální zůstatek účtu v CZK. (API 1.3+)

    např. 0
    realtime_payment_fetchboolean

    Účet podporuje načítání plateb v reálném čase. (API 1.3+)

    namestringmax. délka 45

    Název účtu.

    např. Komerční banka
    currencystringpovinnémax. délka 3

    Měna účtu, kód podle ISO 4217. Dostupné hodnoty vrací Měny.

    např. CZK
    isdefaultboolean

    Účet je nastavený jako výchozí.

    account_prefixstring

    Předčíslí účtu. Řetězec, aby se zachovala vedoucí nula.

    např. 19
    account_numberstringpovinné

    Číslo účtu bez předčíslí.

    např. 123457
    bank_codestringpovinné

    Kód banky.

    např. 0100
    swiftstringmax. délka 11

    SWIFT / BIC.

    např. KOMBCZPPXXX
    ibanstringmax. délka 34

    IBAN.

    např. CZ5601000000190000123457
    initial_statenumber<double>

    Počáteční stav účtu.

    např. 0
    chart_account_idinteger

    ID účtu účetní osnovy. Výchozí je 221.

    visibleboolean

    Účet se nabízí v seznamech.

    items object[]povinné

    Položky dokladu.

  • Array [
  • idintegerpovinné

    ID položky.

    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
    vatnumber

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

    např. 21
    vat_totalnumber<double>

    DPH celkem za položku.

    např. 0
    department_idinteger
    contract_idinteger
    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
    vat_chart_idinteger | nullmůže být null
  • ]
  • idinteger

    ID dokladu.

    price_inc_vatnumber<double>povinné

    Cena celkem včetně DPH v měně dokladu.

    např. 50
    to_be_paidnumber<double>povinné

    Kolik z dokladu zbývá uhradit, v měně dokladu.

    např. 50
    deletedboolean

    Doklad je smazaný.

    accountedbooleanpovinné

    Doklad je zaúčtovaný v účetním deníku.

    modifiedstring<date-time>

    Datum a čas poslední změny záznamu. Jediné pole, podle kterého jde tenhle seznam řadit (sort=-modified), takže se používá jako vodoznak při inkrementálním stahování.

    např. 2026-08-07T19:03:56+02:00
    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
    invoice_received_idinteger

    ID faktury přijaté, ke které se doklad vztahuje.

    pricenumber<double>povinné

    Cena bez DPH v měně dokladu.

    např. 50
    price_czknumber<double>povinné

    Cena bez DPH v CZK.

    např. 50
    price_inc_vat_czknumber<double>povinné

    Cena celkem včetně DPH v CZK.

    např. 50
    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.

    supplier_bank_accountstring

    Číslo bankovního účtu dodavatele, na který se vrací peníze.

    např. 123456789/0800
    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.

    cash_register object

    Pokladna firmy.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idintegerpovinné

    ID pokladny.

    namestringpovinnémax. délka 45

    Název pokladny.

    např. EET pokladna
    currencystringpovinnémax. délka 3

    Měna pokladny, kód podle ISO 4217. Dostupné hodnoty vrací Měny.

    např. CZK
    isdefaultbooleanpovinné

    Pokladna je nastavená jako výchozí.

    initial_statenumber<double>

    Počáteční stav pokladny.

    např. 0
    iseetbooleanpovinné

    Pokladna je nastavená pro elektronickou evidenci tržeb.

    business_premises object

    Provozovna, pod kterou pokladna spadá. Vyplňuje se u pokladen zapojených do EET.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idintegerpovinné

    ID provozovny.

    namestringpovinné

    Název provozovny.

    např. Restaurace u koníčka
    isdefaultboolean

    Provozovna je nastavená jako výchozí.

    balancenumber<double>

    Aktuální zůstatek pokladny v měně pokladny. (API 1.3+)

    např. 0
    balance_czknumber<double>

    Aktuální zůstatek pokladny v CZK. (API 1.3+)

    např. 0
    bank_account object

    Detail bankovního účtu.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idintegerpovinné

    ID účtu.

    numberstringpovinné

    Celé číslo účtu ve tvaru předčíslí-číslo/kód banky.

    např. 19-123457/0100
    balancenumber<double>

    Aktuální zůstatek účtu v měně účtu. (API 1.3+)

    např. 0
    balance_czknumber<double>

    Aktuální zůstatek účtu v CZK. (API 1.3+)

    např. 0
    realtime_payment_fetchboolean

    Účet podporuje načítání plateb v reálném čase. (API 1.3+)

    namestringmax. délka 45

    Název účtu.

    např. Komerční banka
    currencystringpovinnémax. délka 3

    Měna účtu, kód podle ISO 4217. Dostupné hodnoty vrací Měny.

    např. CZK
    isdefaultboolean

    Účet je nastavený jako výchozí.

    account_prefixstring

    Předčíslí účtu. Řetězec, aby se zachovala vedoucí nula.

    např. 19
    account_numberstringpovinné

    Číslo účtu bez předčíslí.

    např. 123457
    bank_codestringpovinné

    Kód banky.

    např. 0100
    swiftstringmax. délka 11

    SWIFT / BIC.

    např. KOMBCZPPXXX
    ibanstringmax. délka 34

    IBAN.

    např. CZ5601000000190000123457
    initial_statenumber<double>

    Počáteční stav účtu.

    např. 0
    chart_account_idinteger

    ID účtu účetní osnovy. Výchozí je 221.

    visibleboolean

    Účet se nabízí v seznamech.

    eet_status object

    Zkrácený stav EET zprávy, jak se objevuje v detailu dokladu.

    _links object

    HAL odkaz na samotný zdroj.

    self objectpovinné
    hrefstringpovinné

    Cesta ke zdroji včetně prefixu verze API, například /1.3/{zdroj}/{id}.

    idinteger

    ID EET záznamu.

    statusstring

    Stav odeslání zprávy.

    např. ok
    fikstring

    Fiskální identifikační kód přidělený finanční správou.

    např. f26e5172-077e-4aba-9f5c-d0181362a16b-ff
    bkpstring

    Bezpečnostní kód poplatníka.

    např. a983e13d-c6c7ce4a-03198fec-8cc1292c-32134ae9
    pkpstring

    Podpisový kód poplatníka.

    např. awOqOqCmawUNvyDpjFIQGC2YSc/IvbEctZ12FBU6SQ53UshDQacacx62wUgeMyJ63bpyJ+a9Sl2fa+4deEQfIBmah3AB3FwIU+Uxa8A1prlRYmVY1UmcDHAf+62pyLbUmMBgmtj7GArv54aCgaaYJzwV9ZTjuTDel9YUXfB1OWwOsK6z8tblfoWcisTEMbS0QvPubHJFAbe9kHZQH+oU/8V2S8Nxpmen1YY9/ivYDf+97H05qaihLOdzmoqhlNWkfMYHHKI26aCqHuHW9qbffvdbuzwy39zoEXEZbeujVadkbPfptdfY5BnB8VcHSrw3aDsWEooTdPWVRZrXs8AFw==
    PaymentReceivedDetail
    {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 123,
    "price_inc_vat": 50,
    "deleted": false,
    "currency": "CZK",
    "modified": "2026-08-07T19:03:56+02:00",
    "sequence_code": "PP20190001",
    "external_code": "FV3425435",
    "variable_symbol": "20190001",
    "date": "2019-07-12",
    "date_vat": "2019-07-12",
    "proforma_invoice_id": 1234,
    "oss_mode": false,
    "eet": false,
    "price": 50,
    "price_czk": 50,
    "price_inc_vat_czk": 50,
    "items": [
    {
    "id": 123456,
    "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
    }
    ],
    "payment_type": "transfer",
    "date_vat_prev": "2019-05-05",
    "description": "Popis",
    "rounding_type": "round",
    "reference_mark": "RF",
    "full_paid": true,
    "liquidation_amount": 50,
    "customer": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 123,
    "name": "Jan Novák",
    "comid": "12345679",
    "email": "novak.jan@example.org",
    "phone": "+420123123123",
    "cellphone": "+420123123123",
    "customer_group_id": 78,
    "external_code": "CC123",
    "vat_payer": false,
    "vatid": "CZ12345679",
    "name_display": "Jan Novák ml.",
    "www": "https://www.iucto.cz",
    "usual_maturity": 30,
    "preferred_payment_method": "transfer",
    "invoice_language": "cs",
    "address": {
    "street": "Stodolní 123",
    "city": "Ostrava",
    "postalcode": "385 02",
    "country": "CZ"
    },
    "note": "Věrný zákazník",
    "account_number1": "1234567890/0100",
    "account_number2": "1234-1234567890/4400",
    "account_number3": null,
    "account_number4": null,
    "default_department_id": 123,
    "default_contract_id": 321
    },
    "supplier": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 123,
    "name": "Jan Novák",
    "comid": "12345679",
    "email": "novak.jan@example.org",
    "phone": "+420123123123",
    "cellphone": "+420123123123",
    "supplier_group_id": 78,
    "external_code": "CC123",
    "vat_payer": false,
    "vatid": "CZ12345679",
    "name_display": "Jan Novák ml.",
    "www": "https://www.iucto.cz",
    "address": {
    "street": "Stodolní 123",
    "city": "Ostrava",
    "postalcode": "385 02",
    "country": "CZ"
    },
    "note": "Věrný dodavatel",
    "account_number1": "1234567890/0100",
    "account_number2": "1234-1234567890/4400",
    "account_number3": null,
    "account_number4": null,
    "default_department_id": 123,
    "default_contract_id": 321
    },
    "invoice": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "customer": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 123,
    "name": "Jan Novák",
    "comid": "12345679",
    "email": "novak.jan@example.org",
    "phone": "+420123123123",
    "cellphone": "+420123123123",
    "customer_group_id": 78,
    "external_code": "CC123",
    "vat_payer": false,
    "vatid": "CZ12345679",
    "name_display": "Jan Novák ml.",
    "www": "https://www.iucto.cz",
    "usual_maturity": 30,
    "preferred_payment_method": "transfer",
    "invoice_language": "cs",
    "address": {
    "street": "Stodolní 123",
    "city": "Ostrava",
    "postalcode": "385 02",
    "country": "CZ"
    },
    "note": "Věrný zákazník",
    "account_number1": "1234567890/0100",
    "account_number2": "1234-1234567890/4400",
    "account_number3": null,
    "account_number4": null,
    "default_department_id": 123,
    "default_contract_id": 321
    },
    "bank_account": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 456,
    "number": "19-123457/0100",
    "balance": 0,
    "balance_czk": 0,
    "realtime_payment_fetch": true,
    "name": "Komerční banka",
    "currency": "CZK",
    "isdefault": true,
    "account_prefix": "19",
    "account_number": "123457",
    "bank_code": "0100",
    "swift": "KOMBCZPPXXX",
    "iban": "CZ5601000000190000123457",
    "initial_state": 0,
    "chart_account_id": 424,
    "visible": true
    },
    "document_state": {
    "id": 123,
    "name": "Odesláno",
    "description": "Doklad byl odeslán zákazníkovi",
    "visibility": true
    },
    "business_premises": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 897,
    "name": "Restaurace u koníčka",
    "isdefault": true
    },
    "eet_status": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 1,
    "status": "ok",
    "fik": "f26e5172-077e-4aba-9f5c-d0181362a16b-ff",
    "bkp": "a983e13d-c6c7ce4a-03198fec-8cc1292c-32134ae9",
    "pkp": "awOqOqCmawUNvyDpjFIQGC2YSc/IvbEctZ12FBU6SQ53UshDQacacx62wUgeMyJ63bpyJ+a9Sl2fa+4deEQfIBmah3AB3FwIU+Uxa8A1prlRYmVY1UmcDHAf+62pyLbUmMBgmtj7GArv54aCgaaYJzwV9ZTjuTDel9YUXfB1OWwOsK6z8tblfoWcisTEMbS0QvPubHJFAbe9kHZQH+oU/8V2S8Nxpmen1YY9/ivYDf+97H05qaihLOdzmoqhlNWkfMYHHKI26aCqHuHW9qbffvdbuzwy39zoEXEZbeujVadkbPfptdfY5BnB8VcHSrw3aDsWEooTdPWVRZrXs8AFw=="
    },
    "to_be_paid": 50,
    "accounted": true,
    "eet": false,
    "share_link": "https://online.iucto.cz/link/i?s=ukazka-tajny-odkaz-nema-tenhle-tvar",
    "proforma_invoice": [
    {
    "id": 123456
    }
    ],
    "modified": "2026-08-07T19:03:56+02:00",
    "oss_mode": false,
    "order_id": "13290",
    "reminders": [
    "2019-08-12",
    "2019-08-19"
    ],
    "id": 123,
    "price_inc_vat": 50,
    "deleted": false,
    "sequence_code": "DOC20190001",
    "variable_symbol": "20190001",
    "date": "2019-07-12",
    "date_vat": "2019-01-10",
    "maturity_date": "2019-01-25",
    "currency": "CZK",
    "price": 50,
    "price_czk": 50,
    "price_inc_vat_czk": 50,
    "items": [
    {
    "id": 123456,
    "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
    }
    ],
    "payment_type": "transfer",
    "date_vat_prev": "2019-01-01",
    "description": "Popis",
    "rounding_type": "round"
    },
    "creditnote": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "supplier": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 123,
    "name": "Jan Novák",
    "comid": "12345679",
    "email": "novak.jan@example.org",
    "phone": "+420123123123",
    "cellphone": "+420123123123",
    "supplier_group_id": 78,
    "external_code": "CC123",
    "vat_payer": false,
    "vatid": "CZ12345679",
    "name_display": "Jan Novák ml.",
    "www": "https://www.iucto.cz",
    "address": {
    "street": "Stodolní 123",
    "city": "Ostrava",
    "postalcode": "385 02",
    "country": "CZ"
    },
    "note": "Věrný dodavatel",
    "account_number1": "1234567890/0100",
    "account_number2": "1234-1234567890/4400",
    "account_number3": null,
    "account_number4": null,
    "default_department_id": 123,
    "default_contract_id": 321
    },
    "bank_account": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 456,
    "number": "19-123457/0100",
    "balance": 0,
    "balance_czk": 0,
    "realtime_payment_fetch": true,
    "name": "Komerční banka",
    "currency": "CZK",
    "isdefault": true,
    "account_prefix": "19",
    "account_number": "123457",
    "bank_code": "0100",
    "swift": "KOMBCZPPXXX",
    "iban": "CZ5601000000190000123457",
    "initial_state": 0,
    "chart_account_id": 424,
    "visible": true
    },
    "items": [
    {
    "id": 123456,
    "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
    }
    ],
    "id": 123,
    "price_inc_vat": 50,
    "to_be_paid": 50,
    "deleted": false,
    "accounted": true,
    "modified": "2026-08-07T19:03:56+02:00",
    "sequence_code": "DOC20190001",
    "variable_symbol": "20190001",
    "date": "2019-07-12",
    "date_vat": "2019-01-10",
    "maturity_date": "2019-01-25",
    "currency": "CZK",
    "invoice_received_id": 12343,
    "price": 50,
    "price_czk": 50,
    "price_inc_vat_czk": 50,
    "payment_type": "transfer",
    "supplier_bank_account": "123456789/0800",
    "date_vat_prev": "2019-01-01",
    "description": "Popis",
    "rounding_type": "round"
    },
    "cash_register": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 475,
    "name": "EET pokladna",
    "currency": "CZK",
    "isdefault": true,
    "initial_state": 0,
    "iseet": true,
    "business_premises": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 897,
    "name": "Restaurace u koníčka",
    "isdefault": true
    },
    "balance": 0,
    "balance_czk": 0
    },
    "bank_account": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 456,
    "number": "19-123457/0100",
    "balance": 0,
    "balance_czk": 0,
    "realtime_payment_fetch": true,
    "name": "Komerční banka",
    "currency": "CZK",
    "isdefault": true,
    "account_prefix": "19",
    "account_number": "123457",
    "bank_code": "0100",
    "swift": "KOMBCZPPXXX",
    "iban": "CZ5601000000190000123457",
    "initial_state": 0,
    "chart_account_id": 424,
    "visible": true
    },
    "eet_status": {
    "_links": {
    "self": {
    "href": "string"
    }
    },
    "id": 1,
    "status": "ok",
    "fik": "f26e5172-077e-4aba-9f5c-d0181362a16b-ff",
    "bkp": "a983e13d-c6c7ce4a-03198fec-8cc1292c-32134ae9",
    "pkp": "awOqOqCmawUNvyDpjFIQGC2YSc/IvbEctZ12FBU6SQ53UshDQacacx62wUgeMyJ63bpyJ+a9Sl2fa+4deEQfIBmah3AB3FwIU+Uxa8A1prlRYmVY1UmcDHAf+62pyLbUmMBgmtj7GArv54aCgaaYJzwV9ZTjuTDel9YUXfB1OWwOsK6z8tblfoWcisTEMbS0QvPubHJFAbe9kHZQH+oU/8V2S8Nxpmen1YY9/ivYDf+97H05qaihLOdzmoqhlNWkfMYHHKI26aCqHuHW9qbffvdbuzwy39zoEXEZbeujVadkbPfptdfY5BnB8VcHSrw3aDsWEooTdPWVRZrXs8AFw=="
    }
    }