---
title: "EDIT_I07"
url: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i07"
updated: "2026-06-02"
parent: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest.md"
---

# EDIT_I07

### Aprašymas

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

### Specifikacija

> **Informacija:** Informacija apie autorizaciją, bendruosius parametrus ir klaidų kodus: **[Rivile API v2 naudojimo pagrindai](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/naudojimo_pagrindai.md)**

##### 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](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i07.md#i07))  

> **Informacija:** Koreguoti galima tik to paties API vartotojo sukurtas operacijas. Teisės valdomos parametru [RGI_ALL_EDIT](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/parametrai.md#RGI_ALL_EDIT)

> **Dėmesio:** 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>`

> **Informacija:** Naudojant tag'ą `<obj_ser_order>` yra galimybė prekių likučius nurašyti kitu objektu ir serija, nei buvo paduota. Detaliau [čia](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i07.md#i07)

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

> **Informacija:** 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.

> **Informacija:** 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>`.

> **Informacija:** 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į.

> **Dėmesio:** 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_KODAS_US>VNT</I07_KODAS_US><!--Pagrindinio matavimo vieneto kodas-->
            <KIEKIS_U>10</KIEKIS_U>
			<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-->
            <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_KODAS_US": "VNT",
            "KIEKIS_U": "10",
            "I07_KODAS_US_P": "VNT",
            "I07_KODAS_US_A": "VNT",
            "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

> **Dėmesio:** Koregavimas, trynimas vyksta pagal lentelės raktą  (Primary Key)

> **Dėmesio:** 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ą.