GET_A32_LIST

Aprašymas

Darbo grafiko operacijų sąrašas

Specifikacija

Informacija apie autorizaciją, bendruosius parametrus ir klaidų kodus: Rivile API v2 naudojimo pagrindai

Body
  • method : GET_A32_LIST
  • params :
    • list : H - gražinama tik pagrindinė informacija (A32) (default). Jeigu A - grąžinama visa susijusi informacija (A32+A33).
    • fil : filtravimo sąlyga. T-SQL tipo where sąlygos užklausa iš lentelės A32 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

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_A32_LIST</method>
    <params>
        <fil> A32_PERKELTA = 1 </fil>
        <list>A</list>
    </params>
</body>

pvz application/json:

{
    "method": "GET_A32_LIST",
    "params": {
        "fil": " A32_PERKELTA = 1 ",
        "list": "A"
    }
}
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ą A32_KODAS_DG

Jeigu įrašų nerasta pagal užduotas sąlygas, tuomet gražinama status=200 bei tuščias tag'as

pvz, kai list='A':

<RET_DOK>
    <A32>
        <Row_number>1</Row_number>
        <A32_KODAS_DG>000R00000011</A32_KODAS_DG>
        <A32_KODAS_IS>999999999999</A32_KODAS_IS>
        <A32_DATE>2026-10-01T00:00:00</A32_DATE>
        <A32_TIPAS>1</A32_TIPAS>
        <A32_PAV>UAB "Rivilė"</A32_PAV>
        <A32_KODAS_LS_1>           </A32_KODAS_LS_1>
        <A32_KODAS_LS_2>           </A32_KODAS_LS_2>
        <A32_KODAS_LS_3>           </A32_KODAS_LS_3>
        <A32_KODAS_LS_4>           </A32_KODAS_LS_4>
        <A32_PERKELTA>1</A32_PERKELTA>
        <A32_BUSENA>1</A32_BUSENA>
        <A32_PASTABOS></A32_PASTABOS>
        <A32_ADDUSR>ABCDEF     </A32_ADDUSR>
        <A32_ADD_DATE>2026-11-12T13:46:32</A32_ADD_DATE>
        <A32_USERIS>ABCDEF     </A32_USERIS>
        <A32_R_DATE>2026-11-12T13:46:32</A32_R_DATE>
        <A33>
            <A33_KODAS_DG>000R00000011</A33_KODAS_DG>
            <A33_EIL_NR>1</A33_EIL_NR>
            <A33_KODAS_TB>002         </A33_KODAS_TB>
            <A33_KODAS_PE>           </A33_KODAS_PE>
            <A33_KODAS_OS>           </A33_KODAS_OS>
            <A33_KODAS_IS>999999999999</A33_KODAS_IS>
            <A33_V00>16.00</A33_V00>
            <A33_D01>  8.00  1.0008:00-12:0013:00-17:00</A33_D01>
            <A33_D02>  8.00  1.0008:00-12:0013:00-17:00</A33_D02>
            <A33_D03>                                 </A33_D03>
            <A33_D04>                                 </A33_D04>
            <A33_D05>                                 </A33_D05>
            <A33_D06>                                 </A33_D06>
            <A33_D07>                                 </A33_D07>
            <A33_D08>                                 </A33_D08>
            <A33_D09>                                 </A33_D09>
            <A33_D10>                                 </A33_D10>
            <A33_D11>                                 </A33_D11>
            <A33_D12>                                 </A33_D12>
            <A33_D13>                                 </A33_D13>
            <A33_D14>                                 </A33_D14>
            <A33_D15>                                 </A33_D15>
            <A33_D16>                                 </A33_D16>
            <A33_D17>                                 </A33_D17>
            <A33_D18>                                 </A33_D18>
            <A33_D19>                                 </A33_D19>
            <A33_D20>                                 </A33_D20>
            <A33_D21>                                 </A33_D21>
            <A33_D22>                                 </A33_D22>
            <A33_D23>                                 </A33_D23>
            <A33_D24>                                 </A33_D24>
            <A33_D25>                                 </A33_D25>
            <A33_D26>                                 </A33_D26>
            <A33_D27>                                 </A33_D27>
            <A33_D28>                                 </A33_D28>
            <A33_D29>                                 </A33_D29>
            <A33_D30>                                 </A33_D30>
            <A33_D31>                                 </A33_D31>
            <A33_PERKELTA>1</A33_PERKELTA>
            <A33_ADDUSR>ABCDEF     </A33_ADDUSR>
            <A33_ADD_DATE>2026-11-12T13:46:33</A33_ADD_DATE>
            <A33_USERIS>ABCDEF     </A33_USERIS>
            <A33_R_DATE>2026-11-12T13:46:33</A33_R_DATE>
        </A33>
    </A32>
</RET_DOK>

pvz, kai list='H'

<RET_DOK>
    <A32>
        <Row_number>1</Row_number>
        <A32_KODAS_DG>000R00000011</A32_KODAS_DG>
        <A32_KODAS_IS>999999999999</A32_KODAS_IS>
        <A32_DATE>2026-10-01T00:00:00</A32_DATE>
        <A32_TIPAS>1</A32_TIPAS>
        <A32_PAV>UAB "Rivilė"</A32_PAV>
        <A32_KODAS_LS_1>           </A32_KODAS_LS_1>
        <A32_KODAS_LS_2>           </A32_KODAS_LS_2>
        <A32_KODAS_LS_3>           </A32_KODAS_LS_3>
        <A32_KODAS_LS_4>           </A32_KODAS_LS_4>
        <A32_PERKELTA>1</A32_PERKELTA>
        <A32_BUSENA>1</A32_BUSENA>
        <A32_PASTABOS></A32_PASTABOS>
        <A32_ADDUSR>ABCDEF     </A32_ADDUSR>
        <A32_ADD_DATE>2026-11-12T13:46:32</A32_ADD_DATE>
        <A32_USERIS>ABCDEF     </A32_USERIS>
        <A32_R_DATE>2026-11-12T13:46:32</A32_R_DATE>
    </A32>
</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>4641133481.3d11c2a9.1773136925474</id>
    <durationMs>3</durationMs>
    <errorMessage>Invalid column name 'fake_col'.</errorMessage>
</RET_DOK>

PHP pvz

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'ApiKey: ABCDEFG.ABCDEFG',
      'Content-Type: application/json',
      ]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
    "method": "GET_A32_LIST",
    "params": {
        "fil": "A32_KODAS_IS = \'999999999999\'",

        "list": "A"
    }
}');
$response = curl_exec($ch);
curl_close($ch);

Lentelės

A32

Nuoroda į lentelės aprašymą: A32

A33

Nuoroda į lentelės aprašymą: A33