Prepojenie BlueGastro a Helios ORANGE metóda getOrder

Webová služba pre sťahovanie zákazky zo systému Asseco Helios ORANGE

Bola rozšírená komunikácia medzi ekonomickým systémom Helios Orange a systémom BlueGastro o prepojenie modulu Spoločné stravovanie -Objednávky jedál. V Helios Orange vzniká zákazka, ktorá môže obsahovať viacero úloh. Jednou z úloh je aj catering, ktorý bude realizovať gastronomický úsek, využívajúci systém BlueGastro. Aby bolo možné zákazku vyhodnotiť ako celok, je potrebné získať zo systému BlueGastro informácie o nákladoch a tržbách za danú úlohu. Detaily cateringu, t.j. podrobný rozpis jedál a nápojov zvyčajne určuje až stravovací úsek. HeO vytvorí zákazku, naplánuje úlohu aj pre catering, určí finančný limit a do poznámky rozpíše požiadavky na akciu dohodnuté so zákazníkom. BlueGastro si zákazku stiahne a vytvorí rozpis, čiže vytvorí objednávku jedál . Po realizácii úlohy obsluha v BG zaktualizuje skutočnú spotrebu a spracuje objednávku. Hneď po spracovaní odošle BG informáciu do HEO o predaných položkách. V HeO sa vytvorí dodací list, ktorý bude slúžiť ako podklad k fakturácii. V denných exportoch z BG sa prenesie informácia o skutočných nákladoch zákazky, čím získa HeO ucelený prehľad o zákazke.

Popis prenosu dát medzi HEO–BG

1. BG si bude cez webové služby sťahovať zákazku. Zákazka v HEO musí obsahovať:
   1. Údaje o firme : externé číslo, IČO, DIČ, názov firmy, ulica, mesto, PSČ
   2. Údaje o zákazke : ID zákazky, číslo zákazky, názov zákazky, dátum začiatku
   3. Poznámka orezaná na max 1000 znakov
   4. Finančný limit zákazky
2. Po ukončení akcie sa z BG do HEO prenesú k zákazke informácie:
   1. Skutočné náklady – cez exporty do ekonomiky StockTranfer , párovanie cez parameter Číslo zákazky
   2. Skutočná tržby – cez vystavenú webovú službu BG zašle zoznam predaných položiek do ekonomiky, z ktorého bude vytvorený dodací list

Údaje z odseku 1 sa budú sťahovať z HEO pri vytváraní objednávky jedál. Zoznam dostupných zákaziek bude obsahovať len zákazky, ktoré ešte neboli uzavreté alebo ukončené a musia byť určené pre dané BlueGastro. Pokiaľ BG nebude firmu poznať, založí si novú firmu.

Predané položky budú zasielané okamžite po uzatvorení akcie v BG. Náklady do HeO bude možné stiahnuť manuálne alebo automaticky v nastavených časoch.

Rozšírenie formuláru Externé systémy – Ekonomika záložka HeO

Vznikne nová záložka, v ktorej bude nastavenie prepojenia s HeO, tak ako je to riešené v Horci. Formulár obsahuje:

• Povolený / zakázaný
• Host
• Port
• Prihlasovacie meno
• Prihlasovacie heslo

Metóda na import zákazky z HEO

Vstupné parametre:

• ID systému BG

Výstupné parametre:

• Firma
• Externé číslo
• IČO – povinné number(10)
• DIČ – varchar(20)
• Názov firmy – povinné varchar(200)
• Ulica - varchar(30)
• Mesto - varchar(30)
• PSČ - varchar(6)
• ID zákazky
• Číslo zákazky
• Názov zákazky
• Dátum
• Poznámka max 1000 znakov
• Finančný limit

Zoznam ponúknutých zákaziek bude obsahovať len zákazky, ktoré ešte neboli uzavreté, ukončené.

Metóda na zaslanie dodacieho listu

Vstupné parametre:

• ID systému
• ID zákazky
• Dátum realizácie
• Príznak bez alebo s DPH
• Externé číslo firmy
• položky
• Id PLU
• Číslo PLU
• Názov
• Merná jednotka
• Množstvo
• sadzba DpH
• Jednotková predajná cena
• Predajná cena spolu

Výstupné parametre

• T/F

Pri objednávke sa ukladajú parametre

• ID zákazky,
• číslo zákazky ,
• názov zákazky ,
• limit zákazky,
• externé číslo firmy
• príznak že objednávka prišla z HeO.

Úprava formuláru Pohyby jedál – objednávanie fGastroPohybyObjednavanieVstup (Spolocne stravovanie - Objednavky jedal - Nova objednavka

• Nové tlačidlo Číslo zákazky – po jeho stlačení sa dopýtame na zoznam zákaziek z HEO
• Nové pole Číslo zákazky bude vyplnené automaticky po výbere zákazky alebo bude možný aj manuálny vstup
• Nové pole Limit akcie, bude vyplnený automaticky alebo bude možný aj manuálny vstup

Po výbere zákazky systém skontroluje, či pozná externé číslo firmy alebo IČO. Ak nie, systém vytvorí v tabuľke obchodných partnerov nový záznam. Pokiaľ také IČO existuje a pri firme nie je vyplnené externé číslo, tak ho systém doplní.

Hlavička Objednávky jedál sa naplní všetkými dostupnými údajmi:

• Dátum
• Číslo zákazky
• Názov
• Odberateľa - IČO a názov
• Limit akcie
• Poznámku

Hlavičku je možné ľubovoľne upraviť. Po jej odsúhlasení sa otvorí okno pre zadanie položiek objednávky.

Úprava formuláru Pohyby jedál - objednávanie (fGastroPohybyJedla)

• Formulári je rozšírený o stĺpec Úroveň oprávnenia

• Ak bude k akcii priradená zákazka z HEO, je možné do akcie vkladať iba PLU, ostatné tlačidla Nové jedlo, Nový tovar a Nová služba sú neaktívne.
• Upravené správanie sa pri výbere položiek – ak používateľ vyberieme cenu za pokladňu, systém si pokladňu pamätá a táto sa nastaví v ďalšom novom zázname
• Zadávanie záporného množstva PLU je povolené

V spodnej časti formuláru je zobrazené:

• Limit akcie / prevzatý z HeO/,
• Predajná cena spolu
• Kalkulačná cena spolu
• Rozdiel medzi predajnou cenou spolu a kalkulačnou cenou spolu
• Rozdiel P.C a limit/ medzi predajnou cenou spolu a limitom/

1. Zápis čísla zákazky k odbytu - pri odbyte si systém zapíše k dokladu aj číslo zákazky t.j bude ho zapisovať do G_DOKLAD_POHYBY_TOVARU.POD_ECONOMIY_ORDER_ID
2. Export dodacieho listu - Pokiaľ je Objednávka jedál viazaná na zákazku v HeO, po jej spracovaní používateľ zašle do Heo dodací list, tlačidlo HeO
3. Ak má objednávka príznak, že prišla z HeO systém nedovolí Opravu/ storno dokladu(Sklad - pohyby - Storno/oprava dokladov)
4. Ak je objednávka poslaná ako spracovaná /zrealizovaná, nebude ju možné stornovať ani opravovať. Pokiaľ vznikne potreba opravy, používateľ vytvorí novú opravnú akciu na rovnakú zákazku

Popis webových služieb pre prepojenie HeO a BlueGastro.

Metóda “login” Metóda login slúži na prihlásenie.

Vstupné parametre:

• User
• Password
• Remember – parameter či sa má user odhlasovať (0- áno, 1 - nie)
• Format – xml alebo json

Požiadavka: http://server:port/heows/Login?user=xxxxxxx&password=xxxxxx&remember=1&format=json

JSON návratovej správy "Result": { "value": "9F26018F-501C-4109-AFCE-7A2E41954694", "error": "0" }

• Value – hodnota, ktorá sa zadáva do vstupných parametrov pri dopyte na vystavené WS

Ak je error 0 tak value vracia GUID, inak je vo value popis chyby.

Metóda “logout” Metóda logout slúži na odhlásenie používateľa a vyresetuje sa GUID

Vstupné parametre:

• guid – návratová hodnota z metódy Login
• format – xml alebo jason

Požiadavka:

http://server:port/heows/Logout?guid=9F26018F-501C-4109-AFCE-7A2E41954694&format=json

JSON návratovej správy "Result": "value": "User with GUID 9F26018F-501C-4109-AFCE-7A2E41954694 successfully logged out", "error": "0"</ }

Ak je error 0, tak value je informácia o úspešnom odhlásení, inak je vo value popis chyby.

Metóda “getOrder” Metóda na získanie dostupných zákaziek

Vstupné parametre

• Userguid – návratová hodnota z metódy Login
• Input – ID systému BlueGastro / zatiaľ v HeO nie je dopracované/
• Format – xml alebo jason

Požiadavka: http://server:port/heows/Execute?method=GetOrder&userguid=9F26018F-501C-4109-AFCE-7A2E41954694&input=A&format=json

JSON návratovej správy

"Result": {, "value": {, "Zoznam": {, "Zakazka": [, {"ID": "10", "Cislo": "7", "Nazov": "Catering Koktejl", "Datum": "2018-09-28T14:00:00", "OrgID": "5", "OrgCislo": "4", "OrgNazov": "BILLA s.r.o.", "OrgICO": "31347037", "OrgDIC": "SK2020312503", "Ulica": "Bajkalská 19/A ", "Mesto": "Bratislava ", "PSC": "82102", "PocetUcastnikov": "20", "Limit": "499.50", "Popis": "Večera s prípitkom, jedno jedlo, kava, nealko"} }, "error": "0"

Ak je error 0, tak value vracia zoznam zákaziek, inak je vo value popis chyby.

• ID - ID zákazky v systéme HeO
• Cislo – číslo zákazky, vie ho zmeniť aj používateľ / 15 znakov/
• Nazov – názov zákazky / 100 znakov/
• Datum – dátum realizácie zákazky / formát YYYY-MM-DD/
• OrgID – ID firmy /
• OrgCislo – jednoznačný identifikátor firmy
• OrgNazov – Názov firmy
• OrgICO – IČO firmy
• OrgDIC – IČ DPH firmy
• Ulica – ulica a číslo sídla firmy
• Mesto – mesto sídla firmy
• PSC – PSČ sídla firmy
• PocetUcastnikov – počet osôb
• Limit – finančný limit akcie
• Popis – text max 1000 znakov

Metóda “SaveDeliveryNote” Metóda na zápis dodacieho listu do HeO.

Vstupné parametre:

• Method – názov metódy
• Userguid - návratová hodnota z metódy Login
• Format - "text/plain", jedine tento formát zabezpečí správny import dodacieho listu
• Input – json dáta dodacieho listu ako string
• Svsid- ID dodacieho listu
• Zakazkaid – ID zákazky
• Datrealizacie – dátum realizácie
• Cenasdph – príznak či je cena s DPH alebo bez DPH A/N
• Orgcislo – externé číslo firmy
• Stav – stav objednávky, môže nadobúdať hodnotu S alebo O
• Pluid – ID PLU
• Plucislo – číslo PLU
• Nazov – názov PLU
• Mj – merná jednotka
• Mnozstvo - množstvo
• Sadzbadph – sadzba DPH môže nadobúdať hodnoty 20/10/0/ prázdny reťazec
• Jedncena- jednotková cena
• Cena – cena spolu

Požiadavka:

"input": {, "method": "SaveDeliveryNote", "userguid": "46E6527A-2C33-4F13-B2AE-8854DA784BF1", "format":"text/plain", "input":"{\"DodList\": {, \"hlavicka\": {, \"sysid\": \"222333\", \"zakazkaid\": \"1456\", \"datrealizacie\": \"2018-09-07\", \"cenasdph\": \"A\", \"orgcislo\": \"470w1\", \"stav\": \"S\" }, \"polozky\": { \"polozka\": [, {, \"pluid\": \"1234\", \"plucislo\": \"4088\", \"nazov\": \"Rožok\", \"mj\": \"ks\", \"mnozstvo\": \"1\", \"sadzbadph\": \"20.00\", \"jedncena\": \"1.00\", \"cena\": \"1.20\", }, {, \"pluid\": \"789\", \"plucislo\": \"564\", \"nazov\": \"mlieko\", \"mj\": \"ks\", \"mnozstvo\": \"2\", \"sadzbadph\": \"20.00\", \"jedncena\": \"2.00\", \"cena\": \"4.80\", }, .............

JSON návratovej správy: "Result": {, "value": 1, "error": "0" },

Ak je error 0 tak value je id dokladu čo sa zapísal do HeO, inak je vo value popis chyby.