Un destinatario automatico consente a NSE di applicare una firma o un sigillo a un documento senza alcuna interazione umana. Anziché inviare un link di firma a una persona, il passaggio di firma viene eseguito automaticamente lato server utilizzando un certificato di sigillo preconfigurato.
- Un certificato di sigillo è configurato in Impostazioni dell'organizzazione → Certificati di sigillo
- Il valore
signatureProfiledeve corrispondere esattamente al friendly name del certificato di eSealing configurato - Il feature flag "AutomaticRemoteSignature" è abilitato sull'organizzazione
- Un JWT Bearer token valido oppure un Personal Access Token
- L'ID organizzazione (
organizationId) - Un documento pronto per il caricamento
POST /api/v1/organizations/{organizationId}/envelopes
Content-Type: application/json{
"name": "Automatic Signing Envelope",
"expiration": {
"expiresAt": "2026-12-31T23:59:59.000Z",
"mode": "absolute"
}
}Salvare l'id restituito nella risposta come envelopeId.
POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files
Content-Type: multipart/form-datafile=@document.pdfSalvare l'id restituito nella risposta come fileId.
POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages
Content-Type: application/json{
"name": "Automatic Seal",
"requiredRecipientCompletions": 1,
"type": "automatic"
}Salvare l'id restituito nella risposta come stageId.
POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}/recipients
Content-Type: application/json{
"languageCode": "en",
"signatureProfile": "<profile-name>",
"type": "Automatic"
}Salvare l'id restituito nella risposta come recipientId.
POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}/tasks
Content-Type: application/json{
"tasks": [
{
"field": {
"fieldType": "AutomaticSignature",
"id": "1234",
"page": 1,
"positionX": 50,
"positionY": 200,
"width": 200,
"height": 60
},
"recipientId":"7117de33-1234-1234-1234-51809e7a3e20",
"sortOrder":1
}
]
}POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/sendLo stage viene eseguito immediatamente dopo l'invio. Il sigillo viene applicato automaticamente e la pratica si completa senza alcuna interazione umana.
Una volta completata la pratica, è possibile recuperare gli artifact tramite:
GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifactsSuccessivamente si può scaricare un artifact specifico (documento firmato o audit trail) utilizzando il relativo artifactId:
GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifacts/{artifactId}