EDIT_A32

Aprašymas

Darbo grafiko operacijos koregavimas.

Specifikacija

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

Body

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

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_A32</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <A32>
            <A32_KODAS_IS>999999999999</A32_KODAS_IS>
            <A32_DATE>20261001</A32_DATE>
        </A32>
    </data>
</body>

pvz application/json:

{
    "method": "EDIT_A32",
    "params": {
        "oper": "I"
    },
    "data": {
        "A32": {
            "A32_KODAS_IS": "999999999999",
            "A32_DATE": "20261001"
        }
    }
}

Response (status 200 OK)

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

pvz:

<RET_DOK>
    <A32>
        <A32_KODAS_DG>000R00000012</A32_KODAS_DG>
        <A32_KODAS_IS>999999999999</A32_KODAS_IS>
        <A32_DATE>2026-10-01T00:00:00</A32_DATE>
        <A32_TIPAS>1</A32_TIPAS>
        <A32_PAV>UAB "Rivilė"</A32_PAV>
        <A32_KODAS_LS_1>           </A32_KODAS_LS_1>
        <A32_KODAS_LS_2>           </A32_KODAS_LS_2>
        <A32_KODAS_LS_3>           </A32_KODAS_LS_3>
        <A32_KODAS_LS_4>           </A32_KODAS_LS_4>
        <A32_PERKELTA>1</A32_PERKELTA>
        <A32_BUSENA>1</A32_BUSENA>
        <A32_PASTABOS></A32_PASTABOS>
        <A32_ADDUSR>ABCDEF     </A32_ADDUSR>
        <A32_ADD_DATE>2026-11-12T13:51:34</A32_ADD_DATE>
        <A32_USERIS>ABCDEF     </A32_USERIS>
        <A32_R_DATE>2026-11-12T13:51:34</A32_R_DATE>
    </A32>
</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>4959678410.e1f1d7a8.1782736885677</id>
    <durationMs>43</durationMs>
    <errorMessage>Nepavyko įvykdyti metodo</errorMessage>
    <document/>
    <errors>
        <error>
            <data>&lt;A32>&lt;num_row>1&lt;/num_row>&lt;A32_OP_DATE>2026-06-2500:00:00.000&lt;/A32_OP_DATE>&lt;A32_TIPAS>0&lt;/A32_TIPAS>&lt;A32_PASTABOS>p7&lt;/A32_PASTABOS>&lt;/A32></data>
            <dataErrors>
                <dataError>
                    <tag>A32_TIPAS</tag>
                    <code>408006</code>
                    <message>Netinkamas tipas</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_A32</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <A32>
            <A32_KODAS_DG>000R00000012</A32_KODAS_DG>
            <A32_PASTABOS>api update</A32_PASTABOS>
        </A32>
    </data>
</body>

pvz išmetimas:

<body>
    <method>EDIT_A32</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <A32>
            <A32_KODAS_DG>000R00000012</A32_KODAS_DG>
        </A32>
    </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_A32",
    "params": {
        "oper": "I"
    },
    "data": {
        "A32": {
            "A32_KODAS_IS": "999999999999",
            "A32_DATE": "20261001"
        }
    }
    }');
$response = curl_exec($ch);
curl_close($ch);

Lentelės

A32

Darbo grafiko operacijos informacija

Laukas	Tipas	Aprašymas
A32_KODAS_DG	char(12)	Operacijos Nr.
A32_KODAS_IS	char(12)	Padalinys
A32_DATE	datetime	Data
A32_TIPAS	numeric(1,0)	Tipas: 1-planas;2-faktas
A32_PAV	char(150)	Pavadinimas
A32_KODAS_LS_1	char(12)	Logistika 1
A32_KODAS_LS_2	char(12)	Logistika 2
A32_KODAS_LS_3	char(12)	Logistika 3
A32_KODAS_LS_4	char(12)	Logistika 4
A32_APRASYMAS1	char(150)	Aprašymas 1
A32_APRASYMAS2	char(150)	Aprašymas 2
A32_APRASYMAS3	char(150)	Aprašymas 3
A32_APRASYMAS4	char(150)	Aprašymas 4
A32_PERKELTA	numeric(1,0)	Perkelta
A32_BUSENA	numeric(3,0)	Būsena
A32_PASTABOS	varchar(max)	Pastabos
A32_ADDUSR	char(12)	Kas sukūrė
A32_ADD_DATE	datetime	Kada sukūrė
A32_USERIS	char(12)	Kas koregavo
A32_R_DATE	datetime	Kada koregavo