Bon nou

Pagina Bon nou îți permite, ca operator, să compui și să printezi un bon fiscal direct din back-office, fără să folosești aplicația Android. Alegi un dispozitiv conectat, adaugi articolele și plățile, apeși Printează bon, iar bonul este trimis la imprimantă prin conexiunea cu cloud-ul.

Folosește pagina când nu ai telefonul la îndemână, când vrei să emiți mai multe bonuri la rând de la birou sau când îți testezi integrarea cap-la-cap.

Deschide pagina

Din lista Bonuri, apasă + Nou în colțul din dreapta sus. Formularul se deschide la /portal/receipts/new.

Poți și să salvezi URL-ul ca favorit — nu sunt necesari parametri.

Alege dispozitivul țintă

Bara laterală din dreapta listează toate imprimantele revendicate de organizația ta, împreună cu statusul lor live.

Un dispozitiv poate fi selectat doar dacă este online și are un controller alocat. Dispozitivele care nu îndeplinesc una dintre condiții apar totuși în dropdown, dar sunt dezactivate, cu un badge care explică motivul:

• Offline — imprimanta nu este accesibilă.
• Deconectat de la WebSocket — controllerul și-a pierdut conexiunea live cu cloud-ul.
• Ocupat — pe dispozitiv rulează deja o altă comandă.
• Status de eroare — imprimanta a raportat o eroare hardware sau fiscală.
• Niciun controller alocat — niciun controller nu a revendicat încă dispozitivul.

Compune bonul

Alege tipul de bon

Alege una dintre opțiuni:

• Vânzare (Sale) — bon de vânzare normal (implicit).
• Restituire (Refund) — restituire pentru o vânzare anterioară.
• Storno — anularea unei vânzări anterioare.

Formularul arată la fel pentru toate trei; cloud-ul rutează diferit fiecare tip către AMEF.

Adaugă articole

Fiecare rând reprezintă o linie pe bon:

Apasă + Adaugă articol pentru un rând nou sau pictograma de coș pentru a-l elimina. Există întotdeauna cel puțin un rând — ultimul nu poate fi șters, doar golit.

Adaugă plăți

Fiecare rând de plată stabilește o metodă și o sumă:

• Numerar (Cash)
• Card
• Tichet (Voucher)
• Credit
• Altă metodă (Other)

Împarte un bon pe mai multe metode adăugând mai multe rânduri (de exemplu, 50 RON numerar + 30 RON card). Suma plăților trebuie să fie egală exact cu totalul bonului — formularul nu acceptă o nepotrivire.

Verifică totalurile

Formularul afișează totalul curent și o defalcare TVA pe cote, pe măsură ce tastezi. Ambele sunt recalculate de cloud la printare, așa că nu trebuie să rotunjești manual.

Printează bonul

Când formularul este valid, apasă Printează bon.

Rezolvă erorile frecvente

Cunoaște limitele

• Un singur dispozitiv pe bon. Nu poți trimite același bon către mai multe imprimante simultan din formular.
• Doar online. Portalul are nevoie de conexiune la rețea ca să printeze. Pentru vânzări offline, folosește aplicația Android — pune bonurile în coadă local și le sincronizează la reconectare.
• Fără ciorne. Închiderea tab-ului sau reîncărcarea paginii golește formularul. Tot ce nu ai printat se pierde.
• Doar bonuri anonime. Formularul din Portal nu expune câmpuri pentru client sau CIF. Pentru un bon nominal cu CIF, apelează API-ul direct (vezi mai jos).
• Reduceri pe întreg bonul nu sunt suportate din formular. Aplică reducerile pe linie.
• Fără expediere programată. Bonurile se printează imediat la apăsarea butonului.

Trimite bonuri din propriul tău software

Tot ce face pagina Bon nou este disponibil și prin API-ul HTTP e-bon. Pentru a emite bonuri din POS-ul, ERP-ul sau scripturile tale, trimite o comandă print_receipt către dispozitiv:

POST /api/v1/devices/{deviceId}/commands
Authorization: Bearer <token-api>
Idempotency-Key: <cheie-unică-per-bon>
Content-Type: application/json

{
  "type": "print_receipt",
  "payload": {
    "type": "sale",
    "operatorId": "1",
    "items": [
      { "name": "Cafea", "quantity": 2, "price": 12.50, "vatRate": 19, "department": 0 }
    ],
    "payments": [
      { "method": "card", "amount": 25.00 }
    ]
  }
}

Cloud-ul validează payload-ul, recalculează totalurile și defalcarea TVA pe server și transmite comanda controllerului. Aceleași reguli de idempotență, validare și evenimente de status se aplică indiferent dacă cererea vine din Portal, din aplicația Android sau din propria ta integrare.

Vezi /api/receipts pentru referința completă a payload-ului, Idempotență pentru comportamentul la reîncercare și WebSocket de evenimente pentru a primi statusul comenzilor în propria ta interfață.

Continuă explorarea

• Bonuri — răsfoiește, filtrează și inspectează bonurile anterioare.
• Dispozitive — asociază imprimante și verifică statusul lor live.
• Operațiuni fiscale — rulează rapoarte X/Z, încasări și retrageri din Portal.
• /api/receipts — emite bonuri programatic din propriul tău software.