Back to Gidas

GET_I04_LIST

internetiniai-underscore-moduliai-api-underscore-rest-get-underscore-i04-underscore-list.md

latest8.7 KB
Original Source

PDF

Pradžia Internetiniai moduliai Rivile API v2 (REST web servisai) GET_I04_LIST

GET_I04_LIST

Aprašymas

Įplaukų/išmokų registras

Specifikacija

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

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

xml
<body>
    <method>GET_I04_LIST</method>
    <params>
        <list>H</list>
        <fil>i04_kodas_ch='000000000001'</fil>
    </params>
</body>

pvz application/json:

json
{
    "method": "GET_I04_LIST",
    "params": {
        "list": "A",
        "fil": "i04_kodas_ch='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ą I04_KODAS_CH

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

pvz , kai list='A':

xml
<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
    <I04>
        <Row_number>1</Row_number>
        <I04_KODAS_CH>000000000001</I04_KODAS_CH>
        <I04_DOK_NR>PM-001</I04_DOK_NR>
        <I04_OP_RUSIS>2</I04_OP_RUSIS>
        <I04_OP_TIPAS>0</I04_OP_TIPAS>
        <I04_OP_STORNO>0</I04_OP_STORNO>
        <I04_OP_DATA>2019-12-13T00:00:00</I04_OP_DATA>
        <I04_KODAS_SS>2710</I04_KODAS_SS>
        <I04_MOKETOJAS>2</I04_MOKETOJAS>
        <I04_KODAS_KS></I04_KODAS_KS>
        <I04_PAV>Pajamų mokestis</I04_PAV>
        <I04_ADR></I04_ADR>
        <I04_ATSTOVAS></I04_ATSTOVAS>
        <I04_KODAS_VS></I04_KODAS_VS>
        <I04_SUMA>10.00</I04_SUMA>
        <I04_SUMA_DSK>0.00</I04_SUMA_DSK>
        <I04_SUMA_PLK>0.00</I04_SUMA_PLK>
        <I04_PASTABOS></I04_PASTABOS>
        <I04_PERKELTA>2</I04_PERKELTA>
        <I04_IMP_EXP>0</I04_IMP_EXP>
        <I04_KODAS_VL>EUR </I04_KODAS_VL>
        <I04_SUMA_VAL>7.00</I04_SUMA_VAL>
        <I04_KOEF>1.000000000000000</I04_KOEF>
        <I04_USERIS>MASTER</I04_USERIS>
        <I04_R_DATE>2017-01-04T11:28:47</I04_R_DATE>
        <I04_ADDUSR>MASTER</I04_ADDUSR>
        <I04_KODAS_SM></I04_KODAS_SM>
        <I04_APRASYMAS></I04_APRASYMAS>
        <I04_SUMA_PER>0.00</I04_SUMA_PER>
        <I04_BUSENA>1</I04_BUSENA>
        <I05>
            <I05_KODAS_CH>000000000001</I05_KODAS_CH>
            <I05_EIL_NR>1</I05_EIL_NR>
            <I05_DOK_NR></I05_DOK_NR>
            <I05_DATA_DOK>2019-12-13T00:00:00</I05_DATA_DOK>
            <I05_DATA_MOK>2019-12-13T00:00:00</I05_DATA_MOK>
            <I05_DATA_DSK>2019-12-13T00:00:00</I05_DATA_DSK>
            <I05_APR></I05_APR>
            <I05_SUMA>10.00</I05_SUMA>
            <I05_SUMA_DSK>0.00</I05_SUMA_DSK>
            <I05_SUMA_PLK>0.00</I05_SUMA_PLK>
            <I05_KODAS_SS>4481</I05_KODAS_SS>
            <I05_KODAS_VL>EUR</I05_KODAS_VL>
            <I05_KODAS_VL_S>EUR</I05_KODAS_VL_S>
            <I05_SUMA_VAL_DSK>0.00</I05_SUMA_VAL_DSK>
            <I05_KOEF>1.000000000000000</I05_KOEF>
            <I05_KOEF_S>1.000000000000000</I05_KOEF_S>
            <I05_SUMA_VAL>10.00</I05_SUMA_VAL>
            <I05_SUMA_VAL_S>10.00</I05_SUMA_VAL_S>
            <I05_KODAS_IS>01</I05_KODAS_IS>
            <I05_KODAS_OS></I05_KODAS_OS>
            <I05_KODAS_OS_C></I05_KODAS_OS_C>
            <I05_KODAS_MS></I05_KODAS_MS>
            <I05_USERIS>MASTER</I05_USERIS>
            <I05_R_DATE>2019-12-13T00:00:00</I05_R_DATE>
            <I05_ADDUSR>MASTER</I05_ADDUSR>
            <I05_KODAS_KT></I05_KODAS_KT>
            <I05_KODAS_K0></I05_KODAS_K0>
            <I05_SUMA_PER>0.00</I05_SUMA_PER>
        </I05>
    </I04>
</RET_DOK>

pvz , kai list='H'

xml
<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
    <I04>
        <Row_number>1</Row_number>
        <I04_KODAS_CH>000000000001</I04_KODAS_CH>
        <I04_DOK_NR>PM-001</I04_DOK_NR>
        <I04_OP_RUSIS>2</I04_OP_RUSIS>
        <I04_OP_TIPAS>0</I04_OP_TIPAS>
        <I04_OP_STORNO>0</I04_OP_STORNO>
        <I04_OP_DATA>2019-12-13T00:00:00</I04_OP_DATA>
        <I04_KODAS_SS>2710</I04_KODAS_SS>
        <I04_MOKETOJAS>2</I04_MOKETOJAS>
        <I04_KODAS_KS></I04_KODAS_KS>
        <I04_PAV>Pajamų mokestis</I04_PAV>
        <I04_ADR></I04_ADR>
        <I04_ATSTOVAS></I04_ATSTOVAS>
        <I04_KODAS_VS></I04_KODAS_VS>
        <I04_SUMA>10.00</I04_SUMA>
        <I04_SUMA_DSK>0.00</I04_SUMA_DSK>
        <I04_SUMA_PLK>0.00</I04_SUMA_PLK>
        <I04_PASTABOS></I04_PASTABOS>
        <I04_PERKELTA>2</I04_PERKELTA>
        ...
    </I04>
</RET_DOK>
Response (status 400)

Klaida paduodant duomenis / SQL sintaksės klaidos / kitos DB klaidos

xml
<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id>3451ded.be556121580910178112</id>
    <durationMs>25</durationMs>
    <errorMessage>Invalid column name 'i04_kodas_chb'.</errorMessage>
</RET_DOK>

Lentelės

I04

LaukasTipasAprašymas
I04_KODAS_CHC12Operacijos numeris
I04_DOK_NRC20Dokumento numeris
I04_OP_RUSISN1Rūšis:1-įplaukos,2-išmokos
I04_OP_TIPASN1Reikalavimo požymis:0-ne,1-taip
I04_OP_STORNON1Rezervas
I04_OP_DATAT8Operacijos data
I04_KODAS_SSC12Sąskaitos kodas
I04_MOKETOJASN1Sudengimo tipas:1-dokumentai,2-sąskaitos
I04_KODAS_KSC12Kliento kodas
I04_PAVC40Kliento pavadinimas
I04_ADRC40Kliento adresas
I04_ATSTOVASC40Atstovas
I04_KODAS_VSC12Vietovės kodas
I04_SUMAN12,2Operacijos suma
I04_SUMA_DSKN12,2Diskonto suma
I04_SUMA_PLKN12, 2Palūkanų suma
I04_PASTABOSC12Pastabos
I04_PERKELTAN 1Perkėlimo požymis:1-neperkelta,2-perkelta,3-koreguota
I04_IMP_EXPN 1Rezervas
I04_KODAS_VLC12Valiutos kodas
I04_SUMA_VALN18,2Valiutos suma
I04_KOEFN20,15Valiutos kursas
I04_USERISC12Kas koregavo
I04_R_DATET 8Kada koregavo
I04_ADDUSRC12Kas sukūrė
I04_KODAS_SMC12Asmuo
I04_APRASYMASC60Aprašymas
I04_SUMA_PERN12,2Valiutos perskaičiavimo suma
I04_SUMA_WKN12,2WB įsipareigojimų suma
I04_KODAS_LS_1C12Logistika 1
I04_KODAS_LS_2C12Logistika 2
I04_KODAS_LS_3C12Logistika 3
I04_KODAS_LS_4C12Logistika 4
I04_KODAS_ZNC12Zona
I04_BUSENAN3Būsena

I05

LaukasTipasAprašymas
I05_KODAS_CHC 12Operacijos numeris
I05_EIL_NRN 6Eilutės numeris dokumente
I05_DOK_NRC 20Dokumento numeris
I05_DATA_DOKT 8Dokumento data
I05_DATA_MOKT 8Mokėjimo data
I05_DATA_DSKT 8Diskonto data
I05_APRC 12Pastabos
I05_SUMAN 12.2Mokėjimo suma
I05_SUMA_DSKN 12.2Suteikiamas diskontas
I05_SUMA_PLKN 12.2Palūkanų suma
I05_KODAS_SSC 12Sąskaitos kodas
I05_KODAS_VLC 12Operacijos valiutos kodas
I05_KODAS_VL_SC 12Skolos valiutos kodas
I05_SUMA_VAL_DSKN 18.2Valiutos diskontas
I05_KOEFN 20.15Konvertavimo koeficientas -> Bazinė valiuta
I05_KOEF_SN 20.15Konvertavimo koeficientas <- Bazinė valiuta
I05_SUMA_VALN 18.2Mokėjimo suma valiuta
I05_SUMA_VAL_SN 18.2Sudengimo suma valiuta
I05_KODAS_ISC 12Padalinio kodas
I05_KODAS_OSC 12Objekto kodas
I05_KODAS_OS_CC 12Centro kodas
I05_KODAS_MSC 12Menedžerio kodas
I05_USERISC 12Kas koregavo
I05_R_DATET 8Kada koregavo
I05_ADDUSRC 12Kas sukūrė
I05_KODAS_KTC 12Sutartis
I05_KODAS_K0C 12Sutarties priedas
I05_SUMA_PERN 12.2Valiutos perskaičiavimo suma