Simplifi Platform API · per sviluppatori

Firme elettroniche, semplici o qualificate,
dal tuo codice.

Una sola chiamata invia il documento e restituisce un link di firma per ogni firmatario. Come firma ciascuno lo decidi tu, firmatario per firmatario: firma semplice, certificato qualificato eIDAS emesso al momento o il certificato personale dell'utente. Crea le credenziali nell'app ed effettua la prima chiamata in pochi minuti.

Vedi la documentazione API Inizia ora

La documentazione tecnica è in inglese.

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. 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>" } ] }'

Nessun costo per l'API. Nessun processo di approvazione.

L'API è attiva per ogni account aziendale Simplifi. Non c'è un abbonamento separato, nessuna lista d'attesa e nessuna chiamata commerciale.

Costo dell'API

L'accesso all'API è incluso nel tuo account aziendale: nessun costo di piattaforma e nessun abbonamento per l'integrazione.

Approvazioni necessarie

Un amministratore dell'azienda crea il client API nell'app (Impostazioni API) e riceve subito le credenziali.

Stesso costo dell'app

L'uso dell'API consuma gli stessi crediti dell'app web, agli stessi prezzi: buste, pacchetti di firme, documenti unilaterali. Nessun sovrapprezzo per l'API e nessuna fattura a sorpresa: se il credito si esaurisce, ricevi un errore stabile insufficient_*_balance.

Una chiamata per inviare. Due decisioni.

Fai una sola chiamata API. Il resto sono due decisioni che prendi a ogni richiesta: chi gestisce il processo di firma e come firma ciascun firmatario.

L'unica chiamata

Invia un documento

POST /publicapi/v1/send-document carica il PDF, indica i firmatari, posiziona i campi firma e invia. La risposta contiene il documento e un signing_url per ogni firmatario. Stato, download e Certificato di completamento arrivano da GET /documents/{uuid} e dai webhook document.*; non serve altro.

Agisce come: la tua azienda (account di servizio)
Autenticazione: token di accesso client_credentials
Decisione 1: send_email, per richiesta
Decisione 2: kind, per firmatario; li combini liberamente sullo stesso documento

send-document.http

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/..." } ] } }

Decisione 1

Chi gestisce il processo di firma

send_email: 1

Simplifi si occupa di tutto

Simplifi invia a ogni firmatario l'invito via email, ospita la firma e manda la notifica di completamento. Il tuo ruolo finisce con la chiamata: attendi il webhook document.completed (o interroghi lo stato), poi scarichi il PDF firmato e il Certificato di completamento.

Invito: Simplifi invia il link via email, e la notifica di completamento
Prova del canale: il link dell'email stesso
Dopo la firma: la pagina di completamento Simplifi o il tuo return_url
Adatto quando: vuoi aver finito dopo una sola chiamata

send_email: 0 (predefinito)

Integri la firma nel tuo prodotto

Nessuna email parte da Simplifi. La risposta ti dà un signing_url per ogni firmatario: lo mostri come pulsante nella tua app web o mobile, lo invii con la tua email o via SMS. Il firmatario firma sulla pagina ospitata da Simplifi e torna al tuo return_url con un esito firmato, sulla schermata da cui era partito. Nessuna email di Simplifi, nessun invito a creare un account.

Invito: tuo: schermata in app, email, SMS, push, deep link
Prova del canale: un codice SMS sulla pagina (passi phone)
Dopo la firma: il tuo return_url, con un esito firmato
Adatto quando: il firmatario non deve mai uscire dal flusso del tuo prodotto

Decisione 2

Come firma ciascun firmatario

Un kind per firmatario; puoi combinarli sullo stesso documento. Tre tipi di firmatario, non fasi: scegli quello adatto a ogni persona.

kind: simple

Firma semplice

Chiunque, senza account. Il firmatario apre il link, accetta i termini, conferma un codice monouso e firma. Simplifi applica il proprio sigillo qualificato a nome del firmatario. Per consensi, prese d'atto, accordi di tutti i giorni.

Il firmatario ha bisogno di: niente
Sulla pagina: termini, codice di verifica, firma
Ottieni: firma elettronica semplice eIDAS (SES); prove sigillate nel Certificato di completamento
Paghi: una busta di firma semplice per pacchetto, al completamento

kind: qualified

Firma qualificata, certificato monouso

Chiunque, senza account. Stessa pagina, più la verifica dell'identità: documento d'identità e selfie con rilevamento di vivacità. Un certificato qualificato emesso solo per questa firma firma il documento. Per contratti con qualcuno che non rivedrai necessariamente.

Il firmatario ha bisogno di: un documento d'identità
Sulla pagina: termini, codice, verifica dell'identità, firma
Ottieni: firma elettronica qualificata eIDAS (QES), equivalente a quella autografa; i dati d'identità restano presso Simplifi
Paghi: una busta prepagata per firmatario, all'invio

kind: account

Firma qualificata, certificato a lungo termine: quello dei tuoi utenti

Le persone che hai registrato una volta (onboarding tramite partner) hanno un certificato qualificato sul proprio account Simplifi. Due modi per firmare: aprono il link e accedono, confermando con l'app di autenticazione; oppure, una volta che hanno autorizzato la tua applicazione (OAuth sul tuo client API), il tuo software esegue il passaggio di firma tramite API, autorizzato dal loro codice dell'app di autenticazione. Lo stesso consenso permette al tuo software di agire per loro: documenti, inbox, conservazione.

Il firmatario ha bisogno di: il proprio account e certificato Simplifi
Verifica dell'identità: una sola volta, all'onboarding; mai ripetuta
Ottieni: firma elettronica qualificata eIDAS (QES) con il certificato personale della persona
Paghi: un invito di firma sponsorizzato per documento, all'invio

Tutti i dettagli nella documentazione API

Integrazione della firma elettronica, per qualsiasi piattaforma

L'API eIDAS di Simplifi copre i flussi di firma delle applicazioni che lavorano con documenti:

HR e recruiting

Contratti di lavoro, addendum e fascicoli del personale firmati all'onboarding.

ERP e contabilità

Contratti con i fornitori e documenti fiscali firmati direttamente dal sistema esistente.

Immobiliare

Preliminari, contratti di locazione e verbali di consegna firmati a distanza.

Fintech e assicurazioni

Onboarding dei clienti, polizze e contratti di credito con pieno valore legale.

Sanità

Consensi dei pazienti e documenti medici, firmati a livello qualificato.

Marketplace e SaaS

Qualsiasi piattaforma che ha bisogno di documenti controfirmati tra i suoi utenti.

Costruita per l'integrazione

Qualificata eIDAS, da un QTSP

Firme qualificate con lo stesso valore legale di quelle autografe in tutta l'UE, emesse da un prestatore di servizi fiduciari qualificato sottoposto a vigilanza.

OAuth2 + REST

Autenticazione OAuth2 standard, JSON in ingresso, JSON in uscita, nessun SDK proprietario obbligatorio.

Webhook firmati

document.signer.signed, document.completed, document.rejected, più avvisi sul saldo. Ogni consegna è firmata con HMAC-SHA256.

Specifica OpenAPI 3.1

La specifica completa dell'API è pubblica: genera client e test direttamente da essa.

Collezione Postman

Un ambiente Postman personalizzato ed esempi di codice nel portale sviluppatori in-app.

Ambiente di test

Testa la tua integrazione end-to-end nell'ambiente di sviluppo (app.dev.simplifi.ro) prima di passare in produzione.

Scarica la specifica OpenAPI 3.1 Apri la collezione Postman Esempi di codice su GitHub

Domande frequenti sull'API

Posso integrare la firma direttamente nella mia piattaforma, senza che il firmatario la lasci?

Sì. Invia il documento con send_email: 0 (il valore predefinito): nessuna email parte da Simplifi, ricevi un signing_url per ogni firmatario e lo mostri nella tua app o lo invii sul tuo canale. Il firmatario firma sulla pagina ospitata da Simplifi e torna al tuo return_url con un esito firmato. Per gli utenti che hai registrato (kind: account), il tuo software può persino eseguire da solo il passaggio di firma tramite API, una volta che l'utente ha autorizzato la tua applicazione via OAuth.

Qual è la differenza tra firma semplice e firma qualificata?

La firma semplice (SES) non richiede account né verifica dell'identità: il firmatario conferma un codice monouso e firma, e Simplifi sigilla le prove nel Certificato di completamento. La firma qualificata (QES) ha lo stesso valore legale di quella autografa in tutta l'UE e richiede la verifica dell'identità del firmatario, sul momento (documento d'identità e selfie, per un certificato emesso solo per quella firma) oppure una sola volta all'onboarding, per gli utenti con certificato personale. Nell'API scegli il livello per firmatario, tramite kind, e puoi combinarli sullo stesso documento.

Quanto costa usare l'API?

L'uso dell'API fa parte del tuo abbonamento abituale: gli stessi crediti e gli stessi prezzi dell'app web, qualunque sia il tipo di firmatario. Una firma semplice consuma una busta di firma semplice per pacchetto, al completamento; un certificato qualificato monouso, una busta prepagata per firmatario, all'invio; un firmatario con account proprio, un invito di firma sponsorizzato per documento, all'invio. Non c'è alcun costo per l'API, nessun abbonamento separato e nessun sovrapprezzo. Se il credito si esaurisce, l'API restituisce un errore stabile insufficient_*_balance che puoi gestire nella tua applicazione.

Serve un'approvazione per iniziare?

No. Un amministratore dell'azienda crea il client API nell'app, in Impostazioni API, e riceve subito le credenziali. Non c'è nulla da richiedere e nessuno da aspettare.

I miei destinatari hanno bisogno di un account Simplifi?

No, a meno che non lo scelga tu. Con kind: simple e kind: qualified il firmatario apre il link e firma senza alcun account: per la firma semplice conferma un codice monouso, per quella qualificata passa anche la verifica dell'identità (documento d'identità e selfie) e un certificato qualificato emesso solo per quella firma firma il documento. Solo kind: account richiede un account Simplifi con certificato qualificato proprio, per gli utenti che hai registrato una volta tramite onboarding partner.

Esiste un ambiente di test?

Sì. Puoi testare la tua integrazione nell'ambiente di sviluppo: l'app è su app.dev.simplifi.ro, l'API e la sua documentazione su api.dev.simplifi.ro. In produzione si usa api.simplifi.ro, con le stesse API.

Ci sono rate limit?

Sì, e sono pubblicati nella documentazione API: 1800 richieste al minuto per i token di integrazione e 600 richieste al minuto per i token utente. Limiti generosi per i normali flussi documentali.

Fai la tua prima chiamata oggi

La documentazione è pubblica, le credenziali sono self-service e i costi sono a consumo. Da zero a una chiamata autenticata in tre passaggi.