Objednávky SB
Pro koho je aplikace určena ?
Aplikace android je určena pro zákazníky, kteří chtějí svým zákazníkům dát možnost objednání zboží právě pomocí mobilní aplikace. Výsledkem je založení expedičního příkazu v informačním systému. Samotná aplikace, na základě knihovny MANTA 2.0. API + konfigurace MANTA + rozšíření o datové view. Přístup bude od zákazníků směrem do WS nainstalované u zákazníka. Zápis bude probíhat přes API rozhraní přímo do DB HEI.
 |
 |
 |
 |
 |
 |
 |
|---|
Technické info
| SPMANTA_CheckQR | Procedura | Popis |
| Vstup: QR,CompanyCode,EmployeeId | Vystup: Id,OrderQuantity,Description,EU (-1= chyba) | SPMANTA_CheckQR QR nvarchar(255), CompanyCode int, EmployeeId int
Procedura na základě vstupních parametrů dohledá informace o kmenové kartě. Výstup: Id int, OrderQuantity numeric(19,6), Description nvarchar(max), EU nvarchar(10) Chyba: Id=-1 |
| SPMANTA_SaveOrder | Procedura | Popis |
| Vstup: CompanyCode,TerminalId,EmployeeId | Vystup: Id,Status (-1= chyba) | SPMANTA_SaveOrder CompanyCode int, TerminalId int, EmployeeId int
Procedura na základě vstupních parametrů založí objednávku EP do systému HeI. Výstup: Id int, Status nvarchar(255) Chyba: Id=-1 |
| SPMANTA_CheckCompanyCode | Procedura | Popis |
| Vstup: CompanyCode | Vystup: Id, Id,Status (jméno organizace ) (-1= chyba) | SPMANTA_CheckCompanyCode CompanyCode varchar(8)
Procedura na základě vstupního parametru ověří přístup organizace. Výstup: Id int, Status nvarchar(255) – pokud OK název organizace Chyba: Id=-1 |
| SPMANTA_AddCompanyCode | Procedura | |
| Vstup: ID místa určení | Vystup: založení čísla do ES organizace | SPMANTA_AddCompanyCode Id int
Procedura na základě vstupního parametru přiřadí organizaci kód pro přístup. Výstup: přiřazení kódu organizaci |
| SPMANTA_RemCompanyCode | Procedura | |
| Vstup: ID místa určení | Vystup: odebrání čísla z ES organizace | SPMANTA_RemCompanyCode Id int
Procedura na základě vstupního parametru odebere organizaci kód pro přístup. Výstup: odebrání kódu organizaci |
| SPMANTA_AddCompanyUser | Procedura - zpracováno v rámci pluginu komunikace s WS | |
| Vstup: ID místa určení,name,login,RFID,password | Vystup: založení uživatele do MANTY | SPMANTA_AddCompanyUser Id int, name nvarchar(100), login nvarchar(50), RFID nvarchar(50)
/*upraveno pro založení uživatele se použije plugin, který komunikuje s API*/ Procedura na základě vstupních parametrů založí uživatele do Manty včetně role. Výstup: založení uživatele do MANTY - doplněny metody pro opravu a smazání uživatele v rámci pluginu |
| SPMANTA_OrderItems | Procedura | |
| Vstup: Mode,TerminalId,CompanyCode,EmployeeId
,ItemId,ItemQuantity,DeliveryDate,OrderItemsId, Note |
Vystup: ID, status ‘900000’ = OK | SPMANTA_OrderItems Mode int, TerminalId int, CompanyCode int, EmployeeId int, ItemId int, ItemQuantity numeric(19,6), DeliveryDate datetime, OrderItemsId int, Note nvarchar(max)=null
Procedura na základě vstupních parametrů vloží, upraví nebo smaže řádek objednávky. Výstup: Id, Status=’900000’ – OK Chyba: Id=-1 Mode nabývá hodnot 0-delete, 1-insert, 2-update V mode 0 a 2 je nutné vyplnit parametr OrderItemsId označuje řádek ve view
|
| SPMANTA_GetList | Procedura | |
| Vstup: CompanyCode, EmployeeId | Vystup: ID, TerminalId, CompanyCode, EmployeeId, ItemId, ItemQuantity, EU, DeliveryDate, CreateDate, Author, ChangeDate, Changed, Processed, Note, Nazev1, RegCis | SPMANTA_GetList CompanyCode int, EmployeeId int
Procedura na základě vstupních parametrů vrátí položky, pro daného uživatele a organizaci, které ještě nebyly uloženy do EP. Výstup: ID, TerminalId, CompanyCode, EmployeeId, ItemId, ItemQuantity, EU, DeliveryDate, CreateDate, Author, ChangeDate, Changed, Processed, Note, Nazev1, RegCis Chyba: Id=-1 |
| TABMANTA_OrderItems | Tabulka |
| ID | Int |
| TerminalId | Int |
| CompanyCode | Int |
| EmployeeId | Int |
| ItemId | Int |
| ItemQuantity | Numeric(19,6) |
| EU | Nvarchar(10) |
| DeliveryDate | Datetime |
| Date | Datetime |
| Author | Nvarchar(255) |
| Processed | Bit |
| Note | Poznámka (chyba) |
Funkční schéma
Instalace APK (interní)
· Připojit se k webové službě na PC IP adresa a port konfigurace se může dle instalace lišit.
· Vybrat správný profil (Ostrá/Cvičná/…..)
· Zadat jméno a heslo pro přístup do konfigurace WS
· Menu aplikace - Správa APK balíčků
· Vybrat Aplikaci „Servisbal Objednavky“
· Ukázat myší na čtvereček QR nejnovější verze
· Načíst v mobilním zařízení zobrazený čárový kód a stáhnout APK balíček. Bude nutné potvrdit bezpečnostní upozornění. Ve stažených souborech najít APK balíček a nainstalovat. Variantně lze zobrazený QR kód z webové služby zkopírovat a zaslat zákazníkovi elektronicky (emailem, vytavit na web …). Pak zákazník načítá pouze zaslaný kód pro instalaci a kód pro konfiguraci (viz níže)
Po spuštění se zobrazí konfigurace. V menu vpravo nahoře volba načíst konfiguraci pomocí QR
· Pak je nutné vyplnit jedinečný identifikátor zařízení NNNNTAB/TEL99 (např.NVSPTAB01 nebo SBALTEL99). Konfiguraci uložit tlačítkem „fajfky“.
· Pokud je vše v pořádku naskočí dialog pro přihlášení do aplikace. Zde je potřeba zadat přihlašovací údaje buď číslo čipu, nebo jméno a heslo. Default se dá nastavit v konfiguraci aplikace volba základní přihlášení.
· Následně je obsluha vyzvána k zadání ČK organizace (ten je vygenerovaný nad Číselníkem organizací v HELIOSU a zákazníkovy zaslán jako PDF nebo obrázek v emailu).Bez zadání platného kódu není možné s aplikací dále pracovat !
Aktualizace aplikace
Při přihlášení aplikace k webové službě je vždy kontrolováno, zda neexistuje novější verze aplikace. Pokud ano je obsluze nabídnuta ke stažení a instalaci.
Na některých verzích Android je třeba potvrdit bezpečnostní opatření. Následně je doporučeno aplikaci ukončit (odstranit z paměti) a znovu se přihlásit. Aktuální číslo buildu je uvedeno v hlavičce při zobrazení konfigurace.
Nastavení na straně HELIOSU iNuvio
Nastavení skladu pro import
Pro správnou funkcionalitu je nutné v číselníku organizační struktury označit přes externí akci sklad, na který se budu generovat objednávky z aplikace. Nastavení se provádí akcí nad označeným skladem, která označí příslušný sklad pro import a zkontroluje označení na ostatních skladech (tedy vždy bude oz načen právě jeden sklad).
Příslušnou akci najdeme nad přehledem Organizační struktura Doplňky -> Manta založení EP -> Označení skladu pro import
Nastavení řady dokladů pro import
Pro správnou funkcionalitu je nutné v číselníku řad dokladů označit přes externí akci řadu EP, na kterou se budou generovat objednávky z aplikace. Nastavení se provádí akcí nad označenou řadou, která označí příslušnou řadu pro import a zkontroluje označení na ostatních řad (tedy vždy bude označena právě jedna řada).
Příslušnou akci najdeme nad přehledem Řady dokladů Doplňky -> Manta založení EP -> Označení řady dokladů pro import
Povolení organizace pro aplikaci
Povolení organizace pro aplikaci se provádí nad číselníkem organizací. Označit lze jak fakturační organizaci, tak i organizaci, která slouží jako místo určení (organizaci podřízenou, dle struktury organizací v HeI). Pro organizaci je vygenerován kód organizace, který jednoznačně identifikuje danou organizaci. Pokud je organizace podřízenou organizací při importu objednávky je automaticky dohledána organizace fakturační, dle struktury organizací v HeI.
Pro povolení organizace je k dispozici akce, která se spouští nad označenými záznamy, pokud již organizace nemá přidělen kód, akce organizaci kód přidělí.
Příslušnou akci najdeme nad přehledem Číselník organizací
Doplňky -> Manta založení EP -> 1. Založ kód pro organizaci
Doplňky -> Manta založení EP -> 2. Zruš kód pro organizaci
Doplňky -> Manta založení EP -> 3. Přidej pro organizaci
Doplňky -> Manta založení EP -> 4. Přehled uživatelů pro organizaci
Nad přehledem uživatelů pro organizaci je možná jejich editace a odebrání z Manty.
Nad číselníkem organizací je rovněž možné tento přidělený kód vytisknout ve formě QR. Příslušný tiskový formulář je k dispozici přes standardní tisk v HeI.
Takto vytištěný kód lze načíst do aplikace a ověřit tak firmu, že je povolena pro zakládání EP v systému HeI. Pokud organizace nemá vygenerován QR kód, v aplikaci neprojde validací a není možné s aplikací dále pracovat.
Pokud je zapotřebí organizaci odebrat přístup je k dispozici akce pro odebrání kódu organizace. Podmínkou pro úspěšné odebrání práva na zápis objednávek je, že nesmí existovat pro příslušnou organizaci, žádné nezpracované záznamy v tabulce položek objednávek. Akce se spouští rovněž nad označenými záznamy.
Příslušnou akci najdeme nad přehledem Číselník organizací
Doplňky -> Manta založení EP -> 1. Zruš kód pro organizaci
Třetí akce nad přehledem organizací nám umožňuje přidat si login pro příslušnou organizaci, pro přihlášení do Manty. Protože tato akce komunikuje s API je zapotřebí v konfiguraci nad pluginem provést nastavení na příslušnou adresu instalovaného API.
_nvspCompanyID – vazba na ID organizace, ke které byl login založen
_nvspPassManta – uloženo nehashované heslo pro potřeby SB
Příslušnou akci najdeme nad přehledem Číselník organizací
Doplňky -> Manta založení EP -> 3. Přidej uživatele pro organizaci
Pro komunikaci pluginu s API je zapotřebí nad Nástroje přizpůsobení -> Externí akce -> Záložka akce -> Pluginy Zvolit příslušný plugin a přes Akce -> Konfigurace -> Oprava parametrů doplnit cestu k API Manta (adresa a port jsou závislé na konkrétní instalaci), dodatečné údaje lze nalézt nad číselníkem zaměstnanců ve sloupcích
Přehledy
V HeI byl vytvořen uživatelsky definovaný přehled Položky uživatelských objednávek - hvw_TABMANTA_OrderItems.
V definovaném pohledu je k dispozici vazba na kmenovou kartu.
Uživatelská dokumentace
Nová instalace aplikace
Od dodavatele dostanete elektronicky dokument se čárovými kódy.
První čárový kód slouží pro stažení APK balíčku, druhý pro nastavení komunikace a třetí pro zadání přiděleného čísla organizace. Pečlivě zkontrolujte, zda je v obdrženém dokumentu v záhlaví, název vaší organizace. Pokud ne, neprodleně kontaktujte dodavatele a vyžádejte si nový dokument.
V mobilním zařízení spusťte čtečku čárových kódů většinou skupina Nástroje – Scaner, někde může být i externí aplikace nebo dokonce HW čtečka čárových kódu.
Po sejmutí čárového kódu budete dotázání zda přejít na webovou stránku. Po potvrzení naskočí dialog zda opravdu stáhnou. V posledním dialogu (po stažení) kliknout na otevřít.
plikace pracuje v ON-LINE režimu a je tedy nutné mít po celou dobu práce zapnuté připojení do internetu. Dostupnost komunikace s WS je signalizováno ikonou LED diody v levém korním roku. Zelená barva komunikace je navázána. Červená barva komunikace je přerušena.
Aktualizace aplikace
Při přihlášení aplikace k webové službě je vždy kontrolováno, zda neexistuje novější verze aplikace. Pokud ano je obsluze nabídnuta ke stažení a instalaci.
Na některých verzích Android je třeba potvrdit bezpečnostní opatření. Následně je doporučeno aplikaci ukončit (odstranit z paměti) a znovu se přihlásit. Aktuální číslo buildu je uvedeno v hlavičce při zobrazení konfigurace profilu.
Nastavení profilu
Po instalaci aplikace a prvním spuštění je třeba vyplnit komunikační profil aplikace.
Pokud není vyplněn žádný profil nebo se pomocí zadaných informací nejde přihlásit k webovému serveru, zobrazí se obrazovka pro zadání profilu automaticky. V menu vpravo nahoře (tři tečky) volba Načíst konfiguraci pomocí QR
Pak je nutné vyplnit jedinečný identifikátor zařízení NNNNTAB/TEL99. Kde NNNN jsou první čtyři znaky z názvu vaší organizace (bez diakritiky )Konfiguraci uložit tlačítkem „fajfky“.
Pokud je vše v pořádku, zobrazí se dialog pro přihlášení do aplikace. Zde je potřeba zadat přihlašovací údaje buď číslo čipu, nebo jméno a heslo. Povolená jména a hesla jsou zaslány s informacemi pro instalaci nebo separátně na vyzvání. Default přihlašování se dá nastavit v konfiguraci aplikace volba základní přihlášení.
Zadání přiděleného čísla organizace
Po prvním přihlášení do aplikace budete vyzvání k zadání čísla organizace. Kliknutím na ikonu čárového kódu se aktivuje čtečka ČK a pomocí ní sejmete ze zaslaných instrukcí čárový kód zákazníka. Dialog uložíte tlačítkem Uložit. Dojde k ověření platnosti ČK, pokud je vše OK, můžete začít s aplikací pracovat. V případě chyby kontaktujte dodavatele, a bude zřejmě nutné revidovat přidělený ČK. Bez platného kódu zákazníka nelze aplikaci používat. Kód zákazníka (dialog pro zadání ČK) , lze vyvolat v menu, vpravo nahoře (tři tečky).
Zadání položek do objednávky
Po spuštění aplikace a přihlášení je zobrazena záložka Položka , kde můžeme ihned začít zadávat nebo snímat zaslané kódy položek. Kód lze zadat ručně nebo pomocí ikony čárového kódu nasnímat čtečkou ČK. Po potvrzení kódu položky, je ověřena platnost ČK a dohledána položka. Informace o položce se zobrazí v okně informací. Pokud nebude položka dohledána, zobrazí se chyba a musí se nasnímat jiný kód. Do pole Počet kusů k objednání se vyplní příslušný počet požadovaných množstevních jednotek a do pole Dodání se vyplní požadovaný termín pro dodání položky. Zadání položky se potvrdí tlačítkem OK v dolní části. Pole aktuálně objednáno zobrazuje jaké množství má Vaše organizace u dodavatele objednáno a ještě nedodáno. Potvrzením zadání položky se záznam přesune do seznamu na druhé záložce Objednávka. Na této záložce lze prohlížet zadané položky ještě před finálním vystavením objednávky. Položky lze smazat nebo případně editovat. Dlouhým stiskem nad konkrétní položkou dojde k zobrazení kontextového menu s volbami Upravit a Smazat. Volba Upravit umožní editovat požadované množství a termín dodání. Volba Smazat zruší komplet celou zadanou položku.
Vystavení objednávky
Vystavení objednávky se provede na druhé záložce Objednávka tlačítkem Odeslat objednávku v dolní části. Budete informováni o průběhu zpracovávání objednávky. Délka zpracování je závislá na rychlosti připojení a množství zpracovávaných položek. Vždy vyčkejte až zhasne informace o zpracování a ukáže se dialog potvrzující vystavení objednávky. V případě vzniku chyby je nutné kontaktovat dodavatele. Aplikaci ukončíte v menu vpravo nahoře (tři tečky) volbou Ukončit nebo Odhlásit.