Assinatura eletrônica

Assinar um documento leva tempo: o fluxo manda o arquivo, as pessoas recebem o convite e assinam quando podem — horas ou dias depois. Por isso a assinatura costuma render dois momentos no seu desenho: um fluxo que cria o documento e um segundo, agendado, que consulta como está e segue adiante quando todos assinaram.

Os quatro nós ficam no grupo Assinatura eletrônica da paleta do editor.

O que vale para todos

• Escolha a credencial no topo do nó, e depois a Operação — os campos abaixo dela mudam conforme a operação escolhida.
• Todo campo de texto aceita {{ … }} com dados do item, então o mesmo nó atende um lote inteiro (um contrato por item, por exemplo).
• Todos têm uma saída (main) e acrescentam ao item um campo com a resposta do serviço. Quando a consulta devolve vários registros, sai um item por registro.
• Na aba Config ficam Timeout (segundos) (padrão 60) e Saída do nó (Mesclar item, o padrão, ou Substituir item) — veja Ajustes do nó. Falhas seguem o Em caso de erro da mesma aba.

De onde vem o arquivo a assinar

Na Autentique e na ClickSign, o arquivo é o que viaja junto com o item sob o nome de uma propriedade binária — o mesmo caminho descrito em Como os arquivos circulam entre os nós. O campo Propriedade binária (arquivo a assinar) aponta qual deles enviar (data é o padrão), então o PDF do RM — Gerar Relatório, o resultado do Salvar em arquivo ou o download do Google Drive — Arquivos entram direto na assinatura:

RM — Gerar Relatório  →  Autentique — Documento (enviar para assinatura)
Google Drive — Arquivos (baixar)  →  ClickSign — Documento (enviar documento)

Se o item não trouxer aquela propriedade, o nó avisa e pede que você gere ou baixe o arquivo num passo anterior.

Os nós do Solis são diferentes: eles trabalham com XML e recebem o conteúdo em campos de texto, não pela propriedade binária.

Autentique — Documento

Um nó só cobre o ciclo inteiro. Em Operação:

Enviar para assinatura pede:

Cada signatário leva o e-mail e, se quiser, o nome e a ação: SIGN (assinar), APPROVE (aprovar) ou ACKNOWLEDGE (tomar ciência). Um signatário sozinho pode ser escrito sem a lista em volta. Como o campo aceita {{ … }}, dá para montar a lista a partir dos dados do fluxo.

Escolhendo Sim, um de cada vez, cada pessoa só é convidada depois que a anterior assina.

Consultar documento pede o ID do documento — o mesmo que saiu no envio. Listar documentos tem Documentos por página (padrão 50) e Página (padrão 1), e emite um item por documento.

Sai o item com _autentique, com o documento e a situação de cada signatário. Quando a credencial está em ambiente de testes, _autentique.sandbox avisa que o documento nasceu sem valor legal.

Para cadastrar a credencial você precisa do token da API gerado nas configurações da sua conta Autentique, e escolhe entre Produção e Sandbox.

ClickSign — Documento

Na ClickSign a assinatura é montada em três passos, e por isso o nó tem quatro operações — três para montar, uma para acompanhar:

Cada passo devolve em _clicksign a chave do que criou, e o passo seguinte a consome. Encadeie os nós nessa ordem e use {{ _clicksign.key }}:

Enviar documento  →  Cadastrar signatário  →  Vincular signatário ao documento

Enviar documento:

Cadastrar signatário:

Vincular signatário ao documento pede a Chave do documento e a Chave do signatário, e define:

Deixando em Não, envio depois, o vínculo é criado mas ninguém recebe o convite — a assinatura fica parada até alguém avisar.

Consultar documento pede a Chave do documento.

Sai, em todas as operações, o item com _clicksign.

Para cadastrar a credencial você precisa do Access Token gerado nas configurações da sua conta ClickSign, e escolhe entre Produção e Sandbox.

Solis — Documento

Gera e valida os documentos XML do Diploma Digital (DDS), na versão do layout do MEC informada — padrão 1.05.

Nas operações de gerar:

Atualizar é a própria operação de gerar: informe o ID do documento original e traga junto, nos dados, o XML gerado antes, além dos campos a alterar.

Nas operações de validar, informe o XML a validar.

Sai o item com o que o DDS respondeu. Um documento inválido não derruba o fluxo: o Solis responde com sucesso e traz os erros e a situação do diploma como campos do item, para um IF decidir o que fazer. Só falha de comunicação ou de credencial vira erro do nó.

Solis — Assinaturas

Cuida do pedido de assinatura dos XMLs gerados no nó anterior.

Abrir pedido:

Fora do recarimbo, o pedido exige signatários.

Consultar pedidos filtra por Código do pedido, Situação (pendente, concluído), Descrição do pedido, Data inicial e Data final (no formato AAAA-MM-DD), e pode Incluir validação da assinatura de arquivamento. Cada processo devolvido vira um item, com os signatários e os links.

Validar assinaturas e carimbos do tempo pede os Arquivos .xml/.zip, numa lista com o nome e o conteúdo em Base64 de cada um.

Para cadastrar a credencial — a mesma dos dois nós Solis — você precisa da URL base do DDS, da chave de acesso do contrato, e do e-mail e da senha do usuário do contrato, fornecidos pela Solis.

Veja também: Credenciais, Ações e Ajustes do nó.