TextSell

Versiunea 1.50 D

Prezentare

Cu ajutorul modulului software TextSell se poate initia, din calculatorul PC, emiterea bonurilor la o casa de marcat DATECS MP 500 TR sau DATECS MP 5000 conectata in retea. Descrierea articolelor care urmeaza sa faca obiectul urmatorului bon se colecteaza intr-un fisier ASCII, cu extensia INP, utilizind un format dat. Executabilul ruleaza ca un program rezident si, de fiecare data cind depisteaza existenta unui fisier INP in directorul de lucru, transmite continutul acestuia catre casa de marcat in vederea emiterii bonului fiscal. Comunicatia PC - casa de marcat este asigurata de driver-ul ECRServ pentru mediul Windows 95/98 sau ServNT pentru mediul Windows95/98/NT.

Modulul software TextSell este protejat astfel incit comunica numai cu casele de marcat pentru care a fost licentiat. Pentru a obtine programul licentiat va trebui sa ne transmiteti numarul fiscal al caselor de marcat conectate la program obtinut de la administratiile financiare.

Configurarea caselor de marcat

Implementarea modulului software TextSell impune urmatoarele setari in casele de marcat conectate:

a)      In tabelul 2 (organizarea magazinului)

Campul 2    - valoare 0

Campul 8    - valoare 3 pentru interfata standard

- valoare 7 pentru modulul multiinterfata

Campul 9    - valoare 3 - 4800 bps

- valoare 4 - 9600 bps

b)      In tabelul 5 (formatul bonului)

Campul 7    - valoare 0

Campul 8    - valoare 0

Instalarea si configurarea programului

Instalarea

Pentru functionarea programului este necesar un PC cu sistem de operare Window 95/98 sau NT. Se va instala si configura protocolul TCP/IP.

EcrServ sau ServNT vor fi instalate pe calculatorul PC la care sunt conectate casele de marcat. TextSell poate fi instalat in oricare alt calculator PC conectat in retea cu cel la care este conectata reteaua de case de marcat.

Introduceti discheta de instalare in driver-ul floppy si lansati SET UP.

Configurarea

Dupa instalare, si dupa lansarea in executie, in partea dreapta a task-bar-ului apare icoana programului TextSell. Cu clic dreapta pe icoana TextSell se intra in meniul de configurare. Configurarea este accesibila numai in situatia in care TextSell este inactiv adica in starea STOP.

Programul poate fi lansat in executie cu comanda C:DIR1TEXTSELL si poate fi oprit cu comanda C:DIR1TEXTSELL Q.

Daca la configurarea programului s-a introdus parola atunci comanda de oprire este C:DIR1TEXTSELL Q:<parola>.

Meniul programului TextSell cuprinde urmatoarele optiuni:

a) Configure - meniul de configurare

b) Start (Stop) - Activarea sau inactivarea programului

c) Exit - Oprirea programului

Configure - meniul de configurare.

Meniul de configurare este activ numai in cazul in care TextSell nu este activ. Daca TextSell este activ atunci se poate dezactiva cu Stop.

Se pot seta urmatoarele

Server

Server IP Address - se introduce adresa IP a PC-ului la care sunt conectate fizic casele de marcat si pe care ruleaza ECRServ sau ServNT. Daca aplicatia ruleaza pe acelasi computer se utilizeaza adresa implicita 127.0.0.1.

Server IP Port - Portul la care "asculta" serverul (implicit 5000).

System Password - parola pentru oprirea si setarea programului (implicit blanc).

Server login password - parola de legatura cu serverul. Trebuie sa coincida cu paraloa definita in server. Valoarea implicita este blanc.

Timeout in seconds - timpul de asteptare la executarea comenzilor programate in fisierul INPUT. Daca exista conditii care impiedica transmiterea informatiilor catre casa de marcat, dupa expirarea timpului, executia este intrerupta. Dupa indepartarea cauzelor programul va continua transmiterea informatiilor catre casa de marcat de la locul intreruperii.

Directories

Input path - indica in ce director programul TextSell va cauta fisierele INPUT (implicit in directorul in care se gaseste programul).

Input Extension - stabileste extensia fisierelor INPUT (implicit extensia este INP).

Output path - stabileste directorul in care se vor inscrie fisierele de iesire (implicit in directorul in care se afla programul).

Output Extension - stabileste extensia fisierelor de iesire.

Encoding and Actions

DOS/Windows - arata in ce sistem de operare se lucreaza.

Output Actions - daca dupa prelucrarea unui anumit fisier in directorul de baza exista deja unul cu acelasi nume sunt posibile urmatoarele variante:

Replace existing - fisierul existent se inlocuieste cu cel nou.

Append existing - la fisierul existent se adauga fisierul nou.

Generate unique - se genereaza un fisier cu nume unic.

Not output - nu se genereaza fisierul de iesire.

Licence

In acest ecran se listeaza numerele fiscale ale caselor de marcat pentru care este licentiat programul TextSell. Parola de acces se inscrie in fisierul TextSell.ini. Parola de licentiere se obtine de la furnizor in baza numarului fiscal al casei ce urmeaza a fi conectata la program.

Descrierea sintaxei fisierelor de intrare.

Comenzile de baza pe care le ofera programul sunt urmatoarele:

vanzarea unui articol - (comanda S)

tiparirea unui text nefiscal - (comanda P)

inchiderea bonului si stabilirea modului de plata - (comanda T)

majorare sau reducere procentuala - (comanda C)

introducerea si scoaterea de sume din sertar - (comanda I)

blocarea si deblocarea tastaturii casei de marcat - (comenzile H si F)

obtinerea numarului bonului fiscal (comanda N)

Pentru initierea bonului din calculatorul PC este necesar intocmirea unui fisier de comenzi, fisier de intrare (INPUT), in format ASCII cu terminator de linie CR/LF. In mod implicit denumirea fisierului de intrare este CASHFILE.INP.

Structura unei comenzi din fisierul de intrare este:

<C>, <E>, <de serviciu>, <parametri>

Unde:

- <C> este codul comenzii (S, P, T, C, I, H, sau F).

- <E> este numarul logic al casei de marcat ( de la 1 la 99).

- <de serviciu> este un campul de serviciu cu formatul <____,_,___>. Scopul lui este sa inregistreze rezultatul operatiunii.

<_______> - prima parte a cimpului de serviciu unde programul va inscrie numarul fiscal al casei care a executat comanda (lungime: 6 caractere).

<_> - partea a doua a cimpului de serviciu unde programul va inscrie un numar de ordine ciclic, de la 0 la 9 (lungime: 1 caracter).

<__> partea a treia a cimpului de serviciu unde programul va inscrie rezultatul executarii comenzii corespunzatoare liniei (lungime: 2 caractere). Sunt posibile urmatoarele mesaje:

<__> - comanda nu a fost transmisa.

<SD> - comanda a fost transmisa catre casa de marcat dar nu s-a primit confirmare din partea casei de marcat.

<ER> - comanda a fost transmisa catre casa de marcat dar aceasta a refuzat-o datorita sintaxei incorecte.

<NO> - comanda a fost transmisa catre casa de marcat dar aceasta a refuzat-o datorita faptului ca nu face parte din setul ei de comenzi.

<OK> - comanda a fost transmisa catre casa de marcat si aceasta a executat-o cu succes..

Vanzarea unui articol pe casa de marcat (comanda S).

Formatul comenzii este dupa cum urmeaza:

S<E>,<de serviciu>,<parametri>.

S - comanda de vinzare a unui articol.

<E> - numarul logic al casei de marcat careia ii este adresata comanda.

<de serviciu> - campul de serviciu descris mai sus.

<parametri> - parametrii articolului de vindut:

<nume>;<pret>;<cantitate>;<d >;<gg>;<x>;0;0;

<nume> - denumirea articolului (max. 22 caractere).

<pret> - pretul articolului (format 999999.99 pentru casele setate a lucra cu 2 zecimale sau format 99999999 pentru casele setate a lucra fara zecimale).

<cantitate> - cantitatea vinduta (format 99999.999, zecimalele sunt obligatorii).

<dep> - numarul departamentului (poate lua valori de la 1 la 8).

<ga> - numarul grupei de articole (poate lua valori intre 1 si 99).

<gt> - numarul grupei de taxe (poate lua valori de la 1 la 7).

<0> - camp rezervat cu valoarea obligatorie "0" (zero).

<0> - camp rezervat cu valoare obligatorie "0" (zero).

In consecinta, sintaxa unei comenzi pentru vinzarea unui articol are formatul:

S,<E>,______,_,__;<nume>;<pret>;<cantitate>;<dep>;<ga>;<gt>;0;0;

De exemplu:

S,3,________,_,__; iaurt;9500;6.000;5;44;1;0;0;

Linia de mai sus indica vinzarea, prin casa de marcat cu numarul logic 3, a produsului iaurt, cu pretul de 9500 lei/buc., in cantitate de 6 buc., produsul apartine departamentului 5 si grupei de articole 44 si este incadrat la grupa de taxe 1.

Pe bonul emis de casa de marcat se va imprima, ca urmare a transmisiei comenzii de mai sus, urmatoarea vinzare:

6.000 x 9500

iaurt 57000 A

presupunind ca ECR-ul are numarul fiscal MB0003001830 si comanda de mai sus este a 7-a comanda transmisa atunci, imediat dupa transmiterea si executia comenzii de mai sus, in fisierul de intrare, se vor completa cimpurile de serviciu dupa cum se vede mai jos:

S,3,001830,7,OK;iaurt;9500;6.000;5;44;1;0;0;

Comanda pentru tiparirea unui text nefiscal (comanda P).

Formatul comenzii este dupa cum urmeaza:

P,<E>;<de serviciu>;<parametri>

P - comanda de tiparire text nefiscal

<E> - numarul logic al casei de marcat cereia ii este adresata comanda

<de serviciu> - camp de serviciu

<parametri> - parametrii comenzii P:

5 campuri corespunzatoare a 5 linii de text nefiscal cu maximum 18 caractere pe rind, cu formatul:

<rand 1>;<rand 2>;<rand 3>;<rand 4>;<rand 5>;

Fiecare rind gol se ignora. Daca pe un rind exista simboluri nepermise acel rind va fi ignorat. Se vor completa toate cele 5 rinduri, rindurile nedorite vor fi completate cu un blanc.

In consecinta sintaxa unei comenzi de tiparire text nefiscal este ca mai jos:

P,<E>,______,__;<rand 1>;<rand 2>;<rand 3>;<rand 4>;<rand 5>;

Se recomanda ca numarul maxim de caractere de tiparit cu o comanda P sa nu fie mai mare decit 100.

Comanda de inchidere de bon (comanda T)

Formatul comenzii de inchidere de bon este:

T,<E>,<de serviciu>;<parametri>;

T - este codul comenzii de inchidere de bon.

<E> - numarul logic al casei de marcat careia ii este adresata comanda

<de serviciu> - camp de serviciu

<parametri> - parametrii sunt obtionali si sunt necesari daca plata corespunzatoare bonului se executa combinat

formatul este

<cod>;<suma>;;;;

<cod> - indica tipul comenzii si poate lua valorile 0, 1, 2, 3 sau 4

0 - plata cu numerar

1 - plata cu tichet

2 - plata cu CEC

3 - plata cu card

4 - indica faptul ca se va executa un subtotal

<suma> - suma platita. Daca suma platita este mai mare decat suma de plata se executa automat inchiderea de bon cu specificarea sumei platite si a restului.

Comanda adresata casei de marcat cu numarul logic 2 pentru inchiderea unui bon cu plata integrala in numerar arata ca mai jos:

T,2,_______,_,__;

Comanda adresata casei de marcat cu numarul logic 8 pentru inchiderea unui bon cu plata sumei de 1500 lei cu tichet arata ca mai jos:

T,8,_____,__,___;1;1500;;;;

Comanda pentru adaosuri sau reduceri procentuale (C)

Comanda de reducere sau majorare procentuala va fi acceptata de casa de marcat numi daca tastele +% si -% au fost activate in modul de programare PGM1.

Comanda arata ca mai jos:

C,<E>,<de serviciu>;<parametri>

C - comanda de reducere sau majorare procentuala

<E> - numarul logic al casei de marcat

<de serviciu> - camp de serviciu

<parametri> - parametri sunt urmatorii:

<cod>;<procent>;;;;

<cod> - cimpul poate avea doua valori, 0 pentru reducere si 1 pentru majorare

<procent> - procentul majorarii sau reducerii (intre 0.00 si 99.99)

Scopul comenzii este acelasi ca si al tastelor +% si -%. Adaosul sau reducerea procentuala se poate aplica atit la totalul ultimei vinzari cit si la nivelul subtotalului unui bon.

Introducerea si scoaterea de sume din sertar (comanda I)

Comanda de introducere si scoatere sume din sertar are sintaxa de mai jos:

I,<E>,<de serviciu>;<parametri>;

Unde:

I - codul comenzii

<E> - numarul logic al casei de marcat

<de serviciu> - campul de serviciu

<parametri> - parametri comenzii cu urmatoarea sintaxa:

<cod>;<suma>;;;;

<cod> - poate lua valorile:

pentru scoaterea de sume din sertar

pentru introducerea de sume in sertar

<suma> - suma scoasa sau adaugata in sertar

Aceasta comanda are acelasi efect ca si utilizarea tastelor <RA> si <PO> din tastatura casei de marcat. Dupa executarea acestei comenzi tastatura casei ramane blocata. Pentru deblocarea ei se va utiliza comanda "F".

Preluarea controlului tastaturii casei de marcat de catre PC (comanda H)

Comanda are sintaxa de mai jos:

H,<E>,<de serviciu>;

H - codul comenzii

<E> - numarul logic al casei de marcat

<de serviciu> - campul de serviciu

Comanda H nu are parametrii.

Comanda H permite preluarea controlului tastaturii casei de marcat de catre PC. Ca urmare, in timpul transmiterii continutului unui fisier de intrare catre casa de marcat, tastatura casei de marcat este inoperanta. Tastatura ramine blocata pina la transmiterea unei comenzi T sau F.

Cum comenzile S, P, C si I blocheaza tastatura casei de marcat pina la aparitia unei comenzi T sau F, utilizarea comenzii H va trebui sa fie decisa cu grija.

Comanda de deblocare a tastaturii casei de marcat (comanda F)

Sintaxa comenzii este:

F,<E>,<de serviciu>

Unde:

F - codul comenzii

<E> - numarul logic al casei de marcat

<de serviciu> - campul de serviciu

Comanda F nu are parametrii

Obtinerea de informatii de la casa de marcat privitoare la starea tastaturii, numarul operatorului activ in casa de marcat si numarul bonului fiscal (comanda N)

Sinaxa comenzii este prezentata mai jos:

N,<E>, <de serviciu>, <parametri>

Unde:

N - codul comenzii

<E> - numarul logic al casei de marcat

<de servicu> - campul de serviciu

<parametri> - ,_;___;_____;

dupa executarea acestei comenzi cimpurile se completeaza dupa cum urmeaza:

prima parte

0 - tastatura blocata

1 - tastatura deblocata

partea a doua - poate lua valori in domeniul 1-30 si indica numarul operatorului activ in casa de marcat

partea a treia - numarul bonului poate lua valori in domeniul 0001-9999

Exemple de fisiere de intare cu comenzi:

Fisiere de comenzi care exemplifica cele expuse mai sus

Impreuna cu programul TextSell se livreaza si 5 fisiere de intrare cu comenzi pentru exemplificarea sintaxei expuse mai sus.

Cum, in urma transmiterii catre o casa de marcat a continutului unui fisier de comenzi, in cimpurile de serviciu se inscriu informatiile explicate in prima parte a prezentului document, transmiterea ulterioara a aceluiasi fisier este imposibila. Ca urmare va rugam sa copiati fisierele demonstrative CASHFILE0.INP, CASHFILE1.INP, CASHFILE2.INP, CASHFILE3.INP si CASHFILE4.INP, inainte de lansarea in executie a programului, in fisiere cu alte nume pentru a avea posibilitatea refacerii lor pentru noi experimente de vinzare.

CASHFILE0.INP contine toate comenzile posibil de efectuat:

- blocarea tastaturii casei de marcat

- vinzare

- reducere la totalul unei vinzari

- o noua vinzare

- determinarea numarului bonului

- tiparirea unui text nefiscal

- efectuarea unui subtotal

- reducere aplicata pe subtotal

- efectuarea unui nou subtotal

- majorare aplicata pe noul subtotal

- 3 tipuri de plati

- inchiderea bonului

- introducerea si scoaterea de sume din sertar

- deblocarea tastaturii casei de marcat

CASHFILE1.INP este asemanator cu CASHFILE0.INP cu diferenta ca bonul se incheie cu plata si restul, nemaifiind necesara deblocarea tastaturii casei cu comanda F.

CASHFILE2.INP este asemanator cu CASHIFLE1.INP cu diferenta ca la sfirsit se executa subtotal dupa care urmeaza comanda F de deblocare a tastaturii pentru ca bonul sa poata fi incheiat manual de catre operator.

CASHFILE3.INP este un exemplu de scoatere de sume din sertar cu comanda I urmata de deblocarea tastaturii cu comanda F.

CASHFILE4.INP este exemplu de introducere de sume in sertar cu comanda I urmata de deblocarea tastaturii cu comanda F.