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)
... View more
.gif "VISMA"){kind=icon}
Visma Denmark
Visma Finland
Visma Latvia
Visma Netherlands
Visma Norway
Visma Sweden
Visma Developers & Partners
Visma Latin America