1. Instruções de Integração
1.1 Fluxo de Integração
O fluxo de integração é mostrado na figura abaixo.
1.1.1 Registar uma conta eSignGlobal
Os desenvolvedores precisam de visitar o site oficial da eSignGlobal para registar uma conta.
- Ambiente de sandbox:https://app-sml.esignglobal.com/
- Ambiente de produção:https://app.esignglobal.com/
Endereço de conexão OpenAPI:
- Nome de domínio do ambiente de sandbox:https://openapi-sml.esignglobal.com
- Nome de domínio do ambiente de produção:
- Localização de residência de dados em Hong Kong:https://openapi-as1.esignglobal.com
- Localização de residência de dados em Singapura:https://openapi-as2.esignglobal.com
- Localização de residência de dados na União Europeia:https://openapi-eu1.esignglobal.com
1.1.2 Criar Aplicação
Faça login no eSignGlobal, o administrador pode adicionar aplicações no menu Configurações - Integração - Aplicações e obter a chave e configurar o endereço de retorno na página de edição da aplicação.
1.1.3 Definir Processos de Negócio
Depois de ler este documento, o programador deve organizar os processos de negócio existentes e ligar a interface correspondente no nó de assinatura do negócio, para realizar a capacidade de assinatura eletrónica no processo de negócio existente.
1.1.4 Integração de Interface
Nesta etapa, o trabalho de ligação é oficialmente realizado. Se encontrar algum problema durante o processo de ligação, pode contactar a equipa eSignGlobal para ajudar a resolver.
1.1.5 Teste de Negócio
Após concluir a ligação da função de interface, realize várias rondas de testes de processo de negócio, conforme necessário. Se encontrar algum problema durante o processo de teste, pode contactar a equipa eSignGlobal para ajudar a resolver.
1.1.6 Lançamento do Projeto
O programador pode lançar o projeto após concluir as seguintes operações:
- Mudar o ambiente de acesso à interface:Ambiente de sandbox ➡ Ambiente oficial
- Mudar as informações da aplicação:sandbox app_id, app_secret ➡ app_id, app_secret oficial
2. Exemplo de Processo
O seguinte mostra o processo de chamada de interface de vários cenários de aplicação típicos, e o método de chamada específico é baseado no seu design de negócio.
O conteúdo do número na figura é o processo de operação de negócio de assinatura eletrónica padrão, e a caixa cinzenta é o serviço API fornecido pelo eSginGlobal.
2.1 Fluxo de Chamada de API (Cenário Clássico) — Iniciação Passo a Passo
2.2 Fluxo de Chamada de API (Cenário Clássico) — Iniciação Rápida
3. Resumo
O processo de assinatura eletrónica é dividido em três fases: inicialização, criação e abertura do envelope, e assinatura.
A descrição dos nós críticos do processo é a seguinte:
- Extrair informações-chave da assinatura:Ao iniciar uma assinatura eletrónica através do eSignGlobal, a plataforma de integração só precisa de fornecer informações do signatário, documentos a assinar, etc., para iniciar a assinatura do contrato. Estas informações são geralmente recolhidas e guardadas no sistema de negócio durante o processo de negócio anterior.
- Criar envelope:O eSignGlobal tem como objetivo criar um serviço de assinatura eletrónica global fiável, pelo que o comportamento de assinatura de documentos a assinar (também conhecido como tarefa de assinatura) é representado por envelopes. Ao criar um processo de assinatura, a plataforma de integração pode personalizar funções relacionadas, como o assunto, notas, etc.
- Gerar documentos a assinar:Atualmente, o eSignGlobal suporta apenas documentos a assinar em formato PDF. A plataforma de integração precisa de preparar os documentos de assinatura com antecedência e adicioná-los ao processo de assinatura através da "interface relacionada com o carregamento de ficheiros".
- Adicionar signatários:Neste passo, a plataforma de integração pode adicionar signatários ao envelope e configurar a experiência do utilizador do signatário, como a ordem de assinatura, a posição de assinatura e se é necessária uma palavra-passe de acesso, etc.
- Abrir envelope:Isto permite que o signatário comece a assinar o documento. Depois de o envelope ser aberto, não é possível adicionar ou modificar documentos a assinar, e este começará automaticamente a circular de acordo com a ordem de assinatura predefinida, e o eSignGlobal enviará uma notificação de assinatura.
- Encerrar Envelope:Ou seja, quando todos os signatários terminarem de assinar, a plataforma de integração fecha manualmente o envelope. (Posteriormente, o eSignGlobal suportará a adição de signatários antes do fecho do processo.)
- Descarregar Documentos Assinados:Ou seja, descarregar os documentos após todos os signatários terem terminado de assinar, só pode ser chamado após o encerramento do envelope.