Domande e risposte

Risposte brevi, raggruppate per argomento. Ognuna rimanda alla pagina che dice il resto. Cerchi qualcos'altro? La casella di ricerca in cima al menu della guida lo trova in tutte le pagine e in queste risposte; se hai effettuato l'accesso, quella della pagina Guida della console cerca anche nell'aiuto della console. Funzionano sia le parole italiane sia quelle inglesi (iva, firma, modello, template).

Per iniziare

Come faccio la prima chiamata?

Prendi la chiave iniziale dall'email di benvenuto e l'id del modello Hello World dalla console, e mandali a POST /api/v1/compose/documents/generate. La risposta è il PDF. Leggi tutto

Come faccio firmare un documento?

Componilo, poi crea e invia una busta con POST /api/v1/sign/envelopes?send=true, indicando il firmatario e dove va la firma. Oppure fai tutte e due le cose con una chiamata, POST /api/v1/flow. Senza codice: Firme, Nuova richiesta nella console (un PDF), oppure Flussi, Fai firmare un documento Word. Leggi tutto

Posso far firmare un documento Word che ho già scritto, senza codice?

Sì: Flussi, Fai firmare un documento Word nella console. Carica il .docx compilato, indica i firmatari e premi Valida per vedere i controlli e il costo; costa quanto un flusso. Un tag {{ signature.A }} nel file posiziona una firma, altrimenti ogni firmatario firma in fondo. Leggi tutto

Come tengo informata la persona che ha chiesto una firma?

Aggiungila come osservatore: settings.watchers (signature.watchers in un flusso), ciascuno con notifyOn everything (ogni passo), completion (la fine, con il PDF firmato) o none. Un osservatore non firma mai; i moduli di firma della console hanno lo stesso elenco. Leggi tutto

Posso usare la console in italiano o in inglese?

Sì: la console, la guida e ogni email seguono la lingua del tuo profilo (Profilo, Preferenze); prima di accedere, la bandierina del sito o il tuo browser. I firmatari leggono la lingua della tua organizzazione, a meno che una busta o un firmatario ne indichi un'altra. L'API risponde in inglese. Leggi tutto

I dati possono spuntare una casella in un modello Word?

Sì: dai un nome alla casella (il segnalibro di una casella tradizionale, o il Tag di un controllo contenuto casella) e manda "consenso": true per spuntarla, false per toglierla. Se ometti la chiave la casella resta come nel modello. Leggi tutto

C'è un esempio pronto nel mio linguaggio?

Sì: cURL, Python e JavaScript per comporre, firmare e il flusso in una chiamata, ciascuno con la sua variante di prova, pronti da copiare. Leggi tutto

Perché il font del mio PDF è diverso da quello del file Word?

Il PDF usa font liberi, quindi un font di Word che non possiamo installare viene sostituito. Arial, Times New Roman, Courier New, Calibri e Cambria hanno un gemello con le stesse larghezze; altri (Aptos, Verdana, Georgia) cambiano poco o molto. La pagina del modello dice quali dei suoi font sono sostituiti. Leggi tutto

Come mi oriento nella console?

La ricerca è nella pagina Aiuto; premi / o Ctrl-K da qualsiasi pagina per arrivarci. Una tabella si ordina facendo clic sull'intestazione, una volta crescente e una decrescente. Le impostazioni sono raggruppate per tema con un indice in alto (il Branding ha una voce sua nel menu); un modulo mette ogni etichetta a sinistra quando c'è spazio. Leggi tutto

Un agente AI può scrivere l'integrazione?

Indica /llms-full.txt a Claude Code, Codex o Cursor. Il prompt che riceve non contiene mai la tua chiave API. Leggi tutto

In quanto tempo risponde l'assistenza?

L'assistenza prende in carico (non risolve) entro 4 ore lavorative se il servizio è fermo per tutti, 8 se una funzione principale è ferma senza alternativa, 3 giorni lavorativi per un guasto che ne ha una, 5 per una domanda o una richiesta di funzione; lun-ven 9:00-18:00 ora italiana, festivi esclusi. La stessa tabella è nello SLA (/legal/sla). Leggi tutto

Chiavi API

Come ottengo una chiave API?

Nella console: Chiavi API, poi Emetti una chiave. Dalle un nome, spunta che cosa può fare e scegli quanto dura; viene mostrata una sola volta, quindi copiala subito. Le chiavi le emetti solo tu, nella tua console - mai noi. Leggi tutto

Di quale ambito ha bisogno la mia chiave?

documents:compose per comporre, signatures:ses per firmare, flow:* per il flusso, e in più isTest per una chiamata di prova. Un rifiuto indica che cosa mancava in details.missingScopes. Leggi tutto

Ho perso una chiave. Potete recuperarla?

No: una chiave è conservata solo come hash, quindi nessuno può rileggerla. Revocala ed emettine una nuova nella pagina Chiavi API. Leggi tutto

Prove

Come faccio una chiamata di prova?

Aggiungi "isTest": true a settings. Stessa richiesta, stessa risposta; il PDF porta una fascia rossa TEST su ogni pagina e non ha valore legale. Leggi tutto

Le chiamate di prova consumano credito?

No. Consumano una dotazione condivisa di 20 elementi di prova al giorno (salvo accordi diversi), che si ricarica alle 00:00 UTC. Ogni risposta di prova dice quanto resta in output.credits.testRemaining. Leggi tutto

Le chiamate di prova sono contate insieme a quelle reali?

Mai. La console, GET /api/v1/usage e l'esportazione contano la produzione e mostrano a parte le chiamate di prova. Leggi tutto

Una chiamata di prova può chiedere un sigillo o un codice via SMS?

No. Tutto ciò che si paga a un terzo è rifiutato con FEATURE_NOT_AVAILABLE_IN_TEST_MODE prima che qualcosa sia riservato o inviato. Leggi tutto

Credito e fatturazione

Quanto costa un documento?

2 crediti alla tariffa standard, e un credito vale 10 centesimi: 0,20 EUR. Una richiesta di firma vale 10 crediti, quindi un flusso (componi e firma con una chiamata) ne vale 12; un codice SMS, un sigillo e una marca temporale hanno tariffe proprie. Le tue sono nella dashboard della console. Leggi tutto

Che cosa succede quando finisce il credito?

La chiamata è rifiutata con QUOTA_EXCEEDED, e nulla viene prodotto o addebitato. Ricarica in Fatturazione, Acquista credito. Leggi tutto

Come vedo quanto è costata una chiamata?

output.credits.items lo elenca riga per riga - unità, quantità, crediti e se ha pagato il credito o il tuo piano - e le righe sommano a output.credits.used. left è il tuo saldo dopo la chiamata. Leggi tutto

C'è un piano annuale?

EarlyBird, quando Fatturazione lo offre: 899 EUR l'anno per 1.200 firme, 2.400 codici SMS e 5.000 documenti, usati prima del credito; sigillo e marca temporale restano a credito. I contatori ripartono a ogni rinnovo. Leggi tutto

Posso cambiare o disdire il mio piano?

Disdici quando vuoi in Fatturazione: arriva alla scadenza, poi credito prepagato. Passa a un piano superiore quando vuoi, pagando la differenza di prezzo, stessa scadenza. Passare a un piano inferiore o diverso: negli ultimi trenta giorni. Fino a cinque giorni prima della scadenza puoi ancora cambiare idea. Leggi tutto

Conservate la mia carta?

No. Il numero della carta e il suo codice si digitano nel modulo di Revolut e non ci arrivano mai. Per un piano conserviamo un token di Revolut, le ultime quattro cifre e la scadenza. Al momento di un pagamento usi la carta salvata o ne aggiungi una nuova; per un piano, una carta nuova sostituisce quella salvata. Leggi tutto

Come cancello la mia carta salvata?

Fatturazione, Piano, Carta, Elimina carta (coordinatori). Viene cancellata presso Revolut e il piano smette di rinnovarsi: termina alla data che ti scriviamo, poi credito prepagato, con il credito che hai. Una ricarica richiederà di nuovo una carta. Negli ultimi trenta giorni puoi riattivarlo con una carta nuova. Leggi tutto

Quanto credito posso acquistare in una volta?

Un acquisto è al massimo di 1.000,00 EUR, IVA esclusa; uno più grande è rifiutato con PURCHASE_AMOUNT_TOO_LARGE prima di qualsiasi pagamento. Fai più acquisti, oppure contattaci per un importo maggiore. Leggi tutto

Quale IVA pago?

22% in Italia; 0% in ogni altro Paese (inversione contabile nell'UE, impresa o privato). Se stabiliamo un altro regime per la tua organizzazione, quello. La tua pagina di fatturazione lo mostra, in sola lettura. Leggi tutto

A noi si applica un regime IVA diverso. Che cosa faccio?

Spunta Il mio regime IVA è diverso nella pagina Fatturazione e indica che cosa si applica e dove è scritto. Finché non l'abbiamo verificato, gli acquisti sono addebitati con l'aliquota del tuo account; se è fondato, impostiamo il regime e l'assistenza può aggiungere credito per quanto addebitato. Leggi tutto

Pago una chiamata fallita?

No. Si paga solo ciò che è stato consegnato: un documento, una busta inviata, un SMS accettato dal gestore. Una chiamata rifiutata o fallita restituisce quanto aveva riservato. Leggi tutto

Mi viene restituito sigillo o marca temporale se la busta è annullata o il sigillo fallisce?

Sì. Una busta li paga con la firma all'invio. Se è annullata, scade o è rifiutata, o non possono essere apposti quando l'ultimo firmatario finisce (anche quando la risposta del prestatore va persa), tornano subito al credito da cui provenivano, e il tuo registro di audit lo dice. La firma non viene restituita. Leggi tutto

Firma

Quale livello di firma ottengo?

Una firma elettronica semplice (FES), con le prove conservate. FEA e FEQ arriveranno presto, e fino ad allora sono rifiutate con SIGNATURE_LEVEL_UNAVAILABLE. Leggi tutto

Come so che un documento è stato firmato?

Leggi output.status quando ti serve, oppure indica un URL di callback e ricevi il webhook firmato quando succede. Leggi tutto

Come posiziono la firma?

Scrivi {{ signature.A }} nel modello dove firma il firmatario A, come qualsiasi altro campo, e manda quel firmatario senza fields. L'alternativa è fields con page, x e y come frazioni della pagina dall'angolo in alto a sinistra; se ci sono, prevalgono. Leggi tutto

Una persona può firmare in più punti?

Sì: dai ai firmatari la stessa email e sono una sola persona, che riceve un invito e firma una volta, con la firma su ogni posizione; un modello con tre posizioni serve una, due o tre persone. Un firmatario i cui tag stanno tutti dentro una condizione falsa resta fuori dalla busta. Leggi tutto

I vostri callback possono autenticarsi presso il mio sistema?

Sì: aggiungi un ambiente dei callback nella console (token Bearer, chiave API o credenziali client OAuth2) e manda "env" con i percorsi in callbackUrl. Ogni callback porta comunque la nostra firma HMAC. Leggi tutto

Le email che ricevono i miei firmatari possono avere il mio logo e i miei colori?

Sì: Branding, nel menu a sinistra (coordinatori). Un logo, i colori di intestazione, pulsante e piè di pagina e un testo a piè di pagina; mai il tuo HTML. L'email con il codice resta nostra, e un'email con il tuo marchio toglie la nostra riga di firma ma tiene il link per le segnalazioni. Leggi tutto

Posso scrivere il testo delle email che ricevono i miei firmatari?

Sì: Branding, poi Email. Ogni email si apre con il nostro testo; modificalo in italiano e in inglese con segnaposto come il nome del firmatario e il link, guarda l'anteprima, mandati una prova e ripristina il testo predefinito quando vuoi. Solo testo semplice, verificato prima del salvataggio. Anche le pagine di firma hanno qualche riga tua. Leggi tutto

Un firmatario ha perso il link. E ora?

Rimanda a quel firmatario: POST /api/v1/sign/envelopes/{id}/recipients/{id}/resend, oppure il pulsante Rimanda nella console. Nessuna nuova richiesta e nessun nuovo addebito; riceve di nuovo l'invito con un link nuovo, e il vecchio smette di funzionare. I promemoria automatici fanno lo stesso a cadenza. Leggi tutto

Un firmatario dice che il link è scaduto. E ora?

La pagina che vede dice perché: la richiesta è scaduta, è stata revocata o la persona è stata sostituita. Finché la richiesta è aperta, rimandala per un link nuovo; una richiesta scaduta non si riapre, quindi mandane una nuova. I firmatari vengono avvisati quando una richiesta scade o è revocata. Leggi tutto

Posso sostituire un firmatario?

Sì, dalla console o con POST /api/v1/sign/envelopes/{id}/recipients/{id}/replace: la nuova persona prende i campi e il posto nell'ordine, il vecchio link smette di funzionare. Su una bozza corregge semplicemente nome, email e telefono. Per un firmatario via SMS indica il nuovo cellulare. Leggi tutto

Come metto una parola in grassetto nel messaggio di firma?

Scrivila fra doppi asterischi: **clausola 4**. Un a capo è una nuova riga e una riga vuota un nuovo paragrafo; i link sono cliccabili. In un documento il grassetto viene dal modello stesso. Leggi tutto

Errori

Che cosa significa un errore?

Ogni errore ha un codice stabile e un numero a quattro cifre in output.error. Ramificati sul codice, mai sul messaggio; la tabella dice quando si verifica ciascuno e se riprovare. Leggi tutto

Devo riprovare una chiamata fallita?

Solo quando la tabella dice che si può riprovare, dopo i secondi indicati in Retry-After. Manda una Idempotency-Key, così un nuovo tentativo non addebita mai due volte. Leggi tutto

Che cosa succede durante la manutenzione?

Ogni chiamata riceve MAINTENANCE_MODE (503, Retry-After) e nulla viene fatto o addebitato; riprova più tardi. Poco prima, un nuovo lavoro in blocco è rifiutato mentre quelli in corso finiscono, e le risposte portano X-Maintenance-Pending. Leggi tutto

Limiti

Quali sono i miei limiti?

Richieste al minuto, dimensioni, pagine, chiamate di prova al giorno e quanto durano link e file: nella console in Riferimento, Limiti, oppure in GET /api/v1/usage. Leggi tutto

Ho ricevuto un 429. Che cosa faccio?

RATE_LIMIT_EXCEEDED: troppe richieste in questo minuto, quindi aspetta i secondi indicati in Retry-After. Anche TEST_QUOTA_EXCEEDED è un 429: la dotazione di prova di oggi è finita; e così QUOTA_EXCEEDED, il tuo credito. Ramificati sul codice, non sullo stato. Leggi tutto

Qual è la richiesta più grande che posso mandare?

25 MB. Un corpo più grande è rifiutato con PAYLOAD_TOO_LARGE (1803, HTTP 413) e nulla viene ricevuto o addebitato. Nessun limite è più alto: anche un modello è al massimo di 25 MB, e i limiti della tua organizzazione per il payload, un file caricato o un file in blocco sono in Riferimento, Limiti. Leggi tutto

Per quanto tempo conservate i miei documenti?

Un documento generato 12 mesi (uno di prova 7 giorni), quello che hai inviato altrettanto, un file caricato 30 giorni, le prove di firma 10 anni. Una chiamata dataless non conserva nulla. Leggi tutto

In quale fuso orario sono gli orari?

L'API e i webhook: sempre UTC. La console, le email, il certificato, la riga sotto ogni firma e le esportazioni: la localizzazione della tua organizzazione, con il suo fuso e il suo formato di data, che impostiamo noi; scrivici per cambiarla. Leggi tutto

Sicurezza e privacy

Siete certificati ISO 27001 o SOC 2?

Non ancora, e non lo dichiariamo. I controlli ci sono e sono documentati rispetto all'Annex A della ISO 27001 e ai criteri SOC 2; la mappatura la condividiamo su richiesta. I server sono in un data center UE certificato ISO 27001. Leggi tutto

C'è una pagina di stato?

Sì: /status dice se l'API, le pagine di firma e l'invio delle email funzionano adesso, con ogni avviso su un incidente o una manutenzione; /status.json è lo stesso per il tuo monitoraggio. Leggi tutto

C'è un accordo sul trattamento dei dati?

Sì: il DPA ex art. 28 GDPR fa parte dei Termini, pubblicato su /legal/dpa con le misure tecniche e organizzative. Lo accetti insieme ai Termini. Leggi tutto

Chi sono i vostri sub-responsabili, e dove sono i dati?

L'elenco su /legal/subresponsabili dice per ogni fornitore che cosa fa, quali dati, dove e se fuori dal SEE. I nostri server e i backup sono nell'UE (OVHcloud); una modifica è annunciata 30 giorni prima, con diritto di opposizione. Leggi tutto