Popis služby
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 - vytvoření pomocného dokladu pro vrácení DPH neuhrazených dokladů
Uplatnění DPH - vytvoření pomocného dokladu pro opětovné uplatnění DPH u nyní již uhrazených dokladů
Uživatel nejprve vybírá měsíc/čtvrtletí a rok, podle čehož se mu nabídnou faktury. Pro vybrané faktury může vytvořit pomocné doklady, přičemž pro každou fakturu vznikne jeden doklad u vrácení DPH. U uplatnění DPH vznikne jeden doklad pro kombinaci faktury a úhrady.
Dostupné endpointy
1. Vrácení DPH neuhrazených dokladů
Přehled dokladů:
Dostupná HTTP metoda: GET
Adresa: /c/{firma}/neuhrazene-po-splatnosti.{přípona}
Vytvoření pomocného dokladu:
Dostupné HTTP metody: POST, PUT
Adresa: /c/{firma}/neuhrazene-po-splatnosti/vraceni-dph.{přípona}
2. Uplatnění DPH uhrazených dokladů
Přehled dokladů:
Dostupná HTTP metoda: GET
Adresa: /c/{firma}/neuhrazene-po-splatnosti-2.{přípona}
Vytvoření pomocného dokladu:
Dostupné HTTP metody: POST, PUT
Adresa: /c/{firma}/neuhrazene-po-splatnosti-2/uplatneni-dph.{přípona}
Kde:
{firma} - databázový identifikátor firmy
{přípona} - formát výstupu (
xml,json)
Parametry
Všechny endpointy akceptují následující parametry:
1. Přehled dokladů (GET)
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:MneboMM(např.3nebo03pro březen)ctvrtleti- volitelný*: Čtvrtletí, pro které se mají doklady zobrazit. Možné hodnoty:1,2,3,4
2. Vytvoření pomocného dokladu - vrácení DPH (POST/PUT)
idFaktury- povinný: Identifikátor faktury, pro kterou se vytváří pomocný doklad. Formát:Longrok- povinný: Rok období DPH. Formát:Integermesic- 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:DoubleVyužije se jen v případě české legislativy
Použije se 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
3. Vytvoření pomocného dokladu - uplatnění DPH (POST/PUT)
idFaktury- povinný: Identifikátor zdrojové faktury. Formát:LongidUhrady- povinný: Identifikátor úhrady. Formát:Longrok- povinný: Rok období DPH. Formát:Integermesic- 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:DoubleVyužije se jen v případě české legislativy
Použije se 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
* Musí být zadán buď parametr mesic nebo ctvrtleti, ne oba současně.
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 importucreated- počet vytvořených dokladů
results- pole výsledkůid- identifikátor vytvořeného dokladuref- odkaz na vytvořený doklad
Ukázky volání
1. Získání přehledu neuhrazených dokladů po splatnosti
Doklady za březen 2024:
GET https://demo.flexibee.eu:5434/c/demo/neuhrazene-po-splatnosti.xml?rok=2024&mesic=3
Doklady za druhé čtvrtletí 2024:
GET https://demo.flexibee.eu:5434/c/demo/neuhrazene-po-splatnosti.json?rok=2024&ctvrtleti=2
2. Vytvoření pomocného dokladu pro vrácení DPH
Vrácení DPH pro fakturu ID 12345 za březen 2024:
POST https://demo.flexibee.eu:5434/c/demo/neuhrazene-po-splatnosti/vraceni-dph.json?rok=2024&mesic=3&idFaktury=12345
Vrácení DPH s koeficientem 0.95:
PUT https://demo.flexibee.eu:5434/c/demo/neuhrazene-po-splatnosti/vraceni-dph.xml?rok=2024&ctvrtleti=1&idFaktury=12345&koeficient=0.95
3. Získání přehledu dokladů pro obnovu DPH
GET https://demo.flexibee.eu:5434/c/demo/neuhrazene-po-splatnosti-2.xml?rok=2024&mesic=5
4. Vytvoření pomocného dokladu pro uplatnění DPH
Uplatnění DPH pro fakturu ID 67890 s úhradou ID 54321:
POST https://demo.flexibee.eu:5434/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 na našem webu.
Jak přes API vygenerovat stav neuhrazených faktur?
Postup je popsán v naší dokumentaci.