Documentație

1. 01

   Conectează echipamentul

   Driverul verifică porturile seriale și caută un echipament Datecs sau Daisy. Dacă detectarea automată nu reușește, configurează manual conexiunea USB, COM sau TCP/IP. Rezultatul detectării precompletează wizardul, dar nu modifică încă config.json.

2. 02

   Alege modul de rulare

   Alege modul Individual pentru apelarea executabilului cu un bon, Rezident pentru monitorizarea unui director sau Embedded pentru serviciul HTTP. Pentru modul Rezident, specifică directorul cu bonuri.

3. 03

   Configurează licența

   Introdu o licență existentă, solicită o licență trial pentru 14 zile sau continuă fără licență. Fără licență, driverul salvează configurația, dar nu poate tipări.

4. 04

   Salvează și închide configurarea

   Apasă Finalizează pentru a scrie opțiunile în config.json. Pagina afișează instrucțiunile pentru modul ales. Verifică setările avansate dacă este nevoie, apoi apasă Am finalizat setup-ul pentru a opri serverul local.

Wizardul rulează numai la prima pornire fără argumente și este disponibil la http://127.0.0.1:8585/setup. După configurare, pornește din nou DxPrint cu PORNESTE_DXPRINT. Pentru a redeschide setările, rulează scurtătura scurtaturi/start_web_config_local pentru sistemul tău de operare sau folosește -start-config.

Detectează din nou echipamentul

Directorul scurtaturi din fiecare arhivă include o comandă care pornește DxPrint în modul de detectare automată:

Scurtătura rulează comanda -auto-configure-device. Driverul caută echipamentul, actualizează config.json, afișează rezultatul și se oprește fără să deschidă interfața web.

Dacă ai nevoie de configurare manuală, poți modifica direct fișierul config.json. Referința completă este disponibilă mai jos.

{
  "echipament": {
    "tipEchipament": "datecs",
    "port": "COM1",
    "baudRate": 115200,
    "numarOperator": 1,
    "parolaOperator": "0001",
    "numarLogic": 1,
    "connTimeout": 30
  },
  "rulare": {
    "rezident": false,
    "directorBonuri": "bonuri",
    "ftpServer": "",
    "ftpUtilizator": "",
    "ftpParola": "",
    "ftpDirectorBonuri": "",
    "ftpIntervalVerificareInSecunde": 300,
    "httpServerActiv": false,
    "httpPort": 8090,
    "httpUtilizator": "",
    "httpParola": "",
    "httpPermiteListareDirBonuri": true,
    "embedded": false,
    "corsActiv": false,
    "logLevel": "INFO"
  },
  "general": {
    "directorBonuriExecutate": "executate",
    "directorBonuriRaspuns": "raspuns",
    "generareFisierCuNrBonFiscal": true,
    "directorRapoarteAnaf": "ANAF",
    "extensieFisierBon": "inp,bon",
    "intervalPastrareBonuriInDirector": 7,
    "tiparesteRaportZAutomat": true,
    "raspundeCuNrEroareInFisierRaspuns": false,
    "transformaCifDinTextPublicitarInFactura": "",
    "trimiteRaportZPeEmail": "",
    "prevalidareValoareBon": "false",
    "ziDinLunaPentruExtragereAutomataFisiereXml": 0,
    "trimiteFisiereXmlPeEmail": "",
    "httpProxy": "",
    "tiparesteRaportPluInainteDeRaportZ": false,
    "nrMaximRapoarteZNetrimise": 0,
    "nrMaximRapoarteZNetrimiseNotificare": 0,
    "mapareModalitatiPlata": [
      {"modalitate": "NUMERAR", "pozitie": 0},
      {"modalitate": "CARD", "pozitie": 1},
      {"modalitate": "CREDIT", "pozitie": 2},
      {"modalitate": "TICHETE_MASA", "pozitie": 3},
      {"modalitate": "TICHETE_VALORICE", "pozitie": 4},
      {"modalitate": "VOUCHER", "pozitie": 5},
      {"modalitate": "PLATA_MODERNA", "pozitie": 6},
      {"modalitate": "CARD_AVANS_NUMERAR", "pozitie": 7},
      {"modalitate": "ALTE_METODE", "pozitie": 8}
    ]
  },
  "licenta": "Cumpara licenta de pe www.dxprint.ro",
  "versiune": 10
}

Dupa instalarea adaptorului de la usb la serial in calculator, este recomandat sa verificati in Device Manager(Windows) sau in /dev/ttyXXX (Linux, MacOS) si sa identificati numarul portului COM. Dupa identificare acesta trebuie sa fie de forma COM1, COM2, COMXX pentru Windows, si sub forma de /dev/ttyACM0, /dev/ttyACM1, /dev/ttyACMX pentru Linux si MacOS. Aceasta informatie trebuie introdusa in sectiunea port din fisierul de configurare. Valoare implicita COM1.

Pentru conectarea prin TCP/IP, setează portul în formatul tcp://ip:port. Exemplu: tcp://192.168.1.23:3999. Majoritatea echipamentelor folosesc portul 3999. Poți verifica setarea de rețea cu această comandă:

Viteza de comunicatie este de obicei setata in casa de marcat la 115200, dar daca este nevoie se poate modifica direct din sectiunea baudRate conform cu viteza setata in casa. De preferat ca viteza setata in casa sa fie trecuta si in Device Manager la viteza portului COM pentru a nu exista discrepante in comunicarea dintre driver si casa de marcat. Pentru conectarea prin TCP/IP acest parametru este ignorat. Valoare implicita 115200.

tipEchipament reprezintă tipul echipamentului la care se face conectarea. Folosiți datecs pentru echipamentele Datecs și daisy pentru echipamentele Daisy. Valoarea implicită este datecs.

numarOperator reprezinta utilizatorul setat in casa de marcat. Echipamentul fiscal este programat initial cu numarul de operator 1.

parolaOperator reprezinta parola utilizatorului setat in casa de marcat. Echipamentul fiscal este programat initial cu parola de operator 0001.

connTimeout reprezinta timpul de asteptare in secunde al driverului pana cand primeste un raspuns de la echipament. Valoare initiala este de 30 de secunde.

Driverul are doua modalitati de rulare: rezident si nerezident. Pentru a rula in modul rezident este nevoie sa treceti valoarea true la optiunea rezident. In modul rezident driverul monitorizeaza daca in directorul specificat in optiunea directorBonuri exista fisiere de bon noi si pe masura ce acestea sunt adaugate in acest director driverul le prelucreaza pe fiecare in parte.

În modul nerezident, trimite numele fișierului de bon ca argument. Fișierul poate fi în directorul driverului sau poate fi indicat printr-o cale absolută.

Toate optiunile de mai jos sunt valabile doar atunci cand driverul ruleaza in modul rezident (FTP , HTTP) sau in modul embedded (doar HTTP).

ftpServer reprezinta adresa de conectare a serverului FTP la care driverul se conecteaza pentru a putea prelua bonurile generate in directorul specificat prin optiunea ftpDirectorBonuri. Adresa de conectare trebuie sa fie trecuta sub forma ip:port sau hostname:port. Daca portul de conectare este cel standard 21 atunci adresa de conectare poate fi trecuta si fara port.

ftpUtilizator reprezinta utilizatorul pentru conectarea la serverul FTP. In cazul in care serverul permite si conectare Anonymous este obligatoriu sa se specifice numele de utilizator ca fiind Anonymous iar la parola trebuie completat orice.

ftpParola reprezinta parola utilizatorului de server FTP. In cazul in care serverul permite si conectare Anonymous este obligatoriu ca acest camp sa fie completat.

ftpDirectorBonuri reprezinta directorul din cadrul serverului FTP de unde vor fi extrase bonurile fiscale. Ex: bonuri/generate, bonuri. Driverul va incerca sa schimbe in momentul conectarii directorul in cel specificat aici.

ftpIntervalVerificareInSecunde reprezinta intervalul in secunde de verificare a bonurilor noi in directorul specificat din cadrul serverului FTP. Valoare minima 60 de secunde.

Pentru mai multe informatii referitoare la modul de lucru cu un director de pe un server FTP gasiti in sectiunea Printare bonuri din director FTP.

httpServerActiv reprezinta optiunea prin care daca este true se va porni un web server pe portul ales in optiunea httpPort prin care se pot printa bonurile direct printr-un apel POST catre endpointul /bonuri.

httpPort reprezinta optiunea se poate seta portul pentru serverul HTTP. Acest port trebuie sa fie cuprins intre 1024 - 65535.

httpUtilizator reprezinta numele de utilizator dorit pentru protejarea serverului web prin autentificare de tip Basic Auth.

httpParola reprezinta parola de utilizator dorit pentru protejarea serverului web. Doar in momentul in care utilizatorul si parola sunt specificate autentificarea va fi activa.

httpPermiteListareDirBonuri reprezinta optiunea prin care daca este true se va putea accesa din interfata web al driverului disponibila din browser la adresa http://IP:port, directoarele de bonuri executate si de bonuri raspuns specificate in configuratia driverului.

embedded reprezinta optiunea prin care daca este true se vor putea trimite apeluri web atat pentru vanzare cat si pentru rapoartele zilnice printr-un webservice HTTP REST JSON. Adresa ip de lansare al webservice-ului depinde strict de optiunea httpServerActiv, si daca aceasta este activa atunci adresa de ip la care va putea fi accesat va fi adresa de retea de forma 192.168.1.x, iar daca aceasta este inactiva atunci serviciul web se va deschide pe adresa de ip 127.0.0.1, iar portul in ambele cazuri se va citi din optiunea httpPort. Si in acest mod protejarea webservice-ului se poate face prin user si parola specificate in optiunile de mai sus.

Pentru mai multe informatii referitoare la modul de integrare cu aplicatii prin websevice JSON gasiti in sectiunea Integrare cu aplicatii prin serviciu web JSON

corsActiv reprezinta optiunea prin care daca este true se vor putea trimite apeluri web din javascript chiar daca requestul nu este de pe acelasi domain. Afla mai multe despre CORS. Aceasta optiune este valabila doar atunci cand optiunea embedded este activa.
Serverul va trimite urmatoarele headere catre client atunci cand aceasta optiune este activa:
- Access-Control-Allow-Origin: *
- Access-Control-Allow-Methods: OPTIONS,GET,POST,PUT,DELETE,HEAD
- Access-Control-Allow-Headers: X-Requested-With, Content-Type, Authorization, Origin, Accept

logLevel reprezinta nivelul de logare afisat in consola si in fisierul de log. Variantele posibile sunt: DEBUG, INFO sau ERROR.

Aceasta sectiune contine variabilele generale de folosire a driverului, ele fiind valabile pentru ambele modurile de rulare (rezident/nerezident).

directorBonuriExecutate reprezinta directorul in care vor fi copiate bonurile executate. Bonul copiat aici nu va contine informatiile de raspuns. Acesta poate avea cale relativa de forma "executate" si asta inseamna ca se va crea un director cu numele de executate in directorul unde se afla driverul dxprint.exe, sau cale absoluta de forma "c:\\executate", si asta inseamna ca bonul va fi copiat in directorul c:\executate. De retinut faptul ca pentru calea absoluta este necesara trecerea unui \ suplimentar, de forma c:\\ in loc de c:\.

directorBonuriRaspuns reprezinta directorul in care vor fi generate fisierele de raspuns ale bonurilor executate. Acesta poate avea cale relativa de forma "raspuns" si asta inseamna ca se va crea un director cu numele de raspuns in directorul unde se afla driverul dxprint.exe, sau cale absoluta de forma "c:\\raspuns", si asta inseamna ca fisierul va fi generat in directorul c:\raspuns. De retinut faptul ca pentru calea absoluta este necesara trecerea unui \ suplimentar, de forma c:\\ in loc de c:\. Fisierul de raspuns contine informatiile de raspuns exact ca Fprint cu coduri de eroare Er, Ok, Sd si suplimentar la sfarsitul fiecarui rand in cazul in care unul din randuri nu este valid se va trece si motivul pentru care bonul a fost respins. Suplimentar in cazul in care avem situatii de Lipsa hartie sau Raport Z neefectuat, se va trece pe ultimul rand din fisier acest mesaj de eroare.

generareFisierCuNrBonFiscal reprezinta optiunea prin care daca este true atunci in directorul de directorBonuriRaspuns se va genera suplimentar pe langa fisierul de raspuns si un fisier cu extensia .nrb care contine informatii legate de respectivul bon, cum ar fi numarul bonului, numarul Z-ului, numele fisierului si data de executie : OK;Z=38|NR=503|UNIQUE_ID=bon.txt|2018_07_09_17_00_04_312. De retinut faptul ca acest fisier este generat doar atunci cand bonul a fost executat cu succes. Valoare implicita true.

directorRapoarteAnaf reprezinta directorul in care vor fi extrase fisierele in format XML/P7B din echipamentul fiscal, necesare pentru rapoartarea ANAF. Acesta poate avea cale relativa de forma "anaf" si asta inseamna ca se va crea un director cu numele de "anaf" in directorul unde se afla driverul dxprint.exe, sau cale absoluta de forma "c:\\anaf", si asta inseamna ca fisierul va fi generat in directorul c:\anaf. De retinut faptul ca pentru calea absoluta este necesara trecerea unui \ suplimentar, de forma c:\\ in loc de c:\. Suplimentar driverul in momentul executiei rapoartelor de extragere a fisierelor pentru anaf va genera cate un subdirector pentru fiecare tip de raport. Pentru tipul de raport de extragere pe baza numarului Z va genera un director cu numele Z10-20 care reprezinta practic numerele Z de inceput - sfarsit trimise in linia de comanda. Pentru tipul de raport de extragere pe baza intervalului de timp va genera un director cu numele 09-2018 care repezinta luna - an, informatii extrase din data de pornire trimisa in linia de comanda.

extensieFisierBon reprezinta lista de extensii de fisier bon pe care driverul le prelucreaza. Acestea pot fi trecute cu virgula una dupa alta sub forma inp,bon,txt si asta inseamna ca driverul va prelucra doar acele fisiere de bon care au extensia .inp, .bon sau .txt. Daca un fisier de bon nu are extensia trecuta in aceasta optiune va fi ignorat atat in modul rezident cat si in modul nerezident. Valoare implicita inp,bon.

intervalPastrareBonuriInDirector reprezinta numarul maxim de zile prin care un fisier din directoarele definite in directorBonuriExecutate si directorBonuriRaspuns este pastrat. Toate fisierele care sunt mai vechi de numarul de zile specificat in aceasta optiune vor fi sterse automat la pornirea driverului. Numarul de zile maxim permis este 30. Valoare implicita 7 zile.

tiparesteRaportZAutomat reprezinta optiunea prin care daca este true in momentul in care se doreste tiparirea unui bon fiscal si au trecut mai mult de 24 de ore se va tipari mai intai raportul Z urmat apoi de bonul fiscal dorit pentru tiparire initial. Valoare implicita true.

raspundeCuNrEroareInFisierRaspuns reprezinta optiunea prin care daca este true in momentul in care o comanda dintr-un bon fiscal intampina o eroare in executie se va inregistra respectiva eroare in fisierul raspuns al bonului si va fi trecuta sub forma Er-111024. Pentru integrare aveti nevoie de intreaga lista de erori ce poate fi descarcata de aici. Valoare implicita false.

transformaCifDinTextPublicitarInFactura reprezinta optiunea prin care se poate printa codul fiscal in formatul nou cerut de legislatie chiar daca acesta a fost trimis prin text publicitar si anume comanda P. Ca si exemplu, daca aplicatia va genereaza in acest moment urmatoarea comanda: P,1,______,_,__;CUI client: RO123456789;;;;; veti putea trece in aceasta optiune exact textul CUI client: iar in momentul in care se prevalideaza bonul driverul va sti sa extraga codul fiscal si sa-l printeze in formatul nou. Continutul optiunii este case insensitive.

trimiteRaportZPeEmail reprezinta optiunea prin care se poate trimite email cu raportul Z in momentul in care acesta este lansat si va fi trimis catre adresele de email specificate in aceasta optiune. Pot fi trecute mai multe adrese de email cu virgula una dupa alta. Ca si exemplu: suport@dxprint.ro,test@test.com. Apelul de trimitere raport Z pe email este apel HTTP POST catre webservice-ul https://www.dxprint.ro, iar acesta dupa validare continut primit va trimite email mai departe cu informatiile primite de la driver. De retinut faptul ca aceste informatii sunt trimise in mod securizat, nu sunt stocate pe serverele noastre sau pe serverele Amazon. Firma noastra foloseste serviciile Amazon AWS pentru trimiterea tuturor email-urilor.

prevalidareValoareBon reprezinta optiunea prin care daca este activata bonul nu se trimite catre echipament decat atunci cand sumele sunt validate. Avand aceasta optiune activa sansele ca bonul sa ramana deschis ca nu s-au trimis sumele de total plata corect sunt minime. Valoare implicita false.

ziDinLunaPentruExtragereAutomataFisiereXml reprezinta ziua din luna in care se va incerca exportul fisierelor XML din luna precedenta si trimiterea lor catre o adresa de email daca optiunea trimiteFisiereXmlPeEmail este completata cu cel putin o adresa de email. Exportul se face indiferent daca optiunea trimiteFisiereXmlPeEmail este completata sau nu. Valoarea acestei optiuni poate fi intre 0 si 20. Valoarea 0 inseamna ca aceasta optiune este dezactivata. Intervalul 1 - 20 reprezinta zilele din luna in care se va putea face exportul automat. In momentul in care optiunea este activa iar exportul de fisiere XML se va lansa, aceasta procedura va genera in directorul definit in optiunea directorRapoarteAnaf o arhiva de forma luna-an.zip,(Ex: 04-19.zip). De retinut faptul ca daca avem data de 5 aleasa ca data de export automat a fisierelor XML iar in data de 5 a lunii nu se deschide casa din varii motive driverul va incerca in urmatoarele 2 zile adica pe data de 6 si pe data de 7 acelasi lucru de export automat. In cazul in care pe data de 5 fisierele XML au fost extrase si arhiva a fost creata atunci driverul nu va mai incerca aceasta procedura de export in urmatoarele 2 zile. Valoare implicita 0.

trimiteFisiereXmlPeEmail reprezinta optiunea prin care fisierele XML exportate automat din echipamentul fiscal se pot trimite catre adresa sau adresele de email specificate in aceasta optiune. Este necesar ca optiunea ziDinLunaPentruExtragereAutomataFisiereXml sa fie activa. Pot fi trecute mai multe adrese de email cu virgula una dupa alta. Ca si exemplu: suport@dxprint.ro,test@test.com. Apelul de trimitere fisiere XML pe email este apel HTTP POST catre webservice-ul https://www.dxprint.ro, iar acesta dupa validare continut primit va trimite email mai departe cu informatiile primite de la driver. De retinut faptul ca aceste informatii sunt trimise in mod securizat, nu sunt stocate pe serverele noastre sau pe serverele Amazon. Firma noastra foloseste serviciile Amazon AWS pentru trimiterea tuturor email-urilor.

httpProxy reprezinta serverul proxy folosit pentru cele 2 servicii disponibile in driver de trimitere raport Z pe email si de trimitere fisiere XML generate automat din echipament fiscal pe email. De obicei se foloseste atunci cand calculatorul de client unde este instalat driverul are accesul la internet restrictionat de obicei printr-un proxy. Formatul adresei de proxy este (http|https)://(hostname:ip):port. Apelurile de trimitere raport Z/fisiere XML pe email sunt apeluri http POST catre webservice-ul https://www.dxprint.ro.

tiparesteRaportPluInainteDeRaportZ reprezinta optiunea prin care daca este activata se va tipari raportul de produse Z PLU inainte de raportul Z. Valoare implicita false.

nrMaximRapoarteZNetrimise reprezinta numarul de rapoarte Z nesincronizate cu serverul ANAF. In cazul in care numarul de rapoarte Z nesincronizate depaseste aceasta optiune driverul se va opri din executie. Daca optiunea este 0 inseamna ca aceasta verificare nu se va face. Valoare implicita 0.

nrMaximRapoarteZNetrimiseNotificare reprezinta numarul de rapoarte Z nesincronizate cu serverul ANAF care vor genera o notificare pe email. Daca numarul de rapoarte Z nesincronizate depasteste aceasta optiune se va genera o notificare pe email prin care se transmite ca exista un nr de x rapoarte Z nesincronizate. Aceasta notificare va folosi adresele de email definite in optiunea trimiteRaportZPeEmail. Aceasta notificare va fi trimisa doar daca driverul ruleaza in modul embedded sau rezident. Daca optiunea este 0 inseamna ca aceasta verificare nu se va face. Valoare implicita 0.

mapareModalitatiPlata reprezinta optiunea prin care se pot remapa modalitatile de plata in momentul in care este tiparit bonul fiscal. Aceasta remapare ofera o compatibilitate mai mare cu aplicatiile existente.

Reprezinta licenta de functionare a driverului. Fara aceasta licenta nu se pot trimite comenzi catre echipamentul fiscal. Este important ca licenta de functionare sa fie trecuta pe o singura linie in locul textului Cumpara licenta de pe www.dxprint.ro, si sa contina inclusiv cele 2 egaluri de la sfarsitul acesteia.

Reprezinta versiunea de configuratie pentru driverul de comunicatie, este recomandat sa nu se modifice aceasta valoare.

In momentul in care driverul ruleaza in mod rezident iar optiunile din cadrul sectiunii ftp sunt completate atunci acesta va porni un ticker care o data la intervalul specificat va incerca sa se conecteze pe serverul FTP in directorul specificat si de acolo sa extraga toate fisierele de comenzi bon care au extensia permisa in lista de extensii din optiunea extensieFisierBon. Trebuie specificat faptul ca verificarea se va face doar dupa prima extensie, si deci in cazul in care in optiune avem specificate 2 sau mai multe extensii sub forma inp,bon,txt atunci driverul va extrage doar fisierele care au extensia .inp. In cazul in care nu exista extensii specificate driverul va extrage fisierele care vor avea extensia .inp.

In momentul in care in directorul FTP exista fisiere, pentru fiecare fisier se va incerca descarcarea acestuia si copierea intr-un fisier cu acelasi nume doar ca i se va mai alipi si _FTP_datetime. In felul acesta in directorul bonurilor executate si a celor de raspuns se vor putea identifica rapid fisierele care au venit dintr-un folder FTP. Dupa ce fisierul a fost creat si salvat in directorul de bonuri al modului rezident specificat prin optiunea directorBonuri fisierul original din directorul FTP va fi sters.

Dupa executia bonului acesta va fi copiat in directoarele de bonuri executate si bonuri raspuns iar fisierul de raspuns va contine si data de executie pe langa data de preluare din directorul FTP.

Este recomandat ca intervalul de verificare sa fie unul realist si anume sa fie raportat la numarul de bonuri generate in respectiva perioada. Durata de tiparire a unui bon depinde de numarul de comenzi existente in acesta.

De specificat faptul ca driverul poate fi folosit in acelasi timp si pentru o aplicatie de vanzare locala care genereaza bonurile in acelasi director de bonuri. Faptul ca sunt extrase bonurile dintr-un director FTP nu incurca cu nimic functionarea locala a driverului. In plus se poate folosi in acelasi timp inclusiv cu primirea bonurilor prin protocol HTTP.

In momentul in care driverul ruleaza in mod rezident iar optiunea httpServerActiv este activa atunci acesta va porni un server web prin care poate primi comenzi direct prin protocolul HTTP.

Serverul web creat va avea adresa formata din adresa de IP al calculatorului de pe care se ruleaza driverul si portul specificat in optiunea httpPort. Ca si exemplu daca calculatorul de pe care rulati driverul are ip-ul 192.168.1.23, iar portul ales de dumneavoastra este 8080, puteti accesa interfata web al driverului direct din browser prin apelarea adresei http://192.168.1.23:8080.

De retinut faptul ca exista o probabilitate foarte mare ca sistemul de operare sa va solicite permisiunea de a accepta conexiuni pe portul specificat de dumneavoastra. Este recomandat sa permiteti acest lucru pentru a putea folosi aceasta functionalitate. Trebuie specificat faptul ca serverul creat nu este unul securizat prin certificat SSL, el fiind gandit pentru retele interne cu mai mult de 2 calculatoare si cu o singur echipament fiscal.

Pentru exemplele de mai jos vom folosi adresa serverului ca fiind http://192.168.1.23:8080 pentru a fi mai simplu in exemplificare. Dar trebuie tinut cont de faptul ca adresa dumneavoastra de IP mai mult ca sigur va fi diferita.

Adresa de IP o puteti afla dupa cum urmeaza:
Wndows: Din Command Prompt apeland comanda ipconfig si in rezultat trebuie sa va uitati dupa sectiunea IPv4 Address.
Linux, Mac: Din Terminal apeland comanda ifconfig si la fel in rezultat trebuie sa se verifice sectiunea inet din cadrul eth0, sau en0 in functie de cate placi de retea aveti instalate.

Dupa pornirea driverului cu serverul de http activat puteti verifica ca acesta functioneaza apeland interfata web al driverului direct din browser la adresa http://192.168.1.23:8080. In pagina afisata o sa aveti toate detaliile pentru a putea printa un bon de pe alt calculator din retea sau din alta parte inclusiv sa accesati directoarele de bonuri executate si bonuri raspuns daca optiunea httpPermiteListareDirBonuri este activa.

Pentru a putea un bon prin HTTP aveti nevoie sa trimiteti un apel de tip POST catre adresa http://192.168.1.23:8080 iar continutul body-ului trebuie sa fie liniile de comanda din fisierul de bon. Daca se doreste specificarea numelui de bon aceasta informatie se poate trimite printr-un query param cu numele nume. Ca si exemplu avem un bon cu numele specificat bon.inp care contine un produs cu discount de 10% trimite printr-un apel http:

POST http://192.168.1.23:8080/bonuri?nume=bon.inp HTTP/1.1
Content-Type: text/plain; charset=utf-8
Content-Length: 200

S,1,______,_,__;Produs cu denumire 1;10.00;1.000;1;1;1;0;0;buc;
C,1,______,_,__;1;10.00;;;;
W,1,______,_,__;ic;Reducere client fidelizare: 10%;
W,1,______,_,__;ic;Va multumim!;
T,1,______,_,__;0;;;;;

In cazul in care aveti si autentificarea activata va trebuie sa trimiteti apelul cu headerul Authorization ca in exemplu de mai jos. Autentificarea este de tip Basic Auth.

POST http://192.168.1.23:8080/bonuri?nume=bon.inp HTTP/1.1
Content-Type: text/plain; charset=utf-8
Authorization: Basic dXNlcjpwYXJvbGE=
Content-Length: 200

S,1,______,_,__;Produs cu denumire 1;10.00;1.000;1;1;1;0;0;buc;
C,1,______,_,__;1;10.00;;;;
W,1,______,_,__;ic;Reducere client fidelizare: 10%;
W,1,______,_,__;ic;Va multumim!;
T,1,______,_,__;0;;;;;

Ca si raspuns la apelul de mai sus se va intoarce numele de fisier generat pentru tiparire. In aceasta versiune de driver nu exista validare direct in webserver. Comenzile trimise in body sunt trimise catre driver si pe baza lor se va construi un fisier de bon care va fi copiat in directorul de bonuri specificat prin optiunea directorBonuri si executat ca orice alt bon.

Un raspuns la bonul trimis prin http mai sus va contine in body numele fisierului generat de catre server/driver si trimis catre echipamentul fiscal. Totodata la numele bonului primit va fi alipit si _HTTP_ip_client_port_client_datetime pentru a se putea identifica rapid in fisierele executate sau de raspuns exact de la ce calculator a fost primit, prin ce protocol si la ce data si ora. In cazul exemplulu de mai jos bonul a fost primit de la calculatorul cu ip 192.168.1.50 in data de 12.09.2018 la ora 13:20:36.

HTTP/1.1 200 OK
Content-Type: text/html
Date: Tue, 11 Sep 2018 10:20:36 GMT
Content-Length: 52

bon_inp_HTTP_192_168_1_50_59936_2018_09_12_13_20_36_124.inp

Daca aveti nevoie de ajutor in implementarea unui client http necesar pentru aceasta procedura va rugam sa ne contactati la adresa de email suport@dxprint.ro.

De specificat faptul ca driverul poate fi folosit in acelasi timp si pentru o aplicatie de vanzare locala care genereaza bonurile in acelasi director de bonuri. Faptul ca sunt primite bonuri si prin protocolul HTTP nu incurca cu nimic functionarea locala a driverului. In plus se poate folosi in acelasi timp inclusiv cu extragerea bonurilor din director FTP.