Kā noskaidrot informāciju par esošiem klientiem un izveidot jaunu klientu kartiņu?

[#1]

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)