FiscalBridge pentru integratori.

Folderele

• Bonuri: folderul de intrare configurat, unde programul tău scrie fișierele
• Raspuns: răspunsurile (lângă folderul de intrare; la Fisco: BonOK / BonERR / BonANSWER)
• Istoric: fișierele procesate, pe zile
• C:\ProgramData\FiscalBridge\files\cli\in: plicurile FiscalBridgePrint.exe (nu se scrie de mână)

Reguli

• Numele fiecărui fișier e unic: un nume refolosit în fereastra de protecție întoarce răspunsul primului fișier, fără al doilea bon.
• Fișierul se scrie complet și abia apoi se pune în folder (sau se redenumește): FiscalBridge îl preia doar după ce dimensiunea nu se mai schimbă.
• Codificarea: UTF-8 (cu sau fără BOM) sau Windows-1250; diacriticele se păstrează.
• Fișierele peste 256 KB sunt refuzate înainte de casă.
• Unitatea de măsură e obligatorie pe fiecare articol (OUG 69/2024); lipsa ⇒ „buc” și un avertisment.
• Căile de export (RF, JE) sunt acceptate doar sub folderul de exporturi al FiscalBridge; altfel EXPORT_PATH_NOT_ALLOWED.

Linii cu ^ (formatul FiscalNet)

Extensii: .txt · separatorul ^ · sumele în bani (1000 = 10,00 lei); cantități în miimi.

Linii FPrint (CMD,NR,______,_,__;câmp;…)

Extensii: .inp, .bon · separatorul ; · sumele în lei, cu punct zecimal (sau întregi, dacă folderul e configurat așa).

Răspunsurile

FiscalNet, Fisco, SmartSell și celelalte denumiri de produse sunt mărci ale titularilor lor. POSEO S.R.L. nu este afiliată cu aceștia; le numim doar ca să arătăm cu ce fișiere lucrează FiscalBridge.

Un bon fiscal: POST /receipt

bon.json

{
  "id": "vanzare-1024",
  "operator": "1",
  "operatorPassword": "0001",
  "till": "1",
  "lines": [
    {
      "name": "CAFEA",
      "quantity": 1,
      "price": 10.0,
      "vatGroup": 1,
      "unit": "buc",
      "department": 1
    }
  ],
  "payments": [
    {
      "type": 1,
      "amount": 10.0
    }
  ]
}

curl

curl -X POST http://127.0.0.1:5078/receipt -H "X-Api-Key: CHEIA-DIN-agent.settings.json" -H "Content-Type: application/json" --data @bon.json

C#

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", "CHEIA-DIN-agent.settings.json");
var bon = File.ReadAllText("bon.json");
var raspuns = await http.PostAsync("http://127.0.0.1:5078/receipt", new StringContent(bon, System.Text.Encoding.UTF8, "application/json"));
Console.WriteLine(await raspuns.Content.ReadAsStringAsync());

Python

import json, requests

with open("bon.json", encoding="utf-8") as f:
    bon = json.load(f)
raspuns = requests.post("http://127.0.0.1:5078/receipt", headers={"X-Api-Key": "CHEIA-DIN-agent.settings.json"}, json=bon)
print(raspuns.json())

Node

import { readFile } from "node:fs/promises";

const bon = await readFile("bon.json", "utf8");
const raspuns = await fetch("http://127.0.0.1:5078/receipt", {
  method: "POST",
  headers: { "X-Api-Key": "CHEIA-DIN-agent.settings.json", "Content-Type": "application/json" },
  body: bon,
});
console.log(await raspuns.json());

Raportul Z: GET /reports/z

curl

curl http://127.0.0.1:5078/reports/z -H "X-Api-Key: CHEIA-DIN-agent.settings.json"

C#

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", "CHEIA-DIN-agent.settings.json");
Console.WriteLine(await http.GetStringAsync("http://127.0.0.1:5078/reports/z"));

Python

import requests

print(requests.get("http://127.0.0.1:5078/reports/z", headers={"X-Api-Key": "CHEIA-DIN-agent.settings.json"}).text)

Node

const raspuns = await fetch("http://127.0.0.1:5078/reports/z", { headers: { "X-Api-Key": "CHEIA-DIN-agent.settings.json" } });
console.log(await raspuns.text());

Raportul X: GET /reports/x

curl

curl http://127.0.0.1:5078/reports/x -H "X-Api-Key: CHEIA-DIN-agent.settings.json"

C#

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", "CHEIA-DIN-agent.settings.json");
Console.WriteLine(await http.GetStringAsync("http://127.0.0.1:5078/reports/x"));

Python

import requests

print(requests.get("http://127.0.0.1:5078/reports/x", headers={"X-Api-Key": "CHEIA-DIN-agent.settings.json"}).text)

Node

const raspuns = await fetch("http://127.0.0.1:5078/reports/x", { headers: { "X-Api-Key": "CHEIA-DIN-agent.settings.json" } });
console.log(await raspuns.text());

• mereu disponibilă: Mereu disponibilă, și cu licența expirată sau lipsă: rapoarte Z/X, anulare bon deschis, numerar, jurnal, export ANAF, stare.
• bon fiscal nou: Bon fiscal nou: cere o licență valabilă care acoperă casa activă.
• plată nouă cu cardul: Plată nouă pe terminalul bancar: cere dreptul de POS bancar.
• configurare: Salvarea configurației și testele de conexiune: mereu disponibile.

Plata cu cardul urmată de bon (POST /payments) cere ambele drepturi: bonul fiscal nou pe casa de marcat și plata pe terminalul bancar.

• unitatea de măsură pe fiecare articol (de exemplu „buc” sau „kg”);
• codul operatorului care face vânzarea;
• CUI-ul cumpărătorului, când îl cere, prin câmpul dedicat (comanda CF sau câmpul fiscal din API), nu ca text liber;
• tipul de plată corect (numerar, card, tichete și celelalte), după tabelul casei de marcat;
• bacșișul ca articol separat, cu denumirea „bacșiș”;
• garanția SGR pe o linie distinctă a bonului.