EDIT_I07

Aprašymas

Pirkimų, pardavimų dokumento detalios informacijos sukūrimas, koregavimas, trynimas

Specifikacija

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

Body

method : EDIT_I07
params :
- oper :
  - I - naujo dokumento sukūrimas
  - U - dokumento koregavimas
  - D - dokumento ištrynimas
data: perduodami duomenys:
- I07 - Detali eilutė, parduodamos prekės, paslaugos informacija (i07)

Koreguoti galima tik to paties API vartotojo sukurtas operacijas. Teisės valdomos parametru RGI_ALL_EDIT

Jei naudojate du tagus <KIEKIS_U> ir <BAR_KODAS>, tuomet nereikia naudoti šių tagų: <I07_KODAS_US>, <I07_KIEKIS>, <I07_FRAKCIJA>, <I07_KODAS_US_P>, <I07_KODAS_US_A>, <I07_ALT_KIEKIS>, <I07_ALT_FRAK>

Naudojant tag'ą <obj_ser_order> yra galimybė prekių likučius nurašyti kitu objektu ir serija, nei buvo paduota. Detaliau čia

Yra galimybė dirbti su papildomomis dimensijomis, jeigu tokios naudojamos Rivile GAMA sistemoje. Tam naudojami tag'ai <I49_DIM01> ... <I49_DIM15>

Jegu dirbama su rinkinias, tuomet <I07_KODAS_OS> atitinka rinkinio kodą. Taip pat yra galimybė rinkinio kodą paduoti dalimis - tam naudojami tag'ai <K45_RIN01> ... <K45_RIN15>. Jeigu bus paduotI ir <I07_KODAS_OS> ir <K45_RIN01> ... <K45_RIN15> tag'ai, aukštesnį prioritetą turi <I07_KODAS_OS>. Rinkinio kodo iš anksto kurti nereikia, jis bus sukurtas automatiškai.

Norint atnaujinti rinkinio kodą, naujas kodas pateikiamas naudojant tag'ą <I07_KODAS_OS>. Jeigu norima naują rinkinio kodą paduoti dalimis - būtina paduoti tuščią tagą <I07_KODAS_OS>ir tada atskiras dalis naudojant tag'us <K45_RIN01> ... <K45_RIN15>.

Numatyta galimybė perduoti papildomų laukų informaciją, jei jie yra aprašyti Rivile GAMA programoje. Tam naudojamos žymos <PAP_1>, <PAP_2> ir t.t., kur skaičius nurodo konkretaus papildomo lauko numerį.

Registruojant pirkimo arba pardavimo grąžinimą, sistemoje galima susieti jį su pradiniu dokumentu. Norint atlikti šį susiejimą, reikia nurodyti tikslų operacijos kodą <graz_op> bei eilutės numerį <graz_eil>. Atkreipkite dėmesį, kad susietoje pirminio dokumento eilutėje esantis prekės kodas turi tiksliai atitikti grąžinamos prekės kodą.

pvz application/xml:

xml

<body>
    <method>EDIT_I07</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
        <I07>
            <I07_KODAS_PO>010R00000008</I07_KODAS_PO>
            <I07_TIPAS>1</I07_TIPAS>
            <I07_KODAS_IS>01</I07_KODAS_IS>
            <I07_KODAS>004</I07_KODAS>
            <I07_KAINA_BE>1000.0000</I07_KAINA_BE>
            <I07_PVM>210.00</I07_PVM>
            <I07_SUMA>1000.00</I07_SUMA>
            <I07_KODAS_US>VNT</I07_KODAS_US><!--Pagrindinio matavimo vieneto kodas-->
            <I07_KIEKIS>1</I07_KIEKIS><!--Kiekis pagrindiniu matavimo vienetu-->
            <I07_FRAKCIJA>1</I07_FRAKCIJA><!--Pagrindinio matavimo vnt. frakcija-->
            <I07_KODAS_US_P>VNT</I07_KODAS_US_P><!--Pajamavimo alternatyvus matavimo vieneto kodas-->
            <I07_KODAS_US_A>VNT</I07_KODAS_US_A><!--Pardavimo alternatyvus matavimo vieneto kodas-->
            <I07_ALT_KIEKIS>1</I07_ALT_KIEKIS><!--Alternatyvaus matavimo kiekis-->
            <I07_ALT_FRAK>1</I07_ALT_FRAK><!--Alternatyvaus kiekio frakcija-->
            <I49_DIM01>MEN1</I49_DIM01> <!--Jeigu naudojamos dimensijos -->
            <K45_RIN01>RINKINYS</K45_RIN01> <!--Jeigu naudojami rinkiniai -->
            <PAP_1>Požymis 1</PAP_1> <!--Jeigu aprašyti papildomi laukai -->
        </I07>    
    </data>
</body>

pvz application/json:

json

{
    "method": "EDIT_I07",
    "params": {
        "oper": "I"
    },
    "data": {
        "I07": {
            "I07_KODAS_PO": "010R00000008",
            "I07_TIPAS": "1",
            "I07_KODAS_IS": "01",
            "I07_KODAS": "004",
            "I07_KAINA_BE": "1000.0000",
            "I07_PVM": "210.00",
            "I07_SUMA": "1000.00",
            "I07_KODAS_US": "VNT",
            "I07_KIEKIS": "1",
            "I07_FRAKCIJA": "1",
            "I07_KODAS_US_P": "VNT",
            "I07_KODAS_US_A": "VNT",
            "I07_ALT_KIEKIS": "1",
            "I07_ALT_FRAK": "1",
            "I49_DIM01": "MEN1",
            "K45_RIN01": "RINKINYS",
            "PAP_1": "Požymis 1"
        }
    }
}

Response (status 200 OK)

Grąžinama informacija XML formate tarp tag'ų <RET_DOK>..</RET_DOK>.

pvz :

xml

<?xml version='1.0' encoding='UTF-8' ?>
<RET_DOK>
    <I07>
        <I07_KODAS_PO>010R00000008</I07_KODAS_PO>
        <I07_EIL_NR>1</I07_EIL_NR>
        <I07_TIPAS>1</I07_TIPAS>
        <I07_KODAS>004</I07_KODAS>
        <I07_PAV>Kompiuteris</I07_PAV>
        <I07_KODAS_TR></I07_KODAS_TR>
        <I07_KODAS_IS>01</I07_KODAS_IS>
        <I07_KODAS_OS></I07_KODAS_OS>
        <I07_KODAS_OS_C></I07_KODAS_OS_C>
        <I07_SERIJA></I07_SERIJA>
        <I07_KODAS_US>VNT</I07_KODAS_US>
        <I07_KIEKIS>1</I07_KIEKIS>
        <I07_FRAKCIJA>1</I07_FRAKCIJA>
        <I07_KODAS_US_P>VNT</I07_KODAS_US_P>
        <I07_KODAS_US_A>VNT</I07_KODAS_US_A>
        <I07_ALT_KIEKIS>1</I07_ALT_KIEKIS>
        <I07_ALT_FRAK>1</I07_ALT_FRAK>
        <I07_VAL_KAINA>0.0000</I07_VAL_KAINA>
        <I07_SUMA_VAL>0.00</I07_SUMA_VAL>
        <I07_KAINA_BE>1000.0000</I07_KAINA_BE>
        ...
    </I07>
</RET_DOK>

Response (status 400)

Klaida paduodant duomenis / SQL sintaksės klaidos / kitos DB klaidos

xml

<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id>14433105830.985e6bc0.1584207405894</id>
    <durationMs>115</durationMs>
    <errorMessage>nepavyko įvykdyti metodo</errorMessage>
    <errors>
        <error>
            <data>&lt;I07>&lt;I07_KODAS_PO>010R00000026&lt;/I07_KODAS_PO>&lt;I07_KODAS_US>VNT&lt;/I07_KODAS_US>&lt;I07_KIEKIS>1&lt;/I07_KIEKIS>&lt;I07_TIPAS>1&lt;/I07_TIPAS>&lt;I07_KODAS_US_P>VNT&lt;/I07_KODAS_US_P>&lt;I07_FRAKCIJA>1&lt;/I07_FRAKCIJA>&lt;I07_ALT_KIEKIS>1&lt;/I07_ALT_KIEKIS>&lt;I07_KAINA_BE>1000.0000&lt;/I07_KAINA_BE>&lt;I07_ALT_FRAK>1&lt;/I07_ALT_FRAK>&lt;I07_KODAS>004&lt;/I07_KODAS>&lt;I07_SUMA>1000.00&lt;/I07_SUMA>&lt;I07_KODAS_US_A>VNT&lt;/I07_KODAS_US_A>&lt;I07_KODAS_IS>01&lt;/I07_KODAS_IS>&lt;I07_PVM>210.00&lt;/I07_PVM>&lt;/I07></data>
            <dataErrors>
                <dataError>
                    <tag>I07_KODAS_PO</tag>
                    <code>16064</code>
                    <message>Galima koreguoti tik savo operacijas</message>
                </dataError>
            </dataErrors>
        </error>
    </errors>
</RET_DOK>

Koregavimas ir trynimas

Koregavimas, trynimas vyksta pagal lentelės raktą (Primary Key)

Koreguojant informaciją bus koreguojami tik perduodami laukai.

pvz koregavimas :

xml

<body>
    <method>EDIT_I07</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <I07>
            <I07_KODAS_PO>010R00000008</I07_KODAS_PO>
            <I07_EIL_NR>1</I07_EIL_NR>
            <I07_KAINA_BE>800.0000</I07_KAINA_BE>
        </I07>    
    </data>
</body>

pvz trynimas :

xml

<body>
    <method>EDIT_I07</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <I07>
            <I07_KODAS_PO>010R00000008</I07_KODAS_PO>
            <I07_EIL_NR>1</I07_EIL_NR>
        </I07>    
    </data>
</body>

Rinkinio kodo atnaujinimas

xml

<body>
    <method>EDIT_I07</method>
    <params>
        <oper>U</oper>
    </params>
    <data>
        <I07>
            <I07_KODAS_PO>010R00000008</I07_KODAS_PO>
            <I07_EIL_NR>1</I07_EIL_NR>
            <I07_KODAS_OS></I07_KODAS_OS>
            <K45_RIN01>RINKINYS</K45_RIN01>
            <K45_RIN02>RINKINYS2</K45_RIN02>
        </I07>    
    </data>
</body>

Lentelės

I07

Pirkimo/Pardavimo dokumentų detalios eilutės

Laukas	Tipas	Aprašymas	Pastabos naudojant EDIT metodus
I07_KODAS_PO	C(12)	Operacijos numeris	Privalomas (metode EDIT_I06_FULL neaktualus)
I07_EIL_NR	N(6)	Eilutės numeris operacijoje	Privalomas tik EDIT_I07 metode, kai oper=U,D
I07_TIPAS	N(1)	Tipas:1-prekė,2-paslauga,3-kodas,4-pranesimas,5-aprašym
I07_KODAS	C(12)	Prekės,paslaugos,... kodas	Privalomas**
I07_PAV	C(40)	Prekės,paslaugos,... pavadinimas
I07_KODAS_TR	C(12)	Transporto dokumento numeris
I07_KODAS_IS	C(12)	Padalinio kodas	Privalomas
I07_KODAS_OS	C(12)	Objekto kodas	Arba rinkinio kodas, jei programoje dirbama su rinkiniais
I07_KODAS_OS_C	C(12)	Pardavimo centro kodas
I07_SERIJA	C(12)	Serija
I07_KODAS_US	C(12)	Pagrindinio matavimo vieneto kodas
I07_KIEKIS	N(14)	Kiekis pagrindiniu matavimo vienetu
I07_FRAKCIJA	N(4)	Pagrindinio matavimo vnt. frakcija. Mūsų sistemoje matavimo vienetas turi frakciją, t.y. į kiek dalių galima smulkinti kiekį. PVZ: KG i07_kiekis=1000, i07_frakcija=1000 dešimtainėje išraiškoje, tai yra 1,000Kg(vienas kilogramas), t.y. frakciinis kiekis dalinamas iš frakcijos.
I07_KODAS_US_P	C(12)	Pardavimo alternatyvus matavimo vieneto kodas
I07_KODAS_US_A	C(12)	Pajamavimo alternatyvus matavimo vieneto kodas
I07_ALT_KIEKIS	N(14)	Alternatyvaus matavimo kiekis
I07_ALT_FRAK	N(4)	Alternatyvaus kiekio frakcija
I07_VAL_KAINA	N(18,4)	Kaina valiuta	Tik valiutinio dokumento atveju
I07_SUMA_VAL	N(18,2)	Valiutos suma	Tik valiutinio dokumento atveju
I07_KAINA_BE	N(12,4)	Kaina be PVM
I07_KAINA_SU	N(12,4)	Kaina su PVM
I07_NUOLAIDA	N(6,2)	Nuolaidos procentas
I07_ISLAIDU_M	N(1)	Ar skaičiuoti nuo išlaidų PVM:0-ne,1-taip	Nurodoma kai norima, kad automatiškai perduodant išlaidų sumą būtų paskaičiuotas ir PVM
I07_ISLAIDOS	N(12,2)	Išlaidos
I07_ISLAIDOS_PVM	N(12,2)	PVM nuo išlaidų
I07_MUITAS_M	N(1)	Ar skaičiuoti nuo muitų PVM:0-ne,1-taip	Nurodoma kai norima, kad automatiškai perduodant muito sumą būtų paskaičiuotas ir PVM
I07_MUITAS	N(12,2)	Muito suma
I07_MUITAS_PVM	N(12,2)	PVM nuo muito
I07_AKCIZAS_M	N(1)	Ar skaičiuoti nuo akcizo PVM:0-ne,1-taip	Nurodoma kai norima, kad automatiškai perduodant akcizo sumą būtų paskaičiuotas ir PVM
I07_AKCIZAS	N(12,2)	Akcizas
I07_AKCIZAS_PVM	N(12,2)	PVM nuo akcizas
I07_MOKESTIS	N(1)	Ar skaičiuoti PVM:0-ne,1-taip
I07_MOKESTIS_P	N(6,2)	PVM procentas
I07_PVM	N(12,2)	PVM suma
I07_SUMA	N(12,2)	Suma be PVM
I07_PAR_KAINA	N(12,4)	Pardavimo kaina sistemoje
I07_PAR_KAINA_N	N(12,4)	Nauja pardavimo kaina
I07_MOK_SUMA	N(12,2)	Eilė
I07_SAVIKAINA	N(12,2)	Savikainos suma
I07_GALIOJA_IKI	T(8)	Prekės galiojimo terminas
I07_PERKELTA	N(1)	Perkėlimo požymis:1-neperkelta,2-perkelta
I07_ADDUSR	C(12)	Kas sukūrė
I07_USERIS	C(12)	Kas koregavo
I07_R_DATE	T(8)	Koregavimo laikas
I07_SERTIFIKATAS	C(12)	Sertifikato kodas
I07_KODAS_KT	C(12)	Sutarties numeris
I07_KODAS_K0	C(12)	Sutarties priedas
I07_KODAS_KV	C(12)	Krovinio kodas
I07_KODAS_VZ	C(12)	Vežimo kodas
I07_ADD_DATE	T(8)	Eilutės sukūrimo laikas
I07_APSKRITIS	C(3)	Apskritis
I07_SANDORIS	C(3)	Sandoris
I07_SALYGOS	C(3)	Pristatymo sąlygos
I07_RUSIS	C(3)	Rūšis
I07_SALIS	C(3)	Šalis gavėja
I07_MATAS	C(3)	Mato vnt.
I07_SALIS_K	C(3)	Kilmės šalis
I07_MASE	N(14,3)	Intrastate masė
I07_INT_KIEKIS	N(14,3)	Intrastate kiekis
I07_PVM_VAL	N(18,2)	PVM valiuta	Tik valiutinio dokumento atveju
I07_KODAS_KS	C(12)	Tiekėjo kodas
I07_APRASYMAS1	C(150)	Aprašymas 1
I07_APRASYMAS2	C(150)	Aprašymas 2
I07_APRASYMAS3	C(150)	Aprašymas 3
I07_KODAS_KL	C(12)	PVM klasifikatoriaus kodas	nuo v109.0100
I07_PVM_SKOL	N(1)	PVM traukti į skolą	nuo v113.0000
I07_GALIOJA_IKI2	T(8)	Galioja 2	nuo v122.0000
kiekis_u	N(12,3)	Alternatyvus kiekis dešimtainėje išraiškoje
bar_kodas	C(12)	Barkodas
suma_val_su	N(12,2)	Valiutinė suma su PVM	Jei įvedant naują įrašą perduodama ši reikšmė, tai viskas perskaičiuojama atsiremiant į šią reikšmę: Kainos, PVM, suma be PVM, valiutinė informacija.
obj_ser_order		Likučių nurašymo tvarka. Sąlygą galima formuoti nurodant tik dvi kolonėles i17_kodas_os ir / arba i17_serija, pavyzdžiui, "i17_kodas_os, i17_serija", "i17_kodas_os desc, i17_serija asc", "i17_serija desc, i17_kodas_os asc"	\ ***
I49_DIM01, ... , I49_DIM15	C(12)	Dimensijos
K45_RIN01, ... , K45_RIN15	C(12)	Rinkiniai
PAP_1, PAP_2...		Papildomi laukai	Veikia tik jei aprašyti Rivile Gama sistemoje
graz_op	C(12)	Pradinio (šaltinio) dokumento, pagal kurį atliekamas grąžinimas, operacijos kodas	Tik pirkimo / pardavimo grąžinimo operacijoms
graz_eil	N(6)	Konkrečios grąžinamos prekės eilutės numeris pradiniame dokumente	Tik pirkimo / pardavimo grąžinimo operacijoms

** jeigu naudojami laukai bar_kodas ir kiekis_u_, tuomet eilutės kodas yra automatiškai užpildomas pagal barkodą ir kiekis išverčiamas iš dešimtainio kiekio į kiekius ir frakcijas. Jeigu naudojamas_ bar_kodas*, tuomet laukai I07_KODAS, I07_PAV, I07_KODAS_US nebūtina nurodyti - jie randami pagal barkodo informaciją.

Koreguojant įrašą (oper=U) yra paduodamas kiekis (I07_ALT_KIEKIS arba kiekis_u) ir nepaduodama nei kainos, nei sumos, nei pvm (I07_KAINA_BE,I07_KAINA_SU,I07_SUMA,I07_SUMA_VAL,I07_PVM ,I07_PVM_VAL), tuomet sumos yra perskaičiuojamos pagal pakoreguotą kiekį ir esamas kainas.

\ *** Jeigu parametro reikšmė neperduodama, prekių likučiai nurašomi tiksliai su tokiu objektu ir serija, koks buvo perduotas. Perdavus reikšmę pirmiausiai tikrinamas prekės kiekis su perduotu objektu ir/ar serija. Jeigu toks kiekis nepakankamas, nurašomi likučiai su kitais objektais ir serijomis išlaikant parametre nurodyta rūšiavimo tvarką.