> Source: https://fiscal.link/shopify-pos/docs/troubleshooting
> Butoane care nu apar, POS neasociat, parola operatorului, conexiunea pe Android și mesajele de eroare din Shopify POS, cu rezolvarea lor.

# Probleme frecvente

Ce faci când ceva nu merge, de la butoane care nu apar la mesajele de eroare din POS.

## Instalare

### Nu am Shopify POS pe dispozitiv

Fără aplicația Shopify POS nu poți tipări bonuri prin FiscalLink. Instalează Shopify POS din Google Play sau din App Store.

### Butoanele FiscalLink nu apar în Shopify POS

Deschide Point of Sale → Settings → Customization. Butoanele Report X, Report Z și Unpair device se adaugă de mână în grila POS, iar butoanele de tipărire se activează din meniul Apps al editorului (vezi Instalare, pasul 2). Apoi închide și redeschide Shopify POS.

### Fila Shopify nu apare în aplicația FiscalLink

Fila Configurare → Shopify apare doar cu o casă de marcat conectată și licența Commerce activă pe ea. Conectează casa și activează licența Commerce.

### Primesc eroarea „Shopify a respins cererea”

Verifică că FiscalLink e instalat în magazinul tău Shopify (Instalare, pasul 1) și că folosești versiunea actualizată a Shopify POS. Dacă ai dezinstalat FiscalLink din magazin, instalează-l din nou din Shopify App Store.

### Am configurat în trecut URL-ul magazinului și un token API

Nu mai e nevoie. FiscalLink folosește acum asocierea cu cod de asociere. Poți șterge aplicația custom creată atunci în Shopify (Settings → Apps and sales channels).

## Asociere

### Shopify POS spune că POS-ul nu este asociat

În aplicația FiscalLink, la Configurare → Shopify, copiază codul de asociere. În Shopify POS atinge orice buton FiscalLink, introdu codul și aprobă asocierea în aplicația FiscalLink.

### „Unknown pairing code. Check the code shown in the FiscalLink app.”

Codul nu e cel al casei. Copiază-l din nou din aplicația FiscalLink (Configurare → Shopify). Dacă ai resetat casa, codul s-a schimbat.

### „This cash register isn't ready yet. In the FiscalLink app, open Configuration → Shopify and enter the operator details.”

Operatorul casei nu e setat. În aplicația FiscalLink, la Configurare → Shopify → Detalii operator, introdu ID-ul și parola operatorului și salvează (vezi Asocierea, pasul 5).

### „Pairing failed. Please try again.”

Dacă POS-ul a fost blocat din aplicația FiscalLink, nu mai poate cere asocierea cu acea casă. Deblochează-l din Configurare → Shopify → Blocate, apoi asociază-l din nou.

### Asocierea a fost respinsă

Cererea a fost respinsă în aplicația FiscalLink, iar POS-ul s-a întors la câmpul pentru cod. Trimite cererea din nou și apasă **Aprobă** în aplicație.

## Tipărire

### Parolă de operator invalidă

**Problemă.** La un bon din Shopify POS, casa refuză operația cu eroarea `operator password invalid`. Nu se tipăresc bonuri până nu se potrivește parola.

**Cauză.** Bonurile din Shopify POS se deschid cu operatorul setat în aplicația FiscalLink, la Configurare → Shopify → Detalii operator. Dacă ID-ul sau parola de acolo nu sunt ale unui operator programat în casă, fiecare tipărire eșuează. Dacă detaliile operatorului lipsesc, aplicația folosește operatorul 1 cu parola `0001`.

**Rezolvare.** 1. Află pe casa de marcat ID-ul și parola operatorului (casierului). 2. În aplicația FiscalLink, la Configurare → Shopify, apasă **Modifică detaliile operatorului**, introdu-le și salvează. 3. Tipărește din nou din Shopify POS.

### „Receipt failed to print. Please check that the FiscalLink app is running.”

Aplicația FiscalLink sau casa nu răspund. Verifică: aplicația e deschisă, casa e conectată (fila Dispozitive), licența Commerce e activă, iar dispozitivul cu aplicația are internet. Apoi tipărește din detaliile comenzii.

### „Couldn't reach the FiscalLink service…”

Serviciul FiscalLink pentru Shopify nu poate fi contactat; problema nu e la casa ta. Încearcă din nou peste câteva minute sau scrie-ne la [support@fiscal.link](mailto:support@fiscal.link).

### „The FiscalLink app on your register is too old to print a client CUI…”

Actualizează aplicația FiscalLink de lângă casa de marcat, apoi tipărește din nou bonul cu CUI.

### POS-ul nu a primit răspuns de la casă

Bonul se poate să se fi tipărit totuși. Uită-te întâi pe casa de marcat. Doar dacă nu s-a tipărit, tipărește din nou din detaliile comenzii.

### Comanda e refuzată (retur, plată, TVA, Daisy)

O comandă returnată sau neplătită integral nu se tipărește. Un produs fără taxă în Shopify sau cu o cotă TVA care nu e programată în casă e refuzat. Pe Daisy, pornește vânzarea liberă. Detalii: Ce nu face.

## Android

### Conexiunea se pierde în fundal (Android)

**Problemă.** Pe Android, comenzile din Shopify POS nu se mai încarcă sau nu se mai tipăresc când aplicația FiscalLink rulează în fundal. Sistemul îi închide conexiunea în mijlocul cererii. A fost observat pe Xiaomi Redmi Pad SE, cu Android 15.

**Cauză.** Economisirea bateriei din Android (foarte agresivă pe Xiaomi, MIUI și HyperOS) suspendă aplicația când trece în fundal și îi închide conexiunile. E o setare a dispozitivului, nu o eroare a aplicației.

**Rezolvare.** Pașii sunt pentru Xiaomi, MIUI și HyperOS; alți producători au setări asemănătoare în Setări → Aplicații → Baterie.

1.  Deschide Setări → Aplicații → Gestionează aplicațiile → FiscalLink.
2.  Setează **Economisire baterie** la **Fără restricții**.
3.  Activează **Pornire automată** (Autostart) pentru FiscalLink.
4.  Setări → Baterie → Optimizare baterie → FiscalLink → **Nu optimiza / Fără restricții**.
5.  În lista de aplicații recente, **blochează** aplicația FiscalLink (apasă lung pe card și atinge lacătul), ca sistemul să nu o oprească la curățarea memoriei.
6.  Redeschide aplicația și încearcă din nou.
