> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amovio.ro/llms.txt
> Use this file to discover all available pages before exploring further.

# Facturare & e-Factura

> Emite facturi conforme și transmite-le automat în SPV-ul ANAF.

## Prezentare generală

Modulul **Facturi** acoperă întregul ciclu de facturare: de la emitere până la transmiterea electronică în **SPV ANAF** prin integrarea e-Factura.

## Emiterea unei facturi

1. Mergi la **Facturi → Factură nouă** sau deschide un contract finalizat și click **Emite factură**.
2. Alege **Tip document** și **Serie numerotare** (vezi mai jos).
3. Selectează clientul — datele se completează automat din **Contacte**.
4. Adaugă liniile de factură — vezi [Factură cu mai multe linii](#factură-cu-mai-multe-linii) pentru a combina mai multe mașini din stoc și articole manuale pe același document.
5. Pentru clienți din România, alege **moneda prețului** (RON direct sau EUR cu curs BNR) — documentul emis este întotdeauna în RON.
6. Amovio calculează automat TVA-ul și totalul.
7. Click **Emite** — factura primește numărul din serie și data curentă. Dacă opțiunea [Trimite automat pe email la emitere](#setări--facturare) este activă și clientul are email, PDF-ul îi este trimis imediat.

## Factură cu mai multe linii

Pașul **Articole Factură** din `/dashboard/invoices/new` îți permite să adaugi pe aceeași factură combinații de mașini din stoc și articole manuale:

* **Adaugă mașină din stoc** — caută după marcă, model sau VIN și adaugă vehiculul ca linie. Mașinile deja adăugate sunt ascunse din rezultate.
* **Adaugă articol manual** — linie liberă pentru servicii, accesorii sau taxe; descrierile folosite anterior sunt sugerate automat.
* Fiecare linie are propriile **cantitate**, **preț unitar** și **discount procentual**.
* **Moneda prețului** (RON / EUR) și **cursul de schimb** sunt comune pentru toate liniile. Când schimbi moneda, toate prețurile de pe linii sunt reconvertite cu cursul curent.
* Pentru fiecare linie de tip mașină, Amovio reține `carId`-ul, astfel încât regula [Scoaterea mașinii din stoc](#setări--facturare) se aplică separat pentru fiecare vehicul.

Sumarul de jos arată subtotalul, TVA-ul și totalul gross al întregii facturi. Pentru regimul **marjă**, marja este calculată ca diferența dintre suma prețurilor de vânzare ale liniilor de tip mașină și suma prețurilor de achiziție ale acelor mașini (toate convertite în RON).

<Note>
  Sub regimul **marjă (Art. 312)**, dacă oricare dintre mașinile adăugate nu îndeplinește criteriile Art. 266 (sub 6.000 km **sau** sub 6 luni de la prima înmatriculare), apare un avertisment cu lista vehiculelor afectate. Articolele manuale pe o factură în regim marjă afișează un avertisment separat — pentru servicii folosește regimul **Normal** sau **Neplătitor**.
</Note>

## Monedă preț și curs valutar

Pentru clienți din România, documentul emis este **întotdeauna în RON**, dar poți introduce prețurile în lei sau în euro ca referință.

<Tabs>
  <Tab title="Preț în RON">
    Alege **Monedă preț → RON**. Introduci direct sumele în lei — nu se aplică curs valutar, iar PDF-ul și XML-ul e-Factura folosesc exclusiv valorile în RON.
  </Tab>

  <Tab title="Preț în EUR (referință)">
    Alege **Monedă preț → EUR**. Amovio convertește liniile în RON folosind cursul BNR al zilei, plus **comisionul curs** configurat în **Setări → Facturare → Comision curs BNR (%)**.

    La emitere poți ajusta comisionul per factură (0%, 1%, 1,4% sau valoare personalizată). Cursul efectiv este salvat pe factură ca snapshot — modificările ulterioare din setări nu rescriu facturile deja emise.
  </Tab>
</Tabs>

### Unde vezi cursul și comisionul

* **Pe fișa facturii** — panoul valutar arată `1 EUR = X.XXXX RON` și, dacă există comision, procentul aplicat.
* **Pe PDF** — sub totaluri apare linia cursului, de exemplu:
  * `Curs valutar: 1 EUR = 5.0723 RON (BNR + 1,5%)` când comisionul este pozitiv
  * `Curs valutar: 1 EUR = 4.9750 RON (BNR)` când comisionul este 0%
* **Pe echivalentul în EUR** — pentru facturi în RON cu curs salvat, totalul în lei este însoțit de echivalentul în euro în paranteză.

<Note>
  Comisionul implicit vine din **Setări → Facturare → Comision curs BNR (%)** (de ex. `1,5`). Valoarea `0` înseamnă curs BNR pur, fără adaos.
</Note>

### Precompletare dintr-un lead

Când deschizi factura nouă cu `?leadId=<ID>` (de exemplu din fluxul de închidere a unui lead), Amovio precompletează automat clientul și adaugă o linie pentru mașina lead-ului, folosind prețul finalizat al tranzacției (`finalAgreedPrice` → `agreedPrice` → `actualPrice` → `budgetMax` → prețul de catalog). Lead-ul rămâne legat de factură pentru rapoartele de comisionare.

## Cota TVA implicită

Liniile noi de factură preiau cota TVA din **Setări → Facturare → Cota TVA implicită**. Valoarea inițială este **21%** (cota standard în România de la 1 august 2025), dar poate fi schimbată per tenant — de exemplu pe 9% pentru entitățile care emit predominant în cota redusă.

* Cota se aplică automat atunci când adaugi o linie nouă; o poți suprascrie per linie (de ex. 0% pentru livrări intracomunitare, 5% pentru cota super-redusă).
* Aceeași valoare este folosită ca fallback la generarea XML-ului UBL când o linie nu are explicit `vatRate` setat.
* Modificarea setării afectează doar facturile **noi** — facturile deja emise păstrează cotele istorice.

### Facturi cu mai multe cote TVA

O factură poate combina linii cu cote diferite (de ex. o linie 0% intra-UE și o linie 21% locală). În XML-ul UBL transmis la ANAF, Amovio generează automat câte un bloc `cac:TaxSubtotal` per cotă distinctă, cu baza impozabilă și TVA-ul corespunzător. Nu trebuie să faci nimic în plus — gruparea și rotunjirile sunt calculate la emitere.

## Tip document & serie

În primul pas al formularului de factură nouă alegi tipul documentului și seria pe care se emite. Combinația determină automat seria implicită și numărul următor estimat.

### Tipuri disponibile

| Tip                 | Când îl folosești                                                              |
| ------------------- | ------------------------------------------------------------------------------ |
| **Factură fiscală** | Factura standard pentru vânzări de vehicule, servicii sau accesorii            |
| **Proformă**        | Document de ofertă, fără efect fiscal — folosit înainte de încasarea avansului |
| **Avans**           | Factură pentru avansul încasat înainte de livrare                              |
| **Factură finală**  | Factura de regularizare după livrare, care stinge avansurile emise             |

<Note>
  Facturile **storno** nu se creează din **Factură nouă** — deschizi factura emisă și folosești acțiunea **Stornează**. Vezi [Stornare](#stornare).
</Note>

### Serie numerotare

Lista de serii se încarcă dinamic din **Setări → Facturare** și se filtrează după tipul ales. Pentru fiecare serie:

* Seria marcată ca **implicită** se preselectează automat.
* Sub selector apare **numărul următor estimat** în format `<SERIE>-<NNN>` (de ex. `FACT-014`), recalculat când schimbi seria.
* Dacă nu există nicio serie configurată pentru tipul ales, se folosește seria implicită (auto).

Configurează seriile în **Setări → Facturare**:

* Poți avea serii separate pentru vânzări vehicule, servicii, avansuri, proforme.
* Numerotarea este automată și continuă per serie.

## Lista facturilor

În **Facturi** (`/dashboard/invoices`), folosește selectorul **Sortează** din partea de sus a listei pentru a ordona facturile după:

| Criteriu          | Opțiuni                                   |
| ----------------- | ----------------------------------------- |
| **Dată emiterii** | Cele mai noi / cele mai vechi             |
| **Scadență**      | Cele mai apropiate / cele mai îndepărtate |
| **Sumă**          | Crescător / descrescător                  |
| **Număr factură** | A→Z / Z→A                                 |
| **Client**        | A→Z / Z→A                                 |

Când mai multe facturi au aceeași valoare pe criteriul ales (de ex. aceeași dată de emitere), Amovio le ordonează în mod **stabil și previzibil** — nu se amestecă la reîncărcarea paginii sau la schimbarea paginii.

<Tip>
  Combină sortarea cu filtrele de status și căutarea după client sau număr pentru a găsi rapid facturile neîncasate cu scadență apropiată.
</Tip>

## Setări → Facturare

În afară de serii, pagina **Setări → Facturare** controlează comportamentul automat al modulului de facturare. Setările se aplică pentru toți utilizatorii tenantului.

### Comision curs BNR

* **Locație:** Setări → Facturare → *Comision curs BNR (%)*
* **Implicit:** `0` (curs BNR pur)
* **Efect:** la facturi cu **monedă preț EUR**, cursul efectiv = curs BNR + procentul configurat. Valoarea se precompletează la emitere și se salvează pe factură; apare pe PDF ca `(BNR + X%)` sau `(BNR)` când comisionul este zero.
* Poți suprascrie comisionul per factură în formularul de emitere/editare, înainte de salvare.

### Trimite automat pe email la emitere

* **Locație:** Setări → Facturare → *Trimite automat pe email la emitere*
* **Implicit:** activ
* **Efect:** când emiți o factură (`DRAFT` → `ISSUED`), Amovio trimite automat pe emailul clientului un mesaj de pe contul agenției, cu PDF-ul facturii atașat și **reply-to** pe agentul care a emis documentul.
* Dacă trimiterea reușește, factura trece în status `SENT`; dacă livrarea eșuează (server SMTP, adresă invalidă), factura rămâne `ISSUED` și eșecul este înregistrat în timeline ca `email_failed` — o poți retrimite manual cu acțiunea **Trimite pe email** din fișa facturii.
* Dialogul **Emite factura** arată adresa exactă pe care va fi expediat documentul, iar **Trimite pe email** afișează emailul real al clientului și este dezactivat dacă nu există o adresă pe fișa de contact.

Dezactivează această opțiune dacă vrei să confirmi manual fiecare expediție.

### Scoaterea mașinii din stoc

* **Locație:** Setări → Facturare → *Scoaterea mașinii din stoc*
* **Opțiuni:**
  * **La emiterea facturii** (`ON_ISSUE`, implicit) — mașina este marcată ca **vândută** în momentul emiterii facturii și retrasă automat de pe Autovit.
  * **La încasarea integrală** (`ON_PAYMENT`) — mașina rămâne pe stoc până când factura este achitată complet; abia atunci este marcată vândută și depublicată de pe Autovit.
* Regula se aplică **per linie de factură de tip mașină** — pe o factură multi-line cu mai multe mașini, fiecare vehicul este procesat individual pe baza `carId`-ului liniei.
* La **plata integrală** a unei facturi, tranzacția (lead-ul) legată este închisă automat (status `COMPLETED`, `closedAt` setat la momentul plății), indiferent de modul ales mai sus.

<Tip>
  Folosește **La încasarea integrală** dacă vinzi frecvent în consignație sau cu avans întins pe mai multe săptămâni — vehiculul rămâne vizibil cumpărătorilor până când banii intră efectiv.
</Tip>

## Căutare globală (Cmd+K)

Facturile emise apar în paleta de comenzi globală sub grupul **Facturi**. Apasă <kbd>Cmd</kbd>+<kbd>K</kbd> (sau <kbd>Ctrl</kbd>+<kbd>K</kbd>) din orice ecran și caută după:

* numărul complet al facturii (de ex. `FACT-014`)
* seria sau numărul separat
* numele clientului
* notele de pe factură

Rezultatele afișează clientul, totalul, moneda și statusul (Ciornă, Emisă, Plătită, Stornată) și deschid factura selectată. Pentru a găsi o factură după **VIN**, **număr de înmatriculare** sau **CUI**, caută mașina sau clientul corespunzător — factura este accesibilă din panoul lor.

## Editare ciornă

Facturile în status **`DRAFT` (ciornă)** pot fi editate complet — inclusiv câmpurile blocate anterior:

* **Data facturii**
* **Client** (cu actualizare automată a adresei, orașului, județului pentru conformitate e-Factura)
* **Furnizor** (cu actualizare IBAN, oraș, județ)
* **Vehicul legat** — schimbi mașina sau dezlegi factura de orice vehicul

În plus poți modifica liniile, regimul TVA, moneda prețului și termenii de plată. Salvarea regenerează automat totalurile și PDF-ul.

<Note>
  Facturile emise (`ISSUED`) care nu au fost încă trimise la e-Factura pot fi de asemenea editate. Pentru facturile **respinse de ANAF**, vezi [Editare și retransmitere după respingere](/integrations/efactura#editare-și-retransmitere-după-respingere).
</Note>

### Ștergerea unei ciorne

Facturile în status **`DRAFT` (ciornă)** pot fi șterse definitiv din lista de facturi:

1. În rândul facturii, deschide meniul de acțiuni (`⋯`).
2. Click **Șterge ciorna** — confirmă în dialogul de avertizare.

Acțiunea este disponibilă **doar pentru ciorne** — facturile emise (`ISSUED`), plătite sau stornate nu se șterg. Ștergerea este definitivă și nu poate fi anulată; pentru o factură deja emisă folosește [Stornare](#stornare).

## Transmitere e-Factura (ANAF SPV)

Dacă certificatul digital este configurat:

1. Pe factura emisă, click **Transmite e-Factura**.
2. Amovio generează XML-ul în format UBL 2.1 și îl semnează digital.
3. XML-ul este transmis automat în **SPV-ul ANAF**.
4. Statusul se actualizează în timp real: `În așteptare` → `Validată` / `Respinsă`.

<Warning>
  Facturile respinse de ANAF pot fi editate și **retransmise pe același număr** — nu emite o factură nouă cu același număr. Vezi [Integrare e-Factura](/integrations/efactura#editare-și-retransmitere-după-respingere).
</Warning>

## Stornare

Pentru a storna o factură:

1. Deschide factura și click **Stornează**.
2. Amovio generează automat factura de stornare cu sumele negative, din seria configurată pentru stornări.
3. Ambele facturi sunt transmise în e-Factura.

## Facturi de comision (consignație)

Lead-urile de tip consignație generează un tip special de factură: **factura de comision** către proprietarul mașinii, emisă în faza de decontare.

**Când o emiți:** după ce mașina a fost vândută cumpărătorului (lead-ul a ajuns în faza **Decontare**) și înainte să marchezi plata către proprietar.

**Cum o emiți:** din tab-ul **Închidere** al lead-ului, apasă **Finalizează cu proprietarul** — dialogul **ConsignmentSettlement** generează factura de comision pre-completată cu:

* Clientul = proprietarul mașinii (vânzătorul din lead)
* Linie = comisionul calculat ca `preț vânzare × cotă comision`
* Suma de plată către proprietar = `preț vânzare − comision`

După emitere, dialogul îți permite să marchezi plata către proprietar drept efectuată, iar lead-ul trece în faza **Finalizată**.

Vezi [Lead-uri de consignație](/platform/leads#lead-uri-de-consignație) pentru fluxul complet.

## Facturi multi-linie (mai multe vehicule)

O singură factură poate combina **mai multe vehicule** cu **articole manuale** (servicii, accesorii) și **discount-uri per linie**:

* Adaugă oricâte linii de tip vehicul (fiecare cu `carId` propriu) plus linii libere.
* Discount-urile aplicate pe o linie sunt declarate ca `AllowanceCharge` în XML-ul UBL (conform BR-CO-04 / CIUS-RO).
* La emitere și la încasare, **toate vehiculele referite pe factură** (atât header cât și linii) sunt dezactivate automat conform `carDeactivationTrigger` din **Setări → Facturare**.
* Previzualizarea de margine se calculează însumat pe toate liniile de tip vehicul; warning-ul Art. 266 apare per vehiculul care îl declanșează.

## Export și rapoarte

* Export PDF, XML (UBL) sau CSV pentru contabil.
* Raport lunar sumar: total facturi, TVA colectat, facturi neîncasate.
