Personalo atleidimo operacijų dokumentų sukūrimas, koregavimas, trynimas.
Informacija apie autorizaciją, bendruosius parametrus ir klaidų kodus: Rivile API v2 naudojimo pagrindai
method : MGAMA_EDIT_K16_ATLDparams :
oper :I - naujo įrašo sukūrimas (numatytasis)U - dokumento koregavimasD - dokumento ištrynimasP - dokumento perkėlimasdata: perduodami duomenys:
K16 - Personalo operacijų antraštė (k16)Koreguoti galima tik to paties API vartotojo sukurtas operacijas. Teisės valdomos parametru RGI_ALL_EDIT
XML Request pvz.:
<body>
<method>MGAMA_EDIT_K16_ATLD</method>
<params>
<oper>I</oper>
</params>
<data>
<K16>
<K16_KODAS_6A>000R00016297</K16_KODAS_6A>
<K16_KODAS_6A_S>000R00016296</K16_KODAS_6A_S>
<K16_KODAS_0A>555</K16_KODAS_0A>
<K16_KODAS_4A>001</K16_KODAS_4A>
<K16_KODAS_5A></K16_KODAS_5A>
<K16_KODAS_IS>999999999999</K16_KODAS_IS>
<K16_OP_DATE>2024-04-30</K16_OP_DATE>
<K16_PAV>vardas pavarde</K16_PAV>
<K16_RUSIS>1</K16_RUSIS>
</K16>
</data>
</body>JSON Request pvz.:
{
"method": "MGAMA_EDIT_K16_ATLD",
"params": {
"oper": "I"
},
"data": {
"K16": {
"K16_KODAS_6A": "000R00016297",
"K16_KODAS_6A_S": "000R00016296",
"K16_KODAS_0A": "555",
"K16_KODAS_4A": "001",
"K16_KODAS_5A": {},
"K16_KODAS_IS": "999999999999",
"K16_OP_DATE": "2024-04-30",
"K16_PAV": "vardas pavarde",
"K16_RUSIS": "1"
}
}
}XML response pvz.:
<RET_DOK>
<K16_OPH>
<K16_KODAS_6A>000R00016304</K16_KODAS_6A>
<K16_KODAS_6A_S>000R00016303</K16_KODAS_6A_S>
<K16_DOK_NR>6AAL00000360</K16_DOK_NR>
<K16_END_DATE>2024-06-21T00:00:00</K16_END_DATE>
<K16_KODAS_0A>555 </K16_KODAS_0A>
<K16_KODAS_1A_14> </K16_KODAS_1A_14>
<K16_KODAS_1A_25> </K16_KODAS_1A_25>
<K16_KODAS_4A>001 </K16_KODAS_4A>
<K16_KODAS_5A> </K16_KODAS_5A>
<K16_KODAS_IS>999999999999</K16_KODAS_IS>
<K16_OP_DATE>2024-04-30T00:00:00</K16_OP_DATE>
<K16_PAV>v1 p1(darbuotojas r1) </K16_PAV>
<K16_RUSIS>1</K16_RUSIS>
<K16_TIPAS>3</K16_TIPAS>
<K16_PERKELTA>1</K16_PERKELTA>
<K16_ADDUSR>999 </K16_ADDUSR>
<K16_R_DATE>2024-04-30T12:13:58</K16_R_DATE>
<K16_USERIS>999 </K16_USERIS>
</K16_OPH>
</RET_DOK>JSON response pvz.:
{
"K16_OPH": {
"K16_KODAS_6A": "000R00016305",
"K16_KODAS_6A_S": "000R00016303",
"K16_DOK_NR": "6AAL00000361",
"K16_END_DATE": "2024-06-21T00:00:00",
"K16_KODAS_0A": 555,
"K16_KODAS_1A_14": "",
"K16_KODAS_1A_25": "",
"K16_KODAS_4A": "001",
"K16_KODAS_5A": "",
"K16_KODAS_IS": 999999999999,
"K16_OP_DATE": "2024-04-30T00:00:00",
"K16_PAV": "v1 p1(darbuotojas r1)",
"K16_RUSIS": 1,
"K16_TIPAS": 3,
"K16_PERKELTA": 1,
"K16_ADDUSR": "999",
"K16_R_DATE": "2024-04-30T12:14:19",
"K16_USERIS": "999"
}
}Klaida paduodant duomenis / SQL sintaksinės klaidos / kitos duomenų klaidos, pvz.:
<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
<id>4641133481.72d6d4a8.1714466326905</id>
<durationMs>497</durationMs>
<errorMessage>Nepavyko įvykdyti metodo</errorMessage>
<document/>
<errors>
<error>
<data><K16><num_row>1</num_row></K16></data>
<dataErrors>
<dataError>
<tag>K16_KODAS_6A_S</tag>
<code>19013</code>
<message>Nenurodytas kodas</message>
</dataError>
<dataError>
<tag>K16_END_DATE</tag>
<code>15012</code>
<message>Bloga reiksmė</message>
</dataError>
<dataError>
<tag>K16_KODAS_4A</tag>
<code>19013</code>
<message>Nenurodytas kodas</message>
</dataError>
<dataError>
<tag>K16_KODAS_0A</tag>
<code>19013</code>
<message>Nenurodytas kodas</message>
</dataError>
<dataError>
<tag>K16_KODAS_IS</tag>
<code>19013</code>
<message>Nenurodytas kodas</message>
</dataError>
</dataErrors>
</error>
</errors>
</RET_DOK>Koregavimas ir trynimas vyksta pagal atitinkamos lentelės raktą (Primary Key).
Koreguojant informaciją bus koreguojami tik perduodami laukai.
Pvz. koregavimas:
<body>
<method>MGAMA_EDIT_K16_ATLD</method>
<params>
<oper>U</oper>
</params>
<data>
<K16>
<K16_KODAS_6A>000000000001</K16_KODAS_6A>
<K16_apr>PAKEITIMAI</K16_apr>
</K16>
</data>
</body>Pvz. trynimas:
<body>
<method>MGAMA_EDIT_K16_ATLD</method>
<params>
<oper>D</oper>
</params>
<data>
<K16>
<K16_KODAS_6A>000000000001</K16_KODAS_6A>
</K16>
</data>
</body><?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'ApiKey: 999.987654321',
'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
"method": " MGAMA_EDIT_K16_ATLD ",
"params": {
"oper": "I"
},
"data": {
"K16": {
"K16_KODAS_6A": "000R00016297",
"K16_KODAS_6A_S": "000R00016296",
"K16_KODAS_0A": "555",
"K16_KODAS_4A": "001",
"K16_KODAS_5A": {},
"K16_KODAS_IS": "999999999999",
"K16_OP_DATE": "2024-04-30",
"K16_PAV": "vardas pavarde",
"K16_RUSIS": "1"
}
}
}');
$response = curl_exec($ch);
curl_close($ch);Personalo atleidimo dokumentų antraštės lentelė
| Laukas | Tipas | Aprašymas | Pastabos naudojant EDIT metodą |
|---|---|---|---|
| K16_APR | varchar(200) | Aprašymas | |
| K16_DOK_NR | char(12) | Dokumento numeris | Būtina užpildyti, jeigu parametro oper reikšmė yra "I" ir nėra aprašytas personalo priėmimo operacijų dokumentų skaitliukas |
| K16_END_DATE | datetime | Atleidimo data | Būtinas, kai oper=I |
| K16_KODAS_0A | char(12) | Etatas | Informacinis laukas, užsipildo automatiškai pagal informaciją iš priėmimo operacijos, nurodytos lauke KODAS_6A_S |
| K16_KODAS_1A_14 | char(12) | Atleidimo priežastis | |
| K16_KODAS_1A_25 | char(12) | Algos klasifikatorius | |
| K16_KODAS_4A | char(12) | Personalo kodas | Laukas apdorojime užsipildo automatiškai pagal informaciją iš priėmimo operacijos, nurodytos lauke KODAS_6A_S. Jeigu nenurodytas K16_KODAS_6A_S ir K16_KODAS_6A_F, tai pagal K16_KODAS_4A surandama aktyvi priėmimo operacija. Aktyvių priėmimo operacijų turi būti ne daugiau 1, kitu atveju gaunama klaida. |
| K16_KODAS_5A | char(12) | Specialybė | Informacinis laukas, užsipildo automatiškai pagal informaciją iš priėmimo operacijos, nurodytos lauke KODAS_6A_S |
| K16_KODAS_6A | char(12) | Operacijos numeris | Būtina užpildyti, kai užklausos parametras "oper" = U, D; t.y. kai vykdoma koregavimo arba trynimo operacija |
| K16_KODAS_6A_F | char(12) | Pirminė priėmimo operacija | Jeigu nenurodytas K16_KODAS_6A_S, tai pagal K16_KODAS_6A_F surandama aktyvi priėmimo operacija. Aktyvių priėmimo operacijų turi būti ne daugiau 1, kitu atveju gaunama klaida. |
| K16_KODAS_6A_S | char(12) | Priėmimo operacija | Lauką būtina užpildyti, kai parametro "oper" reikšmė = I ir darbuotojas (K16_KODAS_4A) turi daugiau nei 1 aktyvią priėmimo operaciją. |
| K16_KODAS_IS | char(12) | Padalinys | |
| K16_OP_DATE | datetime | Operacijos data | Jeigu nieko nenurodoma, laukas užpilodmas automatiškai šiandienos data |
| K16_PAV | varchar(200) | Personalo vardas, pavardė | Laukas apdorojime užsipildo automatiškai pagal informaciją iš priėmimo operacijos, nurodytos lauke KODAS_6A_S |
| K16_RUSIS | numeric(1,0) | Operacijos rūšis | 1 - Dokumentas, 2 - prašymas. Jeigu nieko nenurodoma, laukas užpilodmas reikšme 1. |
| K16_USERIS | char(12) | Administracinė informacija - kas sukūrė arba kas paskutinis koregavo operaciją | |
| K16_PERKELTA | numeric(1,0) | Perkėlimo požymis:1-neperkelta,2-perkelta,3-koreguota | |
| K16_ADDUSR | char(50) | Administracinė informacija - kas sukūrė operaciją | |
| K16_R_DATE | datetime | Administracinė informacija - kada paskutinį kartą buvo koreguota operacija | |
| K16_TIPAS | numeric(3,0) | Operacijos tipas | Informacinis laukas, užsipildo automatiškai |