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