Přeskočit na hlavní obsah

PaymentReceivedListItem

Platba přijatá tak, jak vypadá v seznamu.

_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).

customer object

Zákazník tak, jak vypadá v seznamu a ve vnořených objektech.

_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
supplier object

Dodavatel tak, jak vypadá v seznamu a ve vnořených objektech.

_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
invoice object

Faktura vydaná tak, jak vypadá v seznamu.

_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é

Zákazník tak, jak vypadá v seznamu a ve vnořených objektech.

_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
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.

    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
    creditnote object

    Opravný daňový doklad přijatý tak, jak vypadá v seznamu.

    _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é

    Dodavatel tak, jak vypadá v seznamu a ve vnořených objektech.

    _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
    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.

    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

    Bankovní účet tak, jak vypadá v seznamu.

    _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í.

    PaymentReceivedListItem
    {
    "_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,
    "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"
    },
    "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"
    },
    "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"
    },
    "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,
    "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"
    },
    "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"
    },
    "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
    },
    "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
    }
    }