Slovníček pojmů

Účetní pojmy, na které v iÚčto API narazíte, přeložené do polí a endpointů. U každého hesla je krátký výklad a řádek V API, který říká, kde se pojem v datech objeví.

Doklady

Datum vystavení
Den, kdy doklad vznikl. Neurčuje ani DPH, ani splatnost.
V API: date — povinné na všech dokladech i platbách. Zápis do uzavřeného účetního období API odmítne: POST s kódem 400, PUT a DELETE s kódem 403. → Uzavřené období

DUZP — datum uskutečnění zdanitelného plnění
Den, ke kterému se plnění považuje za uskutečněné a ke kterému plátci vzniká povinnost přiznat DPH. Podle něj doklad spadne do zdaňovacího období.
V API: date_vat na dokladech a platbách s DPH. U neplátce se nevyplňuje, u zálohových faktur se nepoužívá vůbec. → Neplátci DPH

Datum splatnosti
Den, do kterého má být doklad uhrazen. S DPH nemá nic společného.
V API: maturity_date — povinné na fakturách, zálohových fakturách, opravných daňových dokladech a interních předpisech nákladů. Data upomínek (reminders) musí být v den splatnosti nebo po něm. → Upomínky

Datum předchozí sazby DPH
Vyplňuje se u dokladů, které spadají do období se změnou sazeb DPH — podle tohoto data systém pozná, která sazba na dokladu je základní a která snížená. Když je prázdné, platí sazby k datu dokladu.
V API: date_vat_prev na fakturách, opravných daňových dokladech, interních předpisech nákladů a platbách. Zálohové faktury ho nemají.

Zálohová faktura (proforma)
Výzva k zaplacení zálohy předem. Není to daňový doklad a neuvádí se na ní daň — povinnost přiznat DPH vzniká až přijetím úplaty.
V API: Zálohové faktury vydané a přijaté. Nemají date_vat. to_be_paid říká, kolik zbývá uhradit, to_be_invoiced, kolik zbývá odečíst na konečné faktuře; ta odečtené zálohy vrací v poli proforma_invoice.

Daňový doklad k přijaté platbě
Daňový doklad, který plátce vystaví po přijetí zálohy — daň se přiznává ke dni přijetí úplaty, ne k datu zálohové faktury.
V API: samostatný endpoint nemá — je to přijatá platba navázaná na zálohovou fakturu přes proforma_invoice_id. Plnou úhradu zálohy umí založit i PUT /proforma_invoice_issued/{id}/pay. → Platby přijaté

Opravný daňový doklad (ODD, „dobropis")
Doklad, kterým se opravuje už vystavená faktura — sleva, vrácení zboží, špatné množství. Původní faktura zůstává v účetnictví beze změny.
V API: Opravné daňové doklady vydané a přijaté. Vazbu na opravovaný doklad nese invoice_issued_id, resp. invoice_received_id, důvod opravy se píše do povinného pole description a opravované množství se zadává záporně (items[].amount: -1).

Storno vs. oprava
Storno znamená, že doklad z evidence zmizí; oprava znamená, že vedle původního dokladu vznikne opravný. Jakmile doklad odešel protistraně a vstoupil do přiznání k DPH, řeší se oprava opravným daňovým dokladem.
V API: DELETE /invoice_issued/{id} a obdoby u ostatních dokladů. Smazání neprojde, když je doklad vázaný na jiný záznam, když je období uzavřené nebo když byl doklad odeslaný do EET — pak zbývá jen opravný daňový doklad.

Číselná řada (sequence_code)
Předdefinovaná posloupnost, ze které se dokladům přidělují čísla. Nastavuje se v aplikaci, přes API se nemění.
V API: sequence_code je číslo konkrétního dokladu. Když ho při zápisu nevyplníte, přidělí ho číselná řada nastavená ve firmě. U přijatých dokladů je číslo od dodavatele zvlášť v external_code.

Variabilní symbol
Číslo, kterým plátce označí bankovní platbu, aby ji příjemce spároval se správným dokladem.
V API: variable_symbol na dokladech, platbách i bankovních pohybech. U bankovního pohybu je spolu s bank_account podmínkou automatického spárování s dokladem. → Bankovní pohyby

Typy dokladů a jejich kódy
Krátké interní kódy jednotlivých druhů dokladů: FV faktura vydaná, FP faktura přijatá, ZFV zálohová faktura vydaná, ODV opravný daňový doklad vydaný, PP platba přijatá a další.
V API: povinný parametr doctype u číselníků Typy DPH a Typy účetních položek a pole document_type v účetním deníku. Úplná tabulka je v Datových typech.

Daně

Plátce, neplátce, identifikovaná osoba
Neplátce DPH daň neúčtuje ani neodečítá, plátce ji odvádí měsíčně nebo čtvrtletně. Identifikovaná osoba je k DPH registrovaná kvůli přeshraničním plněním, ale u tuzemských plnění daň na výstupu neuplatňuje a nemá nárok na odpočet.
V API: vat_type v GET /company_profile s hodnotami nonpayer, identified_person, monthly, quarterly. U neplátce se nevyplňují pole navázaná na daň. → Detail firmy, Neplátci DPH

Sazba DPH
Procento daně u konkrétní položky dokladu. Sazby se v čase mění a v jiných státech EU jsou jiné, proto se nezadávají natvrdo, ale zjišťují k datu.
V API: items[].vat v procentech. Platné sazby vrací GET /vat_rates s povinným parametrem date, volitelně country pro zemi EU. → Sazby DPH

Typ DPH (vattype_id)
Určuje, o jaký druh plnění jde — zdanitelné plnění v ČR, dodání zboží do EU, vývoz, přenesená daňová povinnost. Z typu systém odvodí, jak se daň zaúčtuje a jak se promítne do přiznání k DPH.
V API: items[].vattype_id. Číselník vrací GET /vat_type s povinným parametrem doctype — nabídka se liší podle typu dokladu. → Typy DPH

Účet DPH (vat_chart_id)
Konkrétní účet, na který se daň z položky zaúčtuje. Je to ruční varianta zadání tam, kde typ DPH nestačí.
V API: items[].vat_chart_id z číselníku GET /vat_chart. Když na položce vyplníte vattype_id, hodnotu vat_chart_id přepíše — obojí najednou nemá smysl posílat. → Účty DPH, Zaúčtování položek

Reverse charge (přenesená daňová povinnost)
Režim, ve kterém daň nepřiznává dodavatel, ale odběratel. Dodavatel vystaví doklad bez daně; v tuzemsku se to týká vyjmenovaných plnění, například stavebních a montážních prací.
V API: vlastní pole nemá — vybírá se vattype_id odpovídajícího typu z GET /vat_type (pro doctype=FP je to třeba „Stavební a montážní práce"). Příznak přenesené povinnosti je vlastností typu DPH v aplikaci, v odpovědi jsou jen ID a české názvy. → Typy DPH

OSS — One Stop Shop
Režim jednoho správního místa: při prodeji koncovým zákazníkům v jiných státech EU odvádíte DPH cílové země, ale přiznáváte ji jedním hlášením v ČR.
V API: oss_mode na fakturách, zálohových fakturách, opravných daňových dokladech a přijatých platbách; oss_status v GET /company_profile říká, jestli má firma režim zapnutý. Sazbu cílové země vrací GET /vat_rates s parametrem country. → Režim One Stop Shop

Období DPH vs. účetní období
Účetní období je rok, za který se sestavuje účetní závěrka. Období DPH je měsíc nebo čtvrtletí, za které se podává přiznání. Uzavírají se nezávisle na sobě.
V API: vlastní endpoint nemají. Projeví se tím, že s dokladem se starým datem se nedá pracovat — kód se přitom liší podle operace. POST skončí kódem 400 a hláškou Záznam musí spadat do otevřeného účetního, případně DPH období., PUT a DELETE kódem 403 a hláškou Doklad je smazaný, nebo účetní období, či období DPH je uzavřeno. → Dva nezávislé zámky

Účtování

Zaúčtování
Převedení dokladu na zápisy v účetním deníku. Do té doby doklad existuje, ale v účetnictví se neprojeví.
V API: PUT /<doklad>/{id}/account, například PUT /invoice_issued/{id}/account. Všechny položky musí mít vyplněné zaúčtování; hotovo poznáte podle accounted: true. → Zaúčtování položek

Účetní deník
Chronologický seznam všech účetních zápisů firmy. Každý řádek nese částku, stranu MD a DAL a odkaz na doklad, ze kterého vznikl.
V API: GET /journal, jen pro čtení. document_type a document_id ukazují na zdrojový doklad, parent_document_type na doklad navázaný — například na fakturu, kterou platba hradí. → Účetní deník

Účtová osnova
Seznam účtů, na které firma účtuje (311 pohledávky, 321 závazky, 343 DPH…). Každá firma má vlastní.
V API: GET /chart_account vrací mapu ID účtu → "číslo - název". V dokladech se posílá to ID, ne číslo účtu — chart_account_id, chartaccount_md, chartaccount_dal. → Účty účetní osnovy

Typ účetní položky (accountentrytype_id)
Pojmenovaná předloha zaúčtování — „Prodej služby", „Úhrada faktury vydané". Vyberete typ a účty za vás dosadí systém.
V API: items[].accountentrytype_id z číselníku GET /accountentry_type s povinným parametrem doctype. Na položce přepisuje chart_account_id. → Typy účetních položek

MD a DAL
Dvě strany každého účetního zápisu (má dáti / dal). Zápis má vždy obě strany a na obou stejnou částku.
V API: chartaccount_md a chartaccount_dal v účetním deníku a na položkách přímého zaúčtování; obojí jsou ID z účtové osnovy.

Přímé zaúčtování (PZ)
Účetní doklad zapsaný rovnou do deníku, bez faktury — interní operace, přeúčtování, opravy.
V API: Přímé zaúčtování. Položka nese přímo chartaccount_md a chartaccount_dal, nemá sazbu DPH ani počet jednotek a může mít vlastní protistranu (customer_id nebo supplier_id).

Interní předpis nákladů (IPN)
Interní doklad, kterým firma zapíše náklad.
V API: Interní předpisy nákladů. Má dodavatele, splatnost, položky s DPH i to_be_paid jako přijatá faktura, navíc povinný protiúčet chartaccount_dal_id, na který se předpis zaúčtuje na straně Dal.

Platby

Úhrada
Zaplacení dokladu. V iÚčtu je to samostatný doklad — platba — navázaný na fakturu, zálohovou fakturu nebo opravný daňový doklad.
V API: Platby přijaté (příchozí) a Platby vydané (odchozí). Platba se páruje nejvýš na jeden doklad — pole s ID faktury, zálohové faktury a opravného dokladu se nedají kombinovat. U přijaté platby jsou to invoice_id, proforma_invoice_id a creditnote_received_id.

Likvidace a liquidation_amount
Likvidace je přiřazení částky platby konkrétnímu dokladu. U dokladů v cizí měně se částka odepsaná z účtu nerovná částce, kterou platba z dokladu umazává, takže je potřeba ji zadat.
V API: liquidation_amount — kolik platba likviduje z napárovaného dokladu, v měně dokladu. Povinné, když je doklad v jiné měně než CZK nebo když se měna účtu či pokladny liší od měny dokladu (od verze API 1.2). full_paid: true znamená úhradu v plné výši.

Zbývá uhradit (to_be_paid)
Neuhrazený zůstatek dokladu.
V API: to_be_paid, jen pro čtení, v měně dokladu. Je i v seznamech, takže se podle něj dají dohledat nezaplacené doklady. U už uhrazené zálohové faktury (to_be_paid je nula) skončí PUT /proforma_invoice_issued/{id}/pay chybou.

Bankovní pohyb vs. platba
Bankovní pohyb je řádek výpisu z účtu, tedy jen záznam, že peníze přišly nebo odešly. Platba je účetní doklad. Z pohybu platba teprve vzniká.
V API: Bankovní pohyby drží pohyby; status říká, v jaké fázi zpracování pohyb je: notprocessed nezpracováno, unmatched nespárováno, matched spárováno, halfmatcheded částečně spárováno, accounted z pohybu vznikla platba. Hodnota halfmatcheded je překlep na straně API — porovnávejte přesně tenhle řetězec, jinak vám stav propadne. PUT /bank_transaction/{id}/account z pohybu vytvoří platbu a vrátí ji.

Párovací znak
Volitelná textová značka na záznamu, podle které se dá dohledat, ke kterému dokladu patří. Není to variabilní symbol — automatické párování bankovních pohybů běží přes variabilní symbol, ne přes párovací znak.
V API: reference_mark na platbách přijatých i vydaných (v aplikaci „Referenční značka", nejvýš 45 znaků) a da_code na položkách přímého zaúčtování.

Organizace firmy

Středisko (department_id)
Vnitřní jednotka firmy — pobočka, provoz, oddělení. Slouží k členění nákladů a výnosů.
V API: číselník Střediska (code, name), na položce dokladu department_id. Účetní deník ho vrací zpátky, takže jde vyhodnocovat podle středisek.

Zakázka (contract_id)
Projekt nebo obchodní případ. Druhá, na středisku nezávislá osa členění nákladů a výnosů.
V API: číselník Zakázky (code, name), na položce dokladu contract_id. Stejně jako středisko je i v účetním deníku.

Provozovna
Místo, ze kterého firma podniká. V API má význam kvůli EET — tržba se hlásila pod konkrétní provozovnou.
V API: Provozovny, jen pro čtení. business_premises_id se posílá na dokladu, který iÚčto odesílá do EET. → EET

Pokladna
Evidence hotovosti. Hotovostní platba musí jít do konkrétní pokladny, každá má vlastní měnu a zůstatek.
V API: Pokladny, jen pro čtení. cash_register_id se posílá na platbě s payment_type: cash; příznak iseet říká, jestli je pokladna zapojená do EET.

EET — elektronická evidence tržeb
Hlášení hotovostních tržeb finanční správě v okamžiku platby. Zákon o evidenci tržeb byl zrušen k 1. 1. 2023, endpointy a pole zůstávají kvůli dokladům z doby, kdy povinnost platila.
V API: eet na fakturách vydaných, opravných daňových dokladech vydaných a platbách přijatých, eet_status s ID zprávy a zdroje Seznam EET záznamů a Správa EET záznamů. → EET