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.

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