Definindo parâmetros para a Assinatura Eletrônica de Documentos com ClickSign
Os parâmetros para assinatura eletrônica com o ClickSign são definidos na tb_referencia_integracao onde a coluna parceiro conter a chave primária da tb_parceiro para o ClickSign. A coluna referencia poderá conter "tb_empreendimento" ou "tb_documento" - atentar que se trata de uma coluna VARCHAR que conterá o nome da tabela; a coluna id_referencia conterá a chave primária na tabela definida na coluna anterior. Os parâmetros para integração são contidos em um objeto JSON na coluna json_externo. Quando a referência for um empreendimento, a configuração servirá para a assinatura do contrato de compra e venda bem como para qualquer documento constante na tabela de referência integração - das telas de Finalização de Aditivo, Finalização de Distrato, Finalização de Entrega de Chaves e Documentos Assinados do Processo. Caso a referência seja a tabela de documento, as configurações definidas no documento JSON sobrescreverão aquelas definidas para o empreendimento - é também possível ter diferentes configurações para um documento, variando por empreendimento, quando a coluna empreendimento da tb_referencia_integracao é preenchida com a chave primária do mesmo.
Atributos aceitos pelo JSON da tabela de referência integração para o Clicksign:
- "acess_token": O único atributo verdadeiramente obrigatório, contém uma string com a chave de API do ClickSign para o cliente. Veja como obter a chave em: https://ajuda.clicksign.com/article/994-como-criar-um-acess-token-que-permitira-a-comunicacao-com-a-api-da-plataforma-clicksign
- "assina_manual_empresa": Define um vetor de objetos com signatários que assinarão pela empresa como vendedor
- "auto_close": Poderá ser true ou false , quando verdadeiro, o documento será fechado automaticamente quando todos assinarem, é verdadeiro por padrão caso omitido
- "auth": Define como será enviado o token para assinar o documento para os signatários, podendo ser email, sms, whatsapp,
pix, api ou icp_brasil; quando omitido o padrão será sms. Veja mais em https://developers.clicksign.com/v1.0/docs/criar-signatario#atributos-para-a-cria%C3%A7%C3%A3o-de-signat%C3%A1rios - "grupos_por_papel": Contém um objeto para definir a ordem das assinaturas; não é obrigatório. Veja mais em: https://duvida.dommus.com.br/books/dommus-vende-configuracoes/page/definindo-a-ordem-dos-signatarios-para-o-clicksign
- "prioridade_intermediario": Contém um array definindo quem terá prioridade de assinar como parte em nome dos intermediários do processo - podendo conter os valores corretor, gerente e equipe; o serviço iterará os intermediários na ordem especificada até encontrar um com faturamento válido para assinar
- "prioridade_intermediario_equipe_interno": Segue a mesma lógica e aplicação de "prioridade_intermediario", entretanto este parâmetro somente será usado para equipes com contratação "Interno".
- "prioridade_intermediario_prestadores": Segue a mesma lógica e aplicação de "prioridade_intermediario", entretanto este parâmetro somente será usado para equipes com contratação "Prestador".
- "enviar_apenas_com_comissao_no_fluxo": Contém um array definindo qual tipo de intermediário - corretor, gerente e equipe - que assinará apenas com comissão no fluxo.
- "solicitar_foto_documento": Contém um vetor de strings definindo para quais papéis será solicitada foto do documento no processo de assinatura eletrônica; os valores válidos são:
- "vendedor": Solicita a todos signatários definidos no parâmetro "assina_manual_empresa".
- "parte": Solicita aos Intermediários
- "permutante": Solicita aos proprietários do imóvel
- "avalista": Solicita aos avalistas do processo
- "comprador": Solicita aos proponentes