Introducere

Această documentație oferă detalii tehnice exhaustive pentru integrarea cu driverul FisCool. Este proiectată pentru dezvoltatori software și integratori de sisteme care necesită o înțelegere profundă a capabilităților și interfețelor driverului.

Driverul este arhitecturat pentru a oferi flexibilitate maximă, oferind trei metode distincte de integrare pentru a se adapta la diverse designuri de sisteme, de la sisteme bazate pe fișiere moștenite la aplicații moderne în timp real.

Casă Virtuală cu Jurnal Electronic

Casă virtuală cu jurnal electronic în FisCool.

Testați ușor integrările cu aparatura fiscală fără să stați cu 10 case pe birou. Dacă merge cu casa simulată, va merge și cu cea reală.

Prevalidare completă și nu numai, puteți vizualiza/exporta rapoartele, jurnalul electronic și chiar simula cazuri de eroare (lipsă hârtie, probleme conexiune, timpi de răspuns, etc). Se comportă exact ca o casă normală.

Notă: Trebuie activată în setările FisCool, la Setări -> Setări aplicație -> Activează dispozitive simulate. Apoi, veți putea crea case cu Brand și Model "Simulated".

Structura Documentației

Această documentație este organizată în secțiuni focalizate, fiecare oferind detalii tehnice complete:

  • Operațiuni Dispozitive - Referință completă a tuturor operațiunilor fiscale și POS, cu specificații detaliate ale parametrilor, formate de răspuns și gestionarea cazurilor limită
  • Interfața Fișiere INP - Ghid exhaustiv pentru metoda de integrare bazată pe fișiere, incluzând sintaxa comenzilor, procesarea fișierelor și gestionarea erorilor
  • API HTTP - Referință comprehensivă REST API cu documentația completă a endpoint-urilor, exemple de cereri/răspunsuri și coduri de eroare
  • API Headless - Documentație pentru gestionarea programatică a driverului (configurare dispozitive, setări, actualizări)
  • API WebSocket - Detalii protocolare de comunicare în timp real, incluzând învelișuri de mesaje, coduri de acțiune și exemple de implementare client
  • Coduri Eroare - Referință completă a codurilor de eroare pentru depanare și gestionarea erorilor

Metode de Integrare

  1. Interfața Fișiere INP

    Un mecanism de monitorizare dosare proiectat pentru compatibilitate maximă cu sistemele moștenite care operează prin plasarea fișierelor de comandă într-un director. Această metodă este asincronă și robustă, făcând-o ideală pentru tipărirea bonurilor fiscale și rularea rapoartelor zilnice fără integrarea directă API.

  2. API HTTP

    Un API RESTful standard, fără stare pentru comunicare directă cu driverul. Este simplu de implementat și ideal pentru aplicațiile care trebuie să interogeze starea dispozitivului sau să execute operațiuni specifice, autonome la cerere.

  3. API Headless

    Un API specializat pentru gestionarea driverului în sine (dispozitive, setări, actualizări) în mod programatic, permițând automatizarea completă fără interacțiunea utilizatorului.

  4. API WebSocket

    Un canal de comunicare în timp real, cu stare proiectat pentru sistemele POS partenere și aplicațiile care necesită feedback instant, operațiuni asincrone și evenimente împinse de server (cum ar fi schimbările de stare ale dispozitivului). Aceasta este metoda de integrare cea mai puternică și receptivă.

Principii Fundamentale

  • Operațiuni Unificate: Toate acțiunile principale (de ex., tipărirea unui bon, efectuarea unei vânzări POS) sunt definite ca "Operațiuni Dispozitive" unificate. Aceste operațiuni pot fi invocate prin API-ul HTTP, API-ul WebSocket sau analizate din fișierele INP, asigurând un comportament consistent pe toate interfețele.
  • Tipizare Puternică: API-urile moderne (HTTP/WS) folosesc structuri JSON puternic tipizate, reducând riscul cererilor malformate.
  • Gestionarea Detaliată a Erorilor: Driverul oferă un set comprehensiv de coduri de eroare pentru a distinge între problemele de configurare la nivel de aplicație și erorile hardware sau de stare la nivel de dispozitiv.
  • Documentație Completă: Fiecare parametru, câmp de răspuns, caz limită și condiție de eroare este documentată cu exemple și bune practici.

Fiecare secțiune oferă exemple gata pentru producție, specificații complete ale parametrilor și ghidare practică de integrare. Folosiți navigația din stânga pentru a explora în detaliu fiecare metodă de integrare.