> Source: https://fiscallink.ro/documentation/user-guide
> Pas cu pas: conectarea dispozitivului, configurarea automată sau manuală, folosirea API-ului, activarea licenței și reconectarea automată în FiscalLink.

# Ghid utilizare

Conectează dispozitivul fiscal, configurează aplicația, activează licența și integrează cu POS-ul sau platforma e-commerce.

## 1\. Conectarea dispozitivului

Înainte de a imprima, trebuie să conectezi un dispozitiv fiscal la FiscalLink.

1.  Deschide aplicația FiscalLink
2.  Dacă niciun dispozitiv nu e conectat, apasă **Conectează un dispozitiv**
3.  Deschide **meniul** (☰) și apasă **Device Connection**
4.  Selectează metoda de comunicare și configurare
5.  Alege dispozitivul din listă și apasă **Connect** (la WiFi / LAN nu există listă — introduci adresa IP și portul imprimantei)

### Metode de comunicare

-   **Serial / USB** — Cablu USB sau port COM. Folosește când imprimanta e conectată prin adaptor serial (ex. USB-to-serial). Disponibil pe Windows, macOS, Linux și Android.
-   **Bluetooth** — Fără fir. Folosește când imprimanta are Bluetooth integrat sau e asociată prin adaptor Bluetooth. Disponibil pe Windows, macOS, Linux și Android.
-   **WiFi / LAN** — Prin rețea. Imprimanta fiscală și dispozitivul cu FiscalLink trebuie să fie în aceeași rețea. Introduci **adresa IP** a imprimantei și **portul** pe care aceasta ascultă. Porturile implicite: **4444** pentru Tremol și **3999** pentru DATECS. **Daisy nu suportă conexiune WiFi / LAN.** Poți lăsa portul gol pentru detectare automată. Disponibil pe toate platformele — pe iOS este singura metodă de conectare.

Exemplu — conectare WiFi / LAN

Imprimantă Tremol cu adresa IP `192.168.1.50`:

-   **Adresă IP:** `192.168.1.50`
-   **Port:** `4444` (pentru DATECS ai folosi `3999`; lăsat gol, portul e detectat automat)

## Configurare automată vs manuală

|  | Automat | Manual |
| --- | --- | --- |
| Tip casă de marcat | FiscalLink detectează protocolul (DATECS, Daisy sau Tremol) | Tu alegi explicit DATECS, Daisy sau Tremol |
| Baud rate (Serial) | 9600 (implicit) | Alegi: 9600, 19200, 38400, 57600 sau 115200 |
| Port (WiFi / LAN) | Lăsat gol — detectat automat | Pre-completat cu portul implicit al tipului ales (Tremol 4444, DATECS 3999); poate fi modificat. Daisy nu apare la WiFi / LAN. |
| Când să folosești | Prima configurare sau când nu știi modelul | Când detectarea automată eșuează sau dispozitivul necesită un baud rate specific |

## 2\. Folosirea API-ului

Odată conectat, aplicațiile externe trimit comenzi de bon prin API-ul HTTP local (Device Communication, Legacy, Shopify).

URL-ul de bază și porturile API sunt afișate pe ecranul principal și în **Server Status** (meniu → Server Status).

## 3\. Activarea licenței

FiscalLink se licențiază **per casă de marcat**. Licența se activează direct din aplicație, pe dispozitivul conectat la imprimanta fiscală.

1.  Conectează casa de marcat (vezi pasul 1).
2.  Deschide **meniul** (☰) și apasă **Licență**.
3.  Introdu codul de licență primit la achiziție și apasă **Activează**.
4.  Licența rămâne legată de casa de marcat respectivă — o singură activare acoperă acea casă pe toate dispozitivele care o folosesc.

## 4\. Configurare integrare (opțional)

În funcție de setup, poți configura:

#### Shopify

Instalează aplicația FiscalLink în magazin și activează butoanele în Shopify POS — fără chei API sau alte configurări.

[Ghid configurare Shopify →](https://fiscallink.ro/documentation/shopify)

#### Integrare în aplicații externe

Conectează FiscalLink cu propria aplicație sau platformă prin rețea locală, app to app sau remote (Cloud).

[Documentație integratori →](https://fiscallink.ro/documentation/integrators)

#### Setări aplicație

Limbă și alte preferințe.

## Reconectare automată

La pornirea aplicației, FiscalLink se reconectează automat la ultimul dispozitiv folosit. Dacă conexiunea se pierde în timpul utilizării (dispozitiv oprit, în afara razei sau deconectat), aplicația afișează mesajul **„Se încearcă reconectarea la ultimul dispozitiv conectat..."** și reîncearcă automat la fiecare 5 secunde, pe aceeași metodă de comunicare, până reușește sau până apeși **Oprește**. La WiFi / LAN reconectarea folosește exact adresa IP și portul salvate. Poți reconecta dispozitivul și manual din meniul Device Connection.

## Rezolvare probleme

-   **Dispozitivul nu apare în listă:** Asigură-te că este pornit, asociat prin Bluetooth sau conectat prin Serial. Apasă Refresh pentru o nouă scanare.
-   **Testul de conectare eșuează:** Dispozitivul nu a răspuns. Verifică alimentarea, cablurile și încearcă modul Manual cu tipul corect de casă de marcat și baud rate-ul potrivit.
-   **Conectarea prin WiFi / LAN eșuează:** Verifică dacă adresa IP este corectă și dacă imprimanta și dispozitivul cu FiscalLink sunt în aceeași rețea. Verifică portul: 4444 pentru Tremol, 3999 pentru DATECS — sau lasă-l gol pentru detectare automată. Reține că Daisy nu suportă WiFi / LAN.