Trimiterea în RO e-Factura

Cum pleacă o factură

O factură emisă ajunge în SPV pe unul din trei drumuri:

• La cererea ta: POST …/documents/{document_id}/submit, sau "submit": true la creare.
• Automat, după emitere, dacă firma are în aplicație trimiterea imediată.
• Programat, la câteva ore după emitere, dacă firma are trimiterea amânată (rămâne timp de corecturi). efactura.scheduled_at spune când.

Modul firmei îl vezi în efactura.submit_mode al firmei și îl schimbi din aplicație. Proformele, persoanele fizice neînscrise în registrul RO e-Factura și firmele din afara României nu trimit nimic (efactura.applies este false).

Stările

ANAF răspunde de obicei în câteva minute, uneori în câteva ore. Noi verificăm răspunsul periodic și îți trimitem evenimentul; nu e nevoie să întrebi în buclă.

O factură respinsă

O factură respinsă se corectează cu PATCH (de exemplu județul clientului) și se trimite din nou cu /submit, cu același număr. Dacă firma trimite automat, după corectare intră singură în programul de trimitere. Fiecare încercare rămâne în efactura.history.

Termenul legal este de 5 zile lucrătoare de la emitere, în efactura.deadline.

Înainte de trimitere

POST …/validate construiește XML-ul și îl trece prin validatorul ANAF, fără să-l trimită. Merge și pe ciorne. checked_by_anaf este false când validatorul ANAF nu a răspuns și s-a făcut doar verificarea noastră.

XML-ul și răspunsul ANAF

• GET …/xml: XML-ul UBL 2.1, CIUS-RO, cum pleacă (sau a plecat) spre ANAF.
• GET …/efactura/zip: arhiva descărcată din SPV după procesare, cu XML-ul și semnătura electronică a Ministerului Finanțelor, sau cu erorile. Este dovada transmiterii.

Firma și ANAF

Trimiterea merge prin conexiunea ANAF a firmei, făcută o dată în aplicație de cine are certificatul digital cu drepturi SPV pe firmă (sau de contabil, printr-un link). Fără ea, /submit răspunde:

• 409 company_not_verified: firma nu a fost încă verificată (nimeni nu a conectat-o la ANAF);
• 409 anaf_not_connected: firma e verificată, dar conexiunea a expirat sau a fost revocată; o reface cineva din aplicație;
• 409 efactura_not_applicable: firma nu trimite în RO e-Factura.

efactura.connected din GET /companies/{company_id} îți spune dinainte dacă trimiterea va merge.

Facturi trimise din alte programe

Dacă firma trimite facturi în SPV și din alt program, le preluăm din SPV ca documente ("source": "spv"), cu numărul lor, liniile, totalurile și plata la emitere. Le citești, le descarci în PDF și XML și le înregistrezi încasările, dar nu le modifici și nu le trimiți. Cele noi vin cu evenimentul document.imported.

Referința

{ "object": "validation", "valid": false, "checked_by_anaf": true, "errors": ["[BR-RO-100] Localitatea cumpărătorului este obligatorie."] }

Obiectul EfacturaState

Unde e documentul în RO e-Factura.

Obiectul Validation

Verificarea XML-ului înainte de trimitere.