1. Istruzioni per l'integrazione
1.1 Processo di integrazione
Il processo di integrazione è mostrato nella figura seguente.
1.1.1 Registrazione di un account eSignGlobal
Gli sviluppatori devono visitare il sito web di eSignGlobal per registrare un account.
- Ambiente sandbox:https://app-sml.esignglobal.com/
- Ambiente di produzione:https://app.esignglobal.com/
Indirizzo di connessione OpenAPI:
- Nome di dominio dell'ambiente sandbox:https://openapi-sml.esignglobal.com
- Nome di dominio dell'ambiente di produzione:
- Residenza dei dati a Hong Kong:https://openapi-as1.esignglobal.com
- Residenza dei dati a Singapore:https://openapi-as2.esignglobal.com
- Residenza dei dati nell'Unione Europea:https://openapi-eu1.esignglobal.com
1.1.2 Creazione di un'applicazione
Dopo aver effettuato l'accesso a eSignGlobal, l'amministratore può aggiungere applicazioni tramite il menu Impostazioni - Integrazione - Applicazioni e ottenere la chiave e configurare l'indirizzo di callback nella pagina di modifica dell'applicazione.
1.1.3 Definizione del flusso di lavoro
Dopo aver letto questo documento, lo sviluppatore può ordinare il flusso di lavoro esistente e collegare l'interfaccia corrispondente al nodo di firma dell'attività per implementare la funzionalità di firma elettronica sul flusso di lavoro esistente.
1.1.4 Integrazione dell'interfaccia
In questa fase, inizia ufficialmente il lavoro di docking. In caso di problemi durante il processo di docking, è possibile contattare il team eSignGlobal per assistenza.
1.1.5 Test aziendale
Dopo aver completato il docking della funzione di interfaccia, eseguire alcuni cicli di test del flusso di lavoro secondo necessità. In caso di problemi durante il processo di test, è possibile contattare il team eSignGlobal per assistenza.
1.1.6 Lancio del progetto
Lo sviluppatore può lanciare il progetto completando le seguenti operazioni:
- Cambia l'ambiente di accesso all'interfaccia:Ambiente sandbox ➡ Ambiente formale
- Cambia le informazioni sull'applicazione:sandbox app_id, app_secret ➡ app_id, app_secret formali
2. Esempio di flusso
Di seguito sono riportati alcuni flussi di chiamata dell'interfaccia di scenari applicativi tipici. Il metodo di chiamata specifico si basa sulla progettazione della tua attività.
Il contenuto del numero nella figura è il flusso operativo aziendale standard della firma elettronica e il riquadro grigio è il servizio API fornito da eSginGlobal.
2.1 Flusso di chiamata dell'API (scenario classico) - Avvio graduale
2.2 Flusso di chiamata dell'API (scenario classico) - Avvio rapido
3. Riepilogo
Il flusso di lavoro della firma elettronica è suddiviso in tre fasi: inizializzazione, creazione e apertura della busta, firma.
Di seguito sono riportati i nodi chiave del flusso di lavoro:
- Estrazione delle informazioni chiave per la firma:Quando si avvia una firma elettronica tramite eSignGlobal, la piattaforma di integrazione deve fornire almeno le informazioni del firmatario, i documenti da firmare, ecc. per avviare la firma del contratto. Queste informazioni provengono generalmente da processi aziendali precedenti e sono già state raccolte e salvate nel sistema aziendale.
- Creazione della busta:eSignGlobal mira a creare un servizio di firma elettronica globale affidabile, quindi il comportamento di firma dei documenti da firmare (noto anche come attività di firma) è rappresentato da una busta. Quando si crea un flusso di firma, la piattaforma di integrazione può personalizzare le funzioni correlate, come oggetto, note, ecc.
- Generazione del documento da firmare:Attualmente, eSignGlobal supporta solo documenti da firmare in formato PDF. La piattaforma di integrazione deve preparare in anticipo il documento da firmare e aggiungerlo al flusso di firma tramite le "interfacce correlate al caricamento dei file".
- Aggiunta del firmatario:In questo passaggio, la piattaforma di integrazione può aggiungere la parte firmataria alla busta e configurare l'esperienza utente del firmatario, come l'ordine di firma, la posizione di firma, se è necessaria una password di accesso, ecc.
- Apertura della busta:Ciò significa consentire al firmatario di iniziare a firmare il documento. Dopo l'apertura della busta, non è supportata l'aggiunta e la modifica di documenti da firmare e inizierà automaticamente a circolare secondo l'ordine di firma preimpostato e eSignGlobal invierà una notifica di firma.
- Chiudi busta:Ovvero, quando tutti i firmatari hanno completato la firma, la piattaforma di collegamento chiude manualmente la busta. (In futuro, eSignGlobal supporterà l'aggiunta di firmatari prima che il processo sia chiuso.)
- Scarica file firmati:Ovvero, scarica i file dopo che tutti i firmatari hanno completato la firma, può essere richiamato solo dopo la chiusura della busta.