MGAMA_EDIT_K16_ATPRA

Aprašymas

Personalo atostogų pratęsimo operacijų dokumentų sukūrimas, koregavimas, trynimas.

Specifikacija

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

Body

method : MGAMA_EDIT_K16_ATPRA
params :
- oper :
- I - naujo įrašo sukūrimas (numatytasis)
- U - dokumento koregavimas
- D - dokumento ištrynimas
- P - dokumento perkėlimas
data: perduodami duomenys:
- K16 - Personalo operacijų antraštė (k16)

Koreguoti galima tik to paties API vartotojo sukurtas operacijas. Teisės valdomos parametru RGI_ALL_EDIT

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.

XML Request pvz.:

xml

<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.:

json

{
    "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 (status 200 OK)

XML response pvz.:

xml

<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.:

xml

{
    "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"
    }
}

Response (status 400)

Klaida paduodant duomenis / SQL sintaksinės klaidos / kitos duomenų klaidos, pvz.:

xml

<?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>&lt;K16>&lt;num_row>1&lt;/num_row>&lt;/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

Koregavimas ir trynimas vyksta pagal atitinkamos lentelės raktą (Primary Key).

Koreguojant informaciją bus koreguojami tik perduodami laukai.

Pvz. koregavimas:

xml

<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:

xml

<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 pavyzdys:

php

<?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);

Lentelės

K16

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