transformare/FACT1 — XML în PDF oficial

transformare/FACT1 este serviciul ANAF care transformă XML-ul unei facturi din e-Factura în PDF. PDF-ul arată la fel ca reprezentarea pe care o vede un inspector, pentru că îl face chiar ANAF din XML-ul original — nu un program străin care l-ar afișa altfel.

Numele provine direct de la serviciul oficial RO e-Factura: /transformare/FACT1. ANAF nu returnează niciodată o factură gata tipărită; din SPV cobori întotdeauna un XML structurat în formatul UBL. PDF-ul pe care îl folosești zilnic este o reprezentare vizuală generată din acel XML — iar transformare/FACT1 este exact serviciul care o produce.

Ce face, mai exact

Serviciul primește conținutul XML al unei facturi și returnează PDF-ul corespunzător. Serviciul cunoaște două tipuri de document: FACT1 pentru facturi și FCN pentru notele de credit. Conversia este unidirecțională: din XML poți regenera oricând PDF-ul, dar dintr-un PDF nu poți reconstrui XML-ul cu valoare legală. De aceea fișierul pe care îl păstrezi cu adevărat rămâne XML-ul, iar PDF-ul îl poți reface oricând din el.

De ce PDF-ul rezultat este „oficial”

Diferența esențială față de un convertor terț este cine face randarea. Aici, randarea o face însuși serviciul ANAF, din același XML pe care ANAF îl consideră original. Rezultatul este reprezentarea standard, care arată la fel cu cea pe care o vede un inspector — nu o variantă cu alt aspect, generată de un program necunoscut. Singura precizare oficială ține de validare: pentru un XML netrecut prin validare, ANAF avertizează că nu garantează corectitudinea PDF-ului. În practica preluării automate, fiecare XML pe care îl transformăm provine deja din ANAF, deci nu există acest risc.

Cu sau fără autentificare

ANAF expune transformare/FACT1 în două forme. Varianta publică, fără autentificare, rulează pe serverul webservicesp.anaf.ro și este cea pe care o folosește convertorul nostru gratuit: încarci un XML, primești PDF-ul oficial, fără cont. Varianta protejată prin OAuth rulează pe api.anaf.ro și este cea integrată în fluxul automat, alături de descărcarea facturilor din SPV. Ambele variante produc același PDF.

Unde apare în fluxul de preluare automată

Când o factură primită este coborâtă din SPV, ANAF returnează o arhivă cu XML-ul original și semnătura electronică a Ministerului Finanțelor — niciodată un PDF. Pasul imediat următor este transformare/FACT1: din XML generăm PDF-ul oficial, pe care îl arhivăm alături de original. Practic, fiecare factură pe care o vezi ca PDF lizibil în arhiva din Google Drive a trecut prin acest serviciu. Capcana de fundal rămâne aceeași ca la întregul flux: ANAF ține XML-ul descărcabil din SPV doar aproximativ 60 de zile, deși obligația ta de arhivare este de 5 ani — de aceea conversia și arhivarea trebuie să se întâmple la timp, automat.

← Înapoi la dicționarul e-Factura