Condividi tramite

Portale dokobit

Usare il portale Dokobit con tutte le funzionalità che ha, ma renderlo automatizzato in modo che non sia necessario perdere tempo nel processo amministrativo. Mettere insieme un puzzle del processo di firma dei documenti automatizzato solo dalle parti necessarie: firma, condivisione, download o eliminazione di documenti, rimozione e sostituzione dei firmatari, recupero di informazioni dettagliate sui firmatari e sulle informazioni sulla firma.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio Class Regions
Copilot Studio Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - China Cloud gestito da 21Vianet
App per la logica Normale Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure Cina
Power Apps Di alta qualità Tutte le aree di Power Apps , ad eccezione dei seguenti:
     - China Cloud gestito da 21Vianet
Power Automate Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - China Cloud gestito da 21Vianet
Contatto
Nome Dokobit
URL https://support.dokobit.com
Email developers@dokobit.com
Metadati del connettore
Editore Dokobit
Sito web https://www.dokobit.com/solutions
Informativa sulla privacy https://www.dokobit.com/compliance/privacy-policy
Categorie Produttività

Usare il portale Dokobit con tutte le funzionalità che ha, ma renderlo automatizzato in modo che non sia necessario perdere tempo nel processo amministrativo. Mettere insieme un puzzle del processo di firma dei documenti automatizzato solo dalle parti necessarie: firma, condivisione, download o eliminazione di documenti, rimozione o sostituzione di firmatari, recupero di dettagli sui firmatari e informazioni sulla firma.

Prerequisiti

Il connettore Flusso del portale Dokobit richiede un token di accesso all'API portale valido.

Come ottenere le credenziali?

  • Per ottenere il token di accesso all'API, contattare il reparto Vendite.

Problemi noti e limitazioni

L'implementazione corrente supporta la raccolta di firme solo nei file PDF o in qualsiasi tipo di file nei contenitori ASiCe. Sono supportati anche i contenitori ADoc già formati.

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.

Nome TIPO Description Obbligatorio
Chiave API securestring Chiave API per questa API Vero

Limiti per la limitazione delle richieste

Nome Chiamate Periodo di rinnovo
Chiamate API per connessione 100 60 secondi

Azioni

Portale - Controllare lo stato della firma

Restituisce le informazioni del documento con stato di firma.
Portale - Convalida

Dokobit è un provider di servizi certificato eIDAS per le convalide di e-seal e-seal qualificate. Usare questa azione per caricare un file firmato per la convalida. Tipi di file supportati: .asice - application/vnd.etsi.asic-e+zip|.asics - application/vnd.etsi.asic-s+zip|.sce - application/vnd.etsi.asic-e+zip|.bdoc - application/vnd.etsi.asic-e+zip|.edoc - application/vnd.etsi.asic-e+zip|.pdf - application/pdf|.p7s - application/pkcs7-signature|.xml - application/xml
Portale - Convalida - Dati di diagnostica XML

Scaricare i dati di diagnostica in XML.
Portale - Convalida - Report PDF

Scaricare il report di convalida in FORMATO PDF.
Portale - Convalida - Report PDF dettagliato

Scarica report di convalida dettagliati in PDF.
Portale - Convalida - Report XML

Scaricare il report di convalida in XML.
Portale - Creare la firma

Creare un file PDF, ASIC o ADOC per la firma.
Portale - Eliminare il partecipante dalla firma

L'accesso al documento verrà revocato per il partecipante indicato.
Portale - Eliminare la firma

Il documento verrà rimosso dall'account del proprietario. Rimarrà accessibile ad altri partecipanti.
Portale - Eliminare la firma per tutti

Il documento verrà rimosso dall'account del proprietario e da altri partecipanti che non hanno ancora firmato il documento.
Portale - Firma del sigilli

Il documento verrà bloccato con il sigillo elettronico delle organizzazioni. Contattare il nostro supporto all'indirizzo developers@dokobit.com per ottenere un certificato qualificato per l'e-sealing.
Portale - Firma dell'aggiornamento

Consente di aggiornare gli attributi di una firma di documento esistente.
Portale - Firma di condivisione

I partecipanti indicati otterranno l'accesso al documento con il ruolo selezionato.
Portale - Invia promemoria

Consente di inviare un messaggio di posta elettronica di promemoria per il partecipante, solo se la persona non ha ancora firmato il documento.
Portale - Ottenere l'elenco delle firme

Restituisce un elenco di tutti i documenti disponibili per il proprietario dell'account.
Portale - Scarica documento

Scarica il documento firmato.

Portale - Controllare lo stato della firma

ID operazione:
Portal-CheckSigningStatus

Restituisce le informazioni del documento con stato di firma.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token di firma

Restituisce

Nome Percorso Tipo Descrizione
status
 status string

Stato della firma
nome
 name string

Nome firma
scadenza
 deadline date-time

Esempio: 2019-11-25T13:15:30Z
filename
 filename string

Nome del file
URL
 signed_file.url string

URL del file firmato
Firmatari
 signers array of object

Informazioni sui partecipanti
token
 signers.token string

Token del partecipante
first_name
 signers.first_name string

Nome del partecipante
last_name
 signers.last_name string

Cognome del partecipante
codice
 signers.code string

Codice del partecipante
country
 signers.country string

Paese del partecipante
posta elettronica
 signers.email string

Posta elettronica del partecipante
type
 signers.type string

TIPO
status
 signers.status string

Stato del partecipante
Nome modello
 template.name string

Nome modello
Tempalte Token
 template.token string

Token tempalte

Portale - Convalida

ID operazione:
Portal-Validation

Dokobit è un provider di servizi certificato eIDAS per le convalide di e-seal e-seal qualificate. Usare questa azione per caricare un file firmato per la convalida. Tipi di file supportati: .asice - application/vnd.etsi.asic-e+zip|.asics - application/vnd.etsi.asic-s+zip|.sce - application/vnd.etsi.asic-e+zip|.bdoc - application/vnd.etsi.asic-e+zip|.edoc - application/vnd.etsi.asic-e+zip|.pdf - application/pdf|.p7s - application/pkcs7-signature|.xml - application/xml

Parametri

Nome Chiave Necessario Tipo Descrizione
nome
 name True string

Nome file.
contenuto
 content True string

Contenuto di file con codifica Base64.

Restituisce

Nome Percorso Tipo Descrizione
status
 status string

Stato caricamento
token
 token string

Token di convalida

Portale - Convalida - Dati di diagnostica XML

ID operazione:
Portal-Validation-XMLDiagnosticData

Scaricare i dati di diagnostica in XML.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token del file di convalida ricevuto dall'azione di Portal-Validation

Restituisce

response
object

Portale - Convalida - Report PDF

ID operazione:
Portal-Validation-PDFReport

Scaricare il report di convalida in FORMATO PDF.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token del file di convalida ricevuto dall'azione di Portal-Validation

Restituisce

response
object

Portale - Convalida - Report PDF dettagliato

ID operazione:
Portal-Validation-DetailedPDFReport

Scarica report di convalida dettagliati in PDF.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token del file di convalida ricevuto dall'azione di Portal-Validation

Restituisce

response
object

Portale - Convalida - Report XML

ID operazione:
Portal-Validation-XMLReport

Scaricare il report di convalida in XML.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token del file di convalida ricevuto dall'azione di Portal-Validation

Restituisce

response
object

Portale - Creare la firma

ID operazione:
Portal-CreateSigning

Creare un file PDF, ASIC o ADOC per la firma.

Parametri

Nome Chiave Necessario Tipo Descrizione
nome
 name True string

Nome firma
type
 type True string

Formato documento
postback_url
 postback_url string

URL del sistema per gestire i webhook
scadenza
 deadline date-time

Data di scadenza della firma con il frammento di fuso orario specificato. Esempio: 2018-11-05T13:15:30Z
hard_deadline
 hard_deadline boolean

Se impostato su true partecipanti non sarà in grado di firmare o approvare il documento dopo aver impostato deadline. Impostazione predefinita: false
require_qualified_signatures
 require_qualified_signatures boolean

Consenti di firmare solo con firme qualificate. Impostazione predefinita: false
allow_video_identification
 allow_video_identification boolean

Consenti di firmare usando l'identificazione basata su video. Impostazione predefinita: false
annotation_position
 annotation_position string

È possibile scegliere la posizione delle annotazioni della firma in un documento PDF. Impostazione predefinita: first_top
annotation_personal_code
 annotation_personal_code boolean

Se impostato su true codice personale sarà visibile nell'annotazione. Applicabile solo per la firma del tipo pdf. Impostazione predefinita: false
commento
 comment string

Messaggio per i partecipanti
require_account
 require_account boolean

Richiedere all'utente di avere un account Dokobit prima della firma. Impostazione predefinita: true
nome
 name True string

Nome del file
contenuto
 content True string

Contenuto di file con codifica Base64
nome
 name string

Nome del partecipante
cognome
 surname string

Cognome del partecipante
posta elettronica
 email string

Posta elettronica del partecipante
codice
 code string

Codice personale del partecipante (numero ID nazionale)
country_code
 country_code string

Codice paese del partecipante. Obbligatorio se viene fornito codice personale
ruolo
 role string

Ruolo del partecipante. Impostazione predefinita: signer
azienda
 company string

Nome della società del partecipante
posizione
 position string

Posizione del partecipante
phone
 phone string

Numero di telefono del partecipante
sequenza
 sequence integer

Consente di configurare l'ordine di sequenza delle azioni di approvazione e firma dei documenti
custom_reason
 custom_reason string

Motivo della firma personalizzata
categoria
 category string

Categoria documento

Restituisce

Nome Percorso Tipo Descrizione
status
 status string

Stato della firma
token
 token string

Token di firma
Firmatari
 signers array of object

Informazioni del partecipante
signer.token
 signers.token string

Token del partecipante
first_name
 signers.first_name string

Nome del partecipante
last_name
 signers.last_name string

Cognome del partecipante
codice
 signers.code string

Codice personale del partecipante (numero ID nazionale)
country
 signers.country string

Paese del partecipante
posta elettronica
 signers.email string

Posta elettronica del partecipante

Portale - Eliminare il partecipante dalla firma

ID operazione:
Portal-SignerDelete

L'accesso al documento verrà revocato per il partecipante indicato.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token di firma
token
 token string

Token del partecipante

Restituisce

Nome Percorso Tipo Descrizione
status
 status string

stato

Portale - Eliminare la firma

ID operazione:
Portal-DeleteSigning

Il documento verrà rimosso dall'account del proprietario. Rimarrà accessibile ad altri partecipanti.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token di firma

Restituisce

Nome Percorso Tipo Descrizione
status
 status string

stato

Portale - Eliminare la firma per tutti

ID operazione:
Portal-DeleteSigningForAll

Il documento verrà rimosso dall'account del proprietario e da altri partecipanti che non hanno ancora firmato il documento.

Parametri

Nome Chiave Necessario Tipo Descrizione
Token di accesso
 token True string

Token di firma

Restituisce

Nome Percorso Tipo Descrizione
status
 status string

stato

Portale - Firma del sigilli

ID operazione:
Portal-SealSigning

Il documento verrà bloccato con il sigillo elettronico delle organizzazioni. Contattare il nostro supporto all'indirizzo developers@dokobit.com per ottenere un certificato qualificato per l'e-sealing.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token di firma

Restituisce

Nome Percorso Tipo Descrizione
status
 status string

stato

Portale - Firma dell'aggiornamento

ID operazione:
Portal-Update

Consente di aggiornare gli attributi di una firma di documento esistente.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token di firma
scadenza
 deadline date-time

Data di scadenza della firma con il frammento di fuso orario specificato. Esempio: 2018-11-05T13:15:30Z
hard_deadline
 hard_deadline boolean

Se impostato su true partecipanti non sarà in grado di firmare o approvare il documento dopo aver impostato deadline. Impostazione predefinita: false
require_qualified_signatures
 require_qualified_signatures boolean

Consenti di firmare solo con firme qualificate. Impostazione predefinita: false
allow_video_identification
 allow_video_identification boolean

Consenti di firmare usando l'identificazione basata su video. Impostazione predefinita: false
require_account
 require_account boolean

Richiedere all'utente di avere un account Dokobit prima della firma. Impostazione predefinita: true

Restituisce

Nome Percorso Tipo Descrizione
status
 status string

stato

Portale - Firma di condivisione

ID operazione:
Portal-SigningShare

I partecipanti indicati otterranno l'accesso al documento con il ruolo selezionato.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token di firma
nome
 name string

Nome del partecipante
cognome
 surname string

Cognome del partecipante
posta elettronica
 email string

Posta elettronica del partecipante
codice
 code string

Codice del partecipante
country_code
 country_code string

Codice paese del partecipante
ruolo
 role string

Ruolo del partecipante. Impostazione predefinita: signer
azienda
 company string

Società del partecipante
posizione
 position string

Posizione del partecipante
phone
 phone string

Telefono del partecipante
custom_reason
 custom_reason string

Motivo della firma personalizzata
commento
 comment string

Messaggio per i partecipanti

Restituisce

Nome Percorso Tipo Descrizione
status
 status string

stato
Firmatari
 signers array of object

Informazioni del partecipante
signer.token
 signers.token string

Token del partecipante
nome
 signers.name string

Nome del partecipante
cognome
 signers.surname string

Cognome del partecipante
posta elettronica
 signers.email string

Posta elettronica del partecipante
codice
 signers.code string

Codice personale del partecipante (numero ID nazionale)
country_code
 signers.country_code string

Paese del partecipante

Portale - Invia promemoria

ID operazione:
Portal-Remind

Consente di inviare un messaggio di posta elettronica di promemoria per il partecipante, solo se la persona non ha ancora firmato il documento.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token di firma
firmatario
 signer True string

Token del partecipante
message
 message string

Messaggio di promemoria per il firmatario

Restituisce

Nome Percorso Tipo Descrizione
status
 status string

stato

Portale - Ottenere l'elenco delle firme

ID operazione:
Portal-GetSigninglist

Restituisce un elenco di tutti i documenti disponibili per il proprietario dell'account.

Parametri

Nome Chiave Necessario Tipo Descrizione
Filter
 filter string

Filtrare i documenti in base allo stato. Valori possibili: completed, pending o declined
Data da
 date_from string

Filtrare le firme create in data o successiva (esempio: 2022-01-01)
Data a
 date_to string

Filtrare le firme create in precedenza o prima di questa data (esempio: 2022-01-31)

Restituisce

Nome Percorso Tipo Descrizione
status
 status string

stato
firme
 signings array of object

Elenco delle firme
token
 signings.token string

Token di firma
status
 signings.status string

Stato della firma
document_number
 signings.document_number string

Numero documento
client_code
 signings.client_code string

Codice client
is_in_trash_bin
 signings.is_in_trash_bin boolean

is_in_trash_bin
last_signature_date
 signings.last_signature_date string

Data ultima firma

Portale - Scarica documento

ID operazione:
Portal-DownloadDocument

Scarica il documento firmato.

Parametri

Nome Chiave Necessario Tipo Descrizione
token
 token True string

Token di firma

Restituisce

response
object

Definizioni

oggetto

Si tratta del tipo 'object'.