Zināšanu bāze Integrācija

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.      

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ā.  

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  

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.

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ē!

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>  

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)

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

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          

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    

Sākot ar 680 versiju, REST ir pieejama jauna funkcija, kas ļaus mainīt saistību dokumenta apmaksas termiņu. Šī darbība ir veidota pēc līdzības ar Horizon pieejamo darbību Dokumenti -> Apgāde/Realizācija -> Preču dokumenti -> Darbības -> Mainīt apmaksas termiņu, un tagad būs pieejama arī integrācijām. Apmaksas termiņu iespējams mainīt izpildītiem un grāmatotiem debitoru/kreditoru saistību dokumentiem. Jāņem vērā, ka apmaksas termiņa maiņa var ietekmēt kavējuma naudas aprēķinus, apmaksas kontroļu rezultātus un atskaites, kurās tiek izmantots dokumenta apmaksas termiņš.  Darbības izsaukšana REST Apmaksas termiņa maiņa tiek veikta konkrētā dokumenta entītes resursā, izmantojot metodi changeDueDate. Metodes izsaukšanas piemērs dokumenta pamatveidam Rēķins par pakalpojumiem:   POST ../rest/TNdmPvzRek/changeDueDate Metodes izsaukšanas piemērs dokumenta pamatveidam Saņ. rēķins par pakalpojumiem:   POST /rest/TNdmPvzRekS/changeDueDate Pieprasījuma piemērs:   <resource>    <aPkDok>{PK}</aPkDok>    <aDueDate>yyyy-mm-dd</aDueDate>    <aDueDateChangeAlgorithm>0</aDueDateChangeAlgorithm> </resource>   Pieprasījuma parametru apraksts: aPkDok – dokumenta sistēmas ID, kuram nepieciešams mainīt apmaksas termiņu ; aDueDate – jaunais apmaksas termiņa datums; aDueDateChangeAlgorithm – apmaksas termiņa noteikšanas veids: 0 – izmantot parametrā aDueDate norādīto datumu; 1 – izmantot dokumentam piesaistītā līguma apmaksas termiņu. Ja tiek izmantots algoritms 1, parametrs aDueDate nav obligāts — norādītā vērtība netiks izmantota, jo termiņš tiks noteikts no dokumentam piesaistītā līguma.   

Kas ir notikumu sūtītājs? Funkcionalitāte, kas automātiski nosūta informāciju par izmaiņām uz ārējām sistēmām, izmantojot webhook mehānismu. Tas ļauj integrēt Horizon ar citām sistēmām reāllaikā, automātiski nosūtot datus par notikumiem, piemēram, lietotāju izmaiņām vai nomenklatūru atlikumiem. Horizon ceļš: Sistēma -> Datu apmaiņa -> Notikumu sūtītājs     Lai aktivizētu notikumu sūtītāju ir jāizpilda sekojoši soļi: 1. Atveriet izvēlni Sistēma → Datu apmaiņa → Notikumu sūtītājs → Notikumu sūtītāja metodes un nospiediet pogu Jauns. 2. Pamatinformācijas aizpildīšana Aizpildiet galvenos obligātos laukus: • Kods: Ievadiet unikālu identifikatoru,  • Nosaukums: Ievadiet metodei saprotamu nosaukumu • Notikuma veids: Izvēlieties vajadzīgo tipu, piemēram, "WEB lietotāji" vai "Nomenklatūru brīvie atlikumi". Svarīgi! Ja izvēlaties Nomenklatūru brīvos atlikumus, sadaļā "Konfigurācija" obligāti  jāizvēlas esošs vai jāizveido jauns datu filtrs. 3. Metodes aktivizēšana un adreses norādīšana • Statuss: Lai metodi aktivizētu, izvēlieties statusu Aktīvs. • Endpoint: Ievadiet ārējās sistēmas URL adresi, uz kuru sūtīt datus (adresei obligāti jāsākas ar https://). 4. Autentifikācija un sūtīšanas laiki • Autentifikācija: Izvēlieties Bez auth (ja ārējā adrese ir publiska) vai Basic auth (ievadot lietotājvārdu un paroli). • Periodiskums: Varat atstāt noklusētos iestatījumus, kas sūtīs datus ik pēc 5 minūtēm darba laikā no 06:00 līdz 21:00, vai arī pielāgot tos savām vajadzībām.   Lai strādātu ar notikumu sūtītāju, nepieciešamas tiesības: Sistēma → Datu apmaiņa → Notikumu sūtītāja metodes → Apskatīt Sistēma → Datu apmaiņa → Notikumu sūtītāja metodes → Labot Notikumu sūtītājs būs pieejams visiem, kam ir Integrāciju paka.   Kā strādā notikumu sūtītājs? • Notikumu reģistrēšana: Kad Horizon sistēmā notiek piesaistītās izmaiņas (piemēram, saglabājot saņemšanas dokumentu vai ievadot kases dokumentu, mainās nomenklatūru atlikumi), sistēma fiksē šo notikumu datubāzē ar statusu "Jauns". Ja metodei ir iestatīta konfigurācija jeb filtri, sistēma pirms tam pārbauda, vai notikums atbilst noteiktajiem kritērijiem. • Datu formēšana: Reģistrētie notikumi tiek apkopoti un pārvērsti JSON formātā. Lai optimizētu datu pārraidi, vairāki atsevišķi notikumi pirms sūtīšanas tiek apvienoti vienā datu pakā. • Nosūtīšanas process (Serviss): Fona serviss seko līdzi iestatītajam periodiskumam (piemēram, ik pēc 5 minūtēm atļautajā laika intervālā) un ģenerē HTTP POST pieprasījumus uz ārējās sistēmas adresi (Endpoint). Ja konfigurācijā ir norādīta Basic auth autentifikācija, serviss automātiski pievieno autentifikācijas galveni HTTP pieprasījumam. • Atbildes apstrāde un atkārtošana: Lai sūtījums tiktu uzskatīts par veiksmīgu, ārējai sistēmai ir jāatgriež HTTP statusa kods 200-299. Ja saziņa neizdodas tīkla vai ārējās sistēmas kļūdas dēļ, Horizon serviss piešķir ierakstam statusu "Tiks sūtīts atkārtoti" (īslaicīga aizture pirms atkārtota mēģinājuma) vai "Neizdevās nosūtīt" (atkārtos nākamajā plānotajā ciklā). Ja tiek sasniegts maksimālais atļautais neveiksmīgo mēģinājumu skaits, metode tiek automātiski deaktivizēta aizsardzības nolūkos. • Automātiskā uzturēšana: Lai sistēma nepārpildītos ar veciem žurnālu datiem, katru dienu ārpus darba laika automātiski tiek dzēsti veiksmīgi nosūtītie ieraksti un dublikāti (vecāki par 10 dienām), kā arī kļūdainie ieraksti (vecāki par 30 dienām).   Kā atsekot sūtāmajiem notikumiem? Horizon Notikumu sūtītāja funkcionalitāte ietver divus žurnālu sarakstus, kas nepieciešami datu nosūtīšanas procesa uzraudzībai, pārbaudei un kļūdu (piemēram, nepiegādātu datu vai nepieejamas ārējās adreses) identificēšanai. 1. Notikumu sūtītāja ierakstu žurnāls: Parāda visus atsevišķos notikumus, kas reģistrēti sistēmā. Tas ir nepieciešams, lai detalizēti izsekotu katra konkrētā notikuma stāvoklim, redzētu tā reģistrēšanas datumu un metodi, kas atbild par šī notikuma apstrādi. 2. Notikumu sūtītāja paku žurnāls: Parāda nosūtītās notikumu pakas, jo bieži vien vairāki notikumi tiek apvienoti vienā pakā. Šis žurnāls ir noderīgs, lai pārraudzīt kopējo uz ārējās sistēmas adresi (endpoint URL) nosūtīto datu plūsmu un pakas piegādes gaitu.   Sistēmas žurnālos ierakstiem var būt dažādi statusi, kas atspoguļo to apstrādes fāzi (paku žurnālā statusi ir analogi atsevišķu ierakstu statusiem): • Jauns: Notikums ir reģistrēts, taču serviss vēl nav mēģinājis to nosūtīt. Ja saņēmēja adrese ir aktīva, piegāde notiks nākamajā plānotajā sūtīšanas reizē. • Tiks sūtīts atkārtoti: Īslaicīgs statuss, ko izmanto īslaicīgu problēmu, piemēram, tīkla pārtraukumu, risināšanai. Tas nozīmē, ka sūtīšana tikko neizdevās, bet serviss ar nelielu aizturi tūlīt veiks atkārtotu mēģinājumu. • Neizdevās nosūtīt: Sūtīšanas mēģinājums nav izdevies, bet serviss turpinās mēģināt datus piegādāt nākamajā plānotajā izpildes reizē. Sistēma šādus ierakstus un pakas automātiski dzēš pēc 30 dienām. • Nosūtīts: Gala statuss, kas nozīmē, ka notikums vai paka ir veiksmīgi nosūtīta uz norādīto endpoint adresi. Šie ieraksti automātiski tiek dzēsti pēc 10 dienām. • Dublikāts: Gala statuss, kas norāda, ka notikums netiks sūtīts, jo tā dati sakrīt ar citu jau esošu notikumu. Arī šos ierakstus sistēma izdzēsīs pēc 10 dienām.   Ja notikumi netiek sūtīti, ieteicams veikt šādas pārbaudes, lai identificētu un novērstu problēmu: • Pārbaudiet metodes statusu: Sistēmā metodei obligāti jābūt ar statusu "Aktīvs". Ja tas ir iestatīts kā "Tikai datu vākšana", notikumi tiek uzkrāti žurnālā, bet netiek sūtīti uz ārējo sistēmu. Jāņem vērā, ka metode var tikt automātiski deaktivizēta, ja ir sasniegts maksimālais neveiksmīgo sūtīšanas mēģinājumu skaits (piemēram, ilgstošu ārējās sistēmas traucējumu dēļ). Tādā gadījumā pēc problēmas atrisināšanas statuss manuāli jānomaina atpakaļ uz "Aktīvs". Ja nepieciešams caur REST API noskaidrot vai metode ir aktīva, tad ir jāizmanto TdmEventSenderMethodsBL klase. Rest pieprasījums, lai izsauktu visas metodes:  /rest/TdmEventSenderMethodsSL/query?columns=EVSENDMETH.KODS&EVSENDMETH.NOSAUK&filter=EVSENDMETH.STATUS eq '0' Rest pieprasījums, lai pārbaudītu konkrētu metodi: /rest/TdmEventSenderMethodsSL/query?columns=EVSENDMETH.KODS,EVSENDMETH.NOSAUK,EVSENDMETH.STATUS&filter=EVSENDMETH.PK_EVENTSENDERMETHODS eq '{Metodes PK}'   {Metodes PK} ir  metodes ID. • Pārbaudiet sūtīšanas laika intervālu un nedēļas dienas: Pārliecinieties, vai attiecīgā nedēļas diena ir atzīmēta un vai pašreizējais laiks ietilpst atļautajā sūtīšanas laika intervālā. Ja laiks ietilpst ārpus atļautā intervāla, notikumi turpina uzkrāties, bet tiks nosūtīti tikai nākamajā sūtīšanas logā. • Pārbaudiet notikumu žurnālus: Ieskatieties ierakstu žurnālā un pievērsiet uzmanību statusiem, kas var norādīt uz kļūdām, piemēram, "Neizdevās nosūtīt" vai "Tiks sūtīts atkārtoti". • Pārbaudiet saņēmēja adresi (endpoint): Pārliecinieties, ka URL adrese ir ievadīta pareizi, ietver https:// un ārējā sistēma ir reāli pieejama. • Pārbaudiet autentifikācijas datus: Ja metodei izmantojat Basic auth, vēlreiz pārliecinieties, vai ievadītais lietotājvārds un parole sakrīt ar ārējās sistēmas prasībām.   Kā testēt notikumu sūtīšanu?   1. Izveidojiet testa endpoint adresi: Atveriet vietni https://webhook.site (vai citu līdzīgu servisu), kas uzģenerēs unikālu testa URL adresi un ļaus pārlūkprogrammā reāllaikā redzēt visus saņemtos datus. 2. Iestatiet drošu statusu Horizon: Metodes iestatījumos norādiet iegūto testa URL adresi un izvēlieties statusu "Tikai datu vākšana". Šis statuss ļauj sistēmai reģistrēt notikumus, taču tie netiks uzreiz nosūtīti un pagaidām neparādīsies ierakstu žurnālā. 3. Izveidojiet testa notikumus: Veiciet Horizon sistēmā darbības, kurām vajadzētu izsaukt datu sūtīšanu, piemēram, pievienojiet jaunu WEB lietotāju vai izmainiet nomenklatūras atlikumu. 4. Aktivizējiet sūtīšanu: Nomainiet metodes statusu uz "Aktīvs". Pēc šīs darbības iepriekš savāktie testa notikumi parādīsies ierakstu žurnālā un tiks nosūtīti uz jūsu testa adresi. 5. Pārbaudiet rezultātu: Atgriezieties webhook.site lapā un pārliecinieties, vai dati ir veiksmīgi saņemti.   Kā var deaktivizēt sūtīšanas metodi?   • Automātiska deaktivizācija: Sistēma automātiski deaktivizēs metodi, ja tiks sasniegts maksimālais atļautais neveiksmīgo datu sūtīšanas mēģinājumu skaits. Tas kalpo kā aizsargmehānisms un parasti norāda uz ilgstošām problēmām ar ārējās sistēmas (endpoint) pieejamību vai nepareizu konfigurāciju. Šādā gadījumā ir jāatrod un jāizlabo problēmas cēlonis (piemēram, jāsalabo endpoint adrese vai autentifikācija) un pēc tam metodes statuss manuāli jānomaina atpakaļ uz "Aktīvs", lai sistēma atsāktu datu sūtīšanu. • Manuāla deaktivizācija: Lietotājs var jebkurā brīdī metodi atslēgt pats, metodes kartītē izvēloties statusu "Neaktīvs". Šajā statusā jauni notikumi netiek ne vākti, ne nosūtīti uz ārējo adresi.  

Interneta veikalā veiktos darījumus Horizon var reģistrēt noliktavas modulī ar dokumentu "Pārdošanas pavadzīme". Ja Horizon ir vairāki pārdošanas pavadzīmes dokumentu tipi, tad Horizon lietotāji nosaka, kuru dokumentu tipu integrācijai izmantot. Pārdošanas pavadzīmes dokumentu tipu sarakstu iespējams iegūt ar šādu vaicājumu.   GET ../rest/TNdmPvzSale/template Pārdošanas pavadzīmi veido ar sekojošu vaicājumu.   POST ../rest/TNdmPvzSale/template/{pk} <resource> <entity> <PK_DOKT>5</PK_DOKT> <PAMV_ID>2711</PAMV_ID> <PK_ESPATS>4</PK_ESPATS> <PK_KLIENTS>66</PK_KLIENTS> <DAT_DOK>2025-11-21</DAT_DOK> <PK_VAL>3</PK_VAL> <NdmPvzAddition> <PK_ADRESE>32</PK_ADRESE> </NdmPvzAddition> <qryPamat> <row> <PAMAT>Piezīmes</PAMAT> </row> </qryPamat> <tblRindas> <row> <RN_VEIDS>0</RN_VEIDS> <PK_NOM>1</PK_NOM> <DAUDZ>10</DAUDZ> <FCENA>4.69</FCENA> </row> </tblRindas> </entity> </resource> PK_ESPATS - noliktavas ID, ../rest/TNdmNolSar/default PK_KLIENTS - klienta kartītes sistēmas ID, kā atrast klienta ID DAT_DOK - pavadzīmes datums PK_VAL - valūtas ID PK_ADRESE - klienta piegādes adreses ID PAMAT - pavadzīmes piezīmes 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

Uzņēmumiem, kur, piemēram jaunu darbinieku dati tiek piefiksēti ārpus Horizon un nepieciešams, izmantojot esošos datus, izveidot jaunus WEB lietotājus, ir pieejams REST resurss:  /rest/TdmUsersOBL Piemērs jauna WEB lietotāja izveidei (POST): ___________________________________________________________________________________________________________ <resource>     <entity>         <PAMV_ID>15125</PAMV_ID>         <ACTIVE>1</ACTIVE>         <LOGIN>JANIS_WEB</LOGIN>         <PK_USER>             <href>/rest/TdmUsrView/808</href>         </PK_USER>         <PK_USERSOGRP>             <href>/rest/TdmWebUserGroupBL/1</href>         </PK_USERSOGRP>         <VARDS>Janis</VARDS>         <UZVARDS>Janitis</UZVARDS>         <PERS_KODS>111177-11111</PERS_KODS>         <LOGIN_TYPE>0</LOGIN_TYPE>         <PAROLE_INP>robots</PAROLE_INP>         <USER_TYPE>0</USER_TYPE>         <dmUsersoFirmaRBL>             <row>                 <PK_FIRMA>56</PK_FIRMA>                 <IS_DEFAULT>1</IS_DEFAULT>                 <DATE_FROM>2025-06-03</DATE_FROM>                 <DATE_TO>3000-01-01</DATE_TO>             </row>             <dmUsersoObjRBL>                 <row>                     <PK_OBJ>1</PK_OBJ>                     <F_NOSAUK>Lanas Firma</F_NOSAUK>                     <PK_ACTTYPE>5</PK_ACTTYPE>                     <PK_FIRMA>56</PK_FIRMA>                 </row>             </dmUsersoObjRBL>         </dmUsersoFirmaRBL>         <dmUsersoInterfacesRBL/>         <dmUsersOPubAtskRBL/>     </entity> </resource> ____________________________________________________________________________________________________ Piemēra rezultāts:  Sistēma -> Administrēt -> WEB lietotāji tiek izveidota lietotāja kartīte:   <LOGIN_TYPE> - autentifikācijas veids (0- Parole; 1 - Domēna vārds; 4 - Domēna vārds vai Parole; 6 - Ārēja autentifikācija) <USER_TYPE> - konta veids (0 - Lietotāja; 1 - Sistēmkonts; 2 - Administratora; 3 - Ārējais) Svarīga informācija: Lai veidotu WEB lietotājus izmantojot REST API, integrācijā izmantotajam WEB lietotājam konta veidam ir jābūt  "Sistēmkonts" vai "Administratora konts" un WEB lietotājam piesaistītajam Horizon lietotājam ir jābūt atļautiem tiesību punktiem (Sistēma → Administrēt → Lomas) Sistēma -> Administrēt -> WEB lietotāji Apskatīt Pievienot Labot Web lietotāju veidošana, labošana, dzēšana ar Rest Horizon sarakstā: Sistēma -> Administrēt -> WEB lietotāji pieejama  kolonna "Reģistrācijas tips". Gadījumos, kad WEB lietotājs izveidots izmantojot REST API, saraksta lauka "Reģistrācijas tips" vērtība tiks aizpildīta ar "Izveidots no Rest"

Uzņēmumiem, kur, piemēram jaunu darbinieku dati tiek piefiksēti ārpus Horizon un nepieciešams, izmantojot esošos datus, izveidot jaunus Horizon lietotājus ir pieejams REST resurss:  /rest/TUser Piemērs jauna Horizon lietotāja izveidei (POST): ___________________________________________________________________________________________________________ <resource>         <entity>         <VARDST>KASPARS</VARDST>         <UZVARDST>JAUNIŅAIS</UZVARDST>        <USRPWD>1:18718:yU8jKxfAdU+p/9+BqSpUKg==:3MDR7MRnLwrMdPMo0yVq2+Wd4V1VgZtWzanQxnty3A==</USRPWD>         <PIEZIMEST>Piezīmes par lietotāju</PIEZIMEST>         <APSKATE>0</APSKATE>         <LOGIN_TYPE>0</LOGIN_TYPE>         <LOGINT>KASPARS_JAUN</LOGINT>         <USER_TYPE>0</USER_TYPE>         <AD_PWDNOEXP>1</AD_PWDNOEXP>         <dmRTUserLLFBL>             <row>                 <PK_FIRMA>56</PK_FIRMA>                 <PK_LOMA>1</PK_LOMA>             </row>         </dmRTUserLLFBL>     </entity> </resource> ___________________________________________________________________________________________________________ Piemēra rezultātā:  Sistēma -> Administrēt -> Lietotāji tiek izveidota lietotāja kartīte: <APSKATE> - licences veids: 0 - Pilna; 1 - Tikai apskate <LOGIN_TYPE> - autentifikācijas veids: 0 - Parole; 1 - Domēna v.; 3 - Domēna v. +AD parole; 2 - el.paraksts; 5 - OIDC <USER_TYPE> - konta veids: 0 - Lietotāja; 1 - Sistēmas; 2 - Administratora <AD_PWDNOEXP> - pazīme, parole nekad nenoveco: 0 - neatzīmēts; 1 - atzīmēts Svarīga informācija: Lai veidotu Horizon lietotājus izmantojot REST API, integrācijā izmantotajam WEB lietotājam konta veidam ir jābūt  "Sistēmkonts" vai "Administratora konts" un WEB lietotājam piesaistītajam Horizon lietotājam ir jābūt atļautiem tiesību punktiem (Sistēma → Administrēt → Lomas) Sistēma -> Administrēt -> Lietotāji Apskatīt Pievienot Labot Horizon lietotāju veidošana un labošana ar Rest

Integrācijās, kas izmantoto klientu saraksta datus, var rasties nepieciešamība papildināt klienta kartīti ar jauniem saistīto datu ierakstiem. Šajā rakstā apskatīsim vaicājumu ar kuru palīdzību caur REST var pievienot klienta kartītes kontaktpersonas.   Jaunas kontaktpersonas pievienošana   POST ../rest/TdmDKPers/template/191 POST BODY <resource> <entity> <PK_DOKT> <href>/rest/TdmDocType/191</href> </PK_DOKT> <VARDS>Jānis</VARDS> <KONTAKTP>Bērziņš</KONTAKTP> <TELEFONS>67067067</TELEFONS> <MOBTEL>20220230</MOBTEL> <EPASTS>[email protected]</EPASTS> <dmDContactRows> <row> <PAMATP>0</PAMATP> <PK_KLIENTS>51</PK_KLIENTS> <TIPS>3</TIPS> </row> </dmDContactRows> </entity> </resource> PAMATP – Galvenā kontaktpersona (Jā – 1; Nē – 0) PK_KLIENTS - Klienta kartītes sistēmas ID TIPS - Kontaktpersonas tips (Klienta kartīte - 3)  

Integrācijās, kas izmantoto klientu saraksta datus, var rasties nepieciešamība papildināt klienta kartīti ar jauniem saistīto datu ierakstiem. Šajā rakstā apskatīsim vaicājumu ar kuru palīdzību caur REST var pievienot klienta kartītes adreses.   Jaunas adreses pievienošana   POST ../rest/TNdmAdr/template POST BODY <resource> <entity> <PK_KLIENTS>51</PK_KLIENTS> <STATUSS>1</STATUSS> <ADRESE1>"Priedes 4"</ADRESE1> <ADRESE2>Silakrogs, Ropažu pagasts</ADRESE2> <ADRESE3>Ropažu novads</ADRESE3> <PASTA_IND>LV-2133</PASTA_IND> <PK_VALSTS>1</PK_VALSTS> <LEG_ADR>1</LEG_ADR> <POST_ADR>1</POST_ADR> </entity> </resource> PK_KLIENTS - Klienta kartītes sistēmas ID STATUSS - Adreses statuss (Aktīvs – 1; Neaktīvs 2) ADRESE1 - Ielas vai mājas numurs ADRESE2 - Ciema vai pagasta nosaukums ADRESE3 - Pilsētas vai novada nosaukums PASTA_IND - Pasta indekss PK_VALSTS - Valsts sistēmas ID LEG_ADR - Juridiskā adrese (1 – Ir; 2 - Nav) POST_ADR - Faktiskā adrese (1 – Ir; 2 - Nav)   Horizon ievadīto valstu sistēmas ID var noskaidrot ar šādu vaicājumu   GET ../rest/TdmSLDValsts/query?Columns=DV_PK_VALSTS,DV_KODS,DV_NOSAUK,DV_PK_VAL,DV_STATUSS DV_PK_VALSTS – Valsts sistēmas ID DV_NOSAUK – Valsts nosaukums

Integrācijās, kas izmantoto klientu saraksta datus, var rasties nepieciešamība papildināt klienta kartīti ar jauniem saistīto datu ierakstiem. Šajā rakstā apskatīsim vaicājumu ar kuru palīdzību caur REST var pievienot klienta kartītes bankas kontus   Jauna bankas konta pievienošana   POST ../rest/TDdmCustAccount/template POST BODY <resource> <entity> <PK_KLIENTS>51</PK_KLIENTS> <PK_BANKA>17</PK_BANKA> <NUMURS>LVHABA000222333444555</NUMURS> <AKTIVS>0</AKTIVS> <PK_VAL>8</PK_VAL> </entity> </resource> PK_KLIENTS - Klienta kartiņas sistēmas ID ID PK_BANKA - Bankas sistēmas ID ID PK_VAL - Valūtas sistēmas ID   Horizon ievadītās banku  sistēmas ID var noskaidrot ar šādu vaicājumu   GET ..rest/TDdmBankas/query?Columns=B_PK_BANKA,B_KODS,B_NOSAUK,BKT_KODS,B_TIPS,B_STATUSS B_PK_BANKA – Bankas sistēmas ID B_STATUSS – Bankas statuss (Aktīvs – 0; Neaktīvs - 1)   Horizon ievadītās valūtu sistēmas ID var noskaidrot ar šādu vaicājumu   GET ..rest/TsdmValSar/query?Columns=SVAL_PK_VAL,SVAL_KODS,SVAL_NOS_VSK,SVAL_NOS_DSK,SVAL_S_NOS_VSK,SVAL_S_NOS_DSK SVAL_PK_VAL – Valūtas sistēmas ID SVAL_KODS – Valūtas kods

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