internetiniai-underscore-moduliai-api-underscore-rest-mgama-underscore-edit-underscore-k14.md
Pradžia Internetiniai moduliai Rivile API v2 (REST web servisai) MGAMA_EDIT_K14
Personalo sąrašo sukūrimas, koregavimas, trinimas
Informacija apie autorizaciją, bendruosius parametrus ir klaidų kodus: Rivile API v2 naudojimo pagrindai
method : MGAMA_EDIT_K14
params :
oper :
I - naujos kortelės sukūrimasU - kortelės koregavimasD - kortelės išmetimasdata: perduodami duomenys:
K14 - personalo kortelės informacija (K14)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_K14_FIL. Šiame parametre įvedamas papildomas filtravimas, galimų reikšmių pavyzdžiai: 1=1 (visos darbuotojų kortelės), K14_KODAS_LS_1='L1' (tik darbuotojų kortelės su pirmu logistikos kodu 'L1'). Filtravimo sąlygose galima naudoti visus lentelės K14 laukus.
pvz application/xml:
<body>
<method>MGAMA_EDIT_K14</method>
<params>
<oper>I</oper>
</params>
<data>
<K14>
<K14_KODAS_4A>002</K14_KODAS_4A>
<K14_TIPAS> 1</K14_TIPAS>
<K14_AS_KODAS>123456789</K14_AS_KODAS>
<K14_VARDAS>Vardas</K14_VARDAS>
<K14_PAV>Pavardė</K14_PAV>
<K14_LYTIS>1</K14_LYTIS>
<K14_GIM>1989.01.09</K14_GIM>
<K14_KODAS_1A_04>LIETUVOS</K14_KODAS_1A_04>
<K14_KODAS_1A_05>LIETUVIS</K14_KODAS_1A_05>
<K14_KOMPETENCIJA>IT</K14_KOMPETENCIJA>
<K14_PASK_DARBOVIETE>UAB "Įmonė"</K14_PASK_DARBOVIETE>
<K14_STAZ_MET>1</K14_STAZ_MET>
<K14_STAZ_MEN>2</K14_STAZ_MEN>
<K14_STAZ_D>3</K14_STAZ_D>
<K14_VSTAZ_MET>4</K14_VSTAZ_MET>
<K14_VSTAZ_MEN>5</K14_VSTAZ_MEN>
<K14_VSTAZ_D>6</K14_VSTAZ_D>
<K14_SEIM_PAD>2</K14_SEIM_PAD>
<K14_SUT_VARDAS>Vardė</K14_SUT_VARDAS>
<K14_SUT_PAVARDE>Pavardė</K14_SUT_PAVARDE>
<K14_SUT_GIM>1990.10.10</K14_SUT_GIM>
<K14_ADR_REG>Vilnius</K14_ADR_REG>
<K14_ADR_GYV>Adresas</K14_ADR_GYV>
<K14_TEL>8888888888</K14_TEL>
<K14_MOB>9999999999</K14_MOB>
<K14_E_MAIL>[email protected]</K14_E_MAIL>
<K14_PASO_NR>123</K14_PASO_NR>
<K14_PASO_DATA>2018.01.22</K14_PASO_DATA>
...
</K14>
</data>
</body>
pvz application/json:
{
"method": "MGAMA_EDIT_K14",
"params": {
"oper": "I"
},
"data": {
"K14": {
"K14_KODAS_4A": "004",
"K14_TIPAS": 1,
"K14_AS_KODAS": "123456789",
"K14_VARDAS": "Vardas",
"K14_PAV": "Pavardė",
"K14_LYTIS": 1,
"K14_GIM": "1989.01.09",
"K14_KODAS_1A_04": "LIETUVOS",
"K14_KODAS_1A_05": "LIETUVIS",
"K14_KOMPETENCIJA": "IT",
"K14_PASK_DARBOVIETE": "UAB \"Įmonė\"",
"K14_STAZ_MET": 1,
"K14_STAZ_MEN": 2,
"K14_STAZ_D": 3,
"K14_VSTAZ_MET": 4,
"K14_VSTAZ_MEN": 5,
"K14_VSTAZ_D": 6,
"K14_SEIM_PAD": 2,
"K14_SUT_VARDAS": "Vardė",
"K14_SUT_PAVARDE": "Pavardė",
"K14_SUT_GIM": "1990.10.10",
"K14_ADR_REG": "Vilnius",
"K14_ADR_GYV": "Adresas",
"K14_TEL": "8888888888",
"K14_MOB": "9999999999",
"K14_E_MAIL": "[email protected]",
"K14_PASO_NR": "123",
"K14_PASO_DATA": "2018.01.22 00:00",
...
}
}
}
Grąžinama informacija XML formate tarp tag'ų <RET_DOK>..</RET_DOK>.
pvz :
<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
<K14>
<K14_KODAS_4A>002</K14_KODAS_4A>
<K14_TIPAS>1</K14_TIPAS>
<K14_AS_KODAS>123456789</K14_AS_KODAS>
<K14_VARDAS>Vardas</K14_VARDAS>
<K14_PAV>Pavardė</K14_PAV>
<K14_LYTIS>1</K14_LYTIS>
<K14_GIM>1989-01-09T00:00:00</K14_GIM>
<K14_KODAS_1A_04>LIETUVOS</K14_KODAS_1A_04>
<K14_KODAS_1A_05>LIETUVIS</K14_KODAS_1A_05>
<K14_KOMPETENCIJA>IT</K14_KOMPETENCIJA>
<K14_PASK_DARBOVIETE>UAB "Įmonė"</K14_PASK_DARBOVIETE>
<K14_STAZ_MET>1</K14_STAZ_MET>
<K14_STAZ_MEN>2</K14_STAZ_MEN>
<K14_STAZ_D>3</K14_STAZ_D>
<K14_VSTAZ_MET>4</K14_VSTAZ_MET>
<K14_VSTAZ_MEN>5</K14_VSTAZ_MEN>
<K14_VSTAZ_D>6</K14_VSTAZ_D>
<K14_SEIM_PAD>2</K14_SEIM_PAD>
<K14_SUT_VARDAS>Vardė</K14_SUT_VARDAS>
<K14_SUT_PAVARDE>Pavardė</K14_SUT_PAVARDE>
<K14_SUT_GIM>1990-10-10T00:00:00</K14_SUT_GIM>
<K14_ADR_REG>Vilnius</K14_ADR_REG>
<K14_ADR_GYV>Adresas</K14_ADR_GYV>
<K14_TEL>8888888888</K14_TEL>
<K14_MOB>9999999999</K14_MOB>
<K14_E_MAIL>[email protected]</K14_E_MAIL>
<K14_PASO_NR>123</K14_PASO_NR>
<K14_PASO_DATA>2018-01-22T00:00:00</K14_PASO_DATA>
<K14_PASO_GAL>2023-01-22T00:00:00</K14_PASO_GAL>
<K14_PASO_ISDAV>Vilnius</K14_PASO_ISDAV>
<K14_VAIR_NR>121</K14_VAIR_NR>
<K14_VAIR_DATA>2020-06-09T00:00:00</K14_VAIR_DATA>
<K14_VAIR_ISDAV>Testavičius</K14_VAIR_ISDAV>
<K14_SOD_NR>6666666</K14_SOD_NR>
<K14_VALS_NR>10</K14_VALS_NR>
<K14_VALS_KODAS>101</K14_VALS_KODAS>
<K14_VALS_NR_IMON>1001</K14_VALS_NR_IMON>
<K14_LK_PAZ_NR>123999</K14_LK_PAZ_NR>
<K14_KODAS_1A_09>LKV</K14_KODAS_1A_09>
<K14_LK_DATA>2020-06-02T00:00:00</K14_LK_DATA>
<K14_LK_ISDAV>Testavičienė </K14_LK_ISDAV>
<K14_DARBO_PAZ_NR>7777777</K14_DARBO_PAZ_NR>
<K14_KT_TARN>2</K14_KT_TARN>
<K14_KODAS_1A_10>GENEROLAS</K14_KODAS_1A_10>
<K14_KODAS_1A_11>PESTININKAS </K14_KODAS_1A_11>
<K14_KT_SPEC_KOD>123</K14_KT_SPEC_KOD>
<K14_KT_DOK_PAV>ABC123 </K14_KT_DOK_PAV>
<K14_KT_DOK_NR>321</K14_KT_DOK_NR>
<K14_KT_KUR_REG>Geležinis Vilkas </K14_KT_KUR_REG>
<K14_KT_DATA>2017-01-01T00:00:00</K14_KT_DATA>
<K14_KODAS_1A_12>TARNAUTOJAS </K14_KODAS_1A_12>
<K14_POZ_DATE>0</K14_POZ_DATE>
<K14_BEG_DATE>2020-06-05T00:00:00</K14_BEG_DATE>
<K14_END_DATE>2020-06-05T00:00:00</K14_END_DATE>
<K14_PASTABOS>Pastaba</K14_PASTABOS>
<K14_USERIS>B1NOONQ</K14_USERIS>
<K14_ADDUSR>B1NOONQ</K14_ADDUSR>
<K14_R_DATE>2020-06-25T14:52:34</K14_R_DATE>
<K14_ADD_DATE>2020-06-25T14:52:34</K14_ADD_DATE>
<K14_KODAS_LS_1>PARUOSTAS </K14_KODAS_LS_1>
<K14_KODAS_LS_2>2</K14_KODAS_LS_2>
<K14_KODAS_LS_3>3</K14_KODAS_LS_3>
<K14_KODAS_LS_4>0.0021</K14_KODAS_LS_4>
<K14_KODAS_1A_23>PENSIJA</K14_KODAS_1A_23>
<K14_DIRBA>0</K14_DIRBA>
<K14_KODAS_FR>FORMULE</K14_KODAS_FR>
<K14_VAIR_GAL>2024-06-25T00:00:00</K14_VAIR_GAL>
<K14_KODAS_LS_5>PARUOSTAS</K14_KODAS_LS_5>
<K14_KODAS_LS_6>3</K14_KODAS_LS_6>
<K14_KODAS_LS_7>2</K14_KODAS_LS_7>
<K14_KODAS_LS_8>0.0021</K14_KODAS_LS_8>
<k14_kodas_la>S_SISTEMINIS</k14_kodas_la>
</K14>
</RET_DOK>
Klaida paduodant duomenis / SQL sintaksės klaidos / kitos DB klaidos
<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
<id>21313695680.d79892fb.1593088125801</id>
<durationMs>6</durationMs>
<errorMessage>Nepavyko įvykdyti metodo</errorMessage>
<errors>
<error>
<data><K14><K14_ADR_REG>Vilnius</K14_ADR_REG><K14_KT_KUR_REG>Geležinis Vilkas</K14_KT_KUR_REG><K14_GIM>1989.01.09 00:00</K14_GIM><K14_VARDAS>Vardas</K14_VARDAS><K14_KT_DATA>2017.01.01 00:00</K14_KT_DATA><K14_VAIR_GAL>2024.06.25 00:00</K14_VAIR_GAL><K14_DARBO_PAZ_NR>7777777</K14_DARBO_PAZ_NR><K14_SUT_GIM>1990.10.10 00:00</K14_SUT_GIM><K14_KT_DOK_PAV>ABC123</K14_KT_DOK_PAV><K14_VAIR_DATA>2020.06.09 00:00</K14_VAIR_DATA><K14_PASTABOS>Pastaba</K14_PASTABOS><K14_VAIR_ISDAV>Testavičius</K14_VAIR_ISDAV><K14_KODAS_4A>002</K14_KODAS_4A><K14_PASO_ISDAV>Vilnius</K14_PASO_ISDAV><K14_KODAS_1A_09>LKV</K14_KODAS_1A_09><K14_KODAS_1A_04>LIETUVOS</K14_KODAS_1A_04><K14_KODAS_1A_05>LIETUVIS</K14_KODAS_1A_05><K14_KT_SPEC_KOD>123</K14_KT_SPEC_KOD><K14_SUT_VARDAS>Vardė</K14_SUT_VARDAS><K14_SEIM_PAD>2</K14_SEIM_PAD><K14_LK_PAZ_NR>123999</K14_LK_PAZ_NR><K14_PASO_NR>123</K14_PASO_NR><K14_PASO_DATA>2018.01.22 00:00</K14_PASO_DATA><K14_VALS_NR>10</K14_VALS_NR><K14_E_MAIL>[email protected]</K14_E_MAIL><K14_KOMPETENCIJA>IT</K14_KOMPETENCIJA><K14_SOD_NR>6666666</K14_SOD_NR><K14_PASK_DARBOVIETE>...</data>
<dataErrors>
<dataError>
<tag>K14_KODAS_4A</tag>
<code>13009</code>
<message>Toks įrašas jau egzistuoja</message>
</dataError>
</dataErrors>
</error>
</errors>
</RET_DOK>
Koregavimas, trynimas vykdomas pagal lentelės raktą (Primary Key)
Koreguojant informaciją bus koreguojami tik perduodami laukai.
pvz trinimas :
<body>
<method>MGAMA_EDIT_K14</method>
<params>
<oper>D</oper>
</params>
<data>
<K14>
<K14_KODAS_4A>003</K14_KODAS_4A>
</K14>
</data>
</body>
pvz koregavimas :
<body>
<method>MGAMA_EDIT_K14</method>
<params>
<oper>U</oper>
</params>
<data>
<K14>
<K14_KODAS_4A>002</K14_KODAS_4A>
<K14_SUT_VARDAS>Testas</K14_SUT_VARDAS>
<K14_SUT_PAVARDE>Testauskas</K14_SUT_PAVARDE>
</K14>
</data>
</body>
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'ApiKey: abcdef.12345',
'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
"method": "MGAMA_EDIT_K14",
"params": {
"oper": "I"
},
"data": {
"K14": {
"K14": {
"K14_KODAS_4A": "004",
"K14_TIPAS": 1,
"K14_AS_KODAS": "123456789",
"K14_VARDAS": "Vardas",
"K14_PAV": "Pavardė",
"K14_LYTIS": 1,
"K14_GIM": "1989.01.09",
"K14_KODAS_1A_04": "LIETUVOS",
"K14_KODAS_1A_05": "LIETUVIS",
"K14_KOMPETENCIJA": "IT",
"K14_PASK_DARBOVIETE": "UAB \"Įmonė\"",
"K14_STAZ_MET": 1,
"K14_STAZ_MEN": 2,
"K14_STAZ_D": 3,
"K14_VSTAZ_MET": 4,
"K14_VSTAZ_MEN": 5,
"K14_VSTAZ_D": 6,
"K14_SEIM_PAD": 2,
"K14_SUT_VARDAS": "Vardė",
"K14_SUT_PAVARDE": "Pavardė",
"K14_SUT_GIM": "1990.10.10",
"K14_ADR_REG": "Vilnius",
"K14_ADR_GYV": "Adresas",
"K14_TEL": "8888888888",
"K14_MOB": "9999999999",
"K14_E_MAIL": "[email protected]",
"K14_PASO_NR": "123",
"K14_PASO_DATA": "2018.01.22 00:00",
...
}
}
}');
$response = curl_exec($ch);
curl_close($ch);
Personalo sąrašo lentelė.
| Laukas | Tipas | Aprašymas | Pastabos naudojant EDIT metodus |
|---|---|---|---|
| K14_KODAS_4A | C(12) | Kodas | Privalomas , kai oper=U,D,P |
| K14_TIPAS | N(1) | Tipas: 1-Darbuotojas,2-Pretendentas | |
| K14_AS_KODAS | C(21) | Asmens kodas | |
| K14_VARDAS | C(20) | Vardas | |
| K14_PAV | C(60) | Pavardė | |
| K14_LYTIS | N(1) | Lytis 1-vyr./2-moter. | |
| K14_GIM | T(8) | Gimimo data | |
| K14_KODAS_1A_04 | C(12) | Pilietybė | |
| K14_KODAS_1A_05 | C(12) | Tautybė | |
| K14_KOMPETENCIJA | C(100) | Kompetencija | |
| K14_PASK_DARBOVIETE | C(100) | Informacija apie paskutinę darbovietę | |
| K14_STAZ_MET | N(3) | Darbo stažas iki registraviomo metais | |
| K14_STAZ_MEN | N(2) | Darbo stažas iki registraviomo mėnesiais | |
| K14_STAZ_D | N(2) | Darbo stažas iki registraviomo dienomis | |
| K14_VSTAZ_MET | N(3) | Darbo stažas iki registraviomo valst. institucijoje metais | |
| K14_VSTAZ_MEN | N(2) | Darbo stažas iki registraviomo valst. institucijoje mėn. | |
| K14_VSTAZ_D | N(2) | Darbo stažas iki registraviomo valst. institucijoje dienomis | |
| K14_SEIM_PAD | N(1) | Šeimyninė padėtis. 1-ved.,2-neved.,3-išsisk.,4-Našlys | |
| K14_SUT_VARDAS | C(20) | Sutuoktinio vardas | |
| K14_SUT_PAVARDE | C(20) | Sutuoktinio pavardė | |
| K14_SUT_GIM | T(8) | Sutuoktinio gimimo data | |
| K14_ADR_REG | C(60) | Kur registruotas | |
| K14_ADR_GYV | C(60) | Kur gyvena | |
| K14_TEL | C(40) | Telefonas | |
| K14_MOB | C(40) | Mobilus | |
| K14_E_MAIL | C(150) | E-mailas | Laukas pailgintas 125.0000 versijoje |
| K14_PASO_NR | C(20) | Paso Nr. | |
| K14_PASO_DATA | T(8) | Paso išdavimo data | |
| K14_PASO_GAL | T(8) | Paso galiojimo data | |
| K14_PASO_ISDAV | C(60) | Paso išdavimo vieta | |
| K14_VAIR_NR | C(20) | Vairuotojo pažymėjimo Nr. | |
| K14_VAIR_DATA | T(8) | Vairuotojo pažymėjimo išdavimo data | |
| K14_VAIR_ISDAV | C(60) | Kas išdavė vairuotojo pažymėjimą | |
| K14_SOD_NR | C(20) | Sodros pažymėjimo Nr. | |
| K14_VALS_NR | C(20) | Valstybės tranautojo paž. Nr. | |
| K14_VALS_KODAS | C(20) | Valstybės tranautojo paž. kodas | |
| K14_VALS_NR_IMON | C(20) | Valstybės tranautojo paž. Nr. įmonėje | |
| K14_LK_PAZ_NR | C(20) | Lietuvių kalbos paž. Nr | |
| K14_KODAS_1A_09 | C(12) | Lietuvių kalbos kvalifikacinė kategorija | |
| K14_LK_DATA | T(8) | Lietuvių kalbos paž. išdavimo data | |
| K14_LK_ISDAV | C(60) | Lietuvių kalbos paž. išdavėjas | |
| K14_DARBO_PAZ_NR | C(20) | Darbo pažymėjimo Nr. | |
| K14_KT_TARN | N(1) | Atitarnavęs: 1-Taip/0-Ne | |
| K14_KODAS_1A_10 | C(12) | Karinis laipsnis | |
| K14_KODAS_1A_11 | C(12) | Karinė parengtis | |
| K14_KT_SPEC_KOD | C(20) | Karinės specialybės kodas | |
| K14_KT_DOK_PAV | C(60) | Karinio dok. pavadinimas | |
| K14_KT_DOK_NR | C(20) | Karinio liudijimo Nr. | |
| K14_KT_KUR_REG | C(60) | Registruostas karinėje įstaigoje | |
| K14_KT_DATA | T(8) | Karinėje įstaigoje registravimo data | |
| K14_KODAS_1A_12 | C(12) | Pareigybės | |
| K14_POZ_DATE | N(1) | Terminuota: 1-Taip, 0-Ne | |
| K14_BEG_DATE | T(8) | Pradžios data | |
| K14_END_DATE | T(8) | Pabaigos data | |
| K14_PASTABOS | M(4) | Pastabos | |
| K14_USERIS | C(12) | Kas koregavo | |
| K14_ADDUSR | C(12) | Kas sukūrė | |
| K14_R_DATE | T(8) | Kada koregavo | |
| K14_ADD_DATE | T(8) | Kada sukūrė | |
| K14_KODAS_LS_1 | C(12) | Logistikos kodas 1 | |
| K14_KODAS_LS_2 | C(12) | Logistikos kodas 2 | |
| K14_KODAS_LS_3 | C(12) | Logistikos kodas 3 | |
| K14_KODAS_LS_4 | C(12) | Logistikos kodas 4 | |
| K14_KODAS_1A_23 | C(12) | Pensijos rūšis | |
| K14_DIRBA | N(1) | Ar asmuo dirba: 0-Ne,1-Taip | |
| K14_KODAS_FR | C(12) | Formulės kodas | |
| K14_VAIR_GAL | T(8) | Vairuotojo pažymėjimo galiojimas | |
| K14_KODAS_LS_5 | C(12) | Logistikos kodas 5 | |
| K14_KODAS_LS_6 | C(12) | Logistikos kodas 6 | |
| K14_KODAS_LS_7 | C(12) | Logistikos kodas 7 | |
| K14_KODAS_LS_8 | C(10) | Logistikos kodas 8 | |
| K14_KODAS_LA | C(12) | Kalendorius |