Documentație API

FiscalLink expune un API REST local pentru controlul imprimantei fiscale, tipărirea bonurilor și integrarea cu Shopify sau cu aplicații POS proprii.

URL-uri de bază

API-ul este servit local de aplicația FiscalLink, iar toate endpoint-urile sunt prefixate cu /api. Porturile implicite: 65401 (HTTPS), 65400 (HTTP).

Mediu	Adresă	Utilizare
Securizat (HTTPS)	`https://localhost.fiscallink.ro:65401/api`	Recomandat pentru integrare normală
Local (HTTP)	`http://{ip-local}:65400/api`	Util în rețeaua locală, fără TLS

Format răspuns (API standard)

Majoritatea endpoint-urilor returnează un format standard:

Succes

{
  "StatusCode": 200,
  "Data": "<payload>"
}

Eroare

{
  "StatusCode": 400,
  "Message": "Descrierea erorii"
}

Excepție: Controller-ul Legacy (POST /Receipt) folosește un format diferit — vezi secțiunea dedicată.

Coduri HTTP frecvente

200 — Cererea a fost procesată cu succes.
400 — Parametri invalizi, date lipsă sau validare respinsă de dispozitiv.
404 — Resursa nu a fost găsită (ex: comandă Shopify inexistentă).
424 — Dispozitivul nu răspunde sau nu este conectat.
500 — Eroare internă neașteptată.

Compatibilitate FiscalNet și Fisco

FiscalLink este compatibil cu API-urile FiscalNet și Fisco. Dacă aplicația ta folosește deja una dintre aceste integrări, poți migra fără schimbări majore de cod.

FiscalNet

Documentație FiscalNet →

Fisco

Documentație Fisco →

Comportamentul dispozitivului diferă între DATECS, Daisy și Tremol. Vezi diferențele dintre tipurile de case de marcat.

Network Controller

Returnează adresele API la runtime. Util când integrarea trebuie să descopere unde ascultă FiscalLink.

GET

/get-secure-api-address

Obține adresa API securizată

Returnează adresa HTTPS completă a API-ului FiscalLink (inclusiv /api).

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "https://localhost.fiscallink.ro:65401/api"
}

Eroare

{
  "StatusCode": 500,
  "Message": "Eroare internă"
}

GET

/get-local-api-address

Obține adresa API locală

Returnează adresa HTTP completă a API-ului din rețeaua locală (inclusiv /api).

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "http://192.168.1.100:65400/api"
}

Eroare

{
  "StatusCode": 500,
  "Message": "Eroare internă"
}

Device Communication — Bon nefiscal

Flux: deschide bon → tipărește text/elemente → închide sau anulează.

POST

/open-non-fiscal-receipt

Deschide un bon nefiscal

Deschide un bon nefiscal. După deschidere folosește print-non-fiscal-text pentru conținut, apoi close-non-fiscal-receipt sau cancel-non-fiscal-receipt.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Eroare

{
  "StatusCode": 424,
  "Message": "Dispozitivul nu răspunde"
}

Observații

• Nu necesită corp de cerere pe DATECS/Daisy.
• Pe Tremol sunt obligatorii OperatorCode și OperatorPassword (max 4 caractere, padded/truncate).
• Trebuie să existe un bon nefiscal deschis pentru print/close/cancel.

POST

/print-non-fiscal-text

Tipărește text pe bon nefiscal

Tipărește o linie de text pe bonul nefiscal deschis. DATECS folosește toate opțiunile de formatare; Daisy și Tremol folosesc doar message.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
Message	String	Da	Text de tipărit
Bold	Bool?	Nu	Text îngroșat (DATECS)
Italic	Bool?	Nu	Text italic (DATECS)
Height	Int?	Nu	0=Normal, 1=Dublu, 2=Jumătate (DATECS)
Underline	Bool?	Nu	Subliniat (DATECS)
Alignment	Int?	Nu	0=Stânga, 1=Centru, 2=Dreapta (DATECS)

Minimal (Daisy / Tremol-compatibil)

{
  "Message": "Text exemplu"
}

Complet (DATECS)

{
  "Message": "Text formatat",
  "Bold": true,
  "Italic": false,
  "Height": 0,
  "Underline": true,
  "Alignment": 1
}

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• alignment: 0=stânga, 1=centru, 2=dreapta.

POST

/close-non-fiscal-receipt

Închide bonul nefiscal

Închide bonul nefiscal deschis și finalizează tipărirea.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• Nu necesită corp de cerere.

POST

/cancel-non-fiscal-receipt

Anulează bonul nefiscal

Anulează bonul nefiscal deschis fără a-l finaliza.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• Nu necesită corp de cerere.

Device Communication — Bon fiscal

Flux: deschide bon → înregistrează vânzări → subtotal → plată → închide. Vezi diferențele DATECS vs Daisy vs Tremol.

POST

/open-fiscal-receipt

Deschide un bon fiscal

Deschide un bon fiscal sau factură. Pe DATECS și Tremol, invoice=true deschide factură (pe Tremol câmpul este folosit ca FiscalRcpPrintType); pe Daisy câmpul invoice este ignorat. Pe Tremol, OperatorPassword este truncat/padded la exact 4 caractere.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
OperatorCode	Int	Da	1–30
OperatorPassword	String	Da	Parola operatorului
PointOfSaleNumber	Int	Da	1–99999
Invoice	Bool	Da	true=factură (DATECS și Tremol; ignorat pe Daisy)

Bon fiscal (implicit)

{
  "OperatorCode": 1,
  "OperatorPassword": "0001",
  "PointOfSaleNumber": 1,
  "Invoice": false
}

Factură fiscală (DATECS / Tremol)

{
  "OperatorCode": 1,
  "OperatorPassword": "0001",
  "PointOfSaleNumber": 1,
  "Invoice": true
}

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

POST

/print-fiscal-text

Tipărește text pe bon fiscal

Tipărește o linie de text pe bonul fiscal deschis. Același corp de cerere ca print-non-fiscal-text: DATECS folosește toate opțiunile de formatare; Daisy și Tremol folosesc doar Message.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
Message	String	Da	Text de tipărit
Bold	Bool?	Nu	Text îngroșat (DATECS)
Italic	Bool?	Nu	Text italic (DATECS)
Height	Int?	Nu	0=Normal, 1=Dublu, 2=Jumătate (DATECS)
Underline	Bool?	Nu	Subliniat (DATECS)
Alignment	Int?	Nu	0=Stânga, 1=Centru, 2=Dreapta (DATECS)

Minimal

{
  "Message": "CIF Client: RO12345678"
}

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• Necesită un bon fiscal deschis.

POST

/register-free-sale

Înregistrează o vânzare liberă

Adaugă un articol pe bon fără PLU predefinit. Suportat pe DATECS și Tremol; Daisy returnează 400 — folosește register-plu-sale.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
ProductName	String	Da	Max 72 caractere
TaxCode	Int	Da	1–8 (VatA–VatH)
Price	Decimal	Da	Preț unitar (0–9.999.999,99)
Department	Int	Da	0–99
Unit	String	Da	Max 6 caractere (ex: buc, kg)
Void	Bool	Nu	true = storno ultimă vânzare
Quantity	Decimal?	Nu	Implicit 1; 0,01–999.999,999
DiscountType	Int?	Nu	0=None, 1=Majorare Procentuală, 2=Reducere Procentuală, 3=Majorare Fixă, 4=Reducere Fixă
DiscountValue	Decimal?	Nu	Obligatoriu cu DiscountType ≠ 0

Vânzare simplă

{
  "ProductName": "Produs",
  "TaxCode": 1,
  "Price": 19.99,
  "Department": 1,
  "Unit": "buc"
}

Cu cantitate și reducere

{
  "ProductName": "Cafea",
  "TaxCode": 1,
  "Price": 8.50,
  "Quantity": 2,
  "Department": 1,
  "Unit": "buc",
  "DiscountType": 2,
  "DiscountValue": 10
}

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Eroare

{
  "StatusCode": 400,
  "Message": "Daisy nu suportă vânzări libere; folosește register-plu-sale"
}

POST

/register-plu-sale

Înregistrează o vânzare prin PLU

Adaugă pe bon un articol existent în memoria dispozitivului (PLU). Funcționează pe ambele tipuri de case.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
PluNumber	Int	Da	PLU trebuie să existe în dispozitiv
Void	Bool	Nu	true = storno
Quantity	Decimal?	Nu	Implicit 1
DiscountType	Int?	Nu	0=None, 1=Majorare Procentuală, 2=Reducere Procentuală, 3=Majorare Fixă, 4=Reducere Fixă
DiscountValue	Decimal?	Nu	Cu DiscountType ≠ 0

Minimal

{
  "PluNumber": 1,
  "Quantity": 2
}

Cu reducere

{
  "PluNumber": 5,
  "Quantity": 1,
  "Void": false,
  "DiscountType": 2,
  "DiscountValue": 15
}

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• PLU trebuie programat în dispozitiv înainte.

POST

/subtotal

Trimite subtotalul

Calculează și trimite subtotalul pe dispozitiv. Opțional: tipărire, afișaj, discount/majorare.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
Print	Bool?	Nu	Tipărește subtotalul
Display	Bool?	Nu	Afișează pe ecran client
DiscountType	Int?	Nu	0=None, 1=Majorare Procentuală, 2=Reducere Procentuală, 3=Majorare Fixă, 4=Reducere Fixă
DiscountValue	Decimal?	Nu	Cu DiscountType ≠ 0

Minimal (fără corp sau {} )

{}

Cu opțiuni

{
  "Print": true,
  "Display": true,
  "DiscountType": 2,
  "DiscountValue": 5
}

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

POST

/payment

Înregistrează plata

Înregistrează o plată pe bon. Pentru plăți non-cash suma trebuie să acopere exact totalul; restul este permis doar pentru cash.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
PaymentMode	Int	Da	Mod plată (definit de dispozitiv)
Amount	Decimal	Da	Suma

Plată cash

{
  "PaymentMode": 0,
  "Amount": 100.00
}

Plată card (suma exactă)

{
  "PaymentMode": 1,
  "Amount": 47.50
}

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

POST

/close-fiscal-receipt

Închide bonul fiscal

Finalizează bonul fiscal după înregistrarea articolelor și plăților.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• Nu necesită corp de cerere.

POST

/cancel-fiscal-receipt

Anulează bonul fiscal

Anulează bonul fiscal deschis fără a-l finaliza.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• Nu necesită corp de cerere.

POST

/status-of-the-fiscal-transaction

Statusul tranzacției fiscale

Returnează starea curentă a tranzacției fiscale de pe dispozitiv (bon deschis, sumă acumulată etc.).

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": { "<câmpuri răspuns dispozitiv>": "..." }
}

Observații

• Nu necesită corp de cerere.
• Data este un obiect structurat, nu string.

POST

/copy-of-last-fiscal-receipt

Copia ultimului bon fiscal

Tipărește o copie a ultimului bon fiscal emis.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": { "<câmpuri răspuns dispozitiv>": "..." }
}

Observații

• Nu necesită corp de cerere.
• Pe Tremol funcționează doar cu parametrul FD activat în firmware (service autorizat).

POST

/report-z

Tipărește raportul Z

Generează raportul fiscal Z, folosit pentru închiderea zilnică. Resetare date.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• Nu necesită corp de cerere.

POST

/report-x

Tipărește raportul X

Generează raportul X, fără închidere fiscală.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• Nu necesită corp de cerere.

GET

/ask-for-z-report-structured-information/{number}

Informații structurate raport Z

Returnează datele unui raport Z arhivat, în format structurat, după numărul raportului.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": { "<câmpuri raport Z>": "..." }
}

Observații

• {number} = numărul raportului Z cerut.

Device Communication — Coduri de bare, linii și afișaj client

Comenzi pentru elemente individuale de tipărire și pentru afișajul de client al casei de marcat.

POST

/print-bar-code

Tipărește un cod de bare

Tipărește un cod de bare pe bonul deschis. Tipurile suportate diferă între DATECS și Daisy; Tremol nu suportă coduri de bare.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
Type	Int	Da	1=EAN8, 2=EAN13, 3=Code128, 4=QRCode (DATECS), 5=Standard2Of5 (Daisy), 6=Interleaved2Of5, 7–16 = alte tipuri (vezi diferențele pe case)
Data	String	Da	Conținutul codului de bare
QrSize	Int?	Nu	Dimensiune QR (DATECS)
Position	Int?	Nu	Poziția codului
Scale	Int?	Nu	Scalare
Height	Int?	Nu	Înălțime
PrintText	Bool?	Nu	Tipărește și textul codului

EAN13

{
  "Type": 2,
  "Data": "5940000000820"
}

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• Pe Tremol returnează NotSupportedException.
• Vezi tabelul de tipuri suportate per casă în diferențele dintre case de marcat.

POST

/print-separating-line/{type}

Tipărește o linie de separare

Tipărește o linie de separare pe bonul deschis. {type} acceptă valorile 1–4 (stiluri diferite: -, =, *, - -); alte valori returnează 400.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Eroare

{
  "StatusCode": 400,
  "Message": "Tip de linie de separare invalid"
}

Observații

• Nu necesită corp de cerere — tipul se transmite în URL.

POST

/display-line-one

Afișează text pe linia 1 a afișajului client

Trimite text pe prima linie a afișajului de client al casei de marcat.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
Text	String	Da	Textul afișat (pe Tremol exact 20 caractere — padded/truncat)

Exemplu

{
  "Text": "Bun venit!"
}

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

POST

/display-line-two

Afișează text pe linia 2 a afișajului client

Trimite text pe a doua linie a afișajului de client.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
Text	String	Da	Textul afișat (pe Tremol exact 20 caractere — padded/truncat)

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

POST

/clear-display

Golește afișajul client

Șterge conținutul afișajului de client.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• Nu necesită corp de cerere.

Printare bon complet (o singură cerere)

Trimite întregul bon într-un singur apel. FiscalLink execută intern: deschidere, articole, subtotal, plăți, închidere.

POST

/print-fiscal-receipt

Tipărește un bon fiscal complet

Primește toate datele bonului și execută fluxul complet. openFiscalReceipt, subtotal și payments sunt opționale; dacă payments lipsește, se folosește plata automată.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
OpenFiscalReceipt	Object?	Nu	Parametri deschidere (opțional)
ReceiptItems	ReceiptItem[]	Da	Articole: Type 0=FreeSale, 1=PluSale, 2=Text, 3=BarCode, 4=SeparatingLine
Subtotal	Object?	Nu	Subtotal cu opțiuni
Payments	RegisterPayment[]?	Nu	Listă plăți; dacă lipsește = plată automată

Bon simplu (articole + plată automată)

{
  "ReceiptItems": [
    {
      "Type": 0,
      "FreeSale": {
        "ProductName": "Cafea",
        "TaxCode": 1,
        "Price": 5.00,
        "Department": 1,
        "Unit": "buc"
      }
    },
    {
      "Type": 0,
      "FreeSale": {
        "ProductName": "Pâine",
        "TaxCode": 1,
        "Price": 2.50,
        "Quantity": 2,
        "Department": 1,
        "Unit": "buc"
      }
    }
  ]
}

Bon complet cu toate tipurile de articole

{
  "OpenFiscalReceipt": {
    "OperatorCode": 1,
    "OperatorPassword": "0001",
    "PointOfSaleNumber": 1,
    "Invoice": false
  },
  "ReceiptItems": [
    {
      "Type": 2,
      "Text": {
        "Message": "CIF Client: RO12345678",
        "Alignment": 1
      }
    },
    {
      "Type": 0,
      "FreeSale": {
        "ProductName": "Produs",
        "TaxCode": 1,
        "Price": 10.00,
        "Department": 1,
        "Unit": "buc"
      }
    },
    {
      "Type": 4,
      "SeparatingLineType": 2
    }
  ],
  "Subtotal": { "Print": true },
  "Payments": [
    { "PaymentMode": 0, "Amount": 10.00 }
  ]
}

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• ReceiptItem: type 0=FreeSale (freeSale), 1=PluSale (pluSale), 2=Text (text), 3=BarCode (barCode), 4=SeparatingLine (separatingLineType 1–4).
• Pe Daisy, FreeSale nu este suportat în receiptItems.
• Pe Tremol, BarCode nu este suportat în receiptItems (returnează NotSupportedException).

POST

/print-non-fiscal-receipt

Tipărește un bon nefiscal complet

Primește toate elementele unui bon nefiscal și le tipărește într-un singur apel. receiptItems: type 0=Text, 1=BarCode, 2=SeparatingLine.

Corp cerere

Câmp	Tip	Obligatoriu	Descriere
ReceiptItems	NonFiscalReceiptItem[]	Da	Type 0=Text, 1=BarCode, 2=SeparatingLine

Text + linie + cod de bare

{
  "ReceiptItems": [
    {
      "Type": 0,
      "Text": {
        "Message": "BON NEFISCAL",
        "Bold": true,
        "Alignment": 1
      }
    },
    {
      "Type": 2,
      "SeparatingLineType": 1
    },
    {
      "Type": 1,
      "BarCode": {
        "Type": 2,
        "Data": "5940000000820"
      }
    }
  ]
}

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Observații

• Pe Tremol, BarCode nu este suportat (returnează NotSupportedException).

Shopify Controller

Endpoint-urile Shopify sunt apelate de componentele FiscalLink din Shopify POS, care trimit automat un token de sesiune Shopify în antetul Authorization: Bearer. Nu este necesară nicio configurare de credențiale. Vezi ghidul Shopify.

GET

/get-shopify-order/{orderId}

Preia o comandă Shopify

Returnează detaliile complete ale unei comenzi Shopify (line items, discounturi, transport, tranzacții). orderId este numeric (ex: 123456789), fără prefixe gid://.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": {
    "id": "gid://shopify/Order/123456789",
    "legacyResourceId": "123456789",
    "name": "#1001",
    "totalPriceSet": { "shopMoney": { "amount": "99.99", "currencyCode": "RON" } },
    "totalDiscountsSet": { "shopMoney": { "amount": "0.00", "currencyCode": "RON" } },
    "note": null,
    "lineItems": {
      "edges": [
        {
          "node": {
            "id": "gid://shopify/LineItem/123",
            "title": "Produs exemplu",
            "quantity": 2,
            "originalUnitPriceSet": { "shopMoney": { "amount": "25.00", "currencyCode": "RON" } },
            "discountedUnitPriceSet": { "shopMoney": { "amount": "22.50", "currencyCode": "RON" } },
            "taxLines": [],
            "discountAllocations": []
          }
        }
      ]
    },
    "transactions": [
      { "gateway": "manual", "amount": "45.00", "kind": "SALE" }
    ],
    "discountApplications": { "edges": [] },
    "shippingLines": {
      "edges": [
        {
          "node": {
            "id": "gid://shopify/ShippingLine/1",
            "title": "Standard",
            "originalPriceSet": { "shopMoney": { "amount": "15.00", "currencyCode": "RON" } },
            "discountedPriceSet": { "shopMoney": { "amount": "0.00", "currencyCode": "RON" } },
            "discountAllocations": []
          }
        }
      ]
    }
  }
}

Eroare 401 — Token de sesiune lipsă

{
  "StatusCode": 401,
  "Message": "Token-ul de sesiune Shopify lipsește. Actualizați aplicația FiscalLink în Shopify POS și încercați din nou."
}

Eroare 401/403 — Cerere respinsă de Shopify

{
  "StatusCode": 401,
  "Message": "Shopify a respins cererea. Asigurați-vă că aplicația FiscalLink este instalată pe magazinul dvs."
}

Eroare 404 — Comandă inexistentă

{
  "StatusCode": 404,
  "Message": "Order not found"
}

POST

/print-shopify-order/{orderId}

Tipărește o comandă Shopify

Preia comanda din Shopify și o tipărește automat ca bon fiscal pe dispozitivul conectat.

Răspuns

Succes

{
  "StatusCode": 200,
  "Data": "<răspuns dispozitiv>"
}

Eroare 400 — Configurare sau date invalide

{
  "StatusCode": 400,
  "Message": "Invalid order data"
}

Eroare 404 — Comandă inexistentă

{
  "StatusCode": 404,
  "Message": "Order not found"
}

Eroare 424 — Dispozitiv deconectat

{
  "StatusCode": 424,
  "Message": "Device communication failure"
}

Legacy Controller (POST /Receipt)

Endpoint compatibil FiscalNet/Fisco. Acceptă array de stringuri în format FiscalNet (^) sau INP (;,). Formatul este detectat automat. Returnează un format diferit de restul API-ului.

POST

/Receipt

Tipărește bon în format FiscalNet sau INP

Primește un array de comenzi în format legacy. FiscalNet folosește ^ ca delimitator; INP folosește , și ;. Vezi documentația FiscalNet/Fisco pentru comenzi.

Corp cerere

FiscalNet (exemplu)

[
  "CF^RO12345678",
  "S^Produs^1000^1000^pcs^1^1",
  "ST^",
  "P^1^1000"
]

INP (exemplu)

[
  "S,1,______,_,__;Produs;10.00;1.000;1;1;2;0;0;pcs",
  "T,1,______,_,__;0;10.00;;;;"
]

Răspuns

Succes

{
  "ReceiptStatus": "true",
  "ReceiptNumber": "12345",
  "ErrorCode": "",
  "ErrorInfo": ""
}

Eroare

{
  "ReceiptStatus": "false",
  "ReceiptNumber": "",
  "ErrorCode": "123",
  "ErrorInfo": "Descrierea erorii"
}

Observații

• Răspuns diferit de API standard: receiptStatus, receiptNumber, errorCode, errorInfo.
• HTTP 200 chiar și la eroare; succes/eroare se citesc din receiptStatus.
• Comenzi comune: CF (CIF), S (Sale), ST (Subtotal), P (Payment), X^ (Report X), Z^ (Report Z).

Fluxuri uzuale

Bon nefiscal

POST /open-non-fiscal-receipt
POST /print-non-fiscal-text (repetat)
POST /close-non-fiscal-receipt (sau /cancel-non-fiscal-receipt pentru anulare)

Bon fiscal

POST /open-fiscal-receipt
POST /register-free-sale sau /register-plu-sale
POST /subtotal
POST /payment
POST /close-fiscal-receipt (sau /cancel-fiscal-receipt pentru anulare)

Securitate

Folosește endpoint-ul HTTPS pentru integrarea standard, atunci când este posibil.
API-ul local HTTP este accesibil doar în rețeaua locală și nu folosește TLS.
Datele de intrare sunt validate înainte de comunicarea cu dispozitivul.

Pentru asistență: [email protected]