internetiniai-underscore-moduliai-api-underscore-rest-get-underscore-i53-underscore-list.md
Pradžia Internetiniai moduliai Rivile API v2 (REST web servisai) GET_I53_LIST
Mokėjimo operacijų sąrašas.
Informacija apie autorizaciją, bendruosius parametrus ir klaidų kodus: Rivile API v2 naudojimo pagrindai
method : GET_I53_LISTparams :
fil : filtravimo sąlyga. T-SQL tipo where sąlygos užklausa iš lentelės I53 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šų. Neprivalomalist: H -gražinama tik pagrindinė informacija (I53) (default). Jeigu A - gražinama visa susijusi informacija (I53+K62).Są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_I53_LIST</method>
<params>
<fil>i53_kodas_oi='000000000001'</fil>
</params>
</body>
pvz application/json:
{
"method": "GET_I53_LIST",
"params": {
"fil": "i53_kodas_oi='000000000001'"
}
}
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ą I53_KODAS_OI
Jeigu įrašų nerasta pagal užduotas sąlygas, tuomet gražinama status=200 bei tuščias tag'as
pvz , response:
<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
<i53>
<Row_number>1</Row_number>
<I53_KODAS_OI>000000000024</I53_KODAS_OI>
<I53_OP_RUSIS>1</I53_OP_RUSIS>
<I53_PAV> </I53_PAV>
<I53_DOK_NR>4444644644646 </I53_DOK_NR>
<I53_DATA>2025-10-30T00:00:00</I53_DATA>
<I53_KODAS_KS>121411842 </I53_KODAS_KS>
<I53_KODAS_SS>7 </I53_KODAS_SS>
<I53_KODAS_VL>EUR </I53_KODAS_VL>
<I53_SUMA>0.00</I53_SUMA>
<I53_MOKETOJAS>1</I53_MOKETOJAS>
<I53_KODAS_SS_S> </I53_KODAS_SS_S>
<I53_PASTABOS> </I53_PASTABOS>
<I53_KODAS_WS> </I53_KODAS_WS>
<I53_KODAS_CH> </I53_KODAS_CH>
<I53_SUMA2>0.00</I53_SUMA2>
<I53_PERKELTA>1</I53_PERKELTA>
<I53_USERIS>MASTER </I53_USERIS>
<I53_R_DATE>2025-10-30T08:32:28</I53_R_DATE>
<I53_ADDUSR>MASTER </I53_ADDUSR>
<I53_ADD_DATE>2025-10-30T08:31:47</I53_ADD_DATE>
<I53_DOK_NR_MOK> </I53_DOK_NR_MOK>
<I53_KODAS_IS> </I53_KODAS_IS>
<I53_KODAS_OS> </I53_KODAS_OS>
<I53_KODAS_OS_C> </I53_KODAS_OS_C>
<I53_KODAS_MS> </I53_KODAS_MS>
<I53_S_KODAS> </I53_S_KODAS>
<I53_ID> </I53_ID>
<I53_DOK_TIPAS>2</I53_DOK_TIPAS>
<I53_SUMA_VL>0.00</I53_SUMA_VL>
<I53_KURSAS>1.000000000000000</I53_KURSAS>
<I53_KODAS_KT> </I53_KODAS_KT>
<I53_KODAS_K0> </I53_KODAS_K0>
<I53_BUSENA>1</I53_BUSENA>
<I53_KODAS_SM> </I53_KODAS_SM>
<I53_SUMA_AP>0.00</I53_SUMA_AP>
<k62>
<K62_KODAS_SO>000000000012</K62_KODAS_SO>
<K62_MODUL>OI</K62_MODUL>
<K62_KODAS_OP>000000000024</K62_KODAS_OP>
<K62_KODAS_KS_1>121411842 </K62_KODAS_KS_1>
<K62_DOK_NR_1>4444644644646 </K62_DOK_NR_1>
<K62_KODAS_KS_2>121411842 </K62_KODAS_KS_2>
<K62_DOK_NR_2>POG000000008 </K62_DOK_NR_2>
<K62_KODAS_VL>EUR </K62_KODAS_VL>
<K62_SUMA>123.00</K62_SUMA>
<K62_SUMA_VL>123.00</K62_SUMA_VL>
<K62_KURSAS>1.000000000000000</K62_KURSAS>
<K62_PRIORITETAS>1.000</K62_PRIORITETAS>
<K62_PERKELTA>1</K62_PERKELTA>
<K62_POZ_DEL>0</K62_POZ_DEL>
<K62_ADDUSR>MASTER </K62_ADDUSR>
<K62_ADD_DATE>2025-10-30T08:32:25</K62_ADD_DATE>
<K62_USERIS>MASTER </K62_USERIS>
<K62_R_DATE>2025-10-30T08:32:25</K62_R_DATE>
</k62>
</i53>
</RET_DOK>
Klaida paduodant duomenis / SQL sintaksės klaidos / kitos DB klaidos
<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
<id>3451ded.be556121580910178112</id>
<durationMs>25</durationMs>
<errorMessage>Invalid column name 'i53_kodas_oip'.</errorMessage>
</RET_DOK>
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'ApiKey: 1234567.xxxxxxxxxxxxxxxxxxxxxxxx',
'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
"method": "GET_I53_LIST",
"params": {
"fil": "i53_kodas_oi=\'000000000001\'"
}
}');
$response = curl_exec($ch);
curl_close($ch);
| Laukas | Tipas | Aprašymas |
|---|---|---|
| I53_KODAS_OI | C(12) | Operacijos numeris |
| I53_OP_RUSIS | N(1,0) | Rūšis: 1-įplaukos; 2-išmokos |
| I53_PAV | C(60) | Aprašymas |
| I53_DOK_NR | C(20) | Dokumento Nr. |
| I53_DATA | T(8) | Data |
| I53_KODAS_KS | C(12) | Kliento kodas |
| I53_KODAS_SS | C(12) | Mokėjimo sąskaita |
| I53_KODAS_VL | C(12) | Valiuta |
| I53_SUMA | N(12,2) | Suma |
| I53_MOKETOJAS | N(1,0) | Sudengimo tipas: 1-dokumentai; 2-sąskaitos |
| I53_KODAS_SS_S | C(12) | Sudengimo sąskaita |
| I53_PASTABOS | M | Pastabos |
| I53_KODAS_LS_1 | C(12) | Logistika 1 |
| I53_KODAS_LS_2 | C(12) | Logistika 2 |
| I53_KODAS_LS_3 | C(12) | Logistika 3 |
| I53_KODAS_LS_4 | C(12) | Logistika 4 |
| I53_KODAS_WS | C(12) | Bankas |
| I53_KODAS_CH | C(12) | Atsiskaitymo Op.Nr. |
| I53_SUMA2 | N(12,2) | Rezervas |
| I53_PERKELTA | N(1,0) | Perkelimo požymis: 1-nauja; 2-perkelta; 3-klaidinga |
| I53_USERIS | C(12) | Kas koregavo |
| I53_R_DATE | T(8) | Kada koregavo |
| I53_ADDUSR | C(12) | Įrašo autorius |
| I53_ADD_DATE | T(8) | Kada sukurta |
| I53_DOK_NR_MOK | C(20) | Sudengiamo dokumento Nr. |
| I53_KODAS_IS | C(12) | Padalinio kodas |
| I53_KODAS_OS | C(12) | Objekto kodas |
| I53_KODAS_OS_C | C(12) | Centro kodas |
| I53_KODAS_MS | C(12) | Menedžerio kodas |
| I53_S_KODAS | C(45) | Banko sąskaita |
| I53_ID | C(40) | Banko operacijos ID |
| I53_DOK_TIPAS | N(1,0) | Dokumento tipas:1-Atsiskaitymo Op.;2-Mokėjimas |
| I53_SUMA_VL | N(18,2) | Suma valiuta |
| I53_KURSAS | N(20,15) | Kursas |
| I53_KODAS_KT | C(12) | Sutartis |
| I53_KODAS_K0 | C(12) | Priedas |
| I53_BUSENA | N(3,0) | Būsena |
| I53_KODAS_SM | C(12) | Asmuo |
| I53_ATSTOVAS | C(150) | Atstovas |
| I53_KODAS_ZN | C(12) | Zona |
| I53_SUMA_AP | N(12,2) | Apvalinimas |
| Laukas | Tipas | Aprašymas |
|---|---|---|
| K62_KODAS_SO | C(12) | Operacijos Nr. |
| K62_PAV | C(150) | Aprašymas |
| K62_MODUL | C(2) | Sukūrusios Op.modulis |
| K62_KODAS_OP | C(12) | Sukūrusios Op.Nr. |
| K62_KODAS_KS_1 | C(12) | Klientas 1 |
| K62_DOK_NR_1 | C(20) | Dokumento Nr. 1 |
| K62_KODAS_KS_2 | C(12) | Klientas 2 |
| K62_DOK_NR_2 | C(20) | Dokumento Nr. 2 |
| K62_KODAS_VL | C(12) | Valiuta |
| K62_SUMA | N(12,2) | Suma |
| K62_SUMA_VL | N(18,2) | Suma valiuta |
| K62_KURSAS | N(20,15) | Kursas |
| K62_PRIORITETAS | N(14,3) | Prioritetas |
| K62_PERKELTA | N(1) | Perkelta:1-nauja;2-sudengta |
| K62_POZ_DEL | N(1) | Anuliuota: 0-ne;1-taip. |
| K62_ADDUSR | C(12) | Kas sukūrė |
| K62_ADD_DATE | T(8) | Kada sukūrė |
| K62_USERIS | C(12) | Kas koregavo |
| K62_R_DATE | T(8) | Kada koregavo |