EDIT_A33

Aprašymas

Darbo grafiko operacijos detalių eilučių koregavimas

Specifikacija

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

Body

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

Numatyta galimybė perduoti papildomų laukų informaciją, jei jie yra aprašyti Rivile GAMA programoje. Tam naudojamos žymos <PAP_1>, <PAP_2> ir t.t., kur skaičius nurodo konkretaus papildomo lauko numerį.

pvz application/xml:

<body>
    <method>EDIT_A33</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <A33>
            <A33_KODAS_DG>000R00000013</A33_KODAS_DG>
            <A33_KODAS_IS>999999999999</A33_KODAS_IS>
            <A33_KODAS_TB>002</A33_KODAS_TB>
            <A33_D01>  8.00  1.0008:00-12:0013:00-17:00</A33_D01>
            <A33_D02>  8.00  1.0008:00-12:0013:00-17:00</A33_D02>
        </A33>
    </data>
</body>

pvz application/json:

{
    "method": "EDIT_A33",
    "params": {
        "oper": "I"
    },
    "data": {
        "A33": {
            "A33_KODAS_DG": "000R00000013",
            "A33_KODAS_IS": "999999999999",
            "A33_KODAS_TB": "002",
            "A33_D01": "8.00  1.0008:00-12:0013:00-17:00",
            "A33_D02": "8.00  1.0008:00-12:0013:00-17:00"
        }
    }
}

Response (status 200 OK)

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

pvz:

<RET_DOK>
    <A33>
        <A33_KODAS_DG>000R00000013</A33_KODAS_DG>
        <A33_EIL_NR>1</A33_EIL_NR>
        <A33_KODAS_TB>002         </A33_KODAS_TB>
        <A33_KODAS_PE>           </A33_KODAS_PE>
        <A33_KODAS_OS>           </A33_KODAS_OS>
        <A33_KODAS_IS>999999999999</A33_KODAS_IS>
        <A33_V00>16.00</A33_V00>
        <A33_D01>  8.00  1.0008:00-12:0013:00-17:00</A33_D01>
        <A33_D02>  8.00  1.0008:00-12:0013:00-17:00</A33_D02>
        <A33_D03>                                 </A33_D03>
        <A33_D04>                                 </A33_D04>
        <A33_D05>                                 </A33_D05>
        <A33_D06>                                 </A33_D06>
        <A33_D07>                                 </A33_D07>
        <A33_D08>                                 </A33_D08>
        <A33_D09>                                 </A33_D09>
        <A33_D10>                                 </A33_D10>
        <A33_D11>                                 </A33_D11>
        <A33_D12>                                 </A33_D12>
        <A33_D13>                                 </A33_D13>
        <A33_D14>                                 </A33_D14>
        <A33_D15>                                 </A33_D15>
        <A33_D16>                                 </A33_D16>
        <A33_D17>                                 </A33_D17>
        <A33_D18>                                 </A33_D18>
        <A33_D19>                                 </A33_D19>
        <A33_D20>                                 </A33_D20>
        <A33_D21>                                 </A33_D21>
        <A33_D22>                                 </A33_D22>
        <A33_D23>                                 </A33_D23>
        <A33_D24>                                 </A33_D24>
        <A33_D25>                                 </A33_D25>
        <A33_D26>                                 </A33_D26>
        <A33_D27>                                 </A33_D27>
        <A33_D28>                                 </A33_D28>
        <A33_D29>                                 </A33_D29>
        <A33_D30>                                 </A33_D30>
        <A33_D31>                                 </A33_D31>
        <A33_PERKELTA>1</A33_PERKELTA>
        <A33_ADDUSR>ABCDEF     </A33_ADDUSR>
        <A33_ADD_DATE>2026-11-12T14:06:02</A33_ADD_DATE>
        <A33_USERIS>ABCDEF     </A33_USERIS>
        <A33_R_DATE>2026-11-12T14:06:02</A33_R_DATE>
    </A33>
</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>19737353540.2af3d5d4.1794485339532</id>
    <durationMs>71</durationMs>
    <errorMessage>Nepavyko įvykdyti metodo</errorMessage>
    <document/>
    <errors>
        <error>
            <data>&lt;A33>&lt;num_row>1&lt;/num_row>&lt;A33_D01>8.001.0008:00-12:0013:00-17:00&lt;/A33_D01>&lt;A33_KODAS_DG>000R00000013&lt;/A33_KODAS_DG>&lt;A33_KODAS_IS>999999999999&lt;/A33_KODAS_IS>&lt;A33_D02>8.001.0008:00-12:0013:00-17:00&lt;/A33_D02>&lt;/A33></data>
            <dataErrors>
                <dataError>
                    <tag>A33_KODAS_TB</tag>
                    <code>552147</code>
                    <message>Neįvestas tabelinis numeris</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_A33</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <A33>
            <A33_KODAS_DG>000R00000013</A33_KODAS_DG>
            <A33_EIL_NR>1</A33_EIL_NR>
            <A33_D01>  8.00  1.0009:00-12:0013:00-18:00</A33_D01>
        </A33>
    </data>
</body>

pvz išmetimas:

<body>
    <method>EDIT_A33</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <A33>
            <A33_KODAS_DG>000R00000013</A33_KODAS_DG>
            <A33_EIL_NR>1</A33_EIL_NR>
        </A33>
    </data>
</body>

PHP pvz

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'ApiKey: abcdef.12345678910',
      'Content-Type: application/json',
      ]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
        "method": "EDIT_A33",
        "params": {
            "oper": "I"
        },
        "data": {
            "A33": {
                "A33_KODAS_DG": "000R00000013",
                "A33_KODAS_IS": "999999999999",
                "A33_KODAS_TB": "002",
                "A33_D01": "8.00  1.0008:00-12:0013:00-17:00",
                "A33_D02": "8.00  1.0008:00-12:0013:00-17:00"
            }
        }
    }
');

$response = curl_exec($ch);
curl_close($ch);

Lentelės

A33

Darbo grafiko operacijos detalios eilutės informacija

Laukas	Tipas	Aprašymas	Pastabos
A33_KODAS_DG	char(12)	Operacijos Nr.	Privaloma visuose operacijos tipuose
A33_EIL_NR	numeric(6,0)	Eilutės Nr.	Privaloma, kai atliekama koregavimo arba pašalinimo operacija (oper = 'U', 'D')
A33_KODAS_TB	char(12)	Tabelinis Nr.	Privaloma, kai atliekama koregavimo arba pašalinimo operacija (oper = 'I')
A33_KODAS_PE	char(12)	Pamaina
A33_KODAS_OS	char(12)	Objektas/Rinkinio ID
A33_KODAS_IS	char(12)	Padalinys(etatas)	Privaloma, kai atliekama koregavimo arba pašalinimo operacija (oper = 'I')
A33_V00	numeric(6,2)	Darbo laikas
A33_D01	char(34)	01 diena	Tinkamos įvesties formatas ir pavyzdys: '<faktinė darbo trukmė> <pietų pertraukos trukmė><dienos pradžia hh:mm>-<pietų pradžia hh:mm><pietų pabaiga hh:mm>-' Pvz.: ' 8.00 1.0008:00-12:0013:00-17:00'
A33_D02	char(34)	02 diena
A33_D03	char(34)	03 diena
A33_D04	char(34)	04 diena
A33_D05	char(34)	05 diena
A33_D06	char(34)	06 diena
A33_D07	char(34)	07 diena
A33_D08	char(34)	08 diena
A33_D09	char(34)	09 diena
A33_D10	char(34)	10 diena
A33_D11	char(34)	11 diena
A33_D12	char(34)	12 diena
A33_D13	char(34)	13 diena
A33_D14	char(34)	14 diena
A33_D15	char(34)	15 diena
A33_D16	char(34)	16 diena
A33_D17	char(34)	17 diena
A33_D18	char(34)	18 diena
A33_D19	char(34)	19 diena
A33_D20	char(34)	20 diena
A33_D21	char(34)	21 diena
A33_D22	char(34)	22 diena
A33_D23	char(34)	23 diena
A33_D24	char(34)	24 diena
A33_D25	char(34)	25 diena
A33_D26	char(34)	26 diena
A33_D27	char(34)	27 diena
A33_D28	char(34)	28 diena
A33_D29	char(34)	29 diena
A33_D30	char(34)	30 diena
A33_D31	char(34)	31 diena
A33_D01P	char(34)	01 diena2
A33_D02P	char(34)	02 diena2
A33_D03P	char(34)	03 diena2
A33_D04P	char(34)	04 diena2
A33_D05P	char(34)	05 diena2
A33_D06P	char(34)	06 diena2
A33_D07P	char(34)	07 diena2
A33_D08P	char(34)	08 diena2
A33_D09P	char(34)	09 diena2
A33_D10P	char(34)	10 diena2
A33_D11P	char(34)	11 diena2
A33_D12P	char(34)	12 diena2
A33_D13P	char(34)	13 diena2
A33_D14P	char(34)	14 diena2
A33_D15P	char(34)	15 diena2
A33_D16P	char(34)	16 diena2
A33_D17P	char(34)	17 diena2
A33_D18P	char(34)	18 diena2
A33_D19P	char(34)	19 diena2
A33_D20P	char(34)	20 diena2
A33_D21P	char(34)	21 diena2
A33_D22P	char(34)	22 diena2
A33_D23P	char(34)	23 diena2
A33_D24P	char(34)	24 diena2
A33_D25P	char(34)	25 diena2
A33_D26P	char(34)	26 diena2
A33_D27P	char(34)	27 diena2
A33_D28P	char(34)	28 diena2
A33_D29P	char(34)	29 diena2
A33_D30P	char(34)	30 diena2
A33_D31P	char(34)	31 diena2
A33_PERKELTA	numeric(1,0)	Perkelta
A33_ADDUSR	char(12)	Kas sukūrė
A33_ADD_DATE	datetime	Kada sukūrė
A33_USERIS	char(12)	Kas koregavo
A33_R_DATE	datetime	Kada koregavo