Manual de
Utilizare

Ghid complet pentru scanarea și sincronizarea codurilor de bare cu EspoCRM

v1.42 · 2026
01

Instalare pe telefon (Android)

Butelii/SCAN este o aplicație web progresivă (PWA) — nu necesită instalare din Play Store. Se accesează direct din browser și poate fi adăugată pe ecranul principal al telefonului pentru a funcționa ca o aplicație nativă.

⚠
Aplicația necesită conexiune HTTPS. La prima accesare, browserul poate afișa un avertisment de securitate pentru certificatul auto-semnat — acesta este normal în rețelele interne. Apasă Avansat → Continuă pentru a accepta.

Accesare și instalare

  1. Deschide Chrome pe telefonul Android și navighează la adresa aplicației furnizată de administratorul de sistem (ex: https://scan.dpsa.ro).

  2. Dacă apare avertismentul de securitate, apasă Avansat apoi Continuă către site. Această acțiune este necesară o singură dată.

  3. Apasă meniul ⋮ din colțul din dreapta sus al Chrome-ului.

  4. Selectează Adaugă pe ecranul principal sau Instalează aplicația.

  5. Confirmă cu Adaugă. Iconița aplicației va apărea pe ecranul principal.

  6. Deschide aplicația din iconița creată — aceasta va rula în modul ecran complet, fără bara de adrese a browserului.

💡
Aplicația funcționează complet offline după prima încărcare. Scanările se salvează local pe telefon și se trimit către EspoCRM când este disponibilă rețeaua.

Cerințe minime

ComponentăCerință
BrowserGoogle Chrome (versiune recentă) — recomandat
Sistem de operareAndroid 8 sau mai nou
CamerăCameră spate cu autofocus
RețeaWi-Fi în rețeaua locală (pentru sync)
02

Configurare setări

La prima utilizare, aplicația trebuie configurată cu datele de conexiune la EspoCRM. Apasă tab-ul ⚙ Setări din bara de navigare.

SCREENSHOT — Tab-ul Setări, vedere completă
Setări

Conexiune EspoCRM

CâmpDescriereExemplu
URL serverAdresa completă a serverului EspoCRM, fără slash la finalhttps://192.168.1.10/espocrm
API KeyCheia de API din contul de utilizator EspoCRMa1b2c3d4e5f6...
Modul (entitate)Numele exact al modulului custom unde se salvează scanărileBarcodeScan
Entitate locațiiModulul din EspoCRM care conține lista de locații (opțional)Location
Nume dispozitivUn identificator pentru acest telefon — apare în EspoCRMDepozit 1, Ion P.

Cum obții API Key-ul din EspoCRM

  1. Autentifică-te în EspoCRM ca administrator.

  2. Mergi la Admin → Users și deschide utilizatorul destinat aplicației.

  3. În tab-ul API, apasă Generate API Key.

  4. Copiază cheia generată și introdu-o în câmpul API Key din aplicație.

SCREENSHOT — Generare API Key în EspoCRM
API Key EspoCRM

Opțiuni de comportament

OpțiuneDescriere
Sunet la scanareBip scurt la fiecare scanare reușită. Sunet diferit (mai jos) pentru coduri duplicate.
Scanare continuăCamera rămâne activă după fiecare scanare. Dezactivează pentru a scana câte un cod pe rând.
Auto-sync la conectareTrimite automat scanările pending către aplicația de butelii (EspoCRM) în momentul în care telefonul se conectează la rețeaua internă (intranet).
💡
După completarea setărilor, apasă Testează conexiunea pentru a verifica că aplicația se poate conecta la EspoCRM. Dacă totul e corect, vei vedea mesajul ✓ Conexiune reușită!
03

Cum se scanează

Tab-ul ⬤ Scanare este ecranul principal al aplicației. Conține camera, selectorul de locație și bara de rezultat.

SCREENSHOT — Tab-ul Scanare
Ecran scanare

Pornirea camerei

  1. Apasă butonul ▶ Pornește camera. La prima utilizare, browserul va cere permisiunea de acces la cameră — apasă Permite.

  2. Camera se activează și apare cadrul de vizare (cele 4 colțuri verzi) cu o linie animată de scanare.

  3. Dacă este configurată o entitate de locații, selectează locația curentă din lista derulantă înainte de a scana.

Scanarea unui cod de bare

  1. Ține telefonul la 10–30 cm distanță față de codul de bare.

  2. Centrează codul în cadrul de vizare — linia verde animată trebuie să treacă peste cod.

  3. La detecție reușită: ecranul clipește în verde, se aude un bip scurt, iar codul apare în bara de rezultat de sub cameră.

  4. Scanarea se salvează automat local. Dacă ești conectat la rețea și auto-sync este activ, se trimite imediat la EspoCRM.

SCREENSHOT — Bara de rezultat după o scanare reușită
Rezultat scanare

Coduri duplicate

Dacă scanezi un cod care se află deja în lista de așteptare (pending), aplicația te avertizează:

  • Ecranul clipește în portocaliu în loc de verde
  • Se aude un sunet diferit (mai jos)
  • Bara de rezultat afișează DUPLICAT
  • Codul nu se salvează din nou

Dacă un cod a fost deja sincronizat sau șters din listă, poate fi scanat din nou fără restricții.

Selectarea locației

Dacă în Setări este configurată o entitate de locații, deasupra barei de rezultat apare un selector. Alege locația potrivită înainte de a scana — toate scanările ulterioare vor fi asociate cu acea locație până la schimbarea selecției.

Dacă nu este relevantă o locație, lasă selectat — fără locație —.

Oprirea camerei

Apasă ■ Oprește pentru a dezactiva camera și a economisi bateria. Scanările salvate rămân în memorie.

💡
Formatele suportate: Code 128, Code 39, EAN-13, EAN-8, QR Code, UPC-A, UPC-E, Data Matrix, PDF417, Aztec și multe altele.
04

Gestionare istoric

Tab-ul ☰ Istoric afișează toate scanările salvate local pe telefon, cu statusul fiecăreia.

SCREENSHOT — Tab-ul Istoric cu scanări în diferite stări
Istoric scanări

Statusurile scanărilor

StatusSemnificație
◷ PENDINGSalvată local, în așteptare pentru sincronizare
✓ SYNCEDTrimisă și confirmată de EspoCRM
! ERROREroare la trimitere — va fi reîncercată la următorul sync

Ștergerea unei scanări individuale

Poți șterge o scanare din listă înainte de sincronizare folosind una din două metode:

Metoda 1 — Swipe stânga: Trage elementul spre stânga cu degetul până apare butonul roșu ✕, apoi apasă-l.

Metoda 2 — Tap lung: Ține apăsat pe o scanare timp de ~0.6 secunde. Telefonul vibrează ușor și apare bara de confirmare.

SCREENSHOT — Swipe stânga pentru ștergere
Ștergere scanare

În bara de confirmare care apare în josul ecranului, apasă Șterge pentru confirmare sau Anulează pentru a renunța.

⚠
Ștergerea este definitivă — scanarea dispare din telefon și nu mai poate fi recuperată. Dacă scanarea era deja sincronizată în EspoCRM, înregistrarea din EspoCRM nu se șterge.

Ștergerea scanărilor sincronizate

Butonul ✕ Șterge synced din bara de jos șterge toate scanările cu statusul SYNCED din memorie. Folosește-l periodic pentru a elibera spațiu.

05

Sincronizare cu aplicația de butelii (EspoCRM)

Sincronizarea trimite toate scanările cu statusul PENDING către serverul EspoCRM. Aceasta poate fi automată sau manuală.

Sincronizare automată

Dacă opțiunea Auto-sync la conectare este activată în Setări, aplicația trimite automat scanările pending în momentul în care detectează că telefonul este conectat la rețea.

Indicatorul din colțul din dreapta sus al aplicației arată starea conexiunii:

  • ● ONLINE — conectat, sync automat activ
  • ● OFFLINE — fără rețea, scanările se salvează local

Sincronizare manuală

  1. Mergi în tab-ul ☰ Istoric.

  2. Apasă butonul ⇅ Sincronizează.

  3. Butonul afișează Se sincronizează... pe durata trimiterii.

  4. La final apare un mesaj cu numărul de înregistrări trimise cu succes.

Ce date se trimit către EspoCRM

Pentru fiecare scanare se trimit următoarele informații:

Câmp EspoCRMConținut
name / barcodeValueCodul de bare scanat
scannedAtData și ora exactă a scanării (nu a sincronizării)
barcodeFormatTipul codului: EAN_13, CODE_128, QR_CODE etc.
deviceNameNumele dispozitivului setat în aplicație
deviceInfoModelul telefonului detectat automat
scanLocationLocația selectată la scanare (sau null)
ℹ
Important: Data scanării (scannedAt) este înregistrată în momentul scanării, nu în momentul sincronizării. Poți scana seara și trimite datele a doua zi — ora exactă va fi corectă în EspoCRM.
06

Probleme frecvente

Camera nu pornește sau nu cere permisiunea

Aplicația necesită HTTPS pentru a accesa camera. Verifică că adresa începe cu https://. Dacă ai respins permisiunea anterior, mergi în Chrome → ⋮ → Setări → Setări site → Cameră și permite accesul pentru adresa aplicației.

Codul de bare nu este detectat

Verifică că lumina este suficientă și că codul nu este deteriorat sau reflectorizant. Ține telefonul stabil la 15–25 cm distanță. Dacă codul tot nu este detectat, încearcă să îl centrezi mai bine în cadrul de vizare sau activează lanterna telefonului.

Eroare CORS la testarea conexiunii

Serverul EspoCRM nu trimite headerele necesare pentru acces din browser. Contactează administratorul să verifice fișierul .htaccess sau configurarea serverului web și să adauge headerele Access-Control-Allow-Origin.

Sincronizarea eșuează (status ERROR)

Verifică în ordine: (1) ești conectat la rețeaua locală, (2) URL-ul serverului din Setări este corect, (3) API Key-ul nu a expirat. Dacă problema persistă, verifică cu administratorul că modulul și câmpurile din EspoCRM sunt configurate corect și că drepturile de acces pentru utilizatorul API sunt active.

Lista de locații nu se încarcă

Verifică că în Setări câmpul Entitate locații conține exact numele modulului din EspoCRM (case-sensitive, ex: Location nu location). Asigură-te că utilizatorul API are drepturi de citire asupra acelui modul. După corectarea setărilor, apasă Salvează setările — lista se reîncarcă automat.

Aplicația nu mai afișează modificările după update

Aplicația este stocată în cache de browser. Pentru a forța reîncărcarea: în Chrome mergi la ⋮ → Setări → Confidențialitate și securitate → Șterge datele de navigare, bifează Imagini și fișiere în cache și șterge. Alternativ, adaugă ?v=2 la sfârșitul adresei URL.

Butonul de sincronizare rămâne dezactivat

Reîncarcă pagina (hard refresh). Dacă problema apare des, verifică că nu există erori de rețea care întrerup sincronizarea înainte de finalizare.

07

Procesare automată în aplicația de butelii (ESPO)

După sincronizarea unei scanări, aplicația de butelii (ESPO) procesează automat datele primite. Utilizatorul nu trebuie să facă nimic suplimentar — întregul flux este automat.

Identificarea și mutarea buteliei

La fiecare sincronizare, aplicația de butelii (ESPO) caută butelia scanată în baza de date după codul de bare unic și aplică una din cele două reguli:

SituațieCe face EspoCRM automat
Butelia EXISTĂ Este identificată după cod și mutată în locația specificată la scanare. Mutarea este înregistrată în istoricul buteliei cu timestamp-ul exact al scanării.
Butelia NU EXISTĂ Se creează automat o înregistrare nouă cu tipul de gaz „necunoscut". Butelia nou creată este imediat mutată în locația specificată. Evenimentul este marcat pentru identificare ulterioară.

Istoric complet — chiar înainte de identificare

Un avantaj important al acestui flux: dacă o butelie este scanată înainte de a fi complet înregistrată în sistem (tip gaz, date de expirare, proprietar etc.), toate mutările ei sunt deja salvate. Odată ce datele buteliei sunt completate ulterior de un administrator, istoricul rămâne intact — inclusiv mutările efectuate în perioada în care butelia era „necunoscută".

💡
Nu este necesar să aștepți identificarea completă a unei butelii pentru a o scana. Scanează acum, completează datele mai târziu — istoricul va fi corect și complet.

Utilizare la inventariere

Pe lângă recepții și ieșiri, aplicația poate fi folosită eficient și la inventarieri periodice. Există frecvent situații în care buteliile sunt mutate fizic în regim de urgență, fără actualizarea imediată a bazei de date. Prin scanarea buteliilor la locația lor actuală, sistemul este adus la zi automat — fără introducere manuală de date.

Cazuri de utilizare tipice:

  • Inventariere periodică a depozitului
  • Corectarea locațiilor după mutări de urgență
  • Verificarea prezenței buteliilor la un punct de lucru
  • Reconcilierea stocului fizic cu baza de date
ℹ
La inventariere, asigură-te că selectezi corect locația în selectorul din tab-ul Scanare înainte de a începe scanarea. Toate codurile scanate în acea sesiune vor fi asociate cu locația selectată.