API

  2. Domů
  4. Dokumentace
  6. API
  8. Vzorové requesty
  10. REST API

REST API

Swagger dokumentace z našeho demo serveru je dostupná na http://demo.moneys5.cz:81/swaggerDoc/.
Pro údaje ClientID a ClientSecret si zažádejte pomocí formuláře.

Obecná syntaxe

bez autorizace

GET http(s)://[adresa API]/[verze API]*/[Endpoint]/[parametry]

s autorizací

GET http(s)://[adresa API]/[verze API]*/[Endpoint]/[parametry]
Authorization: Bearer [vygenerovaný token]
* pokud není uvedena, použije se verze 1.0

Verze API

GET http(s)://[adresa API]/v2.0/Version
(bez autorizace, pouze ve verzi 2.0)

Seznam endpointů

GET http(s)://[adresa API]/Admin/Roles/Endpoints
(s autorizací)

Čtení dat (select)

seznam firem

GET http(s)://[adresa API]/Company

seznam firem (omezeno parametry)

GET http(s)://[adresa API]/Company/0/10

Zápis dat (insert)

POST http(s)://[adresa API]/ReceivedOrder
request body: viz Tělo requestu

Modifikace dat (update)

PUT http(s)://[adresa API]/ReceivedOrder
request body: viz Tělo requestu

Update položek dokladu způsobuje smazání původních záznamů a nahrazení nově zaslanýmy údaji. Aktualizace položek dokladu je technicky stejné jako zaslání všech údajů na položkách znovu. Výsledek bude výměna všech původních položek a jejich hodnot za nově zaslané údaje.

Mazání dat (delete)

DELETE http(s)://[adresa API]/Company/e27fa45a-8075-4718-97f5-d92043e793d0

Tělo requestu

V následujících příkladech jsou uvedeny obvyklé rozsahy informací pro zápis. Přesný rozsah je také záležitostí individuálního nastavení v konkrétní agendě např. mají na skupině přiřazenou číselnou řadu, která se automaticky doplní, taktéž platí pro činnost, středisko, zakázky, splatnost dokladu, předkontace zaúčtování atd. Zápis položek je pro všechny doklady stejný. Hlavička dokladu je principiálně vždy stejná, může se lišit jen v některých elementech např. Datum splatnosti nebo Datum účetního případu má faktura, ale objednávka již nikoliv.

Generování PDF

V rámci REST API je možné si u některých objectů zavolat konkrétní doklad a vygenerovat si .pdf na stažení, dle zvolené tiskové sestavy, tak jako by tento úkon udělal uživatel přímo v Money. Soubor se nikam v rámci Money neukládá, požadavek vrací data taková, jako jsou v ten daný okamžik evidované na dokladu. Je to analogická funkce, jako když uživatel v prostředí v Money stiskne tlačítko nad dokladem, tisknout do .pdf. Seznam podporovaných objectů je v tabulce dostupných endpointů.
 
Pro samostný dotaz je potřeba znát minimálně jedno ID (ideálně dvě), které Vám musí sdělit uživatel Money. V rámci programu mohou být nad jedním objectem několik tiskových sestav a daná jedna tisková sestava může být v různých designech. Tyto ID jsou vždy individuální, dle toho jak si uživatelé zakládají nové sestavy.
 
Standardní vzor dotazu, kde je povinné pole ID dokladu a ID tiskové sestavy:
/v2.0/IssuedInvoice/{id}/Report/{reportId}

Doporučený dotaz je s využitím i ID konkrétního designu tiskové sestavy:

/v2.0/IssuedInvoice/{id}/Report/{reportId}?reportDesignId={reportDesignId}

http://demo.moneys5.cz:81/v2.0/IssuedInvoice/57575161-edd2-46b6-b26d-807a578b1132/Report/454498f9-a2cb-465d-9a0c-958ab5434de2?reportDesignId=c594f175-412c-43bf-8119-d603022bfa62

Uživatel Money dodá požadované ID, které nalezne v Agenda – Nastavení tiskových sestav a po výběru konkrétní tiskové sestavu u konkrétního objectu použije tlačítko Opravit a dole v seznamu designů zjistí ID grafického návrhu. Pro uživatele/administrátora tiskových sestav v agendě, je to běžná součást práce a místa pro editaci šablon.

REST API
Pomohl Vám tento článek? Ano Ne

Jak Vám můžeme pomoci?