Lista principalelor endpoint-uri API publice

API-ul public SoftFactura urmeaza convențiile REST și returnează răspunsuri JSON. Toate endpoint-urile necesită autentificare cu API key în header-ul Authorization: Bearer sf_live_....

URL de baza: https://api.softfactura.ro/v1

Facturi

Metoda	Endpoint	Descriere	Scope necesar
GET	/invoices	Lista facturi (paginată)	read
GET	/invoices/:id	Detalii factura	read
POST	/invoices	Creează factura nouă	write
GET	/invoices/:id/pdf	Descarcă PDF factura	read

Creare factura — exemplu

POST /v1/invoices
{
  "client_id": "cl_abc123",
  "type": "factura",
  "currency": "RON",
  "issue_date": "2026-04-16",
  "due_date": "2026-05-16",
  "auto_submit_efactura": true,
  "lines": [
    {
      "description": "Servicii consultanta IT",
      "quantity": 10,
      "unit_price": 500,
      "vat_rate": 19
    }
  ]
}

Parametri de filtrare

• ?status=issued — filtrează după status (draft, issued, paid, cancelled).
• ?from=2026-01-01&to=2026-03-31 — interval de date.
• ?page=2&limit=50 — paginare (default: page 1, limit 20).

Clienti

Metoda	Endpoint	Descriere	Scope necesar
GET	/clients	Lista clienti	read
GET	/clients/:id	Detalii client	read
POST	/clients	Creează client nou	write
PATCH	/clients/:id	Actualizează client	write

Parametri de filtrare

• ?search=firma — caută după nume, CUI sau email.
• ?type=pj — filtrează după tip (pj = persoana juridica, pf = persoana fizica).

Produse

Metoda	Endpoint	Descriere	Scope necesar
GET	/products	Lista produse și servicii	read
GET	/products/:id	Detalii produs	read
POST	/products	Creează produs/serviciu	write
PATCH	/products/:id	Actualizează produs	write

Informații cont

Metoda	Endpoint	Descriere	Scope necesar
GET	/account	Informații firma și abonament	read

Calcul TVA

Metoda	Endpoint	Descriere	Scope necesar
POST	/tax/calculate	Calcul automat cota TVA pe baza tipului de client, țară și produs	read
GET	/tax/vies/:vatNumber	Verificare TVA intracomunitar (VIES)	read

Format răspuns

Toate răspunsurile urmeaza un format consistent:

{
  "data": { ... },
  "meta": {
    "total": 142,
    "page": 1,
    "limit": 20,
    "totalPages": 8
  }
}

Erorile returnează:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Campul client_id este obligatoriu",
    "details": [...]
  }
}

Coduri HTTP

Cod	Semnificație
200	Succes
201	Resursa creată cu succes
400	Date invalide (verificare parametri)
401	Cheie API invalida sau lipsa
403	Permisiuni insuficiente (scope lipsa)
404	Resursa nu exista
429	Rate limit depășit
500	Eroare server