Simplifi Platform API · pentru dezvoltatori

Semnătură electronică calificată,
din aplicația ta.

Trimite documente la semnat cu semnătură electronică calificată (eIDAS) și automatizează fluxurile de documente printr-un API REST simplu. Creezi credențialele direct din cont și faci primul apel în câteva minute.

Vezi documentația API Începe acum

Documentația tehnică este în limba engleză.

first-call.sh

# 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. Create your first document
curl -X POST https://api.simplifi.ro/publicapi/v1/documents \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "First contract",
        "signature_level": "QUALIFIED",
        "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 face parte din abonamentul tău obișnuit, la aceleași prețuri ca în aplicația web. Fără premium de API și fără facturi surpriză: dacă îți epuizezi creditul, primești o eroare stabilă insufficient_*_balance.

Două moduri de integrare

Un singur API, două principaluri. Alege modelul potrivit pentru fiecare apel, sau combină-le în aceeași integrare.

Send for signature(Sign with Simplifi)

Tu trimiți documentul. Destinatarul semnează cu propriul cont.

Aplicația ta încarcă un PDF, adaugă semnatarii și trimite. Fiecare parte semnează pe platforma Simplifi, cu propriul cont și propriul certificat calificat; tu doar colectezi documentul semnat. Fără enrollment și fără gestionare de certificate în sistemul tău.

Creezi documentul printr-un apel REST autentificat (token client_credentials)
Adaugi semnatarii și pozițiile de semnătură
Redirecționezi fiecare semnatar către signing_url
Semnatarii semnează pe Simplifi, cu certificatul lor calificat
Descarci PDF-ul semnat; urmărești progresul prin webhook-uri sau polling

Ideal pentru contracte, dosare HR și orice document contrasemnat.

User automation

Aplicația ta acționează ca unul dintre utilizatorii tăi, cu acordul lui.

Un utilizator din compania ta, cu cont Simplifi și certificat calificat propriu, își dă acordul o singură dată, prin OAuth. Software-ul tău îi automatizează apoi fluxurile obișnuite de documente, mașină-la-mașină, inclusiv semnarea cu certificatul propriu pe baza codului TOTP curent al utilizatorului.

Utilizatorul își dă acordul o dată (OAuth device grant sau PKCE)
Stochezi token-ul offline și îl schimbi pe token-uri de acces
Automatizezi fluxurile lui: documente, grupuri, arhivare
Semnezi cu certificatul lui, furnizând codul TOTP curent

Ideal pentru trimiteri în masă, arhivare și tooling intern.

Detaliile complete, în documentația API

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.1 Deschide colecția Postman Exemple de cod pe GitHub

Embedded Signing: program de parteneriat

Pentru o integrare completă, de tip white-label: verificarea identității, emiterea certificatelor calificate și semnarea rulează integral în produsul tău, iar semnatarii tăi nu au nevoie de cont Simplifi. Este un program de parteneriat separat, disponibil pe bază de aplicare, evaluat individual și bazat pe abonament.

Hai să vorbim

Întrebări frecvente despre API

Pot integra semnarea calificată direct în platforma mea?

Da, acesta este modelul User automation. Un utilizator cu certificat calificat își dă acordul o singură dată, prin OAuth, iar software-ul tău îi automatizează apoi fluxurile de documente mașină-la-mașină și semnează cu certificatul lui, furnizând codul TOTP curent, fără ca utilizatorul să părăsească platforma ta. Pentru documentele semnate de terți folosești Send for signature: contrapartea semnează pe Simplifi, cu contul și certificatul propriu.

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 dacă trimiți documente la semnat sau automatizezi contul unui utilizator. 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?

În modelul Send for signature, da: fiecare semnatar semnează pe platforma Simplifi cu propriul cont (complet, guest sau sponsorizat) și propriul certificat calificat. Aplicația ta redirecționează semnatarul către adresa de semnare primită de la API, urmărește progresul prin webhook-uri și descarcă documentul finalizat.

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.