Mod sandbox — cum testezi integrarea fara a afecta date reale

Înainte de a activă o integrare pe date reale, testeaz-o în modul sandbox. Sandbox-ul SoftFactura ofera un mediu izolat în care poți crea facturi, clienti și plăți de test fără a afecta datele reale ale firmei și fără a trimite documente la ANAF.

Ce este modul sandbox

• Un mediu separat care simuleaza comportamentul API-ului de producție.
• Facturile create în sandbox nu se trimit la ANAF — e-Factura și e-Transport returnează răspunsuri simulate.
• Datele din sandbox sunt complet izolate de datele firmei tale reale.
• Webhooks-urile sandbox declanșează aceleasi evenimente ca în producție, dar cu date de test.

Activare sandbox

1. Mergi la Dezvoltatori din meniul lateral.
2. In tab-ul API Keys, apasă Cheie nouă.
3. Selectează modul Test (in loc de Live).
4. Completează numele și permisiunile.
5. Cheia generată are prefix-ul sf_test_ (in loc de sf_live_).

Cheile de test funcționează identic cu cele live, dar operează pe date sandbox.

Diferențe fata de producție

Aspect	Producție	Sandbox
Prefix cheie	sf_live_	sf_test_
Date	Date reale ale firmei	Date de test izolate
e-Factura ANAF	Trimite efectiv	Răspuns simulat (acceptat)
e-Transport ANAF	Trimite efectiv	Răspuns simulat (UIT fictiv)
PDF-uri	Generate real	Generate real (cu watermark „TEST")
Webhooks	Trimise la URL-urile live	Trimise la URL-urile configurate
Email-uri	Trimise efectiv	Nu se trimit (simulate)

Cum testezi un flux complet

1. Creează un client de test

curl -X POST https://api.softfactura.ro/v1/clients \
  -H "Authorization: Bearer sf_test_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Test Client SRL", "cui": "RO12345678", "type": "pj"}'

2. Creează o factura de test

curl -X POST https://api.softfactura.ro/v1/invoices \
  -H "Authorization: Bearer sf_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "cl_test_123",
    "type": "factura",
    "auto_submit_efactura": true,
    "lines": [{"description": "Produs test", "quantity": 1, "unit_price": 100}]
  }'

3. Verifică webhook-ul

Dacă ai configurat un webhook, vei primi notificarea invoice.created la URL-ul specificat, cu date de test.

4. Descarcă PDF

curl https://api.softfactura.ro/v1/invoices/inv_test_abc/pdf \
  -H "Authorization: Bearer sf_test_..." \
  -o factura-test.pdf

PDF-ul generat va avea un watermark vizibil „TEST" pentru a preveni confuzia cu documente reale.

Resetare date sandbox

Datele din sandbox pot fi șterse oricând fără consecințe:

• Clienti, facturi, produse și plăți de test se sterg automat după 30 de zile de inactivitate.
• Poți șterge manual date individuale prin endpoint-urile DELETE.

Trecerea la producție

Când integrarea funcționează corect în sandbox:

1. Creează o cheie API live (sf_live_) din Dezvoltatori.
2. Înlocuiește cheia de test cu cea live în aplicația ta.
3. Nu este necesară nicio alta modificare — endpoint-urile și formatul sunt identice.