Zināšanu bāze Integrācija

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

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  

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