Back to Gidas

EDIT_I53

internetiniai-underscore-moduliai-api-underscore-rest-edit-underscore-i53.md

latest3.2 KB
Original Source

PDF

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

EDIT_I53

Aprašymas

Mokėjimo operacijų koregavimas.

Specifikacija

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

Body
  • method : EDIT_I53

  • params :

    • oper :
      • I - naujo įrašo sukūrimas
      • U - įrašo koregavimas
      • D - įrašo išmetimas
  • data: perduodami duomenys:

    • I53 - atitinkamos lentelės laukai (i53)

pvz application/xml:

xml
<body>
    <method>EDIT_I53</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <I53>
            <I53_OP_RUSIS>1</I53_OP_RUSIS>
            <I53_DOK_NR>RIV01</I53_DOK_NR>
            <I53_KODAS_KS>123456789</I53_KODAS_KS>
            <I53_SUMA>100</I53_SUMA>
        </I53>
    </data>
</body>

pvz application/json:

json
{
    "method": "EDIT_I53",
    "params": {
        "oper": "I"
    },
    "data": {
        "I53": {
            "I53_OP_RUSIS": 1,
            "I53_DOK_NR":"RIV01",
            "I53_KODAS_KS": "123456789",
            "I53_SUMA": 100
        }
    }
}
Response (status 200 OK)

Grąžinama informacija XML formate tarp tag'ų <RET_DOK>..</RET_DOK>.

pvz :

xml
<?xml version='1.0'?>
<RET_DOK>
    <I53>
        <I53_KODAS_OI>010R00000002</I53_KODAS_OI>
        <I53_OP_RUSIS>1</I53_OP_RUSIS>
        <I53_PAV> </I53_PAV>
        <I53_DOK_NR>RIV01 </I53_DOK_NR>
        <I53_DATA>2021-05-03T00:00:00</I53_DATA>
        <I53_KODAS_KS>123456789 </I53_KODAS_KS>
        <I53_KODAS_SS> </I53_KODAS_SS>
        <I53_KODAS_VL> </I53_KODAS_VL>
        <I53_SUMA>100.00</I53_SUMA>
        <I53_MOKETOJAS>1</I53_MOKETOJAS>
        ...
    </I53>
</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>14433105830.9def1bf4.1584217427751</id>
    <durationMs>45</durationMs>
    <errorMessage>nepavyko įvykdyti metodo</errorMessage>
    <errors>
        <error>
            <data>&lt;I64>&lt;/I64></data>
            <dataErrors>
                <dataError>
                    <tag>I53_DATA</tag>
                    <code>16004</code>
                    <message>Neprieinamas periodas</message>
                </dataError>
            </dataErrors>
        </error>
    </errors>
</RET_DOK>
Koregavimas ir išmetimas

Koregavimas, išmetimas vyksta pagal lentelės raktą (Primary Key)

Koreguojant informaciją bus koreguojami tik perduodami laukai.

pvz koregavimas :

xml
<body>
    <method>EDIT_I53</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <I53>
            <I53_KODAS_OI>010R00000002</I53_KODAS_OI>
            <I53_DOK_NR>RIV01/1</I53_DOK_NR>
        </I53>
    </data>
</body>

pvz išmetimas :

xml
<body>
    <method>EDIT_I53</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <I53>
            <I53_KODAS_OI>010R00000002</I53_KODAS_OI>
        </I53>
    </data>
</body>