Manual

Ce face Poleo Fiscal?

Poleo Fiscal stă între programul tău de vânzări și casa de marcat. Programul de vânzări transmite o cerere către Poleo Fiscal, iar Poleo Fiscal transmite comanda, întocmai, la aparatul fiscal și aduce înapoi răspunsul (numărul bonului sau eroarea). Similar și pentru aparatele de tip POS bancar.

Programul lucrează pe principiul neutralității: nu interpretează ce primește. Dacă programul de vânzări trimite indicele de plată 3, la casă pleacă 3 - chiar dacă în alt magazin 3 înseamnă altceva. Cotele de TVA și formele de plată sunt programate în aparatul fiscal, iar Poleo Fiscal nu le modifcă, traduce și nu le girează.

Cum ajung bonurile la Poleo Fiscal

  • Folder monitorizat - programul de vânzări lasă fișiere text (comenzi) într-un folder, iar Poleo Fiscal le ia de acolo, le transmite către casa de marcat și, în funcție de răspunsul acesteia, le mută în folderele done sau error.
  • API HTTP local - programul de vânzări cere direct operațiuni, prin apeluri HTTP.
  • Din aplicație - operațiunile pe care le faci tu: rapoarte, numerar, jurnal electronic.

Ce NU face

  • Nu anulează un bon fiscal deja tipărit - nici el, nici casa, nici producătorul ei.
  • Nu ține contabilitate și nu înlocuiește programul de gestiune.
  • Nu decide cota de TVA sau forma de plată; le trimite pe cele primite.

Instalare și prima pornire

Instalarea

Installerul se despachetează implicit în C:\PoleoFiscal, nu în Program Files pentru ca aplicația trebuie să scrie lângă ea baza de date, jurnalele și backupurile, iar softul de vânzare trebuie să scrie bonurile de comanda, iar Windows nu permite aceste operațiuni în orice foldere.

La instalare alegi:

  • Scurtătură pe desktop - recomandat, și fixare în bara de activități;
  • Pornește automat odată cu Windows - recomandat, ca bonurile trimise de programul de vânzări să nu se adune netipărite;
  • Componenta ANAF (DUKIntegrator) - bifată și nedebifabilă, este obligatorie pentru Jurnalul Electronic. Se descarcă la instalare; dacă nu merge atunci, aplicația o aduce singură la nevoie.

La dezinstalare, datele NU se șterg: evidența bonurilor, jurnalul salvat și setările rămân pe disc.

Prima pornire

Aplicația pornește fără nicio casă configurată și îți spune asta. Primul pas e Case de marcat → + Adaugă o casă. Până există o casă, taburile de setări care descriu un aparat sunt stinse - setările lor se scriu pe seria casei, nu global.

Fereastra aplicației

Aplicația are o bară de titlu proprie, un meniu în partea stângă și conținutul în partea dreaptă.

Bara de sus

  • Butonul hamburger - strânge meniul la iconițe, ca să rămână mai mult loc pentru conținut.
  • Starea conexiunii - „Conectat" / „Deconectat" pentru casa activă.
  • Selectorul de casă - când ai mai multe case, alegi aici pe care lucrezi.
  • Plicul - alertele aplicației, cu un număr când sunt necitite.
  • Rotița - Setări. Semnul întrebării - Ajutor.
  • Minimizare / maximizare / închidere - închiderea duce aplicația în tray, nu o oprește, dacă așa ai ales în Setări.

Meniul din stânga

Dashboard, Operațiuni, Istoric, Rapoarte, Case de marcat, Multi-print, Setări, Tutoriale. Elementul activ este evidențiat. Pe Istoric poate apărea un număr roșu: atâtea bonuri așteaptă în coadă (casa a fost picată). Pe Multi-print, iconița își schimbă culoarea după starea legăturii.

Jos stau starea licenței (Activ / Probă, cu zilele rămase) și versiunea instalată.

Benzile de avertizare

Sub bara de sus apar benzi colorate cu ce trebuie făcut acum: hârtie terminată, casă deconectată, fond de rulaj neintrodus, raport Z restant, licență aproape expirată. Fiecare bandă are, unde are sens, butonul care rezolvă problema.

Dashboard

Prima pagină: cum stă ziua de azi, pe casa activă.

Cele patru cartonașe de sus

  • Bonuri emise - câte bonuri au fost tipărite azi.
  • Totalul încasărilor - suma încasată azi.
  • Total TVA - TVA-ul aferent.
  • Z rapoarte - câte rapoarte Z s-au făcut azi și la ce oră a fost ultimul.

Totaluri fiscalizate

Graficul încasărilor și al TVA-ului, cu comutator Zi / Săptămână / Lună. Sub el, trei totaluri: totalul încasărilor, total TVA și valoarea medie a unui bon.

Operațiuni rapide

Scurtături către cele patru operațiuni folosite zilnic: Depunere de numerar, Retragere de numerar, Tipărire raport X, Tipărire raport Z. Sunt aceleași cu cele din pagina Operațiuni.

Rapoarte recente

Ultimele rapoarte (tip, număr, dată/oră, total), cu legătură către pagina Rapoarte.

Starea conexiunii

Ce aparat este configurat și cum răspunde: modelul, seria (NUI), portul sau adresa, dacă monitorizarea este pornită, CUI-ul citit din casă. Creionul din colț duce direct în configurarea conexiunii casei active, iar butonul de jos, Testează conectarea, întreabă aparatul pe loc.

Operațiuni

Tot ce poți cere casei, cu un clic. Ce nu suportă modelul tău apare stins, cu explicația la trecerea mouse-ului peste element.

Numerar

  • Depunere de numerar - bani puși în sertar. Dimineața, tipic fondul de rulaj; suma propusă este cea din Setări → Numerar.
  • Retragere de numerar - bani scoși din sertar.

Ambele deschid o fereastră unde scrii suma și, opțional, explicația. Seria aparatului este scrisă în fereastră, ca să nu greșești casa când ai mai multe.

Rapoarte fiscale

  • Raport X - raport de verificare. Nu închide ziua, nu zerează nimic, se poate face oricând.
  • Raport Z - închide ziua fiscală și ocupă definitiv un loc în memoria fiscală. Obligatoriu zilnic; se transmite la ANAF.
  • Raport periodic Z - totalurile pe un interval de date, citite din memoria fiscală. Nu închide nimic.
  • Citește Jurnalul Electronic (JE) - alegi perioada, aplicația cere casei rapoartele semnate, le salvează pe disc și ți le arată aici: vizor, căutare, copiere, salvare ca .txt, trimitere pe email. Ce este deja salvat nu se mai cere casei a doua oară.
  • Vezi arhiva JE salvată - aceeași fereastră, dar pornită de pe disc, fără să mai întrebe casa. Merge și cu aparatul oprit sau scos din rețea.
  • Interogare ANAF - câte rapoarte Z n-au ajuns încă la ANAF, când s-a conectat casa ultima dată și cu ce eroare.
  • Trimite acum la ANAF - forțează transmiterea celor rămase. Casa acceptă comanda o dată la câteva minute, deci nu are rost apăsată repetat. Nu tipărește nimic.

Istoric

Toate documentele trecute prin aplicație, pe casa aleasă.

  • Filtrul de sus alege ce vezi: toate, doar bonuri, doar rapoarte, doar numerar (depuneri/retrageri), doar cele cu probleme.
  • Intervalul de date - de la / la.
  • Fiecare rând se desface și arată detaliile documentului: articolele, sumele, forma de plată, răspunsul casei.

Bonurile care nu s-au tipărit intră în coada de reîncercare și se retrimit singure când casa revine. Numărul din meniu, lângă „Istoric”, arată câte așteaptă. De aici poți retipări manual un bon eșuat.

Rapoarte

Istoricul rapoartelor fiscale (X, Z, periodice), pe casa aleasă, cu filtru de tip și interval de date calendaristice. Fiecare rând arată tipul, numărul, data și ora, și totalul.

Lista este virtualizată: chiar cu mii de rapoarte, pagina rămâne rapidă.

Case de marcat

Aici adaugi și configurezi aparatele. Fiecare casă are cardul ei, cu numele, starea conexiunii, modelul, portul sau adresa, dacă monitorizarea este activă și folderul monitorizat.

Butoanele fiecărei case

  • Pornește / Oprește monitorizarea - urmărirea folderului cu bonuri. O casa poate fi conectată și să nu tiparească dacă monitorizarea este oprită. Util pentru a verifica dacă bonurile ajunge unde trebuie, fără să tipăresti ceva pentru acel test sau să oprești casa.
  • Testează conexiunea - întreabă aparatul acum; dacă răspunde, îți arată modelul și seria.
  • Editează - deschide formularul casei.
  • Citește - citește din aparat cotele de TVA programate și sloturile de încasare (vezi Mapările casei).
  • Șterge - scoate casa din aplicație. Documentele deja înregistrate rămân.

Formularul casei, câmp cu câmp

CâmpCe e
DenumireNumele sub care vezi casa în aplicație. Doar pentru tine.
ProducătorMarca aparatului (Datecs, Tremol, Daisy, Incotex, Partner…).
ModelModelul din marca aleasă. El stabilește ce operațiuni sunt disponibile.
Tip de legăturăSerial (cablu sau USB care apare ca port COM) sau Rețea (aparatul are adresă IP). Unele modele merg pe amândouă.
PortLa serial: portul COM. Aplicația îl poate găsi singură.
Viteză (baud)La serial: viteza de comunicație, tipic 115200. Se poate detecta.
Adresă (IP) și portLa rețea: adresa aparatului și portul lui.
Serie (NUI)Numărul unic de identificare, atribuit la fiscalizare. Se citește din aparat, nu se scrie de mână. Licența se acordă pe această serie, iar setările casei se țin tot pe ea.
CUICodul fiscal citit din aparat, ca să știi a cui este casa.
Operator și Parola operatoruluiContul cu care aplicația deschide bonuri pe casă. Vin din programarea aparatului.
Parola de administratorCerută de unele operațiuni (rapoarte, setări în casă).
DepartamentDepartamentul implicit pe care cad articolele, când programul de vânzări nu trimite unul. Cota de TVA vine din cum este programat departamentul în casă.
Casa (till)Numărul casei, când aparatul lucrează cu mai multe.
Folder monitorizatUnde lasă programul de vânzări fișierele-bon. Aplicația propune un folder numit după seria casei, ca două aparate să nu se calce.
Folder „done" / „error"Unde se mută fișierele după tipărire, reușită sau nu.
Casa de pe serverCând tipărești printr-o altă stație (Multi-print), aici este casa de pe serverul acela.

Detectarea automată

Butonul Detectează automat caută aparatul singur: pe porturile COM existente și, la modelele de rețea, pe adresele din rețeaua ta. Găsește portul, viteza și seria. Dacă Windows renumerotează adaptorul USB (se întâmplă des), aplicația regăsește singură casa și își actualizează configurația.

Mapările casei de marcat

Butonul Citește, de pe cardul casei, arată ce este programat în aparat. este o citire: nu se modifică nimic.

  • Cotele TVA programate - grupa (A, B, C…) și procentul (21%, 11%, 0%).
  • Sloturile de încasare - ce înseamnă fiecare index (numerar, card, tichete, bon valoric…).

Cotele și formele de plată sunt setate în aparat și pot fi pe indici diferiți de la o casă la alta - chiar în cadrul aceleiași mărci. Poleo Fiscal nu le traduce: trimite mai departe exact indicele primit de la programul de vânzări. Dacă bonul iese cu altă formă de plată decât te aștepți, aici compari ce este în casă cu ce trimite programul. Această metodă este dependentă de posibilitatea casei de marcat de a oferi aceste informații, la cerere, "prin cablu".

Multi-print (tipărire în rețea)

Mai multe calculatoare pot tipări la aceeași casă, prin stația care ține legătura cu aparatul. Stația aceea este serverul; celelalte sunt clienți.

  • Pe stația cu casa: pornești serverul și autorizezi fiecare client.
  • Pe celelalte: adaugi o casă de tip rețea care arată spre server și alegi casa lui.

Funcția nu multiplică licența: ea rămâne una singură, a aparatului. Iconița din meniu își schimbă culoarea după starea legăturii, ca să vezi din meniu dacă este ceva de rezolvat.

Tutoriale și Ajutor

Tutoriale - pași ghidați pentru lucrurile pe care le faci rar (prima configurare, backup, jurnal electronic).

Ajutorul se deschide cu semnul întrebării din bara de sus. Are un ghid scurt, împărțit pe subiecte, și o căutare care se uită atât în titluri, cât și în text: scrii un cuvânt („sertar", „ANAF", „grație") și rămân doar subiectele care îl conțin, cu potrivirile evidențiate în pagină.

Tot de acolo deschizi manualul complet al aplicației (cel pe care îl citești acum) și manualul API. Amândouă sunt salvate pe calculatorul tău, deci se deschid și când nu ai internet.

Licență și perioadă de probă

Licența se acordă pe seria (NUI) a aparatului, nu pe calculator. Poți muta programul pe alt PC și folosi aceeași casă cu aceeași licență. Fiecare aparat are nevoie de licența lui. Ulterior expirării unei licențe, nu vei mai putea utiliza acea casă nici pe alte calculatoare. Pe acel calculator nu vei mai putea utiliza Poleo Fiscal nici cu alte case de marcat.

Proba

  • 30 de zile sau 500 de bonuri - indiferent ce limită atingi prima oară -, pe seria casei. Contorul este ținut și pe server, deci reinstalarea nu îl resetează.
  • Dacă la prima pornire aplicația nu ajunge la server (casă nouă, fără internet), primești o probă locală de 5 zile sau 500 de bonuri, - indiferent ce limită atingi prima oară - cât să poți lucra până se face legătura. Se dă o singură dată pe calculator, cât timp nu există licență plătită.

Fără internet

Cu licență plătită și verificată măcar o dată, aplicația merge 30 de zile fără legătură la server. O pană la noi sau internetul căzut nu au voie să oprească un magazin care și-a plătit licența. Ești avertizat din timp: sub 10 zile rămase o dată, sub 5 zile în fiecare zi.

La expirare

Se blochează tipărirea și raportarea pentru casa respectivă. Datele deja înregistrate rămân accesibile.

API-ul local

Programul tău de vânzări poate cere operațiuni direct, prin HTTP, fără să mai treacă prin fișiere. Serverul rulează pe calculatorul tău și este protejat cu un token.

  • Tu decizi dacă interfața este ascultată și în rețea și către ce adrese. Recomandarea rămâne s-o ții doar pe calculatorul local.
  • O cerere care vine cu tokenul valid este considerată a fi a ta - păstrează tokenul în siguranță.
  • Prin API nu se pot schimba setările serviciului API însuși (pornire, ascultare în rețea, port, adrese permise). Ele rămân în fereastra aplicației, la îndemâna omului din magazin.

Cum comanzi bonuri dintr-un serviciu aflat la distanță

Ai un magazin online sau un serviciu propriu și vrei ca, la o comandă, să se tipărească un bon pe casa dintr-un anumit magazin. Se poate, și nu presupune deschiderea niciunui port în magazin.

Nu serverul tău sună la magazin, ci magazinul sună la serverul tău. Stația din magazin întreabă periodic serviciul tău dacă are ceva de tipărit, execută ce primește și raportează rezultatul înapoi.

De ce în sensul ăsta

Ca un program din altă rețea să comande casa, cineva ar trebui să deschidă o ușă în routerul magazinului. Atunci casa de marcat devine publică: oricine îi află acreditarea îi tipărește bonuri, iar un bon fiscal tipărit nu se mai retrage. Așa, ușa nu se deschide deloc. În plus, dacă serviciul tău cade, în magazin nu se strică nimic - stația pur și simplu nu mai are ce lua.

Ce trebuie să pui la dispoziție

Două adrese pe serviciul tău:

AdresăCine o cheamăCe face
GET jobsstația din magazinÎntoarce lucrările în așteptare pentru acea stație, ca listă în câmpul jobs. Fiecare lucrare are un id propriu.
POST resultsstația din magazinPrimește rezultatul: job_id, dacă a reușit, și datele documentului emis.

Cum se poartă stația

  • Întreabă o dată la 15 secunde.
  • Ia cel mult 5 lucrări dintr-o tură, ca să nu se blocheze pe o coadă lungă.
  • Acceptă cel mult 512 KB într-un răspuns.
  • Fiecare lucrare trebuie să aibă un id. Fără id, stația o sare: fără el nu poate garanta că nu tipărește același bon de două ori.
  • O lucrare deja executată nu se repetă: stația își amintește rezultatul și îl raportează din nou, marcat ca repeated. Dacă răspunsul tău se pierde pe drum, poți cere liniștit aceeași lucrare - nu iese al doilea bon.

Condiții pe care serviciul tău trebuie să le îndeplinească

  • HTTPS cu certificat valid. Pe http stația nu se conectează, iar bifă „acceptă orice certificat" nu există și nu va exista.
  • Fără redirecționări. O redirecționare acceptată tacit e felul obișnuit în care o legătură criptată ajunge una în clar. Stația refuză orice redirecționare.
  • Acreditarea se trimite în antet, niciodată în adresă - adresele ajung în jurnalele serverelor și ale intermediarilor.

Legătura se adaugă din Setări → API → Legăturile cu servicii din afară, unde dai adresa serviciului și acreditarea primită de la el, apoi alegi ce are voie să facă. Poate fi oprită oricând, unilateral.

Manualul complet, cu toate metodele și exemple în Python, PHP și C, este în Ajutor → Manualul API.

Securitate: ce se deschide și cum te aperi

Orice interfață pornită înseamnă o ușă deschisă în plus. Mai jos scrie exact ce deschide Poleo Fiscal, când, și ce ai de făcut ca ușa aceea să nu fie o problemă. Nimic din ce urmează nu este pornit din fabrică, cu derogările prevăzute în tabel.

Ce porturi poate deschide aplicația

CePortDin fabricăCine ascultă
API-ul HTTP local9714 (se poate schimba)oprit Doar 127.0.0.1, dacă nu bifezi „Ascultă și în rețea"
Serverul Multi-printconfigurabiloprit Rețeaua ta locală, doar stațiile pe care le autorizezi

Aplicația nu deschide singură niciun port către internet. Există totuși două căi prin care o cerere ("dă-mi" sau "fă") poate porni de departe, și pe amândouă le controlezi tu:

  • Adresele permise (CORS) - dacă adaugi aici adresa unui site, o pagină deschisă în browserul de pe acest calculator poate cere aplicației operațiuni, inclusiv tipărirea unui bon fiscal. Pagina poate fi servită de un server aflat oriunde. Lăsat gol, niciun site nu are voie; nu pune niciodată *.
  • Ascultarea în rețea - dacă o bifezi, iar routerul tău redirecționează portul din internet către acest calculator, API-ul devine accesibil din afară. Verifică să nu existe o astfel de redirecționare.

Legăturile pornite de aplicație (verificarea licenței, actualizările, emailul) merg întotdeauna dinspre aplicație către server, nu invers.

Cât timp API-ul ascultă doar pe 127.0.0.1, nimeni din afara calculatorului nu poate ajunge la el - nici din rețeaua magazinului, nici de pe internet. În clipa în care bifezi „Ascultă și în rețea", orice calculator din aceeași rețea poate încerca să negocieze cu aplicația. Cine are tokenul poate cere tipărirea unui bon fiscal, rapoarte, operațiuni de numerar. Bonul iese pe casa ta și este un document fiscal real. De aceea tokenul se utilizează și păstrează ca o parolă, nu ca un număr de inventar.

Riscul, pe înțelesul tuturor - Cereri care pot porni de departe

Aplicația nu deschide singură niciun port către internet. Există totuși două situații în care o cerere poate porni din afara calculatorului, iar pe amândouă le controlezi tu. Niciuna nu e activă din fabrică.

Adresele permise (CORS)

Dacă adaugi aici adresa unui site, o pagină deschisă în browserul de pe acest calculator poate cere aplicației operațiuni, inclusiv tipărirea unui bon fiscal. Pagina poate fi servită de un server aflat oriunde în lume - contează unde e deschis browserul, nu unde stă serverul.

Lăsat gol, niciun site nu are voie. Nu pune niciodată *: ar însemna „orice site din internet, dacă cineva îl deschide pe calculatorul ăsta".

Dacă vrei ca un serviciu al tău să comande bonuri, nu ai nevoie de CORS - vezi Cum comanzi bonuri dintr-un serviciu aflat la distanță. Acolo nu se deschide nimic.

Ascultarea în rețea

Din fabrică, API-ul ascultă doar pe acest calculator (127.0.0.1): nimeni din rețea nu ajunge la el. Dacă bifezi „Ascultă și în rețea", devine accesibil celorlalte calculatoare din rețeaua ta - de care ai nevoie când programul de vânzări e pe altă stație.

Atenție la router. Dacă routerul redirecționează portul din internet către acest calculator, API-ul devine accesibil din afara rețelei. Verifică să nu existe o astfel de redirecționare; aplicația nu o poate vedea și nu o poate opri.

Cum te protejezi

  • Lasă API-ul pe local dacă programul de vânzări este pe același calculator. este cazul cel mai des întâlnit și cel mai sigur - nu se deschide nimic în rețea.
  • Pornește-l în rețea doar dacă ai nevoie, adică programul de vânzări este pe alt calculator. Atunci limitează accesul din firewallul Windows la adresele stațiilor tale și rulează într-un VLAN separat de orice alte mașini, procese, aplicații.
  • Nu trimite tokenul pe email sau pe chat și nu-l lăsa scris într-un fișier partajat. Dacă bănuiești că a fost compromis, generează altul din aplicație - cel vechi devine inutil pe loc. Va fi necesar să îl setezi și in clientul API.
  • Adresele permise (CORS) se completează doar dacă un site din browser trebuie să folosească API-ul. Lăsat gol, niciun site nu are voie. Nu pune * și, în general, evită orice wildcard.
  • Limitează ce poate face API-ul: în Setări alegi ce case poate folosi și ce metode sunt permise. Un integrator care are nevoie doar să tipărească nu are de ce să poată închide ziua.
  • Rețeaua magazinului: casa de marcat și calculatoarele nu au ce căuta pe aceeași rețea cu, dar fără a se limita la Wi-Fi-ul pentru clienți. Nu expune API-ul în rețele care ies in WAN, limiteaza la LAN.

Ce NU se poate face prin API

  • Nu se pot schimba setările API-ului însuși - pornire, ascultare în rețea, port, adrese permise. Cine intră prin API nu poate să-și lărgească singur accesul.
  • Nu se poate anula un bon fiscal deja tipărit. Nici prin API, nici altfel.
  • Nu se poate șterge evidența.

Preluarea bonurilor de pe un server (SFTP)

Când aplicația ia bonurile de pe un server, ea se conectează în afară - nu deschide niciun port la tine.

Cerințele de mai jos sunt pentru cine administrează serverul, nu pentru operatorul din magazin. Aplicația merge ea la server: ia bonurile de tipărit și, dacă ai configurat un folder de răspuns, urcă înapoi rezultatul. Legătura pleacă întotdeauna din magazin - la tine nu se deschide niciun port, iar nimeni din afară nu poate cere date de la aplicație.

  • Conectare cu cheie, nu cu parolă; parola rămâne doar pentru cazurile în care serverul nu acceptă chei.
  • Cont dedicat, limitat la folderul cu bonuri - nu un cont care vede tot serverul.
  • Actualizări de securitate la zi, pe amândouă capetele.
  • Protecție împotriva încercărilor repetate de conectare (de exemplu Fail2Ban) și autentificare în doi pași acolo unde se poate.
  • Rotește periodic cheile și verifică cine mai are acces.

Dezavantajele metodei

Calculatorul (stația) pe care este instalat Poleo Fiscal trebuie să fie pornită pentru a putea lucra în acest sistem, indiferent de locul din care se trimite la tipărire, acea stație având chiar nucleul sistemului.

Datele tale

Bonurile, sumele, articolele și jurnalul electronic rămân pe calculatorul tău. Către serverele noastre pleacă doar ce este scris în Acordul de licență (într-o enumerare care nu este limitativă ci exemplificativă: adresă IP, NUI-ul casei de marcat, CUI-ul fiscalizat pe casa de marcat, momentele interogărilor): datele de verificare a licenței și, dacă nu optezi altfel (aceasta fiind setarea implicită), erorile tehnice pentru depanare - niciodată bonuri sau date despre clienții tăi. Excepția o alegi tu: dacă trimiți Jurnalul Electronic pe email prin releul nostru, fișierele trec prin serverele noastre. Poți folosi în schimb serverul tău de email, din Setări.

Probleme frecvente

„Portul COM nu există în sistem"

Adaptorul USB a fost scos sau i-a fost schimbat numărul (COM1 a ajuns COM4). Aplicația caută singură casa pe porturile existente; poți forța cu Detectează automat.

„Portul este folosit de alt program"

Un singur program poate ține un port COM. Închide celălalt driver fiscal sau folosește butonul Eliberează portul din bandă.

Casa din rețea nu răspunde

Modulul de rețea al casei servește un singur client. Dacă alt program ține legătura, aplicația așteaptă degeaba. Închide celălalt program sau oprește-i serviciul. Chiar și Poleo Fiscal poate ține blocat un port TCP. Poleo Fiscal permite metodologia de lucru a conexiunii mai multor stații la aceeași casă TCP IP, dar nu recomandă această metodă pentru că în situația în care 2 comenzi ajung simultan la casă (nu este neapărat un caz rar pentru că poate să se întample și pentru comenzi transmise, către Poleo Fiscal, în momente diferite, dar ajunse simultan la o casă care a avut o sincopă în conectarea la rețea), acestea se pot unifica în procesul de tipărire și pot rezulta într-un bon fiscal anulat. Aici, cu riscurile conexe metodei, sistemul de tipărire prin API sau Multi print pot fi variante de lucru, dar varianta optimă este aceea a caselor de marcat individuale.

Bonul este tipărit cu altă formă de plată

Indicele vine din programul de vânzări și pleacă neatins la casă. Compară, cu informațiile disponibile ulterior apăsării butonului Citește, sloturile programate în aparat cu ce trimite programul.

Bon anulat, fără să fi cerut nimic

Casa a început tipărirea documentului, dar l-a refuzat pe parcursul acestui proces. Cauze tipice: cantități negative (stornarea nu se face așa), reduceri mai mari decât valoarea mărfii, o formă de plată care nu acoperă totalul, indici de TVA inexistenți, indici de încasare inexistenți.

Raport Z restant la ANAF

Aplicația verifică singură câte rapoarte Z n-au ajuns la ANAF și te avertizează. Metoda este dependentă de capacitățile hardware și software ale casei de marcat. Poți cere transmiterea din Operațiuni → Trimite acum la ANAF. Netransmiterea la timp se sancționează. Acest buton nu are forță superioară procedurii implicite a casei de marcat ci doar cere încercarea sau reîncercarea abordării acesteia.

Pe laptop, conexiunea pică periodic

Dezactivează „USB selective suspend" din opțiunile de alimentare: Windows adoarme adaptorul.

Setări - toate câmpurile

Setările sunt grupate în șase taburi. Atenție: în afară de „General” și „API”, toate celelalte configurează un aparat anume - se scriu pe seria (NUI) a casei alese în rândul de sub taburi. Cu două case în magazin, verifică întâi pe care lucrezi.

În total 78 de setări și acțiuni, în ordinea în care apar pe ecran.

Fără nicio casă adăugată, taburile care descriu un aparat sunt stinse.

Tabul „General"

General

SetareCe faceTipImplicit
Denumirea locului de muncăReținut pentru evidență și backup (nu se tipărește pe bon).câmp text-
Numărul caseiIdentificatorul casei de marcat (implicit 1) - reținut pentru evidențăcâmp textpornit
Deschide aplicația la pornirea WindowsPornește printre primele aplicații, ca bonurile trimise de programul de vânzări să nu se adune netipărite. Îți recomandăm să utilizezi această opțiune.comutatorpornit
Pornește direct în tray (ascuns) la startupCând pornește cu Windows, nu mai apare pe ecran - ajunge direct lângă ceascomutatoroprit
Minimizează în tray la închidereButonul de închidere ascunde fereastra în locul opririi programuluicomutatorpornit
Nu mai afișa mesajul „rulează în system tray”Mesajul care apare la închiderea ferestrei. Se bifează automat după 30 de afișări.comutatoroprit
Verifică actualizări la pornireLa deschidere, întreabă serverul dacă a apărut o versiune mai nouă. Nu descarcă și nu instalează nimic - doar te anunță.comutatorpornit
Aplică automat actualizareaCând există versiune nouă, o descarcă și o instalează fără să întrebe (recomandat)comutatoroprit
Versiune instalată: Verifică dacă există o versiune mai nouă disponibilăacțiune-
Trimite diagnosticul de eroare către producătorul programului (Poleo)Doar avertizări și erori tehnice, pentru suport - fără date de client. Local se păstrează întotdeauna un jurnal.acțiune-

Tabul „Bon & aspect"

Elementele de pe bon (logo / QR / text publicitar)

SetareCe faceTipImplicit
Codul QR de pe bonFără / QR cu datele bonului (seria casei · data · numărul) / QR promoțional
Opțiuni: Fără · QR cu datele bonului · QR promoțional
listăFără
Textul publicitar de pe bonRândurile tipărite în subsolul bonului (mulțumire, program de lucru).câmp text-
Nu tipări bonurile peste plafonul de 5.000 lei (numerar, cu CUI)Legea nr. 296/2023 plafonează la 5.000 lei încasarea în NUMERAR de la o persoană juridică - adică bonurile pe care apare CUI-ul clientului. Implicit doar avertizăm după tipărire: dreptul de a încasa este al comerciantului, nu al programului. Având activă această opțiune, bonul nu mai pleacă deloc spre casă și operatorul află de ce. Plata cu cardul nu intră sub plafon.comutatoroprit
Nu tipări bonurile peste plafonul de 10.000 lei (numerar, fără CUI)Același lucru pentru încasările în NUMERAR de la persoane fizice - bonurile fără CUI de client - unde plafonul legal este de 10.000 lei pe zi. Util acolo unde încasează mai mulți casieri și răspunderea rămâne a patronului.comutatoroprit
La reconectare, tipărește automat ce este în memorieHotărăște CÂND ies bonurile rămase în așteptare. Pornită, ies singure imediat ce casa revine. Oprită, rămân în memorie până apeși «Tipărește acum» în banda de sus - util dacă vrei să fii lângă casă când încep să iasă (hârtie, ordinea lor). Nu se pierde niciunul, în niciuna dintre variante.comutatorpornit
Oprește documentele trimise de două oriHotărăște CÂTE ies. Când casa este deconectată și nu iese nimic pe hârtie, operatorii dau același bon la tipărit de mai multe ori - iar la revenire ar ieși de tot atâtea ori, fiecare cu numărul lui fiscal. Având activă această opțiune, al doilea document identic este refuzat cât timp primul este în coadă, deci iese unul singur. Implicit oprită: două vânzări identice la rând sunt normale într-un magazin, iar noi nu avem de unde ști care este care.comutatoroprit
Deschide sertarul la fiecare operațiune pe casăDupă fiecare bon, raport tipărit, depunere sau retragere de numerar, sertarul se deschide singur. Excepții: rapoartele electronice. Implicit oprită: un sertar care se deschide singur, într-un magazin cu vad, este o ușă lăsată deschisă. Cere un sertar legat la casă.comutatoroprit
Scoate diacriticele de pe bonMulte case de marcat nu au Ă, Â, Î, Ș, Ț în memoria lor de caractere și le tipăresc ca semne străine sau ca pătrățele goale. Având activă această opțiune, textul pleacă fără diacritice - «BRANZA» - și iese la fel pe orice casă. Oprește-o doar dacă ai verificat că această casă chiar le tipărește corect.comutatorpornit
Totalul scris mai mareRândul de TOTAL va fi tipărit cu font mai mare, pe casele care suportă această opțiunecomutatorpornit
Intensitatea printuluiContrastul capului termic: 0 = deschis → 20 = închis. Peste 16 textul tipărit este negru închis, dar tipărirea devine vizibil mai lentă și solicită și uzează capul termic într-un ritm accentuat. Ai totuși avantajul unui text clar și vizibil mai mult timp pe hartia fotosensibilă.acțiune-

Tabul „Rapoarte & email"

Rapoartele automate

SetareCe faceTipImplicit
Raport Z automatÎnchide ziua fiscală automat la ora stabilităcomutatoroprit
Ora la care se emite Raportul ZAlege ora (HH:MM) - se validează singură.oră23:55
Pragul de rapoarte Z netrimise la ANAFAvertizează când se adună mai multe rapoarte Z netrimise decât atât (0 = oprit).câmp text5
Trimite alerta pe emailCând depășește pragul, trimite un email (cel mult o dată pe zi)comutatoroprit
DestinatarulAdministratorul firmei (gol = adresa din secțiunea de email)câmp text-
CC furnizor case de marcatCopie către furnizorul/service-ul casei de marcatcâmp text-
Trimite raportul zileiUn email cu declarațiile de bon greșit și retururile zilei. Zi fără nimic de raportat = niciun email.comutatorpornit
Adresa contabilității (pentru declarațiile privind bonurile întocmite greșit)Unde pleacă raportul (gol = adresele de alertă de mai sus). Poți pune mai multe, despărțite prin virgulă.câmp text-
Ora la care pleacă raportulSe trimite DIMINEAȚA, pentru ziua trecută - așa prinde și magazinele care lucrează până la miezul nopții.oră08:30

Rapoartele trimise pe email (Z zilnic și Jurnal Electronic)

SetareCe faceTipImplicit
Trimite rapoarte pe emailRaportul Z zilnic este trimis automatcomutatoroprit
Adresa destinataruluiUnde se trimit rapoartele și Jurnalul Electronic.câmp text-
Ora la care pleacăFormat HH:MM.câmp text23:59
Trimite Jurnalul Electronic pe emailFișierele JE (.p7b) semnate de casă, trimise automat ca ZIPcomutatoroprit
Cât de des se trimiteRitmul în care pleacă Jurnalul Electronic.
Opțiuni: Zilnic · Săptămânal · Lunar
listă-
Ziua din lună (doar la trimiterea lunară)În ce zi se trimite Jurnalul lunii trecute (1-28).câmp textpornit

Pe unde pleacă emailurile

SetareCe faceTipImplicit
Calea de trimitere«Prin Poleo» - mesajul este predat serverului nostru, care îl trimite mai departe; pe calculatorul tău nu se păstrează nicio parolă. «Contul meu» - pleacă direct din serverul tău de email, cu adresa firmei tale ca expeditor.
Opțiuni: Prin Poleo · Contul meu
listă-
Subiectul mesajelorCum se numesc emailurile trimise de aplicație, ca să le găsească ușor contabilul. Lasă gol și îl scriem noi, cu perioada și numele casei. Poți folosi {perioada} și {casa} - le înlocuim la trimitere. Numele expeditorului rămâne «Poleo Fiscal».câmp text-

Tabul „Numerar & POS"

Numerarul

SetareCe faceTipImplicit
Plafonul de numerar din sertarAvertizare când numerarul se apropie de plafonul de casă de 50.000 lei (Legea nr. 296/2023). Implicit 45.000, ca să te prindă din timp.câmp text45000
Anunță-mă când sertarul rămâne fără măruntAvertizarea apare când soldul scade sub pragul de mai jos.comutatorpornit
Pragul de la care se cere alimentareaSub valoarea asta, programul cere alimentarea sertarului cu mărunt.câmp text200
Fondul de rulaj (banii de sertar)Se precompletează la «Depune fondul de rulaj» (poți schimba valoarea).câmp text200

Terminalele de card (POS bancar)

SetareCe faceTipImplicit
Folosește terminalul de cardPlățile cu cardul pleacă din programul de vânzări către terminal.comutatoroprit
Către ce terminal merge plata cu cardul«După casă» = terminalul alocat casei care tipărește bonul (cel de lângă ea). «Întreabă» = alegi tu la fiecare tranzacție. «Mereu la unul» = toate încasările pe același terminal (util când vrei comisionul unei anume bănci). Cu un singur terminal, nu contează.
Opțiuni: După casa care tipărește · Întreabă la fiecare plată · Mereu la un anumit terminal
listăDupă casa care tipărește
Terminalul folosit de fiecare datăToate încasările cu cardul merg la terminalul ăsta.acțiune-
TerminalePoți adăuga oricâte - câte unul pentru fiecare casă, dacă este cazulacțiune-

Tabul „Firmă & backup"

Datele firmei (pentru declarații)

Secțiunea conține o scurtătură, nu setări - vezi descrierea paginii.

Backupul Jurnalului Electronic (JE)

SetareCe faceTipImplicit
Copia automată a Jurnalului (implicit)Salvează pe disc rapoartele JE (.p7b, semnate de casă), după emiterea raportului Z. Fișierele NU se arhivează (o arhivă coruptă ar pierde tot) - se păstrează ca atare, un folder pentru fiecare casă. O zi ratată (calculator oprit) se recuperează automat a doua zi.comutatorpornit
Recurență (implicit)Cât de des se face backup-ul pe o casă nouă
Opțiuni: În fiecare luni · În fiecare zi · Lunar (pe 1)
listă-
Păstrare (implicit)Cât timp rămân fișierele pe discul tău
Opțiuni: Fără limită · 1 an · 2 ani · 5 ani
listă-

Backupul și restaurarea Poleo

SetareCe faceTipImplicit
Folderul pentru copii de siguranțăUnde se salvează arhivele (cale declarată)acțiune-
Copia automată a rapoartelor JESalvează periodic Jurnalul Electronic + baza la calea de mai suscomutatorpornit
Cât de desCât de des rulează backup-ul automat
Opțiuni: Zilnic · Săptămânal · Lunar
listă-
Golește bază de dateȘterge tot istoricul (bonuri, rapoarte, numerar, coadă). Face automat un backup întâi. Casele și setările rămân.acțiune-

Siguranța bazei de date

SetareCe faceTipImplicit
Oglindă permanentăȚine o a doua bază, la zi, și pornește automat din ea dacă prima se stricăcomutatorpornit
Unde stă oglindaGol = lângă datele aplicației. Ideal pe ALT DISC: o defecțiune de disc nu ia și copiaacțiune-
Instantanee zilniceCâte zile în urmă poți reveni dacă se șterg date din greșeală
Opțiuni: 7 zile · 14 zile · 30 zile
listă14 zile
Efort pe discCât de des se rescrie copia completă. Pe un calculator slab, alege «redus»
Opțiuni: Redus · Normal · Frecvent
listăNormal
Sigiliu (anti-modificare)Semnează fiecare bon, raport și operațiune de numerar. Dacă cineva umblă în bază pe lângă aplicație, se vedecomutatorpornit
StareRecalculează semnăturile și compară-le cu ce este acum în bazăacțiune-

Tabul „API"

API HTTP

SetareCe faceTipImplicit
Pornește API-ul HTTPPermite altui program - un ERP, un magazin online, o aplicație de comenzi - să tipărească bonuri și să citească evidența, printr-o cerere HTTP. Fără el, singura cale rămâne folderul monitorizat. Pornirea are efect imediat.comutatoroprit
Ascultă și în rețeaImplicit, API-ul răspunde DOAR programelor de pe calculatorul ăsta (127.0.0.1). Pornește opțiunea doar dacă programul care comandă casa rulează pe alt calculator - de exemplu un server de comenzi. Atunci oricine ajunge la rețeaua ta poate încerca să tipărească, iar singura apărare rămâne tokenul.comutatoroprit
PortulImplicit 9111, lângă cel de printare în rețea (9110). Schimbă-l doar dacă este ocupat de alt program.câmp text-

Tokenul de acces

SetareCe faceTipImplicit
Tokenul acestei stațiiSe trimite la fiecare cerere, în antetul «Authorization: Bearer <token>». Cine îl are poate tipări bonuri FISCALE pe casa ta - tratează-l ca pe o cheie, nu-l pune în pagina unui site și nu-l trimite pe email.acțiune-

Amprenta stației

SetareCe faceTipImplicit
Numele sub care te cunosc parteneriiO dai serviciului din afara rețelei (site, ERP) ca să înregistreze stația la el. Nu are legătură cu licența și nu se schimbă singură - nici la actualizare, nici dacă schimbi portul, IP-ul sau casa. Se rotește doar la cerere sau la reinstalarea sistemului, iar în cazul modificării sale, atât platforma cu care Poleo «vorbește» cât și acea platformă trebuie să aprobe conexiunea (similar cu setarea inițială).acțiune-

Legăturile cu servicii din afară

SetareCe faceTipImplicit
Programe din altă rețeaUn site sau un ERP din cloud nu ajunge la casa ta - stația este cea care iese și întreabă serviciul aprobat ce are de făcut. Aici îi dai adresa lui (https), cheia, ce are voie să facă și pe ce case. Nimic nu curge înainte de aprobarea ta, iar oprirea are efect imediat.acțiune-

Casele pe care le poate folosi API-ul

SetareCe faceTipImplicit
Alege caseleNebifate toate = API-ul le poate folosi pe toate. Legătura se face pe seria casei, deci rămâne corectă chiar dacă se încurcă fișele.acțiune-

Ce poate face API-ul

SetareCe faceTipImplicit
Metodele acestei versiuniAceeași listă o poate cere și programul care se integrează, la /api//methods, ca să știe din cod ce știe stația. Manualul complet, cu exemple și răspunsuri, este în docs/api din instalare.acțiune-

Preluarea bonurilor de pe server (SFTP)

SetareCe faceTipImplicit
Ia bonurile de pe un server SFTPPentru programele care nu sunt în rețeaua magazinului. Fișierele coboară în folderul monitorizat al casei, deci trec prin exact aceleași verificări ca cele locale. Dinadins SFTP, nu FTP: FTP trimite parola în clar.comutatoroprit
Serveradresa serverului SFTPcâmp text-
Portimplicit 22câmp text22
Utilizatorcontul de pe servercâmp text-
Cheie privată (recomandat)Calea către fișierul cheii private, de pe CALCULATORUL ĂSTA - apasă «Alege…» ca să nu o scrii de mână. Cu cheie nu mai este nevoie de parolă, deci nu mai stă nicio parolă pe calculator.acțiune-
Parolă (dacă nu folosești cheie)Parola se păstrează pe CALCULATORUL ĂSTA, cifrată și legată de contul tău de Windows - nu se mai vede în clar după ce ai scris-o. Cifrarea nu înlocuiește însă grija: cine intră pe calculator cu contul tău o poate folosi, deci asigură-te că nu are acces cineva neautorizat la stație. Dacă poți, folosește cheia privată de mai sus în locul parolei.câmp text-
Folderul cu bonuriScrie calea COMPLETĂ de pe server (ex. /home/utilizator/bonuri). Căile relative nu funcționează. Asigură-te că utilizatorul de SFTP are drept de CITIRE în folderul acela - de scris nu avem nevoie, fiindcă rezultatul tipăririi îl comunicăm prin API.câmp text/bonuri
Folderul de răspuns (opțional)Dacă îl completezi, urcăm înapoi în el rezultatul fiecărui fișier. Nu este necesar - rezultatul tipăririi îl poți lua oricând prin API, iar așa nu-i mai ceri utilizatorului de SFTP drept de scriere. Tot cale completă.câmp text-
Șterge fișierul după ce l-am luatDacă este oprit, fișierele rămân pe server - atunci dă un folder de arhivă mai jos.comutatorpornit
Folder de arhivă (dacă nu ștergem)Unde mutăm fișierele după ce le-am luat. Tot cale COMPLETĂ de pe server (ex. /home/utilizator/bonuri/preluate) - căile relative nu funcționează. Aici utilizatorul de SFTP are nevoie și de drept de SCRIERE, fiindcă mutăm fișiere în el.câmp text-
Cât de des verificămsecunde între două verificări (minimum 5)câmp text20

Site-urile cu acces din browser

SetareCe faceTipImplicit
Adresele permise (CORS)Doar dacă un SITE cheamă API-ul direct din browserul casierului. Scrie adresele exacte, separate prin virgulă (ex. https://magazinul-meu.ro). Lasă gol dacă programul care comandă casa rulează pe un server - acolo nu este nevoie de nimic.câmp text-