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

Saiba como usar as APIs do Acrobat Sign para incorporar experiências de assinatura eletrônica e de documento em plataformas Web e sistemas de gerenciamento de conteúdo e documentos. Há quatro partes neste tutorial prático.

Parte 1: Do que você precisa

Na parte 1, saiba como começar a usar tudo o que você precisa para as partes 2 a 4. Vamos começar obtendo credenciais de API.

Exibir detalhes sobre como obter credenciais de API

Parte 2: Código baixo/nulo — o poder dos formulários web

Na parte 2, explore a opção de baixo valor/sem código do uso de formulários web. É sempre uma boa ideia ver se você pode evitar escrever código no início.

Exibir detalhes sobre como criar um formulário web
  1. Acesse o Acrobat Sign com sua conta de desenvolvedor.

  2. Selecione Publish um formulário web na página inicial.

    Captura de tela da página inicial do Acrobat Sign

  3. Crie seu contrato.

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

  4. Insira seu contrato em uma página de 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, crie contratos dinamicamente.

Visualizar detalhes sobre como criar contratos dinamicamente

Primeiro, você precisa estabelecer o acesso. Com o Acrobat Sign, há duas maneiras de se conectar por meio da API. Tokens OAuth e Chaves de Integração. A menos que você tenha um motivo muito específico para usar o OAuth com o aplicativo, você deve explorar as Chaves de integração primeiro.

  1. Selecione Chave de integração no menu Informações de API na guia Conta do Acrobat 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. Acrobat Sign Navegue até os Métodos dada API REST Versão 6.

    Captura de tela de navegação dos Métodos da Acrobat Sign REST API Versão 6

  2. Use o token como um valor de “portador”.

    Captura de tela do valor do portador

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

  1. Crie um Documento temporário e envie-o.
note note
NOTE
As chamadas de solicitação baseadas em JSON têm uma opção “Modelo” e “Esquema de modelo mínimo”. Isso fornece especificações e um conjunto mínimo de carga útil.

Captura de tela da criação de um Documento Temporá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. Veja 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

Lembre-se de onde os Documentos transitórios pousam no esquema geral do ecossistema do Sign.
Temporário -> Contrato
Temporário -> Modelo -> Contrato
Temporário -> Widget -> Contrato

Este exemplo usa um modelo como nossa origem de documento. Geralmente, esse é o melhor caminho, a menos que você tenha um motivo sólido para gerar dinamicamente documentos para assinatura (por exemplo, código legado 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, o mergeFieldInfo é aproveitado para preencher campos dinamicamente.

Captura de tela de código para adicionar assinaturas dinamicamente

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

Em muitas situações, você pode permitir que o participante de acionamento assine imediatamente um contrato. Isso é útil para aplicativos e quiosques voltados para o cliente.

Exibir detalhes sobre como incorporar a experiência de assinatura

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

Captura de tela de código para não disparar 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

Depois de atualizar o processo de criação do contrato, a etapa final é gerar 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 de código para gerar uma URL de signatário

note note
NOTE
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 prática recomendada é estabelecer um loop de repetição. Use uma nova tentativa ou qualquer outra prática recomendada para seu ambiente.

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

Quando tudo está pronto, a solução é bastante simples. Você está criando um contrato e gerando um URL de assinatura para que o signatário clique e comece o ritual de assinatura.

Tópicos adicionais

recommendation-more-help
ac8d3f8e-a625-4146-84f3-0eb730a583a3