Zināšanu bāze Integrācija

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)

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

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.