Cannot find the declaration of element X (FACT1 vs FCN)

Ce înseamnă

Validatorul XML încearcă să verifice fișierul împotriva unei scheme XSD, dar nu găsește o declarație pentru elementul rădăcină din XML. Pe scurt: schema și documentul nu corespund.

Pe validatorul online ANAF (anaf.ro/uploadxml/), eroarea apare cel mai des sub forma:

Cannot find the declaration of element 'CreditNote'.

…când utilizatorul a încărcat un XML de tip CreditNote (notă de credit / storno) dar a selectat FACT1 din dropdown-ul "Alegeți standardul" în loc de FCN.

Cauze frecvente

• Confuzia FACT1 vs FCN — cel mai frecvent scenariu. FACT1 corespunde schemei UBL Invoice (factură obișnuită, cod tip 380 sau 384). FCN corespunde UBL CreditNote (storno, cod tip 381). Sunt scheme XSD diferite.
• Namespace declarat greșit în XML — ex: <Invoice xmlns="...:CreditNote-2"> combină rădăcina Invoice cu namespace-ul CreditNote
• XML generat manual fără respectarea structurii UBL

Cum se rezolvă

1. Verifică elementul rădăcină din XML:
   • <Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"> → folosește FACT1
   • <CreditNote xmlns="urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2"> → folosește FCN
2. Asigură-te că namespace-ul corespunde rădăcinii. Cele două nu pot fi amestecate.
3. Folosește validatorul nostru la /validare-xml-efactura — detectează automat tipul documentului și aplică schema corectă, fără dropdown.

De ce există acest dropdown

UBL 2.1 definește scheme XSD separate pentru Invoice, CreditNote, și alte ~80 de tipuri de documente. Validatorul ANAF nu deduce singur tipul din conținut — îți cere să-l declari prin parametrul standard (în API) sau prin dropdown (în UI). Pentru e-Factura interesează doar două:

Trimitere către SPV

Dacă încărci XML-ul prin API-ul SPV (/upload), parametrul URL ?standard=UBL corespunde FACT1, iar ?standard=CN corespunde FCN. Aplicațiile noastre (și majoritatea programelor de facturare) detectează automat tipul și trimit parametrul corect.