MSCAN diegimas
MSCAN aplikacijos diegimas
-
Kreipiamasi į UAB "Rivilė" ar jos atstovus paslaugos užsakymui, sutarties sudarymui ir prisijungimo vardų sukūrimui.
-
Sudiegiama Manorivile-Gateway. Instrukcija kaip tai atlikti pateikta internetiniai_moduliai/api_rest/manorivile-gateway.
-
Rivile GAMA sistemoje aprašomos aplikacijai MSCAN reikalingos būsenos.
-
Rivile GAMA sistemoje aprašomi aplikacijai MSCAN reikalingi parametrai.
- Reikalinga Rivile GAMA 114.03 ar naujesnė versija (kad veiktų MSCAN Kaupiklio operacijose)
MSCAN būsenų aprašymas Rivile GAMA sistemoje
MSCAN aplikacijos skenavimo procesas sudarytas iš 3 etapų: paruoštas rinkimui, renkamas, baigtas. Šie etapai yra konfigūruojami Rivile GAMA programoje, būsenų aprašyme, kurios parodo kokioje skenavimo stadijoje yra konkretus dokumentas. MSCAN aplikacijoje rodomos tik paruoštos ir renkamos operacijos.
- MSCAN paruošta - paruoštas dokumentas atrinkimui
- MSCAN renkama - kai pradedamos skenuoti dokumento eilutės MSCAN aplikacijoje - būsena iš "paruošta" automatiškai pakeičiama į "renkama".
- Baigimą atitinka viena iš 4 būsenų, priklausomai nuo atrinkto dokumento bei pasirinkimo:
- MSCAN baigta (OK) - kai kiekiai dokumente sutampa su atrinktais kiekiais,
- MSCAN baigta su netikslumais - kai atrinkti (užpajamuoti) kiekiai nesutampa su kiekiais dokumente, bet buvo pasirinktas užbaigimas,
- MSCAN baigta koreguojant - kai atrinkti kiekiai nesutapo su kiekiais dokumente, ir dokumente esantys kiekiai buvo iškoreguoti pagal atrinktus kiekius (galima tik atrinkimo operacijose) ,
- MSCAN iškoreguota su klaidomis - kai atrinkti kiekiai nesutapo su kiekiais dokumente, bet nepavyko pilnai iškoreguoti dokumento kiekių, pvz., trūko prekių (galima tik atrinkimo operacijose).
Būsenos aprašomos Rivile GAMA kiekviename modulyje, su kuriuo bus dirbama per MSCAN aplikaciją. Būsenų pavadinimus pagal poreikį galima aprašyti parametre MSCAN_BUS.
Servisas -> Pirkimai -> Pirkimo operacijos
Servisas -> Pardavimai -> Pardavimo operacijos
Servisas -> Vidinė apskaita -> Vidinės operacijos
Servisas -> Kaupikliai -> Kaupiklio operacijos
Nuskaitomas operacijų sąrašas.
Mygtukas "Būsenos patvirtinimas" paspaudžiamas su dešiniu pelės klavišu:
Pasirenkama "Būsenų sąrašas"
Sukuriamos aukščiau išvardintos būsenos, pvz.:
Tokios pat būsenos aprašomos pardavimo, vidinės apskaitos ir kaupiklių moduliuose.
MSCAN būsenų numeris neturi jokios reikšmės. MSCAN naudojamos būsenos atskiriamos pagal pavadinimą. Svarbu, kad nesidubliuotų tuo pačiu pavadinimu skirtingos būsenos tam pačiam dokumento tipui.
Jeigu Rivile GAMA programoje tuose pačiuose moduliuose jau yra naudojamos būsenos, tai MSCAN reikalingos būsenos papildomai integruojamos šalia jau esančių taip, kad būtų išlaikyti visi loginiai ryšiai. Būsenų prašokimui gali būti naudojama funkcija BUSENA_K
MSCAN būsenų tvirtinimai inicijuojami iš MSCAN aplikacijos.
Rankomis tvirtinama tik pati pradinė būsena. Ją patvirtinus, dokumento būsena tampa "MSCAN renkama".
Todėl vartotojų administravimas ("Vartotojų leidimai") Rivile GAMA programoje reikalingas tik pradinei būsenai.
MSCAN administruojamas tik užbaigimo būsenos parinkimas: ar leisti užbaigti su netikslumais, ar iškoreguoti dokumentą. Tam naudojamas parametras MSCAN_PAB_OP.
MSCAN parametrai, aprašomi Rivile GAMA sistemoje
Servisas -> Administravimas -> Parametrai
| Parametras | Aprašymas |
|---|---|
| MSCAN_BUS | MSCAN aplikacijoje naudojamų būsenų pavadinimai. |
| MSCAN_HSAR | Dokumentų sąraše matoma informacija. |
| MSCAN_HRUS | Dokumentų sąrašo rūšiavimas. |
| MSCAN_HFIL | Dokumentų sąrašo filtravimas. |
| MSCAN_DSAR | Detalioje eilutėje matoma informacija. |
| MSCAN_DRUS | Detalios informacijos rūšiavimas. |
| MSCAN_DFIL | Detalios informacijos filtravimas. |
| MSCAN_DPAP | Detalios informacijos apie prekę papildymas laukais iš lentelių N17_PROD, N37_PMAT, I33_PKAI ir I17_VPRO. |
| MSCAN_PAB_OP | Operacijų užbaigimo parametras teisėms administruoti |
| MSCAN_ATR_TO | Prekių kiekių tolerancija atrinkimo operacijose. |
| MSCAN_PAJ_TO | Prekių kiekių tolerancija pajamavimo operacijose. |
| MSCAN_KP_PAV | Aprašymo laukų pasirinkimo variantai, kuriant naujas kaupiklio operacijas. Pagal nutylėjimą, galima vesti bet kokią reikšmę. |
| MSCAN_IS | Padalinio kodas pagal nutylėjimą MSCAN aplikacijoje. |
| SS_SVS_KBAR | Sveriamo barkodo maketas. |
MSCAN_BUS - MSCAN aplikacijoje naudojamų būsenų pavadinimai.
Parametras leidžia vartotojui pakeisti MSCAN modulyje naudojamų būsenų pavadinimus.
Šis parametras nustatomas tik modulio lygyje. Vartotojo laukas naudojamos būsenos kodui įrašyti. Jeigu parametras neaprašytas, naudojamos standartinės MSCAN būsenos.
Būsenų kodai:
- N - MSCAN paruošta ;
- K - MSCAN renkama ;
- P1 - MSCAN baigta (OK) ;
- P2 - MSCAN baigta su netikslumais;
- P3 - MSCAN baigta koreguojant;
- P4 - MSCAN iškoreguota su klaidomis.
Galima atskirai nurodyti bendrai visiems moduliams arba modulio lygyje (pirkimai, pardavimai, vidiniai, kaupikliai).
Būsenos kodas (N,K,P..) rašomas į lauką "Vartotojas".
MSCAN_HSAR, MSCAN_HRUS, MSCAN_HFIL - Dokumentų sąraše matoma informacija, jos rūšiavimas, filtravimas.
Dokumentų sąrašo formavimui naudojami laukai:
| Kodas | Aprašymas |
|---|---|
| operationCode | operacijos numeris |
| operationType | operacijos tipas – (ATR – atrinkimas, PAJ – pajamavimas, KAUP - kaupikliai) |
| documentNr | dokumento numeris |
| docDate | dokumento data |
| clientCode | kliento kodas |
| clientName | kliento pavadinimas |
| description | pirmas aprašymo laukas Rivile GAMA sistemoje (Pirkimo ir Pardavimo moduliuose – I06_APRASYMAS1, vidiniuose – I09_PAV, kaupiklių modulyje – I51_PAV) |
| appPosition | nuskenuotų pozicijų kiekis |
| documentPosition | dokumente esančių pozicijų kiekis |
| logisticsCode1 | pirmas dokumento logistikos kodas |
| logisticsCode2 | antras dokumento logistikos kodas |
| logisticsCode3 | trečias dokumento logistikos kodas |
| logisticsCode4 | ketvirtas dokumento logistikos kodas |
| managerCode | menedžerio kodas |
| state | operacijos būsenos pavadinimas (pavyzdžiui, „MSCAN renkama“) |
| stateIndicator | būsenos indikatorius (K - renkama, N - paruošta) |
MSCAN_HSAR – Dokumentų sąraše rodomi duomenys
Parametras, leidžiantis vartotojui pakeisti dokumentų sąraše matomą informaciją.
Kiekviena operacija matoma dviem eilutėmis: Elementas1 ir Elementas2:
Elementas 1 - aprašomas pirmame parametro reikšmės lauke.
Elementas 2 – aprašomas pirmame parametro reikšmės lauke.
Jeigu norima rodyti kelių laukų reikšmes, parametro aprašyme tokie laukai atskiriami kableliu.
Parametras gali būti valdomas bendrai, modulio, vartotojų grupės ar vartotojo lygyje
Pvz.:
MSCAN_HRUS – Dokumentų sąrašo rūšiavimas
Parametras skirtas nustatyti laukus, pagal kuriuos rūšiuojamas dokumentų sąrašas ir jų rūšiavimo tvarka
Parametras gali būti valdomas bendrai, modulio, vartotojų grupės ar vartotojo lygyje
Pvz.:
MSCAN_HFIL – Dokumentų sąrašo papildomas filtravimas
Parametras, skirtas papildomai filtruoti operacijas dokumentų sąraše, naudojant SQL sintaksę.
Parametras gali būti valdomas bendrai, modulio, vartotojų grupės ar vartotojo lygyje
Pvz.:
Neaprašius parametrų:
Elementas 1 - operacijos numeris,
Elementas 2 - dokumento numeris ir operacijos data,
Rūšiavimas - pagal operacijos numerį,
Papildomo filtravimo nėra (rodoma tik "paruoštos" bei "renkamos" operacijos).
MSCAN_DSAR, MSCAN_DRUS, MSCAN_DFIL - Dokumento detaliose eilutėse matoma informacija, jos rūšiavimas, filtravimas.
Dokumento detalių eilučių formatavimui naudojami laukai:
| Kodas | Aprašymas |
|---|---|
| productCode | prekės kodas |
| productName | prekės pavadinimas |
| unitCode | matavimo vienetas |
| objectCode | objekto kodas |
| lot | serija |
| departmentCode | padalinio kodas |
| fraction | matavimo vieneto frakcija |
| module | modulis (RO – pardavimų, PO – pirkimų, VD – vidinių, KP – kaupiklių) |
| operationCode | operacijos kodas |
| operationType | operacijos tipas (ATR – atrinkimas, PAJ – pajamavimas, KAUP – kaupikliai) |
| quantityApp | nuskenuotas kiekis |
| quantityDocument | kiekis dokumente |
| rowNumber | eilutės numeris |
| updateDate | eilutės atnaujinimo data |
| barcode | prekės brūkšninis kodas |
MSCAN_DSAR – parametras, leidžiantis vartotojui pakeisti dokumento detalioje eilutėje matomą informaciją.
Dokumento viduje kiekviena prekė matoma dviem eilutėmis: Elementas1 ir Elementas2:
Elementas 1 - aprašomas pirmame parametro reikšmės lauke
Elementas 2 – aprašomas antrajame parametro reikšmės lauke.
Jeigu norima rodyti kelių laukų reikšmes, parametro aprašyme tokie laukai atskiriami kableliu. Pvz.:
MSCAN_DRUS – Detalių eilučių rūšiavimas
Parametras skirtas nustatyti laukus, pagal kuriuos dokumente rūšiuojamos detalios eilutės.
Parametras gali būti valdomas bendrai, modulio, vartotojų grupės ar vartotojo lygyje
Papildomai galima panaudoti prekės informacijos duomenis (N17,N37,I33,I17)
Pvz.:
MSCAN_DFIL – Detalių eilučių filtravimas.
Parametras skirtas nustatyti laukus, pagal kuriuos dokumente filtruojamos detalios eilutės (SQL sintekse)
Parametras gali būti valdomas bendrai, modulio, vartotojų grupės ar vartotojo lygyje
Papildomai galima panaudoti prekės informacijos duomenis (N17,N37,I33,I17)
Pvz.:
Neaprašius parametrų:
Elementas 1 - prekės barkodas,
Elementas 2 - prekės pavadinimas,
Rūšiavimas - pagal operacijos numerį,
Filtruojamos tik prekės (pagal nutylėjimą paslaugų nerodo).
MSCAN_DPAP - Detalios informacijos apie prekę papildymas
Detali informacija apie prekę gali būti papildoma laukais iš lentelių N17_PROD, N37_PMAT, I33_PKAI ir I17_VPRO.
MSCAN aplikacijoje spustelėjus ant detalios eilutės, atsiranda galimybė pažiūrėti informaciją apie eilutėte esančią prekę:
Standartiškai pateikiamą informaciją galima papildyti laukais iš lentelių N17_PROD, N37_PMAT, I33_PKAI ir I17_VPRO, t.y. rodyti tiekėją, kainas, svorius, likutį ir pan.
Parametro aprašyme laukų reikšmės skiriamos kableliu. Aprašymui gali būti naudojama tiek pirma, tiek antra parametro reikšmė. Jeigu laukui suteikiamas pavadinimas, naudojama speciali išraiška, tokia kaip pavyzdžiui :
N17_KODAS_KS as 'Tiekėjas', N37_BAR_KODAS,N37_NETTO
MSCAN_PAB_OP - Operacijų užbaigimo parametras.
Kai atrinktas kiekis nesutampa su originaliame dokumente įvestu kiekiu, bandant užbaigti operaciją vartotojui leidžiama pasirinkti iš 2 variantų:
a) Baigti su netikslumais;
b) Baigti koreguojant.
Parametras gali būti valdomas bendrai, modulio, vartotojų grupės ar vartotojo lygyje.
Jeigu abi parametro reikšmės bus "Ne", ir dokumentas bus netiksliai atrinktas, vartotojas per MSCAN aplikaciją negalės užbaigti operacijos.
MSCAN_ATR_TO - prekių kiekių tolerancija atrinkimo operacijose.
Parametras nustato prekių kiekių tolerancija atrinkimo operacijose.
Parametras gali būti valdomas bendrai, modulio, vartotojų grupės ar vartotojo lygyje
Tolerancija yra procentinė išraiška, kuri nurodo, kiek gali nuskenuotas kiekis viršyti dokumente įvestą faktinį kiekį, neišduodant įspėjimo vartotojui.
Parametro pirma reikšmė skirta nurodyti toleranciją vienetinėms prekėms, antroji – frakcijinėms prekėms.
Pagal nutylėjimą, atrinktas kiekis turi sutapti su dokumento kiekiu (tolerancija lygi 0.00).
MSCAN_PAJ_TO - prekių kiekių tolerancija pajamavimo operacijose.
Parametras nustato prekių kiekių tolerancija pajamavimo operacijose.
Parametras gali būti valdomas bendrai, modulio, vartotojų grupės ar vartotojo lygyje
Tolerancija yra procentinė išraiška, kuri nurodo, kiek gali nuskenuotas kiekis viršyti dokumente įvestą faktinį kiekį, neišduodant įspėjimo vartotojui.
Parametro pirma reikšmė skirta nurodyti toleranciją vienetinėms prekėms, antroji – frakcijinėms prekėms.
Pagal nutylėjimą, užpajamuotas kiekis turi sutapti su dokumento kiekiu (tolerancija lygi 0.00).
MSCAN_KP_PAV - aprašymo laukų pasirinkimo variantai, kuriant naujas kaupiklio operacijas.
Parametras naudojamas naujos kaupiklio operacijos kūrimo procese.
Parametras gali būti valdomas bendrai, modulio, vartotojų grupės ar vartotojo lygyje
Parametre aprašomos reikšmės, kurias galima rinktis naujai kuriamos kaupiklio operacijos aprašymo lauke. Galimi variantai atskiriami kableliu. Pvz.:
Jeigu parametras neįvestas, naujai kuriamos kaupiklio operacijos aprašymo lauke galima įvesti bet kokią reikšmę.
MSCAN_IS - padalinio kodas pagal nutylėjimą MSCAN aplikacijoje.
Parametro aprašyme nurodomas padalinys, naudojamas informacijai apie prekę (barkodą) gauti. Pavyzdžiui, prekės kaina padalinyje ar prekės likutis padalinyje bus paimami iš parametre nurodyto padalinio.
Nenurodžius šio padalinio, prekės likutis bus rodomas bendrai visiems padaliniams, o kaina išvis nebus rodoma.
SS_SVS_KBAR - Sveriamo barkodo maketas
Parametras leidžia valdyti sveriamų barkodų šablonus. Sveriamas barkodas - tai barkodas, kuriame yra užkoduotas prekės barkodas bei svoris. Pvz:
- A - Požymis, identifikatorius, kad tai sveriamas barkodas - 2 simboliai (paprastai 21,..29)
- B - Barkodas, parametre nurodoma kiek simbolių sveriamame barkode sudaro tikrasis barkodas. Prekių sąraše tokie barkodai įvedami pradžioje vedant nulius, pvz 000000008888
- C - Svoris (kiekis), parametre nurodoma kiek skaičių po kablelio skaičiuojant nuo dešinės pusės yra tame svoryje, pvz skaičius 002315 - 3 skaičiai pavyzdyje reiškia 2,315. Sveriamo barkodo ilgis visuomet vertinamas 12 simbolių (t.y. ilgesnis - nukerpamas).
Parametre galima apsirašyti keletą šablonų su skirtingais požymiais, šablonus atskiriant per kabliataškį, pvz 22*4#3;23*4#2; .
MSCAN aplikacijoje, nuskenavus parametre aprašytam šablonui atitinkantį barkodą, atskirai nurodomas kiekis yra ignoruojamas, ir imamas kiekis, kuris yra sveriamame barkode.
Parametras gali būti valdomas bendrai, modulio ar vartotojo lygyje.
