---
title: "EDIT_I31"
url: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i31"
updated: "2026-09-08"
parent: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest.md"
---

# EDIT_I31

### Aprašymas

Debitorinių/Kreditorinių operacijų koregavimas (antraštės)

### 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_I31
* `params` :
  * `oper` :  
      - `I` - naujo įrašo sukūrimas
      - `U` - įrašo koregavimas
      - `D` - įrašo ištrynimas
      - `P` - informacijos perkėlimas
* `data`: perduodami duomenys:
  * `I31` - atitinkamos lentelės laukai ([i31](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i31.md#i31))  

> **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)

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

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

**pvz** `application/xml`:

```xml
<body>
    <method>EDIT_I31</method>
    <params>
        <oper>I</oper>
    </params>
    <data>
      <I31>
        <I31_RUSIS>1</I31_RUSIS>
        <I31_DOK_NR>DK001</I31_DOK_NR>
        <I31_OP_DATA>2022-07-20</I31_OP_DATA>
        <PAP_1>Požymis 1</PAP_1> <!--Jeigu aprašyti papildomi laukai -->
      </I31> 
    </data>
</body>
```

**pvz ** `application/json`:

```json
{
    "method": "EDIT_I31",
	"params": {
		"errorAction": "CONTINUE"
	},
    "data": {
        "I31": {
            "I31_RUSIS": 1,
           	"I31_DOK_NR": "DK001",
            "I31_OP_DATA": "2022-07-20",
            "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>
    <i31>
        <I31_KODAS_KR>000R00000004</I31_KODAS_KR>
        <I31_RUSIS>1</I31_RUSIS>
        <I31_DOK_NR>DK001       </I31_DOK_NR>
        <I31_OP_DATA>2022-07-20T00:00:00</I31_OP_DATA>
        <I31_PASTABOS>                                       </I31_PASTABOS>
        <I31_PERKELTA>1</I31_PERKELTA>
        <I31_USERIS>XXAW2VW     </I31_USERIS>
        <I31_R_DATE>2022-07-20T00:00:00</I31_R_DATE>
        <I31_ADDUSR>XXAW2VW     </I31_ADDUSR>
        <I31_KODAS_SM>           </I31_KODAS_SM>
        <I31_KODAS>           </I31_KODAS>
        <I31_KODAS_LS_1>           </I31_KODAS_LS_1>
        <I31_KODAS_LS_2>           </I31_KODAS_LS_2>
        <I31_KODAS_LS_3>           </I31_KODAS_LS_3>
        <I31_KODAS_LS_4>           </I31_KODAS_LS_4>
        <I31_KODAS_ZN>           </I31_KODAS_ZN>
    </i31>
</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>615386280.9d658372.1658326542237</id>
    <durationMs>0</durationMs>
    <errorMessage>For input string: "a1"</errorMessage>
</RET_DOK>
```



##### Koregavimas, perkėlimas 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_I31</method>
    <params>
    	<oper>U</oper>
    </params>
    <data>
      <I31>
        <I31_KODAS_KR>000R00000006</I31_KODAS_KR>
        <I31_DOK_NR>DK005</I31_DOK_NR>
      </I31>   
    </data>
</body>
```

**pvz trynimas**:

```xml
<body>
    <method>EDIT_I31</method>
    <params>
    	<oper>D</oper>
    </params>
    <data>
	  	<I31>
	     	<I31_KODAS_KR>000R00000007</I31_KODAS_KR>
    	</I31>      
    </data>
</body>
```

**pvz perkėlimas:**

```xml
<body>
    <method>EDIT_I31</method>
    <params>
    	<oper>P</oper>
    </params>
    <data>
	  	<I31>
	     	<I31_KODAS_KR>000R00000006</I31_KODAS_KR>
    	</I31>      
    </data>
</body>
```



### Lentelės

#### I31

Nuoroda į lentelės aprašymą: [I31](https://gidas.rivile.lt/sistemos_programavimas/struktura/i.md#i31_klh-klientų-skolų-koregavimo-hederis)

Papildomi laukai: `PAP_1`, `PAP_2`... Veikia tik jei aprašyti Rivile Gama sistemoje.
