Szolgáltatói dokumentáció Az ETELKA-modul főmenü szerkezete 5 feldolgozási pontból, 5 főmenü csoportból áll. Ezek láthatósága a felhasználókra ráosztott szerepkörök szerint biztosított, melyet a kulcsfelhasználók határoznak meg és a rendszeradminisztrátorok állítanak be. E dokumentáció célja a szolgáltatók által használt (5)-ös menücsoport, és a hozzá tartozó menüpontok ismertetése. 1. Menüpont szerinti bemutatás A továbbiakban a főmenü pontok szerinti tagolásban ismertetjük a szolgáltatói feladatokat. 1. ábra: Szolgáltatói funkciók 1.1. Szolgáltatói információ (5) A menücsoport öt almenüből áll. Több olyan almenü szerepel itt, amely az ETELKA-modul más menücsoportjában is megtalálható. 1
1.1.1. Étkezések, napi menük (51) A legalapvetőbb beállítási lehetőség az ETELKA modulban, hogy mit lehet enni, vagyis miket rendelhetnek a tagok. A rendelésnek két formája van: előrendelés és pótrendelés. A rendelés során minden esetben napi menükből válogathatnak az étkezők. A napi menük az egy napra eső étkezéseket fogják össze, és speciális elnevezésekkel vannak azonosítva. Az étkezések és napi menük adminisztrációja az adatgazdák feladata. Az intézmények és a szolgáltatók ezt a központi beállítást használhatják. A menüpontban lehet az étkezési beállítások listáját megtekinteni. Több panelból épül fel, amelyeket a felső sorban található fülek segítségével érhetünk el. A következő választási lehetőségeink vannak: étkezés fajta: étkezés napszak szerinti besorolását jelenti, azaz reggeli, tízórai, ebéd, uzsonna, vagy vacsora kerül az asztalra. étkezés típus: normál, diétás, vagy vegetáriánus étkezés közül választhatunk. korosztály: az adagok méretére vonatkozó információt hordoz, azaz a felnőtt, iskolás, óvodás, bölcsődés lehetőségeket takarja. szolgáltatástartalom: étkezéstípus, étkezésfajta, korosztály közös kombinációjából jön létre. napi menü: szolgáltatástartalmak kombinációjából jönnek létre a napi menük. 1.1.1.1. Étkezés fajta 2. ábra: Étkezés fajták 2
A menüpontban az étkezés fajták listázását tehetjük meg. Az Étkezés fajták listában a következő adatok szerepelnek: sorszám: az étkezés fajta sorszáma megnevezés: az étkezés fajta megnevezése rövid: az étkezés fajta megnevezésének rövidítése aktív: az étkezés fajta aktív-e 1.1.1.2. Étkezés típus 3. ábra: Étkezés típus A menüpontban az étkezés típus listáját tekinthetjük meg. Az Étkezés típus listában a következő adatok szerepelnek: sorszám: az étkezés típus sorszáma megnevezés: az étkezés típus megnevezése rövid: az étkezés típus megnevezésének rövidítése aktív: az étkezés típus aktív-e altípus kötelező: altípus megadása kötelező-e Az étkezés típus listában a jelölő négyzet segítségével tudunk újabb altípust listázni. Ez 3
jellemzően a diétás menü esetében fordul elő. 4. ábra: Diétás étkezés altípusai Az Étkezés altípusai listában a következő adatok szerepelnek: rövid név: az étkezés altípus megnevezésének rövidítése megnevezés: az étkezés altípus megnevezése 1.1.1.3. Korosztály 5. ábra: Korosztály 4
A menüpontban a korosztály listázását tehetjük meg. A korosztály listában a következő adatok szerepelnek: sorszám: korosztály sorszáma megnevezés: korosztály megnevezése rövid: korosztály megnevezésének rövidítése aktív: korosztály aktív-e 1.1.1.4. Szolgáltatás tartalom 6. ábra: Szolgáltatástartalom Ebben a menüpontban az eddig rögzített szolgáltatás tartalmakat listázhatjuk. A Szolgáltatástartalom listában a következő elemek szerepelnek: étkezés típus: étkezés típus megnevezése étkezés fajta: étkezés fajta megnevezése korosztály: korosztály megnevezése kódolás: szolgáltatástartalom kódolása A kódolás az étkezés fajta és korosztály rövidítésének konkatenációjaként képződik. 5
1.1.1.5. Napi menü 7. ábra: Napi menük A menüpontban a napi menük listáját tekinthetjük meg. A lista a következő elemeket tartalmazza: megnevezés: napi menü megnevezése kódolás: napi menü kódolása tartalom: napi menü tartalma technikai: technikai napi menü-e aktív: napi menü aktív-e A technikai menüket a modul generálja, ha szüksége van rá. Erre egy-egy étkezés lemondásakor van szükség, ha nincs a lemondás után kapott napi menü létrehozva. Pl. REV-ből lemondják az E-t, akkor lehet hogy nincs RV menü. Létrehozza technikainak. A technikai menük mindig részhalmazai valamely valódi napi menünek. 6
1.1.2. Megrendelői perspektíva (52) 8. ábra: Megrendelői perspektíva A menücsoport a megrendelő számára fontos információkat tartalmazza. Megtekinthetjük a szolgáltatói árakat, a rendelések összesítését, utólagos lemondások, pótigények listáját. A szolgáltató saját élelmezési rendszerébe importálhatja az adatokat, a szolgáltatói kódok adminisztrációjának elvégzése után. 1.1.2.1. Szolgáltatói árak (521) A menüpontban a szolgáltatók által alkalmazott bruttó árjegyzék található meg. A szolgáltató árak gomb megnyomása után egy komplex panel jelenik meg, amely 3 részből áll. A panel tetején a szolgáltatói adatok találhatóak, azaz a szolgáltató neve és címe. A panel bal oldalán az árjegyzékek listája van, vagyis adott szolgáltatóhoz párhuzamosan több árjegyzék is rögzítve lehet. Erre akkor van szükség, amikor egyazon szolgáltató különböző árakon szállít a különböző intézményekbe. Amely árjegyzékre rákattintunk, a hozzá kapcsolódó részletes információ a panel jobb oldalán jelenik meg. A felrögzített 7
árjegyzékeket egyedi elnevezéssel lehet ellátni. 9. ábra: Szolgáltatói árjegyzék A panel jobb oldalán adott árjegyzékhez tartozó részletes információ található. A panel két részből áll, közöttük a felső sorban található fülekkel mozoghatunk. A két rész a szolgáltatói árak, és az akkumulált szolgáltatói árak. Ez egy multitáblázat, amely 3 részből áll. A részek között a felső sorban található fülekkel mozgunk. Annak érdekében, hogy a bruttó árjegyzékek mellett a nyersanyagnormával csökkentett térítési díj táblázatokat is át lehessen tekinteni, a díjtáblázat felett a rendszerben rögzített dotációk között lehet válogatni. Az egyes dotációk tartozó táblázatokat fülek segítségével lehet kiválasztani. A táblázatok felépítése minden esetben ugyanaz. A korosztályoknak, étkezés típusoknak megfelelően az egyes étkezés fajtákhoz tartozó árak szerepelnek a táblázat mezőiben. A --- mezőkhöz nem tartozik szolgáltatástartalom. Az akkumulált szolgáltatói árak fülön a rögzített szolgáltatói árak alapján akkumulált napi menükre vonatkozó összesített árakat lehet megtekinteni. Az akkumulált szolgáltatói árak táblázatban a szolgáltatói árak táblázattal ellentétben nem lehet adatokat rögzíteni, ez a multitáblázat adatai a szolgáltatói árak táblázat értékei alapján automatikusan kitöltődnek. A modul piros színnel jelzi azokat a mezőket, ahol a szolgáltatástartalmat a szolgáltató nem adta meg, zöld színnel pedig azokat a mezőket, ahol van megadva szolgáltatástartalom. A kurzor segítségével megkapjuk, hogy az adott szolgáltatástartalom milyen időintervallumban 8
érvényes. A multitáblázat utolsó oszlopában az összesített ár szerepel, ahol a szolgáltató nem adott meg információt, ott a N/A (nincs adat) kifejezés látható. A nyomtatás gomb megnyomása után egy menü árlista PDF keletkezik, amely már a helyi nyomtatón nyomtatható. A vissza gomb megnyomásával visszatérünk a szolgáltatók listájához. A nyomtatás PDF-be gomb megnyomása után az árlista PDF formátumban jelenik meg, amely már a helyi nyomtatón nyomtatható. 1.1.3. Szolgáltató étkezési helyei (522) 10. ábra: Étkezési helyek A menüpontban a szolgáltató étkezési helyeinek listája jelenik meg. A lista a következő adatokat tartalmazza: szolgáltató neve: szolgáltató megnevezése szolgáltató címe: szolgáltató pontos címe telephely neve: telephely megnevezése telephely címe: telephely pontos címe aktív: étkezési hely aktív-e használatban: étkezési hely használatban van-e 9
A vissza gomb megnyomásával visszatérünk a főmenübe. 1.1.4. Utólagos pótigények/lemondások megtekintése (523) 11. ábra: Utólagos pótigények/lemondások Ebben a menüpontban utólagos pótigények, lemondások tekinthetőek meg. Az utólagos rendelés egy speciális szolgáltatás azokra az esetekre, amikor valamilyen technikai vagy egyéb okból nem sikerül rögzíteni bizonyos pótigényeket vagy lemondásokat, melyeket egyébként más csatornákon lejelentettek az intézmények és eljutott a szolgáltatóig. Intézményt legördülő listából választjuk. Az utólagos pótigények/lemondások listában a következő adatok szerepelnek: név: a tag neve, aki lemondást/pótigényt kért. dátum: az utólagos pótigény/lemondás dátuma menü: a pótigény/lemondás menüje állapot: pótigény/lemondás aktuális állapota intézmény: a tag intézménye megjegyzés: a pótigényhez/lemondáshoz fűzött megjegyzés rögzítő: a pótigény/lemondás rögzítőjének neve rögzítés ideje:a pótigény/lemondás rögzítésének ideje 10
jóváhagyó: a pótigény/lemondás jóváhagyójának neve jóváhagyás ideje:a pótigény/lemondás jóváhagyásának ideje 1.1.5. Intézmények napi kimutatása (524) Az adatgazdák minden nap lezárhatják az intézmények elől a további rendelési lehetőségeket. Ez általában azt jelenti, hogy minden esetben az előző munkanap egy előre megadott időpontjáig be kell fejezni a pótigények és lemondások leadását, befogadását. Ez azért szükséges, hogy a lezárás után a lezárt nap végleges rendeléseit összesíthessék a rendszerben és továbbíthassák a szolgáltató felé. A szolgáltatók a menüponton keresztül letölthetik és nyomtathatják ki a végleges rendeléseket, és láthatják, hogy az intézmények időben mikor végeztek a rögzítési munkákkal. 12. ábra: Napi zárás 11
Intézményt legördülő listából választunk. A menüpontban egy táblázat található, amely a következő oszlopokat tartalmazza: hét napjai: pontos dátum, csütörtöktől a következő hét péntekig. zárás: Az étkezés típusoknak megfelelő zárások szerepelhetnek: normál, emelt, diétás, vegetáriánus. Ki zárta le?: a zárás után automatikusan kitöltődik. Mikor zárta le?: a zárás után automatikusan kitöltődik. Megjegyzés: a záráshoz fűzött megjegyzés. Időszak étkezői: a gomb megnyomása után az intézmények napi végleges zárási listája jelenik meg. 13. ábra: Intézmények napi végleges zárási listája A felső sorban található fülekkel választhatunk a normál, emelt, diétás, vegetáriánus étkezés fajtákra vonatkozó listák közül. A lista a következő adatokat tartalmazza: intézmény véglegesítési státusz havi előzetes rögzítés ideje 12
havi előzetes rögzítő havi előzetes logisztikai nyomtatás napi végleges rögzítés ideje napi végleges rögzítő napi végleges mentése napi leadott logisztikai nyomtatás havi végleges számlázási nyomtatás A listában szürke színnel vannak azok a sorok jelölve, amelyek még nincsenek véglegesítve. A napi véglegesített státuszú sorokat kék színnel jelöli a modul. A véglegesített státuszú sorokon a következő műveleteket végezhetjük el: havi előzetes logisztikai nyomtatás napi leadott logisztikai nyomtatás havi végleges számlázási nyomtatás. Mindhárom esetben egy PDF fájl keletkezik, amely a helyi nyomtatón már nyomtatható. A szolgáltatók felé ez egy ellenőrzési lehetőség, hogy az adott intézménynek van-e havi előzetes rendelése, és megtörtént-e időben a napi zárás. 1.1.6. Havi rendelések (525) A menüpontban számlázási és logisztikai nézetben tekinthetők meg a havi rendelések. A számlázási nézet azt mutatja meg, hogy hova állítja ki a számlát a szolgáltató. A logisztikai nézet pedig azt mutatja meg, hogy hova szállítja ki a rendelést a szolgáltató. 13
14. ábra: Havi rendelések A panel legfelső sorában található az aktuális év, hónap. A dátumot legördülő listából választhatjuk. A gyorsabb és kényelmesebb dátumhasználat érdekében bal szélen és jobb szélen is nyilak helyezkednek el, amelyekkel az előző hónapot (évet), és a következő hónapot (évet) tudjuk beállítani. Logisztikai nézetben étkezési helyet, számlázási nézetben telephelyet kell választani a listából. A komplex felületen a logisztikai és számlázási nézetek között válthatunk, és az egyes nézetekben két fül között is választási lehetőségünk van az igényeinknek megfelelően. A logisztikai nézet étkezési helyre, míg a számlázási nézet telephelyre vonatkozólag mutatja a havi rendelések statisztikáját. Az előzetes rendelés fül egy olyan multitáblázat, amelyben a hónap minden napjára, minden korosztályra, minden étkezési típusra számszerűleg szerepel a rendelés mennyisége. Külön oszlopokban találhatóak meg az előzetes, lemondás, pótigény, végleges rendelések számadatai. A nyomtatás (összesített tervezett rendelés -étkezési helyre ) gomb megnyomása után egy PDF fájlt kapunk, amely már a helyi nyomtatón nyomtatható. 14
Az összesített havi végleges rendelés fül egy olyan multitáblázat, amelyben csak a hónap azon napjai szerepelnek, amelyeknél a rendelés véglegesítve lett. A táblázatban minden korosztályra, minden étkezési típusra számszerűleg szerepel a rendelés mennyisége. Külön oszlopokban találhatóak meg az előzetes, lemondás, pótigény, végleges rendelések számadatai. A táblázat alján egy összesítés szerepel a rögzített értékekre. 15. ábra: Összesített havi végleges rendelés A panelen egy másik táblázat is található, amelyben a hónap minden napjához hozzá van rendelve, hogy van-e legalább egy napi végleges rendelés, és az összes rendelés véglegesítve van-e. A napi végleges, össz. végleges oszlopokban igen/nem kifejezések szerepelhetnek. A nyomtatás (összes étkezési hely) gomb megnyomása után keletkezik egy PDF fájl, amely a helyi nyomtatón nyomtatható. Csak akkor lehet végleges rendelést nyomtatni, ha a hónap összes napja le van zárva. 15
1.1.7. Heti rendelések (526) A menüpontban számlázási és logisztikai nézetben tekinthetők a heti rendelések. A számlázási nézet azt mutatja meg, hogy hova állítja ki a számlát a szolgáltató. A logisztikai nézet pedig azt mutatja meg, hogy hova szállítja ki a rendelést a szolgáltató. 16. ábra: Heti rendelések A panel legfelső sorában található az aktuális év, hét. A dátumot legördülő listából választhatjuk. A gyorsabb és kényelmesebb dátumhasználat érdekében bal szélen és jobb szélen is nyilak helyezkednek el, amelyekkel az előző hetet (évet), és a következő hetet (évet) tudjuk beállítani. Mindkét nézetben hasonló a menü felépítése, így egyszerre ismertetjük őket. A panel 5 részből áll, közöttük a felső sorban található fülekkel mozoghatunk. Ezek a részek az előzetes rendelés, lezárt rendelések, aktuális rendelés, lezárás utáni rendelések, összesített heti végleges rendelés. Az öt rész felépítése megegyezik, így mindegyik rész külön nem kerül ismertetésre. Az előzetes rendelés fülön először a jelölő négyzetek segítségével választunk az alkalmazott, ellátott, vendég típusok és az ezekhez tartozó altípusok közül. Ez által szűrési 16
feltételeket állíthatunk be. Majd logisztikai nézetben étkezési helyet, számlázási nézetben telephelyet kell választani a listából. Az előzetes rendelés fül egy olyan multitáblázat, amelyben a hét minden napjára, minden korosztályra, minden étkezési típusra számszerűleg szerepel a rendelés mennyisége. Külön oszlopokban találhatóak meg az előzetes, lemondás, pótigény, végleges rendelések számadatai. A táblázat felső sor bal szélén található mezőben ha a nevesített gombra kattintunk, akkor az előző táblázat helyén megjelenik egy olyan táblázat, amelyben név szerint lebontásban szerepel az összesítés. Azaz adott személy, milyen étkezési fajtát, mely napokra rendelt az adott héten. A táblázat utolsó oszlopában az adott tag heti rendelésének szummája található. A táblázat felső sor bal szélén található összesített gomb megnyomásával visszatérünk a korábban látott összesített táblázatra. A nyomtatás gomb megnyomása után megjelenik egy PDF fájl, amely már a helyi nyomtatón nyomtatható. A fájl az előzetes heti rendelés tervezetet tartalmazza, amely a szolgáltató felé továbbítható. A nyomtatás minden korosztályra gomb megnyomása után hasonlóan egy PDF fájl keletkezik. A nyomtatás funkciótól annyiban különbözik ez a funkció, hogy itt az összes korosztályra szerepel a heti előrendelés. A nyomtatás (összes étkezési típus) gomb megnyomása után hasonlóan egy PDF fájl keletkezik. Az összes étkezési típusra szerepel a kapott táblázatban a heti rendelés. A további füleknek hasonló a felépítése, mint az előzetes rendelés fülnek, így ezeket nem részletezzük. Ezek a lezárt rendelés, aktuális rendelés, lezárás utáni rendelés, és az összesített heti végleges rendelés fülek. 1.1.8. Napi rendelések (527) A menüpontban számlázási és logisztikai nézetben tekinthetők a heti rendelések. 17
A számlázási nézet azt mutatja meg, hogy hova állítja ki a számlát a szolgáltató. A logisztikai nézet pedig azt mutatja meg, hogy hova szállítja ki a rendelést a szolgáltató. 17. ábra: Napi rendelések A panel legfelső sorában található az aktuális nap dátuma. A dátumot legördülő listából választhatjuk. A gyorsabb és kényelmesebb dátumhasználat érdekében bal szélen és jobb szélen is nyilak helyezkednek el, amelyekkel az előző napot (hónapot), és a következő napot (hónapot) tudjuk beállítani. Mindkét nézetben hasonló a menü felépítése, így egyszerre ismertetjük őket. A végleges rendelés fül egy olyan multitáblázat, amelyben minden korosztályra, minden étkezési típusra, minden étkezés fajtára számszerűleg szerepel a rendelés mennyisége. Külön oszlopokban találhatóak meg az előzetes, lemondás, pótigény, végleges rendelések számadatai. A táblázatban szereplő adatokra kattintva megjelenik egy ablak, amely az adott dátumot, korosztályt, étkezési fajtát, étel típust és a paramétereknek megfelelő megrendelők neveit tartalmazza. A bezár gombbal csukhatjuk be a megjelent ablakot. A táblázatban külön színnel jelöli a modul a szolgáltatóra, étkezési helyre, intézményre vonatkozó adatokat. 18
Tervezett napi rendelés nyomtatása gombra kattintva az össz. napi rendelésről egy PDF fájl keletkezik, amely a helyi nyomtatón nyomtatható. Tervezett napi nevesített lista nyomtatása gomb megnyomása után is egy PDF fájl keletkezik, amely a helyi nyomtatón nyomtatható. 1.1.9. Rendelésállomány exportálása (528) 18. ábra: Rendelésállomány exportálása A menüpontban a rendelésállományt exportálhatjuk XML formátumba. Ez arra szolgál, hogy a szolgáltató a saját rendszerébe be tudja importálni a rendelésállomány adatait. Az 19
exportálás alapbeállításait legördülő listából választjuk. Havi/napi logisztikai/számlázási végleges rendelésállomány közül választhatunk. A kiválasztottnak megfelelően automatikusan kitöltődnek a beállítások mezők. Ha az egyéb összeállítást választjuk, akkor a beállítások mező adatait legördülő listából választjuk az igényeinknek megfelelően. Ha a névsor jelölő négyzetét megjelöljük, akkor a rendelésállományhoz névsor is társul. Névsort csak az egyéb összeállítás esetén választhatjuk. Legördülő listából választjuk, hogy tömörítés milyen formátumú legyen. Szintén legördülő listából választjuk az exportálás idejét. A beállítások elvégzése, majd az export gomb megnyomása után megtörténik az XMLfájlba az exportálás. A megrendelő letöltések listában szerepelnek a korábbi exportálások adatai. A lista a következő információkat tartalmazza: időszak: az exportálás állományának időszaka időszak típus: a rendelésállomány időszakának típusa, azaz havi vagy napi rendelésállomány. letöltő neve: az exportálást végző személy neve letöltés ideje: az exportálás pontos ideje nézet: rendelésállomány nézete, logisztikai vagy számlázási. étkezés típus: a rendelésállomány étkezés típusa névsor: névsor készül-e vagy sem. típus: rendelésállomány típusa, előzetes vagy végleges. fájl neve: az export fájl megnevezése MD5: a kódolási algoritmus során keletkező karaktersorozat, amely segítségével ellenőrizhető a fájl eredetisége felmerülő problémák esetén. Az exportálást csak akkor lehet elvégezni, ha a szolgáltató kódok adminisztrációját befejeztük az 529-es menüpontban. 20
1.1.10. Szolgáltató kódok adminisztrációja (529) 19. ábra: Szolgáltató kódok adminisztrációja A menüpontban a szolgáltató az étkezés típushoz, étkezés altípushoz, korosztályhoz, étkezés fajtához, tagtípushoz, intézményhez, telephelyhez, étkezési helyhez saját szolgáltatói kódot rendelhet hozzá. A menü nyolc részből áll, ezek között a felső sorban található fülekkel mozoghatunk. Mindegyik fül felépítése azonos. A füleken egy táblázat található, amely a következő adatokat tartalmazza: ETELKA-megnevezés: a fogalom ETELKA-modulban szereplő elnevezése, automatikusan kitöltődik. ETELKA-kód: a fogalom ETELKA-modulban nyilvántartott kódja, automatikusan kitöltődik. szolgáltatói kód: ez a mező szerkeszthető, itt adhatjuk meg a szolgáltatói kódot. A már tárolt kódok a mezőben megjelennek, de módosíthatóak. A kód rögzítése a rögzít gomb megnyomásával történik. A vissza gomb megnyomásával visszatérünk a főmenübe. 21
Tartalomjegyzék Szolgáltatói dokumentáció...1 1. Menüpont szerinti bemutatás...1 1.1. Szolgáltatói információ (5)...1 1.1.1. Étkezések, napi menük (51)...2 1.1.1.1. Étkezés fajta...2 1.1.1.2. Étkezés típus...3 1.1.1.3. Korosztály...4 1.1.1.4. Szolgáltatás tartalom...5 1.1.1.5. Napi menü...6 1.1.2. Megrendelői perspektíva (52)...7 1.1.2.1. Szolgáltatói árak (521)...7 1.1.3. Szolgáltató étkezési helyei (522)...9 1.1.4. Utólagos pótigények/lemondások megtekintése (523)...10 1.1.5. Intézmények napi kimutatása (524)...11 1.1.6. Havi rendelések (525)...13 1.1.7. Heti rendelések (526)...16 1.1.8. Napi rendelések (527)...17 1.1.9. Rendelésállomány exportálása (528)...19 1.1.10. Szolgáltató kódok adminisztrációja (529)...21 22