GET_N01_LIST

Aprašymas

Įmonės sąskaitų planas

Specifikacija

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

Body
  • method : GET_N01_LIST
  • params :
    • fil : filtravimo sąlyga. T-SQL tipo where sąlygos užklausa iš lentelės N01 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_N01_LIST</method>
    <params>
        <fil> N01_KODAS_SS = '272' </fil>
    </params>
</body>

pvz application/json:

{
    "method": "GET_N01_LIST",
    "params": {
        "fil": "N01_KODAS_SS = '272'"
    }
}
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ą N01_KODAS_SS

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

<RET_DOK>
    <N01>
      <Row_number>1</Row_number>
      <N01_KODAS_SS>272         </N01_KODAS_SS>
      <N01_PAV>Kasa                                                                                                                                                  </N01_PAV>
      <N01_PAV_U>                                                                                                                                                      </N01_PAV_U>
      <N01_LYGIS>3</N01_LYGIS>
      <N01_TIPAS>2</N01_TIPAS>
      <N01_TEVAS>27          </N01_TEVAS>
      <N01_SASK_TIPAS>1</N01_SASK_TIPAS>
      <N01_BANK>0</N01_BANK>
      <N01_DOK_KONTR>0</N01_DOK_KONTR>
      <N01_KODAS_VL>            </N01_KODAS_VL>
      <N01_POZ_DATE>0</N01_POZ_DATE>
      <N01_BEG_DATE>2015-07-08T00:00:00</N01_BEG_DATE>
      <N01_END_DATE>2015-07-08T00:00:00</N01_END_DATE>
      <N01_ADDUSR>MASTER      </N01_ADDUSR>
      <N01_USERIS>MASTER      </N01_USERIS>
      <N01_R_DATE>2015-07-08T12:56:01</N01_R_DATE>
      <N01_KODAS_BT>            </N01_KODAS_BT>
      <N01_KODAS_LS>            </N01_KODAS_LS>
      <N01_KODAS_LS_2>            </N01_KODAS_LS_2>
      <N01_KODAS_LS_3>            </N01_KODAS_LS_3>
      <N01_KODAS_LS_4>            </N01_KODAS_LS_4>
      <N01_KODAS_CC>272         </N01_KODAS_CC>
      <N01_APVAL_CNT>0</N01_APVAL_CNT>
    </N01>
</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_N01_LIST",
    "params": {
        "fil": "N01_KODAS_SS = '272'"
    }
}');
$response = curl_exec($ch);
curl_close($ch);