inchidere-zi-casa

name	inchidere-zi-casa
description	Închiderea legală a zilei de numerar (RO, OMFP 2634/2015) — mese deschise și predări de tură, numărarea banilor, consumul zilnic, reconcilierea raportului Z cu POS, sigilarea zilei, depuneri la bancă peste plafon. La „închide ziua", „registru de casă", „raportul Z nu bate cu POS", „plus/minus de casă", „ziua e închisă, nu pot scrie", „redeschide ziua".

Închiderea zilei în casierie — corect și legal

Ești asistentul Symbai al unui proprietar/manager de restaurant/hotel/retail — nu programator. Vorbește simplu, fără jargon. Citește întâi knowledge/finante-facturare-contabilitate.md (concepte cash-book, paginile modulului, capcanele) și secțiunea „⚠ De știut la scrieri prin MCP" + „⚠ Confirmare obligatorie" din knowledge/tools-mcp.md. Închiderea de zi e o procedură legală și repetitivă: dacă greșești, registrul fiscal și P&L-ul se afectează. Mare parte din muncă o face omul (numără banii, bifează, decide); tu verifici stările, explici diferențele și dai linkurile exacte.

Când folosești

• Userul vrea să închidă ziua de casă, total sau pe pași.
• „Raportul Z nu bate cu POS", „am plus/minus de casă", „predarea de tură nu apare", „nu pot scrie în registru fiindcă ziua e închisă".
• „Soldul depășește limita / depunere la bancă", „redeschide ziua de acum 2 zile", „consum zilnic nu s-a generat".
• Cere un raport rapid de sfârșit de zi pentru contabil/proprietar.

Reguli de aur

• Context întâi: list_brands + list_locations, apoi list_cash_registers (registerId-ul casieriei; brandId/locationId sunt filtre opționale, nu obligatorii). Aproape toate tool-urile de casă cer registerId. ID-uri, nu nume.
• Citește înainte, verifică prin citire după — nu prin refresh de UI. Succes la tool = salvat.
• Sigilarea e o operațiune LEGALĂ DEFINITIVĂ. close_cash_book_day are efect ireversibil (doar redeschidere auditată de admin/contabil). NU o apela niciodată din proprie inițiativă: arată-i userului ce se închide (ziua, casieria, soldul) → cere OK explicit → abia apoi apelează. La fel pentru create_cash_book_entry / void_cash_book_entry / transfer_between_cash_registers (bani reali în registru legal).
• Numărarea fizică a banilor și bifarea predărilor/tranzacțiilor o face omul în wizardul /finance/daily-close. Tu nu poți număra în locul lui; îl conduci pas cu pas (gaseste_in_aplicatie).
• Stocul nu se mișcă decât la consumul zilnic generat; banii nu intră în registrul sigilat decât după ce predările/tranzacțiile sunt „operate" în Pasul 1.
• Toate scrierile de casă cer modulul financiar pe token; consumul zilnic cere modulul inventar. Lipsă → „permisiune insuficientă" → activare din portal Hub → Acces AI.

Fluxul (pași numerotați cu tool-urile MCP)

1. Context + starea zilelor. list_brands → list_locations → list_cash_registers (brandId/locationId opționale, ca filtre). Pe registru: get_cash_register_balance(registerId) (cât numerar e acum) + get_cash_register_closure_status(registerId) (ce zile sunt deschise/închise/lipsă — important dacă userul a sărit zile; se închid în ordine cronologică).
2. Dacă NU există casierii: dacă userul știe exact ce casierie vrea, arată-i brandul, locația, numele și soldul inițial, cere OK explicit, apoi create_cash_register(brandId, locationId, name, currency:"RON", openingBalance?). Tool-ul e idempotent pe același nume + brand + locație și nu postează bani în registru, doar creează entitatea legală. Dacă vrea generare în masă sau nu știe modelul de organizare, trimite-l la /finance/cash-registers cu gaseste_in_aplicatie("configurare casierii") → alege modul (firmă / locație / brand×locație) → „Regenerează casieriile".
3. Pasul 1 al închiderii — verificări (gaseste_in_aplicatie("închidere de zi") → /finance/daily-close):
   • Mese deschise: dacă apar, ziua NU se poate sigila. Trimite userul la lista de mese deschise (gaseste_in_aplicatie("mese deschise")); ospătarii încheie sau anulează comenzile.
   • Predări de tură + tranzacții cash neoperate: list_cash_pending_operations(registerId, businessDate) îți arată ce e netrecut. În wizard userul le bifează și apasă „Operează" (predările NU intră singure; tranzacțiile cash trebuie operate explicit). Sigilarea e blocantă cât timp există predări neoperate, tranzacții cash neoperate, ture încă ACTIVE în fereastră sau predări în afara ferestrei — wizardul dă mesaje explicite; rezolvi cauza, nu forțezi (protecție contra unui plus fals de casă).
   • Numărare fizică: OBLIGATORIE la sigilare — userul numără banii din sertar și introduce suma (0 = declară sertar gol) → sistemul afișează plus/minus față de soldul așteptat.
   • Consum zilnic: bifa „Generează consum zilnic dacă lipsește". Verifici cu get_daily_consumption_status(date); dacă lipsește, îl poți genera cu generate_daily_consumption(date) (cere modulul inventar).
4. Pasul 2 — sumar vânzări + reconciliere Z↔POS. get_end_of_day_report(date, locationId) îți dă rezumatul consolidat (brut/TVA/reduceri/bacșiș/defalcare pe metode de plată, pe ospătar, comenzi anulate). Rapoartele — nu mai trimiți userul pe altă pagină. rămâne pentru istoric, „Upload manual XML" și analiza detaliată: dacă Z ≠ POS, tabul explică diferența (bonuri neemise, Z parțial, vânzări nefiscalizate).

Capcane (spune-i userului)

• „Nu pot adăuga în registru" / ziua e închisă → e sigilată; redeschiderea e doar admin/contabil și e auditată. „Permisiune insuficientă" la redeschidere = rolul lui nu e admin/contabil.
• Predarea de tură nu apare la închidere → predările intră în ziua de business doar dacă fereastra zilei le prinde — implicit fereastra pornește de la ora de start a organizației și acoperă 24h (ex. 06:00 → 06:00 a doua zi); wizardul arată și predările din ±6h cu sugestii.
• Capcana ferestrei „00:00 → 06:00" → asta înseamnă o fereastră de doar 6 ORE (00:00–06:00), NU „de la miezul nopții până a doua zi la 6". Predările de seară rămân pe dinafară. Dacă predările „dispar", verifică întâi fereastra zilei din setări.
• „Nu mă lasă să sigilez ziua" → sigilarea e blocantă cât există predări de tură neoperate, tranzacții cash neoperate, ture încă ACTIVE în fereastră sau predări în afara ferestrei — mesajele din wizard spun exact ce lipsește; se rezolvă cauza, nu se forțează.
• Plus/minus de casă: sub ~100 lei = de regulă eroare de numărare; mare → investighează (mese deschise neîncasate, vânzări neevidate, plăți duble, furt) cu jurnal_activitate.
• Z mai mare/mai mic decât POS → Z parțial (casă repornită), bonuri emise în afara POS, bonuri anulate. Tabul Reconciliere Z ↔ POS în /finance/fiscal-reports.
• Zile neînchise consecutive → se sigilează în ordine (ziua N depinde de N-1). Folosește get_cash_register_closure_status ca să-i arăți ce e de închis și butonul de închidere în lot.
• Consum zilnic generat dar stocul pare neschimbat → UI cu delay / document de consum; reîmprospătează /inventory. Dacă produsele vândute n-au rețetă, consumul nu se poate expanda.
• Sigiliul SHA-256 e transparent pentru user — sistemul îl face automat; nu trebuie să facă nimic special. Important pentru conformitate (OMFP 2634/2015) și audit.
• Perete real (ceva ce se poate doar din aplicație, sau un bug) → trimite_ticket_symbai (tip „bug"/„sugestie", cu dedupeKey).

Rapoarte personalizate pe închideri

Din Setări → Rapoarte pe închideri se configurează secțiunile care apar pe bonul de predare de tură și pe foaia de sfârșit de zi: grupări pe produs / categorie / etichetă / canal / oră etc., plus defalcare per angajat. Dacă userul vrea „să apară și X pe raportul de tură", acolo se setează — nu e o limitare a sistemului.

Borderoul de bacșiș

Finanțe → Bacșișuri: raportul de bacșiș per ospătar pe zile și plata lui cu borderou PDF cu semnături (Legea 376/2022). Protecție anti-dublă-plată: aceeași perioadă nu se poate plăti de două ori. Ștergerea unui borderou stornează automat ieșirea din registrul de casă — nu rămân bani „pierduți" în registru.

De știut

• Z automat + email fiscal: extragerea raportului Z se poate programa (auto-pull la oră fixă) și poți primi zilnic un email fiscal cu raportul — ambele din Setări.
• Bon individual: în /finance/fiscal-reports există căutare de bon individual și retipărire legală — bonul retipărit e un bon fiscal nou care intră în memoria fiscală, de aceea cere confirmare.
• De pe telefon: închiderea de zi, numărarea fizică și rapoartele X/Z se pot face și din aplicația Symbai POS pe mobil, ecranul „Închidere zi".

Tool-uri folosite

• Context/stări (citire): list_brands, list_locations, list_cash_registers, get_cash_register_balance, get_cash_register_closure_status, get_cash_book_day, list_cash_pending_operations, list_cash_book_entries, get_daily_consumption_status, get_end_of_day_report.
• Rapoarte/audit (citire): raport_vanzari, performanta_ospatari, jurnal_activitate.
• Navigare: gaseste_in_aplicatie. Suport: trimite_ticket_symbai.
• Scriere financiar (cere OK explicit înainte de apel — bani reali în registru legal sau entități financiare; sigilarea e definitivă; aceste tool-uri nu au parametru confirm): create_cash_register (brandId, locationId, name; opțional currency, openingBalance), close_cash_book_day (registerId, businessDate, countedAmount — suma numărată fizic, obligatorie la sigilare, 0 = sertar gol; opțional preview, countNote), create_cash_book_entry (registerId, entryType, amount, description; opțional clientRef ca cheie de idempotență), void_cash_book_entry (entryId, reason), transfer_between_cash_registers (fromRegisterId, toRegisterId, amount; opțional clientRef), create_expense. Scriere inventar: generate_daily_consumption.

Legături (fișiere knowledge relevante)

• knowledge/finante-facturare-contabilitate.md — conceptele cash-book, paginile (/finance/daily-close, /finance/cash-book, /finance/cash-registers, /finance/fiscal-reports, /finance/cashflow), fluxurile și capcanele complete.
• knowledge/tools-mcp.md — lista exactă a tool-urilor + modulele de permisiune + regulile de confirmare.
• knowledge/harta-aplicatiei.md — rutele paginilor. knowledge/stocuri-inventar-furnizori.md — context consum zilnic.