Simplifi Platform API · pentru dezvoltatori
Semnătură electronică, simplă sau calificată,
din aplicația ta.
Un singur apel trimite documentul și returnează câte un link de semnare pentru fiecare semnatar. Cum semnează fiecare alegi tu, per semnatar: semnătură simplă, certificat calificat eIDAS emis pe loc sau certificatul propriu al utilizatorului. Creezi credențialele direct din cont și faci primul apel în câteva minute.
Documentația tehnică este în limba engleză.
# 1. Get an access token (OAuth2 client_credentials)
curl -X POST https://auth.simplifi.ro/realms/Simplifi/protocol/openid-connect/token \
-d "grant_type=client_credentials" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_SECRET"
# 2. Send your first document: one call, a signing link per signer
curl -X POST https://api.simplifi.ro/publicapi/v1/send-document \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "signers": [ { "email": "ana@example.com", "name": "Ana Popescu" } ],
"documents": [ { "name": "First contract", "pdf_base64": "<base64 PDF>" } ] }'
Fără taxă de API. Fără proces de aprobare.
API-ul este activ pentru orice cont de companie Simplifi. Nu există abonament separat, listă de așteptare sau discuție de vânzări.
Taxă de API
Accesul la API este inclus în contul de companie: fără costuri de platformă și fără abonament dedicat integrării.
Aprobări necesare
Un administrator al companiei creează clientul API din aplicație (Setări API) și primește credențialele pe loc.
Același cost ca în aplicație
Utilizarea API-ului consumă aceleași credite ca aplicația web, la aceleași prețuri: plicuri, pachete de semnături, documente unilaterale. Fără premium de API și fără facturi surpriză: dacă îți epuizezi creditul, primești o eroare stabilă insufficient_*_balance.
Un singur apel. Două decizii.
Faci un singur apel API. Restul sunt două decizii pe care le iei la fiecare cerere: cine conduce procesul de semnare și cum semnează fiecare semnatar.
Apelul unic
Trimiți un document
POST /publicapi/v1/send-document încarcă PDF-ul, numește semnatarii, plasează câmpurile de semnătură și trimite. Răspunsul conține documentul și câte un signing_url pentru fiecare semnatar. Starea, descărcarea și Certificatul de finalizare vin din GET /documents/{uuid} și din webhook-urile document.*; nimic altceva nu este necesar.
- Acționează ca
- compania ta (cont de serviciu)
- Autentificare
- token de acces
client_credentials - Decizia 1
send_email, per cerere- Decizia 2
kind, per semnatar; le combini liber pe același document
POST /publicapi/v1/send-document
{
"send_email": 0,
"return_url": "https://your.app/signed",
"signers": [
{ "email": "ana@example.com", "name": "Ana Popescu", "kind": "simple" },
{ "email": "dan@example.com", "name": "Dan Ionescu", "kind": "qualified" }
],
"documents": [ { "name": "Contract", "pdf_base64": "JVBERi0x..." } ]
}
# 200
{ "data": { "document_uuid": "...",
"signers": [ { "email": "ana@...", "signing_url": "https://app.simplifi.ro/signing-guest/..." },
{ "email": "dan@...", "signing_url": "https://app.simplifi.ro/signing-guest/..." } ] } }
Decizia 1
Cine conduce procesul de semnare
send_email: 1
Simplifi preia totul
Simplifi trimite fiecărui semnatar invitația pe email, găzduiește semnarea și trimite notificarea de finalizare. Rolul tău se încheie cu apelul: aștepți webhook-ul document.completed (sau interoghezi), apoi descarci PDF-ul semnat și Certificatul de finalizare.
- Invitația
- Simplifi trimite linkul pe email, și notificarea de finalizare
- Dovada canalului
- linkul din email însuși
- După semnare
- pagina de finalizare Simplifi sau
return_url-ul tău - Potrivit când
- vrei să fii gata după un singur apel
send_email: 0 (implicit)
Incluzi semnarea în propriul produs
Niciun email nu pleacă din Simplifi. Răspunsul îți dă câte un signing_url pentru fiecare semnatar; îl afișezi ca buton în aplicația ta web sau mobilă, îl trimiți prin propriul email sau SMS. Semnatarul semnează pe pagina găzduită de Simplifi și revine la return_url-ul tău cu un rezultat semnat, pe ecranul de unde a plecat. Fără emailuri Simplifi, fără îndemnuri de creare a unui cont.
- Invitația
- a ta: ecran în aplicație, email, SMS, push, deep link
- Dovada canalului
- un cod SMS pe pagină (transmiți
phone) - După semnare
return_url-ul tău, cu un rezultat semnat- Potrivit când
- semnatarul nu trebuie să părăsească niciodată fluxul produsului tău
Decizia 2
Cum semnează fiecare semnatar
Un kind per semnatar; îi poți combina pe același document. Trei tipuri de semnatari, nu etape: alegi tipul potrivit fiecărei persoane.
kind: simple
Semnătură simplă
Oricine, fără cont. Semnatarul deschide linkul, acceptă termenii, confirmă un cod unic și semnează. Simplifi aplică sigiliul său calificat în numele semnatarului. Pentru consimțăminte, confirmări, acorduri de zi cu zi.
- Semnatarul are nevoie de
- nimic
- Pe pagină
- termeni, cod de verificare, semnătură
- Primești
- semnătură electronică simplă eIDAS (SES); dovezile sigilate în Certificatul de finalizare
- Plătești
- un plic de semnătură simplă per pachet, la finalizare
kind: qualified
Semnătură calificată, certificat unic
Oricine, fără cont. Aceeași pagină, plus verificarea identității: act de identitate și un selfie cu detecție de prezență. Un certificat calificat emis doar pentru această semnare semnează documentul. Pentru contracte cu cineva pe care nu îl vei revedea neapărat.
- Semnatarul are nevoie de
- un act de identitate
- Pe pagină
- termeni, cod, verificarea identității, semnătură
- Primești
- semnătură electronică calificată eIDAS (QES), echivalentă celei olografe; datele de identitate rămân la Simplifi
- Plătești
- un plic preplătit per semnatar, la trimitere
kind: account
Semnătură calificată, certificat pe termen lung: al utilizatorilor tăi
Persoanele pe care le-ai înrolat o singură dată (înrolare prin partener) dețin un certificat calificat pe propriul cont Simplifi. Două moduri de a semna: deschid linkul și se autentifică, confirmând cu aplicația de autentificare; sau, odată ce au autorizat aplicația ta (OAuth pe clientul tău API), software-ul tău efectuează pasul de semnare prin API, autorizat de codul lor din aplicația de autentificare. Același consimțământ îi permite software-ului tău să acționeze pentru ei: documente, inbox, retenție.
- Semnatarul are nevoie de
- contul și certificatul lor Simplifi
- Verificarea identității
- o singură dată, la înrolare; nu se repetă
- Primești
- semnătură electronică calificată eIDAS (QES) cu certificatul propriu al persoanei
- Plătești
- o invitație de semnare sponsorizată per document, la trimitere
Integrare semnătură electronică, pentru orice platformă
API-ul eIDAS Simplifi acoperă fluxurile de semnare din aplicațiile care lucrează cu documente:
HR & recrutare
Contracte de muncă, acte adiționale și dosare de personal semnate la onboarding.
ERP & contabilitate
Contracte cu furnizorii și documente fiscale semnate direct din sistemul existent.
Imobiliare
Antecontracte, contracte de închiriere și procese-verbale semnate de la distanță.
Fintech & asigurări
Onboarding de clienți, polițe și contracte de credit cu valoare juridică deplină.
Sănătate
Consimțăminte ale pacienților și documente medicale, semnate calificat.
Marketplace & SaaS
Orice platformă care are nevoie de documente contrasemnate între utilizatori.
Construit pentru integrare
Calificat eIDAS, de la un QTSP
Semnături calificate cu aceeași valoare juridică precum cele olografe în toată UE, emise de un furnizor calificat de servicii de încredere, sub supraveghere.
OAuth2 + REST
Autentificare standard OAuth2, JSON in, JSON out, fără SDK-uri proprietare obligatorii.
Webhook-uri semnate
document.signer.signed, document.completed, document.rejected, plus alerte de balanță. Fiecare livrare este semnată HMAC-SHA256.
Specificație OpenAPI 3.1
Specificația completă a API-ului este publică: generezi clienți și teste direct din ea.
Colecție Postman
Mediu Postman personalizat și exemple de cod, în portalul pentru dezvoltatori din aplicație.
Mediu de test
Testezi integrarea end-to-end în mediul de dezvoltare (app.dev.simplifi.ro) înainte de a trece pe producție.
Descarcă specificația OpenAPI 3.1Deschide colecția PostmanExemple de cod pe GitHub
Întrebări frecvente despre API
Pot integra semnarea direct în platforma mea, fără ca semnatarul să o părăsească?
Da. Trimiți documentul cu send_email: 0 (valoarea implicită): niciun email nu pleacă din Simplifi, primești câte un signing_url pentru fiecare semnatar și îl afișezi în propria aplicație sau îl trimiți pe canalul tău. Semnatarul semnează pe pagina găzduită de Simplifi și revine la return_url-ul tău cu un rezultat semnat. Pentru utilizatorii pe care i-ai înrolat (kind: account), software-ul tău poate efectua chiar pasul de semnare prin API, după ce utilizatorul a autorizat aplicația ta o singură dată prin OAuth.
Care este diferența între semnătura simplă și cea calificată?
Semnătura simplă (SES) se aplică fără cont și fără verificarea identității: semnatarul confirmă un cod unic și semnează, iar Simplifi sigilează dovezile în Certificatul de finalizare. Semnătura calificată (QES) are aceeași valoare juridică precum cea olografă în toată UE și cere verificarea identității semnatarului, fie pe loc (act de identitate și selfie, pentru un certificat emis doar pentru acea semnare), fie o singură dată, la înrolare, pentru utilizatorii cu certificat propriu. În API alegi nivelul per semnatar, prin kind, și le poți combina pe același document.
Cât costă utilizarea API-ului?
Utilizarea API-ului face parte din abonamentul tău obișnuit: aceleași credite și aceleași prețuri ca în aplicația web, indiferent de tipul de semnatar. Semnătura simplă consumă un plic de semnătură simplă per pachet, la finalizare; certificatul calificat unic, un plic preplătit per semnatar, la trimitere; semnatarul cu cont propriu, o invitație de semnare sponsorizată per document, la trimitere. Nu există taxă de API, abonament separat sau vreun premium de API. Dacă îți epuizezi creditul, API-ul răspunde cu o eroare stabilă insufficient_*_balance, pe care o poți trata în aplicația ta.
Am nevoie de aprobare ca să încep?
Nu. Un administrator al companiei creează clientul API din aplicație, în Setări API, și primește credențialele pe loc. Nu există proces de aplicare și nimeni de așteptat.
Destinatarii mei au nevoie de cont Simplifi?
Nu, decât dacă alegi tu asta. Cu kind: simple și kind: qualified semnatarul deschide linkul și semnează fără niciun cont: pentru semnătura simplă confirmă un cod unic, pentru cea calificată trece și prin verificarea identității (act de identitate și selfie), iar un certificat calificat emis doar pentru acea semnare semnează documentul. Doar kind: account cere un cont Simplifi cu certificat calificat propriu, pentru utilizatorii pe care i-ai înrolat o singură dată prin partener.
Există un mediu de test?
Da. Poți testa integrarea în mediul de dezvoltare: aplicația rulează la app.dev.simplifi.ro, iar API-ul și documentația la api.dev.simplifi.ro. În producție folosești api.simplifi.ro, cu aceleași API-uri.
Există limite de rată (rate limits)?
Da, și sunt publicate în documentația API: 1800 de cereri pe minut pentru token-urile de integrare și 600 de cereri pe minut pentru token-urile de utilizator. Sunt limite generoase pentru fluxuri obișnuite de documente.
Fă primul apel astăzi
Documentația este publică, credențialele sunt self-service, iar costurile sunt per utilizare. De la zero la un apel autentificat, în trei pași.
Întrebări tehnice? Scrie-ne la easy@simplifi.ro.