Glosar

O singură referință A→Z pentru acronimele fiscale românești și pentru termenii specifici platformei e-bon care apar în această documentație. Dacă ai întâlnit un cuvânt pe altă pagină și nu ești sigur ce înseamnă, aici este locul potrivit să te uiți.

Intrările sunt în ordine alfabetică românească. Fiecare intrare conține un paragraf de definiție în limbaj clar, urmat de o linie Unde apare cu trimiteri către paginile relevante și (pentru termenii legali) o linie Sursă care indică ANAF.

A

AMEF (casă de marcat)

AMEF este aparat de marcat electronic fiscal — denumirea oficială a casei de marcat. În vorbirea curentă același dispozitiv se numește pur și simplu casă de marcat. Orice afacere din România care vinde către consumatori trebuie să folosească un AMEF certificat de Ministerul Finanțelor pentru a emite bonuri fiscale. e-bon gestionează AMEF-urile la distanță din cloud — fiecare casă conectată prin Controller devine accesibilă din portal și din API.

Unde apare: Ce este e-bon?, Casele de marcat.

ANAF

ANAF — Agenția Națională de Administrare Fiscală — este autoritatea fiscală din România. Fiecare raport fiscal generat de e-bon (raport Z, JE, MF, F4109) ajunge până la urmă la ANAF, fie prin conexiunea online MF↔ANAF a casei, fie depus manual de patron prin SPV.

Unde apare: Conformitate, Rapoarte. Sursă: anaf.ro.

Antet și subsol (header și footer)

Primele și ultimele rânduri tipărite pe orice bon fiscal. Antetul conține de obicei numele firmei, adresa și CUI-ul; subsolul conține de obicei un mesaj de mulțumire, informații de fidelitate sau un site web. Ambele sunt configurabile per dispozitiv prin e-bon — modifici rândurile din portal fără să te deplasezi la locație. Antetul și subsolul se reformatează și atunci când încarci un logo nou.

Unde apare: Casele de marcat — comenzi antet și subsol.

B

Bon fiscal

Un bon fiscal este dovada legală că o vânzare a fost înregistrată pe AMEF și înscrisă în memoria fiscală a casei. Bonul conține seria fiscală a casei, numărul bonului, operatorul, articolele cu departamentele lor de TVA, totalurile per cotă de TVA și defalcarea pe metode de plată. e-bon stochează fiecare bon fiscal emis de oricare dintre casele tale și îl expune prin portal și prin API-ul /receipts.

Unde apare: Bonuri, Portal — Bonuri.

Bon nefiscal

Un bon nefiscal este o tipărire fără valoare fiscală — de exemplu un duplicat, un pre-bon, o tipărire de test pentru logo sau un bon de service. Arată ca un bon, dar nu se înscrie în memoria fiscală și nu poate fi folosit ca dovadă a vânzării. e-bon trimite tipăririle nefiscale prin aceeași infrastructură de comenzi ca pe cele fiscale, dar le marchează separat în portal.

Unde apare: Casele de marcat — operațiuni.

Bon storno

Vezi Storno.

C

Cheie API (ebon_live_<orgId>_<hex>)

Orice cheie API e-bon are o formă fixă: ebon_live_<orgId>_<hex>. Prefixul ebon_live_ o marchează drept credențial de producție, segmentul <orgId> o leagă de o singură organizație (astfel încât o cheie compromisă nu poate trece niciodată dincolo de marginea organizației), iar coada <hex> are 32 de caractere hexazecimale aleatoare. Pe server se păstrează doar hash-ul cheii; valoarea brută îți este afișată o singură dată, la creare.

Unde apare: Chei API, Autentificare.

Comandă fiscală (command envelope)

Forma standard a oricărei comenzi pe care e-bon o trimite către o casă de marcat. Fiecare comandă conține un type stabil (de exemplu print_receipt, x_report, set_header), un payload idempotent și metadate de ciclu de viață (status, result). Plicul comenzii este ceea ce permite reluarea comenzii, punerea ei în așteptare cât timp dispozitivul este offline, auditul ulterior din portal și expunerea prin webhook.

Unde apare: Comenzi, Arhitectură — pipeline-ul de comenzi.

Controller (aplicația E-BON Android)

Aplicația Android care stă lângă fiecare casă de marcat și o conectează la cloud-ul e-bon. Comunică cu imprimanta fiscală prin Bluetooth, USB, Serial sau TCP, iar cu portalul prin HTTPS. În documentație îi spunem Controller (sau, simplu, aplicația E-BON) ca să-l deosebim de imprimanta în sine — imprimanta este AMEF-ul, Controller-ul este dispozitivul Android care îl pilotează.

Unde apare: Aplicația E-BON, Casele de marcat — împerechere.

D

Departament

Fiecare articol de pe un bon fiscal este atribuit unui departament — o căsuță numerică de TVA pe AMEF (de obicei 1–8, în funcție de model). Departamentul îi spune casei ce cotă de TVA să aplice articolului și este nivelul la care raportul Z face totalurile la închiderea zilei fiscale. În e-bon departamentul este parte din fiecare articol de bon trimis prin API.

Unde apare: Bonuri.

F

F4109

Declarația F4109 — "Declarație privind AMEF neutilizate" — este declarația ANAF care trebuie depusă ori de câte ori un AMEF emite zero bonuri fiscale într-o lună calendaristică. Se depune per dispozitiv și per lună, până la data de 20 a lunii următoare, electronic prin SPV. Conexiunea online MF↔ANAF nu a abrogat această obligație.

Unde apare: F4109 — Declarația de inactivitate ANAF. Sursă: OPANAF 627/2018, anaf.ro.

I

Idempotency-Key (cheie de idempotență)

Antetul HTTP care face ca reîncercările din POS să fie sigure. Când rețeaua pică la mijlocul unei cereri și integratorul reîncearcă, a doua cerere (și a treia, și a douăzecea) trimite aceeași valoare Idempotency-Key ca prima. e-bon păstrează în cache răspunsul original per organizație și îl reia pe durata ferestrei TTL, astfel încât o reîncercare nu provoacă niciodată tipărirea unui al doilea bon și nu declanșează un al doilea webhook.

Unde apare: Idempotență, Bonuri, Comenzi.

J

Jurnal Electronic (JE)

Jurnalul Electronic este jurnalul XML cumulativ, ordonat cronologic și formatat conform ANAF, care înregistrează fiecare eveniment fiscal produs de o casă pe o perioadă de raportare. Este însoțitorul detaliat al memoriei fiscale: MF stochează totalurile zilnice agregate, JE stochează cronologia care stă la baza acestora. e-bon generează XML-ul JE la cerere, per dispozitiv și per perioadă, prin endpointul /reports/je și păstrează raportul rezultat semnat P7B pentru audit.

Unde apare: Rapoarte — JE.

M

Memorie Fiscală (MF)

Memoria Fiscală este zona protejată anti-modificare de pe AMEF în care se înscriu totalurile fiecărui raport Z care închide o zi fiscală. Este sursa de adevăr a casei și baza pentru controalele ANAF. e-bon exportă rapoartele MF prin endpointurile /reports/mf și le afișează în portal împreună cu data arhivării.

Unde apare: Rapoarte — MF.

N

Numerar — depunere, ridicare, sold (cash in / cash out / sold numerar)

Mișcările sertarului de numerar gestionate de operator: depunere numerar este intrarea de cash (de exemplu fondul de schimb la deschidere), ridicare numerar este scoaterea de cash (de exemplu colectarea de la închidere), iar soldul de numerar este balanța curentă pe care casa o crede în sertar. Toate trei sunt urmărite per dispozitiv prin portalul e-bon și se traduc direct în comenzile de gestiune numerar ale AMEF-ului.

Unde apare: Casele de marcat — gestiune numerar.

O

Operator

O identitate de utilizator pe AMEF — de obicei un casier sau un ospătar. Operatorul se autentifică pe casă cu un ID de operator și (opțional) o parolă înainte să emită bonuri; fiecare bon fiscal este apoi marcat cu acel operator. e-bon administrează operatorii per dispozitiv din portal: poți adăuga, înlocui sau scoate operatori la distanță și ulterior poți filtra bonurile și rapoartele după operator.

Unde apare: Casele de marcat — operatori.

P

P7B

P7B este formatul folosit pentru semnăturile digitale detașate, conforme ANAF (PKCS #7 / CMS, codificat DER). Când e-bon generează un raport XML JE pentru e-Reporting-ul ANAF, plicul semnat este stocat alături ca blob P7B — el este cel care dovedește că XML-ul nu a fost modificat după depunere.

Unde apare: Rapoarte — JE.

Plic de eroare

Numele intern al e-bon pentru forma JSON consistentă pe care o ia orice răspuns de eroare al API-ului: { "error": { "code": "...", "message": "...", "details": ... } }. Cuvântul plic surprinde ideea — orice eroare este împachetată în același plic exterior, astfel încât integratorii au de scris un singur parser de erori.

Unde apare: Erori.

R

Raport X

Un raport X este o instantanee read-only, la mijlocul zilei, a totalurilor curente ale unei case: vânzări, retururi, defalcare TVA și număr de bonuri de la ultimul raport Z încoace. Emiterea unui raport X nu închide ziua fiscală, nu resetează contoarele zilnice și nu scrie în memoria fiscală. Este raportul potrivit când vrei o privire rapidă asupra zilei în desfășurare.

Unde apare: Rapoarte — X.

Raport Z

Un raport Z închide ziua fiscală. Îngheață totalurile zilei, le scrie în memoria fiscală, resetează contoarele zilnice și incrementează contorul de resetări al casei. Raportul Z este închiderea fiscală zilnică — nu este opțional. Fiecare zi de funcționare a unei case trebuie să se încheie cu un raport Z. e-bon poate declanșa un Z la distanță și stochează fiecare Z observat.

Unde apare: Rapoarte — Z.

S

SPV (Spațiul Privat Virtual)

Spațiul Privat Virtual este portalul online securizat al ANAF, la anaf.ro, prin care contribuabilii români depun declarații, primesc corespondență și consultă evidența fiscală. SPV este locul în care depui F4109 și de unde recuperezi artefactele de semnătură electronică calificată ale reprezentantului legal. e-bon nu depune direct în SPV — patronul depune, cu documentele pe care e-bon ajută să le pregătească.

Unde apare: F4109 — Declarația de inactivitate ANAF. Sursă: anaf.ro.

Storno

Storno este o stornare fiscală — un bon care anulează o vânzare anterioară (eroare operator, retur, reducere a bazei impozabile). Bonul de storno este el însuși un bon fiscal: se înscrie în memoria fiscală, apare în raportul Z și trebuie să facă referire la vânzarea originală prin USN și prin numărul bonului original. Stornarea este singurul mod legal de a anula un bon fiscal anterior — pur și simplu nu se poate șterge unul.

Unde apare: Bonuri — bon de retur, Casele de marcat — operațiuni.

T

TVA

TVA — Taxa pe Valoarea Adăugată — este taxa românească pe valoarea adăugată. Fiecare articol de pe un bon fiscal stă într-un departament cu o cotă de TVA configurată (de obicei 19%, 9%, 5% sau 0%). Atât raportul Z cât și JE-ul defalcă vânzările zilei pe cote de TVA; ANAF reconciliază aceste defalcări cu ce declară firma.

Unde apare: Bonuri, Rapoarte.

U

USN (număr unic de vânzare)

USN — număr unic de vânzare — este identificatorul care leagă un storno de vânzarea originală. La emiterea unui bon de retur trimiți USN-ul bonului original pentru ca atât casa de marcat cât și ANAF-ul să poată corela cele două bonuri. În e-bon USN-ul circulă pe payload-urile de comandă ca uniqueSaleNumber.

Unde apare: Bonuri — bon de retur, Comenzi — payload de stornare.

W

Webhook — tipuri de evenimente

Lista de evenimente fiscale pe care e-bon le livrează ca webhook-uri ieșite (receipt.created, command.completed, device.offline etc.). Fiecare eveniment are un nume stabil, un payload documentat și un contract garantat de livrare (semnat, reluat, replayable). Când se întâmplă ceva interesant pe una dintre casele tale, prin webhook află sistemul tău, fără polling.

Unde apare: Tipuri de evenimente webhook, Webhook-uri.