Služba pro správu DPH u neuhrazených dokladů po splatnosti. V České republice se jedná o doklady 6 měsíců po splatnosti, na Slovensku 100 dní po splatnosti.

Služba umožňuje vytvoření dvou typů pomocných dokladů:

Vrácení DPH — pomocný doklad pro vrácení DPH u neuhrazených dokladů.
Uplatnění DPH — pomocný doklad pro opětovné uplatnění DPH u nyní již uhrazených dokladů.

Uživatel nejprve vybírá měsíc nebo čtvrtletí a rok, podle čehož se mu nabídnou faktury. Pro vybrané faktury může vytvořit pomocné doklady — u vrácení DPH vznikne jeden doklad pro každou fakturu, u uplatnění DPH jeden doklad pro kombinaci faktury a úhrady.

Dostupné endpointy

Účel	Metoda	Adresa
Vrácení DPH — přehled dokladů	`GET`	`/c/{firma}/neuhrazene-po-splatnosti.{přípona}`
Vrácení DPH — vytvoření dokladu	`POST` / `PUT`	`/c/{firma}/neuhrazene-po-splatnosti/vraceni-dph.{přípona}`
Uplatnění DPH — přehled dokladů	`GET`	`/c/{firma}/neuhrazene-po-splatnosti-2.{přípona}`
Uplatnění DPH — vytvoření dokladu	`POST` / `PUT`	`/c/{firma}/neuhrazene-po-splatnosti-2/uplatneni-dph.{přípona}`

Kde {firma} je databázový identifikátor firmy a {přípona} formát výstupu (xml, json). Přehled dokladů je dostupný metodou GET, vytvoření pomocného dokladu metodami POST nebo PUT.

ℹ️ Rozdíl mezi oběma evidencemi je v jejich obsahu: neuhrazene-po-splatnosti nabízí doklady, u nichž se DPH vrací, neuhrazene-po-splatnosti-2 pak doklady, u nichž se DPH znovu uplatňuje. Jiná varianta (např. -3) neexistuje a vrátí 404.

Parametry — přehled dokladů (GET)

Parametr	Povinnost	Formát a význam
`rok`	povinný	Rok, pro který se mají doklady zobrazit. Formát `yyyy`, např. `2024`.
`mesic`	volitelný*	Měsíc, pro který se mají doklady zobrazit. Formát `M` nebo `MM`, např. `3` či `03` pro březen.
`ctvrtleti`	volitelný*	Čtvrtletí, pro které se mají doklady zobrazit. Hodnoty `1`, `2`, `3`, `4`.

⚠️ * Musí být zadán buď parametr mesic, nebo ctvrtleti — ne oba současně. Platí pro všechny endpointy této služby.

Parametry — vrácení DPH (POST/PUT)

Parametr	Povinnost	Formát a význam
`idFaktury`	povinný	Identifikátor faktury, pro kterou se vytváří pomocný doklad. Formát `Long`.
`rok`	povinný	Rok období DPH. Formát `Integer`.
`mesic`	volitelný*	Měsíc období DPH. Formát `Integer` (1–12).
`ctvrtleti`	volitelný*	Čtvrtletí období DPH. Formát `Integer` (1–4).
`koeficient`	nepovinný	Koeficient pro výpočet DPH, formát `Double`. Využije se jen v případě české legislativy, a to když zdrojová faktura obsahuje řádek krácení DPH a doklad se vytváří v jiném roce, než ve kterém je datum zdanitelného plnění. Pokud by se koeficient měl využít a není zadán, použije se výchozí hodnota `100`.

Parametry — uplatnění DPH (POST/PUT)

Stejné parametry jako u vrácení DPH, navíc je nutné určit úhradu:

Parametr	Povinnost	Formát a význam
`idFaktury`	povinný	Identifikátor zdrojové faktury. Formát `Long`.
`idUhrady`	povinný	Identifikátor úhrady. Formát `Long`.
`rok`, `mesic`, `ctvrtleti`, `koeficient`	viz výše	Chovají se stejně jako u vrácení DPH.

Formát odpovědi

Při úspěšném vytvoření pomocného dokladu vrací služba odpověď ve formátu JSON nebo XML obsahující:

success — indikátor úspěchu operace (true/false),
stats — statistiky importu, mezi nimi created s počtem vytvořených dokladů,
results — pole výsledků s id vytvořeného dokladu a ref odkazem na něj.

Ukázky volání

Přehled neuhrazených dokladů po splatnosti — za březen 2024, respektive za druhé čtvrtletí 2024:

GET https://demo.flexibee.eu/c/demo/neuhrazene-po-splatnosti.xml?rok=2024&mesic=3
GET https://demo.flexibee.eu/c/demo/neuhrazene-po-splatnosti.json?rok=2024&ctvrtleti=2

Vytvoření pomocného dokladu pro vrácení DPH — pro fakturu ID 12345 za březen 2024 a s koeficientem 0,95:

POST https://demo.flexibee.eu/c/demo/neuhrazene-po-splatnosti/vraceni-dph.json?rok=2024&mesic=3&idFaktury=12345
PUT  https://demo.flexibee.eu/c/demo/neuhrazene-po-splatnosti/vraceni-dph.xml?rok=2024&ctvrtleti=1&idFaktury=12345&koeficient=0.95

Přehled dokladů pro obnovu DPH a vytvoření pomocného dokladu pro uplatnění DPH — pro fakturu ID 67890 s úhradou ID 54321:

GET  https://demo.flexibee.eu/c/demo/neuhrazene-po-splatnosti-2.xml?rok=2024&mesic=5
POST https://demo.flexibee.eu/c/demo/neuhrazene-po-splatnosti-2/uplatneni-dph.json?rok=2024&mesic=5&idFaktury=67890&idUhrady=54321

FAQ

Kde najdu dokumentaci k aplikaci?

Službu lze použít v desktopové aplikaci i ve webovém rozhraní.

Existuje dokumentace k jiným účetním výstupům?

Ano, naleznete ji v článku Účetní výstupy v REST API.

Jak přes API vygenerovat stav neuhrazených faktur?

Postup je popsán v článku Stav úhrad k datu - REST API.

Související

Související články

Neuhrazené závazky 6 měsíců po splatnosti - REST API