DUKIntegrator: top 10 erori frecvente și cum le rezolvi rapid

1. „Java is not installed" — DUKIntegrator nu pornește

Cauza: Nu este instalat Java Runtime Environment (JRE). DUKIntegrator funcționează cu Java 8 sau superior, dar fișierul .jar trebuie asociat corect.

Soluție: Descarcă de pe java.com și instalează JRE 8 sau mai nou (de preferat OpenJDK 11+). Pentru depanare, lansează manual din linia de comandă cu java -jar DUKIntegrator.jar — orice eroare Java va fi afișată în terminal.

2. „Eroare în linia de comandă" la lansare

Cauza: Calea către fișierul XML conține caractere speciale (diacritice, spații) sau subdirectorul dist nu este în calea corectă.

Soluție: Mută fișierele în C:\dist sau în căi simple (ex. C:\SAF-T). Evită folderele cu diacritice sau cu spații în cale.

3. „Namespace lipsă sau incorect"

Cauza: Namespace-ul din XML nu corespunde cu schema XSD curentă a ANAF (frecvent la versiunile vechi de software de facturare care folosesc URN-uri obsolete).

Soluție: Actualizează namespace-ul rădăcină al documentului UBL la valoarea oficială curentă: urn:oasis:names:specification:ubl:schema:xsd:Invoice-2 pentru facturi și urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2 pentru note de credit. Pentru CIUS-RO, CustomizationID trebuie să fie urn:cen.eu:en16931:2017#compliant#urn:efactura.mfinante.ro:CIUS-RO:1.0.1.

4. „TaxCode invalid" la D406 SAF-T

Cauza: ANAF actualizează periodic lista codurilor de taxă SAF-T. Codurile vechi (ex. 300X–300Y) din unele sisteme contabile nu mai sunt valide.

Soluție: Verifică lista actuală de coduri pe pagina static.anaf.ro. Actualizează-ți nomenclatoarele sau folosește add-in-ul Addlify Finance, care include actualizări automate.

5. „AccountID prezent dar vid" la validare SAF-T

Cauza: În D406 SAF-T, fiecare tranzacție trebuie să aibă un cod de cont contabil din planul de conturi (OMFP 1802/2014). Erorile apar când articolele din nomenclatorul tău nu au asociat un cont contabil sau când câmpul AccountID este transmis ca string gol.

Soluție: Mapează fiecare articol/serviciu la un cont contabil valid (ex. 707 pentru venituri vânzări, 704 pentru servicii prestate, 411 pentru clienți). Asigură-te că AccountID nu este gol, null sau caracterul „-".

6. „Sursă coruptă PDF — NullPointerException"

Cauza: DUKIntegrator are un cache vechi. Ștergerea tokenului și repornirea rezolvă temporar, dar cauza profundă poate fi un fișier incomplet generat.

Soluție: Șterge fișierele din static.anaf.ro/DUKIntegrator/100/ și relansează. Asigură-te că PDF-ul atașat nu este corupt și că signatura electronică este validă.

7. Semnătură electronică (smartcard nedetectat)

Cauza: Pe Windows 64-bit poate apărea un conflict între versiunea de Java (32 sau 64 biți) și driverul smartcard-ului instalat. DUKIntegrator nu „vede" token-ul USB deși acesta este recunoscut de sistem.

Soluție: Folosește o versiune de Java care corespunde driver-ului token-ului (de regulă 64-bit pe Windows 10/11). Verifică valabilitatea certificatului digital calificat (Trans Sped, CertSign, DigiSign, IDPrime). Cu Addlify Finance, transmiterea se face direct prin API-ul SPV ANAF (OAuth2), fără DUKIntegrator și fără bătăi de cap cu Java.

8. „_MULTI_SECT — secțiunea există deja" / „_R_MULTI_SECT" la rectificare

Cauza: Ai încercat să depui o declarație cu un identificator unic deja existent în baza ANAF (același CUI + perioadă + tip declarație). Eroarea „_R_MULTI_SECT" apare similar la rectificative duplicate.

Soluție: Pentru a corecta o declarație depusă, generează o declarație nouă cu tip „R" (rectificativă), NU „D" (inițială). Pentru rectificarea unei rectificative, păstrează tipul „R" și incrementează numărul de înregistrare din Recipisa primită la depunerea anterioară.

9. „Java heap space" / out-of-memory la fișiere SAF-T mari

Cauza: DUKIntegrator alocă implicit memorie limitată pentru JVM. Fișierele SAF-T D406 ale firmelor mari (zeci de mii de tranzacții lunare) depășesc heap-ul standard și aplicația se închide cu java.lang.OutOfMemoryError.

Soluție: Lansează DUKIntegrator cu memorie mărită explicit: java -Xmx4g -jar DUKIntegrator.jar (4 GB heap). Pentru firmele foarte mari, fragmentează SAF-T-ul pe luni în loc de trimestrial.

10. „Versiune DUKIntegrator învechită — actualizează la cea mai recentă"

Cauza: ANAF publică periodic versiuni noi ale DUKIntegrator (de regulă la fiecare 2-3 luni) cu actualizări de scheme XSD, nomenclatoare și reguli de validare. Versiunile vechi resping fișiere valide pentru noile reguli sau acceptă fișiere care vor fi respinse la depunere.

Soluție: Verifică pe static.anaf.ro/static/10/Anaf/Declaratii_R/D406.html versiunea curentă și reactualizează lunar. Mai bine, folosește Addlify Finance care actualizează nomenclatoarele și schemele automat în fundal — nu mai trebuie să urmărești manual versiunile.

Recomandări generale

• Consultă lunar pagina ANAF dedicată DUKIntegrator pentru versiuni noi, nomenclatoare actualizate și fixuri de validare. Erorile persistente care implică interpretări contabile (clasificare cheltuieli, regim TVA) se rezolvă cel mai bine cu un expert contabil acreditat CECCAR.
• Pentru erori repetitive de „CIF invalid", aplică workflow-ul: validare automată CIF la introducere → confirmare ANAF/VIES → depunere → arhivare recipisă. Astfel prinzi erorile înainte să ajungă în XML, nu după respingere.
• Folosește Addlify Finance pentru a elimina nevoia de DUKIntegrator — generare și transmitere directă prin API-ul SPV ANAF, cu validare locală în timp real și recipisă automată.