Documentație pentru dezvoltatori

Trimite prima factură în 5 minute

Autoanaf Core este un gateway API headless. Trimiți o singură cerere JSON — generăm XML UBL 2.1 CIUS-RO, ne autentificăm la ANAF și gestionăm automat toate reîncercările.

Start rapid
1. Obține cheia API

Autentifică-te pe autoanaf.ro → Chei API → Generează cheie. Copiază cheia — este afișată o singură dată.

2. Trimite o factură
curl -X POST https://core.autoanaf.ro/v1/invoices \
  -H "Authorization: Bearer fl_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "invoiceNumber": "FACT-2026-001",
    "issueDate": "2026-05-16",
    "currency": "RON",
    "issuer": {
      "name": "Firma Ta SRL",
      "vatNumber": "RO12345678"
    },
    "buyer": {
      "name": "Client SRL",
      "vatNumber": "RO87654321"
    },
    "items": [{
      "name": "Servicii consultanta",
      "quantity": 1,
      "unitPrice": 1000.00,
      "vatRate": 19,
      "totalAmount": 1190.00
    }]
  }'
3. Răspuns (202 Accepted)
{
  "invoiceId": "1b7afb13-90bf-4df2-ab57-064d0f270ceb",
  "invoiceNumber": "FACT-2026-001",
  "jobId": "4cbdc05a-6555-4c35-b7f4-949cd1d48c21",
  "status": "pending",
  "message": "Invoice created and ANAF submission queued"
}
4. Verifică statusul
GET /v1/invoices/{invoiceId}
Authorization: Bearer fl_your-key
Autentificare

Fiecare cerere necesită cheia ta API Autoanaf în antetul Authorization:

Authorization: Bearer fl_<your-api-key>

Cheile au formatul fl_<base64url-random-32-bytes>. Se stochează doar un hash SHA-256 — cheia în clar este afișată o singură dată, la creare, și nu poate fi recuperată.

Referință API
POST
/v1/invoices

Creează factura și programează depunerea la ANAF

GET
/v1/invoices

Listează toate facturile (paginat)

GET
/v1/invoices/{id}

Obține factura și statusul jobului

GET
/v1/invoices/{id}/ubl

Descarcă XML UBL 2.1

POST
/v1/invoices/generate-xml

Previzualizează XML UBL (fără salvare)

GET
/v1/jobs/{id}

Obține detaliile jobului și jurnalul de audit

GET
/v1/auth/anaf/authorize

Pornește fluxul ANAF OAuth2 (browser)

GET
/v1/auth/anaf/status

Verifică starea conexiunii ANAF

POST
/v1/auth/anaf/token

Injectează manual tokenul ANAF

POST
/v1/keys

Generează o cheie API nouă