internetiniai-underscore-moduliai-api-underscore-rest-get-underscore-n52-underscore-list.md
Pradžia Internetiniai moduliai Rivile API v2 (REST web servisai) GET_N52_LIST
Sutarčių priedai
Informacija apie autorizaciją, bendruosius parametrus ir klaidų kodus: Rivile API v2 naudojimo pagrindai
method : GET_N52_LISTparams :
fil : filtravimo sąlyga. T-SQL tipo where sąlygos užklausa iš lentelės N52 nenurodant pačio where tag'o. Neprivalomapagenumber: įrašų puslapio numeris. GET_LIST metodai rezultatus grąžina puslapiais po 100 įrašų, pagenumber parametras nurodo kelintą puslapį grąžinti. Jei nenurodomas, tuomet grąžinamas pirmas puslapis su 100 naujausių įrašų. NeprivalomaSąraše su daugiau nei 1 įrašu informacija visada grąžinama surūšiuota pagal atitinkamos lentelės raktą (Primary Key)
GET_LIST metodų apribojima 100 įrašų, todėl norint gauti visą sąrašą, turite naudoti filtrus, kurie grąžins rezultatą dalimis per kelis kartus, filtruojant pagal paskutinio gauto įrašo rakto reikšmę.
pvz application/xml:
<body>
<method>GET_N52_LIST</method>
<params>
<fil>n52_kodas_kt='SUT00001'</fil>
</params>
</body>
pvz application/json:
{
"method": "GET_N52_LIST",
"params": {
"fil": "n52_kodas_kt='SUT00001'"
}
}
Grąžinama informacija XML formate tarp tag'ų <RET_DOK>..</RET_DOK>. Esant daugiau nei vienam įrašui informacija rūšiuojama (order) pagal lentelės raktinį lauką N52_KODAS_KT
Jeigu įrašų nerasta pagal užduotas sąlygas, tuomet grąžinama status=200, bei tuščias tag'as
<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
<N52>
<Row_number>1</Row_number>
<N52_KODAS_KT>SUT00001</N52_KODAS_KT>
<N52_KODAS_K0>01</N52_KODAS_K0>
<N52_DOK_NR></N52_DOK_NR>
<N52_OP_DATA>2020-02-27T00:00:00</N52_OP_DATA>
<N52_PAV>HDD</N52_PAV>
<N52_POZ_SKOL>0</N52_POZ_SKOL>
<N52_PRIORITETAS>1.000</N52_PRIORITETAS>
<N52_RUSIS>1</N52_RUSIS>
<N52_KODAS>005</N52_KODAS>
<N52_PAV2>HDD</N52_PAV2>
<N52_KODAS_MS></N52_KODAS_MS>
<N52_POZ_SUMA>1</N52_POZ_SUMA>
<N52_SUMA>100.00</N52_SUMA>
...
</N52>
</RET_DOK>
Klaida paduodant duomenis / SQL sintaksės klaidos / kitos DB klaidos
<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
<id>21313695680.569b1c8d.1586199678089</id>
<durationMs>8</durationMs>
<errorMessage>Invalid column name 'n52_kodass_kt'.</errorMessage>
</RET_DOK>
<?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_N52_LIST",
"params": {
"fil": "n52_kodas_kt=\'SUT00001\'"
}
}');
$response = curl_exec($ch);
curl_close($ch);
Sutarčių priedų lentelė:
| Laukas | Tipas | Aprašymas | Pastabos |
|---|---|---|---|
| N52_KODAS_KT | C(12) | Sutarties kodas | |
| N52_KODAS_K0 | C(12) | Priedo Numeris | |
| N52_DOK_NR | C(12) | Rezervas | |
| N52_OP_DATA | T(8) | Priedo data | |
| N52_PAV | C(40) | Pavadinimas | |
| N52_POZ_SKOL | N(1) | Ar priedą atvaizduoti skolose? | |
| N52_PRIORITETAS | N(14,3) | Priedo prioritetas | |
| N52_RUSIS | N(2) | Rūšis:1-Prekė,2-Paslauga,3-Prekių gr.,4-Paslaugų gr.,5-Klientas,6-Tiekėjas | |
| N52_KODAS | C(12) | Rūšies kodas | |
| N52_PAV2 | C(40) | Rūšies pavadinimas | |
| N52_KODAS_MS | C(12) | Priedo menedžeris | |
| N52_POZ_SUMA | N(1) | Kontroliuoti sumą? | |
| N52_SUMA | N(12,2) | Suma | |
| N52_POZ_KIEKIS | N(1) | Kontroliuoti kiekį? | |
| N52_KODAS_US | C(12) | Matavimo vienetas | |
| N52_FRAKCIJA | N(4) | Frakcija | |
| N52_KIEKIS | N(14) | Kiekis | |
| N52_POZ_KAINA | N(1) | Kainos parinkimas | |
| N52_KODAS_US2 | C(12) | Pardavimo kainos mat.vnt. | |
| N52_KAINA | N(12,4) | Kaina | |
| N52_TIPAS1 | C(1) | Kainynas 1 | |
| N52_TIPAS2 | C(1) | Kainynas 2 | |
| N52_TIPAS3 | C(1) | Kainynas 3 | |
| N52_TIPAS4 | C(1) | Kainynas 4 | |
| N52_TIPAS5 | C(1) | Kainynas 5 | |
| N52_TIPAS6 | C(1) | Kainynas 6 | |
| N52_TERM1 | N(3) | Max atidėjimo terminas 1 | |
| N52_TERM2 | N(3) | Max atidėjimo terminas 2 | |
| N52_TERM3 | N(3) | Max atidėjimo terminas 3 | |
| N52_TERM4 | N(3) | Max atidėjimo terminas 4 | |
| N52_TERM5 | N(3) | Max atidėjimo terminas 5 | |
| N52_TERM6 | N(3) | Max atidėjimo terminas 6 | |
| N52_POZ_TERM | N(1) | Negalima viršyti atidėjimo nurodyto priede | |
| N52_POZ_TERM_KS | N(1) | Negalima viršyti atidėjimo nurodyto tiekėjo sutartyje | |
| N52_POZ_KS | N(1) | Vedant pardavimo sutartį turi būti tiekėjo sutartis | |
| N52_PASTABOS | M(4) | Pastabos | |
| N52_USERIS | C(12) | Kas koregavo | |
| N52_ADDUSR | C(12) | Kas sukūrė | |
| N52_R_DATE | T(8) | Kada koregavo | |
| N52_VISKAS | N(1) | Priedas: 0-aktyvus,1-neaktyvus | |
| N52_POZ_DATE | N(1) | Priedas turi terminą | |
| N52_BEG_DATE | T(8) | Priedo pradžios data | |
| N52_END_DATE | T(8) | Priedo pabaigos data | |
| N52_KODAS_US3 | C(12) | Pardavimo kainos mat. vnt. 2 | |
| N52_KAINA3 | N(12,4) | Pardavimo kaina 2 | |
| N52_KODAS_US4 | C(12) | Pardavimo kainos mat. vnt. 3 | |
| N52_KAINA4 | N(12,4) | Pardavimo kaina 3 | |
| N52_KODAS_VL | C(12) | Pardavimo/pirkimo kainos valiuta | |
| N52_KODAS_VL3 | C(12) | Pardavimo/pirkimo 2 kainos valiuta | |
| N52_KODAS_VL4 | C(12) | Pardavimo/pirkimo 3 kainos valiuta | |
| N52_NUOLAIDA | N(6,2) | Nuolaidos procentas | |
| N52_REZERVAS | C(40) | Rezervas | |
| N52_POZ_NUOLAIDA | N(1) | Ar priskirti nuolaidą | |
| N52_SUMA_P | N(12,2) | Pradinė suma | |
| N52_KIEKIS_P | N(14) | Pradinis kiekis |