EDIT_A06

Aprašymas

Darbuotojo koregavimas.

Specifikacija

Address

POST https://api.manorivile.lt/client/v2

Header

ApiKey : Privalomas. Unikalus API raktas išduodamas užsakant paslaugą
Content-Type : Privalomas. Kokiu formatu paduodami parametrai ir duomenys (request):
- application/xml
- application/json
Accept: Neprivalomas. Gražinamo rezultato (response) formatas
- application/xml(default)
- application/json (veikia nuo Manorivile-Gateway-1.1.0 versijos)

Body

method : EDIT_A06
params :
- oper :
  - I - naujo įrašo sukūrimas
  - U - įrašo koregavimas
  - D - įrašo ištrynimas
data: perduodami duomenys:
- A06 - atitinkamos lentelės laukai (A06)

Vienu metu veiksmai atliekami tik su vienu įrašu.

Pirmi 7 ApiKey simboliai (pvz USERABC.JQKPG1d7Pkjxj37ObsgdfEkvfEfvF1oL7h7UMOLo -> USERABC) yra vartotojo vardas Rivile GAMA programoje, kuriuo bus kuriami ar koreguojami įrašai.

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.

pvz application/xml:

<body>
    <method>EDIT_A06</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <A06>
            <A06_KODAS_TB>TST01</A06_KODAS_TB>
            <A06_KODAS_IS>999999999999</A06_KODAS_IS>
            <A06_VARDAS></A06_VARDAS>
            <A06_PAV></A06_PAV>
            <A06_LYTIS>1</A06_LYTIS>
            <A06_KODAS_VS></A06_KODAS_VS>
            <A06_KODAS_MS></A06_KODAS_MS>
            <A06_KODAS_GS></A06_KODAS_GS>
            <A06_KODAS_LS_1></A06_KODAS_LS_1>
            <A06_KODAS_LS_2></A06_KODAS_LS_2>
            <A06_KODAS_LS_3></A06_KODAS_LS_3>
            <A06_KODAS_LS_4></A06_KODAS_LS_4>
            <A06_ADR1></A06_ADR1>
            <A06_ADR2></A06_ADR2>
            <A06_ADR3></A06_ADR3>
            <A06_PAS_NR></A06_PAS_NR>
            <A06_SOD_NR></A06_SOD_NR>
            <A06_APDR_NR></A06_APDR_NR>
            <A06_KODAS_SS></A06_KODAS_SS>
            <A06_AVANSAS></A06_AVANSAS>
            <A06_ZML_NUO></A06_ZML_NUO>
            <A06_ZML_NUOP></A06_ZML_NUOP>
            <A06_ZML_IKI></A06_ZML_IKI>
            <A06_ZML_IKIP></A06_ZML_IKIP>
            <A06_PASTABOS></A06_PASTABOS>
            <A06_STAZAS></A06_STAZAS>
            <A06_SEIMA>2</A06_SEIMA>
            <A06_KODAS_OS_C></A06_KODAS_OS_C>
            <A06_SERIJA></A06_SERIJA>
            <A06_KODAS_SM></A06_KODAS_SM>
            <A06_REZERVAS></A06_REZERVAS>
            <A06_SAVIVALD></A06_SAVIVALD>
            <A06_SAVIVALD_G></A06_SAVIVALD_G>
            <A06_KODAS_4A></A06_KODAS_4A>
            <A06_KODAS_LS_5></A06_KODAS_LS_5>
            <A06_KODAS_LS_6></A06_KODAS_LS_6>
            <A06_KODAS_LS_7></A06_KODAS_LS_7>
            <A06_KODAS_LS_8></A06_KODAS_LS_8>
            <A06_SALIS></A06_SALIS>
            <A06_APRASYMAS1></A06_APRASYMAS1>
            <A06_APRASYMAS2></A06_APRASYMAS2>
            <A06_APRASYMAS3></A06_APRASYMAS3>
            <A06_APRASYMAS4></A06_APRASYMAS4>
            <A06_APRASYMAS5></A06_APRASYMAS5>
            <A06_APRASYMAS6></A06_APRASYMAS6>
        </A06>
    </data>
</body>

pvz application/json:

{
    "method": "EDIT_A06",
    "params": {
        "oper": "I"
    },
    "data": {
        "A06": {
                "A06_KODAS_TB": "TST01",
                "A06_KODAS_IS": "999999999999",
                "A06_VARDAS": "",
                "A06_PAV": "",
                "A06_LYTIS": "1",
                "A06_KODAS_VS": "",
                "A06_KODAS_MS": "",
                "A06_KODAS_GS": "",
                "A06_KODAS_LS_1": "",
                "A06_KODAS_LS_2": "",
                "A06_KODAS_LS_3": "",
                "A06_KODAS_LS_4": "",
                "A06_ADR1": "",
                "A06_ADR2": "",
                "A06_ADR3": "",
                "A06_PAS_NR": "",
                "A06_SOD_NR": "",
                "A06_APDR_NR": "",
                "A06_KODAS_SS": "",
                "A06_AVANSAS": "",
                "A06_ZML_NUO": "",
                "A06_ZML_NUOP": "",
                "A06_ZML_IKI": "",
                "A06_ZML_IKIP": "",
                "A06_PASTABOS": "",
                "A06_STAZAS": "",
                "A06_SEIMA": "2",
                "A06_KODAS_OS_C": "",
                "A06_SERIJA": "",
                "A06_KODAS_SM": "",
                "A06_REZERVAS": "",
                "A06_SAVIVALD": "",
                "A06_SAVIVALD_G": "",
                "A06_KODAS_4A": "",
                "A06_KODAS_LS_5": "",
                "A06_KODAS_LS_6": "",
                "A06_KODAS_LS_7": "",
                "A06_KODAS_LS_8": "",
                "A06_SALIS": "",
                "A06_APRASYMAS1": "",
                "A06_APRASYMAS2": "",
                "A06_APRASYMAS3": "",
                "A06_APRASYMAS4": "",
                "A06_APRASYMAS5": "",
                "A06_APRASYMAS6": ""
            }
    }
}

Response (status 200 OK)

Grąžinama informacija XML formate tarp tag'ų <RET_DOK>..</RET_DOK>.

pvz:

<RET_DOK>
    <A06>
        <A06_KODAS_TB>TST01       </A06_KODAS_TB>
        <A06_VARDAS></A06_VARDAS>
        <A06_PAV></A06_PAV>
        <A06_LYTIS>1</A06_LYTIS>
        <A06_KODAS_VS>           </A06_KODAS_VS>
        <A06_KODAS_MS>           </A06_KODAS_MS>
        <A06_KODAS_GS>           </A06_KODAS_GS>
        <A06_KODAS_LS_1>           </A06_KODAS_LS_1>
        <A06_KODAS_LS_2>           </A06_KODAS_LS_2>
        <A06_KODAS_LS_3>           </A06_KODAS_LS_3>
        <A06_KODAS_LS_4>           </A06_KODAS_LS_4>
        <A06_IM_ID>00</A06_IM_ID>
        <A06_ADR1>                                                                     </A06_ADR1>
        <A06_ADR2>                                                                     </A06_ADR2>
        <A06_ADR3>                                                                     </A06_ADR3>
        <A06_PAS_NR>                   </A06_PAS_NR>
        <A06_SOD_NR>                   </A06_SOD_NR>
        <A06_APDR_NR>                    </A06_APDR_NR>
        <A06_KODAS_IS>999999999999</A06_KODAS_IS>
        <A06_KODAS_SS>           </A06_KODAS_SS>
        <A06_AVANSAS>0.00</A06_AVANSAS>
        <A06_ZML_NUO>1900-01-01T00:00:00</A06_ZML_NUO>
        <A06_ZML_NUOP>1900-01-01T00:00:00</A06_ZML_NUOP>
        <A06_ZML_IKI>3999-01-01T00:00:00</A06_ZML_IKI>
        <A06_ZML_IKIP>3999-01-01T00:00:00</A06_ZML_IKIP>
        <A06_PASTABOS> </A06_PASTABOS>
        <A06_USERIS>AAAAAAAA     </A06_USERIS>
        <A06_R_DATE>2024-10-29T08:42:46</A06_R_DATE>
        <A06_GIM_DATA>1900-01-01T00:00:00</A06_GIM_DATA>
        <A06_STAZAS>0.00</A06_STAZAS>
        <A06_SEIMA>2</A06_SEIMA>
        <A06_KODAS_OS_C>           </A06_KODAS_OS_C>
        <A06_SERIJA>              </A06_SERIJA>
        <A06_KODAS_SM>           </A06_KODAS_SM>
        <A06_REZERVAS>                                       </A06_REZERVAS>
        <A06_SAVIVALD>           </A06_SAVIVALD>
        <A06_SAVIVALD_G> </A06_SAVIVALD_G>
        <A06_KODAS_4A>           </A06_KODAS_4A>
        <A06_KODAS_LS_5>           </A06_KODAS_LS_5>
        <A06_KODAS_LS_6>           </A06_KODAS_LS_6>
        <A06_KODAS_LS_7>           </A06_KODAS_LS_7>
        <A06_KODAS_LS_8>           </A06_KODAS_LS_8>
        <A06_SALIS>    </A06_SALIS>
        <A06_APRASYMAS1></A06_APRASYMAS1>
        <A06_APRASYMAS2></A06_APRASYMAS2>
        <A06_APRASYMAS3></A06_APRASYMAS3>
        <A06_APRASYMAS4></A06_APRASYMAS4>
        <A06_APRASYMAS5></A06_APRASYMAS5>
        <A06_APRASYMAS6></A06_APRASYMAS6>
    </A06>
</RET_DOK>

Response (status 400)

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>&lt;A06>&lt;/A06></data>
            <dataErrors>
                <dataError>
                    <tag>A06_KODAS_TB</tag>
                    <code>5009</code>
                    <message>Kodas nerastas</message>
                </dataError>
            </dataErrors>
        </error>
    </errors>
</RET_DOK>

Response (status 401)

Blogai nurodytas adresas / neteisingai nurodytas API raktas / nenurodytas API raktas / pasibaigęs API rakto galiojimas, pvz

<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id/>
    <durationMs>0</durationMs>
    <errorMessage>Api key is not valid</errorMessage>
</RET_DOK>

Response (status 502)

Nepaleistas MANO Rivile Gateway arba kitaip sutrikusi jo veikla

<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id/>
    <durationMs>0</durationMs>
    <errorMessage>Rivile GAMA database is unavailable. Please check if the gateway is running and is set up correctly.</errorMessage>
</RET_DOK>

Response (status 504)

Laiku nebuvo gautas Rivile API užklausos atsakymas, pavyzdžiui, apkrauta GAMA duomenų bazė

<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id/>
    <durationMs>0</durationMs>
    <errorMessage>No response received from client gateway</errorMessage>
</RET_DOK>

Response (status 500)

Bendrinė sistemos klaida, pvz

<?xml version='1.0' encoding='UTF-8'?>
<Map>
    <timestamp>2020-02-05T12:34:26.890+0000</timestamp>
    <status>500</status>
    <error>Internal Server Error</error>
    <message>No message available</message>
    <path>/v2</path>
</Map>

Koregavimas ir išmetimas

Koregavimas, išmetimas vyksta pagal lentelės raktą (Primary Key)

Koreguojant informaciją bus koreguojami tik perduodami laukai.

pvz koregavimas:

<body>
    <method>EDIT_A06</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <A06>
            <A06_KODAS_TB>TST01</A06_KODAS_TB>
            <A06_PAV>Koreguota informacija</A06_PAV>
        </A06>
    </data>
</body>

pvz išmetimas:

<body>
    <method>EDIT_A06</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <A06>
            <A06_KODAS_TB>TST01</A06_KODAS_TB>
        </A06>
    </data>
</body>

PHP pvz

<?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_A06",
        "params": {
            "oper": "I"
        },
        "data": {
            "A06": {
                "A06_KODAS_TB": "TST01",
                "A06_KODAS_IS": "999999999999"
            }
    }
    }');
$response = curl_exec($ch);
curl_close($ch);

Lentelės

A06

Darbuotojo informacija

Laukas	Tipas	Aprašymas
A06_KODAS_TB	char(12)	Tabelinis Nr.
A06_VARDAS	char(100)	Vardas
A06_PAV	char(100)	Pavarde
A06_LYTIS	numeric(1,0)	Lytis: 1-vyras; 2-moteris.
A06_KODAS_VS	char(12)	Vietovė
A06_KODAS_MS	char(12)	Menedžeris
A06_KODAS_GS	char(12)	Grupė
A06_KODAS_LS_1	char(12)	Logistikos kodas 1
A06_KODAS_LS_2	char(12)	Logistikos kodas 2
A06_KODAS_LS_3	char(12)	Logistikos kodas 3
A06_KODAS_LS_4	char(12)	Logistikos kodas 4
A06_IM_ID	char(2)	Įmonės indentifikacija
A06_ADR1	char(70)	Adresas1
A06_ADR2	char(70)	Adresas2
A06_ADR3	char(70)	Adresas3
A06_PAS_NR	char(20)	Paso Nr.
A06_SOD_NR	char(20)	Sodros Nr.
A06_APDR_NR	char(21)	Asmens kodas
A06_KODAS_IS	char(12)	Pagrindinis padalinys
A06_KODAS_SS	char(12)	Atlyginimo padėjimo sąskaita
A06_AVANSAS	numeric(12,2)	Avansas
A06_ZML_NUO	datetime	Dirba nuo (data)
A06_ZML_NUOP	datetime	Dirba nuo (mėnuo)
A06_ZML_IKI	datetime	Dirba iki (data)
A06_ZML_IKIP	datetime	Dirba iki (mėnuo)
A06_PASTABOS	varchar(max)	Pastabos
A06_USERIS	char(12)	Kas koregavo
A06_R_DATE	datetime	Kada koregavo
A06_GIM_DATA	datetime	Gimimo data
A06_STAZAS	numeric(9,2)	Darbo stažas
A06_SEIMA	numeric(1,0)	Šeimyninė padėtis: 1-Nevedęs/Neištekėjusi, 2-Vedęs/Ištekėjusi, 3-Išsiskiręs(usi),4-Našlys(ė)
A06_KODAS_OS_C	char(12)	Centras
A06_SERIJA	char(12)	Serija
A06_KODAS_SM	char(12)	Asmuo
A06_REZERVAS	char(40)	Rezervas
A06_SAVIVALD	char(12)	Savivaldybės kodas
A06_SAVIVALD_G	char(2)	Savivaldybės kodas pagal gyvenamają vietą
A06_KODAS_4A	char(12)	Personalo kodas
A06_KODAS_LS_5	char(12)	Logistikos kodas 5
A06_KODAS_LS_6	char(12)	Logistikos kodas 6
A06_KODAS_LS_7	char(12)	Logistikos kodas 7
A06_KODAS_LS_8	char(12)	Logistikos kodas 8
A06_SALIS	char(5)	Šalis
A06_APRASYMAS1	char(150)	Aprašymas 1
A06_APRASYMAS2	char(150)	Aprašymas 2
A06_APRASYMAS3	char(150)	Aprašymas 3
A06_APRASYMAS4	char(150)	Aprašymas 4
A06_APRASYMAS5	char(150)	Aprašymas 5
A06_APRASYMAS6	char(150)	Aprašymas 6