Criar experiências incorporadas de assinatura eletrônica e documento

Saiba como usar as APIs da Adobe Sign para incorporar experiências de assinatura eletrônica e documentos em suas plataformas da Web e sistemas de gerenciamento de conteúdo e documentos. Há quatro partes neste tutorial prático descrito nos links abaixo:

Do que você vai precisar Parte 2: Baixa/Sem código — o poder dos formulários da Web Parte 3: Enviar contrato com um formulário, mesclar dados Parte 4: Incorporar experiência de assinatura, redirecionamentos e muito mais

Parte 1: Do que você vai precisar

Na parte 1, você aprenderá como começar com tudo o que precisa para as partes 2 a 4. Vamos começar com a obtenção de credenciais de API.

Parte 2: Baixa/Sem código — o poder dos formulários da Web

Na parte 2, você explorará a opção de baixo/sem código ao usar formulários da Web. É sempre uma boa ideia ver se você pode evitar escrever código no início.

  1. Acesse o Adobe Sign com sua conta de desenvolvedor.

  2. Clique em Publicar um formulário da Web na página inicial.

    Captura de tela da página inicial do Adobe Sign

  3. Crie seu contrato.

    Captura de tela de como criar um formulário da Web

  4. Incorpore seu contrato em uma página HTML simples.

  5. Experimente adicionar parâmetros de consulta dinamicamente.

    Captura de tela da adição de parâmetros de consulta

Parte 3: Enviar contrato com um formulário e mesclar dados

Na parte 3, você criará contratos dinamicamente.

Primeiro, você precisará estabelecer acesso. Com o Adobe Sign, há duas maneiras de se conectar via API. Tokens OAuth & Chaves de integração. A menos que você tenha um motivo muito específico para usar o OAuth com seu aplicativo, você deverá explorar as Chaves de integração primeiro.

  1. Selecione Chave de integração no menu Informações da API na guia Conta no Adobe Sign.

    Captura de tela de onde encontrar a chave de integração

Agora que você tem acesso e pode interagir com a API, veja o que você pode fazer com a API.

  1. Navegue até Métodos da API REST da Adobe Sign Versão 6.

    Captura de tela de navegação pelos Métodos da API REST da Adobe Sign versão 6

  2. Use o token como um valor "portador".

    Captura de tela do valor do portador

Para enviar seu primeiro contrato, é melhor entender como usar a API.

  1. Crie um documento transitório e envie-o.
OBSERVAÇÃO

As chamadas de solicitação baseadas em JSON têm as opções "Modelo" e "Esquema de modelo mínimo". Isso oferece especificações e um conjunto de carga mínima.

Captura de tela da criação de um documento transitório

Depois de enviar um contrato pela primeira vez, você estará pronto para adicionar a lógica. É sempre uma boa ideia estabelecer alguns auxiliares para minimizar a repetição. Estes são alguns exemplos:

Validação

Captura de tela da lógica de validação

Cabeçalhos/Autenticação

Captura de tela de cabeçalhos/lógica de autenticação

URI base

Captura de tela da lógica do URI base

Esteja ciente de onde os documentos do Transient caem no grande esquema do ecossistema do Sign.
Transitório -> Contrato
Transitório -> Modelo -> Contrato
Transitório -> Widget -> Contrato

Este exemplo usa um modelo como a origem do documento. Essa é geralmente a melhor rota, a menos que você tenha um motivo sólido para gerar documentos para assinatura dinamicamente (por exemplo, código herdado ou geração de documento).

O código é bastante simples; ele usa um documento da biblioteca (modelo) para a origem do documento. O primeiro e o segundo signatários são atribuídos dinamicamente. O estado IN_PROCESS significa que o documento está sendo enviado imediatamente. Além disso, mergeFieldInfo é aproveitado para preencher campos dinamicamente.

Captura de tela do código para adicionar assinaturas dinamicamente

Parte 4: Incorporar experiência de assinatura, redirecionamentos e muito mais

Em muitos casos, você pode permitir que o participante acionador assine imediatamente um contrato. Isso é útil para aplicativos e quiosques voltados para o cliente.

Se você não deseja que o primeiro email de envio seja acionado, uma maneira fácil é gerenciar o comportamento é com uma modificação na chamada da API.

Captura de tela do código para não acionar o envio de email

Veja como controlar o redirecionamento pós-assinatura:

Captura de tela do código para controlar o redirecionamento pós-assinatura

Após atualizar o processo de criação do contrato, a etapa final está gerando o URL de assinatura. Essa chamada também é bastante direta e gera um URL que um signatário pode usar para acessar sua parte do processo de assinatura.

Captura de tela do código para gerar um URL do signatário

OBSERVAÇÃO

Observe que a chamada de criação do contrato é tecnicamente assíncrona. Isso significa que uma chamada de contrato 'POST' pode ser feita, mas o contrato ainda não está pronto. A melhor prática é estabelecer um ciclo de repetição. Use uma nova tentativa ou seja qual for a melhor prática para o seu ambiente.

Captura de tela dizendo que é a melhor prática estabelecer um loop de repetição

Quando tudo é reunido, a solução é bastante simples. Você está fazendo um contrato e gerando um URL de assinatura para o signatário clicar e começar o ritual de assinatura.

Tópicos adicionais

Recursos adicionais

http://bit.ly/Summit21-T126

Inclui:

  • Conta de desenvolvedor do Adobe Sign
  • Documentos de API da Adobe Sign
  • Código de exemplo
  • Código do Visual Studio
  • Python

Nesta página