---
title: "MGAMA_EDIT_K16_ATPRA"
url: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest/api_mgama_edit_k16_atpra"
updated: "2026-03-19"
parent: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest.md"
---

# MGAMA_EDIT_K16_ATPRA

### Aprašymas

Personalo atostogų pratęsimo operacijų dokumentų 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` : `MGAMA_EDIT_K16_ATPRA`
* `params` :
  * `oper` :
    * `I` - naujo įrašo sukūrimas (numatytasis)
    * `U` - dokumento koregavimas
    * `D` - dokumento ištrynimas
    * `P` - dokumento perkėlimas
* `data`: perduodami duomenys:
  * `K16` - Personalo operacijų antraštė ([k16](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/api_mgama_edit_k16_priem#k16))

> **Dėmesio:** Koreguoti galima tik to paties API vartotojo sukurtas operacijas. Teisės valdomos parametru RGI_ALL_EDIT

> **Įspėjimas:** Kadangi darbuotojų kortelėse gali būti saugoma konfidenciali informacija, jau egzistuojančių įrašų nuskaitymui ir koregavimui būtinas papildomas leidimas per Rivile Gama parametrą RGI_K14_FIL. Šiame parametre įvedamas papildomas filtravimas, galimų reikšmių pavyzdžiai: 1=1 (visos darbuotojų kortelės), K14_KODAS_LS_1='L1' (tik darbuotojų kortelės su pirmu logistikos kodu 'L1'). Filtravimo sąlygose galima naudoti visus lentelės K14 laukus.

**XML Request pvz.:**

```xml
<body>
  	<method>MGAMA_EDIT_K16_ATPRA</method>
	<params>
		<oper>I</oper>
	</params>
	<data>
        <K16>
            <K16_KODAS_6A_S>00R000000001</K16_KODAS_6A_S>
            <K16_SUT_NR>00R000000100</K16_SUT_NR>
            <K16_end_date>2024-05-15</K16_end_date>
        </K16>
	</data>
</body>
```

**JSON Request pvz.:**

```json
{
	"method": "MGAMA_EDIT_K16_ATPRA",
	"params": {
		"oper": "I"
	},
	"data": {
		"K16": {
			"K16_KODAS_6A_S": "00R000000001",
			"K16_SUT_NR": "00R000000100",
			"K16_end_date": "2024-05-15"
		}
	}
}
```

##### Response (status 200 OK)

**XML response pvz.:**

```xml
<RET_DOK>
	<K16_OPH>
		<K16_KODAS_6A>000R00016301</K16_KODAS_6A>
		<K16_KODAS_6A_S>000R00016299</K16_KODAS_6A_S>
		<K16_BEG_DATE>2024-06-12T00:00:00</K16_BEG_DATE>
		<K16_DIENOS_SV>0.000</K16_DIENOS_SV>
		<K16_DIENU_SK>10.000</K16_DIENU_SK>
		<K16_DOK_NR>6AATP0000246</K16_DOK_NR>
		<K16_END_DATE>2024-06-21T00:00:00</K16_END_DATE>
		<K16_KODAS_0A>555         </K16_KODAS_0A>
		<K16_KODAS_1A_19>           </K16_KODAS_1A_19>
		<K16_KODAS_1A_25>           </K16_KODAS_1A_25>
		<K16_KODAS_4A>001         </K16_KODAS_4A>
		<K16_KODAS_5A>           </K16_KODAS_5A>
		<K16_KODAS_IS>999999999999</K16_KODAS_IS>
		<K16_OP_DATE>2024-04-30T00:00:00</K16_OP_DATE>
		<K16_PAV>v1 p1(darbuotojas r1)                                       </K16_PAV>
		<K16_RUSIS>1</K16_RUSIS>
		<K16_SUT_NR>000R00016300</K16_SUT_NR>
		<K16_PERKELTA>1</K16_PERKELTA>
		<K16_ADDUSR>999     </K16_ADDUSR>
		<K16_R_DATE>2024-04-30T12:10:09</K16_R_DATE>
		<K16_USERIS>999     </K16_USERIS>
	</K16_OPH>
</RET_DOK>
```

**JSON response pvz.:**

```xml
{
	"K16_OPH": {
		"K16_KODAS_6A": "000R00016302",
		"K16_KODAS_6A_S": "000R00016299",
		"K16_BEG_DATE": "2024-06-12T00:00:00",
		"K16_DIENOS_SV": 0,
		"K16_DIENU_SK": 10,
		"K16_DOK_NR": "6AATP0000247",
		"K16_END_DATE": "2024-06-21T00:00:00",
		"K16_KODAS_0A": 555,
		"K16_KODAS_1A_19": "",
		"K16_KODAS_1A_25": "",
		"K16_KODAS_4A": "001",
		"K16_KODAS_5A": "",
		"K16_KODAS_IS": 999999999999,
		"K16_OP_DATE": "2024-04-30T00:00:00",
		"K16_PAV": "v1 p1(darbuotojas r1)",
		"K16_RUSIS": 1,
		"K16_SUT_NR": "000R00016300",
		"K16_PERKELTA": 1,
		"K16_ADDUSR": "999",
		"K16_R_DATE": "2024-04-30T12:10:38",
		"K16_USERIS": "999"
	}
}
```

##### Response (status 400)

Klaida paduodant duomenis / SQL sintaksinės klaidos / kitos duomenų klaidos, pvz.:

```xml
<?xml version='1.0' encoding='UTF-8'?>
<RET_DOK>
	<id>4641133481.72d6d4a8.1714466326905</id>
	<durationMs>497</durationMs>
	<errorMessage>Nepavyko įvykdyti metodo</errorMessage>
	<document/>
	<errors>
		<error>
			<data>&lt;K16>&lt;num_row>1&lt;/num_row>&lt;/K16></data>
			<dataErrors>
				<dataError>
					<tag>K16_KODAS_6A_S</tag>
					<code>19013</code>
					<message>Nenurodytas kodas</message>
				</dataError>
				<dataError>
					<tag>K16_BEG_DATE</tag>
					<code>15012</code>
					<message>Bloga reiksmė</message>
				</dataError>
				<dataError>
					<tag>K16_END_DATE</tag>
					<code>15012</code>
					<message>Bloga reiksmė</message>
				</dataError>
				<dataError>
					<tag>K16_KODAS_4A</tag>
					<code>19013</code>
					<message>Nenurodytas kodas</message>
				</dataError>
				<dataError>
					<tag>K16_KODAS_0A</tag>
					<code>19013</code>
					<message>Nenurodytas kodas</message>
				</dataError>
				<dataError>
					<tag>K16_KODAS_IS</tag>
					<code>19013</code>
					<message>Nenurodytas kodas</message>
				</dataError>
				<dataError>
					<tag>K16_DIENU_SK</tag>
					<code>15012</code>
					<message>Bloga reiksmė</message>
				</dataError>
				<dataError>
					<tag>K16_DIENU_SK</tag>
					<code>21006</code>
					<message>Negalima neigiama reikšmė</message>
				</dataError>
				<dataError>
					<tag>K16_SUT_NR</tag>
					<code>19013</code>
					<message>Nenurodytas kodas</message>
				</dataError>
			</dataErrors>
		</error>
	</errors>
</RET_DOK>
```



### Koregavimas ir trynimas

Koregavimas ir trynimas vyksta pagal atitinkamos lentelės raktą (Primary Key).

Koreguojant informaciją bus koreguojami tik perduodami laukai.

**Pvz. koregavimas:**

```xml
<body>
  	<method>MGAMA_EDIT_K16_ATPRA</method>
	<params>
		<oper>U</oper>
	</params>
	<data>
		<K16>
			<K16_KODAS_6A>000000000001</K16_KODAS_6A>
			<K16_apr>PAKEITIMAI</K16_apr>
		</K16>
	</data>
</body>
```

**Pvz. trynimas:**

```xml
<body>
  	<method>MGAMA_EDIT_K16_ATPRA</method>
	<params>
		<oper>D</oper>
	</params>
	<data>
		<K16>
			<K16_KODAS_6A>000000000001</K16_KODAS_6A>
		</K16>
	</data>
</body>
```



### PHP pavyzdys:

```php
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'ApiKey: 999.987654321',
      'Content-Type: application/json',
      ]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{
    "method": " MGAMA_EDIT_K16_ATPRA ",
    "params": {
        "oper": "I"
    },
    "data": {
        "K16": {
			"K16_KODAS_6A_S": "00R000000001",
			"K16_SUT_NR": "00R000000100",
			"K16_end_date": "2024-05-15"
		}
}
}');
$response = curl_exec($ch);
curl_close($ch);
```



### Lentelės

#### K16

Personalo atostogų pratęsimo dokumentų antraštės lentelė

| Laukas          | Tipas         | Aprašymas                          | Pastabos naudojant EDIT metodą                               |
| --------------- | ------------- | ---------------------------------- | ------------------------------------------------------------ |
| K16_APR         | varchar(200)  | Aprašymas                          |                                                              |
| K16_BEG_DATE    | datetime      | Atostogų  pratęsimo pradžios data  | Lauką  būtina užpildyti, kai parametro "oper" reikšmė = I; t.y. kai  vykdoma įterpimo operacija |
| K16_DIENOS_SV   | numeric(12,3) | Nedarbo dienų skaičius             | Informacinis laukas, užsipildo  automatiškai                 |
| K16_DIENU_SK    | numeric(12,3) | Atostogų  pratęsimo dienų skaičius | Būtinas,  jeigu nėra pateikta END_DATE reikšmė. Jeigu pateikta ir END_DATE, ir DIENU_SK  reikšmės, tai pratęsimo laikotarpis skaičiuojamas pagal DIENU_SK |
| K16_DOK_NR      | char(12)      | Dokumento numeris                  | Būtina užpildyti, jeigu  parametro oper reikšmė yra "I" ir nėra aprašytas personalo priėmimo  operacijų dokumentų skaitliukas |
| K16_END_DATE    | datetime      | Atostogų  pratęsimo pabaigos data  | Būtinas,  jeigu nėra pateikta DIENU_SK reikšmė. Jeigu pateikta ir END_DATE, ir DIENU_SK  reikšmės, tai pratęsimo laikotarpis skaičiuojamas pagal DIENU_SK |
| K16_KODAS_0A    | char(12)      | Etatas                             | Informacinis laukas, užsipildo  automatiškai pagal informaciją iš priėmimo operacijos, nurodytos lauke  KODAS_6A_S |
| K16_KODAS_1A_19 | char(12)      | Atostogų  tipas                    | Informacinis  laukas, užsipildo automatiškai pagal informaciją iš priėmimo operacijos,  nurodytos lauke KODAS_6A_S |
| K16_KODAS_1A_25 | char(12)      | Algos klasifikatorius              |                                                              |
| K16_KODAS_4A    | char(12)      | Personalo  kodas                   | Laukas  apdorojime užsipildo automatiškai pagal informaciją iš priėmimo operacijos,  nurodytos lauke KODAS_6A_S. Jeigu nenurodytas K16_KODAS_6A_S ir K16_KODAS_6A_F, tai pagal K16_KODAS_4A surandama aktyvi priėmimo operacija. Aktyvių priėmimo operacijų turi būti ne daugiau 1, kitu atveju gaunama klaida. |
| K16_KODAS_5A    | char(12)      | Specialybė                         | Informacinis laukas, užsipildo  automatiškai pagal informaciją iš priėmimo operacijos, nurodytos lauke  KODAS_6A_S |
| K16_KODAS_6A    | char(12)      | Operacijos  numeris                | Būtina  užpildyti, kai užklausos parametras "oper" = U, D; t.y. kai vykdoma  koregavimo arba trynimo operacija |
| K16_KODAS_6A_S  | char(12)      | Priėmimo operacija                 | Lauką būtina užpildyti, kai  parametro "oper" reikšmė = I ir darbuotojas (K16_KODAS_4A) turi daugiau nei 1 aktyvią priėmimo operaciją. |
| K16_KODAS_6A_F  | char(12)      | Pirminė priėmimo operacija         | Jeigu nenurodytas K16_KODAS_6A_S, tai pagal K16_KODAS_6A_F surandama aktyvi priėmimo operacija. Aktyvių priėmimo operacijų turi būti ne daugiau 1, kitu atveju gaunama klaida. |
| K16_KODAS_IS    | char(12)      | Padalinys                          | Informacinis  laukas, užsipildo automatiškai pagal informaciją iš priėmimo operacijos,  nurodytos lauke KODAS_6A_S |
| K16_OP_DATE     | datetime      | Operacijos data                    | Jeigu nieko nenurodoma, laukas  užpilodmas automatiškai šiandienos data |
| K16_PAV         | varchar(200)  | Personalo  vardas, pavardė         | Laukas  apdorojime užsipildo automatiškai pagal informaciją iš priėmimo operacijos,  nurodytos lauke KODAS_6A_S |
| K16_RUSIS       | numeric(1,0)  | Operacijos rūšis                   | 1 - Dokumentas, 2 - prašymas.  Jeigu nieko nenurodoma, laukas užpilodmas reikšme 1. |
| K16_SUT_NR      | char(12)      | Atostogų  operacija                | Lauką  būtina užpildyti, kai parametro "oper" reikšmė = I; t.y. kai  vykdoma įterpimo operacija |
| K16_USERIS      | char(12)      |                                    | Administracinė informacija - kas  sukūrė arba kas paskutinis koregavo operaciją |
| K16_PERKELTA    | numeric(1,0)  |                                    | Perkėlimo  požymis:1-neperkelta,2-perkelta,3-koreguota       |
| K16_ADDUSR      | char(50)      |                                    | Administracinė informacija - kas  sukūrė operaciją           |
| K16_R_DATE      | datetime      |                                    | Administracinė  informacija - kada paskutinį kartą buvo koreguota operacija |
| K16_TIPAS       | numeric(3,0)  | Operacijos  tipas                  | Informacinis  laukas, užsipildo automatiškai                 |