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)

xml

<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

json

{
    "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

<?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

<?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>