API REST, direct la subiect
Endpoint-uri pentru facturi, clienți și produse, cu răspunsuri JSON curate, coduri de eroare structurate (tip, cod, mesaj, request_id) și versiune de API explicită. URL de bază: api.softfactura.ro/public/v1.
Modul · 21 RON/lună
Facturarea, condusă din codul tău
Magazin online, ERP, sistem de comenzi intern — dacă platforma ta știe să facă un request HTTP, poate emite facturi în SoftFactura. Cu e-Factura ANAF inclusă pe fluxul de emitere și cu webhooks care îți aduc înapoi fiecare schimbare de stare, în timp real.
Ce face modulul, concret
Construit pentru programatori, cumpărat de firme care vor facturare fără mâini.
Chei API cu permisiuni
Creezi chei separate pentru fiecare integrare, cu permisiuni de citire și/sau scriere. Secretul se afișează o singură dată, vezi ultima utilizare a fiecărei chei, iar revocarea e instantă — fără să atingi celelalte integrări.
Webhooks pe 12 evenimente
Factură creată, emisă, plătită sau anulată; plată primită; client sau produs creat/actualizat; e-Factura trimisă, acceptată sau respinsă. Sistemul tău află în timp real, fără polling — iar fiecare livrare rămâne în istoric, cu status code.
Semnate HMAC-SHA256
Fiecare apel de webhook poartă semnătura HMAC-SHA256 în header-ul X-Webhook-Signature, calculată cu secretul tău — verifici criptografic că apelul vine de la SoftFactura, nu de la altcineva.
Rate limiting și sandbox
Limitele de rată sunt documentate, ca să-ți dimensionezi integrarea fără surprize, iar mediul de test (sandbox) îți permite să rulezi totul fără să emiți documente reale — abia apoi comuți pe producție.
Documentație publică, fără cont
Ghidurile de endpoint-uri, autentificare, webhooks și rate limiting sunt publice în Centrul de ajutor — programatorul tău le poate citi înainte să existe măcar un cont. Iar în trial testează totul, gratuit, 30 de zile.
Fluxul tipic: de la comandă la e-Factura
Clientul plasează comanda în magazinul tău online
Sistemul tău apelează API-ul: creează clientul (dacă e nou) și emite factura
Factura primește număr fiscal, PDF și intră în fluxul e-Factura ANAF
Webhook „invoice.issued" confirmă emiterea către sistemul tău
La încasare, „payment.received" îți închide comanda automat
„efactura.accepted" îți spune că ANAF a validat factura
Pentru eMAG, Fashion Days și Trendyol nu ai nevoie de API — integrările native, fără cod, fac parte din Facturare PRO.
Pentru cine e gândit
Oriunde facturile trebuie să apară singure, din alt sistem.
Magazine online proprii
WooCommerce, Shopify, PrestaShop sau platformă custom: comanda devine factură emisă automat, cu e-Factura B2C inclusă. Parte din pachetul Magazin Online (−17%).
Vezi pachetul Magazin Online →ERP-uri și sisteme interne
Sistemul de comenzi, CRM-ul sau ERP-ul existent emite facturile prin API și primește înapoi, prin webhooks, fiecare emitere, plată și validare ANAF — fără sincronizări manuale.
Toate funcționalitățile API →Agenții și programatori
Documentație publică fără cont, sandbox de test, erori structurate cu request_id și chei separate per proiect — integrarea pentru clientul tău nu depinde de nimeni de la noi.
Deschide Centrul de ajutor →Preț simplu — plătești doar ce folosești
Fără taxe per request și fără trepte de volum: un preț, tot API-ul.
Trial
0 RON
30 de zile, toate modulele, fără card
API & Webhooks
21 RON/lună
249 RON/an, fără TVA
Pachet Magazin Online
1.075 RON/an
5 module cu API inclus, −17%
Întrebări frecvente despre API
Cum mă autentific la API?⌄
Cu o cheie API creată din aplicație (Setări → API & Webhooks), transmisă în header-ul X-Api-Key sau ca Authorization: Bearer. Fiecare cheie are permisiuni separate de citire și scriere, secretul se afișează o singură dată la creare, iar revocarea e instantă. URL-ul de bază: https://api.softfactura.ro/public/v1.
Ce pot face prin API?⌄
Emiți și citești facturi, creezi și actualizezi clienți și produse — tot ce e nevoie pentru facturarea automată dintr-un sistem extern. Facturile emise prin API intră în același flux ca cele emise manual: numerotare fiscală, PDF, e-Factura ANAF, rapoarte.
Cum funcționează webhooks-urile?⌄
Configurezi un endpoint URL și alegi dintre cele 12 evenimente: factură creată/emisă/plătită/anulată, plată primită, client creat/actualizat, produs creat/actualizat, e-Factura trimisă/acceptată/respinsă. Fiecare apel e semnat HMAC-SHA256 (header X-Webhook-Signature) ca să poți verifica autenticitatea, iar istoricul de livrări cu status code pe fiecare apel e vizibil în aplicație.
Pot conecta un magazin WooCommerce sau Shopify?⌄
Da, prin API — comanda plasată în magazin devine factură emisă automat, cu e-Factura B2C inclusă. Nu există încă un plugin oficial gata instalat, deci e nevoie de o integrare făcută de un programator (sau de agenția care ți-a făcut magazinul); API-ul e gândit exact pentru asta. Pentru eMAG, Fashion Days și Trendyol există integrări native, fără cod, în modulul Facturare PRO.
Unde e documentația? Există mediu de test?⌄
Documentația — endpoint-uri, autentificare, webhooks, rate limiting — e publică în Centrul de ajutor (softfactura.ro/ajutor, categoria API), fără cont. Există și un mediu de test (sandbox) în care rulezi integrarea fără să emiți documente reale, plus trialul de 30 de zile în care poți testa totul pe contul tău.
Cât costă modulul API & Webhooks?⌄
249 RON/an fără TVA — echivalentul a 21 RON/lună — se adaugă separat, doar dacă ai nevoie de el. E inclus în pachetul Magazin Online (5 module, −17%) și, ca toate modulele, e gratuit în trialul de 30 de zile, fără card.
Prima factură din cod, azi
Trial 30 de zile cu toate modulele incluse, fără card. Creezi o cheie API, testezi în sandbox și emiți prima factură din sistemul tău — în aceeași zi.
Începe trial gratuit acumSetup în 30 de secunde, cu datele firmei preluate de la ANAF. Hosting UE, conform GDPR.
Vezi și alte profile
Alegere greșită? Verifică pillar-ul potrivit pentru forma ta juridică sau modul tău de lucru.
Magazin online
Facturi automate prin API, e-Factura B2C, stoc, AWB, ramburs verificat per colet.
Vezi pillarFacturare PRO
Documente nelimitate, e-Factura prioritar, recurente automate. Ofertă: 1 an = 3 ani.
Vezi pillarFuncționalități complete
Catalogul complet: facturare, e-Factura, stocuri, curieri, POS, API — pe categorii.
Vezi pillarGhiduri utile din Centrul de ajutor
Pas cu pas, din documentatia SoftFactura — acces gratuit, fara cont.
Lista principalelor endpoint-uri API publice
Endpoint-urile API publice SoftFactura — facturi, clienti, produse, plati. Exemple de cereri si raspunsuri.
Cum generezi API keys pentru integrari externe
Crearea si gestionarea cheilor API in SoftFactura — chei live, permisiuni (scopes) si bune practici de securitate.
Configurare webhooks — URL, events si verificare semnatura
Cum configurezi webhooks in SoftFactura pentru a primi notificari in timp real la evenimente (factura creata, plata inregistrata, e-Factura acceptata).
Limite de rate API — request limits, headers si retry strategy
Limitele de rate pentru API-ul SoftFactura — 100 request-uri pe minut per cheie, headers X-RateLimit si strategia de retry.
Mod sandbox — cum testezi integrarea fara a afecta date reale
Testarea integrarilor API SoftFactura in modul sandbox — date izolate, fara efecte pe facturi reale sau e-Factura ANAF.
Comenzi eMAG — preluare automată și facturare cu un click
Comenzile din eMAG Marketplace se citesc automat din contul tău de seller, le facturezi cu un click (sau automat), iar factura se atașează singură comenzii în eMAG.