Back to Gidas

EDIT_A06

internetiniai-underscore-moduliai-api-underscore-rest-edit-underscore-a06.md

latest11.7 KB
Original Source

PDF

Pradžia Internetiniai moduliai Rivile API v2 (REST web servisai) EDIT_A06

EDIT_A06

Aprašymas

Darbuotojo koregavimas.

Specifikacija

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

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)

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:

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:

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 :

xml
<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
<?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>
Koregavimas ir išmetimas

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

Koreguojant informaciją bus koreguojami tik perduodami laukai.

pvz koregavimas :

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

xml
<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
<?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

LaukasTipasAprašymasPastaba
A06_KODAS_TBchar(12)Tabelinis Nr.Lauką būtina užpildyti visų tipų operacijose
A06_VARDASchar(100)Vardas
A06_PAVchar(100)Pavarde
A06_LYTISnumeric(1,0)Lytis: 1-vyras; 2-moteris.
A06_KODAS_VSchar(12)Vietovė
A06_KODAS_MSchar(12)Menedžeris
A06_KODAS_GSchar(12)Grupė
A06_KODAS_LS_1char(12)Logistikos kodas 1
A06_KODAS_LS_2char(12)Logistikos kodas 2
A06_KODAS_LS_3char(12)Logistikos kodas 3
A06_KODAS_LS_4char(12)Logistikos kodas 4
A06_IM_IDchar(2)Įmonės indentifikacija
A06_ADR1char(70)Adresas1
A06_ADR2char(70)Adresas2
A06_ADR3char(70)Adresas3
A06_PAS_NRchar(20)Paso Nr.
A06_SOD_NRchar(20)Sodros Nr.
A06_APDR_NRchar(21)Asmens kodas
A06_KODAS_ISchar(12)Pagrindinis padalinysLauką būtina užpildyti kūrimo operacijoje (oper = I)
A06_KODAS_SSchar(12)Atlyginimo padėjimo sąskaita
A06_AVANSASnumeric(12,2)Avansas
A06_ZML_NUOdatetimeDirba nuo (data)
A06_ZML_NUOPdatetimeDirba nuo (mėnuo)
A06_ZML_IKIdatetimeDirba iki (data)
A06_ZML_IKIPdatetimeDirba iki (mėnuo)
A06_PASTABOSvarchar(max)Pastabos
A06_USERISchar(12)Kas koregavo
A06_R_DATEdatetimeKada koregavo
A06_GIM_DATAdatetimeGimimo data
A06_STAZASnumeric(9,2)Darbo stažas
A06_SEIMAnumeric(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_Cchar(12)Centras
A06_SERIJAchar(12)Serija
A06_KODAS_SMchar(12)Asmuo
A06_REZERVASchar(40)Rezervas
A06_SAVIVALDchar(12)Savivaldybės kodas
A06_SAVIVALD_Gchar(2)Savivaldybės kodas pagal gyvenamają vietą
A06_KODAS_4Achar(12)Personalo kodas
A06_KODAS_LS_5char(12)Logistikos kodas 5
A06_KODAS_LS_6char(12)Logistikos kodas 6
A06_KODAS_LS_7char(12)Logistikos kodas 7
A06_KODAS_LS_8char(12)Logistikos kodas 8
A06_SALISchar(5)Šalis
A06_APRASYMAS1char(150)Aprašymas 1
A06_APRASYMAS2char(150)Aprašymas 2
A06_APRASYMAS3char(150)Aprašymas 3
A06_APRASYMAS4char(150)Aprašymas 4
A06_APRASYMAS5char(150)Aprašymas 5
A06_APRASYMAS6char(150)Aprašymas 6