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

# EDIT_N17

### Aprašymas

Prekių, paslaugų 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_N17`
* `params` :
  * `oper` :  
      - `I` - naujo prekės sukūrimas
      - `U` - prekės koregavimas
      - `D` - prekės ištrynimas
* `data`: perduodami duomenys:
  * `N17` - Prekės, paslaugos informacija ([N17](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_n17.md#n17))

> **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_N17</method>
    <params>
    	<oper>I</oper>
    </params>
    <data>
		<N17>
	        <N17_KODAS_PS>PASLX</N17_KODAS_PS>
	        <N17_TIPAS>2</N17_TIPAS>
	        <N17_PAV>Paslauga X</N17_PAV>
	        <N17_KODAS_DS>PR001</N17_KODAS_DS>
	        <N17_KODAS_US>VNT</N17_KODAS_US>
	        <PAP_1>Požymis 1</PAP_1> <!--Jeigu aprašyti papildomi laukai -->
    	</N17>   
    </data>
</body>
```

**pvz ** `application/json`:

```json
{
    "method": "EDIT_N17",
    "params": {
        "oper": "I"
    },
    "data": {
    	"N17": {
            "N17_KODAS_PS": "PASLX",
            "N17_TIPAS": "2",
            "N17_PAV": "Paslauga X",
            "N17_KODAS_DS": "PR001",
            "N17_KODAS_US": "VNT",
            "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>
    <N17>
        <N17_KODAS_PS>PASLX</N17_KODAS_PS>
        <N17_TIPAS>2</N17_TIPAS>
        <N17_KODAS_P1></N17_KODAS_P1>
        <N17_KODAS_P2></N17_KODAS_P2>
        <N17_KODAS_US>VNT</N17_KODAS_US>
        <N17_PAV>Paslauga X</N17_PAV>
        <N17_PAVU></N17_PAVU>
        <N17_KODAS_KS></N17_KODAS_KS>
        <N17_KOD_T></N17_KOD_T>
        <N17_KODAS_KS1></N17_KODAS_KS1>
        <N17_KOD_T1></N17_KOD_T1>
        <N17_KODAS_KS2></N17_KODAS_KS2>
        <N17_KOD_T2></N17_KOD_T2>
        <N17_KODAS_VS></N17_KODAS_VS>
        <N17_KODAS_ES></N17_KODAS_ES>
        <N17_UZSIGUL>0.00</N17_UZSIGUL>
        <N17_BAZ_KIEKIS>0</N17_BAZ_KIEKIS>
        <N17_ASSEMBLY>1</N17_ASSEMBLY>
        <N17_KODAS_LS_1></N17_KODAS_LS_1>
        <N17_KODAS_LS_2></N17_KODAS_LS_2>
        <N17_KODAS_LS_3></N17_KODAS_LS_3>
        <N17_KODAS_LS_4></N17_KODAS_LS_4>
        <N17_KODAS_DS>PR001</N17_KODAS_DS>
        <N17_NUOL_GR></N17_NUOL_GR>
        <N17_GALIOJA>0</N17_GALIOJA>
        <N17_MOKESTIS>0</N17_MOKESTIS>
        <N17_TAX>0</N17_TAX>
        <N17_KODAS_KS_G></N17_KODAS_KS_G>
        <N17_KODAS_GS></N17_KODAS_GS>
        <N17_INSTR_POZ>0</N17_INSTR_POZ>
        <N17_INSTR_TIP></N17_INSTR_TIP>
        <N17_INSTR_VYK>0</N17_INSTR_VYK>
        <N17_INSTR_DATE>2020-02-29T00:00:00</N17_INSTR_DATE>
        <N17_INSTR_FILE></N17_INSTR_FILE>
        <N17_URM_POZ>0</N17_URM_POZ>
        <N17_URM_DATEIN>2020-02-29T00:00:00</N17_URM_DATEIN>
        <N17_URM_DATEOU>2020-02-29T00:00:00</N17_URM_DATEOU>
        <N17_KREPS_POZ>0</N17_KREPS_POZ>
        <N17_KREPS_KTG></N17_KREPS_KTG>
        <N17_KREPS_MIN>0</N17_KREPS_MIN>
        <N17_GARANT_POZ>0</N17_GARANT_POZ>
        <N17_GARANT_MEN>0</N17_GARANT_MEN>
        <N17_KODAS_KS3></N17_KODAS_KS3>
        <N17_TEMPER_POZ>0</N17_TEMPER_POZ>
        <N17_TEMPER_MAX>0</N17_TEMPER_MAX>
        <N17_TEMPER_MIN>0</N17_TEMPER_MIN>
        <N17_TEMPER_TXT></N17_TEMPER_TXT>
        <N17_SERTIF_POZ>0</N17_SERTIF_POZ>
        <N17_KODAS_MS></N17_KODAS_MS>
        <N17_ANTKAINIS>0.00</N17_ANTKAINIS>
        <N17_MAX_NUOL>0.00</N17_MAX_NUOL>
        <N17_EX_IM_FRAC>0</N17_EX_IM_FRAC>
        <N17_G_TIME>0</N17_G_TIME>
        <N17_KODAS_OS></N17_KODAS_OS>
        <N17_VAZ_LAIK>0</N17_VAZ_LAIK>
        <N17_UZS_LAIK>0</N17_UZS_LAIK>
        <N17_PAP_LAIK>0</N17_PAP_LAIK>
        <N17_SAN_COST>0.00</N17_SAN_COST>
        <N17_UZS_COST>0.00</N17_UZS_COST>
        <N17_TRA_COST>0.00</N17_TRA_COST>
        <N17_MEN_PAV></N17_MEN_PAV>
        <N17_MUIT_KOD></N17_MUIT_KOD>
        <N17_SK_KODAS>0</N17_SK_KODAS>
        <N17_INTERNET>0</N17_INTERNET>
        <N17_DUM_POZ>0</N17_DUM_POZ>
        <N17_DUM_TIP></N17_DUM_TIP>
        <N17_DUM_D_IN>2020-02-29T00:00:00</N17_DUM_D_IN>
        <N17_DUM_D_OUT>2020-02-29T00:00:00</N17_DUM_D_OUT>
        <N17_MUITO_PROC>0.00</N17_MUITO_PROC>
        <N17_AKCIZO_PROC>0.00</N17_AKCIZO_PROC>
        <N17_PASTABOS></N17_PASTABOS>
        <N17_POZ_DATE>0</N17_POZ_DATE>
        <N17_BEG_DATE>2020-02-29T00:00:00</N17_BEG_DATE>
        <N17_END_DATE>2020-02-29T00:00:00</N17_END_DATE>
        <N17_USERIS>B1NOONQ</N17_USERIS>
        <N17_R_DATE>2020-02-29T22:15:30</N17_R_DATE>
        <N17_ADD_DATE>2020-02-29T22:15:30</N17_ADD_DATE>
        <N17_ADDUSR>B1NOONQ</N17_ADDUSR>
        <N17_MIN_VISO>0</N17_MIN_VISO>
        <N17_SERT_POZ></N17_SERT_POZ>
        <N17_KAT_POZ></N17_KAT_POZ>
        <N17_BROK_POZ>0</N17_BROK_POZ>
        <N17_KODAS_PS_G></N17_KODAS_PS_G>
        <N17_DATA_BR>2020-02-29T00:00:00</N17_DATA_BR>
        <N17_KODAS_VS_T></N17_KODAS_VS_T>
        <N17_KODAS_MS_A></N17_KODAS_MS_A>
        <N17_KODAS_MS_M></N17_KODAS_MS_M>
        <N17_AR_NAUJA>0</N17_AR_NAUJA>
        <N17_DATA_NAUJA>2020-02-29T00:00:00</N17_DATA_NAUJA>
        <N17_MIN_ANTK>0.00</N17_MIN_ANTK>
        <N17_KODAS_LS_5></N17_KODAS_LS_5>
        <N17_KODAS_LS_6></N17_KODAS_LS_6>
        <N17_KODAS_LS_7></N17_KODAS_LS_7>
        <N17_KODAS_LS_8></N17_KODAS_LS_8>
        <N17_MIN_ANTK_UR>0.00</N17_MIN_ANTK_UR>
        <N17_MIN_ANTK_UR_D>2020-02-29T00:00:00</N17_MIN_ANTK_UR_D>
        <N17_MAX_ANTK>0.00</N17_MAX_ANTK>
        <N17_SVS_GALIOJA>0</N17_SVS_GALIOJA>
        <N17_SVS_GALIOJA_D>0</N17_SVS_GALIOJA_D>
        <N17_SVS_PARTIJA>0</N17_SVS_PARTIJA>
        <N17_PAV_K1></N17_PAV_K1>
        <N17_PAV_K2></N17_PAV_K2>
        <N17_PAV_K3></N17_PAV_K3>
    </N17>
</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.f8ddfad4.1584209364010</id>
    <durationMs>6</durationMs>
    <errorMessage>nepavyko įvykdyti metodo</errorMessage>
    <errors>
        <error>
            <data>&lt;N17>&lt;N17_KODAS_PS>PASLX&lt;/N17_KODAS_PS>&lt;N17_TIPAS>2&lt;/N17_TIPAS>&lt;N17_KODAS_US>VNT&lt;/N17_KODAS_US>&lt;N17_KODAS_DS>PR001&lt;/N17_KODAS_DS>&lt;N17_PAV>Paslauga X&lt;/N17_PAV>&lt;/N17></data>
            <dataErrors>
                <dataError>
                    <tag>N17_KODAS_PS</tag>
                    <code>5008</code>
                    <message>Tokia prekė/paslauga jau yra</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_N17</method>
    <params>
    	<oper>U</oper>
    </params>
    <data>
		<N17>
	        <N17_KODAS_PS>PASLX</N17_KODAS_PS>
	        <N17_PAV>Paslauga ABC</N17_PAV>
    	</N17>   
    </data>
</body>
```

> **Dėmesio:** Trynimas vyksta pagal atitinkamos lentelės raktą  (Primary Key) 

**pvz trynimas**:

```xml
<body>
    <method>EDIT_N17</method>
    <params>
    	<oper>D</oper>
    </params>
    <data>
		<N17>
	        <N17_KODAS_PS>PASLX</N17_KODAS_PS>
    	</N17>   
    </data>
</body>
```



### PHP pvz

```php
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'ApiKey: uUCz6UD.sKVrjaWRDJAH1c7l4qL2nOoN2K0jARkvuHDdYsss',
      'Content-Type: application/json',
	  ]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
    "method": "EDIT_N17",
    "params": {
        "oper": "I"
    },
    "data": {
    	"N17": {
            "N17_KODAS_PS": "PASLX",
            "N17_TIPAS": "2",
            "N17_PAV": "Paslauga X",
            "N17_KODAS_DS": "PR001",
            "N17_KODAS_US": "VNT"
		}
    }
}');
$response = curl_exec($ch);
curl_close($ch);
```

### Lentelės

#### N17

Prekės, paslaugos kortelės lentelė

| Laukas            | Tipas   | Aprašymas                                               | Pastabos naudojant EDIT metodus                 |
| ----------------- | ------- | ------------------------------------------------------- | ----------------------------------------------- |
|**N17_KODAS_PS**|C(12)|Prekės kodas| Privalomas |
|N17_TIPAS|N(1)|Tipas:1-prekė,2-paslauga| Privalomas |
|N17_KODAS_P1|C(12)|Pirmas alternatyvus kodas| |
|N17_KODAS_P2|C(12)|Antras alternatyvus kodas| |
|N17_KODAS_US|C(12)|Pagrindinis matavimo vieneto kodas| Privalomas |
|N17_PAV|C(120)|Pavadinimas| |
|N17_PAVU|C(150)|Pavadinimas kita kalba| |
|N17_KODAS_KS|C(12)|Tiekėjo kodas| |
|N17_KOD_T|C(25)|Kodas tiekėjo kataloguose| |
|N17_KODAS_KS1|C(12)|Pirmas alternatyvus tiekėjo kodas| |
|N17_KOD_T1|C(25)|Kodas pirmo alternatyvaus tiekėjo kataloguose| |
|N17_KODAS_KS2|C(12)|Antras alternatyvus tiekėjo kodas| |
|N17_KOD_T2|C(25)|Kodas antro alternatyvaus tiekėjo kataloguose| |
|N17_KODAS_VS|C(12)|Vietovės kodas| |
|N17_KODAS_ES|C(12)|Sezono kodas| |
|N17_UZSIGUL|N(6,2)|Prekės užsigulėjimo procentas| |
|N17_BAZ_KIEKIS|N(14)|Metų bazinis(vidutinis) kiekis| |
|N17_ASSEMBLY|N(1)|Rūšis: 1-paprasta, 2-komplektuojama, 3-išskaidoma, 4-generavimui, 5-sudėtinė, 6-komplektuojama/išskaidoma, 7-mišri, 8-tara| |
|N17_KODAS_LS_1|C(12)|Logistikos 1 kodas| |
|N17_KODAS_LS_2|C(12)|Logistikos 2 kodas| |
|N17_KODAS_LS_3|C(12)|Logistikos 3 kodas| |
|N17_KODAS_LS_4|C(12)|Logistikos 4 kodas| |
|N17_KODAS_DS|C(12)|Sąskaitos ryšio kodas| Privalomas |
|N17_NUOL_GR|C(6)|Nuolaidos grupė| |
|N17_GALIOJA|N(5)|Galiojimo dienos| |
|N17_MOKESTIS|N(1)|Ar prekė apmokestinama:0-ne,1-taip| |
|N17_TAX|N(1)|PVM mokestis,1-A,2-B,3-C,4-D| |
|N17_KODAS_KS_G|C(12)|Prekės gamintojo kodas| |
|N17_KODAS_GS|C(12)|Grupės kodas| |
|N17_INSTR_POZ|N(1)|Ar reikia instrukcijos prekei?:0-ne,1-taip| |
|N17_INSTR_TIP|C(1)|Instrukcijos tipas| |
|N17_INSTR_VYK|N(1)|Ar reikia daryti instrukciją?:0-ne,1-taip| |
|N17_INSTR_DATE|T(8)|Instrukcijos data| |
|N17_INSTR_FILE|C(12)|Instrukcijos failo pavadinimas| |
|N17_URM_POZ|N(1)|Urmo pozymis:0-ne,1-taip| |
|N17_URM_DATEIN|T(8)|Pateko į urmą| |
|N17_URM_DATEOU|T(8)|iškrito iš urmo| |
|N17_KREPS_POZ|N(1)|Ar krepšelio prekė:0-ne,1-taip| |
|N17_KREPS_KTG|C(1)|Krepšelio kategorija| |
|N17_KREPS_MIN|N(14)|Krepšelio minimumas| |
|N17_GARANT_POZ|N(1)|Ar yra garantija:0-ne,1-taip| |
|N17_GARANT_MEN|N(3)|Garantija mėnesiais| |
|N17_KODAS_KS3|C(12)|Garantija atlieka tiekėjas.Kliento kodas| |
|N17_TEMPER_POZ|N(1)|Temperatūros požymis:0-ne,1-taip| |
|N17_TEMPER_MAX|N(3)|Max temperatūra| |
|N17_TEMPER_MIN|N(3)|Min temperatūra| |
|N17_TEMPER_TXT|C(20)|Kitos laikymo sąlygos| |
|N17_SERTIF_POZ|N(1)|Ar reikia sertifikato:0-ne,1-taip| |
|N17_KODAS_MS|C(12)|Marketologo kodas(iš menedžerių sąrašo)| |
|N17_ANTKAINIS|N(6,2)|Antkainio procentas| |
|N17_MAX_NUOL|N(6,2)|Maksimalus nuolaidos procentas parduodant| |
|N17_EX_IM_FRAC|N(4)|Rezervas| |
|N17_G_TIME|N(6)|Rezervas| |
|N17_KODAS_OS|C(12)|Objekto kodas| |
|N17_VAZ_LAIK|N(4)|Vežimo laikas| |
|N17_UZS_LAIK|N(4)|Užsakymo laikas| |
|N17_PAP_LAIK|N(4)|Papildomas laikas| |
|N17_SAN_COST|N(10,2)|Sandėliavimo sąnaudos| |
|N17_UZS_COST|N(10,2)|Užsakymo sąnaudos| |
|N17_TRA_COST|N(10,2)|Transportavimo sąnaudos| |
|N17_MEN_PAV|C(150)|Pavadinimas skirtas menedžeriams| |
|N17_MUIT_KOD|C(16)|Muitinėje prekės kodas| |
|N17_SK_KODAS|N(2)|Prekės skyrius kasoje| |
|N17_INTERNET|N(1)|Interneto požymis:0-ne,1-taip| |
|N17_DUM_POZ|N(1)|Ar užsigulėjusi prekė:0-ne,1-taip| |
|N17_DUM_TIP|C(1)|Užsigulėjimo tipas| |
|N17_DUM_D_IN|T(8)|Kada pateko į užsigulėjimą| |
|N17_DUM_D_OUT|T(8)|Kada iškrito iš išsigulėjimo| |
|N17_MUITO_PROC|N(6,2)|Muito procentas| |
|N17_AKCIZO_PROC|N(6,2)|Akcizo procentas| |
|N17_PASTABOS|M(4)|Pastabos| |
|N17_POZ_DATE|N(1)|Terminuota:0-ne,1-taip| |
|N17_BEG_DATE|T(8)|Termino pradžia| |
|N17_END_DATE|T(8)|Termino pabaiga| |
|N17_USERIS|C(12)|Kas koregavo| |
|N17_R_DATE|T(8)|Kada koregavo| |
|N17_ADD_DATE|T(8)|Kada sukurta kortelė| |
|N17_ADDUSR|C(12)|Kas sukūrė| |
|N17_MIN_VISO|N(14)|Minimumas įmonės mastu| |
|N17_SERT_POZ|C(1)|Sertifikavimo požymis| |
|N17_KAT_POZ|C(1)|Kategorijos požymis| |
|N17_BROK_POZ|N(1)|Broko pozymis| |
|N17_KODAS_PS_G|C(12)|Geras prekės kodas| |
|N17_DATA_BR|T(8)|Iki kada_brokas| |
|N17_KODAS_VS_T|C(12)|Šalis tiekėja| |
|N17_KODAS_MS_A|C(12)|Analitikas| |
|N17_KODAS_MS_M|C(12)|Menedžeris| |
|N17_AR_NAUJA|N(1)|Ar nauja prekė| |
|N17_DATA_NAUJA|T(8)|Iki kada nauja| |
|N17_MIN_ANTK|N(6,2)|Minimalus antkainis| |
|N17_KODAS_LS_5|C(12)|Logistikos kodas 5| |
|N17_KODAS_LS_6|C(12)|Logistikos kodas 6| |
|N17_KODAS_LS_7|C(12)|Logistikos kodas 7| |
|N17_KODAS_LS_8|C(12)|Logistikos kodas 8| |
|N17_MIN_ANTK_UR|N(6,2)|Minimalus urminių kainų antkainis| |
|N17_MIN_ANTK_UR_D|T(8)|Minimalaus urminio antkainio galiojimas| |
|N17_MAX_ANTK|N(6,2)|Maksimalus antkainis| |
|N17_SVS_GALIOJA|N(1)|SVS-e būtina galiojimo data| |
|N17_SVS_GALIOJA_D|N(5)|SVS galiojimo dienos| |
|N17_SVS_PARTIJA|N(1)|SVS būtina partija: 0-Ne,1-Taip| |
|N17_PAV_K1|C(100)|Pavadinimas kita kalba 1| |
|N17_PAV_K2|C(100)|Pavadinimas kita kalba 2| |
|N17_PAV_K3|C(100)|Pavadinimas kita kalba 3| |
|N17_BUSENA|N(3,0)|Būsena| nuo v118.0200 |
|NUORODA|C(4000)|Nuoroda į dokumentą, failą ar paveiksliuką| |
|PAP_1, PAP_2...||Papildomi laukai|Veikia tik jei aprašyti Rivile Gama sistemoje|
