Výpis, úprava, schválení a zamítnutí výdajů a výpis jejich položek. Prostředí, klíč v hlavičce X-Api-Key, stránkování a čtení tabulek popisuje Public API – základy. Dokumentace odpovídá stavu API k 6. 8. 2026.
POST /v2/expense/approve-expenses
Public API klíč musí být vystaven na uživatele Fidoo, který disponuje klíčovou rolí Účetní, případně kombinací rolí Hlavní správce a Účetní. Práva rolí se přenášejí na vystavený API klíč.
Umožňuje hromadné schválení výdajů. V případě dvouúrovňového schvalování jsou povolené následující přechody stavů: approve (Ke schválení) → approve2 (K 2. schválení), approve2 (K 2. schválení) → accountantApprove (K uzavření), accountantApprove (K uzavření) → personalBill (Uzavřený). V případě jednoúrovňového schvalování jsou povolené následující přechody stavů: approve (Ke schválení) → accountantApprove (K uzavření), accountantApprove (K uzavření) → personalBill (Uzavřený).
Vracena jsou všechna expenseId z přijatého bulku. Pakliže dojde k úspěšnému schválení výdaje, je expenseId doplněno o parametr state, který potvrdí nový stav, do kterého výdaj přešel. V opačném případě je expenseId doplněno o parametr errorMessage a parametr state, který potvrdí nezměněný stav. Všechna neschválená expenseId jsou současně vypsána v seznamu parametru failedExpenseIds. V obou případech je výsledný stav uveden pod parametrem status.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
expenses (povinné) | Výpis výdajů. | – |
· expenseId (povinné) | Unikátní identifikátor výdaje v systému Fidoo. maximální limit je 50 expenseId na 1 volání. expenseId lze v rámci 1 volání opakovat, při n opakování dojde k posunu o n stavů. | f9505cc7-46aa-4749-bcf4-bc2b7144d3c9 |
Vrácené parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
expenses | Výpis výdajů. | – |
· errorMessage | Chybová zpráva pro konkrétní expenseId. Když bez chyby, pak je vráceno null. | Expense state not allowed: prepare |
· expenseId | Unikátní identifikátor výdaje v systému Fidoo. | f9505cc7-46aa-4749-bcf4-bc2b7144d3c9 |
· state | Výsledný stav výdaje. Hodnoty: approve = Ke schválení (Výdaj čekající na schválení prvním schvalovatelem); approve2 = K 2. schválení (Výdaj čekající na schválení druhým schvalovatelem); accountantApprove = K uzavření (Výdaj čekající na uzavření účetní); personalBill = Uzavřený (Uzavřený výdaj otevřeného osobního vyúčtování účetní, Čeká na uzavření celého vyúčtování účetní; prepare = Otevřený (Nový výdaj, který je doposud nezpracovaný nebo vrácený zpět uživateli); export = Vyúčtovaný (Vyúčtovaný výdaj připravený k prvnímu exportu v Účetní agendě); exported = Exportovaný (Exportovaný výdaj v Účetní agendě). | accountantApprove |
metadata | Výpis metadat. | – |
· status | Výsledný stav za celé volání. Hodnoty: SUCCESS = všechny výdaje jsou schváleny; FAILED = žádný z výdajů není schválen; PARTIAL_SUCCESS = alespoň jeden výdaj není schválen, ostatní výdaje schváleny. | PARTIAL_SUCCESS |
· errorId | Unikátní identifikátor chybového stavu v systému Fidoo. Když bez chyby, pak je vráceno null. | prod-f1b46317-cc6c-45fc-ae70-5b9f553c92bb |
· timestamp | Časové razítko provedení operace. Uvedeno ve formátu ISO 8601. | 2023-08-24T22:00:00.000Z |
· failedExpenseIds | Seznam unikátních identifikátorů výdajů v systému Fidoo odeslaných ke schválení, u kterých nedošlo ke schválení. | f9505cc7-46aa-4749-bcf4-bc2b7144d3c9 |
POST /v2/expense/edit-expense
Umožňuje změnu názvu stávajícího výdaje nebo zadat externalReferenceId k výdaji.
Je vráceno potvrzení o požadované změně.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
expenseId (povinné) | Unikátní identifikátor výdaje v systému Fidoo. | f9505cc7-46aa-4749-bcf4-bc2b7144d3c9 |
name | Název výdaje. | Oběd s klientem |
externalReferenceId | Externí ID výdaje. | LX-234 |
POST /v2/expense/get-expenses
Lze zjistit podrobnosti o výdaji; např. název, částku v původní měně, účetní kategorii, předkontaci, zda obsahuje položky aj.
Je vrácen výpis výdajů vytvořených konkrétním uživatelem či v daném časovém rozpětí.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
ownerId | Unikátní identifikátor uživatele v systému Fidoo, který je vlastníkem výdaje. | 30dcca40-9858-4139-9230-bb86d97cf64e |
from | Počáteční datum pro filtrování výdajů. Uveden ve formátu ISO 8601. | 2023-04-01T01:00:00Z |
to | Konečné datum pro filtrování výdajů. Uveden ve formátu ISO 8601. | 2023-04-30T23:59:99Z |
lastModifyFrom | Datum pro filtrování výdajů podle poslední úpravy. Uvedeno ve formátu ISO 8601. | 2023-08-29T17:52:34Z |
closed | Indikátor možnosti pozdějších úprav na výdajích. Hodnoty: true = uzavřený výdaj umožňující pouze čtení (vrátí výdaje ve stavu: export / exported / cancelled / atmClosed / cashClosed / migrated); false = otevřený výdaj umožňující úpravy (vrátí výdaje ve stavu: prepare / approve / approve2 / accountantApprove / personalBill); null = výdaj bez specifikace možných úprav (vrátí výdaje ve stavu: prepare / approve / approve2 / accountantApprove / personalBill / export / exported / migrated). | false |
state | Stav výdaje. Hodnoty: prepare = Otevřený (Nový výdaj, který je doposud nezpracovaný nebo vrácený zpět uživateli); approve = Ke schválení (Výdaj čekající na schválení prvním schvalovatelem); approve2 = K 2. schválení (Výdaj čekající na schválení druhým schvalovatelem); accountantApprove = K uzavření (Výdaj/Cesťák–zpráva čekající na uzavření účetní); personalBill = Uzavřený (Uzavřený výdaj otevřeného osobního vyúčtování účetní, Čeká na uzavření celého vyúčtování účetní; export = Vyúčtovaný (Vyúčtovaný výdaj a připravený k prvnímu exportu v Účetní agendě); exported = Exportovaný (Exportovaný výdaj v Účetní agendě). | prepare |
limit | Maximální počet vrácených řádků. Výchozí hodnota je 100. | 100 |
offsetToken | Klíč pro vícenásobné volání. Uveden jako hodnota parametru nextOffsetToken vraceného do nabytí stavu "complete": true. | T101 |
travelReportId | Unikátní identifikátor zprávy o služební cestě (cesťáku) v systému Fidoo. Když ID je přítomno, pak není aplikován filtr v parametru travelReportPresent. Když null, pak je aplikován filtr v parametru travelReportPresent. | 331a0bd0-0f95-11ea-8d71-362b9e155667 |
travelReportPresent | Indikátor výdajů propojených s cesťáky-zprávami. aplikován pouze v případě, kdy není aplikován filtr v parametru travelReportId. Hodnoty: null = všechny výdaje (propojené a nepropojené); true = pouze propojené výdaje; false = pouze nepropojené výdaje. | true |
type | Filtr podle typu výdaje. Hodnoty: null = všechny typy výdajů (hotovostní a karetní); manual = pouze hotovostní výdaje; card-transaction = pouze karetní výdaje. | manual |
Vrácené parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
complete | Stav dokončení kompletního výpisu. Hodnoty: true = výpis je kompletní (dokončen); false = výpis není kompletní (lze pokračovat v provolání). | false |
nextOffsetToken | Klíč pro vícenásobné volání. | T101 |
expenseList | Výpis výdajů. | – |
· expenseId | Unikátní identifikátor výdaje v systému Fidoo. | r6417d750-2f6a-11e9-b210-d663bd873d93 |
· ownerUserId | Unikátní identifikátor uživatele v systému Fidoo, který je vlastníkem výdaje. | 30dcca40-9858-4139-9230-bb86d97cf64e |
· dateTime | Časové razítko vytvoření výdaje. Uvedeno ve formátu ISO 8601. | 2023-08-24T11:32:48.478Z |
· lastEditDateTime | Časové razítko poslední úpravy výdaje. Uvedeno ve formátu ISO 8601. | 2023-08-29T17:52:48.478Z |
· name | Název výdaje. | Lístek na vlak |
· classState | Zjednodušený stav výdaje. Hodnoty: open = (výdaje ve stavu: prepare); sent = (výdaje ve stavu: approve / approve2); approved = (výdaje ve stavu: accountantApprove / personalBill / export / exported); other. | open |
· type | Typ výdaje. Hodnoty: manual = Hotovostní výdaj; card-transaction = Karetní výdaj. | manual |
· amount | Celková částka. Uvedená v měně původní. | 550 |
· amountCzk | Celková částka. Uvedená v měně CZK (Korunách českých). | 550 |
· currency | Měna transakce. Uvedena ve formátu ISO 4217. | CZK |
· shortId | Zkrácený identifikátor výdaje. | EX-10 |
· receiptIds | Unikátní identifikátory připojených účtenek k výdaji v systému Fidoo. | 07dcca40-9858-4139-9230-bb86d97cf64e |
· companyExpense | Částka firemního výdaje. | 420 |
· privateAmount | Součet všech soukromých výdajů. | 30 |
· cardId | Unikátní identifikátor karty v systému Fidoo. | b16d2df4-5c28-4b90-9a8a-a88c3258fa53 |
· travelReportId | Unikátní identifikátor zprávy o služební cestě (cesťáku) v systému Fidoo. | 331a0bd0-0f95-11ea-8d71-362b9e155667 |
· vatAmount | Výše DPH. | 88.2 |
· vatRate | Sazba DPH. Uváděn ve škále 0–1. | 0.21 |
· taxBase | Částka bez DPH (základ). | 331.8 |
· accountCode | Kód předkontace pro základ daně normal. | PHM |
· accountCredit | Hodnota DAL předkontace pro základ daně. | 450 |
· accountDebit | Hodnota MÁ DÁTI předkontace pro základ daně. | 320 |
· vatAccountCode | Kód předkontace pro DPH vat. | DPH21 |
· vatAccountCredit | Hodnota DAL předkontace pro DPH. | 20 |
· vatAccountDebit | Hodnota DPH pro MÁ DÁTI předkontace pro DPH. | 10 |
· costCenterIds | Unikátní identifikátory nákladových středisek v systému Fidoo připojených k výdaji. | a787d2f0-f261-4618-b7d1-7c9ad71c73e6 |
· projectIds | Unikátní identifikátory projektů v systému Fidoo připojených k výdaji. | a787d2f0-f261-4618-b7d1-7c9ad71c73e6 |
· vatBreakDownId | Unikátní identifikátor členění DPH v systému Fidoo. | a787d2f0-f261-4618-b7d1-7c9ad71c73e6 |
· taxableDate | Datum zdanitelného plnění. | 2023-08-24 |
· merchantIdentificationNumber | IČ obchodníka. | 4566544 |
· merchantVatId | DIČ obchodníka. | CZ4566544 |
· merchantName | Název obchodníka. | CESKE DRAHY, A.S. |
· merchantCategory | Kategorie obchodníka. Hodnoty: beauty = Krása; bills-and-household = Domácnost; car = Auto; children = Děti; consumer-goods = Spotřební zboží; culture = Kultura; digital-services = Digitální služby; drugstore = Drogerie; electronics = Elektronika; fashion = Móda; financial-services = Finanční služby; food-and-drink = Stravování; freetime = Zábava; groceries = Potraviny; health = Zdraví; house-and-garden = Dům a zahrada; pets = Mazlíčci; professional-services = Služby; shopping-online = Nakupování na internetu; sport = Sport; travel = Cestování; other = Ostatní. | travel |
· merchantAddress | Adresa obchodníka. | Ječná 1 |
· cardTransactionId | Unikátní identifikátor karetní transakce v systému Fidoo. | 7fec49fb-7e1d-4d2a-9ddb-d5377040cb45 |
· exchangeRate | Měnový kurz. | 23.4244 |
· description | Poznámka výdaje. | Lístek 1. třídy a doplatek za psa |
· state | Stav výdaje. Hodnoty: prepare = Otevřený (Nový výdaj, který je doposud nezpracovaný nebo vrácený zpět uživateli); approve = Ke schválení (Výdaj čekající na schválení prvním schvalovatelem); approve2 = K 2. schválení (Výdaj čekající na schválení druhým schvalovatelem); accountantApprove = K uzavření (Výdaj čekající na uzavření účetní); personalBill = Uzavřený (Uzavřený výdaj otevřeného osobního vyúčtování účetní, Čeká na uzavření celého vyúčtování účetní; export = Vyúčtovaný (Vyúčtovaný výdaj připravený k prvnímu exportu v Účetní agendě); exported = Exportovaný (Exportovaný výdaj v Účetní agendě). | prepare |
· closed | Indikátor možnosti pozdějších úprav na výdajích. Hodnoty: true = uzavřený výdaj umožňující pouze čtení (vrátí výdaje ve stavu: export / exported / cancelled / atmClosed / cashClosed / migrated); false = otevřený výdaj umožňující úpravy (vrátí výdaje ve stavu: prepare / approve / approve2 / accountantApprove / personalBill); null = otevřený výdaj umožňující úpravy (vrátí výdaje ve stavu: prepare / approve / approve2 / accountantApprove / personalBill / export / exported / migrated). | false |
· receiptUrls | Veřejný URL odkaz pro stažení souboru s účtenkou. | https://api-dev.fidoo.com/doc/download/A4DB7PArSUzGrwVwl8zZlAlWPFjlvD5ASroDEp9FQx8k |
· originalTaxDocumentNumber | Původní číslo daňového dokladu. | FV202103 |
· externalReferenceId | Externí ID výdaje. | LX-234 |
· pairingKey | ID výdaje. | EX-007 |
· accountingCategory | Výpis detailu o Účetní kategorii. | – |
·· id | Unikátní identifikátor účetní kategorie v systému Fidoo. | 0aa54c71-aca4-43ba-8107-89daaf4e8fa2 |
·· accountAssignment | Výpis detailu o Předkontaci. | – |
··· id | Unikátní identifikátor předkontace v systému Fidoo. | 07dcca40-9858-4139-9230-bb86d97cf64e |
··· code | Jedinečný kód předkontace na úrovni společnosti. | NS001 |
··· name | Název předkontace. | Veřejná doprava |
··· description | Vysvětlivka k předkontaci. | Jízda vlakem, autobusem, sdíleným kolem… |
··· debit | Účet Má dáti. | 518001 |
··· credit | Účet Dal. | 321000 |
··· type | Typ předkontace. Hodnoty: normal = Základ daně; vat = DPH. | vat |
··· state | Stav předkontace. Hodnoty: active = aktivní (zobrazena v nabídce); inactive = neaktivní (skryta z nabídky); deleted = trvale smazána. | active |
·· code | Jedinečný kód účetní kategorie na úrovni společnosti. | DO23 |
·· name | Název účetní kategorie. | Doprava |
·· state | Stav účetní kategorie. Hodnoty: active = aktivní (zobrazena v nabídce); inactive = neaktivní (skryta z nabídky); deleted = trvale smazána. | active |
· hasItems | Indikátor, zda výdaj obsahuje položky. Hodnoty: true = výdaj obsahuje položky; false = výdaj neobsahuje položky. | false |
POST /v2/expense/get-expense-items
Lze zjistit podrobnosti o položkách konkrétního výdaje; např. název, částku v původní měně, účetní kategorii, předkontaci, projekt, nákladové středisko aj.
Je vrácen výpis položek konkrétního výdaje.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
expenseId (povinné) | Unikátní identifikátor výdaje v systému Fidoo. | r6417d750-2f6a-11e9-b210-d663bd873d93 |
Vrácené parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
items | Výpis. | – |
· expenseItemId | Unikátní identifikátor položky výdaje v systému Fidoo. | 9716297e-9279-4fff-918f-b257eb520c7c |
· expenseId | Unikátní identifikátor výdaje v systému Fidoo. | r6417d750-2f6a-11e9-b210-d663bd873d93 |
· name | Název položky výdaje. | Lístek do 1. třídy |
· amount | Částka v původní měně. | 420 |
· taxBase | Částka bez DPH (základ). | 331.8 |
· vatAmount | Výše DPH. | 88.2 |
· vatRate | Sazba DPH. | 0.21 |
· type | Typ položky výdaje. Hodnoty: simple = s nevyplněným pole DPH Předkontace; vat = s vyplněným pole DPH Předkontace; private = vyřazený typ pro soukromé výdaje. | simple |
· accountCode | Kód předkontace. | PHM |
· accountCredit | Hodnota DAL. | 450 |
· accountDebit | Hodnota MÁ DÁTI. | 320 |
· vatAccountCode | Kód DPH dané předkontace. | DPH21 |
· vatAccountCredit | Hodnota DPH pro DAL. | 20 |
· vatAccountDebit | Hodnota DPH pro MÁ DÁTI. | 10 |
· costCenterIds | Unikátní identifikátory nákladových středisek v systému Fidoo připojených k výdaji. | a787d2f0-f261-4618-b7d1-7c9ad71c73e6 |
· projectIds | Unikátní identifikátory projektů v systému Fidoo připojených k výdaji. | a787d2f0-f261-4618-b7d1-7c9ad71c73e6 |
· vatBreakDownId | Unikátní identifikátor členění DPH v systému Fidoo. | a787d2f0-f261-4618-b7d1-7c9ad71c73e6 |
· accountingCategory | Výpis detailu o Účetní kategorii. | – |
·· id | Unikátní identifikátor účetní kategorie v systému Fidoo. | 0aa54c71-aca4-43ba-8107-89daaf4e8fa2 |
·· accountAssignment | Výpis detailu o Předkontaci. | – |
··· id | Unikátní identifikátor předkontace v systému Fidoo. | 07dcca40-9858-4139-9230-bb86d97cf64e |
··· code | Jedinečný kód předkontace na úrovni společnosti. | NS001 |
··· name | Název předkontace. | Veřejná doprava |
··· description | Vysvětlivka k předkontaci. | Jízda vlakem, autobusem, sdíleným kolem… |
··· debit | Účet Má dáti. | 518001 |
··· credit | Účet Dal. | 321000 |
··· type | Typ předkontace. Hodnoty: normal = Základ daně; vat = DPH. | vat |
··· state | Stav předkontace. Hodnoty: active = aktivní (zobrazena v nabídce); inactive = neaktivní (skryta z nabídky); deleted = trvale smazána. | active |
·· code | Jedinečný kód účetní kategorie na úrovni společnosti. | DO23 |
·· name | Název účetní kategorie. | Doprava |
·· state | Stav účetní kategorie. Hodnoty: active = aktivní (zobrazena v nabídce); inactive = neaktivní (skryta z nabídky); deleted = trvale smazána. | active |
POST /v2/expense/reject-expenses
Public API klíč musí být vystaven na uživatele Fidoo, který disponuje klíčovou rolí Účetní, případně kombinací rolí Hlavní správce a Účetní. Práva rolí se přenášejí na vystavený API klíč.
Umožňuje hromadné zamítnutí výdajů. V případě dvouúrovňového schvalování jsou povolené následující přechody stavů: approve (Ke schválení) → prepare (Otevřený–vrácený), approve2 (K 2. schválení) → prepare (Otevřený–vrácený), accountantApprove (K uzavření) → prepare (Otevřený–vrácený). V případě jednoúrovňového schvalování jsou povolené následující přechody stavů: approve (Ke schválení) → prepare (Otevřený–vrácený), accountantApprove (K uzavření) → prepare (Otevřený–vrácený).
Vracena jsou všechna expenseId z přijatého bulku. Pakliže dojde k úspěšnému zamítnutí výdaje, je expenseId doplněno o parametr state, který potvrdí nový stav, do kterého výdaj přešel. V opačném případě je expenseId doplněno o parametr errorMessage a parametr state, který potvrdí nezměněný stav. Všechna nezamítnutá expenseId jsou současně vypsána v seznamu parametru failedExpenseIds. V obou případech je výsledný stav uveden pod parametrem status.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
expenses (povinné) | Výpis výdajů. | – |
· expenseId (povinné) | Unikátní identifikátor výdaje v systému Fidoo. maximální limit je 50 expenseId na 1 volání. | f9505cc7-46aa-4749-bcf4-bc2b7144d3c9 |
· note (povinné) | Důvod zamítnutí výdaje. | Vydána stravenka |
Vrácené parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
expenses | Výpis výdajů. | – |
· errorMessage | Chybová zpráva pro konkrétní expenseId. Když bez chyby, pak je vráceno null. | Expense state not allowed: exported |
· expenseId | Unikátní identifikátor výdaje v systému Fidoo. | f9505cc7-46aa-4749-bcf4-bc2b7144d3c9 |
· state | Výsledný stav výdaje. Hodnoty: prepare = Otevřený (Nový výdaj, který je doposud nezpracovaný nebo vrácený zpět uživateli); approve = Ke schválení (Výdaj čekající na schválení prvním schvalovatelem); approve2 = K 2. schválení (Výdaj čekající na schválení druhým schvalovatelem); accountantApprove = K uzavření (Výdaj čekající na uzavření účetní); personalBill = Uzavřený (Uzavřený výdaj otevřeného osobního vyúčtování účetní, Čeká na uzavření celého vyúčtování účetní; export = Vyúčtovaný (Vyúčtovaný výdaj připravený k prvnímu exportu v Účetní agendě); exported = Exportovaný (Exportovaný výdaj v Účetní agendě). | prepare |
metadata | Výpis metadat. | – |
· status | Výsledný stav za celé volání. Hodnoty: SUCCESS = všechny výdaje jsou zamítnuty; FAILED = žádný z výdajů není zamítnut; PARTIAL_SUCCESS = alespoň jeden výdaj není zamítnut, ostatní výdaje zamítnuty. | PARTIAL_SUCCESS |
· errorId | Unikátní identifikátor chybového stavu v systému Fidoo. Když bez chyby, pak je vráceno null. | prod-f1b46317-cc6c-45fc-ae70-5b9f553c92bb |
· timestamp | Časové razítko provedení operace. Uvedeno ve formátu ISO 8601. | 2023-08-24T22:00:00.000Z |
· failedExpenseIds | Seznam unikátních identifikátorů výdajů v systému Fidoo odeslaných k zamítnutí, u kterých nedošlo k zamítnutí. | f9505cc7-46aa-4749-bcf4-bc2b7144d3c9 |
Byl tento článek užitečný?