EDIT_A08

Aprašymas

Darbuotojo bankų koregavimas.

Specifikacija

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

Body
  • method : EDIT_A08
  • params :
    • oper :
      • I - naujo įrašo sukūrimas
      • U - įrašo koregavimas
      • D - įrašo ištrynimas
  • data: perduodami duomenys:
    • A08 - atitinkamos lentelės laukai (A08)

Kadangi darbuotojų kortelėse gali būti saugoma konfidenciali informacija, jau egzistuojančių įrašų nuskaitymui ir koregavimui būtinas papildomas leidimas per Rivile Gama parametrą RGI_A06_FIL. Šiame parametre įvedamas papildomas filtravimas, galimų reikšmių pavyzdžiai: 1=1 (visos darbuotojų kortelės), A06_KODAS_LS_1='L1' (tik darbuotojų kortelės su pirmu logistikos kodu 'L1'). Filtravimo sąlygose galima naudoti visus lentelių A06, A07 ir A08 laukus.

Numatyta galimybė perduoti papildomų laukų informaciją, jei jie yra aprašyti Rivile GAMA programoje. Tam naudojamos žymos <PAP_1>, <PAP_2> ir t.t., kur skaičius nurodo konkretaus papildomo lauko numerį.

pvz application/xml:

<body>
    <method>EDIT_A08</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <A08>
            <A08_KODAS_TB>TST01</A08_KODAS_TB>
            <A08_KODAS_WS>10100</A08_KODAS_WS>
            <A08_PAV></A08_PAV>
            <A08_SUMA></A08_SUMA>
            <A08_PROC></A08_PROC>
            <A08_TAUP_FIL></A08_TAUP_FIL>
            <A08_TAUP_RUS></A08_TAUP_RUS>
            <A08_TAUP_SAS></A08_TAUP_SAS>
            <A08_PASTABOS></A08_PASTABOS>
            <PAP_1>Požymis 1</PAP_1> <!--Jeigu aprašyti papildomi laukai -->
        </A08>
    </data>
</body>

pvz application/json:

{
    "method": "EDIT_A08",
    "params": {
        "oper": "I"
    },
    "data": {
        "A08": {
            "A08_KODAS_TB": "TST01",
            "A08_KODAS_WS": "10100",
            "A08_PAV": "",
            "A08_SUMA": "",
            "A08_PROC": "",
            "A08_TAUP_FIL": "",
            "A08_TAUP_RUS": "",
            "A08_TAUP_SAS": "",
            "A08_PASTABOS": "",
            "PAP_1": "Požymis 1"
        }
    }
}
Response (status 200 OK)

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

pvz:

<RET_DOK>
    <A08>
        <A08_KODAS_TB>TST01       </A08_KODAS_TB>
        <A08_KODAS_WS>10100       </A08_KODAS_WS>
        <A08_PAV>Lietuvos bankas                                             </A08_PAV>
        <A08_SUMA>0.00</A08_SUMA>
        <A08_PROC>0.00</A08_PROC>
        <A08_TAUP_FIL>                   </A08_TAUP_FIL>
        <A08_TAUP_RUS>                   </A08_TAUP_RUS>
        <A08_TAUP_SAS>                                       </A08_TAUP_SAS>
        <A08_PASTABOS> </A08_PASTABOS>
        <A08_USERIS>AAAAAAAA     </A08_USERIS>
        <A08_R_DATE>2024-10-29T09:09:26</A08_R_DATE>
    </A08>
</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.8ec4537a.1716271246499</id>
    <durationMs>569</durationMs>
    <errorMessage>Nepavyko įvykdyti metodo</errorMessage>
    <document/>
    <errors>
        <error>
            <data>&lt;A08>&lt;/A08></data>
            <dataErrors>
                <dataError>
                    <tag>A08_KODAS_TB</tag>
                    <code>5009</code>
                    <message>Kodas nerastas</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:

<body>
    <method>EDIT_A08</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <A08>
            <A08_KODAS_TB>TST01</A08_KODAS_TB>
            <A08_KODAS_WS>10100</A08_KODAS_WS>
            <A08_SUMA>123</A08_SUMA>
        </A08>
    </data>
</body>

pvz išmetimas:

<body>
    <method>EDIT_A08</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <A08>
            <A08_KODAS_TB>TST01</A08_KODAS_TB>
            <A08_KODAS_WS>10100</A08_KODAS_WS>
        </A08>
    </data>
</body>

PHP pvz

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'ApiKey: 9999999.12345678910',
      'Content-Type: application/json',
      ]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
        "method": "EDIT_A08",
        "params": {
            "oper": "I"
        },
        "data": {
            "A08": {
                "A08_KODAS_TB": "TST01",
                "A08_KODAS_WS": "10100",
                "A08_PAV": "",
                "A08_SUMA": "",
                "A08_PROC": "",
                "A08_TAUP_FIL": "",
                "A08_TAUP_RUS": "",
                "A08_TAUP_SAS": "",
                "A08_PASTABOS": ""
            }
    }
    }');
$response = curl_exec($ch);
curl_close($ch);

Lentelės

A08

Darbuotojo banko informacija

Laukas Tipas Aprašymas Pastaba
A08_KODAS_TB char(12) Tabelinis Nr. Lauką būtina nurodyti visų tipų operacijose, išskyrus EDIT_A06_FULL metodo užklausoje - jis užsipildo automatiškai
A08_KODAS_WS char(12) Bankas Lauką būtina nurodyti visais atvejais
A08_PAV char(60) Pavadinimas
A08_SUMA numeric(12,2) Suma
A08_PROC numeric(6,2) Procentas
A08_TAUP_FIL char(20) Filialas
A08_TAUP_RUS char(20) Indėlio rūšis
A08_TAUP_SAS char(40) Indėlio sąskaita
A08_PASTABOS varchar(max) Pastabos
A08_USERIS char(12) Kas koregavo
A08_R_DATE datetime Kada koregavo
PAP_1, PAP_2... Papildomi laukai Veikia tik jei aprašyti Rivile Gama sistemoje