internetiniai-underscore-moduliai-api-underscore-rest-get-underscore-ps-underscore-kain.md
Pradžia Internetiniai moduliai Rivile API v2 (REST web servisai) GET_PS_KAIN
Prekių/paslaugų kainų, kainynų, akcijų bei nuolaidų informacijos gavimas.
Vienoje vietoje suformuotos visos prekės galimos kainos ir nuolaidos. Jas galima parinkinėti pagal prioritetą, kaip jas parinkinėja Rivile GAMA sistema arba savo nuožiūra suderinus su klientu. Pvz. mažiausia kaina ir didžiausia galima nuolaida klientui.
Informacija apie autorizaciją, bendruosius parametrus ir klaidų kodus: Rivile API v2 naudojimo pagrindai
method : GET_PS_KAINparams :
bar_kodas: barkodas. Neprivalomakodas_ps: prekė kodas. Neprivalomakodas_us: matavimo vieneto kodas. Neprivalomakodas_is: padalinio kodas. Neprivalomakodas_ks: kliento kodas. Neprivalomafil : filtravimo sąlyga. T-SQL tipo where sąlygos užklausa iš lentelės N37 nenurodant pačio where tag'o. NeprivalomaPrekių sąrašas pagal kliento kodą kodas_ks nefiltruojamas.
Sutartinių kainų gavimui būtina naudoti prekės ir kliento filtrus kodas_ps ir kodas_ks.
pvz Content-Type=application/xml:
<body>
<method>GET_PS_KAIN</method>
<params>
<kodas_ps>PR001</kodas_ps>
<fil>N37_PAK_TIPAS=1</fil>
</params>
</body>
pvz Content-Type=application/json:
{
"method": "GET_PS_KAIN",
"params": {
"kodas_ps":"PR001",
"fil":"N37_PAK_TIPAS=1"
}
}
Grąžinama informacija XML formate tarp tag'ų <RET_DOK>..</RET_DOK>. Jeigu įrašų nerasta pagal užduotas sąlygas, tuomet gražinama status=200 bei tuščias tag'as
pvz Accept=application/xml:
<RET_DOK>
<KAINOS>
<Row_number>1</Row_number>
<kodas_ps>PR001 </kodas_ps>
<kodas_us>PAK </kodas_us>
<kodas_is>999999999999</kodas_is>
<bar_kodas>000000000012</bar_kodas>
<kaina>1.0000</kaina>
<kain_tipas>KAIN_I33 </kain_tipas>
<prioritetas>4</prioritetas>
</KAINOS>
<KAINOS>
<Row_number>2</Row_number>
<kodas_ps>PR001 </kodas_ps>
<kodas_us>VNT </kodas_us>
<kodas_is>999999999999</kodas_is>
<bar_kodas>477904525150</bar_kodas>
<kaina>1.5840</kaina>
<kain_tipas>KAIN_I33 </kain_tipas>
<prioritetas>4</prioritetas>
</KAINOS>
</RET_DOK>
pvz Accept=application/json:
{
"KAINOS": [
{
"Row_number": 1,
"kodas_ps": "PR001",
"kodas_us": "PAK",
"kodas_is": 999999999999,
"bar_kodas": "000000000012",
"kaina": 1,
"kain_tipas": "KAIN_I33",
"prioritetas": 4
},
{
"Row_number": 2,
"kodas_ps": "PR001",
"kodas_us": "VNT",
"kodas_is": 999999999999,
"bar_kodas": 477904525150,
"kaina": 1.584,
"kain_tipas": "KAIN_I33",
"prioritetas": 4
}
]
}
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'ApiKey: uUCz6UD.sKVrjaWRDJAH1c7l4qL2nOoN2K0jARkvuHDdYsss',
'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
"method": "GET_PS_KAIN",
"params": {
"kodas_ps": "1"
}
}');
$response = curl_exec($ch);
curl_close($ch);
Prekių/paslaugų kainų, kainynų, akcijų bei nuolaidų lentelė
| Laukas | Tipas | Aprašymas | Pastabos |
|---|---|---|---|
| BAR_KODAS | C(40) | Bar kodas | |
| KODAS_PS | C(12) | Prekės kodas | |
| KODAS_US | C(12) | Matavimo vienetas | |
| KODAS_IS | C(12) | Padalinys | |
| KAINA | N(12,4) | Kaina / nuolaida (nuolaidos procentas) | |
| KIEKIS | N(14,3) | Nuo kurio kiekio | |
| KAINA2 | N(12,4) | Kaina-2 / nuolaida-2 (nuolaidos procentas) | |
| KIEKIS2 | N(14,3) | Nuo kurio kiekio-2 | |
| KAINA3 | N(12,4) | Kaina-3 / nuolaida-3 (nuolaidos procentas) | |
| KIEKIS3 | N(14,3) | Nuo kurio kiekio-3 | |
| KAINA4 | N(12,4) | Kaina-4 / nuolaida-4 (nuolaidos procentas) | |
| KIEKIS4 | N(14,3) | Nuo kurio kiekio-4 | |
| KAIN_TIPAS | C(12) | Kainų / nuolaidų tipas (aprašymas žemiau) | |
| KAIN_KODAS | C(12) | Kainų / nuolaidų kodas pagal tipą | |
| PRIORITETAS | N(1,0) | Prioritetas Rivile GAMA sistemoje | |
| PRADZIA | T | Kainų / nuolaidų galiojimo pradžia | |
| PABAIGA | T | Kainų / nuolaidų galiojimo pabaiga |
KAIN_TIPAS – kainų nuolaidų tipo galimos reikšmės: