Mediul de test ANAF — testare vs. producție

Mediul de test ANAF este versiunea „de probă” a API-urilor e-Factura/SPV, ținută separat de mediul real. Aici un program își poate verifica integrarea — trimite, primește și procesează facturi — fără niciun efect fiscal: documentele de test nu au valoare legală și nu ajung la destinatari reali. Facturile adevărate circulă exclusiv prin mediul de producție.

Pe scurt, ANAF rulează două copii ale acelorași sisteme: una de testare, pentru ca dezvoltatorii să-și pună la punct integrarea fără să strice nimic, și una de producție, unde se petrec lucrurile reale. Aceeași logică se regăsește la web service-urile ANAF: fiecare serviciu are o adresă de test și una de producție, iar un program comută între ele schimbând doar adresa de bază. Pentru utilizatorul final, mediul de test este invizibil — toate facturile lui reale trec prin producție.

La ce folosește mediul de test

Mediul de test există ca să poți greși fără consecințe. Înainte ca un program să atingă facturile reale, integrarea trebuie verificată pe scenarii ca:

• autentificarea prin OAuth ANAF și reînnoirea cheilor de acces;
• trimiterea unui XML și citirea ID-ului de încărcare returnat;
• preluarea răspunsului — recipisa de acceptare sau de respingere;
• tratarea codurilor de eroare când factura nu trece de validare;
• listarea mesajelor și descărcarea fișierelor, exact ca în fluxul real.

Tot pe acest teren de probă se rezolvă și validarea structurii XML, de pildă cu DUK Integrator, instrumentul ANAF care verifică local dacă factura respectă schema înainte să fie trimisă mai departe.

Test vs. producție — ce se schimbă

Diferența nu stă în cum arată fluxul, ci în consecințe. Adresele API diferă — de regulă o cale care conține /test/ și una care conține /prod/ — însă pașii rămân aceiași. Ce se schimbă cu adevărat este efectul:

• În test, o factură primește un ID de încărcare și o recipisă în sistemul de probă, dar nu produce efecte fiscale și nu ajunge la nimeni real.
• În producție, aceeași factură devine document legal: este înregistrată de ANAF, aterizează în SPV-ul partenerului și intră în obligațiile de declarare și arhivare.

Adresele exacte, condițiile de autentificare și certificatele acceptate se mai schimbă în timp, așa că documentația oficială rămâne sursa de adevăr — verifică pe ANAF înainte să te bazezi pe o configurație.

De ce facturile reale circulă doar în producție

O factură are valoare juridică numai dacă a fost transmisă și validată în mediul de producție. Un document trimis în test este, prin definiție, fictiv: nu se înregistrează în contabilitate, nu se raportează în deconturi și nu poate fi opus la un control. De aceea cele două medii sunt ținute strict separate — ca să nu existe riscul ca o probă de dezvoltare să fie confundată cu o factură reală. Pentru o firmă, asta înseamnă o regulă simplă: dacă factura contează fiscal, ea a trecut prin producție; dacă a trecut prin test, nu există din punct de vedere legal.

Ce înseamnă asta pentru facturile tale primite

Facturile tale reale de la furnizori ajung exclusiv în mediul de producție, în SPV-ul firmei. Mediul de test e treaba dezvoltatorului, nu a ta: el servește la verificarea integrării, ca atunci când fluxul rulează pe facturile tale reale totul să meargă din prima. eFacturaSPV folosește testul doar intern; preluarea efectivă lucrează pe producție.

Aici intervine preluarea automată din SPV: în producție, fiecare factură primită este descărcată, transformată în PDF oficial prin transformare/FACT1 și arhivată în Google Drive-ul tău, pe luni, înainte să iasă din fereastra de aproximativ 60 de zile în care ANAF o mai ține descărcabilă. Testarea asigură doar că acest flux real funcționează corect.

← Înapoi la dicționarul e-Factura