Guia do Usuário Cancelar

API do Adobe Acrobat Sign - Perguntas frequentes

Pesquisar
Adobe Sign

Adobe Sign

Abrir aplicativo

 

Guia do Adobe Acrobat Sign

Novidades

  1. Notas de pré-lançamento
  2. Notas de versão
  3. Notificações importantes

Introdução

  1. Guia de início rápido para admins
  2. Guia de início rápido para usuários
  3. Para desenvolvedores(as)
  4. Biblioteca de tutoriais em vídeo
  5. Perguntas frequentes

Administrar

  1. Visão geral do Admin Console
  2. Gerenciamento de usuários
    1. Adicionar usuários
      1. Adicionar um usuário
      2. Adicionar usuários em massa
      3. Adicionar usuários do diretório
      4. Adicionar usuários do MS Azure Active Directory
    2. Criar usuários focados em funções
      1. Contas técnicas - Orientadas por API
      2. Contas de serviço - Orientadas manualmente
    3. Verificar usuários com erros de provisionamento
    4. Alterar nome/endereço de email
    5. Editar a associação de grupo de um usuário
    6. Editar a associação de grupo de usuários por meio da interface de grupo
    7. Promover um usuário a uma função de admin
    8. Tipos de identidade de usuário e logon único
    9. Alternar identidade de usuário
    10. Autenticar usuários com o MS Azure
    11. Autenticar usuários com a federação do Google
    12. Perfis de produto
    13. Experiência de logon 
  3. Configurações de conta/grupo
    1. Visão geral das configurações
    2. Configurações globais
      1. Nível de conta e ID
      2. Nova experiência para destinatários
      3. Fluxos de trabalho de autoassinatura
      4. Envio em massa
      5. Formulários web
      6. Fluxos de trabalho de envio personalizados
      7. Fluxos de trabalho do Power Automate
      8. Documentos da biblioteca
      9. Coletar dados de formulário com contratos
      10. Visibilidade de documento limitada
      11. Anexar uma cópia em PDF do contrato assinado 
      12. Incluir um link no email
      13. Incluir uma imagem no email
      14. Arquivos anexados a emails receberão o nome
      15. Anexar relatórios de auditoria a documentos
      16. Mesclar vários documentos em um
      17. Baixar documentos individuais
      18. Fazer upload de um documento assinado
      19. Delegação para usuários da minha conta
      20. Permitir que destinatários externos deleguem
      21. Autoridade para assinar
      22. Autoridade para enviar
      23. Autoridade para adicionar selos eletrônicos
      24. Definir um fuso horário padrão
      25. Definir um formato de data padrão
      26. Usuários em vários grupos (UMG)
        1. Atualizar para usar o UMG
      27. Permissões de admin de grupo
      28. Substituir destinatário
      29. Relatório de auditoria
        1. Visão geral
        2. Permitir acesso não autenticado na página de verificação de transação
        3. Incluir lembretes
        4. Incluir eventos de exibição
        5. Incluir contagem de páginas e anexos do contrato
      30. Rodapé da transação
      31. Mensagens e orientações nos produtos
      32. PDFs acessíveis
      33. Nova experiência de criação
      34. Cliente do setor de saúde
    3. Configuração da conta
      1. Adicionar logotipo
      2. Personalizar nome do host e URL da empresa    
      3. Adicionar nome da empresa
      4. Redirecionamento de URL pós-conclusão de contrato
    4. Preferências de assinatura
      1. Assinaturas bem formatadas
      2. Permitir que destinatários assinem por
      3. Permitir que signatários alterem seus nomes
      4. Permitir que os destinatários usem a assinatura salva
      5. Divulgação do cliente e Termos de uso personalizados
      6. Navegar pelos destinatários em campos de formulário
      7. Reiniciar fluxo de trabalho do contrato
      8. Recusar-se a assinar
      9. Permitir fluxos de trabalho de carimbo
      10. Exigir que signatários informem o cargo ou empresa
      11. Permitir que os signatários imprimam e insiram uma assinatura manuscrita
      12. Mostrar mensagens ao assinar eletronicamente
      13. Exigir que signatários usem um dispositivo móvel para criar assinaturas
      14. Solicitar endereço IP dos signatários
      15. Excluir o nome da empresa e o cargo dos carimbos de participação
    5. Assinaturas digitais
      1. Visão geral
      2. Baixar e assinar com o Acrobat
      3. Assinar com assinaturas em nuvem
      4. Incluir metadados para provedores de identidade
      5. Provedores de assinatura em nuvem restritos
    6. Selos eletrônicos
    7. Identidade digital
      1. Gateway de identidade digital
      2. Política de verificação de identidade
    8. Configurações de relatório
      1. Nova experiência de relatório
      2. Configurações clássicas de relatório
    9. Configurações de segurança
      1. Configurações de logon único
      2. Configurações de lembrete pessoal
      3. Política de senha de logon
      4. Nível de segurança da senha de logon
      5. Duração da sessão da Web
      6. Tipo de criptografia PDF
      7. API
      8. Acesso às informações de usuários e grupos
      9. Intervalos de IP permitidos
      10. Compartilhamento de conta
      11. Permissões de compartilhamento da conta
      12. Controles de compartilhamento de contrato
      13. Verificação de identidade de signatário
      14. Senha de assinatura do contrato
      15. Nível de segurança da senha do documento
      16. Bloquear signatários por geolocalização
      17. Autenticação por telefone
      18. Autenticação baseada em conhecimento (KBA)
      19. Permitir extração de página
      20. Validade do link do documento
      21. Fazer upload de um certificado de cliente para webhooks e retornos de chamada
      22. Carimbo de data e hora
    10. Configurações de envio
      1. Mostrar a página Enviar após o logon
      2. Solicitar nome do destinatário ao enviar
      3. Bloquear valores de nome para usuários conhecidos
      4. Funções de destinatário permitidas
      5. Permitir testemunhas eletrônicas
      6. Grupos de destinatários
      7. CCs
      8. Acesso ao contrato do destinatário
      9. Campos obrigatórios
      10. Anexar documentos
      11. Compactar campo
      12. Modificar contratos
      13. Nome do contrato
      14. Idiomas
      15. Mensagens privadas
      16. Tipos de assinatura permitidos
      17. Lembretes
      18. Proteção com senha de documentos assinados
      19. Enviar notificação de contrato por meio de
      20. Opções de identificação do signatário
        1. Visão geral
        2. Senha de assinatura
        3. Senha de uso único por email
        4. Autenticação do Acrobat Sign
        5. Autenticação por telefone
        6. Assinatura digital baseada na nuvem
        7. Autenticação baseada em conhecimento
        8. Documento de identidade
        9. Relatórios de identidade do signatário
      21. Proteção de conteúdo
      22. Habilitar transações da Notarize
      23. Expiração do documento
      24. Visualizar, posicionar assinaturas e adicionar campos
      25. Ordem de assinatura
      26. Liquid Mode
      27. Controles de fluxo de trabalho personalizados
      28. Opções de upload para a página de assinatura eletrônica
      29. URL de redirecionamento para confirmação pós-assinatura
    11. Modelos de mensagem
    12. Configurações de Bio-Pharma
      1. Visão geral
      2. Autenticação de identidade aplicada
      3. Motivos para assinar
    13. Integração de fluxo de trabalho
    14. Configurações de autenticação
    15. Integração de pagamento
    16. Mensagens para signatários
    17. Configurações de SAML
      1. Configuração de SAML
      2. Instalar o serviço de federação do Microsoft Active Directory.
      3. Instalar Okta
      4. Instalar OneLogin
      5. Instalar a federação de identidade da Oracle
    18. Governança de dados
    19. Configurações de carimbo de data e hora
    20. Arquivo externo
    21. Idiomas da conta
    22. Configurações de email
      1. Imagens de cabeçalho e rodapé do email
      2. Permitir rodapés de email de usuário individual
      3. Personalizar o email de solicitação de assinatura
      4. Personalizar os campos Para e CC
      5. Habilitar notificações sem link
      6. Personalizar modelos de email
    23. Migração de echosign.com para adobesign.com
    24. Opções de configuração para destinatários
  4. Orientações com respeito aos requisitos normativos
    1. Acessibilidade
      1. Conformidade de acessibilidade
      2. Criar formulários acessíveis com o Acrobat para desktop
      3. Criar Acroforms acessíveis
    2. HIPAA
    3. GDPR
      1. Visão geral do GDPR
      2. Redigir um usuário
      3. Redigir contratos de um usuário    
    4. 21 CFR parte 11 e EudraLex anexo 11
      1. Pacote de validação do 21 CRF parte 11
      2. Manual EudraLex, anexo 11 e 21 CFR
      3. Análise das responsabilidades compartilhadas
    5. Clientes do setor de saúde
    6. Suporte a IVES
    7. “Armazenamento” de contratos
    8. Considerações para a UE e Reino Unido
      1. Transações transfronteiriças da UE/Reino Unido e eIDAS
      2. Requisitos HMLR para escrituras assinadas eletronicamente
      3. O impacto do Brexit nas leis de assinatura eletrônica do Reino Unido
  5. Baixar contratos em massa
  6. Reivindicar um domínio 
  7. Links para denunciar abuso

Enviar, assinar e gerenciar contratos

  1. Opções do destinatário
    1. Cancelar um lembrete de email
    2. Opções na página de assinatura eletrônica
      1. Visão geral da página de assinatura eletrônica
      2. Abrir para ler o contrato sem campos
      3. Recusar-se a assinar um contrato
      4. Delegar autoridade de assinatura
      5. Reiniciar o contrato
      6. Baixar um PDF do contrato
      7. Exibir o histórico do contrato
      8. Exibir as mensagens do contrato
      9. Converter de uma assinatura eletrônica para uma assinatura manuscrita
      10. Converter de uma assinatura manuscrita para uma assinatura eletrônica 
      11. Navegar pelos campos do formulário
      12. Limpar os dados dos campos de formulário
      13. Ampliação e navegação da página de assinatura eletrônica
      14. Alterar o idioma usado nas ferramentas e informações do contrato
      15. Revisar os Avisos legais
      16. Ajustar as preferências de cookies do Acrobat Sign
  2. Enviar contratos  
    1. Visão geral da página Enviar
    2. Enviar um contrato somente para você
    3. Enviar um contrato para outras pessoas
    4. Assinaturas manuscritas
    5. Ordem de assinatura dos destinatários
    6. Envio em massa
      1. Visão geral do recurso de Envio em massa
      2. Enviar em massa: configurar um modelo principal
      3. Envio em massa: configurar um arquivo CSV
      4. Cancelar uma transação de Envio em massa
      5. Adicionar lembretes de Envio em massa
      6. Relatórios de Envio em massa
  3. Criar campos em documentos
    1. Ambiente de criação no aplicativo
      1. Detecção automática de campo
      2. Arrastar e soltar campos usando o ambiente de criação
      3. Atribuir campos de formulário aos destinatários
      4. Função de preenchimento prévio
      5. Aplicar campos com um modelo de campo reutilizável
      6. Transferir campos para um novo modelo de biblioteca
      7. Ambiente de criação atualizado ao enviar contratos
    2. Criar formulários e tags de texto
    3. Criar formulários usando o Acrobat (Acroforms)
      1. Criação do Acroform
      2. Criar PDFs acessíveis
    4. Campos
      1. Tipos de campo
        1. Tipos de campo comuns
        2. Imagens incorporadas
        3. Imagens do carimbo
      2. Aparência do conteúdo do campo
      3. Validações de campo
      4. Valores de campos ocultos
      5. Definir condições para mostrar e ocultar
      6. Campos calculados 
    5. Perguntas frequentes sobre criação
  4. Assinar contratos
    1. Assinar contratos enviados a você
    2. Preencher e assinar
    3. Autoassinatura
  5. Gerenciar contratos
    1. Visão geral da página Gerenciar
    2. Delegar contratos
    3. Substituir destinatários
    4. Limitar a visibilidade do documento 
    5. Cancelar um contrato 
    6. Criar novos lembretes
    7. Revisar lembretes
    8. Cancelar um lembrete
    9. Acessar fluxos do Power Automate
    10. Mais ações...
      1. Como a pesquisa funciona
      2. Visualizar um contrato
      3. Criação de um modelo a partir de um contrato
      4. Ocultar ou reexibir contratos
      5. Fazer upload de um contrato assinado
      6. Modificar os arquivos e campos de um contrato enviado
      7. Editar o método de autenticação de um destinatário
      8. Adicionar ou modificar uma data de expiração
      9. Adicionar uma nota ao contrato
      10. Compartilhar um contrato individual
      11. Deixar de compartilhar um contrato
      12. Baixar um contrato individual
      13. Baixar os arquivos individuais de um contrato
      14. Baixar o relatório de auditoria de um contrato
      15. Baixar o conteúdo dos campos de um contrato
  6. Relatório de auditoria
  7. Relatórios e exportações de dados
    1. Visão geral
    2. Conceder aos usuários acesso aos relatórios
    3. Gráficos de relatório
      1. Criar novo relatório
      2. Relatórios de contrato
      3. Relatórios de transação
      4. Relatório de atividades de configuração
      5. Editar um relatório
    4. Exportações de dados 
      1. Criar uma nova exportação de dados
      2. Exportação de dados do Formulário web
      3. Editar uma exportação de dados
      4. Atualizar o conteúdo da exportação de dados
      5. Baixar a exportação de dados
    5. Renomear um relatório ou exportação
    6. Duplicar um relatório ou exportação
    7. Agendar um relatório ou exportação
    8. Excluir um relatório ou exportação
    9. Verificar o uso de transações

Recursos e fluxos de trabalho avançados de contratos

  1. Formulários web 
    1. Criar um formulário web
    2. Editar um formulário web
    3. Desabilitar ou habilitar um formulário web
    4. Ocultar ou reexibir um formulário web
    5. Localizar o URL ou o código de script 
    6. Preencher campos de formulário web com parâmetros de URL
    7. Salvar um formulário web para concluir mais tarde
    8. Redimensionar um formulário web
  2. Modelos reutilizáveis (modelos de biblioteca) 
    1. Formulários do governo dos EUA na biblioteca do Acrobat Sign
    2. Criar um modelo de biblioteca
    3. Alterar o nome de um modelo de biblioteca
    4. Alterar o tipo de um modelo de biblioteca
    5. Alterar o nível de permissão de um modelo de biblioteca
    6. Copiar, editar e salvar um modelo compartilhado
    7. Baixar os dados de campo agregado de um modelo de biblioteca
  3. Transferir a propriedade de formulários web e modelos de biblioteca
  4. Fluxos de trabalho do Power Automate 
    1. Visão geral da integração com o Power Automate e direitos incluídos
    2. Habilitar a integração do Power Automate
    3. Ações no contexto da página Gerenciar
    4. Acompanhamento do uso do Power Automate
    5. Criar um novo fluxo (exemplos)
    6. Acionadores usados para fluxos
    7. Importação de fluxos de fora do Acrobat Sign
    8. Gerenciar fluxos
    9. Editar fluxos
    10. Compartilhar fluxos
    11. Desabilitar ou habilitar fluxos
    12. Excluir fluxos
    13. Modelos úteis
      1. Somente admins
        1. Salvar todos os documentos concluídos no SharePoint
        2. Salvar todos os documentos concluídos no OneDrive for Business
        3. Salvar todos os documentos concluídos no Google Drive
        4. Salvar todos os documentos concluídos no Dropbox
        5. Salvar todos os documentos concluídos no Box
      2. Arquivar o contrato
        1. Salvar seus documentos concluídos no SharePoint
        2. Salvar seus documentos concluídos no OneDrive for Business
        3. Salvar seus documentos concluídos no Google Drive
        4. Salvar seus documentos concluídos no Dropbox
        5. Salvar seus documentos concluídos no Box
      3. Arquivar o contrato de formulário web
        1. Salvar documentos de formulários web concluídos na biblioteca do SharePoint
        2. Salvar documentos de formulários web concluídos no OneDrive for Business
        3. Salvar documentos concluídos no Google Drive
        4. Salvar documentos de formulários web concluídos no Box
      4. Extração de dados do contrato
        1. Extraia dados de campos de formulário do documento assinado e atualize a planilha do Excel
      5. Notificações de contrato
        1. Enviar notificações personalizadas por email com o conteúdo do contrato e o contrato assinado
        2. Receba notificações do Adobe Acrobat Sign em um canal do Teams
        3. Receba notificações do Adobe Acrobat Sign no Slack
        4. Receba notificações do Adobe Acrobat Sign no Webex
      6. Geração de contrato
        1. Gerar documento a partir de um modelo do Word e formulário do Power App, e enviar para assinatura
        2. Gere um contrato a partir de um modelo do Word no OneDrive e obter a assinatura
        3. Gerar contrato para a linha selecionada do Excel e enviar para revisão e assinatura
  5. Fluxos de trabalho de envio personalizados
    1. Visão geral do fluxo de trabalho de envio personalizado
    2. Criar um novo fluxo de trabalho de envio
    3. Editar um fluxo de trabalho de envio
    4. Ativar ou desativar um fluxo de trabalho de envio
    5. Enviar um contrato com um fluxo de trabalho de envio
  6. Compartilhar usuários e contratos
    1. Compartilhar um usuário
    2. Compartilhar contratos

Integrar a outros produtos

  1.  Visão geral das integrações do Acrobat Sign 
  2. Acrobat Sign para Salesforce
  3. Acrobat Sign para Microsoft
    1. Acrobat Sign para Microsoft 365
    2. Acrobat Sign para Outlook
    3. Acrobat Sign para Word/PowerPoint
    4. Acrobat Sign para Teams
    5. Acrobat Sign para Microsoft PowerApps e Power Automate
    6. Conector do Acrobat Sign para Microsoft Search
    7. Acrobat Sign para Microsoft Dynamics 
    8. Acrobat Sign para Microsoft SharePoint 
  4. Outras integrações
    1. Acrobat Sign para ServiceNow
    2. Acrobat Sign para HR ServiceNow
    3. Acrobat Sign para SAP SuccessFactors
    4. Acrobat Sign para Workday
    5. Acrobat Sign para NetSuite
    6. Acrobat Sign para VeevaVault
    7. Acrobat Sign para Coupa BSM Suite
  5. Integrações gerenciadas por parceiro
  6. Como obter uma chave de integração

Acrobat Sign Developer

  1. APIs REST 
    1. Documentação de métodos
    2. Guia do desenvolvedor e SDK
    3. Perguntas frequentes sobre API 
  2. Webhooks 
    1. Visão geral do webhook
    2. Configurar um novo webhook
    3. Exibir ou editar um webhook
    4. Desativar ou reativar um webhook
    5. Excluir um webhook
    6. Certificados SSL bidirecionais
    7. Webhooks na API

Suporte e solução de problemas

  1. Recursos de suporte ao cliente 
  2. Recursos de sucesso do cliente corporativo 

O acesso à API é reservado exclusivamente para contas de nível corporativo e de desenvolvedor.

Links para a documentação principal

Links úteis da API REST 6:

Observação:

O suporte para as APIs SOAP herdadas terminou em maio de 2021.

Clientes que usam a API SOAP devem migrar para a API REST o mais rápido possível.

Depois de fazer logon, navegue até Conta > API do Acrobat Sign > Informações de API > APIs Rest e documentação.

Faça logon no Acrobat Sign


Conceitos gerais

Não é possível criar o documento visualizando a página na interface do usuário web. Além disso, não é possível arrastar e soltar ou atribuir funções de signatário usando transientDocumentId por meio da API.

A chamada de transientDocuments retorna a transientDocumentID, que é válida por sete dias.  Você pode usá-la somente para as próximas chamadas de API. É armazenada no servidor da API e recebe essa ID. Faça o upload de um arquivo e consulte sua ID nas chamadas de API subsequentes.

Não é possível carregar diretamente um documento no contrato usando a API REST.

Conforme requisito da REST, crie primeiro um documento temporário e use essa ID nos métodos Agreement, Widget ou Library como a origem do arquivo.

O documento temporário é um arquivo raw de origem, como um PDF, um doc ou um docx carregado nos servidores de Adobe. Portanto, é uma maneira conveniente de transmitir seu documento base para os servidores da API e é um documento temporário na Web.

Sim, você pode publicar contratos usando fluxos de trabalho na v6 com a chamada POST /agreements da API. Passe o parâmetro workflowId na chamada da API.

Você pode obter a workflowId de um fluxo de trabalho usando a chamada GET /workflows.

  1. Faça logon no Adobe Sign como um administrador

  2. Navegue até Conta > API do Adobe Sign > Log de solicitações da API

    Logs da API

  1.  Faça logon na conta do Adobe Sign como um administrador

  2. Navegue até: Conta > API do Adobe Sign > Informações da API

  3. Clique no link Amostras da API REST.

    Observação:

    Para baixar o SDK do JavaScript, consulte https://github.com/adobe-sign/AdobeSignJsSdk.

A partir da v6, a opção “sendTroughWeb” não está mais disponível. O state substitui essa opção. É o estado em que o acordo chega. O campo state só pode ser fornecido em chamadas POST. Ele nunca é retornado em GET /agreements/{ID} e é ignorado se fornecido na chamada PUT /agreements/{ID}. O status final do contrato pode ser obtido em GET /agreements/ID.

state(string) = ['AUTHORING' or 'DRAFT' or 'IN_PROCESS'].

AUTHORING permite que um usuário crie os documentos de um contrato antes de enviá-los. A operação authoring se refere à criação, edição ou inserção de campos de formulário nas configurações (pessoa designada, condições, tipo de dados etc.). nos documentos do contrato. Depois de publicar o documento no estado Authoring, o documento fica visível na seção Rascunho da guia Gerenciar do Adobe Sign.

DRAFT é um estágio temporário ou primário do recurso final pretendido que pode ser atualizado em etapas para criar o recurso final. Ele não está visível na seção Rascunho da guia Gerenciar do Adobe Sign. Usando o estado Draft, as informações do conjunto Participante não são necessárias e podem ser atribuídas posteriormente quando se usa PUT /agreements/agreement/agreementId para concluir este rascunho. Essa etapa pode ser repetida várias vezes até que você tenha todos os dados necessários para criar o contrato.

IN_PROCESS altera o status do contrato para Enviado para assinatura e fica visível na seção Enviado para assinatura da guia Gerenciar do Adobe Sign.

O sendThroughWeb permite enviar o contrato interativamente. Os vários parâmetros no campo “options” na solicitação POST /agreements da v5 permitem que o usuário configure essa visualização interativa (página Enviar). Todos esses parâmetros de configuração de página, como fileUploadOptions, foram movidos para a API POST agreements/ID/views.

Portanto, na prática, você pode obter sendThroughWeb criando um contrato no estado AUTHORING por meio da API POST /agreements. Em seguida, para solicitar o URL da próxima página com a configuração desejada, chame a API POST agreements/ID/views.

Execute as seguintes etapas:

1. Acesse a documentação da API REST v6 e selecione o método POST/agreements.
2. Use o seguinte código de solicitação:

{

  "fileInfos": [

    {

      "transientDocumentId": "***************************"

    }

  ],

  "name": "test",

  "participantSetsInfo": [

    {

      "memberInfos": [

        {

          "email": "abc@gmail.com"

        }

      ],

      "order": 1,

      "role": "SIGNER"

    }

  ],

  "signatureType": "ESIGN",

  "state": "AUTHORING"

}

 

3. Agora, use o método post /agreements/{agreementId}/views com o código de solicitação abaixo:

 

{

  "name": "AUTHORING"

}

O código de resposta fornece o URL para campos da criação.

É possível definir o URL de retorno de chamada das seguintes maneiras:

  • Use o parâmetro abaixo para definir o URL de callback conforme necessário:

    "callbackInfo": "",
  • Entre em contato com o suporte do Adobe Sign para definir o URL de retorno de chamada padrão para toda a conta.

A interface do usuário da SOAP (SmartBear) recebe um erro de conexão SSL semelhante a este a seguir, que você obtém quando faz uma chamada de API. Esse erro geralmente ocorre se você estiver usando um protocolo SSL ou TLS desatualizado, mais antigo que o TLS1.2

ERRO: Exception in request: javax.net.ssl.SSLException: Received fatal alert: protocol_version
ERRO: An error occurred [Received fatal alert: protocol_version], see error log for details

  1. Adicione (-Dsoapui.https.protocols=SSLv3,TLSv1.2) no arquivo VMOPTIONS da pasta Bin.

  2. Acesse C:\Program Files\SmartBear\SoapUI-5.2.1\bin (depende de onde você instalou a interface do usuário SOAP. Pode estar em C:\Program Files (x86))

  3. No arquivo VMOPTIONS, ative a permissão total de leitura/gravação do arquivo.

    VMOPTIONS

  4. Clique com o botão direito do mouse em Arquivo VMOPTIONS>Propriedades>Guia Segurança>Selecionar usuário>Clique em Editar. (O ícone Controle de acesso do usuário é exibido no botão Editar)>Marque todas as caixas de seleção e clique em OK.

  5. Repita o mesmo procedimento para administradores, sistemas e todos os pacotes de aplicativos.

  6. Abra o arquivo usando o Bloco de notas.

  7. Adicione este protocolo na parte inferior “-Dsoapui.https.protocols=SSLv3,TLSv1.2” e salve as alterações.

  8. Feche a interface da SOAP e reinicie. Funciona sem erro de SSL quando você faz uma chamada de API. (Execute um ping de teste para verificar).

Veja a seguir as etapas para criar a ID do cliente e o Segredo do cliente no aplicativo do Adobe Sign:

  1. Faça logon na conta do Adobe Sign.

  2. Navegue até Conta > API do Adobe Sign > Aplicativos da API.

    Fnord.

  3. Para criar um aplicativo, clique no ícone +.

    Fnord.

  4. Digite o Nome e o Nome de exibição.

  5. Em Domínio, selecione CLIENTE e clique em Salvar.

    Fnord.

  6. Realce o aplicativo clicando uma vez.

  7. Clique em Configurar OAuth para o aplicativo.

    Fnord.

  8. Insira o URI de redirecionamento.

  9. Para ativar os escopos necessários, marque as respectivas caixas de seleção e clique em Salvar.

  1. Faça logon no Adobe Sign como um administrador de conta

  2. Navegue até: Conta > API do Adobe Sign > Informações da API

  3. Clique no link da Chave de integração

    Navegue até a Chave de integração

    Observação:

    Se você não estiver vendo o link Chave de integração, entre em contato com seu Gerente de sucesso para que ele ative na sua conta.

    • Nomeie a chave com um valor intuitivo
    • Selecione os vários Escopos necessários para a função do seu aplicativo
    • Clique em Salvar quando a chave estiver completamente configurada
    Interface Criar chave de integração

  5. Uma vez salva, a chave pode ser encontrada em: Conta > Preferências pessoais > Tokens de acesso

    O nome da chave e todos os escopos ativados são listados.  

    Clique na descrição da chave uma vez para expor os links de ação:

    • Chave de integração - Este link fornece literalmente a chave 
    • Revogar - Esta opção revoga e exclui permanentemente o token de acesso
    Tokens de acesso - Chave de Integração

  1. Faça logon na conta do Adobe Sign.

  2. Navegue até Conta > API do Adobe Sign > Aplicativos da API.

  3. Clique no ícone + para criar um aplicativo.

    Postman1

  4. Clique em Configurar OAuth para o aplicativo.

    Fnord.

  5. Gere um código de autorização usando o link a seguir. A ID do cliente, o URI de redirecionamento e os escopos devem ser os mesmos que no URL a seguir, conforme selecionado no aplicativo (evite usar espaços no URL a seguir e definir o Fragmento como “NA1”, de acordo com a conta do Adobe Sign à qual os dados pertencem):

    https://secure.na1.echosign.com/public/oauth?redirect_uri=https://www.google.co.in&response_type=code&client_id=CBJCHBCAABAAo9FZgq31_5BVG_kcIXEe6gNtn-R-gdNe&scope=user_login:self+agreement_send:account

  6. Se a chamada for bem-sucedida, selecione o Código de autorização na barra Endereço.

    Fnord.

  7. Faça o download e instale o Postman no link https://www.getpostman.com/apps.

  8. Depois de fazer o download e instalá-lo, clique em NOVO para criar um POST.

  9. Insira o link https://secure.na1.echosign.com/oauth/token, de acordo com a conta do Adobe Sign à qual os dados pertencem.

  10. Em Cabeçalhos, insira em Content-Type application/x-www-form-urlencoded.

  11. Verifique se x-www-form-urlencoded está selecionado em Corpo e insira os parâmetros abaixo com os valores correspondentes do aplicativo criado na conta do Adobe Sign e clique em ENVIAR.

    Fnord.

  12. Se todas as informações estiverem corretas, são retornados o token de acesso e o token de atualização na resposta:

    Fnord.

Ao executar o processo OAuth, certifique-se de seguir as etapas abaixo:

1. A ID de cliente e o URI de redirecionamento corretos foram especificados.
2. Os escopos fornecidos no URL de autorização devem corresponder exatamente aos escopos fornecidos no aplicativo do Adobe Sign.
3. Use o fragmento correto (na1, na2, au1, eu1, jp1) de acordo com a conta que está sendo configurada.
4. Remova todos os espaços fornecidos no URL de autorização (se houver).
5. Verifique a sintaxe do URL de autorização:

https://secure.na1.echosign.com/public/oauth?redirect_uri=https://secure.na1.echosign.com/public/oauthDemo&
response_type=code&client_id=9MEJXY4Y4R7L2T&scope=agreement_send

Os tokens de acesso são válidos apenas por 3600 segundos (uma hora), período após o qual expiram.

O detentor da solicitação da API pode usar os tokens de Atualização para gerar novos tokens de acesso conforme necessário.

Os webhooks são compatíveis na API REST v6 e mais recentes.

Se um receptor do webhook não responder dentro de 72 horas, o webhook será desativado e nenhuma notificação será enviada.

Se o URL de destino do webhook estiver inativo por algum motivo, o Adobe Sign enfileira o JSON e tenta executar novamente o push em um ciclo progressivo ao longo de 72 horas.

Os eventos não entregues são persistidos em uma fila de tentativas e é feito um melhor esforço nas 72 horas seguintes para entregar as notificações na ordem em que ocorreram.

A estratégia para repetir a entrega de notificações é duplicar o tempo entre tentativas, começando com um intervalo de um minuto e aumentando para a cada 12 horas, resultando em 15 tentativas em 72 horas.

 

Para criar o webhook diretamente da interface do usuário do Adobe Sign, primeiro crie o URL do webhook por meio de aplicativos de função do Azure AD usando as etapas abaixo:

  1. Faça logon usando a conta da Microsoft https://portal.azure.com/.

  2. Registre-se nos Aplicativos de função na conta do Azure AD.

    Menu do Azure

  3. Acesse o Azure AD e vá para Aplicativos de função > Clique no ícone + para acessar Funções.

  4. Selecione Webhook+API com Javascript como linguagem e clique em Criar função.

    Interface do usuário da API do Azure

  5. Substitua o arquivo Index.js pelo seguinte trecho de código:

    module.exports = function (context, req) { 
    var clientId = req.headers['x-adobesign-clientid']; 
    // Validate that the incoming ClientID is genuine 
    if (clientId === '************************************') { 
        context.res = { 
            // status: 200, /* Defaults to 200 */ // any 2XX response is acceptable 
            body: { 
                'xAdobeSignClientId' : clientId, 
                 
            }, 
            headers : { 
                'Content-Type' : 'application/json' 
            } 
        }; 
    } 
    else { 
        context.res = { 
            status: 400, 
            body: "Opps!! Illegitimate Call identified" 
        }; 
    } 
    context.done(); 
};

  6. Clique no botão Testar no canto direito e forneça o seguinte cabeçalho:

    X-AdobeSign-ClientId as ***********************

    Teste da API

  7. Clique em Salvar e executar.

  8. Depois de receber a resposta 200 de sucesso com o cabeçalho a seguir, clique em Obter URL da função

    Resposta 200

  9. Copie o URL e acesse Interface do usuário do Adobe Sign > Webhooks > Clique no ícone + para criar.

  10. Insira a seguinte informação: 

    • Nome: sugerimos um nome intuitivo que outros administradores possam entender prontamente.
    • Escopo: o tamanho da captura do webhook. Conta e Grupo estão disponíveis na interface.
      A API é compatível com os escopos de Recurso, Conta, Grupo e Usuário.
    • Somente um Escopo por webhook pode ser definido
    • URL: o URL de destino para o qual o Adobe Sign enviou a carga JSON.
    • Eventos: o acionador que faz com que o Adobe Sign crie o JSON e o envie para o URL.
      Cada evento cria uma carga diferente relevante para o evento de acionamento
      Vários eventos podem ser incluídos em um webhook.
    • Parâmetros de notificação: os Parâmetros de notificação identificam as seções da carga JSON do Evento, permitindo que você selecione apenas as seções do Evento que são importantes.
    Interface do usuário do webhook

  11. Quando o webhook estiver totalmente definido, clique em Salvar e o novo webhook começará a reagir para acionar eventos imediatamente.

O ativo do contrato é um ativo por meio do qual você pode criar um contrato; por exemplo, um documento de biblioteca, um widget e um contrato em si.

Para pesquisar Eventos de ativo do contrato, faça primeiro uma solicitação à API que cria agreementAssetEvents com os parâmetros de pesquisa relevantes.

A Resposta é a primeira página de resultados, juntamente com um parâmetro de ID de pesquisa e o cursor da próxima página. Você pode usá-lo para obter mais páginas de resultados se estiverem disponíveis usando a API, que recupera agreementAssetEvents com base na ID de pesquisa.

  1. Abra a Documentação da API REST versão 5.

  2. Acesse post/search/agreementAssetEvents e gere o token de acesso com os escopos relevantes.

  3. No código da solicitação, defina a data de início e término de acordo com o requisito:

    { 
  "endDate": "2018-05-22T22:33:33", 
  "startDate": "2017-12-22T22:33:33" 
}

  4. Clique em Experimente. Isso busca as IDs do ativo do contrato, que também podem ser usadas como IDs do contrato.


Gerenciamento de Usuários/Contas

  1. Faça logon no Adobe Sign.
  2. Navegue até Conta>API do Adobe Sign>Documentação da API REST.
  3. Selecione a Versão 5.
  4. No método post /users, use o código de solicitação mencionado no método
    UserCreationInfo
    {
    "email": "email@email.com",
    "firstName": "AA",
    "lastName": "AB",
    "password":"12******rte"
    }

As contas do Adobe Sign que usam o Admin Console (Adobe One) para gerenciar seus direitos de usuários não podem usar a API do Adobe Sign para criar usuários ou gerenciar usuários existentes.

O Adobe One Admin Console usa uma API diferente da API do Adobe Sign. Consulte estes artigos para obter mais informações:

 

Obter a ID do grupo:

  1. Acesse https://secure.na1.echosign.com/public/docs/restapi/v5.

  2. Em Recursos e operações, clique em grupos.

  3. Clique em GET /groups.

  4. Clique no botão oAuth Access-token.

  5. Gere o Token de acesso.

  6. Clique no botão Experimente.

    Você receberá uma resposta como a seguinte com o nome do grupo e a ID do grupo:

    { 
  "groupInfoList": [ 
    { 
      "groupId": "3AAABLblqZhB4o9EnlvmGB_m8CrG5O6XClTBO7vmojOOexu5r3G95LtEV2Sp7BuhNvQYSvWB7PmmwVPXnhPIiYSuHV98Cerkp", 
      "groupName": "Default Group" 
    }, 
    { 
      "groupId": "3AAABLblqZhC3dPT6za5h7r1-BOEWivCe_OcAVONhcsKa57SL9_iCwGr5v_JED1No5jE20Pcjv0mYH2J-LoY1AcmqS69vRkO7", 
      "groupName": "test" 
    }, 
  ] 
}

Excluir grupo:

  1. Clique em DELETE /groups/{groupId}.

  2. Para gerar o Token de acesso, clique no botão oAuth Access-token.

  3. Adicione a groupId recebida na resposta da chamada anterior que você deseja excluir na caixa groupId.

  4. Clique em Experimente.

    Você receberá uma resposta como a seguinte quando o Grupo for excluído: sem conteúdo

Observação:

Não é possível excluir um grupo que tenha um usuário atribuído. Essencialmente, você pode excluir apenas o Grupo vazio. Você receberá uma resposta como a seguinte se houver um usuário no grupo.


{

  "code": "GROUP_NOT_EMPTY",

  "message": "The group cannot be deleted because it is not empty."

}


Iniciar/Enviar contratos

Gerar um documento temporário

  1. Acesse: https://secure.na1.adobesign.com/public/docs/restapi/v6

  2. Clique em transientDocuments e expanda o método POST /transientDocuments

  3. Clique no botão OAuth Access-token

    Método TransientDocument da API

    • Ative os Escopos para a transação
    • Clique em Autorizar
    Escopos OAuth

  5. Permitir acesso

    Se solicitado, clique em Permitir acesso

  6. Você retornará à página de métodos da API. O valor de Autorização agora está preenchido.

    • Insira o nome do arquivo no campo Nome do arquivo
    • Clique no botão Escolher arquivo e faça upload do documento para o contrato
    • Clique no botão Experimente!
    Experimente!

  7. A resposta é gerada.

    A transientDocumentID pode ser encontrada no Corpo da resposta:

    ID do documento temporário

Geração de um contrato usando o Documento temporário

  1. Acesse: https://secure.na1.adobesign.com/public/docs/restapi/v6

  2. Clique em contratos e expanda o método POST /agreements

    • Clique no botão OAuth Access-token
    • Ative o escopo do OAuth
    • Clique em Autorizar
      • Se solicitado, clique em Permitir acesso

  4. Você retornará à página de métodos da API. O valor de Autorização agora está preenchido.

    • Copie o script abaixo em um editor de texto (esse script é apenas um exemplo minimamente configurado; seu código de produção será diferente)
    •  Insira o valor de trasientDocumentId no código, onde indicado
    { 
  "fileInfos": [ 
   {"transientDocumentId":"PASTE YOUR TRANSIENTDOCUMENTID HERE"} 
  ], 
  "name": "test doc", 
  "participantSetsInfo": [ 
    { 
      "memberInfos": [ 
        { 
          "email": "noreply@echosign.com" 
        } 
      ], 
      "order": 1, 
      "role": "SIGNER" 
    } 
  ], 
  "signatureType": "ESIGN", 
  "state": "DRAFT" 
}

     

    • Copie o script personalizado e cole-o no campo AgreementInfo
    • Clique no botão Experimente!
    Método POST agreement

  5. A resposta é gerada.

    A agreementID pode ser encontrada no Corpo da resposta:

    Resposta do método POST agreement

Estas são as etapas para adicionar arquivos no parâmetro FileInfo:

  1. Usar a ID temporária:

    Acesse POST/transientDocuments e faça o upload do documento a ser usado do sistema local.
    Use a ID temporária gerada na seção Informações do arquivo em POST/Agreements:

    "fileInfos": [ 
     { 
       "transientDocumentId": "" 
     } 
   ],

  2. Usar ID do documento da biblioteca:

    Acesse o Painel. Clique em Adicionar documento à biblioteca e salve o modelo.
    Na Documentação da API REST, clique em GET /libraryDocuments e recupere a ID da biblioteca para o modelo que está sendo criado.
    Em POST/Agreements, forneça a ID do documento da biblioteca:

    "libraryDocumentId": "", 
  "libraryDocumentName": "",

  3. Usar URL publicamente disponível:

    Forneça o URL acessível publicamente a ser usado no parâmetro FileInfo:

    { 
      "documentURL": { 
        "mimeType": "", 
        "name": "", 
        "url": "" 
      },

  1. Acesse https://secure.na1.adobesign.com/public/docs/restapi/v6.

  2. Selecione a opção Contratos > POST/agreements. 

  3. Selecione a opção oAuth Access-Token e forneça os escopos necessários.

  4. Depois de adicionar o token de acesso, você pode usar o seguinte Código de solicitação:

    { 
"documentCreationInfo": { 
     "recipientSetInfos": [ 
          { 
               "recipientSetRole": "SIGNER", 
               "recipientSetMemberInfos": [{"email": "testemail@email.com"}] 
          }, 
          { 
               "recipientSetRole": "SIGNER", 
               "recipientSetMemberInfos": [{"email": "testemail@email.com"}] 
          } 
     ], 
     "signatureFlow": "SEQUENTIAL", 
     "name": "husband wife", 
     "signatureType": "ESIGN", 
     "fileInfos": [ 
{ 
"transientDocumentId": "(SAMPLE VALUE)3AAABLblqZhAJ9H6e23kZAfBUbItPvIhHTEyA6eZhziEp4KSntYcULpo43OEXwuWiWa-IM1r1EExYW0044CjCkliP4WFL5yKBUDq5DYSmSxVlFypcD0at8kK-BX-Mu3T9c_3GUqgDg0ArX0MmzWT72GLR_0M4Jq--mtuqGzq-VK1s-WGR6GcbedVY7XWAf3b3h-SpE08Hc-iF3zO7jQzi9newXSl-iW2JJsb_55tggkyxkXAkj74C1WD6KkJzgblK0JU-seh6QPDd0Fv6_mfQe2EPQA31nXj50aXwD_xlUBq7mg5FeaBnZ5bzgoqIWGHkbyeD2taaFdw*"} 
] 
} 
}

Na chamada de POST /agreements, no parâmetro signatureflow, você pode passar o valor SENDER_SIGNS_FIRST ou SENDER_SIGNS_LAST para adicionar o remetente como primeiro ou último signatário respectivamente.

Aqui está um exemplo da chamada no formato JSON:

{

  "documentCreationInfo": {

    "fileInfos": [

      {        "transientDocumentId":"3AAABLblqZ-yourIDGoesHere"

      }

    ],

    "name": "Test",

    "recipientSetInfos": [

      {

        "recipientSetMemberInfos": [

          {

            "email": "test@email.com"

          }

        ],

        "recipientSetRole": "SIGNER"

      }

    ],

    "signatureType": "ESIGN",

    "signatureFlow": "SENDER_SIGNS_FIRST"

  }

}

Observação:

A opção “Enviar em nome de” está disponível somente na API REST v6 com compartilhamento Avançado ativado.

Se a permissão de Enviar não for fornecida no compartilhamento ou se o Compartilhamento avançado não estiver habilitado, você receberá uma resposta como esta:

 

{"code":"PERMISSION_DENIED","message":"User provided in x-on-behalf-of-user header does not have required permission to perform this operation."}

 

Para a função Enviar em nome de, ative o Compartilhamento de conta avançado da conta para que os usuários possam conceder permissões de envio a outros usuários enquanto compartilham a própria conta. Para ativar o Compartilhamento avançado, consulte Ativar Compartilhamento de conta avançado.

Quando o Compartilhamento de usuários estiver habilitado, siga as seguintes etapas para Enviar em nome de:

Gerar um documento temporário:

  1. Acesse https://secure.adobesign.com/public/docs/restapi/v6.

  2. Em transientDocuments, clique em POST /transientDocuments.

  3. Para gerar o token para Autorização, clique no botão OAUTH ACCESS-TOKEN.

  4. Em x-on-behalf-of-user, forneça o email do usuário em nome do qual você deseja enviar no seguinte formato: email:test@email.com

  5. Para selecionar um Arquivo, clique em Escolher arquivo e em Experimente.

    Você recebe uma resposta como a seguinte com a transientDocumentId:

    {"transientDocumentId":"3AAABLblqZhB9Mjo0mrIu_pSgrf5VsMaKM68_Vmn80cimaqiUAD2OxrPp2e5H8GvjfiOxj4d5B8bCPkUfvaozW3KLisp_wseGVOL8A7oNZni1DWyFi4uNoxLQu4nUO44Wh63GQv9_HEJMePust0Pk94vJ_rbS96R7ic-vl7jbOkN0b4EB5-JMqlC-Fl_Vpyz8I1EQUrM5I4nB9ztMov4ad00yiOtDw0tB-Y2t5JdzM07P-mpJmwYEl8Fq2IeDuWjcR2tV7qY7TNGX2CNyh9jt0aMyduHeYa0GABr69z8Hm76eKdtaM_1E1ggWj205fSrNcwJsnpSO278*"}

Gerar um contrato usando o Documento temporário:

  1. Em Contratos, clique em POST /agreements.

  2. Para gerar o token para Autorização, clique no botão OAUTH ACCESS-TOKEN.

  3. Em x-on-behalf-of-user, forneça o email do usuário como é feito na criação do Documento temporário.

  4. Em AgreementInfo, adicione o seguinte código e clique em Experimente.

    { 
  "fileInfos": [ 
    {    "transientDocumentId":"3AAABLblqZhB9Mjo0mrIu_pSgrf5VsMaKM68_Vmn80cimaqiUAD2OxrPp2e5H8GvjfiOxj4d5B8bCPkUfvaozW3KLisp_wseGVOL8A7oNZni1DWyFi4uNoxLQu4nUO44Wh63GQv9_HEJMePust0Pk94vJ_rbS96R7ic-vl7jbOkN0b4EB5-JMqlC-Fl_Vpyz8I1EQUrM5I4nB9ztMov4ad00yiOtDw0tB-Y2t5JdzM07P-mpJmwYEl8Fq2IeDuWjcR2tV7qY7TNGX2CNyh9jt0aMyduHeYa0GABr69z8Hm76eKdtaM_1E1ggWj205fSrNcwJsnpSO278*" 
    } 
  ], 
  "name": "Test", 
  "participantSetsInfo": [ 
    { 
      "memberInfos": [ 
        { 
          "email": "signer@email.com" 
        } 
      ], 
      "order": 1, 
      "role": "SIGNER" 
    } 
  ], 
  "signatureType": "ESIGN", 
  "state": "IN_PROCESS" 
}

     

    Você recebe uma resposta como a seguinte com a agreementId:

    { 
  
  "id": "CBJCHBCAABAAUlen3l_fzlj1Kbn_wGZAhYcIgN0J7Qtq" 
  
}

  1. Faça logon no Adobe Sign.

  2. Navegue até Conta>API do Adobe Sign>Informações da API e clique em Documentação de métodos da API REST.

    Interface do usuário do webhook

  3. Use POST /transientDocuments, faça o upload de um arquivo e crie uma ID de documento temporário.

  4. Copie a ID de documento temporário e use-a no método POST /agreements. Mencione a seguinte solicitação JSON na caixa:

    { 
    "documentCreationInfo": { 
        "mergeFieldInfo": null, 
        "recipientSetInfos": [{ 
                "signingOrder": null, 
                "recipientSetRole": "SIGNER", 
                "recipientSetMemberInfos": [{ 
                    "securityOptions": null, 
                    "email": "test1@gmail.com" 
                }], 
                "privateMessage": "Hello 1", 
                "securityOptions": null 
            }, 
            { 
                "signingOrder": null, 
                "recipientSetRole": "SIGNER", 
                "recipientSetMemberInfos": [{ 
                    "securityOptions": null, 
                    "email": "test2@gmail.com" 
                }], 
                "privateMessage": "Hello 2", 
                "securityOptions": null 
            } 
        ], 
        "signatureType": "ESIGN", 
        "callbackInfo": null, 
        "message": "Please review and sign this document.", 
        "locale": "en_US", 
        "vaultingInfo": null, 
        "securityOptions": null, 
        "reminderFrequency": null, 
        "ccs": null, 
        "postSignOptions": null, 
        "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED", 
        "daysUntilSigningDeadline": null, 
        "formFieldLayerTemplates": [], 
        "name": "Adobe Sign Agreement", 
        "formFields": null, 
        "fileInfos": [{ 
            "libraryDocumentName": null, 
            "transientDocumentId": "XXXXXXXXXXXX", 
            "documentURL": null, 
            "libraryDocumentId": null 
        }] 
    } 
}

  5. Para executar a solicitação JSON, clique no botão Experimente.

    Interface do usuário do webhook

    O JSON correto retorna a resposta com a ID do contrato.

    Interface do usuário do webhook

Estes são os parâmetros que você pode transmitir no código para definir a senha aberta:

 

{

    "documentCreationInfo":

    [{

        "signatureType": "ESIGN",

               "recipientSetInfos": [{

            "recipientSetMemberInfos": [{                      

                "email": "abc@xyz.com"                  

            }],

                   

            "recipientSetRole": "SIGNER"                         

        }],

               "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED",

                   "fileInfos": [           {               

            "libraryDocumentId": "3AAABLblqZhBsm_vH7TVzU3hRdbtWuvzfTKDvBzaKZTiehjO2eGTk5Rlu02K-0BYn8HBJVFTWOmT_BQlrofPBlrCdjiJ_JI-V"        

        }       ],

               "name": "Open password to view document",

               "securityOptions": {        

            "openPassword": "1234",

                     "protectOpen": true   

        }  

    }]

}

 

Para criar um contrato usando a API com o estado “AUTHORING”, execute as seguintes etapas:

Acesse Post /agreements e crie o token de acesso com os escopos necessários.

Use o código de solicitação da seguinte maneira:

 

{

  "fileInfos": [

    {

      "transientDocumentId": "*********************"

    }

  ],

  "name": "A1",

  "participantSetsInfo": [

    {

      "memberInfos": [

        {

          "email": "abc@xyz.com"

        }

      ],

      "order": 1,

      "role": "SIGNER"

    }

  ],

  "signatureType": "ESIGN",

  "state": "AUTHORING"

}

 

A v6 tem um conjunto de APIs de criação para criar um contrato. Na v5, o formFields é consumido diretamente na API POST /agreements. No entanto, o usuário da v6 pode criar um contrato no estado AUTHORING (state = AUTHORING) por meio da v6 de POST /agreements e usar PUT /agreements/ID/formFields a qualquer momento para adicionar campos de formulário aos documentos deste contrato.

Estas são as etapas:

  1. Acesse a documentação da API REST v6 e selecione o método POST/agreements.

  2. Use o seguinte código de solicitação:

    { 
  "fileInfos": [ 
    { 
      "transientDocumentId": "***************************" 
    } 
  ], 
  "name": "test", 
  "participantSetsInfo": [ 
    { 
      "memberInfos": [ 
        { 
          "email": "abc@gmail.com" 
        } 
      ], 
      "order": 1, 
      "role": "SIGNER" 
    } 
  ], 
  "signatureType": "ESIGN", 
  "state": "AUTHORING" 
}

  3. Use o método put /agreements/{agreementId}/formFields com a seguinte solicitação como amostra:

    { 
  "fields": [ 
    { 
     "locations": [ 
          { 
            "height": 36, 
            "left": 75, 
            "pageNumber": "1", 
            "top": 200, 
            "width": 150 
          } 
        ], 
        "contentType": "SIGNATURE_BLOCK", 
        "name": "sigBlock1", 
        "inputType": "SIGNATURE", 
        "recipientIndex":1 
       } 
]}

     

    Isso envia o contrato para o destinatário mencionado assim que a solicitação é concluída.

  1. Faça logon no Adobe Sign.

  2. Navegue até Conta>API do Adobe Sign>Informações da API e clique em Documentação de métodos da API REST.

    Interface do usuário do webhook

  3. Use POST /transientDocuments, faça o upload de um arquivo e crie uma ID de documento temporário.

  4. Copie a ID de documento temporário e use-a no método POST /agreements. Mencione a seguinte solicitação JSON na caixa:

    { 
    "documentCreationInfo": { 
        "recipientSetInfos": [{ 
                "recipientSetRole": "SIGNER", 
                "recipientSetMemberInfos": [{ 
                    "email": "test1@gmail.com" 
                }], 
                "privateMessage": "Hello 1" 
            }, 
            { 
                "recipientSetRole": "SIGNER", 
                "recipientSetMemberInfos": [{ 
                    "email": "test2@gmail.com" 
                }], 
                "privateMessage": "Hello 2" 
            } 
        ], 
        "signatureType": "ESIGN", 
        "message": "Please review and sign this document.", 
        "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED", 
        "name": "Demo1", 
        "fileInfos": [{ 
            "transientDocumentId": "XXXXXXXXXX" 
        }], 
        "formFields": [{ 
                "hidden": "1", 
                "defaultValue": "test1@gmail.com", 
                "name": "Signer Email (Applicant-1)", 
                "inputType": "TEXT_FIELD", 
                "readOnly": true, 
                "locations": { 
                    "pageNumber": 1, 
                    "top": 100, 
                    "left": 100, 
                    "width": 100, 
                    "height": 30 
                }, 
  
                "contentType": "SIGNER_EMAIL" 
            }, 
            { 
                "name": "Signature (Applicant-2)", 
                "inputType": "SIGNATURE", 
                "locations": { 
                    "pageNumber": 1, 
                    "top": 520, 
                    "left": 162, 
                    "width": 280, 
                    "height": 30 
                }, 
                "contentType": "SIGNATURE", 
                "required": 1, 
                "recipientIndex": 1 
            }, 
            { 
                "name": "Signature (Applicant-3)", 
                "inputType": "SIGNATURE", 
                "locations": { 
                    "pageNumber": 2, 
                    "top": 312, 
                    "left": 154, 
                    "width": 280, 
                    "height": 30 
                }, 
                "contentType": "SIGNATURE", 
                "required": 1, 
                "recipientIndex": 1 
            }, 
            { 
                "defaultValue": "017/09/2018", 
                "displayFormatType": "DATE", 
                "name": "Signature Date (Applicant-4)", 
                "format": "DATE_DD_MM_YYYY", 
                "inputType": "TEXT_FIELD", 
                "readOnly": true, 
                "locations": { 
                    "pageNumber": 2, 
                    "top": 260, 
                    "left": 90, 
                    "width": 80, 
                    "height": 30 
                }, 
                "contentType": "DATA", 
                "required": 1, 
                "recipientIndex": 1 
            }, 
            { 
                "name": "Signature (Applicant-5)", 
                "inputType": "SIGNATURE", 
                "locations": { 
                    "pageNumber": 3, 
                    "top": 199, 
                    "left": 179, 
                    "width": 276, 
                    "height": 30 
                }, 
                "contentType ": "SIGNATURE", 
                "required": 1, 
                "recipientIndex": 1 
            }, 
            { 
                "contentType": "SIGNATURE_DATE", 
                "defaultValue": "06/07/2018", 
                "displayFormatType": "DATE", 
                "name": "Signature Date (Applicant-6)", 
                "format": "DATE_DD_MM_YYYY", 
                "inputType": "TEXT_FIELD", 
                "readOnly": true, 
                "locations": { 
                    "pageNumber": 3, 
                    "top": 188, 
                    "left": 488, 
                    "width": 76, 
                    "height": 25 
                }, 
                "required": 1, 
                "recipientIndex": 1 
            }, 
            { 
                "name": "Signature (Applicant-7)", 
                "inputType": "SIGNATURE", 
                "locations": { 
                    "pageNumber": 3, 
                    "top": 370, 
                    "left": 37, 
                    "width": 210, 
                    "height": 26 
                }, 
                "contentType ": "SIGNATURE", 
                "required": 1, 
                "recipientIndex": 2 
            }, 
            { 
                "contentType ": "SIGNATURE_DATE", 
                "defaultValue": "01/02/2018", 
                "name": "Signature Date (Applicant-8)", 
                "locations": { 
                    "pageNumber": 3, 
                    "top": 370, 
                    "left": 300, 
                    "width": 76, 
                    "height": 26 
                }, 
                "required": 1, 
                "recipientIndex": 2 
  
            } 
        ] 
    } 
}

  5. Para executar a solicitação JSON, clique no botão Experimente.

    Interface do usuário do webhook

    O JSON correto retorna a resposta com a ID do contrato.

    Interface do usuário do Webhook

  1. Faça logon no Adobe Sign.

  2. Navegue até Conta>API do Adobe Sign>Informações da API e clique em Documentação de métodos da API REST.

    Fnord.

  3. Use POST /transientDocuments, faça o upload de um arquivo e crie uma ID de documento temporário.

  4. Copie a ID de documento temporário e use-a no método POST /agreements. Mencione a seguinte solicitação JSON na caixa:

    { 
    "options": { 
        "noChrome": true, 
        "authoringRequested": true 
    }, 
    "documentCreationInfo": { 
        "recipientSetInfos": [{ 
                "recipientSetRole": "SIGNER", 
                "recipientSetMemberInfos": [{ 
                    "email": "test1@gmail.com" 
                }], 
                "privateMessage": "Hello 1" 
            }, 
            { 
                "recipientSetRole": "SIGNER", 
                "recipientSetMemberInfos": [{ 
                    "email": "test2@gmail.com" 
                }], 
                "privateMessage": "Hello 44" 
            } 
        ], 
        "signatureType": "ESIGN", 
        "message": "Please review and sign this document.", 
        "locale": "en_US", 
        "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED", 
        "formFieldLayerTemplates": [], 
        "name": "Adobe Sign Agreement", 
        "formFields": null, 
        "fileInfos": [{ 
            "libraryDocumentName": null, 
            "transientDocumentId": "XXXXXXXXXXXX" 
        }] 
    } 
}

  5. Para executar a solicitação JSON, clique no botão Experimente.

    Fnord.

    O JSON correto retorna a resposta com a ID do contrato.

    Fnord.

  6. Para abrir o contrato no Modo de criação, copie o URL e cole-o na barra de endereços de um navegador.

  7. Arraste e solte os campos de formulário no local desejado.

  8. Para enviar o contrato para assinatura, clique em Enviar. 

Use POST /agreements para criar um contrato. Isso o envia para assinatura e retorna a agreementID na resposta ao cliente. Abaixo está o formato JSON para enviar o contrato usando o método de autenticação por telefone.

 

{

"documentCreationInfo": {

"mergeFieldInfo": null,

"recipientSetInfos": [{

"signingOrder": null,

"recipientSetRole": "SIGNER",

"recipientSetMemberInfos": [{

"securityOptions": null,

"email": "Signer@email.com"

}],

 

"privateMessage": null,

"securityOptions": [{

"authenticationMethod": "PHONE",

"phoneInfos": [{

"phone": "1111111111",

"countryCode": "+1"

}]

}]

}],

 

"signatureType": "ESIGN",

"callbackInfo": null,

"message": "Please review and sign this document.",

"locale": "en_US",

"vaultingInfo": null,

"securityOptions": null,

"reminderFrequency": null,

"ccs": null,

"postSignOptions": null,

"signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED",

"daysUntilSigningDeadline": null,

"formFieldLayerTemplates": [],

"name": "Adobe Sign Agreement-Phone authentication testing",

"formFields": null,

"fileInfos": [{

"libraryDocumentName": null,

"transientDocumentId": "3AAABLYourTransactionID",

"documentURL": null,

"libraryDocumentId": null

}]

},

 

"options": {

"autoLoginUser": true,

"authoringRequested": false,

"noChrome": true,

"sendThroughWeb": null,

"sendThroughWebOptions": null,

"locale": "en_US"

}

}

 

É possível mesclar os dados diretamente nos campos de formulário usando os seguintes métodos:

  • Usar um modelo de biblioteca:

    se você estiver usando uma ID de modelo de biblioteca no parâmetro FileInfo, forneça o nome exato do campo e os dados associados na seção abaixo:

 

"mergeFieldInfo": [

     {

       "defaultValue": "",

       "fieldName": ""

     }

   ],

 

  • Usar tags de texto em um documento carregado como um Documento temporário:

    se você fizer o upload de um documento que tenha tags de texto adicionadas a ele como um documento temporário, forneça o nome exato do campo e os dados associados na seção abaixo: 

 

"mergeFieldInfo": [

     {

       "defaultValue": "",

       "fieldName": ""

     }

   ],

 

Como enviar um contrato usando a API que tem valores pré-preenchidos nos campos de formulário específicos (mergefield)?

O pré-requisito desta chamada é primeiro concluir a etapa “Upload temporário” e obter uma “transientDocumentId” (usando: secure.na1.echosign.com/public/docs/restapi/v5#!/transientDocuments/createTransientDocument) para usar aqui.

  • Esta chamada inclui a seção “mergeFieldInfo”, na qual são fornecidos os valores padrão para campos de formulário específicos.
  • Isso pré-preenche os dados vindos de outro sistema na chamada da API.
  • Esses campos no contrato são editáveis ou somente leitura.

 

Pré-requisitos:

  1. ID do documento temporário
  2. Nomes de campos e seus respectivos valores

 

Exemplo de chamada de solicitação:

 

Solicitar:

POST /api/rest/v5/agreements HTTP/1.1

Host: api.na1.echosign.com (ou você pode especificar seu nome do fragmento, que pode ser encontrado usando a chamada getbaseURis: https://secure.na1.echosign.com/public/docs/restapi/v5#!/base_uris/getBaseUris

Token de acesso: 2AAABLblqZhA_D1mluNKQP7py5vXtt-1UHl9NR25e_C3LnKTUH14IblbrXODbXGRozyr7ChBkJNM*

x-user-email: sender@yourdomain.com

Content-Type: application/json

Cache-Control: no-cache

 

{

   "documentCreationInfo": {

       "signatureType": "ESIGN",

       "recipientSetInfos": [

           {

               "recipientSetMemberInfos": [

                   {

                       "email": "signerEmail@domain.com"

                   }

               ],

               "recipientSetRole": "SIGNER"

           }

        ],

      

       "signatureFlow": "SENDER_SIGNATURE_NOT_REQUIRED",

       "message": "Please Sign this from us!",

       "fileInfos": [

           {

               "transientDocumentId": "3AAABLblqZhD1uP3ZnkJximC0JV1S677PR5xmybSJ-SJn6OtEy2tVqFyMN4xUAbhKTSkLw2Zb6HEF4zAGsrUd2ycoB8fFHQJhrci0O6267VztmIL4nCicSqvAjO7HckATHAsovVmuYwI9_FDDgHg0ogyti62L13HQFZIQRe9iyQMvvzbmksM7ODNK_HEepEKRCeJTtis9FOlz6uRCcIMNlbX_2GU8utWT"

           }

       ],

       "name": "MSA Edited”,

        "mergeFieldInfo": [

            {

                "fieldName": "AccountName",

                "defaultValue": "Sam's Garage"

            },

            {

                "fieldName": "AccountNumber",

                "defaultValue": "8756999"

            },

            {

                "fieldName": "Zip",

                "defaultValue": "94501"

            },

            {

                "fieldName": "City",

                "defaultValue": "CityVille"

            },

            {

                "fieldName": "State",

                "defaultValue": "CA"

            },

            {

                "fieldName": "Street",

                "defaultValue": "123 Some Road"

            },

            {

                "fieldName": "Title1",

                "defaultValue": "COO"

            },

            {

                "fieldName": "Description",

                "defaultValue": "Some new description here"

            }

        ]

   }

 

}

 

A resposta a esta chamada é o “agreementId” que você precisa armazenar no sistema para chamadas subsequentes (signingUrl, status, formData etc.)

 

Resposta:

{

  "agreementId": "3AAABLblqZhCf_7xDcrOgKFwAabp1S-OFfvUdHf2wJsSMwlB95_x_WdUeab67jOkJi1IJzWuSJ0zdNNKugS1blZB4LT5vNVyJ"

}

 

Ao executar o método “post /megaSigns/{megaSignId}/views”, um erro é exibido: “Requested view is not available for the resource in the current state”.

O erro é mostrado se o valor do parâmetro do nome fornecido for inválido no código de solicitação abaixo:

{
  "name": " "
}

Por exemplo, se o contrato do MegaSign já estiver “IN_PROCESS”, passar o valor como “AUTHORING” gera o erro mencionado. Verifique se o valor fornecido corresponde ao estado atual do contrato.

Ao executar o método “put /megaSigns/{megaSignId}/state”, um erro é exibido: “No value provided for MegaSign cancellation info”.

O erro é causado quando o código de solicitação não tem o parâmetro: 

"megaSignCancellationInfo": {
    "comment": "",
    "notifyOthers": false
  }

Em vez de usar o “Esquema mínimo”, clique em “Completar esquema modelo” e forneça o código de solicitação completo para executar a chamada da API. 

Para alterar o estado do contrato do MegaSign, use put /megaSigns/{megaSignId}/state e execute as seguintes etapas:

  1. Vá para a Documentação da API REST v6 e selecione o método
    put /megaSigns/{megaSignId}/state.
  2. Forneça o valor de Authorization e também If-Match e a megasignID.
    • Para recuperar a megasignID, use get /megaSigns
    • Para recuperar If-Match, use get /megaSigns/{megaSignId} e, no cabeçalho, localize “Etag”
  3. {
      "state": "CANCELED",
      "megaSignCancellationInfo": {
       "comment": "cancel",
       "notifyOthers": false
      }
    } 

Para registrar um webhook com êxito, o URL do webhook responde a essa solicitação de verificação com um código de resposta 2XX e, além disso, pode enviar o valor da mesma ID de cliente de uma das duas maneiras a seguir:

  1. Em um cabeçalho de resposta X-AdobeSign-ClientId. É o mesmo cabeçalho transmitido na solicitação e que deve ser repetido na resposta.
  2. No corpo da resposta JSON, com a chave de X-AdobeSign-ClientId e seu valor sendo a mesma ID de cliente enviada na solicitação.

O Adobe Sign recebe a resposta 2XX com X-AdobeSign-ClientId. O usuário pode verificar se está configurado corretamente no webhook ou não.

O URL do webhook não está respondendo conforme esperado. Para cada notificação Post enviada pelo Adobe Sign, o URL responde com o código de status 2XX e retransmite a ID de cliente enviada nos cabeçalhos de solicitação (X-AdobeSign-ClientId) para os cabeçalhos de resposta. 

Para obter informações completas, consulte o seguinte link:
https://www.adobe.io/apis/documentcloud/sign/docs.html#!adobedocs/adobe-sign/master/webhooks/webhook_events.md

Quando o URL não cumpre este protocolo, o Adobe Sign considera que ele não aceitou a solicitação e tenta reagendar de acordo com a política confiável.

Se o webhook não responder e o tempo máximo de repetição ou o intervalo máximo de repetição for excedido, o webhook será desativado.

Este trabalho está licenciado com uma licença Creative Commons Attribution-NonCommercial-Share Alike 3.0 Unported  As postagens no Twitter™ e no Facebook não são cobertas pelos termos da licença Creative Co


Gerenciar/Obter informações sobre contratos

Para alterar o documento já enviado para assinatura, use o método PUT /agreements/{agreementId}, com o qual você pode atualizar um contrato existente. Forneça a ID temporária junto com a ID do contrato no seguinte código de solicitação:

 

{

  "documentUpdateInfo": {

    "fileInfos": [

      {

        "agreementDocumentId": "",

        "transientDocumentId": ""

      }

    ]

  }

}

 

Estas são as instruções para atualizar o estado de “AUTHORING” para “IN_PROCESS” usando Put /agreements/{agreementId}/state:

  1. Obtenha a ID do contrato recuperada usando o método POST/Agreement.

  2. Use Get /agreements/{agreementId} para recuperar a ETag mais recente.

  3. Execute Put /agreements/{agreementId}/state e forneça as seguintes informações: "state": "IN_PROCESS"

Não.

Não há método que faz o upload de uma cópia assinada na API REST atual.

O remetente deve fazer upload da cópia assinada na página Gerenciar.

DELETE /agreements/ID é usado para ocultar um contrato na página Gerenciar.

A Adobe tem uma nova API PUT /agreements/ID/me/visibility para controlar a visibilidade de um contrato (em GET /agreements). Além da funcionalidade fornecida por DELETE /agreements/ID, o novo endpoint de visibilidade também permite que um usuário reverta a operação “ocultar”, ou seja, torne o contrato visível novamente. 

Você também pode seguir as etapas detalhadas abaixo:

  1. Acesse o método get /agreements e recupere a ID do contrato.
  2. Clique em put /agreements/{agreementId}/me/visibility e forneça a solicitação abaixo como amostra:
    {
      "visibility": "HIDE"
    }
    A ID do contrato fica oculta somente em get /libraryDocuments, no entanto, ela ainda estará visível na interface da guia Gerenciar.
Observação:

O recurso Retenção da API não está ativado por padrão.

Para ativar a operação DELETE/agreements, entre em contato com seu gerente de sucesso e solicite que a Retenção da API seja ativada para a conta.

Para obter mais informações sobre como ativar os recursos de Retenção na sua conta, consulte Adobe Sign - Retenção de documentos.

  1. Faça logon como administrador do Adobe Sign e navegue até: https://secure.adobesign.com/public/docs/restapi/v6

    • Clique em Contratos e expanda o método GET /agreements
    • Clique no botão OAUTH ACCESS-TOKEN 
    • Ative o escopo agreement_read:self
    • Clique no botão Autorizar
      • Se solicitado, clique em Permitir acesso
    • Clique no botão Experimente! botão
    Método Get Agreement

  3. A resposta é gerada.

    A agreementId pode ser encontrada no Corpo da resposta:

    Resposta de Get Agreement

  4. DELETE /agreements/{agreementId}/documents: exclui todos os documentos relacionados a um contrato. O contrato em si permanece visível na página Gerenciar.

    • Selecione a operação DELETE/agreements a ser executada.
    • Clique no botão OAUTH ACCESS-TOKEN e crie o token de acesso com o escopo agreement_retention.
    • Forneça a agreementId do contrato que você deseja excluir.
    • Depois que o contrato é excluído, o Corpo da resposta passa a conter “sem conteúdo”.

Você obtém a seguinte resposta se a operação DELETE/agreements não estiver ativada:

 "code": "DYNAMIC_DOCUMENT_EXPIRATION_NOT_ENABLED",

  "message": "The operation requires some account settings to be enabled. Please contact the Adobe Sign team to enable the settings."

Como fazer o download do documento Assinado junto com o relatório de auditoria e o documento de suporte por meio da API REST do Adobe Sign em vez de fazer uma chamada separada para fazer o download do relatório de auditoria usando o seguinte método.

GET /agreements/{agreementId}/auditTrail

  1. Acesse https://secure.na1.adobesign.com/public/docs/restapi/v5.

  2. Clique em GET /agreements/{agreementId}/combinedDocument.

  3. Clique no botão oAuth Access-token.

  4. O Token de acesso é gerado automaticamente assim que sua autorização é aceita.

  5. Forneça a agreementId.

  6. Em attachSupportingDocuments, selecione true no menu suspenso.

  7. Em attachAuditReport, selecione true no menu suspenso.

  8. Clique no botão Experimente! botão.

    Obter documentos combinados

    Ele faz o download do PDF que combina o documento assinado, o documento de suporte e o relatório de auditoria.

Para fazer o download de documentos em massa, somente a ferramenta de exportação de documentos está disponível e, com a API, você pode fazer o download de documentos apenas um por um. Este é o método da API para fazer a mesma coisa:

https://secure.na1.adobesign.com/public/docs/restapi/v5#!/agreements/getCombinedDocument


Modelos de biblioteca e formulários web

  1. Faça logon no Adobe Sign como administrador e navegue até: https://secure.na1.adobesign.com/public/docs/restapi/v6

    • Clique em libraryDocuments e expanda o método GET /libraryDocuments
    • Clique no botão OAUTH ACCESS-TOKEN 
    • Ative o escopo library_read:self
    • Clique no botão Autorizar
      • Se solicitado, clique em Permitir acesso
    • Clique no botão Experimente! botão
    Método Get LibraryDocument

  3. A resposta é gerada.

    A libraryDocumentId pode ser encontrada no Corpo da resposta:

    Resposta de Get LibraryDocument

A Adobe tem um novo PUT /libraryDocuments/ID/me/visibility na API para controlar a visibilidade de um contrato (em GET/agreements). Além da funcionalidade fornecida por DELETE /agreements/ID, o novo endpoint de visibilidade também permite que um usuário reverta a operação “ocultar”, ou seja, torne o contrato visível novamente.

Você pode seguir as etapas detalhadas abaixo:

  1. Acesse o método get /libraryDocuments e recupere a ID do contrato.
  2. Clique em put /libraryDocuments/{libraryDocumentId}/me/visibility e forneça a solicitação abaixo como amostra:
    {
      "visibility": "HIDE"
    }
    A ID da biblioteca fica oculta somente em get /libraryDocuments, no entanto, ela ainda estará visível na interface da guia Gerenciar.
Observação:
  • Envie uma solicitação para a equipe de suporte para obter o escopo ativado para a exclusão em Bibliotecas.
  • A API exclui o documento da biblioteca. No entanto, os contratos criados usando este documento da biblioteca não são afetados.


Gerar uma libraryDocumentID

  1. Acesse https://secure.echosign.com/public/docs/restapi/v5.

  2. Clique em libraryDocuments.

  3. Clique no botão oAuth Access-token. 

    Autorizar acesso - Token para si próprio, grupo ou conta.

  4. Selecione libraryTemplateType - Document ou Form_field_layer.

  5. Clique em Experimente.

    Você pode receber uma resposta como a seguinte para todos os seus modelos. (Copie libraryDocumentId para o Modelo de biblioteca que você pretende excluir).

    { 
  "libraryDocumentList": [ 
    { 
      "name": "testing fields", 
      "modifiedDate": "2017-08-04T01:06:05-07:00", 
      "scope": "PERSONAL", 
      "libraryDocumentId": "3AAABLblqZhAK53Dvzq88Q1Ov0TEvMAySDPpIVjF1PWgUpy0H1uYggt4iwGiRSZYlWfl9ms_AcmgZ_uZMPPN2hNT9izwaspHc", 
      "libraryTemplateTypes": [ 
        "DOCUMENT" 
      ] 
    },


Excluir Modelos de biblioteca

  1. Copie libraryDocumentID do Corpo da resposta.

  2. Acesse Delete libraryDocuments.

  3. Clique no botão oAuth Access-token. Autorizar acesso - Token para si próprio, grupo ou conta.

  4. Cole a libraryDocumentId no campo Value.

  5. Clique em Experimente. 
    O modelo é excluído.

    Você obtém o seguinte Código de resposta: 204

Observação:

Somente formulários da Web em um estado Draft podem ser atualizados.

  1. Crie o widget usando post /widgets.

  2. Obtenha a ID do widget de get/widgets.

  3. Depois de criar usando o método GET /widgets/{widgetId}, busque a ETag no cabeçalho da Resposta.

    Foo

  4. Em put  /widgets/{widgetId}, use a ETag de GET /widgets/{widgetId}. No parâmetro If-Match, insira widgetId e widgetInfo.

    Foo 

    { 
  "fileInfos": [ 
    { 
      "transientDocumentId": "******" 
    } 
  ], 
  "name": "Widht_Name", 
  "status": "DRAFT", 
  "widgetParticipantSetInfo": { 
    "memberInfos": [ 
      { 
        "email": "" 
      } 
    ], 
    "role": "SIGNER" 
  } 
}


Exemplos de casos de uso

  1. Faça uma chamada de get/agreements com o x-api-user correto.

  2. No Corpo da resposta, localize o contrato enviado para assinatura para o qual você deseja localizar o URL de assinatura e anote a ID do contrato

  3. Faça uma chamada de get/agreements/{agreementId}/signingUrls usando a ID do contrato recebida da chamada get/agreements.

     

    Resultado

    A saída retorna o endereço de email do(s) signatário(s) e o URL de assinatura eletrônica.

    Método Get Agreement

 Adobe

Receba ajuda com mais rapidez e facilidade

Novo usuário?

Links rápidos

Veja todos os seus planos Gerenciar seus planos
Ver links rápidos
Ocultar links rápidos

Avisos legais    |    Política de privacidade online