Adicionar Signatário

Como adicionar um signatário em um documento já criado.

Para adicionar um signatário à um documento, você pode utilizar a seguinte mutation.

Definição da Mutation:

Aqui está a definição da mutation para adicionar um signatário:

mutation(
  $document_id: UUID!,
  $signer: SignerInput
) {
  createSigner(
    document_id: $document_id 
    signer: $signer
  ) {
    public_id
    name
    email
    delivery_method
    action { name }
    link {
      id
      short_link 
    }
    created_at
  }
}

Parâmetros:

document_id: O identificador único do documento ao qual você deseja adicionar um signatário.
signer: Contém os detalhes do signatário que está sendo adicionado. Este objeto requer atenção especial para os campos obrigatórios e opcionais, conforme definido em nossa especificação de SignerInput.

Após, é necessário atribuir os valores das variáveis declaradas na mutation, em um JSON :

{
  "document_id": "ID_DO_DOCUMENTO",
    "signer": { 
      "email": "troque-esse-email-que-tambem-e-publico@tuamaeaquelaursa.com",
      "action": "SIGN"
    }
}

Lembre-se de substituir os valores, passando o ID do documento e informações de signatário, que são os mesmos mencionados em: Criando um Documento.

Resposta esperada:

A resposta incluirá os detalhes sobre o signatário criado mencionados na definição da mutation. Aqui está um exemplo de resposta que você pode esperar:

{
  "data": {
    "createSigner": {
      "public_id": "434fcd4c6d0c11eea3c542010a2b60c6",
      "name": null,
      "email": "troque-esse-email-que-tambem-e-publico@tuamaeaquelaursa.com",
      "delivery_method": "DELIVERY_METHOD_EMAIL",
      "action": {
        "name": "SIGN"
      },
      "link": null,
      "created_at": "2023-10-17T16:43:13.000000Z"
    }
  }
}

O campo link informará o link de assinatura para o signatário, caso o mesmo tenha sido adicionado usando o parâmetro "delivery_method": "DELIVERY_METHOD_LINK".

AnteriorTransferindo um Documento PróximoRemover Signatário

Atualizado há 6 meses

Isto foi útil?

mutation( $document_id: UUID!, $signer: SignerInput ) { createSigner( document_id: $document_id signer: $signer ) { public_id name email delivery_method action { name } link { id short_link } created_at } }

{ "data": { "createSigner": { "public_id": "434fcd4c6d0c11eea3c542010a2b60c6", "name": null, "email": "troque-esse-email-que-tambem-e-publico@tuamaeaquelaursa.com", "delivery_method": "DELIVERY_METHOD_EMAIL", "action": { "name": "SIGN" }, "link": null, "created_at": "2023-10-17T16:43:13.000000Z" } } }