Zināšanu bāze Integrācija

Interneta veikalā veiktos pasūtījums Horizon visbiežāk reģistrē loģistikas modulī ar dokumentu "Pieprasījums". Ja Horizon ir vairāki pieprasījuma dokumentu tipi, tad Horizon lietotāji nosaka, kuru dokumentu tipu integrācijai izmantot. Pieprasījumu dokumentu tipu sarakstu iespējams iegūt ar šādu vaicājumu. GET ../rest/TLgPiepDBL/template Loģistikas pieprasījumu veido ar sekojošu vaicājumu. POST ../rest/TLgPiepDBL/template/{pk} <resource> <entity> <PK_DOKT>501</PK_DOKT> <PAMVID>7162</PAMVID> <PK_KLIENTS>30</PK_KLIENTS> <DOC_DATE>2024-01-28</DOC_DATE> <NUMURS>LD0158</NUMURS> <PK_ADRESE>20</PK_ADRESE> <NOTES>piezīmes</NOTES> <PK_NOL>4</PK_NOL> <LgPiepRows> <row> <RN_VEIDS>0</RN_VEIDS> <PK_NOM>1</PK_NOM> <DAUDZ>5</DAUDZ> <FCENA>35</FCENA> </row> </LgPiepRows> </entity> </resource>   PK_KLIENTS - klienta kartītes sistēmas ID, kā atrast klienta ID DOC_DATE - pieprasījuma datums NUMURS - pieprasījuma numurs PK_ADRESE - klienta piegādes adreses ID NOTES - piezīmes PK_NOL - noliktavas ID, ../rest/TNdmNolSar/default RN_VEIDS - rindas veids, 0 - nomenklatūra PK_NOM - nomenklatūras ID, kā noskaidrot preces ID  DAUDZ - daudzums FCENA - cena. Ja lauku nenorāda, cena tiek noteikta automātiski  

Integrācijām ar Horizon tiek izmantoti WEB lietotāji. Tas ir lietotāja paveids Horizon, ko izmanto pieslēgšanai WEB aplikācijām, t.sk. REST integrācijām. Veidojot WEB lietotāju, tam obligāti jānorāda Horizon lietotājs, jo pēc šī Horizon lietotāja tiek noteikta WEB lietotāja loma un tiesības, kas nosaka pieejamās funkcionālās sadaļas un tiesības apstrādāt vai skatīt datus.   Tātad vispirms nepieciešams izveidot lomu ar atbilstošām pieejas tiesībām. Vairāk par lomu veidošanu lasīt šeit. Sistēma - Administrēt - Lomas       Nākamais solis ir izveidot Horizon lietotāju. Sistēma - Administrēt - Lietotāji Šādam lietotājam norāda konta veidu Sistēmkonts.       Lappusē Tiesības norāda, kuras firmas datiem būs pieeja un ar kādu lomu.       Visbeidzot var veidot WEB lietotāju. Sistēma - Administrēt - WEB lietotāji Lappusa Pamatinformācija Arī šeit konta veids jānorāda Sistēmkonts, kā arī WEB lietotājs jāsasaista ar Horizon lietotāju. Lappusē Firmas un objekti norāda, kura šim pieslēgumam būs noklusētā firma. Lappusē Atļautās saskarnes atzīmē "piešķirtās" un norāda saskarni "Vispārējā integrācija", ja vien nav izveidota atsevišķa saskarne topošajai integrācijai. Vairāk par saskarnēm lasīt šeit.      

Horizon iespējams vienā datubāzē veikt vairāku uzņēmumu uzskaiti. Iespējami divi dažādi varianti - vairāku nodokļu maksātāju (VNM) režīms jeb iestāžu režīms un firmu režīms.    Vairāku nodokļu maksātāju režīms jeb iestāžu režīms nozīmē, ka vairāki uzņēmumi tiek uzskaitīti vienā datubāzes apgabalā, tiem ir kopēji pamata klasifikatori un katram dokumentam tiek norādīts kurai iestādei tas atbilst. Strādājot ar datubāzi šādā režīmā nepieciešams dokumentu sarakstus filtrēt pēc iestādes lauka. Iestāžu sarakstu iespējams iegūt ar šādu vaicājumu:   GET .../rest/TsarDIestade   Piemērs ar realizācijas rēķinu atlasi filtrējot pēc iestādes.   GET .../rest/TNdmRekSar/query?filter=IEST_PK_IESTADE eq 2&columns=D.DOK_NR,D.DAT_DOK,D.K.NOSAUK,D.SUMMA   Firmus režīms nozīmē, ka vienā datubāzē katrs uzņēmums tiek uzskaitīts nodalītā datubāzes apgabalā - firmā.  Strādājot ar datubāzi šādā režīmā iespējams izmantot atsevišķu lietotāju katrai firmai vai arī veidot vienu lietotāju ar vairākām piesaistītām firmām. Sīkāk par lietotāju veidošanu un firmu piesaistīšanu lasīt šeit.   Ja tiek izmantots lietotājs ar piekļuvēm vairākām firmām, tad pieslēdzoties primāri tiek atlasīta noklusētā lietotāja firma. Informācija par firmu, kuras dati tiek atdoti pieejama galvenē Organization. Ja nepieciešams pieslēdzoties norādīt konkrētu firmu, tad jāizmanto speciālā autentifikācija un parametrs firmaid. Šī brīža aktīvo firmu iespējams apskatīt ar šādu vaicājumu:     GET .../rest/user/organization/current     Lietotājam pieejamās firmas iespējams apskatīt ar šādu vaicājumu:   GET .../rest/user/organization   Ja nepieciešams nomainīt aktīvo firmu, to iespējams izdarīt ar šādu vaicājumu:   POST .../rest/user/organization/change <resource> <PK_FIRMA>4</PK_FIRMA> </resource>  

Viens no visbiežāk izmantotajiem Horizon pamatdatu sarakstiem ir klientu saraksts un šis saraksts tiek izmantots arī daudzās REST integrācijās. Zemāk apskatīsim pamata vaicājumus ar kuriem no Horizon var izgūt aktuālo klientu sarakstu un vaicājumus ar kuriem caur REST var pievienot jaunus klientus. 1. Esošu klientu kartiņu datu izgūšana Klientu saraksts ir galvenais saraksts no kurienes izgūt informāciju par klientiem (Pamatdati -> Klienti -> Klientu saraksts). Ar zemāk esošo vaicājumu iespējams izgūt visas aktīvās debitoru klientu kartiņas.   GET ../rest/TDdmKlSar/query?filter=K_STATUSS eq 0 and K_DBKRPAZ eq 1&columns=K.PK_KLIENTS,K_KODS,K_NOSAUK,K_EPASTS,K_TELEFONS,K_MOBTEL,K_UNI_NR,K_PVN_REGNR,K_DBKRPAZ,K_STATUSS K_STATUSS - filtrēšana pēc klienta kartītes statusa. 0 - aktīvās kartītes K_DBKRPAZ - filtrēšana pēc klienta norēķinu veida (Debitors - 1; Kreditors - 2; Neuzskaita - 0) K_PK_KLIENTS - klienta kartītes sistēmas ID K_UNI_NR - klienta universālais numurs. Apvienots lauks kurā tiek rādīts uzņēmuma reģistrācijas numurs vai privātpersonas personas kods   Ar zemāk esošo vaicājumu var izgūt informāciju par vienu konkrētu aktīvu klienta kartiņu, kas filtrēta pēc klienta reģistrācijas vai personas koda.   GET ../rest/TDdmKlSar/query?filter=K_UNI_NR eq '40003734170' and K_STATUSS eq 0&columns=K.PK_KLIENTS,K_KODS,K_NOSAUK,K_EPASTS,K_TELEFONS,K_MOBTEL,K_UNI_NR,K_PVN_REGNR,K_DBKRPAZ,K_STATUSS K_STATUSS - filtrēšana pēc klienta kartītes statusa. 0 - aktīvās kartītes K_UNI_NR - filtrēšana pēc klienta universālā numura (reģistrācijas numurs vai privātpersonas personas kods)   2. Jaunu klientu kartiņu izveidošana Klientiem var būt izviedoti vairāki klientu kartiņas dokumenta tipi ar savām definētam noklusētajām vērtībām. Veidojot jaunas klienta kartiņas ir svarīgi izvēlēties atbilstošo klientu kartiņas dokumenta tipu. Visus pieejamos klienta kartiņu dokumenta tipus varat noskaidrot ar šādu vaicājumu.   GET ../rest/TDdmCustomer/template Šādā veidā tiek izgūta informācija par visiem klientu kartītēs pieejamiem laukiem, taču ļoti bieži pilnīgi visus klienta kartiņā pieejamos laukus nav nepieciešams aizpildīt.   GET ../rest/TDdmCustomer/template/2 Kad ir atrasts atbilstošais klienta kartiņas dokumenta tipa template, nepieciešams aizpildīt Jums svarīgo informāciju. Veidojot jaunus klientus caur REST, laba prakse ir iesūtīt tikai Jums nepieciešamo informāciju un neizmantotos laukus no šablona dzēst.   Uzņēmuma klienta kartiņas izveide POST ../rest/TDdmCustomer/template/2 POST Body <resource> <entity> <PK_DOKT>2</PK_DOKT> <KODS>0001</KODS> <TIPS>3</TIPS> <NOSAUK>Visma Enterprise SIA</NOSAUK> <REG_NR>40003734170</REG_NR> <PVN_REGNR>LV40003734170</PVN_REGNR> <PK_VALSTS>1</PK_VALSTS> <PK_VAL>3</PK_VAL> <DBKRPAZ>1</DBKRPAZ> <EPASTS>visma@visma.lv</EPASTS> <WWWLAPA>www.visma.lv</WWWLAPA> <TELEFONS>67116211</TELEFONS> <MOBTEL>22334455</MOBTEL> </entity> </resource>   Privātpersonas klienta kartiņas izveide POST ../rest/TDdmCustomer/template/2 POST Body <resource> <entity> <PK_DOKT>2</PK_DOKT> <KODS>0002</KODS> <TIPS>6</TIPS> <VARDS>Jānis</VARDS> <UZVARDS>Bērziņš</UZVARDS> <PERSKODS>112233-11223</PERSKODS> <PK_VALSTS>1</PK_VALSTS> <PK_VAL>3</PK_VAL> <DBKRPAZ>1</DBKRPAZ> <EPASTS>e-pasts@e-pasts.lv</EPASTS> <TELEFONS>67226733</TELEFONS> <MOBTEL>22334455</MOBTEL> </entity> </resource>   PK_DOKT - Dokumenta tipa sistēmas ID TIPS - Klienta kartiņas tips (Uzņēmums - 3, Privātpersona - 6, Individuālais uzņēmums - 4, Vienreizējs - 8 ) KODS - ja klientam dokumenta tipā ir definēts klientu numerators var atstāt tukšu, Horizon to automātiski aizpildīs PERSKODS - Ja klienta kartīte ir privātpersona, tad šeit tiek ievadīts personas kods  PK_VALSTS - Klienta valsts sistēmas ID PK_VAL - Klienta valūtas sistēmas ID standarta sākumkonfigurācija EUR - 3 DBKRPAZ - Norēķinu veids. (Debitors - 1; Kreditors - 2; Neuzskaita - 0)

Lai izgūtu no Horizon datus par darbinieku prombūtnēm, var izmantot Horizon atskaiti Plānotās prombūtnes (Atskaites - Personāla uzskaite - Plānotās prombūtnes). Šajā atskaitē pieejami dati gan par notiekošām prombūtnēm, gan plānotām (pieteiktām). Ja nepieciešams, iespējams paskatīties arī uz pagātnē notikušām prombūtnēm.   REST vaicājuma piemērs:     ...rest/TpuAbsencesSL/query?columns= DOKT_ID,DOKT_KODS,DOKT_NOSAUK,ERS_TNUM,ERS_PK_PERS,ERS_FNAME,ERS_LNAME,PSADM_NOSAUK,PSAMA_NOSAUK,ABS_STATUS,ABS_DAT_FROM,ABS_DAT_TO,ABS_DOC_PK,AISL_PK_PERS,AISLP_FNAME,AISLP_LNAME,AIZV_DATLIDZ, AIZV_DATNO, AIZV_PIEZIMES&filter=ABS_STATUS ne 3&orderby=ABS_DAT_FROM desc&NO_DAT=2024-06-01&LIDZ_DAT=2024-06-15     DOKT_ID,DOKT_KODS,DOKT_NOSAUK - prombūtnes dokumenta pamatveids, dokmenta tipa kods, nosaukums; ERS_PK_PERS,ERS_FNAME,ERS_LNAME - prombūtnē esošā darbinieka personas kartītes PK (identifikators), vārds, uzvārds; PSADM_NOSAUK,PSAMA_NOSAUK - prombūtnē esošā darbinieka pamatslodzes struktūrvienība, amats; ABS_STATUS - prombūtnes statuss (Sagatave - 3; Ieplānota - 2; Apstiprināta - 1; Sākusies - 0) ABS_DAT_FROM,ABS_DAT_TO - prombūtnes sākuma un beigu datums; AISL_PK_PERS,AISLP_TNUM,AISLP_FNAME,AISLP_LNAME,AIZV_DATLIDZ, AIZV_DATNO, AIZV_PIEZIMES - ziņas par aizvietotāju - PK(identifikators), tabeles numurs, vārds, uzvārds, aizvietošanas periods no/līdz.   Filtra nosacījums "ABS_STATUS ne 3" - neatlasīt tās prombūtnes, kas ir statusā "Sagatave".

Ienākošo maksājumu apstrādi no bankām Horizon veic maksājumu importa funkcionalitāte. Ja uzņēmums izmanto kādus maksājumu starpniekus, tad dažkārt maksājums bankā ienāk kopsummā un grāmatvedības uzskaitē tas ir jāsadala pret katru konkrēto klientu/rēķinu. Šādā gadījumā iesakām izmantot sadarbības partnera "virtuālo" bankas kontu, kurā uzskaitīt detalizētos maksājumus un ar bankas pārvedumu ievadīt kopējo maksājumu uzņēmuma bankas kontā. Sīkāk par šo risinājumu šeit.    Šāda risinājuma gadījumā sadarbības partneris ienākošos maksājumus katram samaksājušajam klientam var pievienot izmantojot REST.   Pievienojot ienākošo maksājumu obligāti jānorāda ar kuru dokumenta tipu tas tiks veidots. Ja Horizon ir vairāki dokumentu tipi, tad Horizon lietotāji nosaka kuru dokumentu tipu integrācijai izmantot. Ienākošo maksājumu dokumentu tipu sarakstu iespējams iegūt:  GET ../rest/TDdmInMu/template     POST …/rest/TDdmInMu/template/10 <?xml version="1.0" encoding="UTF-8" standalone="no"?> <entity> <resource> <PK_DOKT>10</PK_DOKT> <PAMV_ID>3306</PAMV_ID> <PK_R_ES>1</PK_R_ES> <PK_VAL>3</PK_VAL> <PK_KLIENTS>82</PK_KLIENTS> <DAT_DOK>2019-10-23</DAT_DOK> <DOK_NR>234654</DOK_NR> <SUMMA>100.00</SUMMA> <SUMMA_APM>100.00</SUMMA_APM> <PK_LIG>118</PK_LIG> <qryPamat> <row> <PAMAT>pamatojuma teksts</PAMAT> </row> </qryPamat> </entity> </resource>   PK_R_ES - bankas konta ID (..rest/TDdmSaviRekSarVisi/default) PK_VAL - valūtas ID (..rest/TsdmValSar/default) PK_KLIENTS - klienta kartītes sistēmas ID (../rest/TDdmKDebSar/default) DAT_DOK - maksājuma datums DOK_NR - maksājuma numurs SUMMA, SUMMA_APM - maksājuma summa PK_LIG - klienta līguma sistēmas ID, nav obligāts (..rest/TdmKllig/default) PAMAT - maksājuma pamatojums

Horizon dokumentiem, kuri ietekmē virsgrāmatu, pārsvarā ir 3 statusi - Sagatave, Izpildīts un Grāmatots. Izveidojot dokumentu tas ir statusā Sagatave. Pēc tam tos nepieciešams izpildīt un grāmatot, dažkārt to iespējams veikt arī integrācijas sistēmai.   Statusa nomaiņa tiek veikta konkrētā dokumenta entītes resursā.  Lai nodrošinātu, ka neviens cits lietotājs nav paralēli veicis darbības ar dokumentu, nepieciešams noskaidrot aktuālo dokumenta counter vērtību. To iespējams izdarīt konkrēto dokumentu atlasot pēc ID. Piemērs ar ienākošo maksājumu.   GET /rest/TDdmInMu/591 (maksājuma ID) Atbilde <description>Entītijas ieraksts</description> <title>234654</title> <entity xmlns="TDdmInMu.xsd" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="TDdmInMu.xsd TDdmInMu.xsd"> <PK_DOKT> <href>/rest/TdmDocType/10</href> </PK_DOKT> <PAMV_ID>3306</PAMV_ID> <COUNTER>0</COUNTER> <PK_DOK> <href rel="self">/rest/TDdmInMu/591</href> </PK_DOK> .....   Dokumentu izpildīšana   Dokumenta izpildi iespējams veikt ar metodi ExecuteFromKey   Piemērs ienākošajam maksājumam, kura resurss ir TDdmInMu.   POST ../rest/TDdmInMu/ExecuteFromKey <resource> <aKey>591</aKey> <CounterVal>0</CounterVal> <GramDate>2020-09-01</GramDate> </resource> aKey - dokumenta ID CounterVal - akutālā counter vērtība GramDate - izpildes datums   Dokumenta grāmatošana   Dokumenta izpildi iespējams veikt ar metodi BookFromKey   Piemērs ienākošajam maksājumam, kura resurss ir TDdmInMu.   POST .../rest/TDdmInMu/BookFromKey <resource> <aKey>591</aKey> <CounterVal>1</CounterVal> <aSchemaPk>1125</aSchemaPk> <DeleteDraft>1</DeleteDraft> </resource>   aKey - dokumenta ID CounterVal - akutālā counter vērtība aSchemaPk - kontēšanas shēmas ID (kontēšanas shēmu saraksts nav pieejamas REST API) DeleteDraft - 1 (kontējums tiks veidots pēc norādītās kontēšanas shēmas)

Bieži izmantots saraksts BI risinājumos ir Grāmatojumu saraksts, kurā datus lietderīgi filtrēt ar precīzu pulksteņlaiku. (Dokumenti -> Virsgrāmata -> Grāmatojumi)   Grāmatojumu saraksts satur daudz ierakstus, tāpēc iesakām iegūt datus tikai par grāmatojuma saraksta izmaiņām, kopš pēdējās datu ielādes.   Tā kā grāmatojums šodien var veikt dažādos datumos, tad svarīgi skatīties nevis uz grāmatojuma datumu, bet gan uz grāmatojuma transakcijas laiku, kas fiksē grāmatošanas notikuma laiku.   GET ../rest/TdmGramatSL/query?filter=SDE_LAIKS ge '2023-06-26T08:30:00.000%2B03:00'&columns=T_NOSAUK,K_NOSAUK,K_UNI_NR,D_DOK_NR,TEKSTS,DK_KODS,KK_KODS,SUMMA,PK_VAL,DS_KODS,KS_KODS,STATUSS,D_DOK_REGNR,DAT_GRP,SDE_LAIKS   T_NOSAUK - Dokumenta veids K_NOSAUK - Klienta nosaukums K_UNI_NR - Klienta universālais numurs (reģistrācijas kods vai personas kods) D_DOK_NR - Dokumenta numurs TEKSTS - Grāmatojuma pamatojums DK_KODS - Debeta konts KK_KODS - Kredīta konts SUMMA - Grāmatojuma summa PK_VAL - Valūta DS_KODS - Debeta struktūrvienības kods KS_KODS - Kredīta struktūrvienības kods STATUSS - (Normāls - 1; Sagatave - 2; Stornēts - 3; Stornējošs - 4) D_DOK_REGNR -  Dokumenta reģistrācijas numurs DAT_GRP - Grāmatošanas datums SDE_LAIKS - Transakcijas laiks Atkarībā no servera konfigurācijas nepieciešams vaicājumā nepieciešams norādīt korektu  laika joslu.  Piemēra servera laika josla ir definēta +3.00 stundas un REST tā tiek pierakstīta šādi “%2B03:00”   Sīkāk par saraksta filtrēšanas iespējām šeit.

Horizon dokumenta apmaksa starp dokumentiem tiek attēlota ar piesaistes izveidošanu to starpā. Sistēmā piesaistes ir iespējams veidot lietotājam manuāli izvēloties dokumentu vai veicot automātiskās piesaistes atbilstoši uzstādījumiem. Arī izmantojot integrāciju platformu iespējams izveidot piesaisti starp dokumentiem. Ja saistību vai maksājumu dokuments tiek izveidots izmantojot integrāciju, tad var būt nepieciešamība veidot piesaistes izmantojot integrāciju platformu   Piesaiste starp diviem konkrētiem dokumentiem   Piesaisti starp diviem dokumentiem iespējams izveidot ar metodi apmaksatFromKey. Metodei nepieciešams nodot maksājuma dokumenta ID, saistību dokumenta ID, valūtas ID. Ja summa tiek atstāta 0.00, tad sistēma izanalizēs, par kādu summa piesaisti iespējams izveidot.   Piemēru, ja piesaistītā darbība tiek veikta ienākošajam maksājumam ar citu saistību dokumentu, skatīt šeit.   Automātiska piesaiste, atbilstoši algoritmam   Horizon dokumentu sarakstos pieejama darbība "Piesaistīt automātiski", kas, atbilstoši uzstādījumiem vai izvēlētajai metodei, veic piesaistes piemeklējot atbilstošos piesaistāmos dokumentus.   Caur REST šo darbību iespējams veikt atbilstošo dokumentu resursiem, izmantojot metodi LinkDocAutomatically (pieejama no 600. versijas).    Metodei nepieciešams dokumenta ID (obligāts parametrs) un automātisko piesaistu metodes ID (ja padod -1, tad tiks izmantota noklusētā (pirmā atzīmētā no uzskaites parametriem).  Šo darbību paredzēts izpildīt pa vienam preču vai maksājuma dokumentam. Ja nepieciešams veikt piesaistes vairākiem dokumentiem, tad šī darbība jāizpilda cikliski katram dokumentam.   Piemērs, ja darbība "piesaistīt automātiski" tiek veikta ienākošajam maksājumam, izmantojot sistēmas uzstādījums.   POST /rest/TDdmInMu/LinkDocAutomatically <resource> <APkDoc>167894</APkDoc> <ALinkMethod>-1</ALinkMethod> </resource> Piesaistu metožu ID: 0 - Klients; 1 - Līgums; 2 - Klients, līgums; 3 - Klients, summa; 4 - Līgums, summa; 5 - Klients, līgums, summa; 6 - Klients, dok. Nr.; 7 - Klients, dok. Nr., summa; 8 - Klients, dok. Nr., līgums; 9 - Klients, dok. Nr., līgums, summa; 10 - Pa norēķinu grupām; 11 - Vecākajiem līguma dokumentiem un norēķinu grupām proporcionāli; 12 - Pa norēķinu grupām datumu secībā; 13 - Pēc atrastajiem rēķinu numuriem; 14 - Pēc atrastajiem rēķinu numuriem, summa

Datu sinhronizācijas mehānisms ir paredzēts darbam ar Horizon klasifikatoriem, lai saņemtu informāciju par tajos veiktajām izmaiņām. Sinhronizācija darbojas pēc šādas shēmas: ar GET pieprasījumu uz kādu no apakšresursiem, piemēram, changed nolasa datus; izpilda POST pieprasījumu uz to pašu apakšresursu, fiksējot saņemtās vērtības. Klasifikatori Horizon pusē ir, piemēram, klientu saraksts (TDdmKlPamatDat), nomenklatūru saraksts (TNdmNomSar), realizācijas rēķinu saraksts (TNdmRekSar) utt. Tiklīdz tiek veiktas izmaiņas kādam klasifikatora ierakstam, piemēram, nomenklatūrai mainās nosaukums, klienta kartītē tiek ierakstīts e-pasts, rēķinam tiek piesaistīts maksājums, šim ierakstam datubāzē tiek palielināta counter vērtība, attiecīgi sync pēc šīm vērtībām saprot, kuri ieraksti ir mainīti. Uzreiz jāpiemin, ka ne visas veiktās darbības klasifikatora ierakstam maina counter vērtību, kā piemēram, nomenklatūru atlikumu izmaiņas - tās nav izmaiņas nomenklatūras kartītē, bet gan tās atlikumos, kas tiek saglabāti citā tabulā. Nomenklatūru atlikumu atskaite (TNdmNatlSL) nav klasifikators, tā ir atskaite, tajā dati tiek izsaukti no vairākām tabulām, veikti aprēķini un rezultāts attēlots lietotājam. Te sync resursi nav izmantojami, tas neatlasa datus pēc izmaiņām atlikumos, bet gan pēc izmaiņām tieši nomenklatūras kartītē.   Detalizētāks apraksts par sinhronizāciju atrodams dokumentācijā.

Horizon izejošajiem rēķiniem (rēķiniem par pakalpojumiem) var būt definēti vairāki dokumentu tipi. Pievienojot jaunu rēķinu obligāti jānorāda ar kuru dokumenta tipu tas tiks veidots. Ja Horizon ir vairāki dokumentu tipi, tad Horizon lietotāji nosaka kuru dokumentu tipu integrācijai izmantot. Rēķinu dokumentu tipu sarakstu iespējams iegūt:  GET ../rest/TNdmPvzRek/template   PVN aprēķinu Horizon nevar koriģēt, tas ir iebūvēts sistēmas mehānisms. Rekomendējam uz Horizon padot skaitļus ar PVN. Šādā gadījumā nepieciešams izmantot dokumentu tipu, kurā PVN ir iekļauts.   Horizon lietotājs rēķinus ievada Dokumenti -> Realizācija -> Rēķinu saraksts.   POST ../rest/TNdmPvzRek/template/{pk} <resource>     <entity>         <PK_DOKT>27</PK_DOKT>         <PK_KLIENTS>162</PK_KLIENTS>         <DAT_DOK>2023-10-27</DAT_DOK>         <DOK_NR>test_REST</DOK_NR>         <PK_LIG>207</PK_LIG>         <APM_TERM>2023-10-31</APM_TERM>         <qryPamat>              <row>                  <PAMAT>Rēķina pamatojums</PAMAT>             </row>         </qryPamat>         <tblRindas>             <row>                 <RN_VEIDS>3</RN_VEIDS>                  <PK_NOM>36</PK_NOM>                 <DAUDZ>1</DAUDZ>                 <CENA>10</CENA>                 <SUMMA>10</SUMMA>                 <TEKSTS>Rindas piezīmes</TEKSTS>             </row>         </tblRindas>     </entity> </resource>   PK_KLIENTS - klienta kartītes sistēmas ID (../rest/TDdmKDebSar/default) PK_LIG - klienta līguma sistēmas ID, nav obligāts (rest/TdmKllig/default) RN_VEIDS - rindas tips, pakalpojums - 3 PK_NOM - pakalpojuma sistēmas ID (../rest/TNdmPakSar/default) CENA un SUMMA - aizpildīt nepieciešams vienu no vērtībām   Vairāk par darbu ar klienta kartītēm skatīt šo rakstu.

Ja nepieciešamos valūtas kursus nevar iegūt ar sistēmas automātiskajām integrāciju iespējām, tad tos ir iespējams importēt no REST.   POST .../rest/TsdmVKurSar/import <resource> <CurrencyRates> <dataset> <row> <DATE>2023-03-20</DATE> <CURRENCY>USD</CURRENCY> <UNITS>1</UNITS> <RATE>0.7</RATE> </row> <row> <DATE>2023-03-20</DATE> <CURRENCY>GBP</CURRENCY> <UNITS>1</UNITS> <RATE>1.4</RATE> </row> <row> <DATE>2023-03-20</DATE> <CURRENCY>FIM</CURRENCY> <UNITS>1</UNITS> <RATE>1.1</RATE> </row> <row> <DATE>2023-03-20</DATE> <CURRENCY>CHF</CURRENCY> <UNITS>1</UNITS> <RATE>1.4</RATE> </row> </dataset> </CurrencyRates> </resource> DATE - valūtas kursa datums. Formāts: YYYY-MM-DD CURRENCY - valūtas kods UNITS - vienību skaits RATE - kurss   Metode atgriež veiksmīgi importēto valūtu kursu skaitu.   Svarīgi! Ja Horizon tiek pievienota jauna valūta, tad REST serveris jārestartē!

Informācija par precēm Horizon tiek uzskaitīta nomenklatūras kartītē un citos saistītajos datos, taču internetveikalam visbiežāk nepieciešamais būs atrodams dažos REST resursos.   Nomenklatūru saraksts ir kopējais saraksts, kur izgūt datus par precēm (Pamatdati - Noliktava - Nomenklatūras). GET ../rest/TNdmNomSar/query?columns=N_PK_NOM,N_KODS,N_NOSAUK,VIEN_KODS,G_PK_NOMGR,G_NOSAUK,KBATL_DAUDZ&filter=N_STATUSS eq 0 N_PK_NOM - nomenklatūras sistēmas ID G_PK_NOMGR - nomenklatūras grupas, kurai pieder nomenklatūra, sistēmas ID KBATL_DAUDZ - nomenklatūras brīvais atlikums uzņēmumā N_STATUSS - filtrēšana pēc nomenklatūras statusa, 0 - aktīvas kartītes   Nomenklatūru grupas klasificē visas nomenklatūras, un tas ir hierarhisks saraksts (Pamatdati - Noliktava - Kartītēm - Grupas). GET ../rest/TNdmNomGrSar/query?columns=G_PK_NOMGR,G_NOSAUK,VGR_PK_NOMGR,VGR_NOSAUK G_PK_NOMGR - nomenklatūras grupas sistēmas ID VGR_PK_NOMGR - nomenklatūras grupas virsgrupas ID   Nomenklatūru attēlus Horizon visbiežāk saglabā kartītes pievienotajos failos. Lai izgūtu šos failus vispirms jāizsauc katras kartītes failu sarakstu, kurā var uzzināt to sistēmas ID. GET ../rest/TNdmNom/1/attachments   Pēc tam katru failu var izsaukt, piemēram, base64 kodējumā. Vairāk par darbu ar pievienotajiem failiem skatīt REST dokumentāciju  GET ../rest/TNdmNom/1/attachments/88?bindata=embed   Tā kā pārdošanas cenas Horizon ir iespēja definēt dažādi, esam izveidojuši atsevišķu rakstu, doties uz rakstu

Tā kā Horizon ir iespēja dažādos veidos definēt pārdošanas cenas, var atšķirties resurss, kurā noskaidrot šobrīd aktuālo cenu. Zemāk apskatīsim biežāk sastopamās konfigurācijas, un kur var uzzināt aktuālo cenu.   1. Tiek lietoti pārdošanas cenu veidi Šādā situācijā cenas var noskaidrot nomenklatūru sarakstā, jo tajā vienmēr tiks attēlota izsaukuma brīdī spēkā esošā cena. GET ../rest/TNdmNomSar/query?columns=N_KODS,N_NOSAUK,CEN_CENA   Var skatīties arī kopējo pārdošanas cenu sarakstu, kurā izmanto kritēriju - šodien spēkā esošās cenas. GET ../rest/TdmNCenTabSar/query?criteria=CENAS_TODAY&columns=N_KODS,N_NOSAUK,CENA_CENA,VAL_KODS,CV_NOSAUK,CENA_NO_DAT,CENA_LIDZ_DAT   Vai arī skatīties atskaiti ar noteiktu datumu - Pavadzīmes cenu saraksts. GET ../rest/TNCenPvzSar/query?qrDat=2023-06-05&qrNol=8&columns=N_KODS,KL_NOSAUK,N_NOSAUK,CV_NOSAUK,CENA_CENA,CENATL_CENA_ATL,CENA_NO_DAT,CENA_LIDZ_DAT CENA_CENA - pamata cena CENATL_CENA_ATL - gala cena   2. Tiek lietotas atlaides Ja Horizon ir definētas atlaides (Pamatdati - Noliktava - Atlaides), tad gala cenu ir iespējams uzzināt atskaitē Pavadzīmes cenu saraksts. Šajā atskaitē varēs uzzināt, kāda ir pamata cena, piemērotā atlaide, tās periods un gala cena. GET ../rest/TNCenPvzSar/query?qrDat=2023-06-05&qrNol=8&columns=N_KODS,KL_NOSAUK,N_NOSAUK,CV_NOSAUK,CENA_CENA,CENATL_CENA_ATL,CENA_NO_DAT,CENA_LIDZ_DAT,ATLR_LIKME,ATLR_BEIG_DAT,ATLR_SAK_DAT CENA_CENA - pamata cena CENATL_CENA_ATL - gala cena   3. Tiek lietotas akcijas cenas (no 620. versijas) Sākot ar 620. versiju ir veiktas izmaiņas pārdošanas cenām, kas ļauj ievadīt akcijas cenas noteiktā periodā. Vairāk par cenu funkcionalitāti https://community.visma.com/t5/Zinasanu-baze/Ka-HORIZON-fikset-AKCIJAS-cenu-precei/ta-p/583334 Akcijas cenas iespējams iegūt kopējā pārdošanas cenu sarakstā. Te gan jāņem vērā, ka jaunā Horizon funkcionalitāte pieļauj vienā periodā, vienam pārdošanas cenas veidam fiksēt vairākas akcijas cenas, bet ar atšķirīgām prioritātēm. GET ../rest/TdmNCenTabSar/query?criteria=CENAS_TODAY&columns=N_KODS,N_NOSAUK,CENA_CENA,VAL_KODS,CV_NOSAUK,CENA_NO_DAT,CENA_LIDZ_DAT,CENA_AKCIJA,CENA_PIEZIMES,CENA_PRIORITATE,AKCENSTARP,LAST30CEN_CENA CENA_CENA - cena CENA_AKCIJA - pazīme, vai tā ir akcijas cena CENA_PRIORITATE - akcijas cenas prioritāte AKCENSTARP - starpība starp akcijas cenu un pamata cenu LAST30CEN_CENA - minimālā cena pirms akcijas pēdējās 30 dienas   Akcijas cenu var apskatīt arī atskaitē Pavadzīmes cenu saraksts GET ../rest/TNCenPvzSar/query?qrDat=2023-06-05&qrNol=8&columns=N_KODS,KL_NOSAUK,N_NOSAUK,CV_NOSAUK,CENA_CENA,CENATL_CENA_ATL,CENA_NO_DAT,CENA_LIDZ_DAT,AKCCEN_CENA,AKCCEN_NO_DAT,AKCCEN_LIDZ_DAT,AKCCEN_PRIORITATE,AKCCEN_PIEZIMES CENATL_CENA_ATL - gala cena AKCCEN_NO_DAT,AKCCEN_LIDZ_DAT - akcijas cenas periods AKCCEN_PIEZIMES - akcijas cenas piezīmes   4. Tiek lietotas līgumcenas Ja Horizon tiek ievadītas līgumcenas (Pamatdati - Noliktava - Līgumcenas), tās var noskaidrot šajā pašā sarakstā izsaucot datus ar kritēriju - šodien spēkā esošā cena. GET ../rest/TNdmLigumCenSar/query?criteria=CENAS_TODAY&columns=K_KODS,K_NOSAUK,N_KODS,N_NOSAUK,CENA_CENA,VAL_KODS,CV_NOSAUK,CENA_NO_DAT,CENA_LIDZ_DAT   Tāpat var skatīties jau iepriekš pieminēto atskaiti - Pavadzīmes cenu saraksts, kur laukā CV_NOSAUK būs norāde, ka šī ir līgumcena. GET ../rest/TNCenPvzSar/query?qrDat=2023-06-05&qrNol=8&columns=N_KODS,KL_NOSAUK,N_NOSAUK,CV_NOSAUK,CENA_CENA,CENATL_CENA_ATL,CENA_NO_DAT,CENA_LIDZ_DAT   Klasifikatoru sinhronizācija Tā kā pārdošanas cenas no 620. versijas ir pārveidotas par saistītājiem datiem, tām tagad ir pieejams sinhronizēšanas mehānisms SYNC. Vairāk par to var lasīt dokumentācijā https://horizon-rest-doc.visma.lv/lv/Guide/RestManual?ContentId=282067233  

Rādījumu ielāde izmantojot Horizon REST notiek pa vienam rādījumam. Horizon iespējami dažādi rādījumu veidi. Kontrolskaitītāju rādījumi - Kontrolskaitītāji ir skaitītāji, kuri nav tieši piesaistīti konkrētam līgumam, piemēram, daudzdzīvokļu mājas ievadskaitītājs, ja rēķini tiek izrakstīti katram dzīvoklim. Līgumu skaitītāju rādījumu reģistrēšanai iespeājams izvēlēties vienu no šiem variantiem: Līgumu skaitītāju rādījumi - rādījums tiek reģistrēts uzreiz konkrētam līgumam par periodu Nolasītie rādījumi - rādījums tiek reģistrēts tikai uz skaitītāja eksemplāru, konkrētā datumā. Pēc tam sistēmas lietotājs veiks pārlasīšanu uz līguma rādījumiem, kur rādījums tiks piesaistīts līgumam un periodam. Lai reģistrētu rādījumu nepieciešams zināt skaitītāja eksemplāra sistēmas ID. Par to, kas Horizon ir skaitītāja eksemplārs skatiet šeit. Lai atrastu visus skaitītāja eksemplārus, kas ir derīgi konkrētā datumā, iespējams izmantot vaicājumu /rest/TdmPNSSkaEksSL/query?columns=PSKR_NUMURS,PSKR_SPEKA_NO,PSKR_SPEKA_LIDZ&criteria=CRT_INPER&PerLidz=2017-04-13&PerNo=2017-04-13   Parasti skaitītāju rādījumi tiek pievienoti sagataves statusā un tos pēc tam apstiprina Horizon lietotājs. Ja nepieciešams rādījumu plūsmu veidot savādāk, tad var izmantot <STAD>, lai norādītu rādījuma stadiju.   Līgumu skaitītāju rādījumi   POST <REST server>/rest/TdmPNSSkaLigRadBL ar sekojošu body: <?xml version="1.0" encoding="UTF-8" standalone="no"?> <resource> <entity> <RAD>12</RAD> <PK_DATAV> <href>/rest/TdmPNSDatAvBL/3</href> </PK_DATAV> <PK_SKAR> <href>/rest/TdmPNSSkaRBL/104</href> </PK_SKAR> <DAUDZ_TIPS>2</DAUDZ_TIPS>   <PIEZIM /> <PER_NO>2019-03-01</PER_NO> <PER_LIDZ>2019-03-31</PER_LIDZ> <PK_LIGR>405</PK_LIGR> </entity> </resource> Kur:   RAD – rādījums PK_DATAV – datu avots (TdmPNSDatAvSL) PK_SKAR – skaitītāja eksemplāra sistēmas ID DAUDZ_TIPS - 2 (Importēts daudzums) PIEZIM – piezīmes PER_NO, PER_LIDZ – rādījuma periods PK_LIGR – līguma "otrās daļas" ID. To var iegūt resursa /rest/TdmPNSLigSL laukā KNLIG.PK_LIGR.   Lai uzzinātu kurā līgumā ir iekļauts skaitītājs konkrētā datumā, iespējams izmantot šādu vaicājumu - /rest/TdmPNSLigAprSkaSL/query?columns= KLIG_NUMURS,KNLIG_PK_LIG,LAPRSKA_SPEKA_NO,LAPRSKA_SPEKA_LIDZ,PSKR_PK_SKAR,PSKR_NUMURS&filter=PSKR_PK_SKAR eq '30' and LAPRSKA_SPEKA_NO le 2022-08-31 and (isnull(LAPRSKA_SPEKA_LIDZ) or LAPRSKA_SPEKA_LIDZ ge 2022-08-31)   Viens skaitītāja eksemplārs var būt piesaistīts līgumam vairākas reizes, ja nodrošina vairāku pakalpojumu aprēķinu. Viens skaitītāja eksemplārs var būt piesaistīts vairākiem līgumiem, ja tā nepieciešams pēc aprēķina nosacījumiem.   Lai iegūtu līguma "otrās daļas" ID atrasto KNLIG_PK_LIG nepieciešams izmantot šādā vaicājumā -/rest/TdmPNSLigSL/query?columns= KLIG_PK_LIG,KNLIG_PK_LIGR&filter=KLIG_PK_LIG eq '221'   Nolasītie rādījumi POST <REST server>/rest/TdmPNSSkaNolRadBL ar sekojošu body: <?xml version="1.0" encoding="UTF-8" standalone="no"?> <resource>  <entity>     <DATUMS>2022-03-01</DATUMS> <RAD>12</RAD> <PK_DATAV> <href>/rest/TdmPNSDatAvBL/3</href> </PK_DATAV> <PK_SKAR> <href>/rest/TdmPNSSkaRBL/104</href> </PK_SKAR>    <DAUDZ_TIPS>2</DAUDZ_TIPS>    <PIEZIM /> </entity> </resource> Kur: DATUMS – rādījuma nolasīšanas datums RAD – rādījums PK_DATAV – datu avots (TdmPNSDatAvSL) PK_SKAR – skaitītāja eksemplāra sistēmas ID DAUDZ_TIPS - 2 (Importēts daudzums) PIEZIM – piezīmes   Kontrolskaitītāju rādījumi   POST <REST server>/rest/TdmPNSSkaKontrSkaRadBL   <resource> <description>Jauna ieraksta sagatave</description> <entity> <RAD>20</RAD> <PK_DATAV/> <PK_SKAR>42</PK_SKAR> <DAUDZ_TIPS>2</DAUDZ_TIPS> <PIEZIM/> <PER_NO>2020-02-01</PER_NO> <PER_LIDZ>2020-02-29</PER_LIDZ> </entity> </resource> Kur: RAD – rādījums PK_DATAV – datu avots (TdmPNSDatAvSL) PK_SKAR – skaitītāja eksemplāra sistēmas ID DAUDZ_TIPS - 2 (Importēts daudzums) PIEZIM – piezīmes PER_NO, PER_LIDZ – rādījuma periods    

Visma Horizon pieejamas standartizētas integrācijas ar dažādām trešo pušu sistēmām.   Risinājuma abonēšana pieejama šādā komplektācijā:   Kods (idenitifikators) Nosaukums VHOP07_ABO Visma integrācija API ar trešajām sistēmām. Abonements uz 1 gadu. VHOP08_ABO VISMA Horizon platformas saskarne (API) Aktīvās direktorijas integrācijai. Abonements uz 1 gadu.   Lietotāja rokasgrāmata    Lietotāju apmācība un rokasgrāmata tiek izveidota projekta laikā.   Instalācijas instrukcija   Instalāciju veic ieviešanas projekta laikā Visma speciālisti.   Programmatūras tehniskais apraksts    ŠEIT ir pieejams risinājuma funkcionālais un tehniskais apraksts.   Ražotājs   Visma Enterprise SIA

Šajā rakstā pieejams dokuments par to, kas jāzina, lai veiktu sistēmu integrāciju, izmantojot REST.

Ja dati par jauniem darbiniekiem primāri tiek ievadīti, piemēram, personāla atlases sistēmā, dokumentu pārvaldības sistēmā vai kādā citā uzņēmumā izmantotā datu bāzē, tad, lai nepārvadītu darbinieka datus manuāli, iespējams izveidot jaunu darbinieka kartīti Horizon, izmantojot Rest.   Šeit apskatīta darbinieka kartītes izveide Horizon sarakstā Pamatdati -> Personāla uzskaite -> Personu kartītes.   Pievienojot jaunu personas kartīti, obligāti jānorāda, ar kuru dokumenta tipu tā tiks veidota. Horizon var būt izveidoti vairāki personas kartīšu dokumentu tipi, piemēram, rezidentiem (ar personas koda pārbaudi) un nerezidentiem. Personu kartīšu dokumentu tipu sarakstu var iegūt:       GET ../rest/TdmDarbBaseBL/template       POST vaicājuma piemērs personas kartītes izveidei ar minimālo obligāti aizpildāmo informācijas apjomu:       POST .../rest/TdmDarbBaseBL/template/{pk} <resource> <entity> <PK_DOKT> <href>/rest/TdmDocType/{pk}</href> </PK_DOKT> <PAMV_ID>6010</PAMV_ID> <TNUM>0000</TNUM> <FNAME>Vārds</FNAME> <LNAME>Uzvārds</LNAME> <PERS_KODS>000000-00000</PERS_KODS> <DZIM_DAT>YYYY-MM-DD</DZIM_DAT> <DZIMUMS>1</DZIMUMS> <STATUSS>0</STATUSS> <PK_VALSTS> <href>/rest/TdmBLDValsts/1</href> </PK_VALSTS> <admPerBaseBL> <row> <SPEKA_NO>YYYY-MM-DD</SPEKA_NO> <DOCOPYADR>0</DOCOPYADR> </row> </admPerBaseBL> <pudmBildeBL> <row> <BILDE> <data></data> </BILDE> </row> </pudmBildeBL> </entity> </resource>       {pk} -  Vajadzīgā personas kartītes dokumenta tipa primārā atslēga; DZIMUMS - Sieviete='1', Vīrietis='2'; STATUSS - Sagatave='0', Apstiprināts='1'; TdmBLDValsts/{pk} rezidences valsts no valstu saraksta Horizon (Pamatdati -> Uzņēmums -> Valsts); TNUM - tabeles (kartītes) numurs - var nebūt, ja Horizon ir izveidots automātisks numerators; BILDE - personas fotoattēla dati base64 kodējumā.  

Dažādām ar personāla vadību saistītām integrācijām ir nepieciešams no Horizon sistēmas izgūt datus par darbiniekiem. Piemēram, ārpus Horizon tiek uzturēta darbinieku kontaktu grāmata, tiek ģenerētas obligāto veselības pārbaužu kartes vai drukātas darba apliecības. Lai to izdarītu, nepieciešami darbinieku dati, tādi kā pamatinformācija, kontaktinformācija, amats utml.   Vispirms jāsaprot, cik daudz, kādi tieši un cik detalizēti dati būs nepieciešami.    Horizon sistēmā darbinieka dati tiek uzkrāti vairākos sarakstos ar atšķirīgu detalizāciju un datu apjomu. Atkarībā no tā, kādus datus nepieciešams izgūt, var izmantot šādus sarakstus:   1. Personu kartītes Pamatdati -> Personāla uzskaite -> Personu kartītes Sarakstā atrodami darbinieka pamatdati, piemēram, tabeles (kartītes) numurs, vārds, uzvārds, personas kods, dzimums, kontaktinformācija, adrese, kā arī ar darbinieku saistīti dati, piemēram, identifikācijas, izglītības dokumenti u.c. No šī saraksta iespējams izgūt arī informāciju par darbinieka vienām galvenajām tiesiskajām attiecībām un šo tiesisko attiecību pamata amata datiem.   PIEMĒRI:         1. Šobrīd aktīvo darbinieku kontaktinformācija ar pamata amatu un struktūrvienību: GET .../rest/TdmDArbSar/query?CRITERIA=AKTIVIE&columns=ERS_PK_PERS,ERS_TNUM,ERS_FNAME,ERS_LNAME,ERS_PERS_KODS,ERS_DZIMUMS,ERS_EPASTS,ERS_TELEFONS,PSADM_NOSAUK,PSAMA_NOSAUK CRITERIA=AKTIVIE - atlasīt tikai darbiniekus ar spēkā esošām tiesiskajām attiecībām. ERS_PK_PERS - personas kartītes sistēmas ID (primārā atslēga); ERS_TNUM - personas kartīties (tabeles) numurs; ERS_FNAME,ERS_LNAME - vārds, uzvārds; ERS_PERS_KODS - personas kods; ERS_DZIMUMS - dzimums (sieviete="1", vīrietis="2") ERS_EPASTS - darba e-pasts; ERS_TELEFONS - darba telefons; PSADM_NOSAUK - administratīvā struktūrvienība (pamatslodzes); PSAMA_NOSAUK - amata nosaukums (pamatslodzes).         2. Šādu vaicājumu var papildināt ar vēl citiem laukiem un filtriem, piemēram, atlasīt tikai tos darbiniekus, kuriem tiesiskajās attiecībās Ienākuma veids ir darba alga (rezidenti un nerezidenti): GET .../rest/TdmDArbSar/query=AKTIVIE&columns=ERS_PK_PERS,ERS_TNUM,ERS_FNAME,ERS_LNAME,ERS_EPASTS,ERS_TELEFONS,PSADM_NOSAUK,PSAMA_NOSAUK,LAT_PK_LIGA,LAT_NUMURS,LAT_SAK_DAT,LAT_BEIG_DAT,IEN_KODS&filter=inlist(IEN_KODS, '1001', '15', '1066') inlist(IEN_KODS, '1001', '15', '1066') - ienākumu veids ir VIENS NO norādītajām vērtībām.   LAT_PK_LIGA - tiesisko attiecību sistēmas ID (primārā atslēga); LAT_NUMURS - tiesisko attiecību numurs; LAT_SAK_DAT,LAT_BEIG_DAT - tiesisko attiecību no/līdz datumi; IEN_KODS - ienākumu veida kods.       3. Kā izgūt darbinieka fotoattēlu?  Ja pie darbinieka kartītes pievienota fotogrāfija, to iespējams izgūt, piemēram, base64 kodējumā. Jāveido pieprasījums personas kartītei (entītes ierakstam), iekļaujot šādu parametru: GET ...rest/TdmDarbBaseBL/{pk}?bindata=embed {pk} - personas kartītes sistēmas ID (primārā atslēga) Pieprasījuma atbildē tiks atgriezts bināro lauku saturs base64 kodējumā.   2. Darbinieku tiesisko attiecību dati Pamatdati -> Personāla uzskaite -> Tiesiskās attiecības Sarakstā apkopota informācija par visām darbinieka tiesiskajām attiecībām - darba, uzņēmuma, autoratlīdzības u.c. līgumiem. Sarakstā iespējams izgūt, piemēram, līgumu numurus, veidus, sākuma, beigu datumus, ziņas par pārbaudes laiku, ja tāds noteikts utml. Šo sarakstu var izmantot, ja ar vienu darbinieku vienlaikus ir noslēgts vairāk par vienu darba/uzņēmuma līgumu. Sarakstā nebūs redzami darbinieki, kuriem nav spēkā nevienas tiesiskās attiecības. Šajā sarakstā var izgūt arī darbinieka pamatdatus, kontaktinformāciju u.c. datus no personas kartītes, kā arī ziņas par katra darba līguma pamatslodzi (amata nosaukums, profesija, administratīvā struktūrvienība, atalgojums utml.).   PIEMĒRS: GET ...rest/TdmLigAttSar/query?CRITERIA=AKTIVIE&columns=ERS_TNUM,ERS_FNAME,ERS_LNAME,ERS_PERS_KODS,LAT_PK_LIGA,LAT_NUMURS,LAT_SAK_DAT,LAT_BEIG_DAT,LAT_PARB_BEIG,IEN_KODS,PSADM_NOSAUK,PSAMA_NOSAUK   CRITERIA=AKTIVIE - atlasīt tikai spēkā esošas tiesiskās attiecības.   ERS_TNUM - personas kartīties (tabeles) numurs; ERS_FNAME,ERS_LNAME - vārds, uzvārds; ERS_PERS_KODS - personas kods; LAT_PK_LIGA - tiesisko attiecību sistēmas ID (primārā atslēga); LAT_NUMURS - tiesisko attiecību numurs; LAT_SAK_DAT,LAT_BEIG_DAT - tiesisko attiecību sākuma, beigu datums; IEN_KODS - ienākumu veida kods; PSADM_NOSAUK - administratīvā struktūrvienība (pamatslodzes); PSAMA_NOSAUK - amata nosaukums (pamatslodzes).   3. Darbinieku amatu dati (slodzes) Pamatdati -> Personāla uzskaite -> Personu amatu dati Sarakstā apkopota informācija par darbinieka visu tiesisko attiecību visiem amatu datiem - pamatslodzēm un papildslodzēm, ja tādas ir - amatu nosaukumi, profesijas, administratīvās struktūrvienības, atalgojums utt. Šo sarakstu izmanto, ja nepieciešama detalizēta informācija par visām darbinieka slodzēm, piemēram, ja darbinieks strādā vienlaikus vairākos amatos, struktūrvienībās. Sarakstā iespējams izgūt arī datus no darbinieka personas kartītes (pamatdatus, kontaktinformāciju u.c.), kā arī datus par katras slodzes tiesiskajām attiecībām (līguma numuru, sākuma, beigu datumus u.c.). Sarakstā nebūs redzami darbinieki, kuriem nav spēkā esošu amata datu.    PIEMĒRS: GET ...rest/TadmSlSar/query?CRITERIA=CRIT_LAT_AKTIVIE&columns=ERS_TNUM,ERS_FNAME,ERS_LNAME,LAT_NUMURS,PK_SLODZE,DOK_NR,SAK_DAT,BEIG_DAT,PK_APMAKSA,SUMMA,STR_NOSAUK,VAM_NOSAUK,SL_TIPS   CRITERIA=CRIT_LAT_AKTIVIE - darbiniekam ir vismaz vienas spēkā esošas tiesiskās attiecības.   ERS_TNUM - personas kartīties (tabeles) numurs; ERS_FNAME,ERS_LNAME - vārds, uzvārds; LAT_NUMURS - tiesisko attiecību numurs; PK_SLODZE - personas amata datu sistēmas ID (primārā atslēga); DOK_NR - personas amata datu numurs; SAK_DAT,BEIG_DAT - personas amata dati "no"/"līdz"; PK_APMAKSA - apmaksas veids:            Alga proporcionāli dienām = 1            Stundas tarifa likme = 2            Gabaldarbs = 3            Dienas apmaksa = 4            Alga proporcionāli stundām = 5 SUMMA - likme (atalgojuma likme); STR_NOSAUK - struktūrvienības nosaukums; VAM_NOSAUK - amata nosaukums; SL_TIPS - slodzes tips (pamatslodze = 1; papildslodze = 2)   4. Atskaites Darbinieki periodā un Personu amatu dati periodā Atskaites -> Personāla uzskaite -> Statistika -> Darbinieki periodā Atskaites -> Personāla uzskaite -> Statistika -> Personu amatu dati periodā   No šīm atskaitēm izgūstama tā pati informācija, kas no personu kartīšu un amatu datu sarakstiem. Atšķirība ir tajā, ka atskaitei jānorāda periods, par kuru vēlamies redzēt datus, tādēļ no atskaitēm būs iespējams izgūt vēsturiskos datus, piemēram, par darbinieku skaitu, amatiem pirms gada utml.    PIEMĒRI: GET ...rest/TdmDArbSar2/query?NO_DAT=2022-11-01&LIDZ_DAT=2022-11-30&columns=ERS_TNUM,ERS_FNAME,ERS_LNAME,ERS_PERS_KODS,ERS_DZIMUMS,IEN_KODS,LAT_NUMURS,LAT_SAK_DAT,LAT_BEIG_DAT,PSADM_NOSAUK,PSAMA_NOSAUK GET ...rest/TadmSlSar2/query?NO_DAT=2022-11-01&LIDZ_DAT=2022-11-30&columns=ARD_TNUM,ERS_FNAME,ERS_LNAME,ERS_PERS_KODS,ERS_DZIMUMS,LAT_NUMURS,LAT_SAK_DAT,LAT_BEIG_DAT,SLODZE,DOK_NR,SAK_DAT,BEIG_DAT,SUMMA,STR_NOSAUK,VAM_NOSAUK