EDIT_A32_FULL

Aprašymas

Darbo grafiko operacijos sukūrimas (kartu su detaliomis eilutėmis).

Specifikacija

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

Body
  • method : EDIT_A32_FULL

  • params :

    • errorAction - klaidos parametras nurodantis koks veiksmas bus atliekamas įvykus klaidai papildomos informacijos formavimo metu, kai sukuriama darbo grafiko operacija (A32) ir gaunama klaida vykdant veiksmus su papildomos informacijos eilutėmis (A33). Parametras gali turėti tris reikšmes: EXIT, CONTINUE, ROLLBACK (default reikšmė). Reikšmė turi būti paduodama dydžiosiomis raidėmis!

    • user - vartotojo vardas (naudojamas dokumentų skaitliukams, parametrams ir kt.), veikia tik rakto prefix'ui įjungus parametrą RGI_USR_EDIT

  • data: perduodami duomenys:

    • A32 - Darbo grafiko operacijos informacija (A32)

    • A33 - Darbo grafiko operacijos detalių eilučių informacija (A33)

errorAction reikšmė turi būti paduodama didžiosiomis raidėmis!

errorAction reikšmių aprašymai:

Reikšmė Aprašymas
ROLLBACK (default reikšmė) Įvykus klaidai tolimesnės procedūros nebus vykdamos, bus ištrinamas dokumentas (A32) ir grąžinama klaida. Klaidos statusas 400
EXIT Įvykus klaidai tolimesnės procedūros nebus vykdamos, bus grąžinamas sukurtas dokumentas (A32) ir klaidų sąrašas. Klaidos statusas 207
CONTINUE Įvykus klaidai procedūros bus vykdamos iki pabaigos, o klaidos dedamos į sąrašą. Grąžinamas sukurtas dokumentas (A32) ir klaidų sąrašas pabaigoje. Klaidos statusas 207

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į. Papildomus laukus galima perduoti tiek prie paties dokumento (A32), tiek prie detalių eilučių (A33).

pvz application/xml:

<body>
    <method>EDIT_A32_FULL</method>
    <params>
        <errorAction>ROLLBACK</errorAction>
    </params>
    <data>
        <A32>
            <A32_KODAS_IS>999999999999</A32_KODAS_IS>
            <A32_DATE>20261001</A32_DATE>
            <A33>
                <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>
        </A32>
    </data>
</body>

pvz application/json:

{
    "method": "EDIT_A32_FULL",
    "params": {
        "errorAction": "ROLLBACK"
    },
    "data": {
        "A32": {
            "A32_KODAS_IS": "999999999999",
            "A32_DATE": "20261001",
            "A33": {
                "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>
    <A32>
        <A32_KODAS_DG>000R00000015</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>ABCDEFG     </A32_ADDUSR>
        <A32_ADD_DATE>2026-11-12T14:31:33</A32_ADD_DATE>
        <A32_USERIS>ABCDEFG     </A32_USERIS>
        <A32_R_DATE>2026-11-12T14:31:33</A32_R_DATE>
        <A33>
            <A33_KODAS_DG>000R00000015</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>ABCDEFG     </A33_ADDUSR>
            <A33_ADD_DATE>2026-11-12T14:31:33</A33_ADD_DATE>
            <A33_USERIS>ABCDEFG     </A33_USERIS>
            <A33_R_DATE>2026-11-12T14:31:33</A33_R_DATE>
        </A33>
    </A32>
</RET_DOK>
Response (status 207)

207 statusas gaunamas, kai procedūros yra vykdamos perduodant parametrą errorAction su reikšme EXIT arba CONTINUE ir gaunama klaida kažkurioje iš procedūrų, pvz.:

<RET_DOK>
    <A32>
        <A32_KODAS_DG>000R00000016</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>ABCDEFG     </A32_ADDUSR>
        <A32_ADD_DATE>2026-11-12T14:32:20</A32_ADD_DATE>
        <A32_USERIS>ABCDEFG     </A32_USERIS>
        <A32_R_DATE>2026-11-12T14:32:20</A32_R_DATE>
        <A33/>
            <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>000R00000016&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>

    <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>000R00000015&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>
Response (status 400)

Klaida paduodant duomenis / SQL sintaksės klaidos / kitos duomenų klaidos

<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id>19737353540.5a2064a6.1794486772457</id>
    <durationMs>54</durationMs>
    <errorMessage>Nepavyko įvykdyti metodo</errorMessage>
    <document/>
    <errors>
        <error>
            <data>&lt;A32>&lt;num_row>1&lt;/num_row>&lt;A32_KODAS_IS>999999999999&lt;/A32_KODAS_IS>&lt;A32_DATE>2026-10-01T00:00:00&lt;/A32_DATE>&lt;/A32></data>
            <dataErrors>
                <dataError>
                    <tag>A32_KODAS_IS</tag>
                    <code>552660</code>
                    <message>Darbo grafikas padalinyje [999999999999] šiam mėnesiui ir tipui jau egzistuoja</message>
                </dataError>
            </dataErrors>
        </error>
    </errors>
</RET_DOK>

PHP pvz

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'ApiKey: AAAAA.12345',
      'Content-Type: application/json',
      ]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
    "method": "EDIT_A32_FULL",
    "params": {
        "errorAction": "ROLLBACK"
    },
    "data": {
        "A32": {
            "A32_KODAS_IS": "999999999999",
            "A32_DATE": "20261001",
            "A33": {
                "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

A32

Nuoroda į lentelės aprašymą: A32

A33

Nuoroda į lentelės aprašymą: A33