Pular para o conteúdo
  • Não há sugestões porque o campo de pesquisa está em branco.

Criação de Nomenclatura em "Assinar Como" (API)

Este endpoint da API D4Sign permite que você crie uma nova nomenclatura para a opção "Assinar como", gerando um número Act exclusivo. Esse Act pode ser usado para cadastrar signatários, personalizando a descrição do papel que eles desempenham no processo de assinatura.

🚧 Importante: Você precisará incluir seus tokens de autenticação na requisição, conforme a documentação da API D4Sign.

Exemplo de URL completa para requisição: https://secure.d4sign.com.br/api/v1/documents/{UUID-USUARIO}/addsignaturetype?tokenAPI={SEU-TOKEN}&cryptKey={SEU-CRYPT-KEY}

Body

No corpo da requisição, você informará o nome/título que deseja adicionar à opção "Assinar como".

JSON
{
    "tipo": "Testemunha Teste"
}

Detalhes dos Parâmetros do Body:

Parâmetro Tipo Obrigatoriedade Descrição
tipo String Obrigatório O nome/título que será adicionado à opção "Assinar como".

Resposta (Status 200 - Sucesso)

Quando a requisição for bem-sucedida, você receberá o novo número Act gerado, o tipo de assinatura e a confirmação de sucesso.

JSON
{
    "act": 373,
    "tipo_assinatura": "Testemunha Teste",
    "sucesso": 1
}

Detalhes dos Campos da Resposta:

Campo Tipo Descrição
act Número O número Act gerado para a nova nomenclatura.
tipo_assinatura String O nome/título da assinatura que foi cadastrada.
sucesso Número Indica se a operação foi bem-sucedida (1).

🚧 Observações Importantes:

  • Verificação do UUID do Usuário: Para utilizar este endpoint, você precisará do UUID do usuário. Ele pode ser verificado na documentação de Verificar usuários.

  • Vinculação a Signatários: Após gerar um número Act (ex: 347), você deve vinculá-lo a um novo signatário usando o endpoint de Cadastrar Signatários.

  • Escopo do Act: O novo número Act é vinculado à plataforma, não ao usuário. Qualquer conta que conheça o número Act cadastrado tem permissão para utilizá-lo.

  • Reuso de Nomes: É possível cadastrar uma nova nomenclatura "Assinar como" que já exista. Cada vez que o cadastro é realizado, um novo número Act é gerado, e não há conflito com nomes pré-existentes.

  • Disponibilidade: O Act cadastrado ficará disponível para uso na plataforma.