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

UBL → CII

Converteşte o factură CIUS-RO (UBL 2.1) în UN/CEFACT CII, formatul cerut de partenerii din alte state. Conversia păstrează şi referinţa la factura precedentă, deci nota de credit poate face şi drumul întors.

POST
https://oneapi.ro/api/anaf/v1/interop/ubl-to-cii

Corpul cererii

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

Factură UBL CIUS-RO

efactura.xml application/xml · 4,0 KB — se trimite ca atare, în corpul cererii.

Notă de credit

efactura-stornare.xml application/xml · 3,6 KB — se trimite ca atare, în corpul cererii.

Factură în euro

efactura-intracomunitara.xml application/xml · 4,2 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 o factură CIUS-RO în UBL 2.1 (rădăcină Invoice sau CreditNote) și o convertește în UN/CEFACT CII (Cross Industry Invoice), pe nucleul EN16931 — formatul de factură electronică folosit în Franța (Factur-X), Germania (ZUGFeRD) și în multe schimburi B2B din UE.
  • Se mapează câmpurile de bază: numărul, datele, părțile (vânzător/cumpărător cu adresă, cod fiscal, cod de TVA), liniile (produs, preț, cantitate, TVA) și totalurile pe categorii de TVA. Sumele se preiau din UBL-ul sursă (autoritative), fără recalcul.
  • Zero retenție. XML-ul primit nu se scrie pe disc, nu se loghează și nu intră în chei de cache.

La ce folosește

  • Trimiterea unei facturi românești către un partener european care așteaptă CII / Factur-X.
  • Alimentarea unui sistem care consumă doar UN/CEFACT CII, pornind de la e-Factura.

Structura răspunsului

CâmpTipDescriere
data.standard string Standardul rezultat: CII.
data.schema string Namespace-ul rădăcinii CII.
data.guideline string Ghidul EN16931 declarat în contextul documentului.
data.xml string XML-ul CII generat; text sau base64 după format.
meta.generat_la string Momentul la care s-a construit răspunsul (ISO 8601).

Exemple de răspuns

body: @efactura.xml

POSThttps://oneapi.ro/api/anaf/v1/interop/ubl-to-cii
{
    "data": {
        "standard": "CII",
        "schema": "urn:un:unece:uncefact:data:standard:CrossIndustryInvoice: 100",
        "guideline": "urn:cen.eu:en16931: 2017",
        "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 o factură UBL validă (nici Invoice, nici CreditNote), sau XML invalid.
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 o factură UBL validă (nici Invoice, nici CreditNote), sau XML invalid.",
        "camp": "format",
        "request_id": "0199c1f0-6e1a-7c3d-9b2f-4a8e5d1c7b04"
    }
}