API facturare pentru developeri
API care face e-Factura sa fie usor.
Integreaza facturarea electronica in produsul tau in cateva linii de cod. Endpoint-uri REST, OAuth2, webhooks si SDK-uri pentru Node.js, PHP si Python.
Sandbox dedicat, fara card. Token-uri test pentru integrarea ANAF.
POST /api/invoices
curl https://app.storno.ro/api/invoices \
-H "Authorization: Bearer $STORNO_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"company_id": "your-company-uuid",
"client": {
"cui": "RO12345678",
"name": "Tech Solutions SRL"
},
"lines": [
{ "description": "Servicii consultanta", "quantity": 10, "unit_price": 250, "vat_rate": 21 }
],
"due_date": "2026-06-01",
"send_to_anaf": true
}'Ce iti ofera API-ul Storno
Tot ce ai nevoie pentru a integra facturarea electronica in produsul tau.
REST API documentat
OpenAPI 3.1, exemple in 5 limbaje, sandbox dedicat. Endpoint-uri pentru facturi, clienti, produse, e-Factura, plati.
OAuth2 + API keys
Autentificare prin OAuth2 pentru integrari multi-tenant sau API keys per organizatie. Permisiuni granulare pe scope.
Webhooks pentru evenimente
Inscriere la evenimente: factura emisa, plata incasata, status ANAF schimbat. Retry automat cu backoff, semnatura HMAC.
SDK-uri si MCP
Pachete oficiale pentru Node.js, PHP si Python. MCP server pentru integrare directa cu Claude, Cursor si alte LLM-uri.
Sandbox + production
Token de test cu ANAF mock pentru dezvoltare. Switch la production cu un singur header. Fara taxe la dezvoltare.
Self-host disponibil
Daca preferi sa tii datele pe serverul tau, instalezi Storno cu Docker. Acelasi API, infrastructura ta.
Ce primesti inapoi
Raspuns complet cu URL-uri pentru PDF, XML si link de plata. Webhook-uri pentru fiecare schimbare de status.
POST /api/invoices — raspuns 201
{
"id": "8f3e2a1c-...",
"number": "F2026-001",
"total_with_vat": 3025.00,
"currency": "RON",
"status": "issued",
"anaf": {
"upload_id": "4729382",
"status": "pending",
"xml_url": "https://app.storno.ro/api/invoices/8f3e2a1c-.../xml"
},
"pdf_url": "https://app.storno.ro/api/invoices/8f3e2a1c-.../pdf",
"payment_link": "https://buy.stripe.com/..."
}webhook invoice.anaf.validated
// POST https://your-app.com/webhooks/storno
{
"event": "invoice.anaf.validated",
"invoice_id": "8f3e2a1c-...",
"anaf": {
"upload_id": "4729382",
"download_id": "8281938",
"status": "ok"
},
"occurred_at": "2026-05-15T10:32:18Z"
}Cloud sau self-host — alegerea ta
Acelasi API, doua optiuni de gazduire.
Pune-l pe serverul tau cu Docker
Storno este open-source. Daca vrei datele tale sa nu plece de pe infrastructura ta, ruleaza Storno cu un docker compose up. Aceleasi endpoint-uri, aceleasi SDK-uri.
Intrebari frecvente despre API
Raspunsuri pentru developeri si echipe tehnice.
Documentatia te asteapta.
OpenAPI specs, exemple, sandbox. Tot ce ai nevoie pentru a integra Storno in produsul tau.