# Aba Histórico de Assinaturas Digitais

## Introdução
O formulário de **Histórico de Assinaturas Digitais** é uma ferramenta essencial para o gerenciamento e visualização das assinaturas digitais no Sistema. Este histórico é um registro cronológico que documenta todas as gerações de links de assinaturas eletrônicas realizadas, quando associado ao contrato do cliente, busca trazer de forma detalhada o histórico individual dos links gerados para o contrato selecionado. Este recurso permite rastrear e verificar a andamento (status) e integridade dos links de assinatura, conforme são gerados.

> [!NOTA] **Acesso ao Formulário:**
> **Caminho:** Sistema > Cadastros > Contratos > Editar > aba Histórico de Assinaturas Digitais

### Requisitos de Uso
Para utilizar esta ferramenta, é necessário atender as seguintes condições:
 - Possuir uma integração com uma plataforma de assinatura digital compatível com o sistema.

>[!example] Plataformas compatíveis:
>- [[ixc assina|IXC Assina]]

## Entrega de Valor
- Fornece uma visão detalhada e cronológica de todos os links de assinaturas digitais realizadas dentro do sistema;
- Atende requisitos regulatórios sobre registros de transações eletrônicas;
- Mantém um registro imutável das assinaturas realizadas, promovendo maior segurança às partes envolvidas;
- Simplifica o processo de assinatura de contrato e mantém um histórico detalhado dos processos.

## Estrutura do Formulário
O formulário está relacionado ao [[formulario contrato do cliente|Contrato do Cliente]], a partir da aba Histórico de Assinatura digital. É estruturado através de uma grid, organizada em linhas e colunas, reunindo todos os registros de links de assinatura digital gerados para o contrato, permitindo a visualização individual de cada item na sequência.

### Grid de Histórico de Assinaturas Digitais
A grid de Histórico de Assinaturas digitais é composta por cinco colunas, dispostas na sequência representada na tabela abaixo:

| Campo             | Descrição                                                                                                                                      |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| ID                | Identificador único da assinatura digital                                                                                                      |
| Data/hora         | Momento em que o link de assinatura foi gerado                                                                                                 |
| Status            | Descrição do andamento de assinatura do link. Apresenta se **Assinado**, se **Pendente de assinatura** ou se **Substituído**                   |
| Origem geração    | Indica a origem de geração do link de assinatura, podendo ter a origem em **Contrato** ou por **Ordem de serviço**                             |
| Tipo do documento | Informa o tipo de documento do qual houve a geração do link com o arquivo, para então ser assinado. Os tipos incluem **Contrato** ou **Termo** |
### Visualização individual do registro
Na grid, é possível selecionar um dos registros dispostos na tabela e visualizar suas informações individuais, separadas em duas abas: a aba Histórico assinatura digital e a aba Informações adicionais.

### Aba Histórico assinatura digital
A aba Histórico assinatura digital reúne as principais informações referente à geração do link de assinatura digital para o contrato, dispostas nos campos conforme representados a seguir:

| Nome do Campo           | Descrição                                                                                 |
| ----------------------- | ----------------------------------------------------------------------------------------- |
| ID                      | Identificação única do registro, gerado automaticamente pelo sistema                      |
| Data/hora               | Data e hora do registro da geração do link de assinatura                                  |
| Descrição               | Descrição do registro (Assinatura digital de documento)                                   |
| Forma origem de geração | Origem da geração do documento (Contrato ou Ordem de serviço)                             |
| Tipo do documento       | Tipo de documento (Contrato ou Termo)                                                     |
| Token do documento      | Token associado ao documento                                                              |
| ID contrato             | Identificação do contrato relacionado                                                     |
| ID da ordem de serviço  | Identificação da ordem de serviço                                                         |
| ID da integração        | Identificação do sistema de integração                                                    |
| ID do usuário           | Identificação do usuário que realizou ação                                                |
| ID do termo             | Identificação do termo                                                                    |
| Data assinatura         | Data da assinatura do documento quando for assinado                                       |
| Status                  | Estado atual da assinatura do documento (Pendente de assinatura, Substituído ou assinado) |

### Aba [[aba signatarios assinatura digital (informacoes adicionais) - historico de assinaturas digitais|Informações Adicionais]]
A aba de **Informações Adicionais** disponibiliza informações acerca de todos os signatários do documento gerado, o e-mail em que foi enviado o link de assinatura, o CPF, e o status de cada assinatura. Nesta aba está relacionado o formulário de [[aba signatarios assinatura digital (informacoes adicionais) - historico de assinaturas digitais|Aba Signatários Assinatura Digital (Informações adicionais) - Histórico de Assinaturas Digitais]], apresentando uma grid com as colunas dispostas da seguinte forma:

| Nome do Campo                 | Descrição                                 |
|-------------------------------|-------------------------------------------|
| ID                            | Identificação única do registro           |
| Responsável assinatura        | Papel do responsável pela assinatura      |
| Nome                          | Nome do responsável pela assinatura       |
| E-mail                        | Endereço de e-mail do responsável         |
| CPF/CNPJ                      | CPF ou CNPJ do responsável                |
| Status assinatura             | Estado da assinatura (se está assinado)   |

A partir da grid de [[aba signatarios assinatura digital (informacoes adicionais) - historico de assinaturas digitais|Aba Signatários Assinatura Digital (Informações adicionais) - Histórico de Assinaturas Digitais]], é possível visualizar um registro de assinatura individualmente, selecionando o e clicando no botão **Visualizar**. Após visualizar, serão apresentadas descrições detalhadas sobre a assinatura do signatário, como as descritas a seguir:

| Campo                           | Função                                                                                                                                                                                                             |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ID                              | Identificador único da assinatura,usado para referência interna.                                                                                                                                                   |
| Nome                            | Nome do signatário que irá realizar a assinatura digital.<br>- Razão social/Nome do cliente;<br>- Responsável provedor definido no cadastro da integração;<br>-  Testemunha provedor;<br>- Testemunha cliente.<br> |
| E-mail                          | Endereço de e-mail do signatário, utilizado para envio de notificações e acesso à assinatura.                                                                                                                      |
| CPF/CNPJ                        | Documento de identificação do signatário (CPF ou CNPJ).                                                                                                                                                            |
| Status assinatura               | Estado atual da assinatura, indicando se está "Pendente" ou "Assinado".                                                                                                                                            |
| Token                           | Código gerado para verificar a integridade e validade da assinatura digital.                                                                                                                                       |
| URL assinatura                  | Link para acessar a interface de verificação da assinatura, direciona ao serviço de e-signature.                                                                                                                   |
| ID histórico assinatura digital | Identificador do histórico de ações relacionadas à assinatura digital, usado para rastreamento e auditoria.                                                                                                        |
| ID externo                      | Identificador externo fornecido por sistemas de terceiros para integração e referência cruzada.                                                                                                                    |
| Tipo signatário                 | Categoria do signatário, indicando se é "Responsável provedor", "Responsável cliente", "Testemunha provedor" ou "Testemunha cliente".                                                                              |
Esses campos são utilizados para gerenciar e acompanhar o processo de assinatura digital, assegurando a validade e a conformidade da documentação assinada.

## Funcionalidades principais

- [[sincronizar assinatura - integracoes de assinatura digital|Sincronização de Assinatura]]: Permite atualizar o histórico com as informações mais recentes da base de dados, através do botão **Sincronizar assinatura**. O sistema verifica na plataforma como consta o status da assinatura e atualiza no IXC.

## Fluxo de Trabalho

```mermaid
graph TD
    A[Início] --> B[Integração do IXC Provedor com a plataforma de Assinatura Digital]
    B --> C[Cadastro de contrato e obtenção de dados do signatário]
    C --> D[Envio dos dados ao serviço de Assinatura Digital]
    D --> E[Recebimento da URL de assinatura]
	E --> F[Signatário assina documento]
    F --> G[Atualização do status de assinatura e ativação de contrato]
    G --> H[Armazenamento do histórico de assinatura digital]
    H --> I[Fim]
```

### Fluxo de Sincronização de Assinaturas
Para atualizar o status de uma assinatura manualmente, é possível acessar o registro da assinatura de determinado cliente no histórico e atualizar os dados a partir do botão "[[sincronizar assinatura - integracoes de assinatura digital|Sincronizar assinatura]]", como indica o fluxo abaixo:

```mermaid
graph TD
    A[Início] --> B[Acessar Formulário]
    B --> C[Clicar em 'Sincronizar']
    C --> D{Há novas assinaturas?}
    D -- Sim --> E[Atualizar Histórico]
    D -- Não --> F[Exibir Mensagem]
    E --> G[Fim]
    F --> G
```

## Considerações Finais
O formulário de **Histórico de Assinaturas Digitais** é um recurso fundamental para garantir transparência, rastreabilidade e segurança no gerenciamento de assinaturas eletrônicas no sistema. Ao documentar cronologicamente a geração e o status dos links de assinatura, ele permite um controle detalhado e confiável das operações, facilitando a verificação da integridade e do andamento de cada processo. Essa funcionalidade não apenas fortalece a confiança nas transações digitais, mas também contribui para a eficiência e conformidade dos processos, sendo indispensável para uma gestão moderna e segura.

## Etiquetas
#Integracoes #Integracao #IntegracoesDeAssinaturaDigital #AssinaturaDigital #IXCAssina

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de assinatura digital|Integrações de Assinatura Digital]]
- [[ixc assina|IXC Assina]]
- [[aba signatarios assinatura digital (informacoes adicionais) - historico de assinaturas digitais|Aba Signatários Assinatura Digital (Informações adicionais) - Histórico de Assinaturas Digitais]]
- [[sincronizar assinatura - integracoes de assinatura digital|Sincronizar Assinatura (Integrações de Assinatura Digital)]]