1. Čo je naviazaný záznam?
Naviazaným záznamom sa rozumie napríklad forma úhrady, bankový účet, zásoba zo skladu, odberateľ, alebo iné naviazané údaje, ktoré chceme uviesť na vytváranej vydanej faktúre. Každý záznam má v aplikácii mPOHODA svoje unikátne id a pre uvedenie požadovaného záznamu na doklade je potrebné sa na daný záznam odkázať práve cez jeho id.
V sekcii Referencie je uvedený zoznam záznamov, s ktorými je možné v rámci API pracovať. Id konkrétneho záznamu sa získa prostredníctvom príslušnej API metódy pre stiahnutie zoznamu záznamov a následne sa doplní do tela vytváranej požiadavky.
2. Získanie id naviazaného záznamu
Na príklade vydanej faktúry si ukážeme získanie id adresy odberateľa (DocumentAddressWithAddressBookLink). Podobným spôsobom by sa postupovalo aj v prípade získania id ďalších záznamov, na ktoré sa chceme v tele požiadavky na vytvorenie vydanej faktúry odkázať.
Pomocou príslušnej API metódy získame zoznam odberateľov. V tele odpovede v časti Data.Items vyhľadáme nami požadovaného odberateľa 'STORMWARE s.r.o.' a zistíme jeho id 9423064b-5842-450d-9d31-cca121b8e034.
Id odberateľa 9423064b-5842-450d-9d31-cca121b8e034 zadáme v tele požiadavky pre vytvorenie vydanej faktúry, v položke DocumentAddressWithAddressBookLink:
{
"Text": "Text faktúry",
"IssueDate": "2023-01-18T13:05:11.148Z",
"DueDate": "2023-02-01T13:05:11.148Z",
"TaxDate": "2023-01-18T13:05:11.148Z",
"PaymentMethodId": "e9001046-a210-49fe-bb5d-ee463b88ca9d",
"BankAccountId": "b61898b3-3ed1-4cb5-b099-475ea32d79fe",
"BusinessPartnerAddress": {
"DocumentAddressWithAddressBookLink": {
"Id": "9423064b-5842-450d-9d31-cca121b8e034"
}
},
"Items": [
{
"TextItem": {
"Text": "Polozka faktury 1",
"Quantity": 1,
"Unit": "ks",
"UnitPrice": 100,
"UnitPriceType": "WithoutVat",
"VatRateType": "ZeroVatRate"
}
},
{
"TextItem": {
"Text": "Polozka faktury 2",
"Quantity": 2,
"Unit": "ks",
"UnitPrice": 50,
"UnitPriceVatType": "WithVat",
"VatRateType": "BasicVatRate"
}
}
]
}
Podobným spôsobom sa získalo id záznamu pre formu úhrady Príkazom a uviedlo sa v tele požiadavky, v položke PaymentMethodId a id pre bankový účet TB a uviedlo sa v položke BankAccountId.
Po odoslaní požiadavky na API, sa v aplikácii mPOHODA vytvorí nová faktúra, na ktorej bude uvedený odberateľ 'STORMWARE s.r.o.', forma úhrady Príkazom, bankový účet TB a dve textové položky:
