Darbuotojo bankų koregavimas.
Informacija apie autorizaciją, bendruosius parametrus ir klaidų kodus: Rivile API v2 naudojimo pagrindai
method : EDIT_A08params :
oper :
I - naujo įrašo sukūrimasU - įrašo koregavimasD - įrašo ištrynimasdata: 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"
}
}
}
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>
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><A08></A08></data>
<dataErrors>
<dataError>
<tag>A08_KODAS_TB</tag>
<code>5009</code>
<message>Kodas nerastas</message>
</dataError>
</dataErrors>
</error>
</errors>
</RET_DOK>
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
$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);
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 |