GET_N41_LIST

Aprašymas

Ilgalaikio turto grupių sąrašas

Specifikacija

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

Body
  • method : GET_N41_LIST
  • params :
    • fil : filtravimo sąlyga. T-SQL tipo where sąlygos užklausa iš lentelės N41 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

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_N41_LIST</method>
    <params>
        <fil> N41_KODAS_GP = 'GP001' </fil>
    </params>
</body>

pvz application/json:

{
    "method": "GET_N41_LIST",
    "params": {
        "fil": "N41_KODAS_GP = 'GP001'"
    }
}
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ą N41_KODAS_DH

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

<RET_DOK>
    <N41>
        <Row_number>1</Row_number>
        <N41_KODAS_GP>GP001       </N41_KODAS_GP>
        <N41_PAV>IT grupė 1                              </N41_PAV>
        <N41_KOEF>33.0000</N41_KOEF>
        <N41_KODAS_SS_V>13          </N41_KODAS_SS_V>
        <N41_KODAS_SS_N>6306        </N41_KODAS_SS_N>
        <N41_KODAS_SS_I>6401        </N41_KODAS_SS_I>
        <N41_KODAS_SS_P>52          </N41_KODAS_SS_P>
        <N41_POZ_DATE>0</N41_POZ_DATE>
        <N41_BEG_DATE>2026-05-12 00:00:00.000</N41_BEG_DATE>
        <N41_END_DATE>2026-05-12 00:00:00.000</N41_END_DATE>
        <N41_USERIS>MASTER      </N41_USERIS>
        <N41_R_DATE>2026-05-12 08:49:40.000</N41_R_DATE>
        <N41_ADDUSR>MASTER      </N41_ADDUSR>
        <N41_KOEF_VAS>0.0000</N41_KOEF_VAS>
        <N41_KODAS_SS_V_VAS>            </N41_KODAS_SS_V_VAS>
        <N41_KODAS_SS_N_VAS>            </N41_KODAS_SS_N_VAS>
        <N41_KODAS_SS_I_VAS>            </N41_KODAS_SS_I_VAS>
    </N41>
</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_N41_LIST",
    "params": {
        "fil": "N41_KODAS_GP = 'GP001'"
    }
}');
$response = curl_exec($ch);
curl_close($ch);

Lentelės

N41

Nuoroda į lentelės aprašymą: N41