Integrace s ECR terminály¶

Využijte naší integraci s ECR terminály pro zvýšení efektivity vašich prodejních procesů. Naše řešení je certifikováno společností Global Payments Europe s.r.o. pro následující země:

• Česká republika
• Slovensko
• Maďarsko

Co potřebuji k integraci POS Base/POS Base CZ s ECR terminály?¶

Pro integraci naší aplikace Navertica POS Base/Navertica POS Base CZ s ECR terminály společnosti Global Payments potřebujete:

1) hardware požadovaný společností Global Payments Europe s.r.o.

2) nainstalovanou a nakonfigurovanou aplikaci Navertica POS Base či Navertica POS Base CZ

3) naistalovanou a nakonfigurovanou aplikaci Navertica POS GPE Connector (detaily konfigurace Vám rádi poskytneme)

4) lokální službu, která zprostředkovává komunikaci s ECR terminálu (pro zpřístupnění této služby nás prosím kontaktujte)

Technické detaily¶

Řešení v tuto chvíli podporuje protokol GPE + iCT220 / IP.

Jak integrované řešení funguje?¶

Integrace jako taková příliš nemění běžé zpracování vašich prodejních transakcí. Z pohledu uživatele jedinou změnou, ke které dojde je, že při zadávání úhrady účtenky nemusí uživatel zadávat ručně autorizační kód platební transakce, nicméně i přesto by bylo vhodné popsat jednotlivé změny standardního procesu.

Zpracování plateb účtenek a servisních faktur¶

Integrace s ECR terminály byla implementována do všech základních prodejních procesů.

Úspěšná platba¶

V případě, že zpracováváte standardní platbu účtenky, pak v rozhraní pro zadávání plateb vyberete způsob platby Kartou. Do tohoto rozhraní byla přidána dvě nová pole:

• Zpracováno terminálem ECR (v případě, že nedojde k úspěšnému zaúčtování účtenky v BC, ale platba proběhla úspěšně, toto pole bude zatrženo. V případě, že je toto pole zatrženo, platba nebude opětovně odesílána na platební terminály)
• Manuálně zpracováno (kým) (v případě, že uživatel zadal platbu manuálně, bude jeho ID uvedeno v řádku se způsoby platby v tomto poli)

Zpracování platby je stejné jak pro případ zpracování platby účtenky, tak pro zpracování úhrady servisní faktury. Všechny níže popsané akce jsou dostupné pro oba typy transakcí.

Jakmile uživatel zadá způsob úhrady Karta a zadá požadovanou částku, zvolí standardně akci Zavřít a zaúčtovat. Tím dojde k zobrazení stavového dialogu komunikace s ECR terminálem. V dialogu je zobrazen odpočet času, po který probíhá komunikace s ECR zařízením. Tento čas se resetuje s každým handshakem v případě, že zpracování transakce trvá déle než jednu minutu (například v případě, že uživatel zadává číslo karty manuálně na platebním terminálu)

V případě, že karta, kterou je prováděna úhrada, vyžaduje ověření podpisu, uživateli v POS se zobrazí dialog, který jej vyzve k potvrzení správnosti podpisu zákazníka. V případě, že uživatel zvolí volbu ANO, přijímá tím podpis zákazníka a platba bude úspěšně dokončena. V případě, že uživatel zvolí volbu NE, platba není akceptována a dochází ke stronu provedené platby na terminálu.

V případě, že dojde k úspěšnému zaúčtování platby i samotného dokladu, dojde standardně k tisku účtenky.

V případě, že uživatel zvolí platbu více kartami, musí dojít ke zpracování jednotlivých plateb samostatně. Po stisknutí akce "Zavřít a zaúčtovat" jsou jednotlivé platby zasílány do ECR zařízení v pořadí, ve kterém byly zadány do rozhraní pro správu způsobů platby. Všechny platby musí být úspěšně zpracovány, aby došlo k zaúčtování účtenky.

Výsledkem úspěšné transakce s ECR terminálem je rovněž to, že autorizační kód platby je automaticky přenesen z ECR zařízení do POS a je poznačený k jednotlivým způsobům platby účtovaného POS dokladu.

Autorizační kód se rovněž propisuje do pole Číslo externího dokladu do položek zákazníka a může tudíž být využit pro párování plateb.

Detaily komunikace s ECR zařízením jsou ukládány do Položek ECR. V případě zpracování této platby. V tomto případě dojde ke vzniku 9 položek. Tyto položky mají následující význam (v pořadí, ve kterém vznikají):

1. Položka typu PAYMENT zahrnující variabilní symbol transakce, částku transakce a její měnu. Tento řádek je odesílán do ECR, všechny ostatní položky jsou z ECR přijímány.
2. Položka typu CARDID obsahující maskované číslo karty, kterou byla provedena platba
3. Položka typu ISSUER obsahující název vydavatele karty (například MASTERCARD, VISA)
4. Položka typu AUTH obsahující autorizační symbol transakce, který se propíše do řádku způsobu platby u příslušného dokladu
5. Položka typu VS neobsahuje žádné doplňující informace pro uživatele
6. Položka typu PREAUTH neobsahuje žádné doplňující informace pro uživatele
7. Položka typu SEQ neobsahuje žádné doplňující informace pro uživatele
8. Položka typu AMOUNT obsahuje částku transakce v notaci terminálu (tzn. neobsahuje oddělovače desetinných míst ani statisíců)
9. Položka typu OK neobsahuje žádné doplňující informace pro uživatele

V případě, že transakce vyžaduje potvrzení podpisu, položka z kroku 9 obsahuje informaci, že potvrzení podpisu je nutné k úspěšnému dokončení platby. Potvrzení správnosti podpisu uživatelem POS je následně poznačeno do položek ECR jako dodatečný řádek, který v sobě zahrnuje informaci, zda potvrzení podpisu bylo úspěšné či nikoliv (položky ECR pro transakci s vyžadováním podpisu jsou zobrazeny na printscreenu níže)

Neúspěšné platby¶

K neúspěšné platbě může dojít z několika důvodů. Každá situace vyžaduje jiné chování uživatele, proto budou popsány samostatně.

Překročení kreditního limitu¶

Jedním z nejběžnějších důvodů, proč platba nemohla být zpracována je, že dojde k zamítnutí platby ECR zařízením, například v důsledku překročení kreditního limitu použité karty či k překročení maximálního možného objemu transakcí.

Výsledkem této situace je, že dojde ke zrušení platby jako takové. Uživatel bude o této informaci notifikován aplikačním dialogem.

V tomto případě musí uživatel rozhodnout, zda dává smysl pokusit se platbu provést znovu (v některých případech může pomoci vložení karty do platebního terminálu) či zda zvolí jiný způsob platby dokumentu. Pokud uživatel chce restartovat zpracování platby na ECR terminálu, stačí pouze na účtence znovu použít akci Zavřít a zaúčtovat.

V případě toho důvodu neúspěšné platby dojde ke vzniku 6 položek ECR:

1. Položka typu PAYMENT zahrnující variabilní symbol transakce, částku transakce a její měnu. Toto je jediná zpráva, která je přenášena z BC do ECR. Všechny ostatní zprávy jsou přenášeny z ECR do BC.
2. Položka typu CARDID neobsahující doplňující informace pro uživatele (karta byla terminálem zamítnuta)
3. Položka typu ISSUER neobsahující doplňující informace pro uživatele (karta byla terminálem zamítnuta)
4. Položka typu AUTH neobsahující doplňující informace pro uživatele
5. Položka typu PREAUTH neobsahující doplňující informace pro uživatele
6. Položka typu ERR v tomto případě obsahuje kód chybové zprávy a chybové hlášení s detailnějším popisem příčiny chyby.

Neplatný podpis¶

Platby s vyžadovaným podpisem jsou zpracovávány tak, že terminál nejprve provede strhnutí částky z účtu zákazníka a zašle do BC zpět informaci, že uživatel musí ověřit podpis zákazníka. V případě, že uživatel potvrdí, že podpis je v pořádku, dojde k úspěšnému zpracování platby. V případě, že uživatel zvolí volbu NE, platba není akceptována a dojde k iniciaci storna provedené transakce s terminálem (nevyžaduje akci uživatele).

V případě, že dojde k inicializaci storna transakce (tudíž podpis zákazníka není akceptován uživatelem prodejny), uživatel o tom bude informován pomocí komunikačního dialogu o odeslání storna do ECR. ECR terminál po dokončení storna automaticky vytiskne potvrzení pro zákazníka.

Jakmile dojde k dokončení storna terminálem, uživatel bude o celkovém neúspěšném provedení platby informován následujícím dialogem. Jelikož na straně BC ještě nedošlo k účtování v POS rozhraní, není potřeba provádět žádné storno na straně BC.

Po provedení storna je uživatel vrácen zpět do účtenky. Uživatel se buď může vrátit do rozhraní pro provádění plateb a restartovat zpracování platby, nebo může zvolit způsob platby v případě, že platba kartou ze strany zákazníka není možná.

V tomto případě je komunikace s ECR rozdělena do dvou sekcí. V první sekci dojde k provedení platby a položky ECR vypadají následovně:

1. Položka typu PAYMENT obsahující variabilní symbol, částku transakce a její měnu. Tento typ položky je jediný, který je přenášen z BC do ECR. Ostatní položky vedoucí k úspěšnému zpracování platby jsou přenášeny z ECR do BC.
2. Položka typu PING neobsahující žádné dodatečné informace pro uživatele (tato položka se může vyskytnout v libovolné transakci, která trvá déle, než je nastavený čas pro tzv. handshake, tedy obnovení konunikace, tato položka nemá význam pro zpracování transakce - pouze udržuje otevřenou komunikaci mezi BC a ECR)
3. Položka typu CARDID obsahující číslo karty, kterou byla provedena platba
4. Položka typu ISSUER obsahující název společnosti, která vydala kartu, kterou byla platba provedena
5. Položka typu AUTH obsahující autorizační kód transakce
6. Položka typu VS neobsahující žádné doplňující informace pro uživatele
7. Položka typu PREAUTH neobsahující žádné doplňující informace pro uživatele
8. Položka typu SEQ neobsahující žádné doplňující informace pro uživatele
9. Položka typu AMOUNT obsahující potvrzenou částku transakce z terminálu v notaci terminálu (bez oddělovačů desetinných míst či tisíců)
10. Položka typu OK obsahující žádost o potvrzení podpisu
11. Položka typu OK obsahující výsledek potvrzení podpisu (v tomto případě negativní), který vede k iniciaci nové transakce storna s terminálem

Druhá sekce je poté vztažena ke stornu transakce a vznikají v jejím rámci následující položky ECR:

1. Položka typu REVERSE obsahující variabilní symbol, autorizační symbol provedené platby a částku transakce. Tato položka je odesílána z BC do ECR.
2. Položka typu CARDID neobsahující žádné doplňující informace pro uživatele
3. Položka typu ISSUER neobsahující žádné doplňující informace pro uživatele
4. Položka typu AUTH neobsahující žádné doplňující informace pro uživatele
5. Položka typu VS neobsahující žádné doplňující informace pro uživatele
6. Položka typu PREAUTH neobsahující žádné doplňující informace pro uživatele
7. Položka typu SEQ neobsahující žádné doplňující informace pro uživatele
8. Položka typu OK neobsahující žádné doplňující informace pro uživatele

Selhání jedné z více plateb¶

V případě, že dojde k selhání jedné z více plateb, uvidíte na terminálu úspěšně provedené platby označené příznakem Zpracováno terminálem ECR

Položky ECR pro úspěšně provedenou platbu jsou stejné jako byly popsány v kapitole úspěšně provedené platby. Položky ECR pro zamítnutou platbu jsou shodné jako bylo popsáno výše v kapitolách věnovaných jednotlivým možným důvodům zamítnutí platby.

V tomto případě může uživatel buď restartovat zpracování platby na ECR terminálu použitím akce Zavřít a zaúčtovat nebo může provést změnu způsobu platby v rozhraní pro zadávání plateb (například na hotovostní platbu). Další možností rovněž je platbu na terminálu zadat ručně (manuálnímu zpracování platby bude věnována samostatná kapitola).

Timeout transakce & technické problémy¶

Jedna z posledních nejběžnějších příčin neúspěšného zpracování chyby je buď vypršení limitu žádosti, technický problém nebo například předčasné ukončení transakce uživatelem (například tím, že v dialogu pro zpracování platby klikne na Storno).

V tomto případě dojde k situaci, kdy platba je úspěšně zpracována terminálem, ale nedošlo k jejímu korektnímu propsání do BC k příslušné účtence. V takovém případě položky ECR vypadají následovně. V tomto případě vypadají na první pohled stejně jako položky pro úspěšně provedené transakce, ale nejsou označeny příznakem Zpracováno (jsou ve stavu Zpracováno = NE)

V takovém případě by měl uživatel znovu zvolit akci Zavřít a zaúčtovat. POS terminál nejprve projde nezpracované položky ECR a pokusí se je přiřadit k právě odesílané platbě. Pokud je taková platba nalezena, nedojde k opětovnému zahájení komunikace s ECR. ECR položky se zpracují a následně označí jako zpracované.

Manuální zpracování platby¶

V případě, že komunikace s ECR není funkční (například v důsledku problémů s lokální službou), může uživatel stále zpracovat platbu manuálně. Do rozhraní pro zadávání plateb byla přidána nová akce "Označit jako zpracovaný"

Po spuštění této akce se uživateli zobrazí aplikační dialog pro zadání autorizačního kódu.

Po potvrzení aplikačního dialogu dojde k označení platby v rozhraní pro zadávání plateb jako "Zpracováno terminálem ECR" a zároveň k vyplnění pole "Manuálně zpracováno (kým)". Uživatel může následně standardně zvolit akci Zavřít a zaúčtovat a již nedochází k iniciaci platební transakce s terminálem.

Storno platby¶

V případě, že platba již proběhla, ale uživatel z nějakého důvodu potřebuje platbu stornovat před dokončením účtování účtenky v POS, musí uživatel použít akci "Stornovat platbu" v POS rozhraní pro zadávání plateb. Při spuštění funkce dochází ke kontrole, že platba ve způsobech plateb dokladu je označená příznakem Zpracováno terminálem ECR, jinak není možné tuto akci použít a uživateli se zobrazí chybová hláška.

Po spuštění této funkce se uživateli zobrazí konfirmační dilaog vyzývající uživatele k potvrzení storna platby a její výše. V případě, že uživatel dialog potvrzení, dojde k inciiaci transakce s platebním terminálem.

V případě, že je transakce storna úspěšná, v BC uvidíte následující položky ECR.

Po úspěšném dokončení storna transakce, platba v rozhraní pro zadávání plateb v POS je označena jako Zpracováno terminálem ECR = NE. Uživatel může následně provést novou karetní platbu, či odstranit řádek s tímto způsobem platby a nahradit ho jiným.

Zpracování storen/dobropisů účtenek a servisních dobropisů¶

Dobropis můžete v POS rozhraní zpracovávat třemi způsoby:

1. použitím akce "Storno účtenky"
2. použitím akce "Vytvořit dobropis"
3. použitím akce "Vytvořit servisní dobropis"

V případě použití akce "Storno účtenky" dojde k provedení vrácení plateb stejným způsobem, jakým byly platby provedeno (uživatel tedy nemůže například změnit způsob platby z karty na hotovost). Pokud je storno platby kartou, dojde rovněž k iniciaci platební transakce s ECR terminálem a zákazník je vyzván k přiložení karty k terminálu.

V případě tohoto typu vrácení platby při úspěšném vrácení vznikne 8 položek ECR:

1. Položka typu MECHRET obsahující variabilní symbol transakce, částku transakce a její měnu.
2. Položka typu CARDID obsahující číslo karty, na kterou bylo provedeno vrácení hotovosti
3. Položka typu ISSUER obsahující název vydavatele kreditní karty, na kterou bylo provedeno vrácení hotovosti
4. Položka typu AUTH obsahující autorizační kód transakce
5. Položka typu VS neobshaující žádné doplňující informace pro uživatele
6. Položka typu PREAUTH neobsahující žádné doplňující informace pro uživatele
7. Položka typu SEQ neobsahující žádné doplňující informace pro uživatele
8. Položka typu OK neobsahující žádné doplňující informace pro uživatele

Autorizační kód z ECR terminálu je rovněž přenášen při účtování do položek zákazníka a je možné jej následně využít při párování plateb.

Zpracování platby faktury¶

V rámci Navertica POS Base CZ je k dipsozici rovněž funkcionalita pro zpracování úhrady dříve vystavených faktur. Tato funkcionalita provádí standardní zpracování karetní platby, proto může být rovněž zpracována prostřednictvím ECR zařízení. Jediným rozdílem je, že zpracování platby buď skončí úspěšným zaúčtováním transakce, či dojde ke stronu procesu a uživatel následně musí provést celou transakci znovu.

Položky ECR¶

Seznam Položek ECR je přehledem veškeré komunikace mezi ECR zařízením a POS (BC). Tento přehled obsahuje následující informace:

• servisní informace o připojení ke službě
• stav zpracování platby
• stav zpracování storna
• stav zpracování vrácení platby

Seznam Položky ECR obsahuje následující informace

Jak bylo přislíbeno výše, nyní bude uveden seznam možných Typů položek ECR.

Co musím nastavit v POS Base/POS Base CZ?¶

Nastavení pro spuštění ECR integrace je poměrně jednoduché a zabere pouze několik málo minut.

Nastavení ECR¶

Pro každý ECR terminál budete muset nastavit informace v nastavení ECR terminálu. Toto nastavení můžete vyhledat v menu pomocí klíčových slov "Terminály ECR".

Tato akce otevře následující nastavovací tabulky, ve které pro každé zařázení musíte zadat následující informace:

Z přehledu Terminálu ECR jsou k dispozici 4 akce:

• Handshake
• Uzávěrka
• Aktualizace terminálu
• Položky

Akce "Handskae" je připravena pro možnost uživatelsky vyvolat komunikaci s terminálem a ověřit stav spojení.

Akce "Uzávěrka" slouží k vyvolání tisku uzávěrky terminálu.

Akce "Aktualizace terminálu" umožňuje uživateli stáhnout poslední aktualizace pro daný terminál. V průběhu instalace aktualizací může dojít k opakovanému restartování terminálu.

Akce "Položky" umožňuje uživateli si zobrazit Položky ECR zaznamenávající průběh komunikace s daným zařízením. Položky ECR jsou protokolem komunikace s terminálem a obsahují informace přenášené mezi POS a ECR.

Nastavení POS prodejních terminálů¶

Nastavení pro propojení ECR zařízení s vaším prodejním místem je poměrně jednoché. Toto nastavení můžete provést v nastavení terminálů prodejny. V tomto nastavení budete muset zvolit ECR zařízení, se kterým má dané prodejní místo komunikovat. Toto provede přiřazení hodnoty pole ECR ID jednotlivý prodejním místům Vaší prodejny, které jsou připojeny k prodejnímu terminálu.

Nastavení měny pro ECR¶

Pro měny, které budete chtít využívat pro komunikaci s ECR zařízení, je nutné mít založenou kartu měny (toto platí i pro lokální měnu) a mít na ní vyplněný ISO kód.