# Aplicația clientului

Pe lângă POS-ul folosit de personal, Chappa are și o **aplicație pentru client** — aplicația **Chappa** de pe telefonul oaspeților (gratuită, din App Store / Google Play). Ca să comande la o anumită masă, clientul **scanează din aplicație codul QR** al mesei, iar de acolo poate: să **comande singur**, să **învârtă ruleta cu premii** și să **încarce o poză** care apoi apare pe nota de plată. Tu nu instalezi nimic pe telefoanele lor — tot ce ține de aplicație îl **scoți și-l gestionezi din POS și din backoffice**. Acest capitol arată exact partea ta: cum **scoți codurile QR**, cum **apar comenzile** trimise din aplicație, cum **configurezi ruleta** și cum **printezi poza** clientului pe notă.

> Chappa POS · https://chappa.ro/manual/aplicatie-client/

## Ce este aplicația clientului

Aplicația clientului este aplicația **Chappa**, de pe **telefonul oaspetelui** (gratuită, din App Store / Google Play). Ca să comande la masa lui, clientul **scanează codul QR al mesei din aplicație**. De acolo poate comanda, se poate juca la ruletă și poate încărca o poză pentru nota lui.

Din punctul tău de vedere (al personalului) sunt **patru lucruri** de știut, fiecare cu secțiunea lui mai jos:

- **Codurile QR** — cum le scoți din POS și de ce sunt legate de masă (vezi [Codurile QR](https://chappa.ro/manual/aplicatie-client/coduri-qr/)).
- **Comenzile din aplicație** — cum apar la tine și ce faci cu ele (vezi [Comenzile din aplicație](https://chappa.ro/manual/aplicatie-client/comenzi-app/)).
- **Ruleta cu premii** — campanii și premii, configurate din backoffice (vezi [Ruleta cu premii](https://chappa.ro/manual/aplicatie-client/ruleta-despre/)).
- **Poza pe notă** — clientul încarcă o poză, tu o printezi (sau nu) pe bon (vezi [Poza clientului pe notă](https://chappa.ro/manual/aplicatie-client/poza-nota/)).

> **Capitolul e scris din perspectiva personalului**  
> Aici documentăm doar ce vezi și faci **tu**, din POS și din backoffice. Ecranele propriu-zise ale aplicației de pe telefonul clientului nu fac obiectul acestui manual.  

> **Sfat**  
> Dă click pe orice captură din acest manual ca să o mărești.  


## Codurile QR (cum le scoți din POS)

Fiecare masă are **propriul cod QR**. Clientul îl scanează din aplicația **Chappa** ca să se „lege” de masa lui. Codul îl scoți din **ecranul mesei** din [POS](https://chappa.ro/manual/pos/ecran-masa/), cu butonul **Print Code** din bara de sus — el **tipărește codul QR la imprimanta termică**, pe un bon pe care îl dai clientului.

![Butonul Print Code în bara ecranului de masă](https://chappa.ro/manual/media/img/aplicatie-client/qr-button.png)
*Bara de sus a ecranului unei mese: butonul **Print Code** (cu pictograma de cod QR) tipărește codul mesei.*

Pe bon scrie tot ce-i trebuie clientului: numele mesei, mesajul **„Comandă direct din aplicație!”** și codul QR de scanat.

1. Deschide masa în [POS](https://chappa.ro/manual/pos/ecran-masa/).
2. Apasă **Print Code** — codul QR al mesei se tipărește la imprimanta termică.
3. Dă bonul clientului. El deschide aplicația **Chappa** și scanează codul de pe bon ca să ajungă pe masa lui.

> **Scanarea se face din aplicație**  
> Codul se scanează **din aplicația Chappa**. Dacă cineva îl scanează fără aplicație (de ex. cu camera telefonului), e trimis în **App Store / Google Play** ca să instaleze întâi aplicația **Chappa**.  

> **De reținut**  
> Codul QR se tipărește la imprimanta termică configurată pentru postul respectiv, ca orice alt bon.  


## Un cod nou pentru fiecare masă

Codul QR este **legat de masa** pentru care l-ai scos și este **regenerat de fiecare dată** când îl tipărești. Asta e intenționat: comenzile date prin acel cod ajung **exact pe acea masă**, iar codul e gândit să fie scos proaspăt, la nevoie.

- Scoate codul **per masă** — nu folosi un singur cod pentru tot localul.
- Tipărește un cod **proaspăt la fiecare client/vizită**. Așa, un cod vechi (fotografiat de cineva) nu rămâne bun la nesfârșit.
- Pentru că e legat de masă, nu are sens să fie pus public (pe site, pe rețele) — atunci oricine ar putea „comanda de acasă”. Scopul codului este să fie scanat **la masă**.

> **De ce retipărești codul**  
> Codul este conceput să țină comanda **ancorată la masă**, nu să fie un link permanent de comenzi online. Tipărind unul nou pentru fiecare client, eviți situația în care cineva refolosește un cod vechi ca să trimită comenzi de la distanță.  


## Comenzile din aplicație

Când un client comandă din aplicație de la masa lui, **masa se aprinde portocaliu** pe hartă — semnalul că are o comandă nouă din aplicație, care te așteaptă.

![Harta sălii cu o masă aprinsă portocaliu](https://chappa.ro/manual/media/img/aplicatie-client/app-order-map.png)
*Harta sălii: „Masa 9” are conturul portocaliu aprins — semn că a venit o comandă din aplicație.*

### Ce găsești când deschizi masa

Deschizi masa și vezi produsele comandate de client adunate în ****Buffer**** — zona de pregătire a comenzii. Ele **nu au plecat încă** la preparare; așteaptă să le verifici și să apeși **Trimite**.

![Ecranul unei mese cu o comandă din aplicație în Buffer](https://chappa.ro/manual/media/img/aplicatie-client/app-order-table.png)
*Ecranul „Masa 9”: berile comandate din aplicație (1 Bere Tuborg + 2 Bere Heineken) așteaptă în Buffer, cu butonul **Trimite**. Tot ecranul mesei e încadrat portocaliu cât timp comanda e neconfirmată.*

De aici încolo merge exact ca o comandă pe care ai adăuga-o tu: vezi [Buffer-ul](https://chappa.ro/manual/pos/buffer/) și [stările unei comenzi](https://chappa.ro/manual/pos/stari-comanda/). **Nimic nu ajunge la bucătărie până nu apeși **Trimite**** — deci controlul rămâne la tine: poți confirma, modifica sau șterge produse înainte.

> **Tu confirmi, nu clientul**  
> Comanda din aplicație e o **propunere** a clientului, adunată în Buffer. Personalul o verifică și o trimite. Așa eviți comenzi greșite sau glume — nimic nu pleacă la preparare fără confirmarea ta.  

> **Nu confunda cu „Comenzi Externe”**  
> Comanda dată din aplicație **la masă** (cea descrisă aici) e diferită de comenzile de **livrare prin Glovo/Wolt**, care apar în panoul separat [Comenzi externe](https://chappa.ro/manual/pos/comenzi-externe/). Una e oaspetele de la masa ta, cealaltă e o comandă de livrare.  


## Ruleta cu premii

**Ruleta cu premii** este o roată pe care clientul o învârte din aplicație și poate câștiga un premiu mic. Nu e un joc de noroc — e un **instrument de marketing**: premii mici și gratuite care încurajează clientul să mai comande și să se distreze.

### Unde o configurezi

Din **meniul principal**, apasă **Ruleta cu premii** (disponibilă de la **nivelul de acces 2**). Se deschide pagina **„Campanii Ruletă”**: în stânga roțile campaniilor existente, în dreapta editorul campaniei selectate.

![Pagina de campanii a ruletei](https://chappa.ro/manual/media/img/aplicatie-client/ruleta-overview.png)
*Pagina „Campanii Ruletă”: în stânga campaniile (ca roți), în dreapta editorul campaniei selectate. O campanie gri, cu eticheta „INACTIVĂ”, nu apare clienților.*

O campanie definește **când** se poate juca ruleta, **în ce zone**, **ce premii** are și **cu ce șanse**. Poți avea mai multe campanii și le activezi/dezactivezi după nevoie.


## Crearea și setarea unei campanii

Apasă **+ Adaugă Campanie** ca să creezi una nouă, sau **click pe o roată** din stânga ca să editezi una existentă. La crearea unei campanii noi vezi întâi și **regulile** premiilor.

![Fereastra de adăugare a unei campanii](https://chappa.ro/manual/media/img/aplicatie-client/ruleta-add.png)
*Fereastra „Adaugă Campanie Nouă”: caseta cu regulile premiilor, apoi câmpurile campaniei și butoanele **Anulează** / **Creează Campania**.*

### Câmpurile campaniei

![Editorul unei campanii de ruletă](https://chappa.ro/manual/media/img/aplicatie-client/ruleta-editor.png)
*Editorul unei campanii: nume, activă, disponibilitate, zone, condiții (sumă minimă, timp de așteptare), premiile și distribuția șanselor.*

- **Nume** — Numele campaniei (pentru tine, ca s-o recunoști în listă).
- **Campanie Activă** — Bifată = campania e disponibilă clienților. Debifată = apare gri, cu „INACTIVĂ”, și **nu** ajunge în aplicație.
- **Disponibilitate** — Când se poate juca. Implicit **„Activ mereu”**; apeși butonul ca să stabilești intervale orare pe zile (vezi mai jos).
- **Se aplică pe toate zonele** — Bifată = în tot localul. Debifată = apare lista zonelor și alegi exact zonele în care merge ruleta (vezi [Zone](https://chappa.ro/manual/gestiuni-produse-zone/zone-rvc/)).
- **Suma minimă cheltuită (RON)** — Cât trebuie să fi consumat masa ca să poată învârti o dată.
- **Timp așteptare (minute)** — Câte minute trebuie să aștepte clientul între două învârtiri.

### Disponibilitatea pe ore și zile

Apăsând **„Activ mereu / Apasă pentru a modifica perioadele”** se deschide selectorul de program: alegi ziua (Lun–Dum) și pe banda de 24 de ore marchezi intervalul în care e activă campania.

![Selectorul de disponibilitate al campaniei](https://chappa.ro/manual/media/img/aplicatie-client/ruleta-availability.png)
*Selectorul de disponibilitate: zilele săptămânii sus, banda de 24 de ore dedesubt (verde = activ). Poți copia setările de pe o zi pe alta.*

### Salvarea

La o campanie nouă apeși **Creează Campania**. La modificări pe campanii existente apeși **Salvează Modificările** din capul paginii (o campanie modificată e marcată până salvezi).


## Premiile și șansele

Premiile unei campanii și **șansa** fiecăruia se setează în secțiunea **„Premii Campanie”** din editor (partea de jos a capturii din [secțiunea anterioară](https://chappa.ro/manual/aplicatie-client/ruleta-campanie/)).

### Regulile premiilor

- Între **1 și 3 produse** câștigătoare per campanie.
- Șansa **colectivă** de câștig a produselor ≥ **30%**.
- Șansa **minimă per produs** = **10%**.

### Cum adaugi premii

La **„Adaugă Premiu”** scrii ca să cauți un produs și apeși **Adaugă Produs**. Produsele vin din [meniul tău](https://chappa.ro/manual/gestiuni-produse-zone/produse-meniu/). Pe lângă produse, ai două premii speciale:

- **Include „Aplauze”** — Premiu special: **aplauze în boxele barului** când clientul îl câștigă (un moment de distracție, fără cost).
- **Include „Nimic”** — Permite ca un client **să nu câștige nimic** la o învârtire — felia „Nimic” pe roată.

Sub premii, bara **„Distribuția Șanselor”** arată proporțiile. Trage de marginile segmentelor ca să schimbi procentul fiecărui premiu; suma trebuie să fie 100%.

> **Exemple de campanii**  
> **(1)** Un furnizor de bere îți sponsorizează premiile → pui berea lui ca premiu, șansă 30–40%, restul „Nimic”. **(2)** „Peste 50 lei consumație” (sumă minimă 50) → o învârtire pentru un desert sau o cafea gratis. **(3)** Doar la happy-hour → setezi disponibilitatea pe intervalul 17:00–19:00 și o zonă anume.  

> **De reținut**  
> Ruleta e marketing, nu pariuri: premiile sunt mici și gratuite, iar scopul e să anime clienții și să încurajeze comenzile — exact ce scrie și în caseta de reguli la crearea campaniei.  


## Poza clientului pe notă

Clienții pot **încărca o poză** din aplicație, iar tu o poți **tipări pe nota lor de plată**. E o funcție opțională, de distracție.

### Cum o activezi

Din **meniul principal**, **Notă de plată și bon** → coloana **Configurare** → bifează **„Permite clienților să încarce o poză pe nota de plată folosind aplicația.”**

![Opțiunea de a permite poza clientului pe notă](https://chappa.ro/manual/media/img/aplicatie-client/nota-config.png)
*Opțiunea care permite clienților să încarce o poză pe notă (în pagina „Notă de plată și bon”).*

### Cum apare la tipărirea notei

Când tipărești [nota](https://chappa.ro/manual/pos/nota/) unei mese pentru care clientul a încărcat o poză, POS-ul te întreabă **„Printează imaginea clientului?”**:

![Întrebarea: Printează imaginea clientului?](https://chappa.ro/manual/media/img/aplicatie-client/nota-photo-prompt.png)
*Întrebarea de la tipărirea notei: **Da** = poza apare pe bon; **Nu** = bonul iese fără poză.*

- **Da** — Poza se include **pe nota de plată**, sub total.
- **Nu** — Nota se tipărește **fără** poză.

Poza este pregătită automat pentru imprimanta termică (alb-negru, contrast ajustat). Apare pe **nota HTML**; pe bonul simplu (text) se menționează doar că poza e disponibilă pe nota HTML.

> **De reținut**  
> Întrebarea apare **doar** dacă opțiunea e activată și clientul chiar a încărcat o poză pentru acea masă. Altfel, nota se tipărește normal, fără să te întrebe nimic.  


## Întrebări frecvente

**Poate clientul să comande „de acasă” cu un cod vechi?**

Codul e legat de masă și se regenerează la fiecare tipărire, iar el e gândit să fie scanat la masă. Scoate un cod proaspăt pentru fiecare client/vizită și nu publica niciun cod — așa eviți comenzile de la distanță.

**Comanda din aplicație intră direct la bucătărie?**

Nu. Ajunge în [Buffer](https://chappa.ro/manual/pos/buffer/) pe masa respectivă și pleacă la preparare doar când personalul apasă **Trimite**.

**Cum știu că a venit o comandă din aplicație?**

Masa se aprinde **portocaliu** pe hartă, iar la deschiderea ei produsele apar în Buffer.

**Ruleta e joc de noroc?**

Nu — e marketing. Premii mici, gratuite, menite să anime clienții și să încurajeze comenzile.

**Câte premii pot pune la o campanie?**

Între 1 și 3 produse, cu o șansă colectivă de minim 30% și minim 10% fiecare. Opțional adaugi „Aplauze” și „Nimic”.

**Ce înseamnă premiul „Aplauze”?**

Când clientul îl câștigă, pornesc aplauze în boxele barului — un moment de distracție, fără cost.

**De ce nu mă întreabă POS-ul de poză când tipăresc nota?**

Fie opțiunea „Permite clienților să încarce o poză…” nu e bifată în **Notă de plată și bon**, fie clientul nu a încărcat nicio poză pentru acea masă.

**Unde văd comenzile de livrare (Glovo, Wolt)?**

Acelea nu sunt comenzi „de la masă” din aplicație, ci comenzi externe — apar în panoul [Comenzi externe](https://chappa.ro/manual/pos/comenzi-externe/) din POS.

**Trebuie clientul să instaleze ceva?**

Da — aplicația **Chappa** (gratuită, din App Store / Google Play). Codul QR al mesei se scanează **din aplicație**. Dacă cineva îl scanează fără aplicație (cu camera telefonului), e trimis în store ca să instaleze întâi Chappa.