> ## 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.

# Integrare e-Factura ANAF

> Transmite facturi electronic în SPV-ul ANAF prin integrarea nativă e-Factura.

## Prezentare generală

**e-Factura** este sistemul național de facturare electronică administrat de ANAF. Din 2024, transmiterea facturilor B2B în e-Factura este obligatorie pentru toți operatorii economici din România.

Amovio integrează nativ e-Factura — nu ai nevoie de software suplimentar.

## Configurare certificat digital

1. Mergi la **Setări → Integrări → e-Factura**.
2. Încarcă fișierul certificat digital în format `.p12` sau `.pfx`.
3. Introdu parola certificatului.
4. Click **Verifică certificat** — Amovio testează conexiunea cu ANAF.

<Note>
  Doar utilizatorii cu rol **Administrator** pot salva setările e-Factura, iniția conectarea OAuth cu ANAF sau rula **Test conexiune**. Orice utilizator autentificat poate **vedea** statusul conexiunii pe pagina de integrare — util pentru echipe unde contabila verifică starea, iar administratorul face configurarea inițială.
</Note>

<Warning>
  Certificatul digital trebuie să fie emis pe CUI-ul firmei tale și să fie valabil. Certificatele expirate nu sunt acceptate de ANAF.
</Warning>

## Monedă factură

### Clienți din România

Factura transmisă în SPV este **întotdeauna în RON**. La emitere alegi **moneda prețului**:

| Monedă preț | Comportament                                                                                                     |
| ----------- | ---------------------------------------------------------------------------------------------------------------- |
| **RON**     | Introduci direct sumele în lei — fără curs valutar                                                               |
| **EUR**     | Preț de referință în euro; totalul în RON folosește cursul BNR + comisionul configurat în **Setări → Facturare** |

Pe PDF, pentru facturi cu curs salvat:

* totalul în lei este însoțit de echivalentul în euro în paranteză;
* sub totaluri apare linia cursului, de ex. `Curs valutar: 1 EUR = 5.0723 RON (BNR + 1,5%)` sau `(BNR)` când nu există comision.

Vezi [Monedă preț și curs valutar](/platform/invoices#monedă-preț-și-curs-valutar) pentru detalii despre configurare și snapshot-ul salvat la emitere.

### Clienți externi

Factura poate fi în EUR sau USD; TVA se raportează în RON în XML-ul transmis la ANAF.

### Facturi marjă (TVA special)

Folosesc codul de scutire **`VATEX-EU-F`**. Dacă ANAF respinge transmisia, editezi factura și o retransmiți pe același număr (vezi mai jos).

## TVA în XML-ul transmis la ANAF

### Cota implicită

Pentru linii de factură care nu au explicit setată o cotă TVA, Amovio folosește **cota implicită configurată per tenant** în **Setări → Facturare → Cota TVA implicită** (vezi [Cota TVA implicită](/platform/invoices#cota-tva-implicit%C4%83)). Valoarea inițială este **21%** — cota standard din România începând cu 1 august 2025.

Dacă nu este configurată nicio cotă implicită la nivel de tenant, sistemul cade pe `21%` ca ultim resort. Pentru conformitate, recomandăm să persiști întotdeauna `vatRate` pe fiecare linie de factură.

### Facturi cu mai multe cote (TaxSubtotal per cotă)

XML-ul UBL include un bloc `cac:TaxSubtotal` separat pentru fiecare cotă TVA distinctă întâlnită pe linii. Asta acoperă corect scenariile mixte, de exemplu:

* O linie **0% intra-UE** (cod categorie `Z`) + o linie **21% locală** (cod categorie `S`) → două `TaxSubtotal` distincte în XML.
* Linii la **9%** + linii la **21%** pe aceeași factură → grupate per cotă, cu rotunjire la 2 zecimale per grup.

Facturile în **regim marjă** (TVA special, second-hand) folosesc în continuare un singur `TaxSubtotal` cu codul de scutire `VATEX-EU-F` (vezi mai jos).

### Facturi furnizor importate din SPV

La descărcarea facturilor furnizor din SPV-ul ANAF, parserul UBL păstrează **fidel cota TVA primită** — inclusiv `0%` pentru furnizorii neînregistrați în scopuri de TVA sau pentru operațiuni neimpozabile (categoriile UBL `O`, `E`, `Z`, `AE`, `K`, `G`). Aceste linii **nu mai sunt coerciate** la cota implicită — sumele și TVA-ul declarate de furnizor rămân exact așa cum au fost transmise în XML-ul SPV.

## Flux automat de transmitere

După configurare, fluxul este complet automatizat:

1. Emiți factura în Amovio (implicit ciornă; emisiune fiscală din acțiuni).
2. Click **Transmite e-Factura** (sau activează transmitere automată).
3. Amovio validează datele, generează XML UBL 2.1 CIUS-RO și îl trimite la ANAF.
4. ANAF returnează un **număr de înregistrare** și procesează factura.
5. Statusul final apare pe factură: `Validată` sau `Respinsă cu erori` (mesaje Schematron lizibile).

Amovio interoghează ANAF la fiecare **\~2 minute** pentru facturile în status `În așteptare` (`PROCESSING`). Când răspunsul ANAF întârzie peste 24 de ore sau după sute de verificări fără rezultat, echipa de suport este alertată automat — poți reîncărca fișa facturii sau contacta suportul dacă statusul rămâne blocat.

## Stornare și e-Factura

Facturile de stornare (`FACTURA_STORNO`) **nu se transmit automat** la ANAF la creare. După ce generezi storno-ul:

1. Deschide factura de stornare (status `DRAFT` sau `ISSUED`).
2. Click **Transmite e-Factura** — la fel ca pentru orice factură fiscală.

XML-ul UBL include referința la factura originală (numărul documentului stornat), conform cerințelor ANAF pentru note de credit. Statusul e-Factura al facturii originale **nu se modifică** automat — storno-ul este un document fiscal separat.

<Warning>
  Nu uita să transmiți și factura de stornare în SPV. Doar transmiterea facturii originale nu anulează obligația fiscală — note de credit trebuie înregistrate explicit la ANAF.
</Warning>

## Statusuri posibile

| Status         | Descriere                                            |
| -------------- | ---------------------------------------------------- |
| `Nesupusă`     | Factură care nu necesită e-Factura (ex: B2C)         |
| `În așteptare` | Trimisă, în procesare ANAF                           |
| `Validată`     | Acceptată de ANAF                                    |
| `Respinsă`     | Respinsă — verifică mesajul de eroare și retransmite |

## Editare și retransmitere după respingere

Când ANAF respinge o transmisie (status `REJECTED` sau `ERROR`), factura **rămâne editabilă** în Amovio — nu trebuie să emiți un document nou.

### Mesajul de eroare

Blocul de erori de pe pagina facturii afișează verbatim conținutul răspunsului ANAF:

* Mesajele Schematron (`failed-assert`) — regulile CIUS-RO încălcate.
* Câmpul **`observații`** returnat de ANAF — explicația textuală a respingerii (de ex. CUI invalid, adresă incompletă, sector lipsă pentru București).
* Identificatorii ANAF (`id_descarcare`, mesajul de eroare brut din header), folositori pentru suport.

### Fluxul de corecție

1. Pe factura respinsă, click **Editează**.
2. Corectează datele semnalate (de ex. adaugă sectorul pentru un client din București, completează cursul BNR pentru o factură în EUR, ajustează linia pentru o factură storno).
3. Salvează — factura **își păstrează același număr și aceeași serie**. Sistemul nu generează un document nou.
4. Click **Retransmite e-Factura**. Amovio regenerează XML-ul UBL și îl trimite din nou la ANAF.

<Warning>
  Numerotarea fiscală este continuă: nu emite niciodată o factură nouă cu același număr ca una respinsă. Fluxul **editează → retransmite** păstrează intenționat numărul original pentru ca registrul de facturi să rămână conform.
</Warning>

### Ce câmpuri se pot edita pe o factură respinsă

Pe lângă liniile facturii, regimul TVA și termenii de plată, poți modifica:

* Adresa, orașul, județul, sectorul clientului (validate pentru București).
* Adresa furnizorului și IBAN-ul.
* Cursul de schimb pentru facturi EUR către clienți români.
* Vehiculul legat și moneda prețului.

Notele interne și PDF-ul se regenerează automat la salvare.

## Transmitere automată

Activează din **Setări → e-Factura → Transmitere automată** pentru ca orice factură emisă să fie trimisă automat la ANAF fără acțiune manuală.