EDIT_I09_KOP

Aprašymas

Vidinių dokumentų kopijavimas ir keitimas.

Specifikacija

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

Body
  • method : EDIT_I09_KOP
  • data: perduodami duomenys:
    • I09 - Vidinės operacijos antraštė (i09)

Kopijuojant ar keičiant dokumentą yra privalomi laukai: P_OPER, OLD_I09_KODAS_VD, NEW_I09_TIPAS ir NEW_I09_DOK_NR.

Tagas Aprašymas
P_OPER 1 - kopijuoti, 2 - keisti. Privalomas
OLD_I09_KODAS_VD Operacijos numeris iš kurio bus daroma kopija arba koregavimas. Privalomas
NEW_I09_TIPAS Operacijos tipas kaip ir I09_TIPAS i09. Privalomas
NEW_I09_DOK_NR Dokumento numeris. Privalomas
NEW_I09_IS_DATA Nauja siuntimo data kaip ir I09_IS_DATA i09
NEW_I09_GAV_DATA Nauja gavimo data kaip ir I09_GAV_DATA i09
NEW_I09_KODAS_IS1 Padalinys gavėjas kaip ir I09_KODAS_IS1 i09
NEW_I09_KODAS_IS2 Padalinys siuntėjas kaip ir I09_KODAS_IS2 i09
NEW_I10_KODAS_OS1 Nurodomas visų detalių eilučių objektas kaip ir I10_KODAS_OS1 i10
NEW_I10_KODAS_OS2 Nurodomas visų detalių eilučių objektas kaip ir I10_KODAS_OS2 i10
NEW_I10_SERIJA1 Nurodoma visų detalių eilučių serija kaip ir I10_SERIJA1 i10
NEW_I10_SERIJA2 Nurodoma visų detalių eilučių serija kaip ir I10_SERIJA2 i10
errorAction Klaidos parametras nurodantis koks veiksmas bus atliekamas įvykus klaidai dokumento kopijavimo / keitimo metu, kai yra sukuriama operacija (I09) ir gaunama klaida kopijuojant / keičiant detalias eilutes (I10). Parametras gali turėti tris reikšmes: EXIT, ROLLBACK, CONTINUE (reikšmė pagal nutylėjimą). Reikšmė turi būti paduodama dydžiosiomis raidėmis!

Jei Rvilės programoje dokumentas yra perkeltas tai jo keisti negalima.

Kai nurodoma bent viena NEW_I10 tago reikšmė, tuomet yra pakeičiami visų detalių eilučių laukai atitinkantys tuos tagus.

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

errorAction reikšmių aprašymai:

Reikšmė Aprašymas
ROLLBACK Įvykus klaidai tolimesnės procedūros nebus vykdamos, bus ištrinamas dokumentas (I09) ir grąžinama klaida.
EXIT Įvykus klaidai tolimesnės procedūros nebus vykdamos, bus grąžinamas sukurtas dokumentas (I09) ir klaidų sąrašas.
CONTINUE (default reikšmė) Įvykus klaidai procedūros bus vykdamos iki pabaigos, o klaidos dedamos į sąrašą. Grąžinamas sukurtas dokumentas (I09) ir klaidų sąrašas pabaigoje.
XML request (kopijavimas)
<body>
    <method>EDIT_I09_KOP</method>
    <data>
        <I09>
            <P_OPER>1</P_OPER><!-- 1 - kopijuoti, 2 - keisti -->
            <OLD_I09_KODAS_VD>010R00000053</OLD_I09_KODAS_VD>
            <NEW_I09_TIPAS>1</NEW_I09_TIPAS>
            <NEW_I09_DOK_NR>D20260713-6</NEW_I09_DOK_NR>
            <NEW_I09_IS_DATA>2026-07-13</NEW_I09_IS_DATA>
            <NEW_I09_GAV_DATA>2026-07-13</NEW_I09_GAV_DATA>
            <NEW_I09_KODAS_IS1>02</NEW_I09_KODAS_IS1>
            <NEW_I09_KODAS_IS2>01</NEW_I09_KODAS_IS2>
            <NEW_I10_KODAS_OS1>OBJ01</NEW_I10_KODAS_OS1>
            <NEW_I10_KODAS_OS2>OBJ02</NEW_I10_KODAS_OS2>
            <NEW_I10_SERIJA1>ABC123</NEW_I10_SERIJA1>
            <NEW_I10_SERIJA2>ABC124</NEW_I10_SERIJA2>
            <errorAction>CONTINUE</errorAction>
        </I09>    
    </data>
</body>
JSON request
{
    "method": "EDIT_I09_KOP",
    "data": {
        "I09": {
            "P_OPER": "1",
            "OLD_I09_KODAS_VD": "010R00000053",
            "NEW_I09_TIPAS": "1",
            "NEW_I09_DOK_NR": "D20260713-6",
            "NEW_I09_IS_DATA": "2026-07-13",
            "NEW_I09_GAV_DATA": "2026-07-13",
            "NEW_I09_KODAS_IS1": "02",
            "NEW_I09_KODAS_IS2": "01",
            "NEW_I10_KODAS_OS1": "OBJ01",
            "NEW_I10_KODAS_OS2": "OBJ02",
            "NEW_I10_SERIJA1": "ABC123",
            "NEW_I10_SERIJA2": "ABC124",
            "errorAction": "CONTINUE"
        }
    }
}
Response (status 200 OK)
XML response
<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
    <I09>
        <I09_KODAS_VD>010R00000061</I09_KODAS_VD>
        <I09_TIPAS>1</I09_TIPAS>
        <I09_DOK_NR>D20260713-6</I09_DOK_NR>
        <I09_IS_DATA>2026-07-13T00:00:00</I09_IS_DATA>
        <I09_GAV_POZ>0</I09_GAV_POZ>
        <I09_GAV_DATA>2026-07-13T00:00:00</I09_GAV_DATA>
        <I09_KODAS_IS1>02</I09_KODAS_IS1>
        <I09_KODAS_SS_T></I09_KODAS_SS_T>
        <I09_NUTOL1>0</I09_NUTOL1>
        <I09_EIL1>Centrinis padalinys</I09_EIL1>
        <I09_EIL2></I09_EIL2>
        <I09_EIL3></I09_EIL3>
        <I09_KODAS_IS2>01</I09_KODAS_IS2>
        <I09_NUTOL2>0</I09_NUTOL2>
        <I09_A_EIL1>Sandėlis</I09_A_EIL1>
        <I09_A_EIL2></I09_A_EIL2>
        <I09_A_EIL3></I09_A_EIL3>
        <I09_PERKELTA1>1</I09_PERKELTA1>
        <I09_PERKELTA2>1</I09_PERKELTA2>
        ...
    </I09>
</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>21313695680.1594f9da.1587494227502</id>
    <durationMs>11</durationMs>
    <errorMessage>nepavyko įvykdyti metodo</errorMessage>
    <errors>
        <error>
            <data>&lt;I09>&lt;OLD_I09_KODAS_VD>010R0000005&lt;/OLD_I09_KODAS_VD>&lt;NEW_I09_TIPAS>1&lt;/NEW_I09_TIPAS>&lt;NEW_I09_DOK_NR>D20260713-6&lt;/NEW_I09_DOK_NR>&lt;NEW_I09_KODAS_IS1>02&lt;/NEW_I09_KODAS_IS1>&lt;USERIS>M&lt;/USERIS>&lt;P_OPER>1&lt;/P_OPER>&lt;/I09></data>
            <dataErrors>
                <dataError>
                    <tag>OLD_I09_KODAS_VD</tag>
                    <code>21001</code>
                    <message>Toks operacijos kodas nerastas</message>
                </dataError>
                <dataError>
                    <tag>I09_KODAS_IS1</tag>
                    <code>34001</code>
                    <message>Nėra tokio padalinio</message>
                </dataError>
            </dataErrors>
        </error>
    </errors>
</RET_DOK>