---
title: "EDIT_I20"
url: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i20"
updated: "2026-10-20"
parent: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest.md"
---

# EDIT_I20

### Aprašymas

Perkainavimo operacijos koregavimas

### 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_I20`
* `params` :
  * `oper` :  
      - `I` - naujo įrašo sukūrimas (numatytasis)
      - `U` - įrašo koregavimas
      - `P` - įrašo perkėlimas
      - `D` - įrašo ištrynimas
  * `user` :  vartotojo vardas (naudojamas dokumentų skaitliukams, parametrams ir kt.), veikia tik rakto prefix'ui įjungus parametrą `RGI_USR_EDIT`
* `data`: perduodami duomenys:
  * `I20` - atitinkamos lentelės laukai ([i20](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i20.md#i20))  

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

##### XML request

```xml
<body>
    <method>EDIT_I20</method>
    <params>
    	<oper>I</oper>
    </params>
    <data>
		<I20>
            <I20_TIPAS>1</I20_TIPAS>
            <I20_OP_DATE>2024.01.01</I20_OP_DATE>
            <I20_DOK_NR>PERK001</I20_DOK_NR>
            <I20_KODAS_IS>01</I20_KODAS_IS>
            <PAP_1>Požymis 1</PAP_1> <!--Jeigu aprašyti papildomi laukai -->
		</I20>    
    </data>
</body>
```

##### JSON request

```json
{
    "method": "EDIT_I20",
    "params": {
        "oper": "I"
    },
    "data": {
    	"I20": {
            "I20_TIPAS": 1,
            "I20_OP_DATE": "2024.01.01",
            "I20_DOK_NR": "PERK001",
            "I20_KODAS_IS": "01",
            "PAP_1": "Požymis 1"
		}
    }
}
```

##### Response (status 200 OK)

##### XML response

```xml
<RET_DOK>
    <I20>
        <I20_KODAS_PK>010R00000001</I20_KODAS_PK>
        <I20_DOK_NR>PERK001</I20_DOK_NR>
        <I20_TIPAS>1</I20_TIPAS>
        <I20_OP_DATE>2024-01-01T00:00:00</I20_OP_DATE>
        <I20_APRAS></I20_APRAS>
        <I20_KODAS_IS>01</I20_KODAS_IS>
        <I20_PERKELTA>1</I20_PERKELTA>
        <I20_USERIS>WS</I20_USERIS>
        <I20_ADDUSR>WS</I20_ADDUSR>
        <I20_R_DATE>2024-01-01T00:00:01</I20_R_DATE>
        <I20_PERKELTA2>1</I20_PERKELTA2>
        <I20_KODAS_SM></I20_KODAS_SM>
        <I20_ID></I20_ID></I20_ID>
        <I20_BUSENA>1</I20_BUSENA>
    </I20>
</RET_DOK>
```

##### JSON response

```json
{
    "I20": {
        "I20_KODAS_PK": "010R00000001",
        "I20_DOK_NR": "PERK001",
        "I20_TIPAS": 1,
        "I20_OP_DATE": "2024-01-01T00:00:00",
        "I20_APRAS": "",
        "I20_KODAS_IS": "01",
        "I20_PERKELTA": 1,
        "I20_USERIS": "WS",
        "I20_ADDUSR": "WS",
        "I20_R_DATE": "2024-01-01T00:00:01",
        "I20_PERKELTA2": 1,
        "I20_KODAS_SM": "",
        "I20_ID": "",
        "I20_BUSENA": 1
    }
}
```

##### Response (status 400)

Klaida paduodant duomenis / SQL sintaksės klaidos / kitos duomenų klaidos

```xml
<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
    <id>9357776210.60e9b119.1706716350593</id>
    <durationMs>24</durationMs>
    <errorMessage>Nepavyko įvykdyti metodo</errorMessage>
    <document/>
    <errors>
        <error>
            <data></data>
            <dataErrors>
                <dataError>
                    <tag>I20_TIPAS</tag>
                    <code>15001</code>
                    <message>Neleistina parametro reikšmė</message>
                </dataError>
            </dataErrors>
        </error>
    </errors>
</RET_DOK>
```



##### Koregavimas, trynimas  ir perkėlimas

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

> **Dėmesio:** Koreguojant informaciją bus koreguojami tik perduodami laukai. 

**pvz koregavimas**:

```xml
<body>
    <method>EDIT_I20</method>
    <params>
    	<oper>U</oper>
    </params>
    <data>
		<I20>
			<I20_KODAS_PK>010R00000001</I20_KODAS_PK>
            <I20_APRAS>API test - pataisyta</I20_APRAS>
		</I20>    
    </data>
</body>
```

**pvz trynimas**:

```xml
<body>
    <method>EDIT_I20</method>
    <params>
        <oper>D</oper>
    </params>
    <data>
        <I20>
            <I20_KODAS_PK>010R00000001</I20_KODAS_PK>
        </I20>
    </data>
</body>
```

**pvz perkėlimas**:

```xml
<body>
    <method>EDIT_I20</method>
    <params>
        <oper>P</oper>
    </params>
    <data>
        <I20>
            <I20_KODAS_PK>010R00000001</I20_KODAS_PK>
        </I20>
    </data>
</body>
```



### PHP pvz

```php
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'ApiKey: uUCz7UY.sKVrjaWRDJAH1c7l4qL222nn2K0jARkkkHDdYTss',
      'Content-Type: application/json',
	  ]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
    "method": "EDIT_I20",
    "params": {
        "oper": "I"
    },
    "data": {
    	"I20": {
            "I20_TIPAS": 1,
            "I20_OP_DATE": "2024.01.01",
            "I20_DOK_NR": "PERK001",
            "I20_KODAS_IS": "01"
		}
    }
}');
$response = curl_exec($ch);
curl_close($ch);
```



### Lentelės

#### I20

Perkainavimo operacijų antraštės lentelė

| Laukas           | Tipas  | Aprašymas | Pastabos naudojant EDIT metodus |
| ---------------- | ------ | --------- | -------- |
|**I20_KODAS_PK**|C(12)|Operacijos Numeris|Privalomas , kai oper=U,D,P|
|I20_DOK_NR|C(12)|Dokumento numeris||
|I20_TIPAS|N(1)|Tipas:1-prekės,2-paslaugos|  |
|I20_OP_DATE|T(8)|Operacijos data| |
|I20_APRAS|C(40)|Aprašymas| |
|I20_KODAS_IS|C(12)|Padalinio kodas|  |
|I20_PERKELTA|N(1)|Perkėlimo požymis:1-neperkelta,2-perkelta,3-koreguota||
|I20_USERIS|C(12)|Kas koregavo| Neperduodamas. Pildomas automatiškai, ApiKey - pirmi 7 simboliai |
|I20_ADDUSR|C(12)|Kas sukūrė| Neperduodamas. Pildomas automatiškai, ApiKey - pirmi 7 simboliai |
| I20_R_DATE | T(8) | Kada koregavo | Neperduodamas. Pildomas automatiškai, Current Datetime |
| I20_PERKELTA2 | N(1) | 2 perkėlimo požymis:1-neperkelta,2-perkelta,3-koreguota |                                                              |
| I20_KODAS_SM | C(12) | Asmuo                       |  |
| I20_ID | C(2) | Įmonės Id.       |  |
| I20_KODAS_LS_1 | C(12) | Logistika 1                         ||
| I20_KODAS_LS_2 | C(12) | Logistika 2                          |  |
| I20_KODAS_LS_3 | C(12) | Logistika 3                         |  |
| I20_KODAS_LS_4 | C(12) | Logistika 4                        |                                                              |
| I20_KODAS_ZN | C(12) | Zona                              |                                                              |
| I20_APRASYMAS1 | C(150) | Aprašymas 1                      |                                                              |
| I20_APRASYMAS2 | C(150) | Aprašymas 2                               |                                                              |
| I20_APRASYMAS3 | C(150) | Aprašymas 3                        |                                                              |
| I20_BUSENA | N(3) | Būsena                             |                                                              |
|PAP_1, PAP_2...||Papildomi laukai|Veikia tik jei aprašyti Rivile Gama sistemoje|