Back to Gidas

EDIT_I06_KOP

internetiniai-underscore-moduliai-api-underscore-rest-edit-underscore-i06-underscore-kop.md

latest6.5 KB
Original Source

PDF

Pradžia Internetiniai moduliai Rivile API v2 (REST web servisai) EDIT_I06_KOP

EDIT_I06_KOP

Aprašymas

Pirkimų, pardavimų dokumento kopijavimas ir keitimas.

Specifikacija

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

Body
  • method : EDIT_I06_KOP
  • data: perduodami duomenys:
    • I06 - Pardavimo/pirkimo antraštė (i06)

Kopijuojant ar keičiant dokumentą yra privalomi laukai: P_OPER, OLD_I06_KODAS_PO, NEW_I06_OP_TIP ir NEW_I06_DOK_NR.

TagasAprašymas
P_OPER1 - kopijuoti, 2 - keisti. Privalomas
OLD_I06_KODAS_POOperacijos numeris iš kurio bus daroma kopija arba koregavimas. Privalomas
NEW_I06_OP_TIPOperacijos tipas kaip ir I06_OP_TIP i06. Privalomas
NEW_I06_DOK_NRDokumento numeris. Privalomas
NEW_I06_OP_DATANauja operacijos data kaip ir I06_OP_DATA i06
NEW_I06_DOK_DATANauja dokumento data kaip ir I06_DOK_DATA i06
NEW_I07_KODAS_ISNurodomas visų detalių eilučių padalinys kaip ir I07_KODAS_IS i07
NEW_I07_KODAS_OSNurodomas visų detalių eilučių objektas kaip ir I07_KODAS_OS i07
NEW_I07_KODAS_OS_CNurodomas visų detalių eilučių centras kaip ir I07_KODAS_OS_C i07
NEW_I07_SERIJANurodomas visų detalių eilučių serija kaip ir I07_SERIJA i07
errorActionKlaidos parametras nurodantis koks veiksmas bus atliekamas įvykus klaidai dokumento kopijavimo / keitimo metu, kai yra sukuriama operacija (I06) ir gaunama klaida kopijuojant / keičiant detalias eilutes (I07, I08, I13). 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!
NEFORMUOTI_APMOKEJIMU1 - Nekopijuoti apmokėjimų informacijos
GALIOJIMO_DATA1 - Neformuoti
2 - Formuoti iš naujo (pagal lauko Galiojimo laikas reikšmę prekės / paslaugos kortelėje)
3 - Kopijuoti (reikšmė pagal nutylėjimą)

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

Kai nurodoma bent viena NEW_I07 tago reikšmė, tuomet yra pakeičiami visų detalių eilučių laukai atitinkantis 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 (I06) ir grąžinama klaida.
EXITĮvykus klaidai tolimesnės procedūros nebus vykdamos, bus grąžinamas sukurtas dokumentas (I06) 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 (I06) ir klaidų sąrašas pabaigoje.
XML request (kopijavimas)
xml
<body>
    <method>EDIT_I06_KOP</method>
    <data>
        <I06>
            <P_OPER>1</P_OPER><!-- 1 - kopijuoti, 2 - keisti -->
            <OLD_I06_KODAS_PO>010000001293</OLD_I06_KODAS_PO>
            <NEW_I06_OP_TIP>1</NEW_I06_OP_TIP>
            <NEW_I06_DOK_NR>D20200409-6</NEW_I06_DOK_NR>
            <NEW_I06_OP_DATA>2020-04-21</NEW_I06_OP_DATA>  
            <NEW_I07_KODAS_IS>02</NEW_I07_KODAS_IS>
            <NEW_I07_KODAS_OS>OBJ01</NEW_I07_KODAS_OS>
            <NEW_I07_KODAS_OS_C>CENT02</NEW_I07_KODAS_OS_C>
            <NEW_I07_SERIJA>ABC123</NEW_I07_SERIJA>
            <errorAction>CONTINUE</errorAction>
        </I06>    
    </data>
</body>
JSON request
json
{
    "method": "EDIT_I06_KOP",
    "data": {
        "I06": {
            "P_OPER": "1",
            "OLD_I06_KODAS_PO": "010000001293",
            "NEW_I06_OP_TIP": "1",
            "NEW_I06_DOK_NR": "D20200409-6",
            "NEW_I06_OP_DATA": "2020-04-21",
            "NEW_I07_KODAS_IS": "02",
            "NEW_I07_KODAS_OS": "OBJ01",
            "NEW_I07_KODAS_OS_C": "CENT02",
            "NEW_I07_SERIJA": "ABC123",
            "errorAction": "CONTINUE"
        }
    }
}
Response (status 200 OK)
XML response
xml
<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
    <I06>
        <I06_KODAS_PO>010R00000038</I06_KODAS_PO>
        <I06_OP_TIP>1</I06_OP_TIP>
        <I06_VAL_POZ>0</I06_VAL_POZ>
        <I06_PVM_TIP>0</I06_PVM_TIP>
        <I06_OP_STORNO>0</I06_OP_STORNO>
        <I06_DOK_NR>D20200409-7</I06_DOK_NR>
        <I06_OP_DATA>2020-04-21T00:00:00</I06_OP_DATA>
        <I06_DOK_DATA>2020-04-21T00:00:00</I06_DOK_DATA>
        <I06_KODAS_MS></I06_KODAS_MS>
        <I06_KODAS_KS>121411842</I06_KODAS_KS>
        <I06_KODAS_SS></I06_KODAS_SS>
        <I06_PAV>UAB "Rivilė"</I06_PAV>
        <I06_ADR>Geležinio Vilko 5-48, Vilnius</I06_ADR>
        <I06_ATSTOVAS></I06_ATSTOVAS>
        <I06_KODAS_VS></I06_KODAS_VS>
        <I06_PAV2>UAB "Rivilė"</I06_PAV2>
        <I06_ADR2>Geležinio Vilko 5-48, Vilnius</I06_ADR2>
        <I06_ADR3></I06_ADR3>
        <I06_KODAS_VL></I06_KODAS_VL>
        <I06_KODAS_XS>PVM</I06_KODAS_XS>
        <I06_KODAS_SS_P></I06_KODAS_SS_P>
        <I06_PASTABOS></I06_PASTABOS>
        ...
    </I06>
</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;I06>&lt;OLD_I06_KODAS_PO>01000000129&lt;/OLD_I06_KODAS_PO>&lt;NEW_I06_OP_DATA>2020-04-21&lt;/NEW_I06_OP_DATA>&lt;NEW_I07_SERIJA>ABC123&lt;/NEW_I07_SERIJA>&lt;NEW_I06_OP_TIP>1&lt;/NEW_I06_OP_TIP>&lt;NEW_I07_KODAS_IS>02&lt;/NEW_I07_KODAS_IS>&lt;USERIS>M&lt;/USERIS>&lt;NEW_I07_KODAS_OS>OBJ01&lt;/NEW_I07_KODAS_OS>&lt;P_OPER>1&lt;/P_OPER>&lt;NEW_I06_DOK_NR>D20200409-7&lt;/NEW_I06_DOK_NR>&lt;NEW_I07_KODAS_OS_C>CENT02&lt;/NEW_I07_KODAS_OS_C>&lt;/I06></data>
            <dataErrors>
                <dataError>
                    <tag>I07_KODAS_PO</tag>
                    <code>21001</code>
                    <message>Nėra operacijos</message>
                </dataError>
                <dataError>
                    <tag>I06_KODAS_KS</tag>
                    <code>2001</code>
                    <message>Nėra tokio kliento</message>
                </dataError>
            </dataErrors>
        </error>
    </errors>
</RET_DOK>