ASSECO Print Manager - nastavenie

Nastavenie Debug modu

Postup:

1. zastaviť servis
2. APM súbor APM.jar otvoriť ctrl+Pdown - BOOT-INT - classes log4j - prepísať v prvom riadku info na debug - uložiť
3. pustiť servis
4. skontrolovať, niekedy sa to neprepíše, vtedy súbor prekopírovať, zmeniť, nakopírovať naspäť

Spustenie APM Servera

ASSECO Print Manager APM je aplikácia slúžiaca ako komunikačná vrstva medzi PMS a samotnými on-line registračnými pokladňami ORP.

ASSECO Print Manager APM je aplikácia slúžiaca ako komunikačná vrstva medzi PMS a samotnými on-line registračnými pokladňami ORP. APM je potrebné nainštalovať na server, t.z., že bude jeden APM pre viac inštalácii PMS. V prípade lokálnych prevádzok bude APM nainštalovaný na slave server. APM inštalačný balík je možné stiahnuť z Team’s - eKasa General – Files alebo FTP- eKasa. V prípade OS WIN musí byť 64-bit verzia.

https://teams.microsoft.com/_#/files/Development?threadId=19%3A037a4913928a47d2b61849789bb89f7c%40thread.skype&ctx=channel&context=AssecoPrintManager%2520(APM)%252FAPM%2520server

Inštalácia a spustenie APM je možné pomocou inštalačného balíka, ktorý je potrebné uložiť najlepšie do adresára DatalockHotel. Balíček obsahuje súbor Install.bat a AssecoPrintManager.bat. Súbor Install.bat slúži na inštaláciu servisov, súborom APM.bat sa spúšťa APM. Súbor je potrebné spustiť ako správca. Súbor Install.bat kontroluje, či je prítomný Framework v pc, ak nie tak ho stiahne. Druhou možnosťou je ručné spustenie APM ako NT službu. Do príkazového riadku je potrebné v adresári aplikácie APM napísať nasledovný príkaz, ktorý je potrebné spustiť s administrátorskými právami (v rovnakom adresári ako je uložený APM), Framework musí byť nainštalovaný:

• AssecoPrintManager.exe install

Pre výpis všetkých možností resp. všetkých parametrov aplikácie je potrebné zadať nasledovný príkaz:

• AssecoPrintManager.exe --help

A wrapper binary that can be used to host executables as Windows services Usage: winsw [/redirect file] <command> [<args>] Missing arguments trigger the service mode Available commands:

• 'install' - install the service to Windows Service Controller
• 'uninstall' - uninstall the service
• 'start' - start the service (must be installed before)
• 'stop' - stop the service
• 'restart' - restart the service
• 'restart!' - self-restart (can be called from child processes)
• 'status' - check the current status of the service
• 'test' - check if the service can be started and then stopped
• 'testwait' - starts the service and waits until a key is pressed then stops the service
• 'version'
• 'print' - print the version info
• 'help' - print the help info (aliases: -h,--help,-?,/?)

Spustenie a nastavenie APM

• Prístup - https://localhost(alebo IP zariadenia):5591, potvrdiť výnimku certifikátu
• Default PIN pre prihlásenie je 1111.

Zariadenia

Zoznam zariadení sa nachádza v ľavej časti prehľadu. V pravej časti prehľadu sa nachádzajú parametre jednotlivých zariadení.

• Práca so záznamami:

- uloženie záznamu
- zmazanie záznamu
- pridanie záznamu
- test tlače zariadenia. Test tlače slúži aj na odblokovanie zariadenia, v prípade že fiškál vráti hlášku eKasa zablokovaná chybným dokladom..., od verzie 1.26

• Názov zariadenia - názov ORP
• Lokácia - pracovná stanica, na ktorej je naištalovaná ORP
• Typ zariadenia - voľba z ponuky
• Štýl komunikácie požiadavka - odpoveď - potvrdiť v prípade, že ide o tento spôsob komunikácie medzi PMS a APM
• Povolené - check box Áno/Nie
• Parametre: pre každé zariadenie sú rozdielne, každé zariadenie má definovanú svoju sadu parametrov

Nastavenie parametrov zariadenia eKasa FiskalPro

• Lokácia - IP zariadenia:Port (červené tlačidlo+1, priamo na zariadení FP)
• paperWidth – počet znakov v riadku, default 40, nemeniť
• resultEncoding - nastavenie kódovej stránky, default windows-1250, nemeniť

Poznámka: FiskalPro má defaultne nastavené ID spôsobu platby, ktoré je potrebné nastaviť aj v PMS (Gastro manager):

• Hotovosť – 1
• Platobná karta – 2
• Stravné lístky – 3
• Ostatné zatiaľ nie je vyriešené, zadať jedno z uvedených.

FiscalPro má nastavené hladiny DPH defaultne: A 20%, B 10%, C 0%

Zariadenie FiskalPro može slúžiť aj ako platobný terminál, ktorý nepodporujeme. Od verzie APM-1.26 je zapracovaná lokácia, aby platba kartou nepýtala platobnú kartu. Pre nastavenie je potrebné spustiť test tlače.

Zariadenie FiskalPro má nastavenú povinnú fiškálnu uzávierku, fiškálna uzávierka však nie je podporovaná. Preto, aby bolo možné tlačiť doklady bez finančnej uzávierky, je potrebné spustiť test tlače v APM, ktorý takto vypne požadovanie fiškálnej uzávierky zariadením.

Tlačidlo Test tlače slúži tiež na odblokovanie blokovaného dokladu a na zistenie informácii o nastaveniach, ktoré používateľ nájde v logu po použití tlačidla

Po potvrdení tlačidla TEST je potrebné reštartovať zariadenie : fialové tlačidlo úplne vpravo, stlačiť klávesu 3 (nastavenie), stlačiť klávesu 2 (reštart)

Nastavenie parametrov zariadenia eKasa Taxis

Pri tomto fiskále je potrebné nastaviť hladiny DPH podľa hladín v PMS (BG a Horci).

• Lokácia - http://localhost:8080 – port služby
• VAT LEVEL A – 20
• VAT LEVEL B – 10
• VAT LEVEL C – 0
• VAT LEVEL D – 0
• VAT LEVEL E – 0
• VAT LEVEL F – 0
• username – pri všetkých fiškáloch rovnako „DKP“
• password – číslo DKP (priradené číslo KP), zistiť takto: pravým kliknúť na koníka, vybrať Get info - v tabuľke je číslo DKP. Musia byť najprv nahrané certifikáty.
• paperWidth – počet znakov v riadku, default 40, nemeniť iž je odstránené
• deviceNumber – id zariadenia
• cashDeskOpen - typ otvárania zásuvky, nastavené na A, možnosť nastaviť na B
• sendToEmailAddress- ak je APM nastavené na posielanie originálu účteniek a nie je na účtenke vyplnený mail, účtenka bude zaslaná na tento mail a nevytlačí sa

Nastavenie ID spôsobov platby v číselníku platieb v PMS (Gastro Manager):

• ID Hotovosť - 1
• ID Platobná karta - 2
• ID Iné - 3

Od verzie APM 3.19 a verzie Taxis 1.0.6 je zapracované tlačenie smenovej fiškálnej uzávierky. Smenová fiškálna uzávierka sa tlačí spolu s dennou/mesačnou systémovou uzávierkou. Znamená to, že používateľ potvrdením tlačidla Systémová uzávierka Denná vyvolá zároveň aj tlač fiškálnej uzávierky smenovej. Smenová fiškálna uzávierka je počítaná od poslednej vyvolanej uzávierky. Podmienkou pre tlač tejto uzávierky sú:

• nové tlačové šablóny (sú na FTP) - je potrebné kontaktovať pracovníka AsecoSolutions a.s.
• nastavenie v BGM - Pokladne - Konfigurácia pokladní - Pokladne - Fiskal - Tlačiť smenovú uzávierku dennú/mesačnú pri dennej/mesačnej systémovej uzávierke.

Taxis – mobilná tlačiareň Taxis ePrinter

Od verzie APM 3.63 je možné nastaviť fiškálne zariadenie Taxis ePrinter. V nastaveniach zariadenia je možné nastaviť mobilné tlačiarne, na ktoré je presmerovaná tlač účteniek. Nastavenie v Asseco Print Manageri:

• Lokácia – http://IP adresa : port 6090
• Typ zariadenia – KT, Kaso Taxis
• Name – názov mobilnej tlačiarne pre presmerovanie tlače
• redirectingPrinting – potvrdiť pre presmerovanie
• ostatné nastavenia rovnaké ako pre zariadenie Taxis

Názov mobilnej tlačiarne zistí používateľ nasledovne:

• po zadaní url adresy z lokácie do prehliadača je používateľ presmerovaný na stránku Taxis
• po zadaní mena a hesla je v časti ....prístupný zoznam pridelených prenosných tlačiarní...

Nastavenie parametrov zariadenia eKasa Diebold Nixdorf

• Lokácia nie je podstatná - vyplniť localhost alebo 127.0.0.1
• DataDirectory - cesta k úložisku logov (c:\Temp\wn_fpsk_data) nie je potrebné meniť
• PortBlaudRate - 115200, symbolová rýchlosť, rýchlosť komunikácie medzi pc a tlačovým zariadením, 115200 je najvyššia možná, nemeniť
• PortFile - port pripojenia zariadenia, zistiť cez správcu zariadení Win
• LogEnabled - 0, vypnutie logovania, nemeniť
• LogDays - 30, dĺžka uloženia logov v dňoch, nemeniť
• LogDebug - 0, vypnutie debugovacieho módu, nemeniť
• CheckStateDisabled - 1, nastavenie nekontroluje stav fiškálnej tlačiarne a metódy, ktoré sa na ňu volajú,zrýchľuje proces tlače dokladu, nemeniť
• DisplayItemDisabled - 1, nastavenie zrýchli tlač a zakáže ukazovanie informácii o položkách a platbe počas tlače, nemeniť
• FreezeEvents - 1, nemeniť
• SingleCashReceipt - 0, nemeniť
• applyItemRounding - check box, potvrdený znamená, že v prípade ak cena spolu sa nerovná súčinu jednotkovej ceny a množstva, fiškálne zariadenie dopočíta rozdiel ako zaokrúhlenie a výčísli toto zaokrúhlenie ako ďalšiu položku. (Napr. Horec - združený účet a výpočet jednotkovej ceny spätne)

Po uložení nastavení v APM pribudne v zložke APM priečinok diebold_nixdorf_config, ktorý obsahuje xml so všetkými nastaveniami uvedenými vyššie. V priečinku sa vytvorí toľko xml súborov, koľko je v APM uložených zariadení.

Nastavenie ID spôsobov platby v číselníku platieb v PMS (Gastro Manager):

• ID Hotovosť - 1
• ID Platobná karta - 4
• ID Poukážka - 3
• ID Platba v CM - 2

Zariadenie DN nevracia kópiu účtenky pri úhrade faktúry

Nastavenie parametrov zariadenia eKasa Elcom

• Lokácia - ComPort, zistiť cez správcu zariadení - LAN - adresa sa bude zapisovať na to isté miesto ako číslo portu. Podľa toho, ako je vyskladaná lokácia sa APM rozhodne, či má používať tcp alebo com port
• OpenDrawer1/openDrawer2 - otváranie zásuvky
• Id platby - nie je potrebné, ale je potrebné v ELCOME skontrolovať nastavenie PaymentsRegistration: TRUE - očakáva ID platby, PaymentsRegistration - FALSE očakáva názov platby. Nastaviť TRUE
• DPH - štandartne
• billClosingAlternativeTime - nastavuje sa v prípade, že zariadeniu trvá dlhšie dostať odozvu zo zariadenia pri uzatváraní fiškálneho účtu (príčina môže byť vnútorne nesprávne nakonfigurovaný limit alebo pomalý internet)- zariadenie príjma hodnoty v rozmedzí 1000-1 800 000ms:
  • 0 - žiadna zmena
  • 1-1000 - správa sa ako by bolo zadané 1000
  • 1001 - 1 800 000 - zariadenie použije zadanú hodnotu
  • 1 800 000+ - správa sa ako by bolo zadané 1 800 000
  • v prípade, že je zadaný text - správa sa ako keby bolo zadané 0
• ID - platieb - 1 hotovosť, 2 šek, 3 kredit, 4 ostatné/nedefinované

Nastavenie parametrov zariadenia eKasa BOWA

Upozorňujeme, že BOWA vydala 18.9.2019 verziu 01.14. Uvedená verzia rieši problémy pri tlači účteniek pri operáciách pokladne vklad a výber, tiež iné nedostatky, keď sa účtenka nevytlačila.

• Lokácia - localhost:30000
• deviceNumber – číslo tlačového zariadenia podľa PPEKK, v prípade, že existuje viac tlačových zariadení v jednodnom PPEKK, začína od 1. Pozn.: Tento parameter je špeciálny pre Bowu, pre ostatné zariadenia platí, že koľko mám tlačových zariadení toľko zariadení nastavím v APM
• BOWA - parameter bowaHomeFolder je dôležitý pre zasielanie originál účtenky mailom. Parameter musí obsahovať absolútnu cestu k adresáru kde je BOWA software umiestnený. Na túto cestu sa pri vystavovaní účtov generuje PNG súbor účtenky a APM tento súbor preberie a odosiela ho mailom ako obrázok v prílohe, napr.: d:\__eKasa\Bowa0110\
• POZOR – hladiny DPH nastaviť v PPEKK štandartne (A-20%, B-10%, C-0%)
• ID platby v PMS:
  • Hotovosť 16
  • Karta 1
  • Stravné lístky 2

BOWA dovoľuje zadať max 10 znakov v poli pre názov transakcie. Nezmestí sa napr.: Platobná karta, Stravné lístky. Ak to zákazníkovi vadí, je potrebné premenovať spôsoby platieb napr.: Karta

BOWA nepodporuje účtenku ak obsahuje jednu položku, ktorá je vrátenie zálohy. Je potrebné na takýto účet pridať jednu položku s nulovou cenou.

Nastavenie parametrov RAW tlačiarní pre tlač objednávok a interných dokladov

Presný názov tlačiarne skontrolovať cez ovládací panel vo Windows

• Názov - lubovolný názov tlačiarne, napr. RAW tlač kuchyňa
• Lokácia - presný názov tlačiarne, tak ako je názov v zariadeniach a tlačiarňach vo windows - bixolon, viď obrázok
• Typ zariadenia - RP, RAW (Network)Printer Device - typ zariadenia RAW znamená, že tlač sa odkazuje na windows spooler
• paperWidth - 40
• encnding - cp852 - toto kodovanie nastaviť pre diakritiku

Nastavenie v systéme Asseco BLUEGASTRO:

• Servis - Číselníky - Tlačiarne a zariadenia - Vstupno/výstupné zariadenia - Nový APM
  • Host a port - kde beží APM

• Servis - Číselníky - Tlačiarne a zariadenia - Objednávkové body - je potrebné (oproti nastaveniam CSDLVPP) nastaviť Zmenu textu na Bez zmeny. Tlačové sekvencie platia a fungujú rovnako ako pri CSDLVPP.

Nastavenie parametrov zariadenia AxaSoft

Od verzie APM 3.63 je zapracovaná nové fiskálne zariadenie AxaSoft, ktoré slúži prioritne pre aplikáciu Kassandra. Fiškálne zariadenie je zároveň platobným terminálom. Parametre zariadenia sú rovnaké ako v nastavení POS terminálu v BGM:

• Lokácia – IP adresa : port 15000
• Typ zariadenia – EA, eKasa Axasoft
• KasaId – rovnaké ako v nastaveniach POS terminálu v BGM, napr.: KAS001
• EftPosId - rovnaké ako v nastaveniach POS terminálu v BGM, napr.: ASSECO003
• Ostatné nastavenia nemeniť
• Id platieb – 1 hotovosť, 2 platobná karta, 3 poukážky, 4 Cudzia mena, 5 Iné.

Nastavenie parametrov zariadenia POSNET - poľská fiškalizácia

POSNET

Vzory

Záložka Vzory slúži na nastavenie parametrov pre zasielanie účteniek e-mailom. Posielanie účteniek e-mailom je aktívne od verzie APM 2.41

Od verzia APM 2.41 majú klienti možnosť posielať účtenky svojim zákazníkom aj e-mailom. Posielanie účteniek e-mailom je podporované týmito fiškálnymi zariadeniami:

• KASO Taxis
• FiskalPro
• Diebol Nixdorf - iba kópia účtenky
• BOWA

Nastavenia v AssecoPrintManageri pre e-mailing

• Záložka Nastavenia je potrebné nastaviť tieto údaje:

• • Server mailového hosta - napr. smtp.office365.com
  • Port mailového hosta
  • Užívateľské meno na mailovom hoste - v tvare email@email.sk
  • Heslo na mailovom hoste
  • TLS - potvrdené
  • Mailom odosielať originál účtenku - nastavenie je nadradené nad nastavením na zariadeniach:
    • ÁNO - bude sa odosielať originál účtenky a účtenka nebude vytlačená cez fiškálne zariadenie
    • NIE - bude sa odosielať kópia účtenky vo forme html súboru, originál účtenky sa vytlačí cez fiškálne zariadenie

• Záložka Vzory - vzory e-mailov

• • Názov
  • Pracovná verzia - miesto na zápis textu. Na formátovanie textu sa využívajú html tagy, napr. <b>text</b> pre zvýraznenie textu. Uchopením dolného pravého rohu kurzorom je možné pole zväčšovať podľa potreby
  • Finálna verzia - v poli sa zobrazuje finálna podoba textu

• • Typ zariadenia - vybrať z číselníka
  • Šablónu použiť ako:
    • originál - vybrať v prípade, že v časti Nastavenia je nastavené Mailom odosielať originál účtenku ÁNO. Text vo Finálnej verzii bude použitý ako sprievodný text v e-maily, originál účtenky bude v prílohe. V prípade nastavenia originál nie je možné zároveň potvrdiť aj nastavenie hlavička.

• • • kópia - vybrať v prípade, že v časti Nastavenia je nastavené Mailom odosielať originál účtenku NIE. Text vo Finálnej verzii bude použitý ako sprievodný text v e-maili, kópia účtenky bude v prílohe
    • hlavička - vybrať len v prípade, že používateľ má nastavené posielať kópie účteniek, nastavenie nie je povinné. Text vo Finálnej verzii bude použitý v hlavičke kópie účtenky, nahradí text Finančná správa....V prípade, že používateľ chce mať rozdielny text v sprievodnom e-maily a hlavičke, je potrebné hlavičku definovať v ďalšom samostatnom zázname pre daný typ zariadenia.

Pre jednotlivé zariadenia je možné vytvoriť dva záznamy nastavenia pre zasielanie účteniek: jedno nastavenie kópia (s/bez hlavičky) a jedno nastavenie originál. Systém bude vyberať nadradené nastavenie v časti Nastavenia. Týmto spôsobom môže používateľ prepnutím jedného nastavenia zmeniť spôsob zasielanie účteniek e-mailom

Nastavenia jednotlivých zariadení

• KASO Taxis - nie je potrebné nastaviť
• FiskalPro - nie je potrebné nastaviť
• Diebold Nixdorf - nie je potrebné nastaviť
• BOWA - parameter bowaHomeFolder je dôležitý pre zasielanie originál účtenky mailom. Parameter musí obsahovať absolútnu cestu k adresáru kde je BOWA software umiestnený. Na túto cestu sa pri vystavovaní účtov generuje PNG súbor účtenky a APM tento súbor preberie a odosiela ho mailom ako obrázok v prílohe, napr.: d:\__eKasa\Bowa0110\

Nastavenia pre automatické zasielanie faktúr

• Záložka Vzory - vzory šablón - nastavujú sa šablóny pre automatické faktúry o úhrade zálohy. V APM od verzie 4.6 je zadefinovaná default šablóna, ktorú nie je možné meniť. Základnú šablónu je možné kopírovať a upraviť alebo vytvoriť novú šablónu.

• Skratka - rovnakú skratku uviesť aj v nastavení v PMS
• Názov - názov šablóny
• Jazyk - rovnakú skratku uviesť aj v PMS
• Systémový záznam - nie je možné meniť - potvrdené v default šablóne
• Povolené - možnosť zakázať šablóny
• Formulár šablóny - zadávanie textu a formátovanie pomocou ikon v hornej lište, zadávanie značiek pre jednotlivé hodnoty faktúry - možnosť kopírovať zo zoznamu pod žltým tlačidlom
• tlačidlá v spodnom pravom rohu:

• - nová šablóna
• - uloženie šablóny
• - zmazanie šablóny
• - značky do šablóny
• - kopírovanie aktuálnej šablóny

Používatelia

Zoznam používateľov sa nachádza v ľavej časti prehľadu:

• Priezvisko, Meno, Používateľské meno - rovnaké ako v PMS, ak bude zvolená možnosť Vyžadovať autentifikáciu pri komunikácii.
• PIN kód - zabudovaná kontrola na duplicitu
• Heslo, Potvrdenie hesla - heslo musí obsahovať aspoň jeden číselný znak, aspoň jeden malý znak, aspoň jeden veľký znak, aspoň jeden špeciálny znak "@#$%^&+=" a heslo musí mať aspoň 8 znakov. Heslo musí byť rovnaké ako heslo v PMS, ak bude zvolená možnosť Vyžadovať autentifikáciu pri komunikácii.
• Používateľská autorita:

• Administrátor
• User

• Povolený prístup na zariadenie - potvrdiť v prípade, že v Nastaveniach je potvrdená voľba Vyžadovať autentifikáciu pri komunikácii. Nastavenie povoľuje prístup požiadavky z PMS na APM iba v prípade, že v nastaveniach PMS je definované meno a heslo rovnaké ako pri užívateľovi v APM
• Povolené prihlasovanie do web rozhrania - potvrdiť v prípade, že používateľ má mať prístup do používateľského web rozhrania aplikácie APM a možnosť editovať nastavenia

Servis

Servis zariadení

• Tlačidlo na potvrdenie servisu pre ELCOM - - Servis - Servis zariadení - v prípade, že je potrebné vykonať servisnú prehliadku je potrebné potvrdiť flag
• Tlačidlo na potvrdenie servisu pre Diebold Nixdorf - Servis - Servis zariadení - v prípade, že stavy sú pod medznou hodnotou je potrebné potvrdiť flag

Nastavenia

• Komunikačný port - 5591
• Zariadenia budú otvorené pri štarte - prístupy do ORP budú otvorené pri štarte APM servera a zostanú otvorené alebo sa budú prístupy otvárať pri každom posielaní účtu
• Vyžadovať autentifikáciu pri komunikácii - v prípade, že bude voľba potvrdená, komunikácia bude prebiehať pod menom a heslom zadaným pri používateľovi, ktorý je určený na autentifikáciu komunikácie. Takýto používateľ musí mať povolený prístup na zariadenie.
• Interval kontroly spojení (ms)- zatiaľ nie je využívané
• Interval kontroly otvárania zariadení (ms) - zatiaľ nie je využívané
• Životnosť session v sekundách - zatiaľ nie je využívané
• Server mailového hosta - nastavenie pre mailing účtenky
• Port mailového hosta - nastavenie pre mailing účtenky
• Užívateľské meno na mailovom hoste - nastavenie pre mailing účtenky
• Heslo na mailovom hoste - nastavenie pre mailing účtenky
• TLS - nechať potvrdené
• Mailom odosielať originál účtenku - ak je potvrdené, tak aj v časti Vzory je potrebné vybrať - Šablónu použiť ako originál
• Jazyk pre pripojenie - sk, en
• Prostredie - Slovensko, Poľsko

Zoznam skratiek

CA	Certifikačná autorita
CRL	Certificate revocation list
DIČ	Daňové identifikačné číslo
DPH	Daň z pridanej hodnoty
IČDPH	Identifikačné číslo pre daň z pridanej hodnoty
IČO	Identifikačné číslo organizácie
OCSP	Online Certificate Status Protocol
OKP	Overovací kód podnikateľa
ORP	On-line registračná pokladnica
PPEKK	Pokladničný program e-kasa klienta
CHDÚ	Chránené dátové úložisko
PKP	Podpisový kód podnikateľa
UID	Universal Unique Identifier