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

# Loturi plată furnizori (XML bancă)

> Generează fișiere pain.001 pentru plăți în lot către furnizori — conturi multi-valută, RON domestic, Raiffeisen.

## Prezentare generală

Modulul **Facturi furnizori** permite aprobarea facturilor primite (SPV sau manuale) și generarea unui **lot de plată** exportabil ca XML pentru banca (format ISO 20022 `pain.001.001.03`).

Flux tipic:

1. Sincronizezi / încarci facturi furnizor.
2. Aprobi facturile eligibile.
3. Selectezi facturile și creezi **Lot plată**.
4. Descarci XML-ul și îl încarci în internet banking (ex. Raiffeisen ValidateFin / plăți).

## Configurare — Setări → Facturare

### Conturi bancare plată (ordonator)

Adaugă câte un cont per valută:

| Câmp     | Exemplu                             |
| -------- | ----------------------------------- |
| Monedă   | RON, EUR                            |
| IBAN     | contul firmei pentru plăți          |
| BIC      | opțional (se poate deduce din IBAN) |
| Implicit | contul folosit la pre-fill în lot   |

La generarea lotului, debitorul (firma ta) se pre-completează din contul potrivit monedei lotului.

### Reguli XML plată

| Setare                      | Recomandat Raiffeisen RON | Descriere                                                           |
| --------------------------- | ------------------------- | ------------------------------------------------------------------- |
| `ChrgBr`                    | **SLEV**                  | Comisioane plătite de beneficiar (cerință Raiffeisen)               |
| `svcLvlRon`                 | **URGP**                  | Transfer domestic RON                                               |
| `svcLvlEur`                 | **SEPA**                  | Plăți EUR                                                           |
| `domesticEurToRon`          | **dezactivat**            | Nu converti EUR→RON automat în XML (doar pentru OCR false positive) |
| `allowMixedCurrencyBatches` | dezactivat                | Un lot = o singură valută                                           |

<Warning>
  După deploy sau schimbare setări, **regenerează** loturile vechi — XML-urile generate anterior pot avea `SLE` sau monedă greșită.
</Warning>

## Contacte furnizor (PJ)

Pe contactele **Persoană juridică** poți seta **Conturi plată furnizor** (RON/EUR). Dacă factura din SPV nu are IBAN, lotul îl rezolvă din:

1. IBAN pe factură
2. Conturi plată pe contact (potrivit monedei)
3. IBAN principal pe contact (doar RON)

### CUI duplicat

La creare contact PJ sau căutare ANAF, dacă **CUI-ul există deja**, apare dialog:

* **Folosește existentul** — nu se creează duplicat
* **Suprascrie datele** — actualizează contactul existent
* **Anulează**

## Plăți parțiale

Poți plăti o factură în mai multe tranșe:

* La **Creează lot**, coloana **De plată acum** este editabilă (implicit = restul de plată).
* După **Finalizează** lot, suma se înregistrează pe factură (`Plătit` / `Rest`).
* Status **Parțial plătită** până când restul ajunge la 0 → apoi **Plătită**.
* Aceeași factură poate intra în loturi noi până la stingerea restului (nu în două loturi nefinalizate simultan).

În detaliu factură → tab **Istoric Plăți** vezi fiecare alocare și lotul asociat.

## Creare lot

1. **Facturi furnizori** → selectează facturi **Aprobate** sau **Parțial plătite** cu rest > 0 și IBAN/contact.
2. Facturile deja într-un lot **nefinalizat** nu pot fi selectate din nou.
3. **Creează lot** → verifică IBAN debitor, sume parțiale, dată execuție, denumire.
4. Descarcă XML din lista de loturi.

La aprobarea facturii, **Note aprobare** (opțional) apar în XML ca **Informații suplimentare** la bancă; descrierea plății rămâne `Plata facturii {serie} {număr}`.

### Validări la generare

* Aceeași valută în lot (implicit)
* IBAN debitor în lista de conturi configurate (dacă ai conturi definite)
* IBAN creditor valid
* Factura nu e deja într-un alt lot

## Verificare XML (checklist)

Înainte de upload la bancă:

| Element         | Așteptat RON domestic                                                                                  |
| --------------- | ------------------------------------------------------------------------------------------------------ |
| `EndToEndId`    | referință factură, **max 16 caractere alfanumerice** (plăți ≤ 50.000 RON); **max 11 cifre** peste prag |
| `ChrgBr`        | `SLEV`                                                                                                 |
| `DbtrAcct/Ccy`  | `RON`                                                                                                  |
| `InstdAmt/@Ccy` | `RON`                                                                                                  |
| `SvcLvl/Cd`     | `URGP`                                                                                                 |
| `CtrlSum`       | suma liniilor (fără facturi test cu 0)                                                                 |

<Note>
  Regulile pentru plăți în lei urmează ghidul [ARB pain.001.001.03 RON](https://www.arb.ro/en/structura-mesajului-client-banca-isoxml_pain-001-001-03-in-ron-2/). Din 14 mai 2026, varianta `pain.001.001.09` este standardul actualizat — verifică cu banca ta dacă acceptă încă `.03`.
</Note>

<Note>
  Formatul generat este `pain.001.001.03`. Unele bănci acceptă și varianta `.09` — dacă ValidateFin cere explicit v09, contactează suportul pentru upgrade planificat.
</Note>

## Depanare

| Problemă                             | Cauză probabilă                        | Acțiune                                         |
| ------------------------------------ | -------------------------------------- | ----------------------------------------------- |
| EUR în XML la factură RON            | Lot vechi sau `domesticEurToRon` activ | Regenerează lot; dezactivează conversie EUR→RON |
| `SLE` respins                        | Setare veche                           | `ChrgBr` = `SLEV` în setări + lot nou           |
| IBAN furnizor lipsă                  | SPV fără IBAN                          | Leagă contact PJ sau editează IBAN pe factură   |
| Lot respins sumă 0                   | Factură test `amount=0`                | Scoate factura din lot                          |
| `EndToEndId` duplicat la a 2-a plată | Aceeași factură, lot nou               | Sistemul adaugă sufix `P2`, `P3`… automat       |

## Rapoarte

* **Analize & Cheltuieli** → KPI **Rest de plată**
* **Export resturi CSV** — `GET /v1/supplier-invoices/reports/outstanding`
* Filtru listă: **Cu rest de plată**