--- title: "Dovanų čekių panaudojimas naudojant Rivile REST API" url: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest/duk/duk_010_dovanu_cekiai" updated: "2026-03-19" parent: "https://gidas.rivile.lt/internetiniai_moduliai/api_rest/duk.md" --- # Dovanų čekių panaudojimas naudojant Rivile REST API #### Bendra informacija Rivile GAMA dovanų čekių panaudojimas per Rivile REST API susideda iš keturių žingsnių: 1. Patikrinimas ar dovanų čekis egzistuoja ir yra nepanaudotas. 2. Jei dovanų čekis nebuvo rastas arba jau panaudotas, tuomet kuriamas naujas dovanų čekis. 3. Dovanų čekio pardavimas. 4. Atsiskaitymas dovanų čekiu. > **Dėmesio:** 125.0000+DI Rivile GAMA programos versijoje praplėstos dovanų čekių pardavimų ir atsiskaitymų galimybės: \- galimybė dovanų čekio sumą nurodyti pardavimo metu, \- galimybė atsiskaitymo metu dalinai panaudoti dovanų čekį, o likusią suma panaudoti kitą kartą, #### Detalus veiksmų aprašymas ##### 1. Patikrinimas ar dovanų čekis egzistuoja ir yra nepanaudotas. Turint dovanų čekio numerį, pirmiausia reikia patikrinti ar jis yra Rivile sistemoje ir koks jo statusas. Dovanų čekio tikrinimas atliekamas naudojant **[GET_N77_LIST](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/get_n77_list.md)** metodą. **Užklausos pavyzdys :** ``` GET_N77_LIST n77_kodas_dc='CEKIS1' ``` **Atsakymo pavyzdys :** ``` 1 CEKIS1 Dovanų čekis 2021-06-26T00:00:00 0 01 100.00 0 2021-06-29T00:00:00 2021-06-29T00:00:00 0 0 0 0 1900-01-01T00:00:00 PASLXX VNT MASTER 2021-06-29T08:14:46 MASTER 2021-06-29T08:16:12 CEKIS1 01 0 0.00 0.00 0.00 MASTER 2021-06-29T08:15:58 1 0 1 1 ``` Jei dovanų čekis egzistuoja, API atsakymo rezultate matoma visa čekio informacija iš **N77_DC** ir **T78_DCL** lentų, bei panaudojimo informacija. Galimų veiksmų tagai (**pardavimas, atsiskaitymas, vidinis, nurasymas**) nurodo kokias operacijas galima atlikti su dovanų čekiu. Panaudojimo tagų reikšmės: - **„pardavimas“** – jei grąžinama reikšmė **1**, tai čekis dar neparduotas, juo atsiskaityti negalima, jį galima parduoti, jei **0**, tai čekio parduoti negalima, čekis parduotas; - **„atsiskaitymas“** – jei grąžinama reikšmė **1**, tai čekis yra jau parduotas ir juo galima atsiskaityti, jei **0**, tai čekiu atsiskaityti negalima; - **„vidinis“** – Jei grąžinama reikšmė **1**, tai su čekiu galima atlikti vidinę operaciją, jei **0**, tai su čekiu vidinės operacijos atlikti negalima; - **„nurasymas“** – Jei grąžinama reikšmė **1**, tai čekį galima nurašyti, jei **0**, tai čekio nurašyti negalima. **Jei visos galimų veiksmų tagų reikšmės 0, tai reiškia, kad dovanų čekis panaudotas ir su juo negalima atlikti jokių veiksmų.** Mūsų siūloma veiksmų seka: - Jei dovanų čekio Rivile sistemoje nėra, tačiau jis buvo sugeneruotas trečiųjų šalių programoje, tuomet dovanų čekį reikia sukurti Rivile programoje rankiniu būdu arba per Rivile REST API. Dovanų čekio sukūrimas aprašomas antrajame punkte. - Jei čekis egzistuoja Rivile sistemoje ir yra neparduotas, tuomet praleidžiamas antras punktas ir veiksmai atliekami nuo trečiojo punkto. - Jei čekis egzistuoja Rivile sistemoje ir yra parduotas bei juo galima atsiskaityti, tuomet praleidžiami antras ir trečias punktai, veiksmai atliekami nuo ketvirtojo punkto. ##### 2. Jei dovanų čekis nebuvo rastas arba jau panaudotas, tuomet kuriamas naujas dovanų čekis. Kai generuojamas naujas dovanų čekis arba čekis nerandamas Rivile sistemoje panaudojus Rivile REST API metodą **[GET_N77_LIST](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/get_n77_list.md)** pagal aktyvų trečiųjų šalių dovanų kodą, tuomet panaudojamas Rivile REST API dovanų čekio sukūrimo metodas **[EDIT_N77](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_n77.md)**. **Užklausos pavyzdys :** ``` EDIT_N77 I DC_0001 01 DC VNT 100 1 50 0 0 ``` **Atsakymo pavyzdys :** ``` 1 DC_0001 2023-10-25T10:56:36 0 01 100.00 0 2023-10-25T10:56:36 2023-10-25T10:56:36 1 50 0 0 1900-01-01T00:00:00 DC VNT … UCLO2XS 2023-10-25T10:56:36 0 0 DC_0001 01 0 0.00 0.00 0.00 UCLO2XS 2023-10-25T10:56:36 1 0 1 1 ``` **Rezultatas Rivile sistemoje :** ![dov_01](https://gidas.rivile.lt/user/pages/010.internetiniai_moduliai/10.api_rest/9999.duk/1000.duk_010_dovanu_cekiai/dov_01.png) Rivile REST API užklausoje kuriant dovanų čekį privaloma perduoti tagus: **N77_KODAS_DC**, **N77_KODAS_IS**, **N77_KODAS_AS**, **N77_KODAS_US**, **N77_NOMINALAS**. > **Įspėjimas:** **Jei Rivile programoje prie dokumentų skaitliukų aprašytas dovanų čekių skaitliukas, tuomet tagas N77_KODAS_DC yra neprivalomas.** **Paslaugos kodas N77_KODAS_AS ir N77_KODAS_US suderinamas su klientu.** Kuriant dovanų čekį su galiojimo data, yra privaloma perduoti du papildomus tagus **N77_GALIOJA** ir **N77_GALIOJA_D**. > **Įspėjimas:** **Nurodytas galiojimo dienų skaičius priklauso nuo dovanų čekio pardavimo operacijos datos, nes galiojimo dienų skaičius pridedamas prie pardavimo operacijos datos.** > **Dėmesio:** 125.0000+DI Rivile GAMA programos versijoje galimi 2 nauji laukai: \- N77_PR_TIPAS - Kintamas nominalas parduodant (0 - dovanų čekio nominalas fiksuotas, 1 - dovanų čekio pardavimo metu nurodoma jo suma) \- N77_MOK_TIPAS - Dalinis apmokėjimas (0 - dovanų čekį privaloma panaudoti vienu kartu, 1 - dovanų čekį galima panaudoti per kelis kartus) ##### 3. Dovanų čekio pardavimas Dovanų čekio pardavimas vykdomas, kai dovanų čekis yra aktyvus ir jį galima parduoti (**„pardavimas“ = 1**) .
Čekio pardavimas atliekamas per Rivile REST API naudojant dvi užklausas **[EDIT_I06_FULL](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i06_full.md)** ir **[EDIT_K78_FULL](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_k78_full.md)**.
Pirmiausia sukuriama pardavimo operacija panaudojant metodą **[EDIT_I06_FULL](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i06_full.md)**, nes reikalingas pardavimo operacijos numeris **I06_KODAS_PO**. Šis numeris reikalingas sąryšiui tarp dovanų čekių operacijų ir pardavimo operacijų.
Pardavimo operacijos tipas turi būti važtaraštis, kliento kodas suderinimas su klientu.
Detali pardavimo informacija apie paslaugos kodą, matavimo vienetą, padalinį ir sumą yra gaunama iš dovanų čekių, panaudojant Rivile REST API metodą **[GET_N77_LIST](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/get_n77_list.md)** arba **[EDIT_N77](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_n77.md)**. Laukų atitikmenys: - **I07_KODAS =** **N77_KODAS_AS** - **I07_KODAS_US_P = N77_KODAS_US** - **I07_KAINA_BE = N77_NOMINALAS** - **I07_KODAS_IS = N77_KODAS_IS** - **I07_PAV =** **N77_KODAS_DC** **Jei dovanų čekis yra apmokėtas, tai pardavimo operacijoje reikia nurodyti tarpinę apmokėjimo sąskaitą, kuri yra suderinama su klientu.** Plačiau apie EDIT_I06_FULL metodą aprašyta: [EDIT_I06_FULL](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i06_full.md). **Užklausos pavyzdys :** ``` EDIT_I06_FULL 01 51 PARD231025001 2023.10.25 2023.10.25 2 PARD231025001 2 DC 01 100 DC_0001 VNT 1 2721 100 ``` **Atsakymo pavyzdys :** ``` 010R00000301 1 51 0 0 PARD231025001 0 2023-10-25T00:00:00 2023-10-25T00:00:00 01 … PARD23102500 2.00 … 010R00000301 1 2721 100.00 0.00 … 010R00000301 1 2 DC DC_0001 01 VNT 1 1 VNT VNT … 0.0000 0.00 100.0000 100.0000 … 1 0.00 0.00 100.00 … ``` Pardavimuose sėkmingai suformavus dovanų čekio pardavimo operaciją ir gavus **I06_KODAS_PO** reikšmę, reikia kurti dovanų čekio pardavimo operaciją (dovanų čekių operacijose) panaudojant Rivilės REST API metodą **[EDIT_K78_FULL](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_k78_full.md)**.
Šiame metode taip pat reikės panaudoti gautas dovanų čekio ir pardavimo operacijos reikšmes: padalinio kodą, dovanų čekio numerį, pardavimo operacijos numerį, kliento kodą. Laukų atitikmenys: - **K78_KODAS_KS =** **I06_KODAS_KS** - **K78_KODAS_IS_1 = N77_KODAS_IS** - **K78_MOD = ”RO” (Visada RO, nes toks pardavimo modulio kodas)** - **K78_KODAS_OP = I06_KODAS_PO** - **K79_KODAS_DC = N77_KODAS_DC** Jeigu dovanų čekyje uždėtas požymis "**Kintantis nominalas parduodant**", jo vertė prilyginama sumai, už kurią jis buvo parduotas (K79_SUMA). Priešingu atveju, t.y. kai šis požymis neuždėtas, nesvarbu už kokią kainą jis parduodamas ar netgi dovanojamas, jo vertė prilyginama nominalo sumai (K79_NOMINALAS). > **Dėmesio:** Galimybė parduodant dovanų čekį nurodyti jo vertę prieinama nuo 125.0000+DI Rivile GAMA programos versijos. **Užklausos pavyzdys :** ``` EDIT_K78_FULL 01 01 DC231025001P 2023.10.25 RO 010R00000301 DC_0001 100.00 ``` **Atsakymo pavyzdys :** ``` 010R00000021 1 2023-10-25T00:00:00 DC231025001P 01 01 RO 010R00000301 … 010R00000021 1 DC_0001 100.00 100.00 … ``` **Sėkmingai suformavus pardavimo ir dovanų čekio pardavimo operacijas, jas privaloma perkelti panaudojant Rivile REST API metodus [EDIT_I06](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i06.md) ir [EDIT_K78](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_k78.md).** **Užklausos pavyzdys :** ``` EDIT_I06 P 010R00000301 EDIT_K78 P 010R00000021 ``` ##### 4. Atsiskaitymas dovanų čekiu. Atsiskaitymas dovanų čekiu vykdomas, kai dovanų čekis yra aktyvus ir juo galima atsiskaityti (**„atsiskaitymas“ = 1**) . Čekio pardavimas atliekamas per Rivile REST API naudojant dvi užklausas **[EDIT_I06_FULL](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i06_full.md)** ir **[EDIT_K78_FULL](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_k78_full.md)**. Pirmiausia, naudojant **[EDIT_I06_FULL](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i06_full.md)** metodą sukuriama pardavimo operacija, kurioje yra naudojamas Rivile dovanų čekis.
Sukūrus pardavimo operaciją, bus gautas operacijos numeris **I06_KODAS_PO**. Šis numeris reikalingas sąryšiui tarp dovanų čekių operacijų ir pardavimo operacijų.
Pardavimo operacija turi būti dalinai arba pilnai apmokėta, tai priklauso nuo operacijos apmokėjimo statuso sistemoje, iš kurios bus keliama informacija, operacijos tipas turi būti važtaraštis.
Pardavimo dokumento apmokėjimo (dovanų čekio) informacija gaunama panaudojant Rivile REST API metodą **[GET_N77_LIST](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/get_n77_list.md)**. **Dovanų čekio buhalterinė sąskaita I13_KODAS_SS suderinama su Rivile klientu.** **Panaudota dovanų čekio suma ir jo numeris nurodomi I13 taguose.** Laukų atitikmenys: - **I13_PAV =** **N77_KODAS_DC** - **I13_SUMA = N77_NOMINALAS** **Užklausos pavyzdys :** ``` EDIT_I06_FULL 01 51 PARD231025003 2023.10.25 2023.10.25 2 PARD231025001 1 005 01 150 VNT 1 277 100 DC_0001 ``` **Atsakymo pavyzdys :** ``` 010R00000303 1 51 0 0 PARD231025003 0 2023-10-25T00:00:00 2023-10-25T00:00:00 MINDAUGAS 03 … PARD23102500 2.00 .. 010R00000303 1 277 100.00 0.00 DC_0001 … 010R00000303 1 1 005 HDD … ``` Pardavimuose sėkmingai suformavus pardavimo operaciją, kurioje dalinai arba pilnai atsiskaitoma dovanų čekiu, gaunamas pardavimo operacijos numeris **I06_KODAS_PO**. Gavus šį operacijos numerį formuojama dovanų čekio atsiskaitymo operacija (dovanų čekių operacijose) panaudojant Rivile REST API metodą **[EDIT_K78_FULL](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_k78_full.md)**.
Šiame metode taip pat reikės panaudoti gautas dovanų čekio ir pardavimo operacijos reikšmes: padalinio kodą, dovanų čekio numerį, pardavimo operacijos numerį, kliento kodą. Laukų atitikmenys: - **K78_KODAS_KS =** **I06_KODAS_KS** - **K78_KODAS_IS_1 = N77_KODAS_IS** - **K78_MOD = ”RO” (Visada RO, nes toks pardavimo modulio kodas)** - **K78_KODAS_OP = I06_KODAS_PO** - **K79_KODAS_DC = N77_KODAS_DC** Kuriant atsiskaitymo operaciją reikia nurodyti **K78_TIPAS=2** (atsiskaitymas). Jeigu dovanų čekio aprašyme pažymėtas laukas "**Dalinis apmokėjimas**", juo atsiskaitant galima nurodyti dovanų čekio apmokėjimo sumą (K79_SUMA) - jei dovanų čekio suma panaudojama dalinai, likusią sumą bus galima panaudoti sekantį kartą. Priešingu atveju, t.y. kai šis laukas nepažymėtas, jeigu perkama už mažesnę sumą, nei dovanų čekis, vis tiek sunaudojamas visas dovanų čekis - neišnaudota dalis apskaitoje neužfiksuojama. > **Dėmesio:** Galimybė dovanų čekį panaudoti per kelis kartus atsirado nuo **125.0000+DI** „Rivile GAMA“ programos versijos. > **Įspėjimas:** Nurodomą panaudoto dovanų čekio sumą reikia įvesti su minuso ženklu **Užklausos pavyzdys :** ``` EDIT_K78_FULL 01 2 01 DC231025002A 2023.10.25 RO 010R00000303 DC_0001 -100.00 ``` **Atsakymo pavyzdys :** ``` 010R00000023 2 2023-10-25T00:00:00 DC231025002A 01 01 … 010R00000023 1 DC_0001 100.00 -100.00 … ``` **Dėmesio! Sėkmingai suformavus pardavimo ir dovanų čekio pardavimo operacijas jas privaloma perkelti panaudojant Rivilės REST API metodus [EDIT_I06](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_i06.md) ir [EDIT_K78](https://gidas.rivile.lt/internetiniai_moduliai/api_rest/edit_k78.md).** **Užklausos pavyzdys :** ``` EDIT_I06 P 010R00000303 EDIT_K78 P 010R00000023 ```