Criando documentos com assinatura mista

Permite o controle de assinatura eletrônica ou qualificada por signatário.

A assinatura mista permite que um mesmo documento tenha signatários com tipos diferentes de assinatura. Por exemplo, uma pessoa pode assinar de forma eletrônica padrão, enquanto outra utiliza uma assinatura qualificada com certificado digital.

Esse recurso está disponível somente para organizações com plano corporativo e suas organizações filhas. A API retornará um erro de permissão quando ele for utilizado por uma organização que não atenda a esse requisito.

No schema, essa configuração é feita individualmente pelo campo type de cada SignerInput:

input SignerInput {
  email: EmailScalar
  action: ActionEnum!
  type: SignerTypeEnum = STANDARD
}

Os tipos disponíveis são:

Valor	Descrição
STANDARD	Utiliza o fluxo normal de assinatura eletrônica. É o valor padrão.
QUALIFIED	Exige uma assinatura qualificada, realizada com certificado digital.

Exemplo de criação

A mutation utilizada continua sendo a createDocument:

mutation CreateMixedSignatureDocument(
  $document: DocumentInput!
  $signers: [SignerInput!]!
  $file: Upload!
) {
  createDocument(
    document: $document
    signers: $signers
    file: $file
  ) {
    id
    name
    signatures {
      public_id
      name
      email
      type
      action {
        name
      }
    }
  }
}

Nas variáveis, defina o tipo de assinatura para cada signatário:

{
  "document": {
    "name": "Contrato com assinatura mista"
  },
  "signers": [
    {
      "email": "[e-mail]",
      "action": "SIGN",
      "type": "STANDARD"
    },
    {
      "email": "[e-mail]",
      "action": "SIGN",
      "type": "QUALIFIED"
    }
  ]
}

Nesse exemplo, o primeiro signatário segue o fluxo normal, enquanto o segundo precisa utilizar um certificado digital para concluir sua assinatura. Como STANDARD é o valor padrão, ele pode ser omitido.

Para criar um documento com assinatura mista, utilize o campo type dentro de cada signatário. O campo document.qualified: true ativa a assinatura qualificada a de nível do documento e não é a configuração indicada quando apenas alguns signatários devem utilizar certificado digital.