Canonical: https://verslomatika.lt/integracijos/rivile/

Autorius: MB Pinet komanda (https://verslomatika.lt/apie-mus/)

Paskelbimo data: 2026-10-25T17:55:07.502Z

# Rivilė integracija: sklandus sąskaitų, likučių ir sandėlio duomenų apsikeitimas


Rivilės integracija pradedama nuo konkretaus produkto nustatymo. Rivilė GAMA ir Rivilė ERP nėra viena universali API. Šiame pavyzdyje remiamės GAMA API v2; jo metodų ir diegimo sąlygų negalima automatiškai priskirti kitam produktui.


## GAMA API v2 sąlygos


[Oficialiame GAMA gide](https://gidas.rivile.lt/internetiniai_moduliai/api_rest) nurodoma užsakoma API paslauga, versijų prieigos sutartis, tinkama GAMA versija ir Manorivile-Gateway ryšio kanalas. Sąlygos tikrintos 2026-10-24. Tikslūs aplinkos reikalavimai sutikrinami prieš diegiant; viešas metodų sąrašas nesuteikia prieigos prie duomenų bazės.


## Produktas ir jungties paskirtis


| Klausimas | Ką užrašyti prieš darbą |
| --- | --- |
| Koks produktas? | GAMA ar ERP, konkreti versija |
| Kokia operacija? | Skaityti prekes, likučius, dokumentus ar keisti įrašą |
| Koks metodas? | Būtent tos operacijos dokumentuotas metodas |
| Kas valdo duomenį? | Apskaita, sandėlis ar kita patvirtinta sistema |
| Kas priima rezultatą? | Įgaliotas apskaitos ar sandėlio naudotojas |


GAMA sąraše `GET_N17_LIST` skirtas prekių ir paslaugų sąrašui. Tai nėra universali sąskaitų kūrimo operacija. Keitimo teisės ir duomenų struktūra vertinamos atskirai.


## Iliustracinė saugi skaitymo pradžia


Bandymo konfigūracija prašo riboto prekių sąrašo ir fiksuoja gautų įrašų identifikatorius. Tuomet tikrinama, ar laukai atitinka pasirinktą įmonę ir koduotę. Toks bandymas neįrodo dokumentų įrašymo ar likučių keitimo.


[XML ir JSON pavyzdžiuose](https://verslomatika.lt/assets/rivile-gama-skaitymo-pavyzdziai.json) atskiriamas dokumentuotas užklausos apvalkalas ir vidiniai normalizuoti duomenys. Paslaptys pateikiamos tik vietaženkliais. ERP jungčiai naudojama jos atskira dokumentacija; GAMA konfigūracija nekopijuojama.


## Klaidos ir priėmimas


Tikrinkite trūkstamą teisę, netinkamą filtrą, koduotę, tuščią rezultatą ir ryšio sutrikimą. Tuščias sąrašas ne visada reiškia, kad duomenų nėra – gali būti netinkama įmonė ar filtras. Prieš kartojant keitimo operaciją sutikrinkite jos faktinę baigtį, kad nesukurtumėte dublikato.


Galutinį laukų ir operacijos atitikimą priima apskaitos savininkas. [Sąskaitų sprendime](https://verslomatika.lt/sprendimai/saskaitu-valdymas/) aprašytos patikros prieš perdavimą.


[Aptarti Rivilės jungtį](https://verslomatika.lt/kontaktai/)


## Šaltiniai ir dokumentacija
- [Rivilė: GAMA API v2 reikalavimai, Gateway ir metodų sąrašas](https://gidas.rivile.lt/internetiniai_moduliai/api_rest) (šaltinis peržiūrėtas 2026-10-24)
- [Rivilė: Body: method, params.list, pagenumber; XML / JSON pavyzdžiai ir RET_DOK](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/get_n17_list) (šaltinis peržiūrėtas 2026-10-24)