Programul tău vorbește cu casa de marcat, prin aplicația FiscalLink.

GET /get-secure-api-address

Adresa API-ului securizat

Întoarce adresa HTTPS completă a API-ului, cu /api.

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

GET /get-local-api-address

Adresa API-ului din rețeaua locală

Întoarce adresa HTTP completă a API-ului în rețeaua locală, cu /api.

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

POST /print-fiscal-receipt

Tipărește un bon fiscal

Primește tot bonul și face singur deschiderea, liniile, subtotalul, plățile și închiderea, într-un singur apel.

Fără OpenFiscalReceipt, bonul se deschide cu operatorul 1, parola 0001, punctul de vânzare 1, fără factură. Fără Payments, tot totalul se achită automat în numerar.

Câmpuri

Modele

Reguli

• Aplicația verifică bonul înainte să-l deschidă. Un bon care eșuează după deschidere e anulat, iar mesajul se termină cu | Receipt cancelled successfully. Niciun bon nu rămâne deschis.
• Cu verificarea cotelor TVA pornită în aplicație, o grupă care nu poartă o cotă încă în vigoare (21%, 11% sau 0%) e refuzată cu 400, înainte de deschidere.
• Plățile care nu acoperă totalul sunt un refuz al casei, iar bonul se anulează. Pe Datecs, o plată automată la un total de 0 sau mai mic e refuzată și bonul se anulează.
• Daisy nu vinde linii libere direct. Cu „Vânzare liberă pe Daisy” pornită în aplicație (sau de organizația de integrator care a activat casa), fiecare linie liberă se vinde ca articol programat: aplicația caută articolul după nume, preț și departamentul grupei TVA și, dacă lipsește, îl programează întâi. Articolele folosite vin înapoi în rezultatul bonului. Cu setarea oprită, bonul cu linii libere e refuzat cu 400, înainte de deschidere.
• Pe API-ul local, Data e mesajul de succes, în limba aplicației. Numărul bonului, totalurile și articolele folosite vin doar prin API-ul Cloud, în rezultatul comenzii.

Cerere minimă (tot totalul în numerar)

{
  "ReceiptItems": [
    {
      "Type": 0,
      "FreeSale": {
        "ProductName": "Espresso",
        "TaxCode": 1,
        "Price": 8.50,
        "Quantity": 2,
        "Department": 1,
        "Unit": "buc"
      }
    }
  ]
}

Cerere completă

{
  "OpenFiscalReceipt": {
    "OperatorCode": 1,
    "OperatorPassword": "0001",
    "PointOfSaleNumber": 1,
    "Invoice": false
  },
  "ReceiptItems": [
    { "Type": 2, "Text": { "Message": "Ref. 128", "Alignment": 1 } },
    { "Type": 0, "FreeSale": { "ProductName": "Espresso", "TaxCode": 1, "Price": 8.50, "Quantity": 2, "Department": 1, "Unit": "buc" } },
    { "Type": 1, "PluSale": { "PluNumber": 101, "Quantity": 1 } },
    { "Type": 4, "SeparatingLineType": 2 }
  ],
  "Subtotal": { "Print": true },
  "Payments": [
    { "PaymentMode": 0, "Amount": 50.00 }
  ]
}

PaymentMode 0 e numerar pe Datecs și Tremol; pe Daisy numerarul are codul 3.

curl -X POST https://localhost.fiscallink.ro:65401/api/print-fiscal-receipt \
  -H "Content-Type: application/json" \
  -d @receipt.json

Răspuns

{
  "StatusCode": 200,
  "Data": "Receipt printed successfully."
}

{
  "statusCode": 400,
  "message": "Receipt printing error: <text> (<code>) | Receipt cancelled successfully"
}

Coduri de răspuns

POST /print-non-fiscal-receipt

Tipărește un bon nefiscal

Tipărește tot bonul nefiscal dintr-un singur apel: linii de text, coduri de bare și linii de separare. Fără vânzări, fără plăți, fără verificare TVA.

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

{
  "StatusCode": 200,
  "Data": "Non-fiscal receipt printed successfully."
}

POST /report-z

Tipărește raportul Z

Închide ziua fiscală și îi aduce totalurile la zero. E ireversibil. Fără corp.

POST /report-x

Tipărește raportul X

Tipărește totalurile zilei de până acum, fără să închidă ziua. Fără corp.

Răspuns (Z; la X, Zeroing e false)

{
  "StatusCode": 200,
  "Data": {
    "Zeroing": true,
    "ReportNumber": "0142",
    "TaxGroups": { "A": "1250.00", "B": "310.50", "C": "0.00", "D": "0.00", "E": "0.00", "F": "0.00" },
    "Payments": { "payment_method1": "980.50", "payment_method2": "580.00", "payment_method3": "0.00" },
    "Message": "Report Z printed successfully."
  }
}

GET /ask-for-z-report-structured-information/{number} Doar Tremol

Raport Z arhivat, după număr

Întoarce datele unui raport Z arhivat, ca obiect, după numărul lui. Doar pe Tremol; Datecs și Daisy refuză cererea.

POST /read-vat-rates

Citește cotele TVA

Citește grupele TVA programate în casă. Nu schimbă nimic pe casă. Fără corp.

{
  "StatusCode": 200,
  "Data": {
    "Groups": { "A": "21.00", "B": "11.00", "C": "0.00" },
    "DisabledGroups": ["D", "E", "F", "G", "H"],
    "ZReportNumber": "0042",
    "EndDate": "01-08-25",
    "Brand": "Datecs",
    "ReadAtUtc": "2026-09-25T10:15:30.1234567Z",
    "Message": "VAT rates read successfully."
  }
}

POST /read-plu-items

Citește articolele

Citește baza de articole a casei. E lentă: aplicația face câte un drum la casă pentru fiecare articol programat. Fără corp, citește toată baza. Pe Tremol, aplicația caută în pozițiile 1–500; prima poziție goală e următorul număr liber, iar rezultatul e marcat ca trunchiat.

POST /program-plu-item

Programează un articol

Creează sau actualizează un articol cu aceeași comandă. Un număr existent e suprascris complet, deci trimiți tot articolul. Fără număr de PLU, aplicația folosește următorul număr liber al casei. Răspunsul e articolul citit înapoi de pe casă.

POST /delete-plu-item

Șterge articole

Șterge articole și citește înapoi intervalul. Un articol cu vânzări rămâne pe casă, pentru că nicio casă nu șterge vânzările. Răspunsul spune ce s-a șters și ce a rămas blocat. Pe Tremol, ștergerea unui singur articol e refuzată: protocolul lui șterge doar toată baza.

POST /display-line-one

Afișează pe linia 1

Scrie un text pe prima linie a afișajului pentru client. Pe Tremol, textul are exact 20 de caractere: se completează sau se taie.

{
  "Text": "Total 27.00"
}

POST /display-line-two

Afișează pe linia 2

Scrie un text pe a doua linie a afișajului pentru client, cu aceleași reguli.

POST /clear-display

Golește afișajul

Șterge ce e pe afișajul pentru client. Fără corp.

POST /print-bar-code

Tipărește un cod de bare

Tipărește un cod de bare pe bonul deschis. Corpul e modelul BarCode.

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

POST /print-separating-line/{type}

Tipărește o linie de separare

Tipărește o linie de separare pe bonul deschis. Stilul vine în cale: 1 -, 2 =, 3 *, 4 - -. Orice altă valoare răspunde 400, iar pe Datecs și 4. Fără corp.

POST /copy-of-last-fiscal-receipt

Copia ultimului bon fiscal

Tipărește o copie a ultimului bon fiscal. Data e un obiect. Daisy nu are această comandă. Fără corp.

POST /status-of-the-fiscal-transaction

Starea tranzacției fiscale

Întoarce starea tranzacției fiscale de pe casă (de exemplu, dacă e un bon deschis și suma strânsă), ca obiect. Fără corp.