Documentație API FiscalNET.
HTTP, fișiere și Android.

Alege metoda de integrare.

Un singur mod de apelare. Windows și Android.

Webserverul integrat primește cereri POST la http://localhost:65400/api/Receipt. Corpul cererii poate fi o listă JSON de șiruri, fiecare șir reprezentând o comandă. În Postman alege POST, Body → raw → JSON și antetul Content-Type: application/json.

Pe Windows rămâne disponibil și fluxul prin fișiere depuse în folderul Bonuri. Comanda către POS-ul bancar prin API este disponibilă numai pe Windows.

Aplicații web: verifică și regulile browserului

O pagină HTTPS și un serviciu local HTTP pot întâlni restricții de securitate ale browserului. Configurează originea permisă și răspunsul CORS/OPTIONS, iar când instalarea oferă HTTPS local folosește adresa și certificatul configurate pentru acea versiune. Nu presupune că simpla înlocuire a IP-ului rezolvă aceste cerințe; nu dezactiva protecțiile browserului.

[
  "CF^RO 123456789",
  "S^ARTICOL DE STORNAT^600^1000^buc^1^1",
  "VS^ARTICOL STORNO^600^1000^buc^1^1",
  "S^ARTICOL 1^500^1000^buc^1^1",
  "DP^1000",
  "S^ARTICOL 2^500^1000^buc^1^1",
  "DV^100",
  "S^ARTICOL 3^415^1000^buc^1^1",
  "MP^500",
  "S^ARTICOL 4^315^1000^buc^1^1",
  "MV^50",
  "ST^",
  "DP^500",
  "CB^5940000000820^2",
  "TL^Rand text liber 1",
  "TL^Alt rand text liber",
  "P^2^1000",
  "P^1^2000"
]

Precizări de integrare: echipa FiscalNET, 19 octombrie 2026. Exemplele din PDF folosesc și scrierea /api/receipt; adresa de mai sus reproduce forma comunicată integratorilor. Verifică ruta și configurația versiunii instalate.

API HTTP comun pentru Windows și Android.

Baza locală din ghid: http://localhost:65400. Folosește adresa și portul configurate în instanța ta. Nu expune serviciul local direct pe internet.

curl.exe http://localhost:65400/api/health

Pentru executarea comenzilor, ghidul acceptă text multilinie sau o listă JSON de linii. Exemplu de interogare a stării:

curl.exe -X POST "http://localhost:65400/api/receipt" -H "Content-Type: text/plain" --data-binary "STATUS"

Fișiere Windows: un flux ușor de urmărit.

1. Construiește fișierul

   Folosește .txt, .inp sau .json, cu sintaxa corespunzătoare din ghid.

2. Trimite comanda

   Depune fișierul complet în folderul Bonuri sau în folderul dispozitivului configurat.

3. Citește rezultatul

   După prelucrare, comanda ajunge în Istoric, iar rezultatul se citește din Raspuns.

4. Păstrează perechea

   Arhivează împreună comanda și răspunsul pentru diagnostic și trasabilitate.

Referința comenzilor în format text.

În formatul text simplu, fiecare linie reprezintă o instrucțiune. Separatorul câmpurilor este ^. În notația de mai jos, acoladele indică valori de înlocuit, iar ? marchează un parametru opțional; aceste semne nu fac parte din valoarea trimisă.

Sintaxa completă și exemplele din PDF · paginile 5–8

Android Intent: aplicații pe același dispozitiv.

Pachetul tehnic rămâne com.econmedia.fiscalnet; acesta este identificatorul aplicației, nu denumirea societății.

Extra-urile de rezultat folosesc prefixul com.econmedia.fiscalnet.result.: SUCCESS, RESPONSE_JSON, HTTP_STATUS_CODE, RECEIPT_STATUS, RECEIPT_NUMBER, RECEIPT_INFO, ERROR_CODE și ERROR_INFO. Păstrează identificatorii exact cum apar în ghid.

Exemple Kotlin și rezultatele Android · pagina 13

INP: păstrează compatibilitatea, verifică semnificația.

INP este un format de comandă pentru integrări existente. Folosește virgula și punctul și virgula ca separatori, sume și cantități zecimale și același număr logic, între 1 și 99, pe toate liniile documentului. Ordinea liniilor stabilește contextul.

Nu converti o comandă între text simplu și INP doar prin înlocuirea separatorilor. Codurile de plată, reprezentarea sumelor și unele litere de comandă au semnificații diferite. Consultă structura completă a liniilor INP în PDF, paginile 8–10.

Plăți POS: verifică operația reală.

Pentru integrarea cu POS bancar, verifică licența PLUS, terminalul configurat și ID-ul POS când există mai multe terminale. Confirmă metoda de conectare pentru terminalul și platforma folosite.

Regulile speciale pentru comanda POS · pagina 14

Detalii de integrare FiscalNET PLUS cu POS bancar

Interpretează rezultatul, nu doar transportul.

Depanare: pornește de la simptom.

Vezi și întrebările frecvente despre instalare, licențe și suport

Înainte de utilizarea în producție.

1. Identifică dispozitivul

   Dacă sunt mai multe aparate, transmite explicit ID-ul dispozitivului fiscal. Pentru o plată bancară, transmite și ID-ul POS-ului atunci când este disponibil și verifică licența PLUS și terminalul configurat.

2. Testează răspunsurile

   Acoperă succes, dispozitiv indisponibil, hârtie lipsă și erori de comandă, într-un mediu controlat.

3. Separă plata de confirmare

   Nu presupune că un timeout înseamnă eșec. Verifică operația înainte de retrimitere.

4. Documentează integrarea

   Păstrează versiunile, setările și exemplele de comandă/răspuns, fără date de card sau alte informații sensibile.

Surse: ghidul general pentru integratori, ediția 30 aprilie 2026 (15 pagini), precizările echipei FiscalNET din 19 octombrie 2026 privind apelarea Windows/Android și browserul local și confirmarea din 3 noiembrie 2026 privind integrarea POS bancar pe Android.

Exemple și referințe pentru integrări existente

Pentru o integrare nouă, pornește de la ghidul general 2026 și referința comenzilor de mai sus. Materialele din 2024 sunt păstrate ca referință pentru integrările existente.