---
title: "Integracijos diegimas"
url: "https://gidas.rivile.lt/integraciniai_sprendimai/el_parduotuves/pigult/integracijos_diegimas"
updated: "2026-02-09"
parent: "https://gidas.rivile.lt/integraciniai_sprendimai/el_parduotuves/pigult.md"
---
# Integracijos diegimas
Pagrindiniai diegimo žingsniai :
- Manorivile-Gateway įdiegimas. Instrukcija kaip tai atlikti pateikta [internetiniai_moduliai/api_rest/manorivile-gateway](https://gidas.rivile.lt/internetiniai_moduliai/api_rest.md#manorivile-gateway).
- Importo programos įrašymas;
- Parametrų ir dokumentų skaitliukų aprašymas;
- Programos parametrų priderinimas pagal kliento poreikį;
- Importui reikalingo klavišo užprogramavimas.
#### Importo programos įrašymas.
Su UAB "Rivile" ar atstovais sudaroma sutartis dėl importo iš Pigu.lt užprogramavimo.
Į RIV_GAMA katalogą įrašoma importo programa.
[Programų atsisiuntimas (Konsultantams ir atstovams): ](https://manorivile.sharepoint.com/:u:/r/sites/rivilefiles/Shared%20Documents/Downloads/Rivile%20EPI/imp_pigult_api-latest.zip?download=1)
#### Parametrų ir dokumentų skaitliukų aprašymas.
Rivile GAMA sistemoje aprašomi ir užpildomi:
- specialūs, importui reikalingi parametrai,
- parametras "Padalinio kodas pagal nutylėjimą",
- aprašomas pardavimo dokumentų skaitliukas,
- aprašomas klientų kodų skaitliukas (jei bus kuriami klientai).
Parametrai ir skaitliukai gali būti priskirti tik konkrečiam vartotojui.
> **Įspėjimas:** Vartotojo vardas, kuriuo leidžiamas importas, yra Rivilės API rakto simboliai iki taško.
> **Dėmesio:** Parametrų sąraše kurti naujų parametrų nereikia. Jie susikurs automatiškai, pirmą kartą paspaudus užprogramuotą importo klavišą.
> **Įspėjimas:** Dėl prisijungimo informacijos reikia kreiptis į Pigu.lt . Jie suteikia prisijungimo vartotojo vardą ir slaptažodį.
Pigu.lt vartotojui turi įjungti web servisus.
| Parametras | Aprašymas |
| --------------- | ------------------------------------------------------------ |
| **PIGULT_RIV** | Rivile API (web service) raktas |
| **PIGULT_USER** | Pigu.lt prisijungimo duomenys (pvz.,user123 password123 ) - kad suteiktų, reikia kreiptis į Pigu.lt |
Iš anksto nesukūrus parametrų ir pirmą kartą iškvietus importą, programa praneš, kad neaprašyti parametrai. Parametrai susikurs automatiškai, reikės aprašyti jų reikšmes.
#### Programos parametrų priderinimas pagal kliento poreikį.
Importo programoje naudojami tam tikri parametrai. Keičiant jų reikšmes, importo programą galima lanksčiai priderinti prie kliento poreikių.
| Parametras | Reikšmė pagal nutylėjimą | Aprašymas |
| ---------------------- | --------------------------------------------------- | ------------------------------------------------------------ |
| **nuo_datos** | DATE()-30 | Nurodoma nuo kada skaityti pardavimų informaciją (pvz: už paskutines 5 dienas arba už paskutines 30 dienų) |
| **kliento_kodas** | '' | Kliento kodas, kai visi pardavimai registruojami vienam klientui |
| **kliento_rysys** | 'PT001' | Kliento sąskaitų ryšio kodas pagal nutylėjimą |
| **kliento_mokesciai** | 'PVM0' | Kliento mokesčio kodas pagal nutylėjimą |
| **kliento_info** | '' | Kliento papildoma informacija kuriant kliento kortelę. Pavyzdžiui: `"WEB"` |
| **mokesciai** | '' | Galimybė taikyti mokesčio kodą pagal šalį ir kliento tipą (įmonė arba fizinis).
Mokesčių parinkimo sąlygos: `""[-<ŠALIS>][-]:,..."`,
pavyzdžiui: `"EUR:PVM,EUR-LV:PVM_LV,EUR-EE-1:PVM_I"`.
1 - įmonė, 2 - fizinis asmuo. |
| **pristatymo_kodas** | 'PRISTATYMAS' | Pristatymo paslaugos kodas |
| **pristatymo_tipas** | 2 | Tipas: 1-prekė, 2-paslauga, 3-kodas |
| **nuolaidos** | .F. | Ar skaičiuoti nuolaidos sumą (kainos ir sumos bus imamos prieš nuolaidą) |
| **nuolaidos_kodas** | 'NUOLAIDA' | Nuolaidos paslaugos kodas |
| **nuolaidos_tipas** | 2 | Tipas: 1-prekė, 2-paslauga, 3-kodas |
| **apmokejimas** | '' | Apmokėjimo sąlygos: `"[-<ŠALIS>]:,..."`, pavyzdžiui: `"EUR:271,EUR-LV:2711"` |
| **apmokejimo_tipas** | 'paid' | Apmokėjimo tipas: ",...", pavyzdžiui: "paid" |
| **op_tip** | 53 | 51 - Pardavimo važtaraštis, 53 - Pardavimo užsakymas |
| **kaina_su_pvm** | .T. | .T. - Kaina su PVM dokumente, .F. - Kaina be PVM dokumente |
| **isaf_pozymis** | 0 | Dokumentų registre: 0 - Formuoti, 1 - (+)Sąskaita, ... |
| **suma_su_pvm** | .T. | .T. - PVM suskaičiuojama Rivile sistemoje, arba .F. - sumos ir PVM imamos taip kaip pateikta el. parduotuvėje |
| **suminis** | .F. | .T. - Suminis dokumentas, neimportuojama detaliomis eilutėmis, arba .F. - importuojamos detalios eilutės |
| **suminis_kodas** | 'PARDAVIMAS' | Suminio dokumento pardavimo kodas |
| **suminis_matas** | 'VNT' | Mato vienetas |
| **suminis_tipas** | 3 | Tipas: 1-prekė, 2-paslauga, 3-kodas |
| **preke_kliento** | 'PIGULT' | Kliento kodas, naudojamas kliento prekių aprašymuose prie prekių kortelės |
| **api_url** | 'https://pmpapi.pigugroup.eu/v3/' | API versijos nuoroda |
| **api_filtravimas** | '' | Filtravimo sąlygos, kaip atrenkami dokumentai iš el. parduotuvės |
| **api_puslapio_limit** | 100 | Gražinamų iš el. parduotuvės dokumentų kiekis vienoje užklausoje (max 100) |
| **param_riv** | 'PIGULT_RIV' | Parametro kodas, kuriame nurodomas prisijungimo prie Rivile API raktas |
| **param_user** | 'PIGULT_USER' | Parametro kodas, kuriame bus nurodomas prisijungimo prie elektroninės parduotuvės vartotojas ir slaptažodis |
| **file** | .F. | Jei nurodytas failas - importuojama iš failo. Galima nurodyti: `imp.file=GETFILE("JSON")` |
| **debug** | .F. | Jei .T. - išsaugomi originalūs json failai tmp kataloge |
| **i06_dok_nr** | '' | Dokumento numerio laukas (užsakymo nr: 'external_id'). Nenurodžius - priskiriamas iš skaitliuko. |
| **field_dok_data** | 'created_at' | Dokumento data. Gali būti: `'created_at'`, `'closed_at'`, `'deadline_date'` |
| **field_sku** | 'modification.sku' | Nurodomas laukas, iš kurio imamas prekės/paslaugos SKU kodas |
| **field_barcode** | 'modification.ean' | Nurodomas laukas, iš kurio imamas prekės/paslaugos barkodas |
| **app_name** | 'pigu.lt:LT,220.lv:LV,kaup24.ee:EE,HobbyHall.fi:FI' | Šalies nustatymui pagal parduotuvę |
| **order_status** | '' | Importuoti tik nurodytus statusus turinčius užsakymus. Pagal nutylėjimą- visus. Galimos reikšmės: submitted, confirmed, confirmed_later, processed, open_incident, closed_incident, completed, shipping, in_progress, returned, rejected |
| **dok_nr_mask** | '' | Nurodoma, kokią seriją pridėti prie invoice_number, nurodomas šablonas, pavyzdžiui: INV-99999 |
> **Dėmesio:** Jeigu pardavimai bus registruojami kiekvienam pirkėjui atskirai, tai klientas parenkamas pagal tokią logiką prioritetiškai:
Kliento kodas pagal nutylėjimą -\> Parenkamas pagal el. pašto adresą -\> Kuriamas naujas.
> **Dėmesio:** Prekė/ paslauga/ pardavimo kodas parenkamas pagal tokią logiką prioritetiškai:
Barkodas -\> Parenkama iš kliento, nurodyto parametre "preke_kliento", prekių sąrašo (jeigu prekių kortelėse yra suvestos klientų prekės) -\> Parenkama pagal prekės kodas + pagrindinis mato vnt -\> pardavimo kodas -> Jeigu nieko nerandama, gaunama klaida, ir neimportuojamas visas dokumentas.
#### Reikalavimai ir pastabos:
- Veikia tik nuo Rivile GAMA 119 versijos.
- Jeigu pardavimai bus registruojami kiekvienam pirkėjui atskirai, būtinai turi būti aprašytas skaitliukas klientų kodų kūrimui:
Servisas -> Administravimas -> Dokumentų skaitliukai
- Kad neimportuotų antrą kartą tų pačių klientų, klientų kortelėse turi būti suvesti bent jau el. pašto adresai - pagal juos bus identifikuojamas klientas.
- Kad neimportuotų antrą kartą tų pačių pardavimo dokumentų, "Dokumentų registro" lauke įrašomas užsakymo numeris.
- Startuojant pirmą kartą, rekomenduojama nurodyti parametre datą, nuo kurios dienos turi būti pradėti importuoti dokumentai ir už kokį intervalą jie turi būti imami. Pavyzdžiui, už 31 dieną, pradedant nuo 2020.09.01: imp.nuo_datos=MAX({^2020.09.01},date()-30)
- Ištrynus pardavimo dokumentą, jį programa importuos dar kartą.
- Ištrynus arba pakeitus pardavimo dokumente "Dokumentų registro" lauką, dokumentas bus importuojamas dar kartą.
- Mokėjimo statusas bei mokėjimo būdas išsaugomi importuoto pardavimo dokumento aprašymo lauke.
#### Importui reikalingo klavišo užprogramavimas.
Pardavimo operacijų sąraše užprogramuojamas klavišas, kurį paspaudus bus vykdomas importas iš Pigu.lt sistemos.
Pavyzdžiui:
imp=imp_pigult_api() && Sukuriamas parametrų objektas
imp.nuo_datos=MAX({^2021.03.10},date()-7) && Nurodoma pradžios data, nuo kurios dienos startuojamas servisas
imp.suma_su_pvm=.T.
imp.kliento_kodas="PIRKEJAS"
imp.apmokejimas="EUR:271,EUR-LV:2711"
imp.Init() && Vykdomas importas