Contrassegna un documento come firmato

Segna un documento come firmato quando è stata ottenuta una firma fisica o fuori banda. Puoi segnare l'intero documento come completato oppure segnare come completato un singolo destinatario se gli altri stanno ancora firmando. Puoi caricare un PDF firmato contemporaneamente.

Prerequisiti

• Il tuo ID documento (codificato in base64) — se hai un UUID REST, aggiungi il prefisso doc e codifica il risultato in base64 (es. doc + <your-document-uuid> → base64). Vedi Understand Web IDs and API IDs per dettagli.

Opzione A: Segna come firmato senza caricamento PDF

Chiama markAsComplete con isUploaded: false. Il campo declarationText è obbligatorio — usalo per registrare il motivo per cui il documento è stato segnato come completato (es. "Verbal confirmation received", "Wet signature obtained"). Può essere lasciato come stringa vuota, ma un valore significativo è utile ai fini dell’audit.

mutation MarkAsComplete {
  markAsComplete(input: {
    documentId: "<document-id>"
    declarationText: "Verbal confirmation received"
    isUploaded: false
  })
}

Opzione B: Segna come firmato con caricamento PDF

Passo 1: Ottieni un URL di caricamento pre-firmato

Chiama la query upload con uploadType: MARKASCOMPLETE per ottenere un URL S3 a breve termine.

query GetUploadUrl {
  upload(
    id: "<document-id>"
    uploadType: MARKASCOMPLETE
    extension: "pdf"
  ) {
    url
  }
}

Risposta:

{
  "data": {
    "upload": {
      "url": "https://lon-files-clearing.s3-accelerate.amazonaws.com/upload/..."
    }
  }
}

Passo 2: Invia il file a S3 con PUT

Carica il PDF firmato direttamente all’URL ricevuto usando una richiesta HTTP PUT con Content-Type: application/pdf. L’URL è a breve termine — usalo immediatamente. Vedi Upload files per maggiori dettagli sul passo PUT.

curl -X PUT \
  -H "Content-Type: application/pdf" \
  --data-binary @signed-copy.pdf \
  "<url from previous step>"

Passo 3: Segna il documento come completato

Chiama markAsComplete con isUploaded: true. Il campo declarationText funziona come nell’Opzione A.

mutation MarkAsComplete {
  markAsComplete(input: {
    documentId: "<document-id>"
    declarationText: "Signed copy received by post"
    isUploaded: true
  })
}

Segna come firmato un singolo destinatario

Usa markRecipientAsComplete quando una parte ha firmato fuori banda ma le altre no.

Se vuoi caricare un PDF firmato per il destinatario, prima ottieni un URL pre-firmato usando uploadType: MARKRECIPIENTASCOMPLETE:

query GetUploadUrl {
  upload(
    id: "<recipient-id>"
    uploadType: MARKRECIPIENTASCOMPLETE
    extension: "pdf"
  ) {
    url
  }
}

Poi invia il file all’URL ricevuto con PUT — vedi Upload files.

Campi chiave:

• suppressNextRecipientNotification — impostalo a true per evitare che il prossimo destinatario nell’ordine di firma venga notificato immediatamente.
• auditlogText — opzionale. Lascialo vuoto se non serve, ma un valore significativo è utile ai fini dell’audit.

Poi chiama markRecipientAsComplete:

mutation MarkRecipientAsComplete {
  markRecipientAsComplete(input: {
    recipientId: "<recipient-id>"
    documentOptions: NONE
    suppressNextRecipientNotification: false
    auditlogText: "Signed copy received by post"
  }) {
    id
    uploadId
  }
}

Archivia il documento (opzionale)

Una volta segnato come completato, puoi archiviare il documento per rimuoverlo dalla vista dei documenti attivi.

mutation ArchiveDocument {
  archiveDocument(input: {
    documentId: "<document-id>"
    restore: false
  })
}

Imposta restore: true per ripristinare.

Correlati

• Authenticate
• markAsComplete
• markRecipientAsComplete
• upload query