> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/trilha-de-auditoria.md).

# Trilha de Auditoria

Requisitos da página de auditoria que torna válida a assinatura coletada por você (estratégia `ORIGINATOR_MANAGED`) no Termo de Autorização em PDF e na CCB, inclusive quando a assinatura é feita no seu próprio sistema, sem provedor terceiro.

{% hint style="info" %}
No **termo em trilha opt-in** (sem PDF), o lastro é a trilha enviada pela API — ver [Trilha de auditoria — termo em trilha opt-in](#trilha-de-auditoria-termo-em-trilha-opt-in).
{% endhint %}

***

## Estrutura da Página de Auditoria

### Informações do Documento

| Campo                    | Descrição                                   | Exemplo                     |
| ------------------------ | ------------------------------------------- | --------------------------- |
| Nome do arquivo assinado | Nome completo do arquivo PDF assinado       | `CCB_0012345678_signed.pdf` |
| ID do arquivo            | Identificador único do documento no sistema | `DOC-2026-0012345678`       |

### Assinaturas

| Campo                | Descrição                            | Exemplo                                     |
| -------------------- | ------------------------------------ | ------------------------------------------- |
| Nome do Signatário   | Nome completo do tomador que assinou | `JOÃO SILVA SANTOS`                         |
| Método de assinatura | Tecnologia ou processo utilizado     | `Certificado Digital A1 + Biometria Facial` |

### Hashes do Documento

| Campo       | Descrição                                   |
| ----------- | ------------------------------------------- |
| Hash MD5    | Hash MD5 do documento original assinado     |
| Hash SHA256 | Hash SHA-256 do documento original assinado |

### Informações da Empresa

| Campo              | Descrição                                  |
| ------------------ | ------------------------------------------ |
| Nome da empresa    | Empresa que realizou a trilha de auditoria |
| CNPJ               | Cadastro Nacional de Pessoa Jurídica       |
| Sistema/Plataforma | Nome do sistema que gerou a trilha         |

***

## Histórico de Eventos

Cada evento deve conter as seguintes informações:

| Campo          | Descrição                                                | Obrigatório |
| -------------- | -------------------------------------------------------- | ----------- |
| Data e hora    | Momento exato em que o evento ocorreu (com fuso horário) | Sim         |
| Ação realizada | Descrição detalhada da ação executada                    | Sim         |
| Endereço IP    | IP de origem (se aplicável)                              | Condicional |
| Observações    | Informações complementares sobre o evento                | Não         |

### Eventos Obrigatórios

Ao menos **três eventos**, cada um com:

1. **Nome do tomador**
2. **Número da CCB**
3. **Ação praticada**
4. **Data e hora com respectivo fuso horário**

### Informações Complementares Obrigatórias

Ao menos **três** das informações abaixo devem aparecer nos eventos:

#### Autenticação e Dispositivo

| Informação                           | Descrição                                         |
| ------------------------------------ | ------------------------------------------------- |
| Número de endereço IP e porta lógica | IP e porta utilizados pelo Tomador                |
| Cadastro de login e senha            | Registro de autenticação do usuário               |
| IMEI                                 | Identificador do dispositivo móvel (se aplicável) |
| Geolocalização                       | Coordenadas geográficas do momento da assinatura  |

#### Tokens de Verificação

| Informação                | Descrição                                   |
| ------------------------- | ------------------------------------------- |
| Destino do Token (e-mail) | Endereço de e-mail onde o token foi enviado |
| Destino do Token (SMS)    | Número de telefone onde o token foi enviado |

#### Biometria e Documentos

| Informação                             | Descrição                                 |
| -------------------------------------- | ----------------------------------------- |
| Foto do tomador / Biometria Facial     | Imagem ou dados biométricos do signatário |
| Upload dos documentos de identificação | CNH, CPF ou RG enviados para validação    |
| Assinatura do cliente                  | Registro da assinatura propriamente dita  |

#### Aplicativos de Mensagem

| Informação                   | Descrição                                                             | Exemplo                                                   |
| ---------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------- |
| ID da mensagem enviada       | Identificador único da mensagem no aplicativo, com Data/Hora do envio | `wa.message_123456789 às 2026-03-12 14:32:15 (UTC-03:00)` |
| ID da confirmação de leitura | ID que comprova que a mensagem foi lida (quando disponível)           | `read_receipt_abc123`                                     |

Relevantes quando a assinatura é feita por chatbot ou aplicativo de mensagem.

#### Outros

| Informação | Descrição                       |
| ---------- | ------------------------------- |
| Outros     | Conforme avaliação da Giro.Tech |

***

## Exemplo Completo de Página de Auditoria

```
=================================================================
TRILHA DE AUDITORIA - CCB
=================================================================

INFORMAÇÕES DO DOCUMENTO
--------------------------
Nome do arquivo: CCB_00000001_signed.pdf
ID do documento: DOC-2025-0012345678
Número da CCB: 00000001

EMPRESA RESPONSÁVEL
-------------------
Nome: ORIGINADOR FINANCEIRO LTDA
CNPJ: 12.345.678/0001-90
Sistema: Plataforma de Assinatura Digital v2.1

ASSINATURAS
-----------
Signatário: Nome Completo (Parte)
E-mail: e-mail@exemplogiro.tech
Telefone: 41 999 888 777
CPF: 000.000.000-00
Assinou em: 21 de Janeiro de 2026 às 13:51:46 (UTC-03:00)

=================================================================
HISTÓRICO DE EVENTOS
=================================================================

Em todos os eventos: Nome do tomador: Nome Completo. Número da CCB: 00000001.

21/01/2026 10:27:53 (UTC-03:00)
Originador (12345678000190) solicitou as assinaturas do documento CCB.

21/01/2026 10:30:00 (UTC-03:00)
Originador criou o documento CCB e adicionou signatário para assinatura via WhatsApp. Conta: +55 11 99999-9999.

21/01/2026 10:30:01 (UTC-03:00)
Enviada mensagem de solicitação de assinatura via WhatsApp. ID da mensagem: wa.msg_abc123xyz789. Data/Hora do envio: 21/01/2026 10:30:01 (UTC-03:00). Número da conta: +55 11 99999-9999.

21/01/2026 10:30:15 (UTC-03:00)
Mensagem lida. ID da confirmação de leitura: read_receipt_def456uvw012.

21/01/2026 10:41:16 (UTC-03:00)
Assinatura iniciada - IP: 192.168.0.0 - Geolocalização: -23.6695,-49.2784.

21/01/2026 10:41:25 (UTC-03:00)
Dados da assinatura confirmados.

21/01/2026 10:41:30 (UTC-03:00)
Assinatura realizada como Parte - Token via WhatsApp (+55 11 99999-9999). ID da ação de aceite: click_accept_ghi789. IP: 192.168.0.0 - Geolocalização: -23.6695,-49.2784.

21/01/2026 10:51:25 (UTC-03:00)
Validação Biometria iniciada.

21/01/2026 10:51:26 (UTC-03:00)
Validação dos documentos iniciada.

21/01/2026 10:51:28 (UTC-03:00)
Validação Biometria concluída (Score 95).

21/01/2026 10:51:28 (UTC-03:00)
Validação dos documentos concluída.

21/01/2026 13:52:05 (UTC-03:00)
Processo de assinatura concluído para o documento CCB.

=================================================================
OBSERVAÇÕES
=================================================================

Hash do documento original (SHA256): d87deb2bbb43addfa587d34b2d078056d1641231d38b221390636254feeb13ac

Esse log pertence única e exclusivamente aos documentos de HASH acima.

Esse documento está assinado e certificado pela Giro.Tech, conforme MP 2.200-2/01, Art 10º, §2º.

=================================================================
FIM DA TRILHA DE AUDITORIA
=================================================================
```

***

## Checklist de Validação

Antes do upload:

* [ ] Página de auditoria anexada ao PDF da CCB assinada
* [ ] Nome do arquivo e ID do documento informados
* [ ] Nome do signatário e método de assinatura documentados
* [ ] Hash MD5 e SHA256 do documento calculados e registrados
* [ ] Informações da empresa que realizou a trilha incluídas
* [ ] Mínimo de **3 eventos** no histórico
* [ ] Cada evento contém: Nome Completo, número da CCB, ação, data/hora com fuso
* [ ] Mínimo de **3 informações complementares** presentes nos eventos
* [ ] Todas as datas/horas incluem o **fuso horário completo**
* [ ] Quando aplicável, IDs de mensagens de aplicativos de mensagem documentados

***

## Integração com API GTPayroll

Na estratégia `ORIGINATOR_MANAGED`, anexe a trilha ao PDF da CCB antes do upload:

```
1. GTPayroll gera PDF da CCB → webhook CONTRACT_DOCUMENT_READY
2. Originador baixa o PDF
3. Originador coleta assinatura externamente
4. Originador gera página de auditoria e anexa ao PDF
5. Originador faz upload via POST /contracts/{requestNumber}/upload-signed
```

{% hint style="warning" %}
A trilha é exigida para a validade legal da assinatura. Documento sem trilha adequada pode ser rejeitado na revisão de compliance.
{% endhint %}

***

## Observações Importantes

### Fuso Horário

Toda data/hora leva o fuso completo:

| Região            | Formato     |
| ----------------- | ----------- |
| Brasília (padrão) | `UTC-03:00` |
| Horário de verão  | `UTC-02:00` |
| GMT               | `UTC+00:00` |

### Integridade do Documento

* Hashes MD5 e SHA256 calculados sobre o arquivo final, **após a assinatura**
* Página de auditoria gerada no momento da assinatura
* **Não altere** a trilha depois de gerada

### Formatos Suportados

* **Anexa ao PDF** da CCB (página adicional no final), ou
* **Documento separado**, referenciado de forma inequívoca no documento principal

***

## Trilha de auditoria — termo em trilha opt-in

No [termo em trilha opt-in](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-trilha-opt-in.md) não há PDF: o lastro é a **trilha** enviada em `POST .../authorization-trails`, guardada pela Giro **como recebida e imutável**, amarrada ao **NSU** do documento de autorização. A trilha **não vai para a Dataprev**, que recebe só canal, data/hora, NSU e CPF.

### O que é guardado pela Giro

| Item                         | Observação                                                                          |
| ---------------------------- | ----------------------------------------------------------------------------------- |
| Snapshot do aceite           | `timestamp` (UTC), `ipAddress`, `sessionId`                                         |
| Identificação                | `name`, `documentNumber` (CPF, validado contra o employee)                          |
| Fingerprint do device        | `fingerprintId`, geolocalização (`lat`/`lng`), `device`, `browser`/`browserVersion` |
| Timeline opcional `events[]` | Quando enviada, guardada **literal** (texto livre), amarrada ao mesmo NSU           |
| Vínculo                      | NSU do documento de autorização (canal `Web Correspondente`)                        |

O **snapshot** (timestamp/IP/sessão/fingerprint) já é o registro do aceite; `events[]` é **opcional**.

### Vocabulário recomendado de eventos de auditoria

`events[]` é **texto livre** (`occurredAt` + `description`, com `ipAddress`/`geo` opcionais), sem enum. A tabela é uma **recomendação** para padronizar as descrições, e vale para os dois caminhos: na página de auditoria do PDF e em `events[]` do opt-in.

| Evento sugerido            | Quando ocorre                                  | Dados úteis na descrição                |
| -------------------------- | ---------------------------------------------- | --------------------------------------- |
| Solicitação de autorização | Originador solicitou a autorização/assinatura  | —                                       |
| Termo/opt-in apresentado   | Termo apresentado ao tomador                   | —                                       |
| Mensagem enviada           | WhatsApp/SMS/e-mail enviado                    | canal, ID da mensagem, conta, data/hora |
| Mensagem lida              | Confirmação de leitura                         | ID do read-receipt                      |
| Token enviado              | Token de verificação enviado                   | destino (e-mail/telefone)               |
| Aceite iniciado            | Aceite/assinatura iniciado                     | IP, geolocalização                      |
| Dados confirmados          | Dados da assinatura confirmados                | —                                       |
| Aceite realizado           | Aceite efetivado (**evento mínimo do opt-in**) | IP, geo, ID de sessão, token            |
| Biometria validada         | Biometria facial validada                      | —                                       |
| Documentos validados       | Documentos de identificação validados          | —                                       |
| Processo concluído         | Processo de aceite concluído                   | —                                       |

Não confundir com o status de ciclo de vida da assinatura (`PENDING`/`IN_PROGRESS`/`COMPLETED`/...), que é outro eixo.

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
