Rivile API v2 parametrai

Parametras	Aprašymas
RGI_A02_FIL	API Algos kintamųjų reikšmių filtravimas
RGI_A06_FIL	API Algos darbuotojų filtravimas
RGI_ALL_EDIT	API leidimas koreguoti visas operacijas
RGI_K14_FIL	API Personalo sąrašo filtravimas
RGI_KRED_LIM	API kredito limito kontroliavimas
RGI_MINUSLIK	(WS) Neigiami likučiai (i17)
RGI_N08_UNIK	API pasikartojantys įmonės kodai
RGI_SUDENG	API skolų sudengimas
RGI_USR_EDIT	API vartotojo kodo perdavimas
RGI_RAK	API įrašų rakinimas

RGI_A02_FIL

API Algos kintamųjų reikšmių filtravimas

Jeigu neužpildytas šis parametras, algos kintamųjų reikšmių nuskaitymo ir koregavimo API metodai neprieina prie jokių duomenų.

Šiems metodams prienami tik duomenys, kurie tenkina parametre aprašytą sąlygą.

RGI_A06_FIL

API Algos darbuotojų filtravimas

Jeigu neužpildytas šis parametras, darbuotojų kortelių nuskaitymo ir koregavimo API metodai neprieina prie jokių duomenų.

Šiems metodams prienami tik duomenys, kurie tenkina parametre aprašytą sąlygą.

Sąlygoje gali būti naudojami laukai iš a06_tab, a07_tabp,a08_tabb lentelių.

RGI_ALL_EDIT

API leidimas koreguoti visas operacijas

Parametras nustato kokias operacijas pardavimų, pirkimų, vidinių bei atsargų moduliuose gali koreguoti API serviso vartotojas.

Jeigu parametras nenustatytas, - standartiškai API vartotojas (pirmi 7 API rakto simboliai) gali koreguoti tik savo sukurtas operacijas (kur add_user yra API vartotojas).

Jeigu norima leisti API vartotojui koreguoti "ne savo" operacijas, tuomet parametre įvedamos atitinkamos reikšmės:

• Modulis - konkretus modulis (pardavimų, pirkimų, vidinių, atsargų) arba "bendras"
• Vartotojas - API rakto vartotojas arba visiems API raktams (paliekama tuščia)
• Gali koreguoti - Taip / Ne

Pvz., taip aprašoma galimybė koreguoti tik savo operacijas visuose moduliuose, išskyrus pardavimus, kur APIKEY1 raktas gali koreguoti visų vartotojų operacijas:

RGI_K14_FIL

API Personalo sąrašo filtravimas

Jeigu neužpildytas šis parametras, personalo kortelių nuskaitymo ir koregavimo API metodai neprieina prie jokių duomenų.

Šiems metodams prienami tik duomenys, kurie tenkina parametre aprašytą sąlygą.

RGI_KRED_LIM

API kredito limito kontroliavimas

Kredito limito kontrolė veikia taip pat, kaip Rivile GAMOJE, t.y. neleidžia įkelti įrašo, jeigu yra viršytas skolos kredito limitas.

Parametru galima nustatyti, kad skolos limitas nebūtų kontroliuojamas.

RGI_MINUS_LIK

(WS) Neigiami likučiai (i17)

Parametras nustato, ar einamieji prekių likučiai gali būti neigiami.

RGI_N08_UNIK

API pasikartojantys įmonės kodai

Parametras nustato ar kuriant naujas klientų korteles, jų įmonės kodai turi būti unikalūs.

RGI_SUDENG

API skolų sudengimas

Rivile GAMA 116 versijoje padaryta automatinė skolų sudengimo sistema, kuri leidžia automatiškai sudengti Klientų skolas perkeliant Pirkimų, Pardavimų arba Mokėjimų operacijas.

Jeigu kliento kortelėje nustatytas automatinis skolų sudengimas pagal "Parinktus dokumentus" arba "Visus dokumentus" ir dokumentas yra perkeliamas naudojant Rivile API v2, visada atsižvelgiama į parametro RGI_SUDENG reikšmę.

Pirmoji parametro reikšmė nurodo, ar leisti perkelti dokumentus neatliekant sudengimo.

Antroji parametro reikšmė nurodo, ar pildyti "Pirminio Dok. Nr." lauką Pardavimų / Pirkimų operacijoje kuriant naują dokumentą ir naudojant Rivile API v2. Jeigu parametro reikšmė "Taip", užklausoje nepadavus Pirminio Dok. Nr, jis bus užpildomas automatiškai ir bus lygus "Dokumento Nr.".

Jeigu parametras nenustatytas - standartiškai API vartotojas (pirmi 7 API rakto simboliai) negali perkelti operacijos, jeigu kliento kortelėje nurodytas sudengimas pagal "Parinktus dokumentus" arba "Visus dokumentus".

Jeigu norima leisti API vartotojui leisti perkelti operacijas nesudengiant dokumentų, tuomet parametre įvedamos atitinkamos reikšmės:

• Modulis - konkretus modulis (pardavimų, pirkimų, vidinių, atsargų) arba "bendras";
• Vartotojas - API rakto vartotojas arba visiems API raktams (paliekama tuščia);
• Leisti perkelti nesudengiant - Taip / Ne
• Pildyti neužpildytą pirminį Dok. Nr. lauką - Taip / Ne

RGI_USR_EDIT

API vartotojo kodo perdavimas

Parametras nustato ar per API galima perduoti vartotojo kodą (user). Pagal vartotojo kodą parenkami parametrai, skaitliukai ir kt.

Procedūras iškviečiant tiesiogiai iš Rivile GAMA, vartotojas automatiškai bus tas, kokiu vardu prisijungta į Rivile GAMA - standartiškai veiks jam priskirti parametrai, skaitliukai ir pan.

Iškviečiant procedūras per API, galima nurodyti vartotoją (user), tačiau jis suveiks tik tuo atveju, jei rakto prefiksui bus įjungtas šis parametras .

RGI_RAK

API įrašų rakinimas

Parametras skirtas užtikrinti duomenų vientisumą, kai su tais pačiais įrašais vienu metu dirbama per Rivile GAMA ir Rivile API. Kai parametras išjungtas, per API atliekami veiksmai netikrina sisteminių rakinimų. Įjungus šį parametrą, operacijų vykdymas per API užrakins susijusius duomenis iki veiksmo pabaigos bei atsižvelgs į jau esamus rakinimus Rivile GAMA pusėje. Ši apsauga veikia abiem kryptimis: kol įrašas yra modifikuojamas per API, Rivile GAMA vartotojai į jį užeiti negali ir mato standartinį pranešimą apie kito vartotojo užrakintą operaciją.

Jei operaciją ar normatyvą tuo pat metu koreguoja kitas vartotojas (nesvarbu, per programą ar su kitu API raktu), API grąžins klaidą: „423: Įrašas užrakintas kito vartotojo [VARTOTOJAS]. Bandykite vėliau“. Kadangi tai yra laikinojo pobūdžio klaida, tokią užklausą rekomenduojama programiškai pakartoti po kurio laiko.