Personalo atostogų pratęsimo operacijų dokumentų sukūrimas, koregavimas, trynimas.
Informacija apie autorizaciją, bendruosius parametrus ir klaidų kodus: Rivile API v2 naudojimo pagrindai
method : MGAMA_EDIT_K16_ATPRAparams :
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_ATPRA</method>
<params>
<oper>I</oper>
</params>
<data>
<K16>
<K16_KODAS_6A_S>00R000000001</K16_KODAS_6A_S>
<K16_SUT_NR>00R000000100</K16_SUT_NR>
<K16_end_date>2024-05-15</K16_end_date>
</K16>
</data>
</body>JSON Request pvz.:
{
"method": "MGAMA_EDIT_K16_ATPRA",
"params": {
"oper": "I"
},
"data": {
"K16": {
"K16_KODAS_6A_S": "00R000000001",
"K16_SUT_NR": "00R000000100",
"K16_end_date": "2024-05-15"
}
}
}XML response pvz.:
<RET_DOK>
<K16_OPH>
<K16_KODAS_6A>000R00016301</K16_KODAS_6A>
<K16_KODAS_6A_S>000R00016299</K16_KODAS_6A_S>
<K16_BEG_DATE>2024-06-12T00:00:00</K16_BEG_DATE>
<K16_DIENOS_SV>0.000</K16_DIENOS_SV>
<K16_DIENU_SK>10.000</K16_DIENU_SK>
<K16_DOK_NR>6AATP0000246</K16_DOK_NR>
<K16_END_DATE>2024-06-21T00:00:00</K16_END_DATE>
<K16_KODAS_0A>555 </K16_KODAS_0A>
<K16_KODAS_1A_19> </K16_KODAS_1A_19>
<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_SUT_NR>000R00016300</K16_SUT_NR>
<K16_PERKELTA>1</K16_PERKELTA>
<K16_ADDUSR>999 </K16_ADDUSR>
<K16_R_DATE>2024-04-30T12:10:09</K16_R_DATE>
<K16_USERIS>999 </K16_USERIS>
</K16_OPH>
</RET_DOK>JSON response pvz.:
{
"K16_OPH": {
"K16_KODAS_6A": "000R00016302",
"K16_KODAS_6A_S": "000R00016299",
"K16_BEG_DATE": "2024-06-12T00:00:00",
"K16_DIENOS_SV": 0,
"K16_DIENU_SK": 10,
"K16_DOK_NR": "6AATP0000247",
"K16_END_DATE": "2024-06-21T00:00:00",
"K16_KODAS_0A": 555,
"K16_KODAS_1A_19": "",
"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_SUT_NR": "000R00016300",
"K16_PERKELTA": 1,
"K16_ADDUSR": "999",
"K16_R_DATE": "2024-04-30T12:10:38",
"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_BEG_DATE</tag>
<code>15012</code>
<message>Bloga reiksmė</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>
<dataError>
<tag>K16_DIENU_SK</tag>
<code>15012</code>
<message>Bloga reiksmė</message>
</dataError>
<dataError>
<tag>K16_DIENU_SK</tag>
<code>21006</code>
<message>Negalima neigiama reikšmė</message>
</dataError>
<dataError>
<tag>K16_SUT_NR</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_ATPRA</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_ATPRA</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_ATPRA ",
"params": {
"oper": "I"
},
"data": {
"K16": {
"K16_KODAS_6A_S": "00R000000001",
"K16_SUT_NR": "00R000000100",
"K16_end_date": "2024-05-15"
}
}
}');
$response = curl_exec($ch);
curl_close($ch);Personalo atostogų pratęsimo dokumentų antraštės lentelė
| Laukas | Tipas | Aprašymas | Pastabos naudojant EDIT metodą |
|---|---|---|---|
| K16_APR | varchar(200) | Aprašymas | |
| K16_BEG_DATE | datetime | Atostogų pratęsimo pradžios data | Lauką būtina užpildyti, kai parametro "oper" reikšmė = I; t.y. kai vykdoma įterpimo operacija |
| K16_DIENOS_SV | numeric(12,3) | Nedarbo dienų skaičius | Informacinis laukas, užsipildo automatiškai |
| K16_DIENU_SK | numeric(12,3) | Atostogų pratęsimo dienų skaičius | Būtinas, jeigu nėra pateikta END_DATE reikšmė. Jeigu pateikta ir END_DATE, ir DIENU_SK reikšmės, tai pratęsimo laikotarpis skaičiuojamas pagal DIENU_SK |
| 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 | Atostogų pratęsimo pabaigos data | Būtinas, jeigu nėra pateikta DIENU_SK reikšmė. Jeigu pateikta ir END_DATE, ir DIENU_SK reikšmės, tai pratęsimo laikotarpis skaičiuojamas pagal DIENU_SK |
| 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_19 | char(12) | Atostogų tipas | Informacinis laukas, užsipildo automatiškai pagal informaciją iš priėmimo operacijos, nurodytos lauke KODAS_6A_S |
| 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_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_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_IS | char(12) | Padalinys | Informacinis laukas, užsipildo automatiškai pagal informaciją iš priėmimo operacijos, nurodytos lauke KODAS_6A_S |
| 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_SUT_NR | char(12) | Atostogų operacija | Lauką būtina užpildyti, kai parametro "oper" reikšmė = I; t.y. kai vykdoma įterpimo operacija |
| 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 |