EDIT_A11

Aprašymas

Darbuotojų priskaitymų/atskaitymų koregavimas.

Specifikacija

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

Body

method : EDIT_A11
params :
- oper :
- I - naujo įrašo sukūrimas (numatytasis)
- U - dokumento koregavimas
- D - dokumento ištrynimas
data: perduodami duomenys:
- A11 - Personalo operacijų antraštė (a11)

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_A06_FIL. Šiame parametre įvedamas papildomas filtravimas, galimų reikšmių pavyzdžiai: 1=1 (visos darbuotojų kortelės), A11_KODAS_TB='004' (tik darbuotojų kortelės su tabeliniu kodu '004'). Filtravimo sąlygose galima naudoti visus lentelės A11 laukus.

XML Request pvz.:

xml

<body>
    <method>EDIT_A11</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <A11>
            <A11_KODAS_LP>100</A11_KODAS_LP>
            <A11_KODAS_TB>004</A11_KODAS_TB>
            <A11_KODAS_IS>999999999999</A11_KODAS_IS>
        </A11>
    </data>
</body>

JSON Request pvz.:

json

{
    "method": "EDIT_A11",
    "params": {
        "oper": "I"
    },
    "data": {
        "A11": {
            "A11_KODAS_LP": "100",
            "A11_KODAS_TB": "004",
            "A11_KODAS_IS": "999999999999"
        }
    }
}

Response (status 200 OK)

XML response pvz.:

xml

<RET_DOK>
    <A11>
        <A11_KODAS_LP>000000000100</A11_KODAS_LP>
        <A11_TIPAS>1</A11_TIPAS>
        <A11_KODAS_TB>004 </A11_KODAS_TB>
        <A11_KODAS_IS>999999999999</A11_KODAS_IS>
        <A11_EIL_NR>14</A11_EIL_NR>
        <A11_PAV> Etatinis atlyginimas var pav</A11_PAV>
        <A11_ATS_IP>0</A11_ATS_IP>
        <A11_IP_DOK> </A11_IP_DOK>
        <A11_IP_SUMA>0.00</A11_IP_SUMA>
        <A11_POZ_DATE>0</A11_POZ_DATE>
        <A11_BEG_DATE>2025-02-13T00:00:00</A11_BEG_DATE>
        <A11_END_DATE>2025-02-13T00:00:00</A11_END_DATE>
        <A11_USERIS> ******* </A11_USERIS>
        <A11_R_DATE>2025-02-13T00:00:00</A11_R_DATE>
        <A11_KODAS_SS> </A11_KODAS_SS>
        <A11_KODAS_KS> </A11_KODAS_KS>
    </A11>
</RET_DOK>

JSON response pvz.:

json

{
    "A11": {
        "A11_KODAS_LP": "000000000100",
        "A11_TIPAS": "1",
        "A11_KODAS_TB": "004",
        "A11_KODAS_IS": "999999999999",
        "A11_EIL_NR": "14",
        "A11_PAV": "Etatinis atlyginimas var pav",
        "A11_ATS_IP": "0",
        "A11_IP_DOK": "",
        "A11_IP_SUMA": "0.00",
        "A11_POZ_DATE": "0",
        "A11_BEG_DATE": "2025-02-13T00:00:00",
        "A11_END_DATE": "2025-02-13T00:00:00",
        "A11_USERIS": " *******",
        "A11_R_DATE": "2025-02-13T00:00:00",
        "A11_KODAS_SS": "",
        "A11_KODAS_KS": ""
    }
}

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.40a6e682.1739444053694</id>
    <durationMs>33</durationMs>
    <errorMessage>Nepavyko įvykdyti metodo</errorMessage>
    <document/>
    <errors>
        <error>
            <data>&lt;A11>&lt;num_row>1&lt;/num_row>&lt;A11_KODAS_LP>1007&lt;/A11_KODAS_LP>&lt;A11_KODAS_TB>004&lt;/A11_KODAS_TB>&lt;A11_KODAS_IS>999999999999&lt;/A11_KODAS_IS>&lt;/A11></data>
            <dataErrors>
                <dataError>
                    <tag>A11_KODAS_LP</tag>
                    <code>552216</code>
                    <message>Nerastas priskaitymas [000000001007]</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>EDIT_A11</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <A11>
            <A11_KODAS_LP>100</A11_KODAS_LP>
            <A11_TIPAS>1</A11_TIPAS>
            <A11_KODAS_TB>004</A11_KODAS_TB>
            <A11_EIL_NR>14</A11_EIL_NR>
            <A11_KODAS_IS>9999999999999</A11_KODAS_IS>
            <A11_PAV>update</A11_PAV>
        </A11>
    </data>
</body>

Pvz. trynimas:

xml

<body>
    <method>EDIT_A11</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <A11>
            <A11_KODAS_LP>100</A11_KODAS_LP>
            <A11_TIPAS>1</A11_TIPAS>
            <A11_KODAS_TB>004</A11_KODAS_TB>
            <A11_EIL_NR>14</A11_EIL_NR>
            <A11_KODAS_IS>9999999999999</A11_KODAS_IS>
        </A11>
    </data>
</body>

PHP pavyzdys:

php

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'ApiKey: *******.************',
      'Content-Type: application/json',
      ]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
    "method": "EDIT_A11",
    "params": {
        "oper": "I"
    },
    "data": {
        "A11": {
            "A11_KODAS_LP": "100",
            "A11_KODAS_TB": "004",
            "A11_KODAS_IS": "999999999999"
        }
    }
}');
$response = curl_exec($ch);
curl_close($ch);

Lentelės

A11

Darbuotojų priskaitymų/atskaitymų koregavimo informacija

Kodas	Tipas	Aprašymas
A11_KODAS_LP	char(12)	Priskaitymas/Atskaitymas
A11_TIPAS	numeric(1,0)	Tipas: 1-priskaitymas,2-atskaitymas
A11_KODAS_TB	char(12)	Tabelinis Nr.
A11_KODAS_IS	char(12)	Padalinys
A11_EIL_NR	numeric(6,0)	Eilutės numeris(unikalumui)
A11_PAV	char(60)	Aprašymas
A11_ATS_IP	numeric(1,0)	Ypatingas atskaitymas
A11_IP_DOK	char(20)	Ypatingo atskaitymo Dok.Nr.
A11_IP_SUMA	numeric(12,2)	Ypatingo atskaitymo visa suma
A11_POZ_DATE	numeric(1,0)	Terminuota
A11_BEG_DATE	datetime	Pradžios data
A11_END_DATE	datetime	Pabaigos data
A11_USERIS	char(12)	Kas koregavo
A11_R_DATE	datetime	Kada koregavo
A11_KODAS_SS	char(12)	Sąskaitos kodas
A11_KODAS_KS	char(12)	Kliento kodas