Esiti e codici di errore

Manca l'header Authorization: Bearer.

Chiave sconosciuta, revocata o scaduta. Stessa risposta per tutti e tre i casi, così l'API non può confermare che una chiave sia mai esistita.

La chiave è valida ma la sua organizzazione non può operare: è sospesa, la sua registrazione non è ancora approvata (details.registration), è stata archiviata dopo un lungo periodo di inutilizzo (details.lifecycle è archived; chiedi di riattivarla, non è stato eliminato nulla) oppure è stata anonimizzata (details.lifecycle è anonymised).

La chiave è valida e l’organizzazione è attiva; il prodotto che hai chiamato non è attivo per lei. I tre sono venduti separatamente: composizione (/api/v1/compose/documents/*, /api/v1/compose/templates/*), firma (/api/v1/sign/*) e il flusso in una chiamata (/api/v1/flow/*). details.suite nomina quello che hai chiamato e details.enabled elenca quelli che puoi usare. Non viene addebitato nulla. L’amministratore della tua organizzazione vede lo stesso elenco in Impostazioni, e solo noi possiamo cambiarlo.

Hai chiesto qualcosa che la tua organizzazione non ha acquistato: un servizio fiduciario (settings.qeSeal o settings.qualifiedTimestamp impostato a true), un codice monouso via SMS (validationMode: "sms"), un'operazione massiva (/bulk/compose, /bulk/sign, /bulk/flow) o un livello di firma. Rifiutato su ogni API (composizione, firma e flusso allo stesso modo) e mai prodotto senza: a differenza delle impostazioni della tua organizzazione, che restituiscono il documento ordinario e lo segnalano con un avviso, questa non è visibile dal tuo lato, quindi un declassamento silenzioso non sarebbe rilevabile. details.feature indica quale (qeSeal, qualifiedTimestamp, smsValidation, bulkCompose, bulkSign, bulkFlow, signatureSes, signatureAes, signatureQes) e details.enabled elenca quelle che hai; GET /api/v1/usage mostra lo stesso elenco. Non viene addebitato nulla. Chiedi al tuo referente DoConure di attivarla; solo noi possiamo farlo.

La chiave è valida; l'indirizzo da cui è arrivata non è nella lista degli indirizzi consentiti della tua organizzazione. È distinto da INVALID_API_KEY di proposito — il passaggio a un nuovo server deve poter essere distinto da una chiave errata, e details.address riporta l'indirizzo, perché non è un segreto per il suo stesso proprietario.

Una pagina della console raggiunta senza sessione. Non viene restituito a chi chiama l'API.

La tua organizzazione può fare questa chiamata; al token che hai inviato non è stato concesso l’ambito che serve. Diverso da SUITE_NOT_ENABLED, che riguarda ciò che ha acquistato la tua organizzazione — questa è una restrizione del token stesso, dagli ambiti che hai scelto quando l’hai creato. details.missingScopes nomina cosa manca. Crea un token con l’ambito che ti serve; gli ambiti di un token esistente possono solo ridursi, mai crescere, quindi la soluzione è emetterne uno nuovo, non modificarlo.

Hai inviato isTest: true insieme a una funzione pagata presso un fornitore esterno: qeSeal, qualifiedTimestamp, un codice monouso via SMS (validationMode: "sms") o un livello AES/QES. Rifiutato prima che venga riservato, inviato o addebitato qualcosa — una chiamata di test non spende mai denaro e non viene mai declassata in silenzio. details.features le indica una per una. Invia la chiamata senza isTest, oppure senza la funzione.

Il lotto ha chiesto qualcosa che un'elaborazione massiva non può ancora fare: un sigillo o una marca temporale qualificata (addebitati a posteriori, quindi un lotto di questi potrebbe superare quanto riservato), una password del documento, un responseFormat (un elemento non ha una risposta propria) o un filename (un solo nome per molti file). details.fields li indica uno per uno. Non è stato riservato nulla; invia lo stesso lotto senza di essi, oppure invia quei documenti uno alla volta.

Hai inviato isTest: true a un'organizzazione le cui impostazioni richiedono un sigillo o una marca temporale qualificata su ogni documento (seal_mode / timestamp_mode = always). Una chiamata di test non ne compra mai uno, e un documento che la policy dice debba essere sigillato non viene mai restituito senza sigillo, quindi la chiamata viene rifiutata prima che qualcosa venga riservato, inviato o addebitato. details.features indica ciascuna. Invia la chiamata senza isTest, oppure cambia l'impostazione. Dove l'impostazione è solo facoltativa, isTest salta invece il sigillo con PAID_EXTRA_SKIPPED_ON_TEST.

Hai chiesto un qualifiedTimestamp senza un qeSeal (oppure il timestamp_mode della tua organizzazione è always e il documento non è sigillato). La marca temporale qualificata è un’opzione del sigillo qualificato e non viene mai applicata da sola, quindi la chiamata viene rifiutata prima che venga reso, riservato, inviato o addebitato qualsiasi cosa. Invia anche qeSeal: true, oppure togli qualifiedTimestamp; un documento sigillato senza marca temporale va bene. details.source dice se l’ha chiesta la richiesta o l’impostazione dell’organizzazione.

Nessun id di questo tipo, oppure appartiene a un altro tenant — volutamente indistinguibili.

Il modello è completamente disattivato. Attiva una versione nell’amministrazione.

Hai fissato un numero che non è mai stato creato. details.activeVersions elenca quelli esistenti.

Hai fissato una versione che esiste ma è disattivata. details.activeVersions ti dice cosa usare al suo posto.

Il modello esiste ed è attivo, ma nessuna sua versione è attiva.

Hai chiesto AES o QES. Sono in arrivo, nella prossima fase; oggi viene prodotta solo SES, e la richiesta viene rifiutata, mai declassata — secondo eIDAS sono oggetti giuridici diversi, quindi ricevere in silenzio una firma più debole sarebbe peggio che sentirsi dire di no. details.available elenca cosa può essere emesso. Vedi Livelli di firma: SES, AES, QES.

Un firmatario è stato impostato per la validazione via sms e il codice non può essere consegnato: la piattaforma non ha un fornitore SMS configurato (details.reason: provider_not_configured) oppure il numero è fuori dai paesi per cui il mittente è registrato (country_not_registered); details.signer nomina il firmatario. Viene rifiutato alla creazione della busta, prima che venga inviato qualsiasi cosa, invece di produrre una busta che nessuno può firmare o un codice che passa in silenzio all’email. Usa validationMode: "email" per quel firmatario.

Nessuna busta di questo tipo, oppure appartiene a un altro tenant — indistinguibili di proposito, come per i modelli.

È già stata inviata. Una busta si compone una volta e si invia una volta.

Completata, annullata, rifiutata o scaduta. details.status indica quale.

Il pacchetto delle prove è stato richiesto prima che la busta raggiungesse uno stato finale. details.status indica lo stato attuale.

Il documento esiste ma non è un PDF.

Ritirato il 2026-10-04 e mantenuto perché il numero non venga mai riutilizzato. Un PDF caricato (fileId, o il fileBase64 inline) è ora un'origine supportata per una busta, quindi nulla lo genera più. Se lo trovi in vecchi log, significava che un caricamento era stato rifiutato prima che i caricamenti esistessero.

Hai provato a eliminare un file archiviato (un PDF che hai caricato per farlo firmare, o qualsiasi file per fileId) mentre una busta aperta — una bozza, una inviata o una in corso — lo usa ancora. details.envelopeIds le nomina. Prima annullale o completale; un file usato solo da buste completate può essere eliminato, e i suoi byte vengono conservati come loro prova fino alla fine della loro conservazione.

Hai fissato uno sha256 accanto a un fileId e non è quello del file. Un file archiviato non cambia mai — una nuova versione è un nuovo caricamento con un nuovo fileId — quindi significa che l’id indica un file diverso da quello che intendevi.

Rivolto al firmatario. Un campo che il mittente ha reso obbligatorio (un testo, una casella da spuntare, una scelta da un elenco) è stato lasciato vuoto, oppure compilato con qualcosa che non è consentito. La firma non è stata acquisita: il firmatario corregge la risposta e firma di nuovo. details.fields li nomina uno per uno.

La consegna webhook che hai chiesto alla console di inviare di nuovo non esiste, oppure appartiene a un'altra organizzazione — indistinguibili di proposito.

callbackUrl.env non indica nessun ambiente di callback della tua organizzazione, oppure hai inviato un percorso senza env e nessun ambiente è quello predefinito. Rifiutato alla chiamata, prima che venga creato o addebitato qualcosa. details.known elenca i tuoi ambienti.

Un percorso di callback che potrebbe cambiare l'host (uno schema, //, @, .., una barra rovesciata o un frammento), un URL completo inviato insieme a env, oppure un percorso mescolato a un URL completo. Invia solo la parte finale dell'URL; l'host è nell'ambiente. details.reason indica quale.

È stato chiesto alla console di eliminare un ambiente di callback ancora indicato da buste aperte, lotti in corso o callback in coda. Attendi che si chiudano; details li conta.

Solo console, mai una risposta API. Non è stato possibile salvare un ambiente di callback: la sigla, l'URL di base, il tipo di autenticazione o le sue credenziali. details.field indica quale.

Un tag di firma nel documento, come {{ '{{ signature.C }}' }}, nomina un firmatario che la tua richiesta non contiene. Aggiungi il firmatario, oppure togli il tag dal modello. Un flusso viene rifiutato prima che venga composto o addebitato qualsiasi cosa quando il tag è nel modello; un tag scritto in un allegato caricato viene letto dopo la composizione. details.tags e details.signers indicano quali.

Il documento posiziona i firmatari con i tag di firma, e un firmatario non ha né un tag né fields, oppure il suo tag non era nel documento finito (per esempio dentro una condizione risultata falsa). Aggiungi un tag o fields per lui. details.signers li nomina.

Il firmatario ha scelto un modo di apporre il segno che l’organizzazione non consente. Non viene mai sostituito con uno consentito — chi ha disegnato il proprio nome e trovasse sul documento un nome digitato avrebbe firmato qualcosa che non ha fatto. La pagina di firma offre solo i modi che l’organizzazione accetta, quindi un firmatario incontra questo errore solo se invia comunque un altro modo, e allora gli viene mostrato di nuovo il modulo con il motivo.

Rivolto al firmatario. Ha provato a passare la richiesta a qualcun altro e non può farlo: l'organizzazione lo vieta per questa busta, oppure la richiesta è già passata di mano tutte le volte consentite.

Rivolto al firmatario. Il link è sconosciuto, già usato, oppure è stato annullato da una cancellazione.

Rivolto al firmatario. La scadenza della busta è passata. Crea una nuova busta.

Rivolto al firmatario. È una busta sequenziale, ed è il turno di qualcun altro.

Rivolto al firmatario. Quella persona ha già firmato; i link si usano una volta sola.

Rivolto al firmatario. Nessun codice valido: richiedine prima uno.

Rivolto al firmatario. Codice sbagliato. Il tentativo viene contato.

Riguarda il firmatario. Troppi tentativi errati su un codice, o troppi codici richiesti. Un nuovo codice azzera i tentativi.

Il destinatario non esiste in quella busta — compreso uno che appartiene a un altro tenant, che risponde come se fosse assente.

Riservato a un validationMode che questo servizio non supporta ancora. Non viene più sollevato per "sms" — quella modalità funziona, con un vero gateway SMS (rifiutata con SMS_VALIDATION_UNAVAILABLE dove un codice non può essere consegnato) — ma resta disponibile per la prossima modalità di validazione che verrà.

Riguarda il firmatario. Il gruppo di questo destinatario firma in modalità "OR" e qualcun altro del gruppo ha già firmato — la sua firma non è mai stata richiesta, e per quel link non resta nulla da fare.

Il flusso non esiste, oppure appartiene a un altro tenant — i due casi sono volutamente indistinguibili.

Il flusso è già terminato, è stato annullato oppure è scaduto.

Il corpo non corrisponde alla struttura attesa. details.fields indica ogni campo errato.

Lo stesso Idempotency-Key è arrivato con una richiesta diversa. Rispondere con l’esito della prima chiamata ti sembrerebbe in tutto e per tutto un successo, quindi la richiesta viene invece rifiutata. Usa una nuova chiave, oppure invia la stessa richiesta.

Una richiesta con questa chiave è ancora in corso. Da ritentare, con un Retry-After: stai facendo la cosa giusta, solo troppo presto.

La chiave è nota ma il suo risultato non può essere restituito di nuovo — la generazione era dataless e non ha conservato nulla, oppure il documento ha raggiunto la data di fine conservazione. details.jobId indica il lavoro: ti è stato addebitato una volta, non due, che è proprio ciò che volevi sapere ritentando.

Il lotto (o il file caricato) è malformato nel suo insieme: una riga che non è JSON, un elemento senza data, un externalId duplicato, un lotto vuoto, sia items sia fileId oppure nessuno dei due. details.problems ne elenca fino a venti, ciascuno con la sua line (un file) o il suo index (inline). Non è stato riservato né creato nulla; correggi l'input e invialo di nuovo.

Hai chiesto un qeSeal in una chiamata di composizione o di flusso che non porta alcun Idempotency-Key. Un nuovo tentativo dopo un timeout non potrebbe essere distinto da una nuova richiesta e comprerebbe un secondo sigillo presso il fornitore, cosa che non si può annullare. Invia l'header (una qualsiasi stringa univoca, riusata solo quando ritenti la stessa chiamata). Niente è stato riservato, inviato o addebitato.

Un file caricato è stato rifiutato: vuoto, non un PNG, JPEG, WebP o PDF in base ai suoi byte (gli SVG sono rifiutati), illeggibile, cifrato, un PDF con script, azioni di avvio, file incorporati o moduli che inviano dati, oppure un PDF con più di 500 pagine (200 per un PDF caricato per essere firmato). details.reason indica quale; non è stato conservato nulla.

Il corpo non è JSON leggibile.

Nessun endpoint a questo percorso: di solito un errore di battitura, o un percorso indovinato da un agente AI. details.reference rimanda a /openapi.json, dove ci sono tutti i percorsi. Una risorsa che non esiste ha il suo codice ..._NOT_FOUND.

Il percorso esiste, ma non con questo metodo (un POST dove è servito solo GET). details.allowed e l'header Allow elencano i metodi che accetta.

Il corpo JSON è annidato più in profondità, o contiene più valori, di quanto la piattaforma legga, ed è stato rifiutato prima di essere analizzato. details.limit è depth o nodes, con il valore in vigore. Un elenco lungo va in un'elaborazione massiva o in un file archiviato.

Un campo assente viene reso vuoto per impostazione predefinita — vedi Campi mancanti e in più — quindi questo errore si verifica solo quando il modello è impostato per rifiutare i dati incompleti, oppure quando un campo manca da un oggetto che il modello effettivamente raggiunge. details.fields / details.field li indica.

Il modello e il payload non si accordano: un campo presente e del tipo sbagliato. {% raw %}{{ importo + 1 }}{% endraw %} con "quarantadue" non può essere reso, e la tolleranza non lo copre — la tolleranza riguarda i campi assenti. details.problem indica il tipo di errore. Mai da ritentare: la stessa identica richiesta fallisce nello stesso identico modo. (Prima del 2026-09-19 questi casi rispondevano INTERNAL_ERROR, che è marcato da ritentare — così un chiamante che rispettava quel flag ritentava per sempre.)

Il payload non rispetta il JSON Schema del modello e quest'ultimo è impostato su payloadValidation: "reject". Viene rifiutato prima che venga riservato credito o occupato uno slot, quindi non costa nulla. details.violations elenca le prime violazioni come {path, keyword, message} (puntatore JSON nei tuoi data), details.count quante erano. Il valore errato non vi compare mai. Mai da ritentare: correggi i dati, oppure imposta il modello su warn.

Hai inviato settings.dataless: true a /api/v1/flow. Un documento in firma deve essere conservato — una firma senza nulla da mostrare non è una firma, e le sue prove sono conservate per dieci anni — quindi la richiesta viene rifiutata invece di essere soddisfatta a metà. Componilo su /api/v1/compose/documents/generate se non può essere conservato nulla. Rifiutato prima che venga generato o addebitato qualcosa.

Il corpo della richiesta supera i 25 MB, il massimo accettato da questo servizio, quindi niente è stato ricevuto o elaborato. Su /api/* e /verify.json la risposta è il consueto corpo di errore JSON (output.error incluso), come per ogni altro rifiuto; anche i tuoi limiti più bassi (un modello, un file caricato) vengono rifiutati con questo codice e indicano il limite nel messaggio.

Il file del modello salvato non si è potuto leggere o unire ai dati.

Rifiutato al caricamento: contiene macro, oppure è un archivio sospetto.

Il jsonSchema inviato con un modello o una versione non può essere applicato: non è un JSON Schema valido, usa una parola chiave fuori dal sottoinsieme supportato, contiene un $ref non locale allo schema, oppure supera i limiti di dimensione, profondità o pattern. Viene rifiutato al caricamento, così nessuna chiamata di composizione lo incontra mai. details.problems indica ciascun problema, con il suo percorso all'interno dello schema.

Nessun documento con quell'id, oppure appartiene a un'altra organizzazione.

Nessuna elaborazione massiva con quell'id, oppure appartiene a un'altra organizzazione — i due casi sono indistinguibili di proposito.

Nessun file massivo caricato con quell'id per la tua organizzazione, oppure un'elaborazione lo ha già usato, oppure è scaduto (un caricamento non usato entro la sua durata viene eliminato). Caricalo di nuovo.

Il pacchetto dei risultati di un'elaborazione massiva non può essere creato: l'elaborazione non è finita, oppure i risultati dei singoli elementi sono stati eliminati dalla conservazione. details.reason indica quale (job_not_finished, results_expired). I documenti seguono la propria conservazione.

Gli elementi falliti di un'elaborazione massiva non possono essere rimessi in coda: non è finita, nulla al suo interno è da ritentare, i dati non sono stati conservati (un'organizzazione che compone senza conservare i dati), oppure i suoi risultati sono scaduti. details.reason indica quale; details.skipped elenca gli elementi rifiutati uno per uno. Un elemento con esito sconosciuto non viene mai ripetuto.

Nessun file archiviato con quell’id per la tua organizzazione: non è mai esistito, è stato eliminato, è scaduto, oppure appartiene a un’altra organizzazione — la stessa risposta per tutti i casi. Caricalo di nuovo.

Il documento o il link di download che hai indicato da creare, elencare o revocare non è tuo, oppure non esiste.

L'indirizzo pubblico di download è sconosciuto, alterato, revocato, già usato (monouso) o non corrisponde più al suo documento — una sola risposta per tutti i casi, così non può essere sondato. Chiedi un nuovo link.

L'indirizzo di download era autentico ed è scaduto. Generane uno nuovo.

Il passaggio di unione non è riuscito per un motivo che non dipende dai dati.

La conversione in PDF non è riuscita, oppure non è riuscito un passaggio di post-elaborazione guidato da settings (esportazione PDF/A, conversione del colore).

La conversione o la post-elaborazione ha superato il tempo massimo.

Non è stato possibile raggiungere l'archivio dei modelli o dei documenti.

Qualsiasi errore non classificato.

Questa installazione non può eseguire ciò che hai chiesto — la piattaforma non offre il sigillo qualificato e la marca temporale (details.comingSoon: true, qualunque cosa abbia la tua organizzazione; sono in vendita ora, quindi è un interruttore che abbiamo spento noi), oppure non è configurato nessun certificato di sigillo o autorità di marcatura temporale, oppure un fornitore non offre quello che hai chiesto. Tocca a noi risolverlo, non a te, e per questo è distinto da FEATURE_NOT_ENABLED. Il documento viene rifiutato, prima che venga riservato o addebitato qualsiasi cosa, invece di essere restituito senza ciò che doveva contenere.

Il fornitore del sigillo o della marca temporale è stato interpellato e non è stato raggiungibile, oppure ci ha rifiutati — una connessione mai riuscita, un limite di frequenza, un guasto a monte. details.category contiene il motivo normalizzato. Da ritentare: la stessa identica richiesta funziona appena rispondono, e non deve cambiare nulla.

È stato chiesto un sigillo qualificato, tutto lo consentiva, e non è stato possibile applicarlo — quindi non viene restituito alcun documento. È voluto: una composizione si può rieseguire, e restituire un PDF non sigillato dove era stato chiesto un sigillo significherebbe attribuire al file una proprietà che non ha. Non è stato addebitato nulla per il sigillo. Non è indicato come da ritentare, perché il fornitore potrebbe aver eseguito l'operazione prima del guasto e un nuovo tentativo alla cieca potrebbe comprarne un secondo. details.category: "OUTCOME_UNKNOWN" è esattamente questo caso: il fornitore ha ricevuto la richiesta e la sua risposta è andata persa. Una busta si comporta diversamente di proposito — vedi SEAL_NOT_APPLIED.

Lo stesso, per la marca temporale qualificata.

Compare solo come error di un elemento massivo: l'elemento era ancora in attesa quando la sua elaborazione ha superato la scadenza, quindi non è stato eseguito. Il suo credito è stato liberato. Inseriscilo in un nuovo lotto.

Il fornitore del sigillo ha rifiutato perché il nostro account presso di lui non è completo. Tocca a noi sistemarlo e niente nella tua richiesta può cambiarlo: ti viene detto che il servizio è temporaneamente non disponibile, non viene addebitato nulla per il sigillo (quanto già pagato per esso all'invio viene restituito), e la stessa identica richiesta funziona appena lo abbiamo sistemato.

Il saldo prepagato non copre l'operazione: il credito è esaurito. details porta requestedCredits, currentBalance, reservedCredits, availableCredits e missingCredits, e un flusso indica il suo breakdown. L'intera richiesta viene rifiutata prima di qualsiasi lavoro, e niente è stato riservato.

Più di max_requests_per_minute chiamate negli ultimi 60 secondi. Porta Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Tutti gli slot di conversione di questa istanza sono occupati (limite misurato, non un limite per tenant). Contiene Retry-After; un chiamante corretto aspetta quel tempo prima di ritentare, invece di ritentare subito.

Un operatore ha messo in pausa la generazione su tutta la piattaforma — l’interruttore di emergenza che esiste per poter fermare un incidente senza un deploy. Nella tua richiesta non c’è niente di sbagliato e non devi cambiare nulla; la stessa identica chiamata riesce appena la pausa viene tolta. Contiene Retry-After.

Inviare questa busta porterebbe la tua organizzazione oltre il numero di indirizzi distinti a cui può scrivere nell’arco di 24 ore mobili — firmatari, cc e bcc insieme, su tutte le buste. La posta in uscita parte da un mittente condiviso, quindi questo limite protegge il recapito delle richieste di firma di tutti, non quello di un singolo account. Niente è stato addebitato e la busta non è stata toccata: è ancora una bozza e la stessa chiamata funziona domani. Il limite è più alto una volta che la tua organizzazione ha completato un acquisto, e un operatore può alzarlo ulteriormente per un cliente che invia davvero grandi volumi.

La tua organizzazione ha esaurito il suo pool giornaliero condiviso di elementi isTest (20 al giorno, salvo un numero diverso impostato da un operatore); viene rifiutata un’intera chiamata, mai ridotta a ciò che resta. details contiene requestedItems, remainingTestItems e dailyLimit. Non è stato addebitato nulla — una chiamata di test non tocca mai il credito. Il pool si azzera a mezzanotte UTC. Un elemento di test si consuma al tentativo, quindi anche una chiamata fallita e ritentata ne usa uno.

Una chiamata di test (isTest) è stata respinta per proteggere la produzione: c’era una richiesta di produzione in attesa, la quota di test degli slot di rendering era in uso, oppure la coda di test era piena. Non è stato riservato, addebitato né prelevato nulla dal pool di test. Contiene Retry-After; il traffico sandbox viene limitato per primo per scelta, quindi rallenta e riprova.

La coda per uno slot di rendering nella classe di questa richiesta è piena, quindi attendere sarebbe finito solo con SERVER_BUSY. Rifiutata prima di qualsiasi lavoro; niente è stato addebitato. Porta Retry-After.

La tua organizzazione ha già tanti documenti in elaborazione (o in attesa) quanti una singola organizzazione può averne contemporaneamente. Le altre organizzazioni non sono coinvolte. Non è stato addebitato nulla. Contiene Retry-After; inviare meno chiamate nello stesso momento lo evita.

Il lotto ha più elementi di quanti consentiti — il minore tra il tuo options.maxItems, il limite della tua organizzazione e quello della piattaforma, oppure, per un lotto isTest, il limite di test. Rifiutato per intero e mai ridotto. details.requestedItems e details.allowedItems indicano di quanto. Non è stato riservato nulla.

Il corpo dell'elaborazione massiva o il file caricato supera il suo limite di byte (details.limit). Per un lotto grande carica un file invece di inviare gli elementi nel corpo.

La tua organizzazione ha già tante elaborazioni massive in corso, elementi in coda, caricamenti non usati o invii nell'ultimo minuto quanti la piattaforma ne consente; details.what indica quale. Non è stato riservato nulla. Ritenta quando un'elaborazione finisce.

La piattaforma è in manutenzione programmata: ogni chiamata riceve questa risposta finché la manutenzione non termina, e niente viene eseguito o addebitato. details.state è on. Quando la manutenzione sta per iniziare è pending: le elaborazioni massive già in corso vengono completate, e una nuova elaborazione massiva (o un nuovo tentativo di una) viene rifiutata con questo codice; le chiamate singole funzionano ancora, e ogni risposta porta X-Maintenance-Pending con i secondi rimanenti. Porta Retry-After; la stessa identica chiamata funziona dopo.

Un singolo acquisto di credito supera EUR 1,000.00, IVA esclusa — il massimo consentito per un singolo acquisto (EUR 1,220.00 con l'IVA italiana). Viene rifiutato prima che venga aperto un ordine o chiamato un fornitore di pagamento: niente viene riservato o addebitato. Fai più acquisti, oppure contattaci (il modulo di contatto, o Segnala un problema nella console) per un importo maggiore. details.netCents e details.maximumNetCents dicono di quanto.

Un contatore del tuo piano (firme, documenti o chiamate) non ha più nulla per questa richiesta, e il pagamento con il credito dopo l’esaurimento è disattivato (l’impostazione predefinita). Rifiutata per intero prima che venga riservato o addebitato qualsiasi cosa: un batch non viene mai ammesso a metà, e un flusso non viene pagato a metà. Attiva Paga con il credito quando un contatore del piano è esaurito nella pagina Fatturazione, rinnova, oppure aspetta il periodo successivo. details.remaining e details.requested (per contatore), details.missing (cosa manca) e details.endsAt dicono a che punto sei. Un codice SMS a un firmatario non viene mai rifiutato in questo modo.

La tua organizzazione conserva già tanti file quanti la piattaforma ne consente. Eliminane alcuni, oppure attendi che scadano.

Hai chiesto un sigillo; l'organizzazione ha il sigillo disattivato. Il documento viene prodotto senza sigillo.

Lo stesso, per una marca temporale.

Hai chiesto di non sigillare; l’organizzazione sigilla tutto. Il documento viene sigillato, e addebitato.

Lo stesso, per una marca temporale.

Voluto da tutti, e questa piattaforma non ha alcun certificato di sigillo installato. Il problema è nostro, non tuo — niente nella tua richiesta può risolverlo.

Lo stesso, per l'autorità di marcatura temporale.

Configurato, voluto, tentato al completamento, e non ha funzionato. La busta è stata comunque completata: una terza parte irraggiungibile non fa mai perdere una firma già apposta.

Lo stesso. Compare sulla busta dopo che è stata completata, non sulla chiamata di creazione.

L’impostazione della tua organizzazione sigilla ogni documento, e il sigillo qualificato non è attivo sull’account. Il documento viene prodotto senza sigillo e non viene addebitato nulla. Lo vedi solo quando non hai chiesto nulla: una richiesta che lo chiede esplicitamente viene invece rifiutata con FEATURE_NOT_ENABLED, perché altrimenti qualcuno crederebbe a qualcosa di non vero.

Lo stesso, per la marca temporale qualificata.

Hai chiesto di consentire ai firmatari di passare la richiesta ad altri; l'organizzazione non lo permette. La busta viene creata e l'opzione è disattivata.

Hai chiesto di non consentirla; l'organizzazione la consente sempre.

Una chiamata di test ("isTest": true, oppure un’organizzazione di test). Il documento è gratuito e riporta TEST — NOT VALID su ogni pagina: non ha valore legale e non può essere scambiato per quello vero. Validate lo segnala prima che tu chiami. Invia la stessa chiamata senza isTest per ottenere il documento vero, che viene addebitato.

Tutti i tag di firma di un firmatario stavano dentro una condizione risultata falsa: quel firmatario non è sulla busta, non riceve email e non gli si chiede di firmare. details.signers li nomina. Se succede a tutti i firmatari, la richiesta è rifiutata con SIGNER_NOT_PLACED.

Il modello legge campi che il tuo payload non conteneva. Sono stati resi vuoti e il documento è stato prodotto, perché questo modello non è impostato per rifiutare dati incompleti (errorOnMissingFields). details.fields li nomina tutti — è l’avviso da leggere quando un PDF torna con dei vuoti.

Il renderer aveva qualcosa da segnalare durante la produzione di questo documento: un valore che ha accorciato, una sezione che non è comparsa, un confronto che non ha potuto fare. details.notes porta i testi e details.count quanti sono — tranne in una generazione senza dati, che riceve solo il conteggio, perché una nota cita i tuoi stessi valori.

Il payload non rispetta il JSON Schema del modello e quest'ultimo è impostato su warn (il valore predefinito), quindi il documento è stato prodotto comunque. details.violations elenca le prime violazioni come {path, keyword, message} e details.count quante erano. Un valore del tuo payload non vi compare mai, quindi è uguale anche in una generazione senza dati.

Il sigillo o la marca temporale su questo documento sono stati applicati da un fornitore simulato o non dichiarato qualificato (details.feature, details.simulated). La struttura è autentica e si verifica, ma non porta alcuna presunzione eIDAS di origine o di data e ora. La chiamata ha fatto ciò che dichiarava; tratta il documento di conseguenza. Gli stessi dati sono in output.compose.trust come qualified e simulated.

compressionLevel è stato richiesto e non applicato: il documento è convertito in PDF/A, è in bianco e nero, oppure la compressione non lo avrebbe reso più piccolo (details.reason: pdfa, blackwhite, not_smaller). Il documento è esattamente quello che produrrebbe la richiesta senza l'impostazione.

È stata eseguita una conversione PDF/A e il risultato non è stato validato con un validatore PDF/A, quindi non si dichiara alcuna conformità. output.compose.pdfa.verified è false. Valida tu il file se ci fai affidamento.

Una busta è stata annullata, è scaduta o è stata rifiutata dopo l'invio, quindi il sigillo e la marca temporale che aveva pagato sono stati restituiti al credito da cui provenivano. La firma non viene restituita: il lavoro di invio è stato fatto. details.units e details.credits indicano cosa è stato restituito.

Il sigillo o la marca temporale pagati all'invio non hanno potuto essere applicati quando l'ultimo firmatario ha finito (il fornitore o l'autorità non era disponibile o ha rifiutato), quindi sono stati restituiti subito. La busta si è completata senza, come indica SEAL_NOT_APPLIED.

La richiesta del sigillo ha raggiunto il fornitore e la risposta è andata persa. Non possiamo dire se sia stata eseguita, quindi è stato restituito subito e la richiesta non viene ripetuta: il rischio è nostro, non tuo. La busta si è completata senza il sigillo.

Questa generazione era dataless: il PDF che hai in mano è l'unica copia che esisterà mai, e nulla della richiesta è stato registrato. Arriva come header (X-Warning-Code) invece che nel corpo, perché il corpo di quella chiamata è il PDF. X-Document-Id è vuoto per lo stesso motivo. Vedi Generare un documento.

La tua organizzazione compone in modalità dataless e questa chiamata era un flusso, quindi il documento è stato conservato — è in firma. Quello che hai inviato non è stato comunque registrato. La metà che poteva essere rispettata lo è stata, e questo indica quale metà.

La tua organizzazione compone in modalità dataless e questo era un lotto massivo, quindi i suoi documenti sono stati conservati — un lotto risponde senza byte, e i documenti si scaricano dopo. Quello che hai inviato non è stato registrato, e i dati di ogni elemento vengono cancellati quando l'elemento finisce.

Questa è un'organizzazione di test, oppure una chiamata isTest la cui organizzazione ha un'impostazione che attiva qualcosa che costa denaro reale presso una terza parte (un sigillo o una marca temporale). Una chiamata che chiede essa stessa la funzione insieme a isTest viene invece rifiutata con FEATURE_NOT_AVAILABLE_IN_TEST_MODE (1009). Il rifiuto avviene prima dell'acquisto, qualunque cosa dicano le impostazioni dell'organizzazione — i documenti di test non valgono la spesa. Vale a ogni ingresso — composizione, busta e flusso. details.feature indica quale: qeSeal o qualifiedTimestamp. Usa l'organizzazione di produzione per vedere un documento sigillato.