EDIT_A07

Aprašymas

Darbuotojo padalinių koregavimas.

Specifikacija

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

Body

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

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_A07</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <A07>
            <A07_KODAS_TB>TST01       </A07_KODAS_TB>
            <A07_KODAS_IS>999999999999</A07_KODAS_IS>
            <A07_PAREIGOS>Darbuotojas</A07_PAREIGOS>
            <A07_KODAS_LA>S_SISTEMINIS</A07_KODAS_LA>
            <A07_KODAS_DS>AL001</A07_KODAS_DS>
            <A07_TIPAS></A07_TIPAS>
            <A07_KVAL></A07_KVAL>
            <A07_TB_FOR></A07_TB_FOR>
            <A07_V_KAL></A07_V_KAL>
            <A07_PASTABOS></A07_PASTABOS>
            <A07_KODAS_LE></A07_KODAS_LE>
            <a07_sk_virsv>0</a07_sk_virsv>
        </A07>
    </data>
</body>

pvz application/json:

{
    "method": "EDIT_A07",
    "params": {
        "oper": "I"
    },
    "data": {
        "A07": {
            "A07_KODAS_TB": "TST01",
            "A07_KODAS_IS": "999999999999",
            "A07_PAREIGOS": "Darbuotojas",
            "A07_KODAS_LA": "S_SISTEMINIS",
            "A07_KODAS_DS": "AL001",
            "A07_TIPAS": "",
            "A07_KVAL": "",
            "A07_TB_FOR": "",
            "A07_V_KAL": "",
            "A07_PASTABOS": "",
            "A07_KODAS_LE": "",
            "a07_sk_virsv": "0"
        }
    }
}

Response (status 200 OK)

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

pvz:

<RET_DOK>
    <A07>
        <A07_KODAS_TB>TST01       </A07_KODAS_TB>
        <A07_KODAS_IS>999999999999</A07_KODAS_IS>
        <A07_PAREIGOS>Darbuotojas                                                 </A07_PAREIGOS>
        <A07_KODAS_LA>S_SISTEMINIS</A07_KODAS_LA>
        <A07_KODAS_DS>AL001       </A07_KODAS_DS>
        <A07_TIPAS>1</A07_TIPAS>
        <A07_KVAL>1</A07_KVAL>
        <A07_TB_FOR>0</A07_TB_FOR>
        <A07_V_KAL>1</A07_V_KAL>
        <A07_PASTABOS> </A07_PASTABOS>
        <A07_USERIS>AAAAAAA     </A07_USERIS>
        <A07_R_DATE>2024-10-29T08:59:11</A07_R_DATE>
        <A07_KODAS_LE>555         </A07_KODAS_LE>
        <a07_sk_virsv>0</a07_sk_virsv>
    </A07>
</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;A07>&lt;/A07></data>
            <dataErrors>
                <dataError>
                    <tag>A07_KODAS_IS</tag>
                    <code>552159</code>
                    <message>Toks darbuotojo padalinys jau yra</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:

<body>
    <method>EDIT_A07</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
            <A07>
                <A07_KODAS_TB>TST01</A07_KODAS_TB>
                <A07_KODAS_IS>999999999999</A07_KODAS_IS>
                <A07_PASTABOS>Koreguota informacija</A07_PASTABOS>
            </A07>
    </data>
</body>

pvz išmetimas:

<body>
    <method>EDIT_A07</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <A07>
            <A07_KODAS_TB>TST01</A07_KODAS_TB>
            <A07_KODAS_IS>999999999999</A07_KODAS_IS>
        </A07>
    </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_A07",
        "params": {
            "oper": "I"
        },
        "data": {
            "A07": {
                "A07_KODAS_TB": "TST01",
                "A07_KODAS_IS": "999999999999",
                "A07_PAREIGOS": "Darbuotojas",
                "A07_KODAS_LA": "S_SISTEMINIS",
                "A07_KODAS_DS": "AL001"
            }
    }
    }');
$response = curl_exec($ch);
curl_close($ch);

Lentelės

A07

Darbuotojo padalinių informacija

Laukas	Tipas	Aprašymas	Pastaba
A07_KODAS_TB	char(12)	Tabelinis Nr.	Lauką būtina nurodyti visų tipų operacijose, išskyrus EDIT_A06_FULL metodo užklausoje - jis užsipildo automatiškai.
A07_KODAS_IS	char(12)	Padalinys	Lauką būtina nurodyti visais atvejais
A07_KODAS_LA	char(12)	Kalendorius	Lauką būtina nurodyti kūrimo operacijose: EDIT_A07 - kai oper reikšmė lygi "I" EDIT_A06_FULL - visada
A07_KODAS_DS	char(12)	Sąskaitų ryšys.	Lauką būtina nurodyti kūrimo operacijose: EDIT_A07 - kai oper reikšmė lygi "I" EDIT_A06_FULL - visada
A07_KODAS_LE	char(12)	Pareigos	Lauką būtina nurodyti kūrimo operacijose: EDIT_A07 - kai oper reikšmė lygi "I" EDIT_A06_FULL - visada
A07_PAREIGOS	char(60)	Pareigų pavadinimas
A07_TIPAS	numeric(1,0)	Tipas: 1-tarnautojas; 2-darbuotojas.
A07_KVAL	numeric(1,0)	Kvalifikacijos grupė
A07_TB_FOR	numeric(1,0)	Tabelio formavimas: 0-formuoti,1-ne
A07_V_KAL	numeric(1,0)	Įtraukti į kalendoriaus laiko vidurkį:1-taip 0-ne
A07_PASTABOS	varchar(max)	Pastabos
A07_USERIS	char(12)	Kas koregavo
A07_R_DATE	datetime	Kada koregavo
A07_APRASYMAS1	char(150)	Aprašymas 1
A07_APRASYMAS2	char(150)	Aprašymas 2
A07_APRASYMAS3	char(150)	Aprašymas 3
A07_APRASYMAS4	char(150)	Aprašymas 4
A07_SK_VIRSV	numeric(1,0)	Skaičiuoti viršvalandžius: 0-ne; 1-taip