Certyneo (anteprima)

Inviare documenti per la firma elettronica conforme a eIDAS, creare buste da modelli e attivare flussi su eventi di firma, ad esempio inviati, firmati, completati e rifiutati.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service Classe Regions
Copilot Studio Premium Tutte le aree Power Automate ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Logic Apps Standard Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - aree Azure per enti pubblici
     - Aree di Azure Cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Premium Tutte le aree Power Apps ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate Premium Tutte le aree Power Automate ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Contatto
Name Supporto di Certyneo
URL https://certyneo.com/fr/contact
Email support@certyneo.com
Metadati del connettore
Editore Certyneo
Website https://certyneo.com
Informativa sulla privacy https://certyneo.com/fr/legal/privacy
Categorie Operazioni IT; Produttività

Certyneo

Certyneo è un servizio di firma elettronica conforme a eIDAS. Questo connettore consente a un flusso di inviare documenti per la firma, reagire in tempo reale quando un firmatario agisce e inviare il file PDF firmato e il relativo file di prova ovunque il resto dell'azienda mantenga i propri record.

Il flusso tipico è costituito da tre passaggi: un documento si trova da qualche parte (una raccolta documenti, una cassetta postale, un invio di modulo), il flusso crea e invia una busta e un secondo flusso attivato da envelope.completed scarica il PDF firmato e lo archivia.

Editore

Certyneo

Prerequisiti

È necessario un account Certyneo in un piano che include l'accesso all'API. I piani gratuito e personale possono creare chiavi API e sottoscrivere eventi, ma ricevono solo eventi per buste sandbox. Vedere problemi noti e limitazioni di seguito.

Come ottenere le credenziali

Il connettore esegue l'autenticazione con una chiave API Certyneo.

  1. Accedere a Certyneo e aprire Impostazioni → chiavi API.
  2. Creare una chiave. Le chiavi attive iniziano con sk_live_, le chiavi sandbox con sk_test_.
  3. Quando il connettore richiede la chiave API, incollare la parola Bearer, uno spazio e quindi la chiave , ad esempio Bearer sk_live_abc123. Certyneo si aspetta la parola Bearer davanti alla chiave e una chiave incollata da sola viene rifiutata con 401.

La chiave contiene ambiti. Una chiave senza envelopes:write non può creare o inviare e una chiave senza webhooks:write non può restituire il trigger. Concedere agli ambiti effettivamente necessari il flusso.

Test senza inviare messaggi di posta elettronica a nessuno

Una chiave sandbox (sk_test_) esercita l'intera pipeline senza inviare un singolo messaggio di posta elettronica di invito. Nulla raggiunge una posta in arrivo reale, che significa anche che nessuno può raggiungere la pagina di firma da un messaggio di posta elettronica, quindi Crea busta e Invia busta restituisce invece un token di accesso per ogni destinatario. Aprire https://certyneo.com/sign/<access token> per firmare manualmente la busta di prova.

Considera il token come credenziale: chiunque possa firmare come tale destinatario. Non registrarlo e non rilasciarlo in un foglio di calcolo.

Operazioni supportate

Trigger

Quando si verifica un evento envelope : genera gli eventi selezionati, supportati da un webhook reale anziché dal polling. Eventi disponibili:

envelope.created, envelope.sent, , envelope.declined, envelope.voidedenvelope.expired, envelope.returned_to_sender, envelope.resubmittedrecipient.signed, , recipient.viewed. recipient.approvedenvelope.completed

Ogni payload contiene l'ID busta, sia per gli eventi envelope che per i destinatari. Ovvero il valore da inserire nelle azioni seguenti.

Le consegne vengono firmate con HMAC-SHA256 nell'intestazione X-Certyneo-Signature , ovvero un digest esadecimale del corpo JSON non elaborato, con chiave con il segreto della sottoscrizione. Verificarlo prima che un flusso agisca sul payload.

Azioni

Action Funzionamento
Elencare i modelli I modelli di busta salvati. Consente di selezionare il modello.
Crea busta Crea una busta BOZZA, da un modello o da documenti caricati.
Invia busta Invia una busta DRAFT ai destinatari.
Ottieni busta Stato corrente e dettagli destinatario.
Elencare le buste Elenco impaginato, filtrabile in base allo stato.
Caricare il documento Carica un PDF o un'immagine e restituisce un ID documento.
Scaricare il documento firmato Pagina pdf firmata, certificato inclusa.
Scaricare il audit trail Il file di prova: chi ha firmato, quando, da quale IP, con quali fattori.
Elimina busta bozza Elimina una busta che non è mai stata inviata.

Problemi noti e limitazioni

Non è possibile richiamare una busta inviata da un flusso.Elimina busta bozza accetta solo buste ancora in BOZZA, ovvero un flusso che non è riuscito a metà, un documento errato. Una volta che una busta è uscita, restituisce 409 e non è attualmente presente alcuna operazione di annullamento nell'API.

recipient.signed viene generato prima dell'esistenza del PDF firmato, incluso per l'ultimo firmatario. L'assemblaggio e la chiusura del documento finale si verifica dopo tale evento, quindi un flusso che recipient.signed attiva e chiama immediatamente Download signed document ottiene 409 ogni volta. Questa non è una gara che si può vincere con un ritardo - trigger invece envelope.completed , che si attiva una volta che il PDF è sul disco.

I piani gratuito e personale ricevono solo eventi sandbox. Entrambi possono creare una sottoscrizione e il trigger verrà visualizzato come integro, ma le buste in tempo reale non lo raggiungono mai. Se un trigger sembra non eseguire alcuna operazione sul traffico reale, controllare il piano prima di qualsiasi altra operazione.

Usare un modello o documenti, mai entrambi. Un modello porta i propri documenti e i propri campi di firma. Quando invece si compilano documenti caricati, è necessario specificare Campi , ovvero una busta il cui firmatario non ha alcuna posizione per firmare viene rifiutato al momento dell'invio con 409 signer_without_field, non in fase di creazione.

Preferisce il testo di ancoraggio rispetto alle coordinate. L'inserimento di un campo tra virgolette dal documento ("Signature du client") sopravvive a una modifica del layout e non richiede alcuna misurazione. X e Y rimangono come fallback in modo che un campo il cui ancoraggio non venga trovato mantiene una posizione letterale anziché scomparire.

I caricamenti sono limitati a 50 MB per documento.

Un documento eliminato restituisce 410, non 409. 409 significa "non ancora pronto, tornare dopo envelope.completed". 410 indica che il documento firmato è stato deliberatamente eliminato con i criteri di conservazione e non viene mai restituito. Un ciclo di ripetizione dei tentativi dovrebbe rinunciare alla versione 410.

Errori e rimedi comuni

risposta Cause Rimedio
401 Chiave mancante o incollata senza Bearer davanti Immettere nuovamente la connessione come Bearer sk_live_...
403 La chiave non ha l'ambito per questa operazione Rimettere la chiave con gli ambiti necessari per il flusso
409 al download La busta non è ancora COMPLETATA envelope.completed Attiva invece di eseguire il polling
409 all'invio signer_without_field — un firmatario non ha un campo di firma Aggiungere campi o compilare da un modello
409 all'eliminazione La busta è già stata inviata Le buste inviate non possono essere eliminate o richiamate
410 al download Il documento è stato eliminato con i criteri di conservazione Smettila di riprovare; il file non è più disponibile

Gli errori contengono sia un messaggio leggibile error che un elemento stabile code. Branch on code : il messaggio può essere riformulato.

Support

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Predefinita Parametri per la creazione della connessione. Tutte le aree geografiche Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Name Type Description Obbligatorio
Chiave API securestring Chiave API per questa API True

Azioni

Caricare il documento

Caricare un PDF o un'immagine (massimo 50 MB). Restituisce un ID documento, passarlo a "Crea busta" in "Documenti".

Crea busta

Creare una nuova busta nello stato BOZZA, da un modello salvato o direttamente dai documenti caricati con "Carica documento". Compilare esattamente uno dei "Modelli" o "Documenti". Con i documenti, aggiungere anche "Campi" in modo che ogni firmatario abbia un punto da firmare, il modo più semplice consiste nel citare una frase del documento in "Testo ancoraggio" invece di lavorare le coordinate. IMPORTANTE: questa azione crea solo la busta: non viene ancora inviato alcun messaggio di posta elettronica. Aggiungere l'azione "Invia busta" subito dopo questa nel flusso per inviarla effettivamente ai destinatari.

Elencare i modelli

Restituisce i modelli di busta salvati. Usato per attivare la selezione modello su "Crea busta".

Elencare le buste

Recuperare un elenco impaginato di buste.

Elimina busta bozza

Eliminare una busta che non è mai stata inviata, ovvero un flusso che non è riuscito a metà, un documento errato. BOZZA solo: una volta esaurita una busta, viene restituito un errore e non è possibile richiamarlo da un flusso.

Invia busta

Inviare una busta BOZZA ai destinatari per la firma: questo è il passaggio che invia effettivamente il messaggio di posta elettronica. "Crea busta" lo salva solo come bozza; non invia nulla da solo. Concatena sempre questa azione subito dopo "Crea busta" nel flusso, usando l'ID busta restituito.

Ottieni busta

Ottenere lo stato corrente e i dettagli di una busta.

Scaricare il audit trail

Ottenere il file di prova per una busta completata, che ha firmato, quando, da cui IP, con quali fattori di autenticazione. Archiviarlo insieme al PDF firmato: è ciò che una controversia eIDAS attiva.

Scaricare il documento firmato

Ottenere il PDF firmato, pagina del certificato inclusa. Una volta completata la busta, prima di restituire 409, quindi attivare "Envelope completed" anziché eseguire il polling.

Caricare il documento

Caricare un PDF o un'immagine (massimo 50 MB). Restituisce un ID documento, passarlo a "Crea busta" in "Documenti".

Parametri

Nome Chiave Necessario Tipo Descrizione
File
file True file

Il PDF o l'immagine da caricare, al massimo 50 MB.

Nome documento
name string

Nome in cui archiviare il documento. L'impostazione predefinita è il nome del file caricato.

Valori restituiti

Corpo
Document

Crea busta

Creare una nuova busta nello stato BOZZA, da un modello salvato o direttamente dai documenti caricati con "Carica documento". Compilare esattamente uno dei "Modelli" o "Documenti". Con i documenti, aggiungere anche "Campi" in modo che ogni firmatario abbia un punto da firmare, il modo più semplice consiste nel citare una frase del documento in "Testo ancoraggio" invece di lavorare le coordinate. IMPORTANTE: questa azione crea solo la busta: non viene ancora inviato alcun messaggio di posta elettronica. Aggiungere l'azione "Invia busta" subito dopo questa nel flusso per inviarla effettivamente ai destinatari.

Parametri

Nome Chiave Necessario Tipo Descrizione
Subject
subject True string

Oggetto busta/titolo.

Message
message string

Messaggio visualizzato ai destinatari.

Template
templateId string

Selezionare un modello salvato. Usare questo OR "Documents", non entrambi: un modello contiene i propri documenti e campi di firma.

Documents
documentIds array of string

ID documento da "Carica documento". Usare questo OR "Template", non entrambi. Quando si usano documenti, aggiungere anche "Campi", una busta il cui firmatario non dispone di un campo di firma viene rifiutato al momento dell'invio.

Messaggio di posta elettronica del firmatario
recipientEmail True string

Deve corrispondere esattamente a uno dei destinatari precedenti.

Numero documento
documentIndex integer

Quale documento contiene questo campo, contando da 0 nell'ordine indicato in precedenza. Lasciare vuoto quando è presente un solo documento.

Pagina
pageNumber True integer
Tipo di campo
fieldType True string
Testo di ancoraggio (scelta consigliata)
anchorText string

Testo da cercare nel documento: il campo viene posizionato accanto a esso, quindi non sono necessarie coordinate. Senza distinzione tra maiuscole e minuscole e trovato anche quando il PDF divide la frase tra le esecuzioni. Lasciare vuoto per usare invece X/Y.

Posizionamento dell'ancoraggio
anchorPlacement string

Dove inserire il campo relativo al testo di ancoraggio.

Occorrenza dell'ancoraggio
anchorIndex integer

Occorrenza da usare, contando da 0, quando il testo di ancoraggio viene visualizzato più volte.

X
x True number

Punti dal bordo sinistro. Ignorato quando viene trovato l'ancoraggio, mantenuto come fallback, in modo che il campo non svanisca mai.

Y
y True number

Punti dal bordo SUPERIORE. Ignorato quando viene trovato l'ancoraggio, mantenuto come fallback.

Larghezza
width True number
Altezza
height True number
Messaggio di posta elettronica destinatario
email True string
Nome del destinatario
name string
Role
role string
stato
status string
signedAt
signedAt string
Token di accesso
accessToken string

Apre la pagina di firma del destinatario in corrispondenza https://certyneo.com/sign/<del token>. Nella sandbox non viene visualizzato alcun messaggio di posta elettronica di invito, quindi questo è il modo in cui si firma una busta di test manualmente. Restituito da "Crea busta" e "Invia busta" - non da "Get envelope", dove rimane vuoto. Considerarlo come credenziale: chiunque lo contenga può firmare come destinatario, quindi non registrarlo o rilasciarlo in un foglio di calcolo.

Livello di firma
signatureLevel string
Scade il
expiresAt date-time
Category
category string

Classificazione aziendale visualizzata nell'elenco delle buste. Lasciare vuoto e Certyneo deduce uno dall'oggetto.

Tag
tags array of string

Etichette in formato libero: codice del progetto, riferimento del cliente, stato interno. Fino a 10, ognuno con un massimo di 40 caratteri. Lato server in minuscolo e deduplicato.

Language
locale string

Lingua di tutto ciò che il firmatario vede: pagina di firma, invito, promemoria, messaggio di posta elettronica di completamento. Codice BCP-47, ad esempio nl, nl-BE, en-GB, de, fr. Lasciare vuoto per ereditare la lingua dell'account Certyneo che invia la busta. Un codice non supportato viene rifiutato con 400.

URL di reindirizzamento
redirectUrl string

Posizione in cui il firmatario viene inviato dopo la firma. Sostituisce il metodo predefinito Certyneo call-to-action con un singolo pulsante "Continua" che punta qui. Deve iniziare con https:// : qualsiasi altra cosa viene rifiutata con 400.

Iniziali in ogni pagina
initialsOnEveryPage boolean

Contrassegnare automaticamente le iniziali del firmatario nella parte inferiore di ogni pagina di ogni documento, oltre a qualsiasi campo posizionato manualmente. Nessuna configurazione per pagina necessaria: il firmatario riempie le proprie iniziali una volta e si applica ovunque. Ignora una pagina in cui il firmatario dispone già di un campo , ad esempio la firma nell'ultima pagina.

Workspace
workspaceId string

Creare la busta in un'area di lavoro condivisa in modo che ogni membro dell'area di lavoro possa visualizzarla e seguirla. Lasciare vuoto per mantenerlo nel proprio account. È necessario essere proprietari dell'area di lavoro o essere membri di esso.

Valori restituiti

Corpo
Envelope

Elencare i modelli

Restituisce i modelli di busta salvati. Usato per attivare la selezione modello su "Crea busta".

Valori restituiti

Corpo
TemplateList

Elencare le buste

Recuperare un elenco impaginato di buste.

Parametri

Nome Chiave Necessario Tipo Descrizione
Pagina
page integer

Pagina dei risultati da restituire. Inizia da 1.

Dimensioni della pagina
limit integer

Numero di buste da restituire per pagina.

Stato
status string

Restituisce solo le buste in questo stato. Lasciare vuoto per restituire ogni stato.

Valori restituiti

Corpo
EnvelopeList

Elimina busta bozza

Eliminare una busta che non è mai stata inviata, ovvero un flusso che non è riuscito a metà, un documento errato. BOZZA solo: una volta esaurita una busta, viene restituito un errore e non è possibile richiamarlo da un flusso.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID busta
id True string

Identificatore della busta bozza da eliminare.

Valori restituiti

Corpo
DeleteResult

Invia busta

Inviare una busta BOZZA ai destinatari per la firma: questo è il passaggio che invia effettivamente il messaggio di posta elettronica. "Crea busta" lo salva solo come bozza; non invia nulla da solo. Concatena sempre questa azione subito dopo "Crea busta" nel flusso, usando l'ID busta restituito.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID busta
id True string

Identificatore della busta bozza da inviare ai destinatari.

Valori restituiti

Corpo
Envelope

Ottieni busta

Ottenere lo stato corrente e i dettagli di una busta.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID busta
id True string

Identificatore della busta da recuperare.

Valori restituiti

Corpo
Envelope

Scaricare il audit trail

Ottenere il file di prova per una busta completata, che ha firmato, quando, da cui IP, con quali fattori di autenticazione. Archiviarlo insieme al PDF firmato: è ciò che una controversia eIDAS attiva.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID busta
id True string

Identificatore della busta di cui scaricare il audit trail.

Valori restituiti

response
binary

Scaricare il documento firmato

Ottenere il PDF firmato, pagina del certificato inclusa. Una volta completata la busta, prima di restituire 409, quindi attivare "Envelope completed" anziché eseguire il polling.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID busta
id True string

Identificatore della busta di cui si desidera scaricare il documento firmato.

Valori restituiti

response
binary

Trigger

Quando si verifica un evento envelope

Attiva un flusso ogni volta che si verifica uno degli eventi selezionati in una delle buste,ad esempio firmate, completate, rifiutate. Supportato da un webhook in tempo reale, senza polling.

Quando si verifica un evento envelope

Attiva un flusso ogni volta che si verifica uno degli eventi selezionati in una delle buste,ad esempio firmate, completate, rifiutate. Supportato da un webhook in tempo reale, senza polling.

Parametri

Nome Chiave Necessario Tipo Descrizione
Events
events True array of string

Quali eventi envelope/destinatario devono attivare questo flusso.

Valori restituiti

Recapitato con HMAC-SHA256 nell'intestazione X-Certyneo-Signature (digest esadecimale del corpo JSON non elaborato, con chiave con il segreto della sottoscrizione). Verificarlo prima di considerare attendibile il payload in un flusso che agisce su di esso (vedere /developers/webhooks).

Definizioni

DeleteResult

Nome Percorso Tipo Descrizione
Operazione completata
success boolean

True quando la risorsa è stata eliminata.

Pagination

Nome Percorso Tipo Descrizione
totale
total integer
pagina
page integer
pageSize
pageSize integer
Pagine
pages integer

Template

Nome Percorso Tipo Descrizione
id
id string
nome
name string
description
description string
signerCount
signerCount integer
documentCount
documentCount integer

TemplateList

Nome Percorso Tipo Descrizione
Dati
data array of Template
Paginazione
pagination Pagination

Recipient

Nome Percorso Tipo Descrizione
Messaggio di posta elettronica destinatario
email string
Nome del destinatario
name string
Role
role string
stato
status string
signedAt
signedAt string
Token di accesso
accessToken string

Apre la pagina di firma del destinatario in corrispondenza https://certyneo.com/sign/<del token>. Nella sandbox non viene visualizzato alcun messaggio di posta elettronica di invito, quindi questo è il modo in cui si firma una busta di test manualmente. Restituito da "Crea busta" e "Invia busta" - non da "Get envelope", dove rimane vuoto. Considerarlo come credenziale: chiunque lo contenga può firmare come destinatario, quindi non registrarlo o rilasciarlo in un foglio di calcolo.

Documento

Nome Percorso Tipo Descrizione
id
id string
nome
name string
tipo MIME
mimeType string
size
size integer
stato
status string

Busta

Nome Percorso Tipo Descrizione
id
id string
subject
subject string
message
message string
stato
status string
signatureLevel
signatureLevel string
recipients
recipients array of Recipient
expiresAt
expiresAt string
createdAt
createdAt string
completedAt
completedAt string

EnvelopeList

Nome Percorso Tipo Descrizione
Dati
data array of Envelope
Paginazione
pagination Pagination

WebhookEventPayload

Recapitato con HMAC-SHA256 nell'intestazione X-Certyneo-Signature (digest esadecimale del corpo JSON non elaborato, con chiave con il segreto della sottoscrizione). Verificarlo prima di considerare attendibile il payload in un flusso che agisce su di esso (vedere /developers/webhooks).

Nome Percorso Tipo Descrizione
evento
event string
timestamp
timestamp date-time
ID busta
data.envelopeId string

Sempre presente. Inserirlo in "Ottieni busta" o "Scarica documento firmato".

Subject
data.subject string

Presente solo per gli eventi envelope.

Stato
data.status string
Livello di firma
data.signatureLevel string

Presente su envelope.completed e recipient.signed.

Firmatari di firma avanzati con una chiave personale
data.aesSignerCount integer

envelope.completed solo su una busta ADVANCED.

Seriale del certificato di firma avanzata
data.aesCertificateSerial string

recipient.signed, quando il firmatario ha firmato con una chiave di firma avanzata personale.

Certificato di firma avanzato SHA256
data.aesCertificateSha256 string

recipient.signed, quando il firmatario ha firmato con una chiave di firma avanzata personale.

Manifesto della firma avanzato SHA256
data.aesManifestSha256 string

recipient.signed, quando il firmatario ha firmato con una chiave di firma avanzata personale.

Timestamp della firma avanzata
data.aesTimestamped boolean

recipient.signed, quando il firmatario ha firmato con una chiave di firma avanzata personale.

Numero dei destinatari
data.recipientCount integer

Presente solo per gli eventi envelope.

Conteggio con segno
data.signedCount integer

Presente solo per gli eventi envelope.

ID destinatario
data.recipientId string

Presente solo per gli eventi del destinatario.

Messaggio di posta elettronica destinatario
data.email string

Presente solo per gli eventi del destinatario.

Nome del destinatario
data.name string

Presente solo per gli eventi del destinatario.

Ruolo destinatario
data.role string

Presente solo per gli eventi del destinatario.

Firmato all'indirizzo
data.signedAt date-time

Presente solo per gli eventi del destinatario.

Visualizzato all'indirizzo
data.viewedAt date-time

Presente solo per gli eventi del destinatario.

binary

Questo è il tipo di dati di base 'binario'.