MANUAL UTILIZARE DRIVER EMULARE TASTATURA

OPTIKEY

Acest program de comunicatie este destinat utilizatorilor de case de marcat OPTIMA care folosesc o aplicatie proprie de gestiune, instalata pe un PC, si doresc sa trimita în casa de marcat bonurile creeate în aceasta aplicatie.

Casa de marcat OPTIMA poate efectua toate operatiile de înregistrare (descrise în manualul de operare) prin utilizarea tastaturii proprii sau prin trimiterea codurilor fiecarei taste de la un PC, prin comunicatie pe un port serial de tip RS232.

Având în vedere solicitarile mai multor categorii de utilizatori care:

au o baza de date (numar de articole) foarte mare si necesita un mod de cautare rapid al acestor articole în timpul vânzarii;

au folosit pâna acum o aplicatie proprie pentru emiterea bonurilor si gestionarea vânzarilor;

trebuie sa trimita toate vânzarile zilnice (sau în timp real) printr-o retea proprie de PC-uri, în vederea centralizarii acestora.

a fost creeat programul de comunicatie OPTIKEY cu urmatoarele functii:

1. Stabilirea portului serial de comunicatie între PC si casa de marcat;
2. Stabilirea numarului casei de marcat (daca se comanda mai multe case de marcat de la acelasi PC);
3. Stabilirea numelui fisierului text creeat de aplicatia instalata pe PC;
4. Programarea în casa de marcat a articolelor din bonul creeat în aplicatia de pe PC;
5. Efectuarea propriuzisa a bonului prin trimiterea, în casa de marcat a codurilor tastelor care ar trebuii apasate daca s-ar opera direct de la tastatura casei de marcat. (emulatea tastaturii din aplicatia de gestiune instalata pe PC);
6. Preluarea mesajelor de eroare din casa de marcat în timpul programarii sau a tiparirii bonului si transmiterea acestor erori în aplicatia de gestiune, prin indicarea tipului de eroare (ultima eroare poate fi preluata din fisierul Err.txt );
7. Comanda anularii unui bon neefectuat datorita unei erori aparuta în timpul tiparirii bonului si care poate fi eliminata cu tasta CLEAR, sau, în cazul unor erori aparute la casa de marcat care nu pot fi eliminate cu tasta CLEAR, se va afisa un mesaj de atentionare a utilizatorului de a anula bonul început pe casa de marcat dupa eliminarea erorii semnalate. In ambele situatii, bonul creeat în aplicatia de pe PC nu se va prelucra, urmând a fi trimis din nou la casa de marcat, dupa eliminarea erorilor. 

Utilizarea programului de comunicatie OPTIKEY se face prin crearea unui fisier text denumit OPTIMA.BON (sau alta denumire stabilita in OPTIKEY.CFG) salvat în directorul OPTIKEY si trimiterea acestui fisier în casa de marcat apelând OPTIKEY.EXE din acelasi director.

Structura fisierului OPTIKEY .CFG este:

- portul serial (1 sau 2)

- numele fisierului *.BON

- numarul casei de marcat ( 0-99)

COM 1<ENTER>

BON nume.bon<ENTER>

CASA 02<ENTER>

Structura fisierului OPTIMA .BON este:

< ENTER >

S; denumire articol(24) ; pret articol(8) ; cantitate(8) ; departament(2) ;< ENTER >

G; denumire articol(24) ; pret articol(8) ; cantitate(8) ; departament(2) ;< ENTER >

I ; nume art.(12) ; pret(8) ; numarator(8) ; numitor(8) ; departament(2) ;< ENTER >

K; F1 ; F2 ; F3 ; F4 ; F5 ; F6 ; F7 ; F8 ;< ENTER >

N ; N1 ; N2 ; N3 ; . ; N24 ;<ENTER>

T ; suma de la client pe tip de plata(8) ; tipul de plata(1) ; ; ; ; ; ; ; ; ; ; ;< ENTER >

Unde:

• Prima linie indica daca bonul a fost prelucrat (daca bonul a fost tiparit corect în casa de marcat, programul va suprascrie aceasta linie cu valoarea "0 < ENTER >"
• Liniile care încep cu "S" , "G" , "I"  reprezinta articolele din bonul care se programeaza in casa de marcat dupa care se tiparesc pe bon; Linia de tip "G" este folosita pentru articole gratuite, in cazul farmaciilor; Linia de tip "I " este folosita pentru articole care se vand cu cantitate fractionara;

Denumire articol poate fi din maxim 12 caractere (CR300 sau CR500) sau 24 caractere (CR655 sau CR715);

Pret articol poate fi din maxim 8 cifre;

Cantitate poate fi din maxim 8 cifre din care maxim 3 zecimale;

Numarator sau Numitor pot fi din maximum 4 cifre fara zecimale;

Departamentul poate fi 1.48 (CR300); 1.99 (CR500 si CR715); 1.24 (CR655);

• Liniile care incep cu "K" reprezinta functiile tastelor care se doresc a fi apasate la casa de marcat pentru efectuarea unui bon;

F1 . F8 reprezinta functiile tastelor;

Lista tuturor functiilor este prezentata mai jos

• Liniile care incep cu "N" reprezinta o denumire din maximum 24 litere si spatii (N1 . N24) literele reprezentand fiecare o functie, iar pentru spatiu se va folosii functia "CARD2"; Acest tip de linie se poate folosi numai la CR715;
• Linia care începe cu "T" reprezinta modul de închidere a bonului, cu sau fara forme de plata încasate de la client; Aceasta linie este obligatorie!!!

Pentru fiecare tip de plata, în cazul unor plati combinate, poate fi introdusa suma primita de la client (maxim 8 cifre)

Tipul de plata (CASH; CEC; CARD1; CARD2; CARD3; CHARGE)

Nota 1

În liniile de tip "K"si "N" dupa "K" respectiv "N" trebuie sa existe 8 functii de taste, respectiv 24 litere si spatii. Daca functiile de taste lipsesc, se va inscrie ;; pana la 9 separatori in total, respectiv 25 separatori (ex.: K;1;PLU ; )

Linia de închidere a bonului de tip "T", dupa "T" trebuie sa existe obligatoriu 6 perechi de "suma;forma plata;" Daca nu se introduce nici o forma de plata, aceasta linie va fi astfel: T ; ;;;;;; (adica T urmat de 13 x ";" si ENTER). Daca suma si implicit forma de plata lipsesc, se va inscrie ;; (ex. T;100000;CASH ; ;;;; ).

În cazul aparitiei unor erori (departament neprogramat, lipsa hârtie, imprimanta blocata, sau orice alte erori), casa de marcat va trimite un mesaj de eroare care va fi salvat in fisierul "ERORI.txt", iar bonul va fi anulat sau se va afisa un mesaj prin care utilizatorul este avertizat sa anuleze bonul dupa îndepartarea erorii.

În aceste situatii bonul nu a fost prelucrat si, dupa anularea bonului la casa de marcat si eliminarea erorii, se va trimite din nou bonul din aplicatia de pe PC.

Daca eroarea apare dupa trimiterea formei de plata catre casa de marcat, dupa eliminarea erorii casa de marcat va inchide automat bonul. Pentru aceasta situatie mesajul din fisierul "ERORI.txt" va atentiona utilizatorul sa elimine eroarea si sa finalizeze bonul la casa de marcat. In aceasta situatie bonul a fost prelucrat de aplicatia de pe PC.

Cantitatea se va introduce cu zecimale NUMAI daca acestea exista !!!

Nota 2:

1. Casa de marcat va fi programata cu minimum urmatoarele date:

TVA

Departamentele care se vor utiliza

Toate articolele care se vor apela, in situatia in care:

se va lucra cu aceeasi baza de date programata in casa si in PC

nu se vor folosi linii de tip "S" adica nu se vor programa articole prin driverul OptiKey,

Grupuri de cate 50 articole legate la cate un departament, (in cazul in care se lucreaza cu linii de tip "S") dupa cum urmeaza:

PLU 0001 la PLU 0050 se vor programa la Dept. 01

PLU 0051 la PLU 0100 se vor programa la Dept. 02

PLU 0101 la PLU 0150 se vor programa la Dept. 03

PLU 0151 la PLU 0200 se vor programa la Dept. 04

PLU 0201 la PLU 0250 se vor programa la Dept. 05 ...

La Dept. nn se vor programa articolele cu coduri de la [(nn - 1)x 50+ 1 la nn x 50 ]

Exemple de bonuri:

Se programeaza apticolul ASPIRINA cu pret unitar 38000 legat la departamentul 2 si se efectueaza bonul pentru cantitatea 1,5 achitat cu 60 000 numerar.

1< ENTER >

S;ASPIRINA ;38000;1,5;2;< ENTER >

T;60000;CASH ; ;;;;< ENTER >

Se efectueaza bonul cu urmatoarele articole si functii:

1,375 buc. PLU0001

2 buc. PLU0002

Anularea liniei anterioare (VOID 2 X PLU0002)

1 buc. PLU0003

Reducerea partiala a valorii de 10 000 din PLU0003

Inchiderea bonului cu introducerea sumelor primite de la client 100 000 numerar si un CEC in valoare de 50 000

1< ENTER >

K;1;DOT;375;XTIME1;1;PLU;;;< ENTER >

K;2;XTIME1;2;PLU;;;;; < ENTER >

K;VOID;2;XTIME;2;PLU;;;; < ENTER >

K;3;PLU ; < ENTER >

K;REFUND;10000;PLUCR;3;PLU;;;; < ENTER >

T;100000;CASH;50000;CEC ; ;; < ENTER >

Atentie, pentru folosirea functiei REFUND, aceasta functie trebuie programata pe tastatura casei de marcat !!!

Introducerea sumei in numerar de 50 000 in sertar:

1< ENTER >

K;50000;RA;CASH;;;;;; < ENTER >

Lista de functii ale tastelor caselor de marcat Optima CR300/500/715:

Nota:

1. Pentru CR715 se pot utiliza si functiile tastelor "ALFABET" (A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z );
2. Linia de tip "T" este obligatorie .
3. Aplicatia de pe PC va considera bonul prelucrat numai daca pe prima linie din fisierul Optima.BON se va gasii "0" 

Ddaca bonul a fost tiparit corect la casa de marcat, driverul OptiKey va scrie pe prima linie a fisierului Optima.BON cifra "0";

Daca pe prima linie din fisierul Optime.BON exista "1" inseamna ca fisierul nu a fost prelucrat.

Lista de functii ale tastelor caselor de marcat Optima CR655:

Nota: Functiile care se vor apela trebuie programate pe tastatura casei de marcat.

Mesaje de eroare din functia principala a optibon.dll

(care apar in fisierul erori.txt)

1. Eroare parametru tip casa in fisierul optikey.cf2. Bonul trebuie retransmis

2. Eroare parametru tip firmware in fisierul optikey.cf2. Bonul trebuie retransmis

3. Port-ul serial nu poate fi deschis. Va rugam sa configurati corect port-ul in fisierul optikey.cfg sau sa inchideti alte aplicatii care ocupa acest port. Bonul trebuie retransmis

4. Eroare la resincronizare. Va rugam verificati conexiunea seriala si starea casei de marcat. Bonul trebuie retransmis

5. Eroare la verificarea starii casei de marcat. Va rugam verificati conexiunea seriala si starea casei de marcat. Bonul trebuie retransmis

6. Eroare la anularea bonului (1,2,3,4). Va rugam verificati conexiunea seriala si starea casei de marcat. Bonul trebuie retransmis

7. Eroare citire data/ora. Va rugam verificati conexiunea seriala si starea casei de marcat. Bonul trebuie retransmis

8. Exista o diferenta de data calendaristica intre casa de marcat si PC. Va rugam corectati aceasta diferenta si retransmiteti bonul

9. Eroare la deschiderea modului programare (1,2). Va rugam verificati conexiunea seriala si starea casei de marcat. Bonul trebuie retransmis

10. Eroare la inchiderea modului programare. Va rugam verificati conexiunea seriala si starea casei de marcat. Bonul trebuie retransmis

11. Eroare la deschiderea fisierului <fisier_bon>. Va rugam verificati prezenta si atributele fisierului. Bonul trebuie retransmis

12. Eroare la citirea liniei <n>. Va rugam verificati starea fisierului <fisier_bon>. Bonul trebuie retransmis

13. Eroare la pozitionarea cursorului in fisier (1,2,3). Va rugam verificati starea fisierului <fisier_bon>. Bonul trebuie retransmis

14. Bonul a fost deja tiparit

15. Eroare la prelucrarea liniei de tip <tip_linie_bon> fisier <fisier_bon> linia <nr>. Bonul trebuie retransmis

16. Eroare la finalizare. Va rugam rezolvati eroarea si inchideti bonul. Bonul a fost inregistrat si NU TREBUIE RETRANSMIS

17. Eroare la scrierea in fisier (1,2). Va rugam verificati starea fisierului <fisier_bon>. Bonul a fost inregistrat si NU TREBUIE RETRANSMIS

18. Eroare in fisier <fisier_bon> linia <nr>. Linie de tip necunoscut. Va rugam corectati eroarea si retransmiteti bonul

19. Eroare la interogarea contorului de tranzactii. Bonul a fost inregistrat si NU TREBUIE RETRANSMIS

Mesaje de eroare din functia principala a optikey.exe

(care apar in fisierul erori.txt)

1. Eroare la incarcarea 'optibon.dll'. Bonul trebuie retransmis

2. Eroare la aflarea directorului curent. Bonul trebuie retransmis

3. Eroare la deschiderea fisierului <optikey.cfg>. Bonul trebuie retransmis

4. Eroare la citirea liniei <nr> in fisierul optikey.cfg. Va rugam verificati starea fisierului <optikey.cfg>. Bonul trebuie retransmis

5. Eroare pe linia <nr> la parametrul COM in fisierul optikey.cfg. Va rugam verificati starea fisierului <optikey.cfg>. Bonul trebuie retransmis

6. Eroare pe linia <nr> la parametrul BON in fisierul optikey.cfg. Va rugam verificati starea fisierului %s. Bonul trebuie retransmis

8. Eroare pe linia <nr> la parametrul CASA in fisierul optikey.cfg. Va rugam verificati starea fisierului <optikey.cfg>. Bonul trebuie retransmis

9. Fisier de configurare invalid. Va rugam verificati starea fisierului <optikey.cfg>. Bonul trebuie retransmis

10. Eroare la deschiderea fisierului <optikey.cf2>. Bonul trebuie retransmis

11. Eroare la citirea liniei <nr> in fisierul optikey.cf2 . Va rugam verificati starea fisierului <optikey.cf2>. Bonul trebuie retransmis

12. Eroare pe linia <nr> la parametrul TYPE in fisierul optikey.cf2. Va rugam verificati starea fisierului <optikey.cf2>. Bonul trebuie retransmis

13. Eroare pe linia <nr> la parametrul FIRM in fisierul optikey.cf2. Acest firmware nu este disponibil. Va rugam verificati starea fisierului <optikey.cf2>. Bonul trebuie retransmis

14. Eroare pe linia <nr> la parametrul MODE in fisierul optikey.cf2. Acest mod nu este disponibil. Va rugam verificati starea fisierului <optikey.cf2>. Bonul trebuie retransmis

15. Fisier de configurare invalid. Va rugam verificati starea fisierului <optikey.cf2>. Bonul trebuie retransmis

16. Eroare la incarcarea functiei 'Optibon'. Verificati starea si versiunea fisierului optibon.dll, eventual restartati PC-ul. Bonul trebuie retransmis

Mesaje de eroare secundare

Eroare 1 - lungime bloc

Eroare 2 - EDC bloc recepionat

Eroare 3 - EDC bloc transmis

Eroare 4 - bloc transmis

Eroare 5 - cerere de resynch receptionata !

Eroare 6 - DAB/SAB

Eroare 7 - SAB/DAB

Eroare 8 - desincronizare

Eroare 9 - parametru eronat

Eroare 10 - bon deja tiparit

Eroare 11 - linie de tip necunoscut

Eroare 12 - diferenta de data

Eroare 247 - eroare necunoscuta la receptie

Eroare 248 - timeout asteptare tasta

Eroare 249 - timeout asteptare imprimanta

Eroare 250 - timeout asteptare port serial

Eroare 251 - more data receptie

Eroare 252 - more data transmisie

Eroare 253 - format necunoscut de bloc

Eroare 254 - raspuns necunoscut

Eroare 255 - prea multe incercari

Eroare 1 - grup de comenzi necunoscut

Eroare 2 - comanda necunoscuta

Eroare 3 - casa nu este pregatita pentru programare

Eroare 4 - nici un cod scanat

Eroare 5 - structura de date prea lunga

Eroare 6 - final raport PLU

Eroare 7 - final raport MF

Eroare 8 - parametru eronat

Eroare 9 - casa nu a terminat de tiparit

Eroare 100 - tasta gresit apasata (+/-%%, SUBTOTAL, PLU ENTER) verificati fisierul BON

Eroare 1 - tasta gresit apasata (EC, VOID, SCALE) verificati fisierul BON

Eroare 2 - tasta gresit apasata (RA, PO) verificati fisierul BON

Eroare 3 - depasire valorica Efectuati raportul periodic

Eroare 4 - departament/taxa/pret neprogramat Programati corect casa de marcat

Eroare 5 - atentie la modul INVOICE

Eroare 6 - eroare casier

Eroare 20 - buffer tastatura plin

Eroare 30 - lipsa hartie Inlocuiti rola de hartie

Eroare 31 - eroare imprimanta. SOLICITATI INTERVENTIA ECHIPEI DE SERVICE

Eroare 40 - scanner neprogramat verificati fisierul BON

Eroare 41 - cod bare neprogramat verificati fisierul BON

Eroare 50 - memorie fiscala aproape plina. SOLICITATI INTERVENTIA ECHIPEI DE SERVICE

Eroare 51 - eroare MF. SOLICITATI INTERVENTIA ECHIPEI DE SERVICE

Eroare 52 - eroare initializare memorie fiscala. SOLICITATI INTERVENTIA ECHIPEI DE SERVICE

Eroare 53 - MF blocat. SOLICITATI INTERVENTIA ECHIPEI DE SERVICE

Eroare 60 - stoc PLU = 0

Eroare 71

Eroare 0 - cheie in pozitia 'L'. Va rugam puneti cheia in pozitia 'R'

Eroare 2 - cheie in pozitia 'X'. Va rugam puneti cheia in pozitia 'R'

Eroare 4 - cheie in pozitia 'Z'. Va rugam puneti cheia in pozitia 'R'

Eroare 8 - cheie in pozitia 'P'. Va rugam puneti cheia in pozitia 'R'

Eroare 16 - cheie in pozitia 'T'. Va rugam puneti cheia in pozitia 'R'

Eroare <nr> - necunoscuta status.current_mode

Eroare <nr> - necunoscuta datorata casei de marcat

Eroare <nr> - necunoscuta la nivel de INF bloc (ERC)

Precizari suplimentare

referitoare la interpretarea informatiilor din fisierul Erori.txt

In fisierul Erori.txt apare suplimentar numarul bonului fiscal tiparit la casa de marcat pe o linie de forma " #xxxx" unde xxxx este numarul bonului fiscal care poate fi de la "1" la "9999". Numarul bonului fiscal se reseteaza dupa fiecare raport fiscal de inchidere zilnica si, practic , nu s-a depasit numarul maxim de 2000 bonuri fiscale pe zi.

In situatia in care in fisierul Erori.txt apare o eroare si bonul nu poate fi tiparit in totalitate la casa de marcat se va proceda dupa cum urmeaza:

a.      Se verifica lungimea fisierului Erori.txt pana cand acesta devine >1;

b.      Daca fisierul Erori.txt > 1 se verifica flag bon:

c.      Daca flag bon = 0, bonul este prelucrat si se trece la urmatorul bon;

d.      daca flag bon = 1 inseamna ca exista erori si se relanseaza driverul OptiKey dupa care se afiseaza mesajul din fisierul Erori.txt;

e.      Daca eroarea aparuta anterior relansarii driverului OptiKey este datorata unei pierderi a sincronizarii dintre Casa de marcat si PC si bonul a fost inceput dar neterminat, relansarea driverului OptiKey duce la anularea automata a bonului tiparit la casa de marcat si retransmiterea automata a bonului;

f.        Daca eroarea aparuta anterior relansarii driverului OptiKey este datorata unei erori la casa de marcat (lipsa hartie, eroare imprimanta sau alte erori care trebuie inlaturate de utilizator sau de service-ant, relansarea driverului OptiKey duce detectarea aceleiasi erori urmand ca aceasta eroare sa fie afisata pe monitorul PC-ului (mesajul fiind de tipul " Eliminati eroarea nr .. Si retransmiteti bonul. Bon neprelucrat") pentru ca utilizatorul sa fie informat si sa ia decizia corecta pentru eliminarea erorii.

Pentru informatii suplimentare va rugam sa ne contactati telefonic sau la adresa de e-mail.

Calin Pavelescu, Director Tehnic