iDoklad Rest API v2

Úvod

Dokumentace API pro iDoklad

Changelog

Poslední změny

06.11.2023

Změna nastavení pro refresh tokeny. Více info v HTTP návratové kódy

25.09.2019

Přidány endpointy GET/ProformaInvoices/{id}/Account, který vrátí novou vydanou fakturu určenou pro vyúčtování zálohové faktury, a POST/IssuedInvoices/Accounting, který uloží novou vydanou fakturu a použije ji pro vyúčtování zálohové faktury.

18.09.2019

Do modelu SalesReceiptApiModelExpand pro GET/SalesReceipts/{id}/Expand a GET/SalesReceipts/Expand přídán Partner

28.08.2019

Přidány metody pro vytoření kopie faktury přijate, vydané a zálohové. Resp. ReceivedInvoices/{id}/Copy, IssuedInvoices/{id}/Copy, ProformaInvoices/{id}/Copy

17.07.2019

Přidána možnost odesílat poděkování za úhradu.
Do modelu pro POST/IssuedInvoicePayments přídán SentPaymenntConfirmation
Přidán endpoint POST/Mails/IssuedDocumentPayments/SendConfirmation/{id}

20.03.2018

Přidány metody pro práci s e-maily.
Přidány metody pro práci s tiskovými sestavami.
Přidán číselník kódů plnení - VatReverseChargeCodes.
Přidány metody pro práci s bankovními výpisy včetně párování.

07.02.2018

Pokladní doklady jsou nyní vícepoložkové. Kvůli zpětné kompatibilitě byla ponechána i stará vlastnost Item, která vždy vrací první položku. Pokud chcete přes API používat vícepoložkové pokladní doklady, použijte novou vlastnost Items. Pro update byla přidána metoda PATCH. Metoda PUT funguje nadále jenom pro jednopoložkové doklady.
Na prodejkách přibyl odběratel. Do GET modelů byly přidány adresy odběratele a dodavatele, do POST modelu id odběratele (PartnerId).

14.12.2017

Do dokumentace byly přidány filtry na legislativu a zastaralé vlastnosti. Tyto filtry nemají vliv na chování API, jenom na to, co je vidět v dokumentaci. Se zastaralými vlastnostmi v budoucích verzích API nelze počítat, ale v API v2 budou fungovat nadále.
Opraveny endpointy Agendas pro správné fungování s víceuživatelským přístupem. Přibyl taky endpoint Agendas/Current.
Přidány endpointy pro přílohy Attachments/GET, Attachments/PUT a Attachments/DELETE, které fungují pro všechny podporované entity na základě id a typu dokumentu. Existující endpointy pro přílohy byly označeny za zastaralé.

04.10.2017

Do GET metod faktur byly přidány filtry na id kontaktu odběratele (PurchaserId) nebo dodavatele (SupplierId).

30.08.2017

Přidány metody pro práci se skladovými pohyby
Optimalizace rychlosti metod GetExpand
Opravena logika dat u ReceivedInvoices/POST. DateOfMaturity a DateOfTaxing se špatně vyplňovaly vždy podle DateOfIssue. Nevyplněný DateOfIssue se už nenaplní aktuálním datem. Nevyplněný DateOfTaxing se už nenaplní podle DateOfReceiving
Další vylepšení dokumentace

27.06.2017

Oprava chyb u PUT/PATCH
Přidaná položka BarCode do modelu ceníku (GET, POST, PATCH)

10.04.2017

Vylepšení dokumentace - přidány sekce changelog a často kladené dotazy
Přidán stav skladu do modelu ceníku
Mazání ceníkové položky: Při specifikování deleteIfReferenced=false se nesmažou ani exportováné položky
Model prodejky - přidány údaje související se zaúčtováním prodejek: IsAccounted, CashVoucherItemId
Model pokladního dokladu - přidány údaje související se zaúčtováním prodejek: IsSummarySalesReceipt, SummarySalesReceiptDate

24.01.2017

Oprava - odstranění kontroly na unikátnost ID položky aktualizovaného dokladu (znemožňovalo přidat více než jednu novou položku)

10.01.2017

U vydaných faktur, zálohových faktur a dobropisů přidaná podpora pro více číselných řad
U vydaných faktur, zálohových faktur a dobropisů přidaná podpora pro přílohy. Přílohy fungují stejně jako u faktur přijatých

Quick start

Pro okamžitý začátek práce s API

Postman

Pro snadnou komunikaci a rychlý start jsme pro Vás připravili Postman kolekci dotazů. Během několika minut můžete začít pracovat s Vašimi daty.

1. Stáhnutí |
2. Načtení kolekce |
3. Nastavení prostředí klienta |
4. Získání access tokenu a poslání dotazu |

Pro přístup k datům pomocí aplikace doporučujeme REST API klienta Postman.

Další krok »

Hlavní endpoint pro přístup k API

https://api.idoklad.cz
Např.: https://api.idoklad.cz/v2/IssuedInvoices

Rozdíly oproti API v1

Api verze 2 využívá místo secure tokenu standard OAuth2. Pro zavolání API musíte mít tzv. access token. Pro vyzkoušení API v2 doporučujeme použít získání tokenu pomocí Client Credentials a program Postman. Víc detailů najdete v sekci Autorizace.

Získání seznamů faktur

Zavolejte GET metodu api/v2/IssuedInvoices doc
Odpověď requestu bude obsahovat seznam faktur v poli Data

Vytvoření faktury

Zavolejte api/v2/IssuedInvoices/Default doc
Metoda vrátí předvyplněný objekt faktury s výchozím nastavením uživatele
Vyplňte požadovaná data objektu
Vyplněný objekt serializujte do Body parametru requestu
Zavolání POST metody api/IssuedInvoices doc
Požadavek vrátí fakturu i s nově přepočítanými hodnotami

Obecná pravidla

Konvence a zpětná kompatibilita

HTTP návratové kódy

Signalizující úspěch:

200 OK. Součástí response bývá obvykle vzniklá entita nebo výsledek operace, je-li potřeba.

Signalizující neúspěch:

Model nesplňuje validaci (400 Bad Request).
Entita nebyla nalezena (404 not found)
Překročení limitu (429 Too Many Requests). V hlavičce odpovědi je vrácena hodnot Retry-After v sekundách
Plánovaná odstávka aplikace (503 Service unavailable). Po dobu odstávky je API nedostupné.
Nespecifikovaná chyba (500 Internal Server Error) - v tomto případě nás kontaktujte. Nejrychleji vám pomůžeme, když pošlete celý request, který způsobuje chybu.

Související s předplatným iDokladu:

Expirovaný nebo nepostačující tarif (402 Payment Required)
Potřeba manuálního downgrade předplatného přes webové rozhrání (403)
Překročení limitu (429 Too Many Requests)

Související s autentizací:

Neautorizovaný přístup (401 Unauthorized). Při výskytu této chyby by se měla aplikace pokusit vyzvat uživatele k opětovnému přihlášení.
Neplatný refresh token (400 se správou "invalid_grant"). Refresh tokeny mohou expirovat či být zneplatněny. S každým požadavkem o access token je doručen i nový refresh token, který je nutné uložit a použít při další žádosti o access token. Při výskytu této chyby by se měla aplikace pokusit vyzvat uživatele k opětovnému přihlášení.

Zpětná kompatibilita

Klient API musí být připraven na následující:

Může přibýt (nepovinná) vlastnost na libovolný model.
Response bude obsahovat libovolný zdokumentovaný status kód, pokud v dané situaci dává smysl.

Klient API se může spoléhat na následující:

Nikdy nezmizí vlastnost z modelu. Výjimkou jsou major verze API (1.0/2.0/3.0), kde je vyžadovaná větší migrace a změny můžou být libovolné.
Nezmění se mu pod rukama chování, nezmění-li on posílaný model. Pod chováním se myslí:
- Změna návratového kódu, např. přidáním nové validace.
- Změna vráceného modelu, s výjimkou přidání nových vlastností.
Pod chováním se nemyslí např. změna algoritmu, jen formát jeho výstupu. Nevztěhuje se ani na opravy chyb.

Klient API se nemůže spoléhat na následující:

Nezdokumentované chování. Týká se hlavně POSTu, kde se některé vlastnosti automaticky berou z nastavení, i když nejsou vyplněny. Před POSTem by se měla použít metoda Default, která vrátí model dle nastavení. (Netýká se popsaných chování, jako jsou číselné řady a podobně.)

HTTP konvence

GET - získávání dat
PUT - změna existujících dat
PATCH - částečný update
POST - přidání nového záznamu
DELETE - smazání záznamu

Práce se seznamy

Všechny seznamy z API vracejí data zaobalena do objektu, který se skládá z:

Data - seznam požadovaných objektů
TotalItems - celkový počet záznamů pro request
TotalPages - počet stránek pro request

Stránkování

Pro stránkování v seznamech se používají parametry:

PageSize - počet položek na stránce
Page - číslo zobrazené stránky
Maximální množství záznamu na jedné strance je 200 a výchozí je 20 200 a výchozí je 20

Přidávání a úprava záznamu

Před POST-em nového záznamu si připravíte model dle vašich aktuálních nastavení pomocí metody Default. Ta vrací vždy model vhodný pro metodu POST. V tomhle modelu už stačí jenom provést potřebné změny a poslat ho.

PUT se používá pro úplný update záznamu a vyžaduje specifikovat všechny jeho vlastnosti. PATCH aktualizuje jenom to, co specifikujete. Je tedy jednodušší na použití a doporučujeme používat spíše PATCH než PUT.

Při použití requestů PUT, POST, PATCH a DELETE je potřeba přidat do hlavičky záznam Content-Type
Např.: Content-Type: application/json

Autorizace

Úvodní informace ohledně identifikace uživatele Api a uživatele iDokladu

Vzorovou kolekci pro autorizaci si můžete stáhnout zde.

Adresy

Služba	Url
iDoklad	https://app.idoklad.cz
API	https://api.idoklad.cz/v2
Doklad developer	https://developer.idoklad.cz/

Identity server endpoint	Url
Authorize endpoint	https://identity.idoklad.cz/server/connect/authorize
Token endpoint	https://identity.idoklad.cz/server/connect/token

OAuth2

Api iDokladu ve verzi 2 využívá autentizaci pomocí standardu OAuth2. Pro použití API je nutné získat tzv. access token, který se dá získat různými způsoby podle potřeb aplikace. iDoklad momentálně podporuje autentizaci pomocí následujících způsobů:

Authorization code flow
Client credentials flow
PIN flow (používané EET zařízeními)

Autentizace access tokenem
Každý request musí obsahovat hlavičku

Authorization: Bearer your_access_token

Authorization code flow:

Tento flow je vhodný pro aplikace, které potřebují data různých uživatelů. Aplikace zobrazí uživateli přihlašovací okno iDokladu, kde zadá své přihlašovací údaje, čímž povolí aplikaci pracovat s jeho daty.

Aplikace se musí registrovat na Developer portálu, kde získá své client id a client secret.
Získání samotného tokenu probíhá následovně:

Poslaní requestu na authorize endpoint

https://identity.idoklad.cz/server/connect/authorize
                ?scope=idoklad_api%20offline_access
                &client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
                &response_type=code
                &redirect_uri=http://test.test.com/

Parametr	Význam
scope	viz tabulka scopes
client_id	z Developer portálu
response_type	řetězec “code”
redirect_uri	adresa, na kterou přijde po přihlášení uživatele autorizační kód, který se vymění za access token. Adresa musí být přidaná do seznamu v Developer portálu (podrobnosti klienta - záložka redirect uris)

Přihlášení uživatele

Uživateli se otevře popup okno, kde se přihlásí do iDokladu. Po přihlášení bude přesměrovaný na adresu specifikovanou v redirect_uri.

Poslaní requestu na token endpoint

POST https://identity.idoklad.cz/server/connect/token
                grant_type=authorization_code
                &client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
                &client_secret=yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyy
                &scope=idoklad_api%20offline_access
                &code=70ae4b57d835d3755a59b3aa2a729546
                &redirect_uri=http://test.test.com/

Odpovědí na úspěšný request je access token (spolu s refresh tokenem, pokud byl vyžádán).

{
  "access_token": "eyJ0eXAi...",
  "expires_in": 6000,
  "token_type": "Bearer",
  "refresh_token": "abcd..."
}

Parametr	Význam
grant_type	řetězec “authorization_code”
client_id	z Developer portálu
response_type	z Developer portálu
scope	viz tabulka scopes
code	autorizační kód vrácený po přesměrování na redirect_uri. Kód lze použít jenom jednou. Chcete-li se vyhnout opakovanému přihlašování uživatele, použijte refresh token.
redirect_uri	adresa, která byla specifikována při requestu na authorize endpoint

Refresh token

POST https://identity.idoklad.cz/server/connect/token
                grant_type=refresh_token
                &client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
                &client_secret=yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyy
                &scope=idoklad_api%20offline_access
                &redirect_uri=http://test.test.com/
                &refresh_token=f4bcdc2e6d964f519cd74e2ac4a2105f

Parametr	Význam
grant_type	řeťezec “refresh_token”
refresh_token	z Developer portálu
ostatní	shodné s access token requestem

Client credentials flow

Každý uživatel si může v nastavení vygenerovat své client id a client secret bez potřeby registrovat se jako aplikace. Tyto údaje se nacházejí v nastavení uživatele. Použití client credentials je vhodné pouze v případech, kde je client secret bezpečně uložený, např. při server-to-server komunikaci. Je také jednoduchý na zprovoznění přes klienta Postman.

Access token

Parametr	Hodnota
scope	idoklad_api
grant_type	client_credentials
client_id	z nastavení iDokladu
client_secret	z nastavení iDokladu

Client credentials nepoužívá refresh token

Pin flow

POST https://app.idoklad.cz/identity/server/connect/token
                scope=eet+offline_access
                &client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
                &client_secret=yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyy
                &grant_type=pin
                &pin=12345678

Parametr	Hodnota
scope	eet offline_acccess
grant_type	pin
client_id	z Developer portálu
client_secret	z Developer portálu
pin	kód zařízení

Pozor

Při použití EET flow je důležité uložit si refresh token. Vygenerováním access tokenu se zařízení nastaví jako spárované a odpárování je možné jenom manuálně v iDokladu. Pro spárované zařízení nejde vyžádat nový access token jinak než přes refresh token.

POST https://identity.idoklad.cz/server/connect/token
    scope=eet+offline_access
    &client_id=a05743fa-f043-42f2-a26b-7c75194762d0
    &client_secret=510e5d46-0566-48b2-8e30-71a28abeb077
    &grant_type=refresh_token
    &refresh_token=397e08355318cc85dd890e3bc33b0cc1

Refresh token

Parametr	Hodnota
scope	eet offline_acccess
grant_type	refresh_token
refresh_token	hodnota refresh tokenu uděleného s prvním access tokenem
client_id	z Developer portálu
client_secret	z Developer portálu

* Při žádosti o refresh token se nemusí znovu specifikovat pin

Scopes

Scope	Význam
idoklad_api	univerzální scope pro read/write přístup do API
offline_access	potřebný pro udělení refresh tokenu
eet	používaný v eet pin flow

Filtrování

Syntax pro filtry

Url syntax

url/v2/controller/endpoint
   ?filter=FILTER_SYNTAX
    &sort=SORT_SYNTAX
    &page={int}
    &pagesize={int}

Parametr	Defaultní hodnota
filter	-
sort	id~asc
pagesize	20
page	1
filtertype	and

pořadí query parametrů je libovolné
může se uvést víc než jeden filtr na jednu vlastnost

Filter syntax

FILTER_SYNTAX = (
{PROPERTY_NAME}~{OPERATOR}~{PROPERTY_VALUE}
    ~and~ // ~or~
{PROPERTY_NAME}~{OPERATOR}~{PROPERTY_VALUE}
    ... )

Operátory

Operátor	Význam	Podporované datové typy
lt	<	int, datetime
lte	<=	int, datetime
gt	>	int, datetime
gte	>=	int, datetime
eq	==	všechny
!eq	!=	všechny
ct	contains	string, int
!ct	!contains	string

Vlastnosti typu enum je možné filtrovat i na základě textové hodnoty, např.:

movementType~eq~Received je ekvivalentní s movementType~eq~1

Sort syntax

{PROPERTY_NAME}~{SORT_ORDER}
        |  // oddělovač sortů
{PROPERTY_NAME}~{SORT_ORDER}

SORT_ORDER

Operátor	Význam
asc	ascending (123)
desc	descending (321)

Příklad konkrétního requestu:

GET
/v2/IssuedInvoices
   ?filter=DocumentNumber~ct~2016|Price~gt~50
    &sort=Id~desc
    &page=2
    &pagesize=30
    &filtertype=or

Seznam filtrovatelných vlastností entit je dostupný v podrobné dokumentaci.

FAQ

Často kladené dotazy

Autorizace

Dotaz:
Request na authorize endpoint mi vrací The requested resource does not support http method 'GET'

Odpověď:

Request na authorize endpoint je typu POST

Dotaz:
Request na token endpoint mi vrací "error": "invalid_scope"

Odpověď:

Prostudujte scopes v dokumentaci nebo ve vzorové Postman kolekci. Pozor na mezery.

Dotaz:
Request na token endpoint mi vrací "error": "invalid_client"

Odpověď:

Zkontrolujte:

Jestli se posílané údaje opravdu shodují (překlepy, extra mezery).
V případě client credentials se může stát, že jste je vygenerovali, ale neuložili nastavení.
V případě client credentials se může stát, že jste vygenerovali nové a uložili nastavení, které zneplatní ty staré.

Dotaz:
Request na token endpoint mi vrací "error": "invalid_grant"

Odpověď:

U authorization code (request na access token) - code získaný po přihlášení uživatele je jednorazový. Opakované použití vrátí tuto chybu.

Dotaz:
Request na token endpoint mi vrací "error": "unsupported_grant_type"

Odpověď:

Špatně vyplněná hlavička grant_type. Platné hodnoty najdete v dokumentaci nebo ve vzorové Postman kolekci.

Dotaz:
Kdy použít client id a client secret z Developer portálu a kdy z nastavení iDokladu?

Odpověď:

Údaje z Developer portálu identifikují aplikaci. Využijete je, když chcete vyvíjet napojení, která budou používat různí uživatelé iDokladu. Ti dávají aplikaci povolení pracovat s jejich daty (přihlášením). Samotná aplikace žádná data nevlastní. Účet na Developer portálu a účet na iDokladu nejsou svázány, a to ani v případě, že se shoduje přihlašovací e-mail.
Údaje z nastavení iDokladu identifikují konkrétní kombinaci firmy a uživatele. Lze je použít jen pro client credentials flow. Ideální je tedy použití pro práci s vlastními daty nebo v automatizovaném prostředí, kde se uživatel manuálně nepřihlašuje.

Jiné

Dotaz:
Tiskovka se mi vrátí v jiném jazyce, než bych chtěl.

Odpověď:

Pro většinu tiskovek lze použít HTTP header Accept-Lanuage. Akceptovanou hodnotou je jedna z en-US, de-DE, sk-SK a cs-CZ. U vydaných faktur, zálohových faktur a dobropisů se jazyk tiskovky řídí parametrem LanguageCode, se kterým byla faktura uložená.

Knihovny a rozšíření

My vývojáři táhneme za jeden provaz. Oceňujeme, že čím dál častěji sdílíte výsledky svého úsilí a vzájemně tak usnadňujete práci všem.

C#

SDK pro C# od Miroslava Holce najdete na jeho Githubu. Je také dostupný jako NuGet package.

PHP

Honza Malcánek vytvořil open source knihovnu pro snadné napojení PHP aplikací přes API iDokladu a dal ji všem volně k použití. Děkujeme mu, je to opravdu hodně dobrá práce! Najdete ji zde.

Jiné

Máte taky aplikaci nebo knihovnu využívající iDoklad? Zaregistrujte si ji zde!

Podrobná dokumentace

Všechno do posledního detailu.

Hlavné entity

Agendas

Metody pro práci s agendami.

GET v2/Agendas	Seznam agend.
GET v2/Agendas/{id}	Detail agendy dle Id.
GET v2/Agendas/Current	Detail autorizované agendy.
GET v2/Agendas/GetActualMonthInvoicing	Funkce vypočítá statistické údaje pro aktuální měsíc
GET v2/Agendas/GetAgendaBankAccounts	Seznam bankovních účtů agendy.
GET v2/Agendas/GetAgendaContact	Kontaktní údaje agendy.
GET v2/Agendas/GetAgendaContactExpand	Kontaktní údaje agendy - rozšířená verze.
GET v2/Agendas/GetAgendaSummary	Počet dokladů v agendě.
GET v2/Agendas/GetInvoicingForPeriod	Funkce vypočítá statistické údaje pro vydané a přijaté faktury
GET v2/Agendas/GetInvoicingForYear	Funkce vypočítá statistické údaje pro vydané a přijaté faktury
GET v2/Agendas/GetStatisticForContact/{id}	Statistika pro kontakt.
GET v2/Agendas/GetSummaryQuarters	Součet fakturačních částek dle jednotlivých kvartálů.
GET v2/Agendas/GetTopPartners	Funkce vypočítá nejlepší kontakty dle vyfakturované částky.

BankStatements

Metody pro práci s bankovými výpisy.

GET v2/BankStatements	Vrátí seznam bankovních výpisů. Filtry jsou volitelné.
GET v2/BankStatements/{id}	Vrátí údaje o bankovním výpisu s daným id.
POST v2/BankStatements/Pair	Vytvoří výpis a spáruje ho automaticky s fakturou na základě variabilního symbolu a měny. Bankovní účet se hledá podle čísla a kódu banky u CZ legislativy a podle IBANu u SK legislativy.

CashVouchers

Metody pro práci s pokladními doklady.

Vícepoložkový pokladní doklad

Pokladní doklady jsou vícepoložkové od 7.2.2018. Kvůli zpětné kompatibilitě zůstala na modelech položka Item. Pokud chcete používat vícepoložkové doklady, začněte ve vašem napojení využívat Items. Pro update pokladního dokladu použijte metodu PATCH, která již pracuje jenom s Items.
Také se změnilo umístnění pro VariableSymbol, který byl přesunutý z Item na hlavičku dokladu. Starý variabilní symbol na položkách je nyní redundantní a bude vždy totožný s tím na hlavičce.

GET v2/CashVouchers	Vrátí seznam pokladních dokladů. Filtry jsou volitelné.
GET v2/CashVouchers/{id}	Vrátí údaje o pokladním dokladu.
GET v2/CashVouchers/{id}/Expand	Vrátí pokladní doklad s pridruženými entitami.
GET v2/CashVouchers/{id}/GetCashVoucherPdf	Vrátí pdf s tiskovou sestavou Pokladní doklad. Dokument je zakódovaný Base64 kódováním a je vrácen jako řetězec.
GET v2/CashVouchers/{id}/GetCashVoucherPdfCompressed	Vrátí pdf s tiskovou sestavou Pokladní doklad. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/CashVouchers/Default/{movementType}	Vrátí prázdný pokladní doklad s výchozími hodnotami, dle nastavení agendy.
GET v2/CashVouchers/Default/{movementType}/{invoiceType}/{invoiceId}	Vrátí pokladní doklad z dané faktury pro daný typ pohybu a typ faktury
GET v2/CashVouchers/Expand	Vrátí seznam pokladních dokladů s pridruženými entitami.
POST v2/CashVouchers	Vloží nový pokladní doklad.
POST v2/CashVouchers/Pair/{cashVoucherId}/{invoiceType}/{invoiceId}	Spáruje pokladní doklad s neuhrazenou fakturou. Při párování se vytvoří úhrada k dané faktuře.
POST v2/CashVouchers/Pair/{invoiceType}/{invoiceId}	Spáruje pokladní doklad s neuhrazenou fakturou. Při párování se vytvoří úhrada k dané faktuře.
PUT v2/CashVouchers/{id}	Kompletní Update pokladního dokladu dle Id.
PUT v2/CashVouchers/{id}/Exported/{exported}	Update příznaku Exported pokladního dokladu. Využívá se při komunikaci s externími účetními programy.
PATCH v2/CashVouchers/{id}	Částečný update pokladního dokladu dle Id.
DELETE v2/CashVouchers/{id}	Odstraní pokladní doklad ze systému.

Contacts

Metody pro práci s kontakty.

Terminologie

Contact označuje kontakt v adresáři. DocumentAddress se vytvoří v momentě vytvoření dokumentu pro dodavatele i pro odběratele. Údaje v kontaktních údajích na faktuře nemusí odpovídat údajům, které má kontakt nastavené v adresáři (při změne kontaktu se DocumentAddress nemění). Změnu DocumentAddress lze dodatočně provést pomocí metody PATCH/DocumentAddresses, která povoluje i částečný update.

Užitečné rady

Id kontaktu je u faktur vyžadované. Jedná se o PurchaserId na vydaných fakturách a SupplierId na přijatých.

GET v2/Contacts	Seznam kontaktů.
GET v2/Contacts/{id}	Vrátí Kontakt dle Id.
GET v2/Contacts/{id}/Expand	Vrátí kontakt i se zanořenými entitami dle Id.
GET v2/Contacts/Default	Vrátí výchozí kontakt, který je vhodný pro naplnění údaji a uložení pomocí metody POST.
GET v2/Contacts/Expand	Seznam kontaktů i se zanořenými entitami.
POST v2/Contacts	Přidání nového kontaktu.
PUT v2/Contacts/{id}	Úplný update kontaktu.
PATCH v2/Contacts/{id}	Update kontaktu. Lze updatovat i částečně.
DELETE v2/Contacts/{id}	Odstraní kontakt.

CreditNotes

Metody pro práci s dobropisy.

GET v2/CreditNotes	Vrátí seznam dobropisů. Filtry jsou volitelné.
GET v2/CreditNotes/{id}	Vrátí údaje o dobropisu včetně výpočtu sum. Vhodné pro zobrazení detailu dobropisu.
GET v2/CreditNotes/{id}/Expand	Vrátí dobropis s kompletními údaji o dobropisu a odběrateli.
GET v2/CreditNotes/{id}/GetAttachment	Vrátí soubor s přilohou, pokud dobropis nějakou má. Soubor je zakódován Base64 kódováním.
GET v2/CreditNotes/{id}/GetAttachmentCompressed	Vrátí soubor s přilohou, pokud dobropis nějakou má. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/CreditNotes/Expand	Vrátí seznam dobropisů s kompletními údaji o dobropisech a odběratelích.
PUT v2/CreditNotes/{id}/Exported/{exported}	Update příznaku Exported dobropisu. Využívá se při komunikaci s externími účetními programy.
PUT v2/CreditNotes/{id}/FullyPay	Metoda provede plnou úhradu dobropisu.
PUT v2/CreditNotes/{id}/FullyUnpay	Provede plné oduhrazení dobropisu.
PUT v2/CreditNotes/SetAttachment/{invoiceId}	Nastaví přílohu u dobropisu. Případná existující příloha se přepíše.
DELETE v2/CreditNotes/DeleteAttachment/{invoiceId}	Smaže přílohu u dobropisu.

IssuedDocumentPayments

Metody pro práci s úhradami vydaných dokladů.

GET v2/IssuedDocumentPayments	Vrátí seznam úhrad. Filtry jsou volitelné.
GET v2/IssuedDocumentPayments/{id}	Vrátí údaje o úhradě. Vhodné pro zobrazení detailu úhrady.
GET v2/IssuedDocumentPayments/{id}/Expand	Vrátí úhradu s kompletními údaji o navázaných entitách jako například doklad úhrady.
GET v2/IssuedDocumentPayments/Default/{documentId}	Vygeneruje defaultní úhradu k zadanému dokladu. Vhodné pro vytvoření nové úhrady.
GET v2/IssuedDocumentPayments/Expand	Vrátí seznam úhrad s kompletními údaji o navázaných entitách jako například doklad úhrady.
POST v2/IssuedDocumentPayments	Vloží novou úhradu do seznamu úhrad. Úhrada by měla obsahovat id dokladu který hradí.
PUT v2/IssuedDocumentPayments/{id}/Exported/{exported}	Update příznaku Exported úhrady. Využívá se při komunikaci s externími účetními programy.
DELETE v2/IssuedDocumentPayments/{id}	Odstraní úhradu ze systému. Pokud má úhrada pokladní doklad, odstraní ho.

IssuedInvoices

Metody pro práci s fakturami vydanými.

GET v2/IssuedInvoices	Vrátí seznam faktur vydaných. Filtry jsou volitelné.
GET v2/IssuedInvoices/{contactId}/IssuedInvoices	Vrátí seznam faktur pro kontakt.
GET v2/IssuedInvoices/{id}	Vrátí údaje o faktuře vydané včetně výpočtu sum. Vhodné pro zobrazení detailu faktury.
GET v2/IssuedInvoices/{id}/Copy	Vrátí kopii existující faktury vydané. Vhodné pro vytvoření nové faktury vydané.
GET v2/IssuedInvoices/{id}/Expand	Vrátí fakturu s kompletními údaji o faktuře a odběrateli.
GET v2/IssuedInvoices/{id}/GetAttachment	Vrátí soubor s přilohou, pokud faktura nějakou má. Soubor je zakódován Base64 kódováním.
GET v2/IssuedInvoices/{id}/GetAttachmentCompressed	Vrátí soubor s přílohou, pokud faktura nějakou má. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/IssuedInvoices/{id}/GetCashVoucherPdf	Vrátí pdf s tiskovou sestavou Pokladní doklad pro fakturu. Dokument je zakódovaný Base64 kódováním a je vrácen jako řetězec.
GET v2/IssuedInvoices/{id}/GetCashVoucherPdfCompressed	Vrátí pdf s tiskovou sestavou Pokladní doklad pro fakturu. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/IssuedInvoices/{id}/GetPdf	Vrátí pdf s tiskovou sestavou Faktura vydaná. Dokument je zakódovaný Base64 kódováním a je vrácen jako řetězec.
GET v2/IssuedInvoices/{id}/GetPdfCompressed	Vrátí pdf s tiskovou sestavou Faktura vydaná. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/IssuedInvoices/{id}/GetPdfWithPayments	Vrátí pdf s tiskovou sestavou Faktura vydaná s úhradami. Dokument je zakódovaný Base64 kódováním a je vrácen jako řetězec.
GET v2/IssuedInvoices/{id}/GetPdfWithPaymentsCompressed	Vrátí pdf s tiskovou sestavou Faktura vydaná s úhradami. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/IssuedInvoices/{id}/MyDocumentAddress	Vrátí fakturační údaje dodavatele faktury vydané.
GET v2/IssuedInvoices/{id}/PurchaserDocumentAddress	Vrátí fakturační údaje odběratele faktury vydané.
GET v2/IssuedInvoices/Default	Vrátí prázdnou fakturu s výchozími hodnotami, dle nastavení agendy. Vhodné pro vytvoření nové faktury.
GET v2/IssuedInvoices/Expand	Vrátí seznam faktur s kompletními údaji o fakturách a odběratelích.
POST v2/IssuedInvoices	Vloží novou fakturu do seznamu faktur. Faktura by měla obsahovat pouze položky typu ItemTypeNormal.
POST v2/IssuedInvoices/{id}/Recount	Provede přepočet faktury. Faktura by měla obsahovat pouze položky typu ItemTypeNormal.
POST v2/IssuedInvoices/Accounting	Vloží novou fakturu do seznamu faktur a použije ji pro vyúčtování zálohové faktury. Zálohová faktura musí být uhrazena.
POST v2/IssuedInvoices/Recount	Provede přepočet faktury. Faktura by měla obsahovat pouze položky typu ItemTypeNormal.
PUT v2/IssuedInvoices/{id}	Update faktury dle Id. Lze provést jak kompletní nebo i částečný update. Faktura by měla obsahovat pouze položky typu ItemTypeNormal.
PUT v2/IssuedInvoices/{id}/Exported/{exported}	Update příznaku Exported faktury. Využívá se při komunikaci s externími účetními programy.
PUT v2/IssuedInvoices/{id}/FullyPay	Metoda provede plnou úhradu faktury.
PUT v2/IssuedInvoices/{id}/FullyUnpay	Provede plné oduhrazení faktury.
PUT v2/IssuedInvoices/{id}/MyDocumentAddress	Upraví fakturační údaje dodavatele faktury vydané.
PUT v2/IssuedInvoices/{id}/PurchaserDocumentAddress	Upraví fakturační údaje odběratele faktury vydané
PUT v2/IssuedInvoices/{id}/SendMailToPurchaser	Odešle fakturu odběrateli.
PUT v2/IssuedInvoices/SetAttachment/{invoiceId}	Nastaví přílohu u faktury vydané. Případná existující příloha se přepíše.
PATCH v2/IssuedInvoices/{id}	Update faktury dle Id. Lze provést jak kompletní nebo i částečný update. Faktura by měla obsahovat pouze položky typu ItemTypeNormal.
DELETE v2/IssuedInvoices/{id}	Odstraní fakturu ze systému.
DELETE v2/IssuedInvoices/DeleteAttachment/{invoiceId}	Smaže přílohu u faktury vydané.

PriceListItems

Metody pro práci s ceníkem.

Užitečné rady

Pro efektivnější práci s ceníkem lze použít dávkové operace pro vkládání i mazání.

GET v2/PriceListItems	Vrátí stránkovaný seznam položek ceníku.
GET v2/PriceListItems/{id}	Vrátí položku ceníku dle Id.
GET v2/PriceListItems/{id}/Expand	Vrátí položku ceníku včetně zanořených entit dle Id.
GET v2/PriceListItems/Default	Vygeneruje položku s defaultními hodnotami dle nastavení agendy vhodnou pro následnou úpravu a uložení.
GET v2/PriceListItems/Expand	Seznam položek ceníku i se zanořenými entitami.
POST v2/PriceListItems	Vloží novou položku ceníku do seznamu.
POST v2/PriceListItems/Batch	Vloží novou položku ceníku do seznamu. Dávková verze.
PUT v2/PriceListItems/{id}	Upraví položku ceníku.
PUT v2/PriceListItems/Batch	Upraví položky ceníku. Dávková operace.
PATCH v2/PriceListItems/{id}	Upraví položku ceníku.
PATCH v2/PriceListItems/Batch	Částečná úprava položek. Dávková operace.
DELETE v2/PriceListItems/{id}/{deleteIfReferenced}	Smaže položku ze seznamu ceníku.
DELETE v2/PriceListItems/Batch/{deleteIfReferenced}	Smaže položky ze seznamu ceníku.

ProformaInvoices

Metody pro práci se zálohovými fakturami.

GET v2/ProformaInvoices	Vrátí seznam zálohových faktur. Filtry jsou volitelné.
GET v2/ProformaInvoices/{contactId}/Invoices	Vrátí seznam zálohových faktur pro kontakt.
GET v2/ProformaInvoices/{id}	Vrátí údaje o zálohové faktuře včetně výpočtu sum. Vhodné pro zobrazení detailu faktury.
GET v2/ProformaInvoices/{id}/Account	Vrátí novou vydanou fakturu určenou pro vyúčtování zálohové faktury. Zálohová faktura musí být uhrazena.
GET v2/ProformaInvoices/{id}/Copy	Vrátí kopii existující zálohové faktury. Vhodné pro vytvoření nové zálohové faktury.
GET v2/ProformaInvoices/{id}/Expand	Vrátí zálohovou fakturu s kompletními údaji o faktuře a odběrateli.
GET v2/ProformaInvoices/{id}/GetAttachment	Vrátí soubor s přilohou, pokud faktura nějakou má. Soubor je zakódován Base64 kódováním.
GET v2/ProformaInvoices/{id}/GetAttachmentCompressed	Vrátí soubor s přílohou, pokud faktura nějakou má. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/ProformaInvoices/{id}/GetCashVoucherPdf	Vrátí pdf s tiskovou sestavou Pokladní doklad pro fakturu. Dokument je zakódovaný Base64 kódováním a je vrácen jako řetězec.
GET v2/ProformaInvoices/{id}/GetCashVoucherPdfCompressed	Vrátí pdf s tiskovou sestavou Pokladní doklad pro fakturu. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/ProformaInvoices/{id}/GetPdf	Vrátí pdf s tiskovou sestavou Faktura vydaná. Dokument je zakódovaný Base64 kódováním a je vrácen jako řetězec.
GET v2/ProformaInvoices/{id}/GetPdfCompressed	Vrátí pdf s tiskovou sestavou Faktura vydaná. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/ProformaInvoices/{id}/GetPdfWithPayments	Vrátí pdf s tiskovou sestavou Zálohová faktura s úhradami. Dokument je zakódovaný Base64 kódováním a je vrácen jako řetězec.
GET v2/ProformaInvoices/{id}/GetPdfWithPaymentsCompressed	Vrátí pdf s tiskovou sestavou Zálohová faktura s úhradami. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/ProformaInvoices/{id}/MyDocumentAddress	Vrátí fakturační údaje dodavatele zálohové faktury.
GET v2/ProformaInvoices/{id}/PurchaserDocumentAddress	Vrátí fakturační údaje odběratele zálohové faktury.
GET v2/ProformaInvoices/Default	Vrátí prázdnou zálohovou fakturu s výchozími hodnotami, dle nastavení agendy. Vhodné pro vytvoření nové faktury.
GET v2/ProformaInvoices/Expand	Vrátí seznam zálohových faktur s kompletními údaji o fakturách a odběratelích.
POST v2/ProformaInvoices	Vloží novou zálohovou fakturu do seznamu faktur. Faktura by měla obsahovat pouze položky typu ItemTypeNormal.
POST v2/ProformaInvoices/{id}/Recount	Provede přepočet faktury. Faktura by měla obsahovat pouze položky typu ItemTypeNormal.
POST v2/ProformaInvoices/Recount	Provede přepočet faktury. Faktura by měla obsahovat pouze položky typu ItemTypeNormal.
PUT v2/ProformaInvoices/{id}	Kompletní update faktury dle Id.
PUT v2/ProformaInvoices/{id}/Account	Provede vyúčtování zálohové faktury. Faktura musí být uhrazena.
PUT v2/ProformaInvoices/{id}/Exported/{exported}	Update příznaku Exported faktury. Využívá se při komunikaci s externími účetními programy.
PUT v2/ProformaInvoices/{id}/FullyPay	Metoda provede plnou úhradu zálohové faktury.
PUT v2/ProformaInvoices/{id}/FullyUnpay	Provede plné oduhrazení zálohové faktury.
PUT v2/ProformaInvoices/{id}/SendMailToPurchaser	Odešle fakturu odběrateli.
PUT v2/ProformaInvoices/SetAttachment/{invoiceId}	Nastaví přílohu u zálohové faktury. Případná existující příloha se přepíše.
PATCH v2/ProformaInvoices/{id}	Update faktury dle Id. Lze provést jak kompletní nebo i částečný update. Faktura by měla obsahovat pouze položky typu ItemTypeNormal.
DELETE v2/ProformaInvoices/{id}	Odstraní zálohovou fakturu ze systému.
DELETE v2/ProformaInvoices/DeleteAttachment/{invoiceId}	Smaže přílohu u zálohové faktury.

ReceivedDocumentPayments

Metody pro práci s úhradami přijatých dokladů.

GET v2/ReceivedDocumentPayments	Vrátí seznam úhrad. Filtry jsou volitelné.
GET v2/ReceivedDocumentPayments/{id}	Vrátí údaje o úhradě. Vhodné pro zobrazení detailu úhrady.
GET v2/ReceivedDocumentPayments/{id}/Expand	Vrátí úhradu s kompletními údaji o navázaných entitách jako například doklad úhrady.
GET v2/ReceivedDocumentPayments/Default/{documentId}	Vygeneruje defaultní úhradu k zadanému dokladu. Vhodné pro vytvoření nové úhrady.
GET v2/ReceivedDocumentPayments/Expand	Vrátí seznam úhrad s kompletními údaji o navázaných entitách jako například doklad úhrady.
POST v2/ReceivedDocumentPayments	Vloží novou úhradu do seznamu úhrad. Úhrada by měla obsahovat id dokladu který hradí.
PUT v2/ReceivedDocumentPayments/{id}/Exported/{exported}	Update příznaku Exported úhrady. Využívá se při komunikaci s externími účetními programy.
DELETE v2/ReceivedDocumentPayments/{id}	Odstraní úhradu ze systému. Pokud má úhrada pokladní doklad, odstraní ho.

ReceivedInvoices

Metody pro práci s fakturami přijatými.

GET v2/ReceivedInvoices	Vrátí seznam faktur přijatých. Filtry jsou volitelné.
GET v2/ReceivedInvoices/{id}	Vrátí údaje o faktuře přijaté včetně výpočtu sum. Vhodné pro zobrazení detailu faktury.
GET v2/ReceivedInvoices/{id}/Copy	Vrátí kopii existující faktury přijaté. Vhodné pro vytvoření nové faktury přijaté.
GET v2/ReceivedInvoices/{id}/Expand	Vrátí fakturu přijatou s kompletními údaji o faktuře a dodavateli.
GET v2/ReceivedInvoices/{id}/GetAttachment	Vrátí soubor s přilohou, pokud faktura nějakou má. Soubor je zakódován Base64 kódováním.
GET v2/ReceivedInvoices/{id}/GetAttachmentCompressed	Vrátí soubor s přílohou, pokud faktura nějakou má. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/ReceivedInvoices/{id}/GetPdf	Vrátí pdf s tiskovou sestavou Faktura přijatá. Dokument je zakódován Base64 kódováním a je vrácen jako řetězec.
GET v2/ReceivedInvoices/{id}/GetPdfCompressed	Vrátí pdf s tiskovou sestavou Faktura přijatá. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/ReceivedInvoices/{id}/MyDocumentAddress	Vrátí fakturační údaje odběratele faktury přijaté.
GET v2/ReceivedInvoices/{id}/SupplierDocumentAddress	Vrátí fakturační údaje dodavatele faktury přijaté.
GET v2/ReceivedInvoices/{supplierId}/ReceivedInvoices	Vrátí seznam faktur přijatých pro kontakt.
GET v2/ReceivedInvoices/Default	Vrátí prázdnou fakturu s výchozími hodnotami, dle nastavení agendy. Vhodné pro vytvoření nové faktury přijaté.
GET v2/ReceivedInvoices/Expand	Vrátí seznam přijatých faktur s kompletními údaji o rozšířených entitách.
POST v2/ReceivedInvoices	Vloží novou fakturu do seznamu faktur přijatých.
POST v2/ReceivedInvoices/{id}/Recount	Provede přepočet existující faktury přijaté a vrátí výsledek výpočtu. Přepočítanou fakturu je pak nutné uložit pomocí metody POST.
POST v2/ReceivedInvoices/Recount	Provede přepočet nové faktury přijaté
PUT v2/ReceivedInvoices/{id}	Kompletní update faktury přijaté dle Id.
PUT v2/ReceivedInvoices/{id}/Exported/{exported}	Update příznaku Exported faktury. Využívá se při komunikaci s externími účetními programy.
PUT v2/ReceivedInvoices/{id}/FullyPay	Metoda provede plnou úhradu faktury.
PUT v2/ReceivedInvoices/{id}/FullyUnpay	Provede plné oduhrazení faktury.
PUT v2/ReceivedInvoices/{id}/MyDocumentAddress	Upraví fakturační údaje odběratelé faktury přijaté.
PUT v2/ReceivedInvoices/{id}/SupplierPurchaserDocumentAddress	Upraví fakturační údaje dodavatele faktury přijaté.
PUT v2/ReceivedInvoices/SetAttachment/{invoiceId}	Nastaví přílohu u faktury přijaté. Případná existující příloha se přepíše.
PATCH v2/ReceivedInvoices/{id}	Kompletní nebo částečný update faktury přijaté dle Id.
DELETE v2/ReceivedInvoices/{id}	Odstraní fakturu ze systému.
DELETE v2/ReceivedInvoices/DeleteAttachment/{invoiceId}	Smaže přílohu u faktury přijaté.

RegisteredSale

Metody pro práci s evidovanými tržbami.

GET v2/RegisteredSales	Vrátí seznam údajů o evidovaných tržběách.
GET v2/RegisteredSales/{type}/{id}	Vrátí údaje o evidované tržbě pro typ prodeje a id dokladu.
GET v2/RegisteredSales/{type}/{id}/Expand	Vrátí údaje o evidované tržbě pro typ prodeje a id dokladu s pridruženými entitami.
GET v2/RegisteredSales/Default	Vrátí prázdnou evidovanou tržbu s výchozími hodnotami, dle nastavení agendy.
GET v2/RegisteredSales/Expand	Vrátí seznam údajů o evidovaných tržběách s pridruženými entitami.
POST v2/RegisteredSales/{type}/{id}	Vloží novou evidovanou tržbu.

SalesReceipts

Metody pro práci s prodejkami.

GET v2/SalesReceipts	Vrátí seznam prodejek. Filtry jsou volitelné.
GET v2/SalesReceipts/{id}	Vrátí údaje o prodejce.
GET v2/SalesReceipts/{id}/Expand	Vrátí prodejku s pridruženými entitami.
GET v2/SalesReceipts/{id}/GetPdf	Vrátí pdf s tiskovou sestavou prodejky. Dokument je zakódovaný Base64 kódováním a je vrácen jako řetězec.
GET v2/SalesReceipts/{id}/GetPdfCompressed	Vrátí pdf s tiskovou sestavou prodejky. Dokument je dále komprimovaný do Zip souboru. Archív je zakódován Base64 kódováním.
GET v2/SalesReceipts/Default	Vrátí prázdnou prodejku s výchozími hodnotami, dle nastavení agendy.
GET v2/SalesReceipts/Expand	Vrátí seznam prodejek s pridruženými entitami.
POST v2/SalesReceipts	Vloží novou prodejku.
POST v2/SalesReceipts/{id}/Recount	Provede přepočet prodejky.
POST v2/SalesReceipts/Recount	Provede přepočet prodejky.
PUT v2/SalesReceipts/{id}	Kompletní update prodejky dle id.
PUT v2/SalesReceipts/{id}/EetStatus/{eetStatus}	Update příznaku EetStatus
PUT v2/SalesReceipts/{id}/Exported/{exported}	Update příznaku Exported prodejky. Využívá se při komunikaci s externími účetními programy.
PUT v2/SalesReceipts/{id}/Imported/{value}	Update příznaku Imported prodejky. Využívá se při komunikaci s externími účetními programy.
PATCH v2/SalesReceipts/{id}	Částečný update prodejky dle id.
DELETE v2/SalesReceipts/{id}	Odstraní prodejku ze systému.

StockMovements

Metody pro práci se skladovými pohyby.

Užitečné rady

Skladové pohyby se provedou automaticky, pokud při uložení faktury použijete skladovou ceníkovou položku.
Pro efektivnější práci se skladem lze použít dávkové vkládání pohybů.

GET v2/StockMovements	Vrátí stránkovaný seznam skladových pohybů.
GET v2/StockMovements/{id}	Vrátí skladový pohyb dle id.
GET v2/StockMovements/Default/{priceListItemId}	Vrátí model skladového pohybu dle nastavení agendy.
POST v2/StockMovements	Vytvoří nový skladový pohyb. Pro záporný pohyb použijte záporné množství. V případě, že ceníková položka není skladová, změní se na skladovou.
POST v2/StockMovements/Batch	Vytvoří nové skladové pohyby. Pohyby mohou být i k různým ceníkovým položkám. Pro záporný pohyb použijte záporné množství.
PATCH v2/StockMovements/{id}	Částečný update skladového pohybu s daným id.
DELETE v2/StockMovements/{id}	Smaže skladový pohyb s daným id.

Vedlejší entity

CashRegisters

Metody pro práci s pokladnami.

Terminologie

Pokladna není to stejné, co pokladní zařízení. Pokud hledáte SalesPosEquipmentId pro EET, použijte metodu GET/SalesPosEquipments.

GET v2/CashRegisters	Vrátí seznam pokladen
GET v2/CashRegisters/{id}	Vrátí údaje o pokladně.
GET v2/CashRegisters/{id}/Expand	Vrátí pokladnu s pridruženými entitami.
GET v2/CashRegisters/Expand	Vrátí seznam pokladen s pridruženými entitami.

DocumentAddresses

Metody pro práci s kontaktními údaji dokumentů.

Terminologie

GET v2/DocumentAddresses/{id}	Vrátí kontaktní údaje pro fakturu Faktura obsahuje dvě položky daného typu - jednu pro odběratele a jednu pro dodavatele.
PUT v2/DocumentAddresses/{id}	Provede update kontaktních údajů k faktuře
PATCH v2/DocumentAddresses/{id}	Provede update kontaktních údajů k faktuře. Lze provést částečný update.

NumericSequences

Metody pro práci s číselnými řady.

Užitečné rady

V případě, že chcete vkládat dokumenty do předvolené řady pro daný typ dokumentu, nemusíte NumericSequenceIdspecifikovat.

GET v2/NumericSequences	Vrátí stránkovaný seznam číselných řad.
GET v2/NumericSequences	Vrátí číselnou řadu podle Id.

SalesOffice

Metody pro práci s prodejními místy.

GET v2/SalesOffice

Vrátí seznam prodejních míst. Filtry jsou volitelné.

SalesPosEquipment

Metody pro práci s pokladními zařízeními.

GET v2/SalesPosEquipment	Vrátí seznam prodejních zařízení. Filtry jsou volitelné.
GET v2/SalesPosEquipment/Expand	Vrátí seznam prodejních zařízení s rozšířenými entitami.
GET v2/SalesPosEquipment/Info	Vrátí informace o spárovaném pokladním zařízení, vrátaně informace o číselné řadě.

Číselníky

Banks

Číselník bank.

GET v2/Banks	Metoda vrátí seznam bank.
GET v2/Banks/{id}	Metoda vrátí banku dle Id.
GET v2/Banks/GetChanges	Metoda vrátí seznam bank, které byly změněné.

ConstantSymbols

Číselník konstantní symbolů.

GET v2/ConstantSymbols	Metoda vrátí seznam konstantních symbolů
GET v2/ConstantSymbols/{id}	Metoda vrátí konstantní symbol dle Id
GET v2/ConstantSymbols/GetChanges	Metoda vrátí seznam konstantních symbolů, které byli změněne.

Countries

Číselník států.

GET v2/Countries	Metoda vrátí seznam států
GET v2/Countries/{id}	Metoda vrátí stát dle Id.
GET v2/Countries/GetChanges	Metoda vrátí seznam států, které byly změněny.

Currencies

Číselník měn.

GET v2/Currencies	Metoda vrátí seznam měn.
GET v2/Currencies/{id}	Metoda vrátí měnu dle Id
GET v2/Currencies/GetChanges	Metoda vrátí seznam měn, které byly změněny.

ExchangeRates

Číselník kurzů.

GET v2/ExchangeRates	Metoda vrátí seznam kurzů.
GET v2/ExchangeRates/{id}	Metoda vrátí kurz dle Id
GET v2/ExchangeRates/GetChanges	Metoda vrátí seznam kurzů, které byly změněny.

PaymentOptions

Číselník způsobů úhrady.

GET v2/PaymentOptions	Metoda vrátí seznam způsobů úhrad
GET v2/PaymentOptions/{id}	Metoda vrátí způsob úhrady dle Id.
GET v2/PaymentOptions/GetChanges	Metoda vrátí seznam způsobů úhrad, které byly změněny.

System

Systémové funkce pro práci s číselníky.

GET v2/System/GetCodeBooks	Vrátí všechny číselníky.
GET v2/System/GetCodeBooksChanges	Indikace zda v číselníku nastala změna oproti poslední kontrole.

VatCodes

Metody pro práci s členením DPH.

GET v2/VatCodes	Metoda vrátí seznam členení DPH.
GET v2/VatCodes/{id}	Metoda vrátí členení DPH dle Id.
GET v2/VatCodes/GetChanges	Metoda vrátí seznam členení DPH, které byly změněny.

VatRates

Číselník sazeb DPH.

GET v2/VatRates	Metoda vrátí seznam sazeb DPH.
GET v2/VatRates/{id}	Metoda vrátí sazbu DPH dle Id.
GET v2/VatRates/GetChanges	Metoda vrátí seznam sazeb DPH, které byly změněny.

VatReverseChargeCodes

Číselník kódů plnění.

GET v{version:apiVersion}/VatReverseChargeCodesVersion2	Není dostupná žádná dokumentace.
GET v2/VatReverseChargeCodes	Metoda vrátí seznam kódů plnění.
GET v2/VatReverseChargeCodes/{id}	Vrátí kód plnění s daným id.

Jiné

Attachments

Metody pro práci s přílohami.

Užitečné rady

Nekomprimované přílohy jsou zakódovány pomocí Base64.
Komprimované přílohy jsou zabalené do zip souboru, který je zakódován pomocí Base64.
Limit pro přílohu v API je max. 5MB.
Upload přílohy se provádí přes content-type multipart/form-data. Pokud dostáváte výsledek 415 Unsupported Media Type, zkontrolujte si hlavičky requestu.

GET v2/Attachments/{documentId}/{documentType}/{compressed}	Vrátí soubor s přilohou, pokud dokument nějakou má.
PUT v2/Attachments/{documentId}/{documentType}	Nastaví přílohu u dokumentu. Případná existující příloha se přepíše.
DELETE v2/Attachments/{documentId}/{documentType}	Smaže přílohu u dokumentu.

Batch

Dávkové operace.

PUT v2/Batch/Exported

Update příznaku Exported entity. Využívá se při komunikaci s externími účetními programy.

Mails

Metody pro práci s maily.

Užitečné rady

Jazyk odeslané faktury lze změnit pomocí vlastnosti Language. Lze specifikovat i vlastní šablonu v cizím jazyce a posílat tak e-maily zahraničním klientům.
Šablona může obsahovat stejné zástupné znaky jako lze zadat v aplikaci.

Pozor

Ne všechny vlastnosti odeslání se shodují napříč entitama (např. přijatá faktura nelze zasílat odkazem).

POST v2/Mails/CreditNote/Send	Odeslání dobropisu.
POST v2/Mails/IssuedDocumentPayments/SendConfirmation/{id}	Odeslání podekovani za úhradu.
POST v2/Mails/IssuedInvoice/Send	Odeslání faktury vydané.
POST v2/Mails/ProformaInvoice/Send	Odeslání zálohové faktury.
POST v2/Mails/ReceivedInvoice/Send	Odeslání přijaté faktury.
POST v2/Mails/SalesOrder/Send	Odeslání cenové nabídky.

Reports

Metody pro práci s tiskovými sestavami.

Užitečné rady

Každá metoda obsahuje nepovinné parametry:
- Language - jazyk vrácené sestavy (platné hodnoty jsou Cz, Sk, De, En). Parametr má u výběru jazyka nejvyšší prioritu.
- Compressed - dále komprimuje sestavu do zip souboru. Vrácený zip soubor je zakódován pomocí Base64.

GET v2/Reports/CashVoucher/{id}/Pdf	Vrátí pdf s tiskovou sestavou Pokladní doklad.
GET v2/Reports/CreditNote/{id}/Pdf	Vrátí pdf s tiskovou sestavou Dobropis.
GET v2/Reports/CreditNote/{id}/PdfWithPayments	Vrátí pdf s tiskovou sestavou Dobropis s úhradami.
GET v2/Reports/IssuedInvoice/{id}/CashVoucherPdf	Vrátí pdf s tiskovou sestavou Pokladní doklad pro vydanou fakturu.
GET v2/Reports/IssuedInvoice/{id}/Pdf	Vrátí pdf s tiskovou sestavou Faktura vydaná.
GET v2/Reports/IssuedInvoice/{id}/PdfWithPayments	Vrátí pdf s tiskovou sestavou Faktura vydaná s úhradami.
GET v2/Reports/ProformaInvoice/{id}/CashVoucherPdf	Vrátí pdf s tiskovou sestavou Pokladní doklad pro zálohovou fakturu.
GET v2/Reports/ProformaInvoice/{id}/Pdf	Vrátí pdf s tiskovou sestavou Zálohová faktura.
GET v2/Reports/ReceivedInvoice/{id}/Pdf	Vrátí pdf s tiskovou sestavou Faktura přijatá.
GET v2/Reports/SalesReceipt/{id}/Pdf	Vrátí pdf s tiskovou sestavou Prodejka.

Test

Testovací metody.

GET v{version:apiVersion}/TestVersion2	Neprovede žádnou operaci, jenom vrátí query string v response. Může se použít jako redirect url pro callback pri authorization code flow.
GET v2/Test/DowngradeNeeded	Vždy vrátí status informující o nutnosti v aplikaci manuálně provést přechod na nižší předplatné.
GET v2/Test/GetActualApiLimit	Vrátí aktuální stav API požadavků.
GET v2/Test/PaymentRequired	Vždy vrátí status informující o nutnosti zakoupit předplatné před použitím volané funkce.
GET v2/Test/RateLimitExceeded	Vždy vrátí status pro prekročení limitu.