Documentație pentru integratori

Conectează programul tău la casele de marcat.

Un singur API pentru Datecs, Tremol și Daisy. Pe casa clientului, prin API-ul local al aplicației FiscalLink, sau de la distanță, prin API-ul Cloud.

Aplicația FiscalLink e mereu puntea: doar ea vorbește cu casa de marcat. Programul tău vorbește cu aplicația, direct sau prin FiscalLink Cloud.

Paginile de aici sunt pentru dezvoltatori. Dacă ești magazinul care folosește aplicația, ghidurile tale sunt în documentația aplicației (/app/docs) și a FiscalLink Cloud (/cloud/docs).

Două căi

	API local	API Cloud
Unde rulează programul tău	Pe același calculator cu aplicația FiscalLink sau în aceeași rețea.	Pe serverul tău, oriunde.
Cum ajunge comanda	Cereri REST către aplicație. Răspunsul casei vine în același apel.	Cereri REST către FiscalLink Cloud, cu o cheie API. Cloud-ul trimite comanda la aplicația de pe casa clientului; răspunsul îl citești după aceea.
Ce poți trimite	Bon fiscal dintr-un singur apel, bon nefiscal, rapoarte X și Z, citirea cotelor TVA, articole (PLU): citire, programare, ștergere, afișaj client, coduri de bare, copia ultimului bon.	Raport Z, raport X, bon fiscal, bon nefiscal, citirea cotelor TVA.
Ce îți trebuie	Aplicația FiscalLink, o casă conectată și o licență Essential sau Commerce pe casă.	O organizație de integrator și chei API. La client: aplicația FiscalLink, casa conectată și activată cu codul tău.
Cât costă	Licența clientului, pe casă: Essential 15 lei/lună +TVA sau 99 lei/an +TVA; Commerce 99 lei/lună +TVA sau 999 lei/an +TVA.	100 lei/an +TVA organizația; 29 lei +TVA pe casă, pe lună de folosire, care scade cu volumul până la 21,75 lei +TVA.
Fără internet	Aplicația tipărește cât timp licența salvată pe dispozitiv e valabilă.	Comanda către o casă offline așteaptă până casa revine.

Cum alegi

Alege API-ul local când programul tău rulează lângă casă, pe calculatorul sau în rețeaua magazinului, și vrei răspunsul casei în același apel.
Alege API-ul Cloud când trimiți comenzi de la distanță, pentru casele mai multor clienți, fără acces la rețeaua magazinului.
Folosești deja FiscalNet sau Fisco: aplicația FiscalLink citește aceleași foldere și ascultă pe aceeași interfață Fisco, pe desktop. Vezi „Treci de pe FiscalNet sau Fisco”.
Ambele căi folosesc aceleași câmpuri pentru bonuri: în API-ul local le scrii cu majusculă (ReceiptItems), în API-ul Cloud în camelCase (receiptItems).

Ce îți trebuie: API local

Clientul instalează aplicația FiscalLink (Windows, macOS, Linux, Android sau iOS) și conectează casa prin USB, Bluetooth sau rețea. Pe iOS doar prin rețea; Daisy nu are conexiune în rețea.
Clientul activează o licență pe casă, din FiscalLink Cloud. Licența ține de seria casei, nu de dispozitiv, și nu se introduce niciun cod. Pașii lui sunt în documentația aplicației (/app/docs).
Programul tău află adresa API-ului cu GET /get-secure-api-address și trimite cererile. Detaliile sunt în „API local”.

Ce îți trebuie: API Cloud

Creezi în FiscalLink Cloud o organizație de integrator și plătești taxa anuală de 100 lei +TVA. Organizația există abia după plată. În dashboard, tipul ei apare ca „Integrare”.
Creezi cheile API: automatizare (comenzi), administrare (clienți și case), sandbox (fsk_test_).
Adaugi clienții. Fiecare client primește un cod de activare.
Clientul folosește codul în aplicația FiscalLink, pe fiecare casă, și își dă acordul. Pașii lui sunt în documentația aplicației (/app/docs).
Trimiți comenzi prin API, câte una pe casă, și citești rezultatul.

Sandboxul

Organizația de integrator are un sandbox: o casă de marcat simulată care răspunde ca aplicația FiscalLink, cu chei de test fsk_test_. Nu tipărește nimic, nu facturează nimic și nu atinge nicio casă. Detaliile sunt în „Sandbox”.

Referința din dashboard

Referința API-ului Cloud există și în dashboard, în organizația ta, la Documentație. Exemplele de acolo folosesc adresa de producție.