EDIT_I15_KOP

Aprašymas

Gamybos dokumentų kopijavimas ir keitimas.

Specifikacija

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

Body

method : EDIT_I15_KOP
data: perduodami duomenys:
- I15 - Gamybos operacijos antraštė (i15)

Kopijuojant ar keičiant dokumentą yra privalomi laukai: P_OPER, OLD_I15_KODAS_KA ir NEW_I15_DOK_NR.

Tagas	Aprašymas
P_OPER	1 - kopijuoti, 2 - keisti. Privalomas
OLD_I15_KODAS_KA	Operacijos numeris iš kurio bus daroma kopija arba koregavimas. Privalomas
NEW_I15_TIPAS	Operacijos tipas kaip ir I15_TIPAS i15. Nenurodžius paliekamas originalo tipas
NEW_I15_DOK_NR	Dokumento numeris. Privalomas
NEW_I15_OP_DATA	Nauja operacijos data kaip ir I15_OP_DATA i15
NEW_I15_UZS_DATA	Nauja užsakymo data kaip ir I15_UZS_DATA i15
NEW_I15_KODAS_IS	Antraštės padalinys kaip ir I15_KODAS_IS i15
NEW_I15_KODAS_OS	Antraštės objektas kaip ir I15_KODAS_OS i15
NEW_I15_SERIJA	Antraštės serija kaip ir I15_SERIJA i15
NEW_I15_KODAS_OS_C	Antraštės centras kaip ir I15_KODAS_OS_C i15
NEW_I16_KODAS_OS	Nurodomas visų detalių eilučių objektas kaip ir I16_KODAS_OS i16
NEW_I16_SERIJA	Nurodoma visų detalių eilučių serija kaip ir I16_SERIJA i16
errorAction	Klaidos parametras nurodantis koks veiksmas bus atliekamas įvykus klaidai dokumento kopijavimo / keitimo metu, kai yra sukuriama operacija (I15) ir gaunama klaida kopijuojant / keičiant detalias eilutes (I16). 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!

Operacijos tipą keisti galima tik grupės viduje: tarp 1 (surinkimas) ir 2 (surinkimo užsakymas) arba tarp 3 (išbarstymas) ir 4 (išbarstymo užsakymas). Surinkimo operacijos pakeisti į išbarstymo negalima.

Jei Rvilės programoje surinkimo (1) arba išbarstymo (3) dokumentas yra perkeltas tai jo keisti negalima. Užsakymus (2 ir 4) keisti galima.

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

Kai keitime dalyvauja išbarstymo (3) tipo operacija, keitimas vykdomas neatsižvelgiant į errorAction reikšmę, t.y. įvykus bet kokiai klaidai visi pakeitimai atstatomi (senoji operacija lieka nepakeista).

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 (I15) ir grąžinama klaida.
EXIT	Įvykus klaidai tolimesnės procedūros nebus vykdamos, bus grąžinamas sukurtas dokumentas (I15) 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 (I15) ir klaidų sąrašas pabaigoje.

XML request (kopijavimas)

xml

<body>
    <method>EDIT_I15_KOP</method>
    <data>
        <I15>
            <P_OPER>1</P_OPER><!-- 1 - kopijuoti, 2 - keisti -->
            <OLD_I15_KODAS_KA>010R00000021</OLD_I15_KODAS_KA>
            <NEW_I15_TIPAS>1</NEW_I15_TIPAS>
            <NEW_I15_DOK_NR>D20260713-6</NEW_I15_DOK_NR>
            <NEW_I15_OP_DATA>2026-07-13</NEW_I15_OP_DATA>
            <NEW_I15_UZS_DATA>2026-07-13</NEW_I15_UZS_DATA>
            <NEW_I15_KODAS_IS>02</NEW_I15_KODAS_IS>
            <NEW_I15_KODAS_OS>OBJ01</NEW_I15_KODAS_OS>
            <NEW_I15_SERIJA>ABC123</NEW_I15_SERIJA>
            <NEW_I15_KODAS_OS_C>CENT02</NEW_I15_KODAS_OS_C>
            <NEW_I16_KODAS_OS>OBJ02</NEW_I16_KODAS_OS>
            <NEW_I16_SERIJA>ABC124</NEW_I16_SERIJA>
            <errorAction>CONTINUE</errorAction>
        </I15>    
    </data>
</body>

JSON request

json

{
    "method": "EDIT_I15_KOP",
    "data": {
        "I15": {
            "P_OPER": "1",
            "OLD_I15_KODAS_KA": "010R00000021",
            "NEW_I15_TIPAS": "1",
            "NEW_I15_DOK_NR": "D20260713-6",
            "NEW_I15_OP_DATA": "2026-07-13",
            "NEW_I15_UZS_DATA": "2026-07-13",
            "NEW_I15_KODAS_IS": "02",
            "NEW_I15_KODAS_OS": "OBJ01",
            "NEW_I15_SERIJA": "ABC123",
            "NEW_I15_KODAS_OS_C": "CENT02",
            "NEW_I16_KODAS_OS": "OBJ02",
            "NEW_I16_SERIJA": "ABC124",
            "errorAction": "CONTINUE"
        }
    }
}

Response (status 200 OK)

XML response

xml

<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
    <I15>
        <I15_KODAS_KA>010R00000034</I15_KODAS_KA>
        <I15_DOK_NR>D20260713-6</I15_DOK_NR>
        <I15_UZS_NR></I15_UZS_NR>
        <I15_UZS_DATA>2026-07-13T00:00:00</I15_UZS_DATA>
        <I15_OP_DATA>2026-07-13T00:00:00</I15_OP_DATA>
        <I15_TIPAS>1</I15_TIPAS>
        <I15_KODAS_IS>02</I15_KODAS_IS>
        <I15_KODAS_PS>PREKE001</I15_KODAS_PS>
        <I15_KODAS_OS>OBJ01</I15_KODAS_OS>
        <I15_SERIJA>ABC123</I15_SERIJA>
        <I15_KODAS_US>VNT</I15_KODAS_US>
        <I15_FRAKCIJA>1</I15_FRAKCIJA>
        <I15_KIEKIS>10</I15_KIEKIS>
        <I15_KODAS_US_A>VNT</I15_KODAS_US_A>
        <I15_FRAKCIJA_A>1</I15_FRAKCIJA_A>
        <I15_KIEKIS_A>10</I15_KIEKIS_A>
        <I15_PERKELTA>1</I15_PERKELTA>
        <I15_H_COST>0</I15_H_COST>
        <I15_PARD_K>0</I15_PARD_K>
        ...
    </I15>
</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;I15>&lt;OLD_I15_KODAS_KA>010R0000002&lt;/OLD_I15_KODAS_KA>&lt;NEW_I15_TIPAS>1&lt;/NEW_I15_TIPAS>&lt;NEW_I15_DOK_NR>D20260713-6&lt;/NEW_I15_DOK_NR>&lt;NEW_I15_KODAS_IS>02&lt;/NEW_I15_KODAS_IS>&lt;USERIS>M&lt;/USERIS>&lt;P_OPER>1&lt;/P_OPER>&lt;/I15></data>
            <dataErrors>
                <dataError>
                    <tag>OLD_I15_KODAS_KA</tag>
                    <code>21001</code>
                    <message>Toks operacijos kodas nerastas</message>
                </dataError>
                <dataError>
                    <tag>NEW_I15_TIPAS</tag>
                    <code>15002</code>
                    <message>Blogas operacijos tipas</message>
                </dataError>
            </dataErrors>
        </error>
    </errors>
</RET_DOK>