GET_I53_LIST

Aprašymas

Mokėjimo operacijų sąrašas.

Specifikacija

Address

POST https://api.manorivile.lt/client/v2

Header

ApiKey : Privalomas. Unikalus API raktas išduodamas užsakant paslaugą
Content-Type : Privalomas. Kokiu formatu paduodami parametrai ir duomenys (request):
- application/xml
- application/json
Accept: Neprivalomas. Gražinamo rezultato (response) formatas
- application/xml(default)
- application/json (veikia nuo Manorivile-Gateway-1.1.0 versijos)

Body

method : GET_I53_LIST
params :
- fil : filtravimo sąlyga. T-SQL tipo where sąlygos užklausa iš lentelės I53 nenurodant pačio where tag'o. Neprivaloma
- pagenumber: į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šų. Neprivaloma
- list: 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'"
    }
}

Response (status 200 OK)

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>

Response (status 400)

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>

Response (status 401)

Blogai nurodytas adresas / neteisingai nurodytas API raktas / nenurodytas API raktas / pasibaigęs API rakto galiojimas, pvz

<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id/>
    <durationMs>0</durationMs>
    <errorMessage>Api key is not valid</errorMessage>
</RET_DOK>

Response (status 502)

Nepaleistas MANO Rivile Gateway arba kitaip sutrikusi jo veikla

<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id/>
    <durationMs>0</durationMs>
    <errorMessage>Rivile GAMA database is unavailable. Please check if the gateway is running and is set up correctly.</errorMessage>
</RET_DOK>

Response (status 504)

Laiku nebuvo gautas Rivile API užklausos atsakymas, pavyzdžiui, apkrauta GAMA duomenų bazė

<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id/>
    <durationMs>0</durationMs>
    <errorMessage>No response received from client gateway</errorMessage>
</RET_DOK>

Response (status 500)

Bendrinė sistemos klaida, pvz

<?xml version='1.0' encoding='UTF-8'?>
<Map>
    <timestamp>2020-02-05T12:34:26.890+0000</timestamp>
    <status>500</status>
    <error>Internal Server Error</error>
    <message>No message available</message>
    <path>/v1</path>
</Map>

PHP pvz

<?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);

Lentelės

I53

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

K62

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