oneapi
Autentificare
Anaf v1 / Interop (CII / Factur-X)

Extrage din Factur-X

Scoate XML-ul de factură încorporat într-un PDF Factur-X sau ZUGFeRD şi spune în ce profil a fost găsit. Pentru facturile primite ca un singur fişier PDF.

POST
https://oneapi.ro/api/anaf/v1/interop/facturx-extract

Corpul cererii

Corpul cererii e documentul întreg, trimis brut (Content-Type: application/pdf) — nu un obiect cu câmpuri.

PDF Factur-X

factura-x.pdf application/pdf · 54,3 KB — se trimite ca atare, în corpul cererii.

PDF-ul unei stornări

factura-x-stornare.pdf application/pdf · 53,9 KB — se trimite ca atare, în corpul cererii.

PDF în profil BASIC

factura-x-intracomunitara.pdf application/pdf · 54,8 KB — se trimite ca atare, în corpul cererii.

Parametri de interogare

NumeTipDescriereValori acceptate
formatopțional text Forma XML-ului întors: xml (implicit) sau base64. ex. base64

Cum se comportă

  • Documentul se poate trimite şi ca fişier: multipart/form-data cu câmpul fisier (curl -F fisier=@document.xml), în locul corpului brut. Conţinutul fişierului devine corpul cererii, deci rezultatul e identic; opţiunile rămân în query string, iar alt câmp de formular lângă fisier dă 422 camp_necunoscut.
  • Primește octeții unui PDF Factur-X / ZUGFeRD / XRechnung (un PDF/A-3 cu un atașament XML de factură) și întoarce XML-ul de factură încorporat — de regulă CII, uneori UBL. Detectează și formatul găsit.
  • Extragerea merge în două straturi: întâi atașamentele PDF, apoi, dacă e nevoie, un scan direct al stream-urilor /EmbeddedFile, cu dezarhivare FlateDecode.
  • Nu construim PDF-uri Factur-X — încorporarea XML-ului într-un PDF/A-3 e în afara scopului acestui toolkit. Aici doar despachetăm.
  • Zero retenție: PDF-ul primit nu se scrie și nu se loghează.

La ce folosește

  • Scoaterea facturii structurate dintr-un PDF Factur-X primit prin email, ca s-o poți valida sau converti mai departe.
  • Un prim pas înainte de CII → UBL: extragi CII-ul din PDF, apoi îl convertești în CIUS-RO.

Structura răspunsului

CâmpTipDescriere
data.format_detectat string Formatul XML-ului extras: CII, UBL sau necunoscut.
data.xml string XML-ul de factură extras; text sau base64 după format.
meta.generat_la string Momentul la care s-a construit răspunsul (ISO 8601).

Exemple de răspuns

body: @factura-x.pdf

POSThttps://oneapi.ro/api/anaf/v1/interop/facturx-extract
{
    "data": {
        "format_detectat": "CII",
        "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<rsm:CrossIndustryInvoice xmlns:rsm=\"urn:un:unece:uncefact:data:standard:CrossIndustryInvoice: 100\" xmlns:ram=\"urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity: 100\" xmlns:udt=\"urn:un:unece:uncefact:data:standard:UnqualifiedDataType: 100\" xmlns:qdt=\"urn:un:unece:uncefact:data:standard:QualifiedDataType: 100\">\n  <rsm:ExchangedDocumentContext>\n    <ram:GuidelineSpecifiedDocumentContextParameter>\n      <ram:ID>urn:cen.eu:en16931: 2017</ram:ID>\n    </ram:GuidelineSpecifiedDocumentContextParameter>\n  </rsm:ExchangedDocumentContext>\n  <rsm:ExchangedDocument>\n    <ram:ID>FCT-2026-0142</ram:ID>\n    <ram:TypeCode>380</ram:TypeCode>\n    <ram:IssueDateTime>\n      <udt:DateTimeString format=\"102\">20260910</udt:DateTimeString>\n    </ram:IssueDateTime>\n  </rsm:ExchangedDocument>\n  <rsm:SupplyChainTradeTransaction>\n    <ram:IncludedSupplyChainTradeLineItem>\n      <ram:AssociatedDocumentLineDocument>\n        <ram:LineID>1</ram:LineID>\n      </ram:AssociatedDocumentLineDocument>\n      <ram:SpecifiedTradeProduct>\n        <ram:Name>Servicii de consultanţă</ram:Name>\n      </ram:SpecifiedTradeProduct>\n      <ram:SpecifiedLineTradeAgreement>\n        <ram:NetPriceProductTradePrice>\n          <ram:ChargeAmount>100.00</ram:ChargeAmount>\n        </ram:NetPriceProductTradePrice>\n      </ram:SpecifiedLineTradeAgreement>\n      <ram:SpecifiedLineTradeDelivery>\n        <ram:BilledQuantity unitCode=\"H87\">2</ram:BilledQuantity>\n      </ram:SpecifiedLineTradeDelivery>\n      <ram:SpecifiedLineTradeSettlement>\n        <ram:ApplicableTradeTax>\n          <ram:TypeCode>VAT</ram:TypeCode>\n          <ram:CategoryCode>S</ram:CategoryCode>\n          <ram:RateApplicablePercent>21</ram:RateApplicablePercent>\n        </ram:ApplicableTradeTax>\n        <ram:SpecifiedTradeSettlementLineMonetarySummation>\n          <ram:LineTotalAmount>200.00</ram:LineTotalAmount>\n        </ram:SpecifiedTradeSettlementLineMonetarySummation>\n      </ram:SpecifiedLineTradeSettlement>\n    </ram:IncludedSupplyChainTradeLineItem>\n    <ram:IncludedSupplyChainTradeLineItem>\n      <ram:AssociatedDocumentLineDocument>\n        <ram:LineID>2</ram:LineID>\n      </ram:AssociatedDocumentLineDocument>\n      <ram:SpecifiedTradeProduct>\n        <ram:Name>Licenţă software anuală</ram:Name>\n      </ram:SpecifiedTradeProduct>\n      <ram:SpecifiedLineTradeAgreement>\n        <ram:NetPriceProductTradePrice>\n          <ram:ChargeAmount>500.00</ram:ChargeAmount>\n        </ram:NetPriceProductTradePrice>\n      </ram:SpecifiedLineTradeAgreement>\n      <ram:SpecifiedLineTradeDelivery>\n        <ram:BilledQuantity unitCode=\"H87\">1</ram:BilledQuantity>\n      </ram:SpecifiedLineTradeDelivery>\n      <ram:SpecifiedLineTradeSettlement>\n        <ram:ApplicableTradeTax>\n          <ram:TypeCode>VAT</ram:TypeCode>\n          <ram:CategoryCode>S</ram:CategoryCode>\n          <ram:RateApplicablePercent>21</ram:RateApplicablePercent>\n        </ram:ApplicableTradeTax>\n        <ram:SpecifiedTradeSettlementLineMonetarySummation>\n          <ram:LineTotalAmount>500.00</ram:LineTotalAmount>\n        </ram:SpecifiedTradeSettlementLineMonetarySummation>\n      </ram:SpecifiedLineTradeSettlement>\n    </ram:IncludedSupplyChainTradeLineItem>\n    <ram:ApplicableHeaderTradeAgreement>\n      <ram:SellerTradeParty>\n        <ram:Name>Exemplu Furnizor SRL</ram:Name>\n        <ram:PostalTradeAddress>\n          <ram:LineOne>Str. Memorandumului 28</ram:LineOne>\n          <ram:CityName>Cluj-Napoca</ram:CityName>\n          <ram:CountryID>RO</ram:CountryID>\n          <ram:CountrySubDivisionName>RO-CJ</ram:CountrySubDivisionName>\n        </ram:PostalTradeAddress>\n        <ram:SpecifiedTaxRegistration>\n          <ram:ID schemeID=\"VA\">RO990000005</ram:ID>\n        </ram:SpecifiedTaxRegistration>\n      </ram:SellerTradeParty>\n      <ram:BuyerTradeParty>\n        <ram:Name>Exemplu Client SRL</ram:Name>\n        <ram:PostalTradeAddress>\n          <ram:LineOne>Calea Victoriei 1</ram:LineOne>\n          <ram:CityName>SECTOR1</ram:CityName>\n          <ram:CountryID>RO</ram:CountryID>\n          <ram:CountrySubDivisionName>RO-B</ram:CountrySubDivisionName>\n        </ram:PostalTradeAddress>\n        <ram:SpecifiedTaxRegistration>\n          <ram:ID schemeID=\"VA\">RO990000072</ram:ID>\n        </ram:SpecifiedTaxRegistration>\n      </ram:BuyerTradeParty>\n    </ram:ApplicableHeaderTradeAgreement>\n    <ram:ApplicableHeaderTradeDelivery/>\n    <ram:ApplicableHeaderTradeSettlement>\n      <ram:InvoiceCurrencyCode>RON</ram:InvoiceCurrencyCode>\n      <ram:ApplicableTradeTax>\n        <ram:CalculatedAmount>147.00</ram:CalculatedAmount>\n        <ram:TypeCode>VAT</ram:TypeCode>\n        <ram:BasisAmount>700.00</ram:BasisAmount>\n        <ram:CategoryCode>S</ram:CategoryCode>\n        <ram:RateApplicablePercent>21</ram:RateApplicablePercent>\n      </ram:ApplicableTradeTax>\n      <ram:SpecifiedTradePaymentTerms>\n        <ram:DueDateDateTime>\n          <udt:DateTimeString format=\"102\">20261010</udt:DateTimeString>\n        </ram:DueDateDateTime>\n      </ram:SpecifiedTradePaymentTerms>\n      <ram:SpecifiedTradeSettlementHeaderMonetarySummation>\n        <ram:LineTotalAmount>700.00</ram:LineTotalAmount>\n        <ram:TaxBasisTotalAmount>700.00</ram:TaxBasisTotalAmount>\n        <ram:TaxTotalAmount currencyID=\"RON\">147.00</ram:TaxTotalAmount>\n        <ram:GrandTotalAmount>847.00</ram:GrandTotalAmount>\n        <ram:DuePayableAmount>847.00</ram:DuePayableAmount>\n      </ram:SpecifiedTradeSettlementHeaderMonetarySummation>\n    </ram:ApplicableHeaderTradeSettlement>\n  </rsm:SupplyChainTradeTransaction>\n</rsm:CrossIndustryInvoice>\n"
    },
    "meta": {
        "generat_la": "2026-10-06T23: 59: 44+03: 00"
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422xml_invalidCorpul nu e un PDF valid, sau PDF-ul nu conține un XML de factură încorporat (factura_x_fara_xml).
429cota_depasitaCota lunară a planului a fost depăşită (vezi Retry-After).

Erorile modulului Anaf au acelaşi plic ca restul platformei, cu două câmpuri în plus: {eroare: {cod, mesaj, camp, request_id}}. eroare.cod e stabil şi e cel după care ramifici în cod; la validare (422) codul e specific cazului: xml_invalid, xml_nu_e_factura, unitate_necunoscuta, luna_invalida ş.a. camp arată câmpul vinovat, când se poate identifica.

{
    "eroare": {
        "cod": "xml_invalid",
        "mesaj": "Corpul nu e un PDF valid, sau PDF-ul nu conține un XML de factură încorporat (factura_x_fara_xml).",
        "camp": "format",
        "request_id": "0199c1f0-6e1a-7c3d-9b2f-4a8e5d1c7b04"
    }
}