# Regra para converter documento

## Visão geral

Essa regra faz parte das que rodam em background, conforme comentamos nessa [página](/zeevdocs/criar-bibliotecas/o-que-sao-regras-de-negocio.md), ou seja, sua configuração não reflete a interface de algum módulo, por isso é chamada "regra do tipo **Serviço"**.

Ela é responsável por efetuar a conversão dos documentos para os formatos **PDF** ou **TIFF**, substituindo ou gerando uma nova versão do arquivo original.

{% hint style="info" %}
**Dicas:**

1. Não é possível efetuar a conversão de arquivos protegidos com senha;
2. Pode ocorrer erro ao efetuar a conversão de arquivos PDF com fontes de uso não convencional, assim como quando a mesma possui sombreamento ou quando o arquivo possui imagens com transparência.
   {% endhint %}

### Como configurar a regra de conversão

Essa regra possui as seguintes opções de configuração:

* Tipo de conversão: para PDF ou TIFF;
* Resultado da conversão: 
  * Substituir arquivos originais;
  * Adicionar arquivos na última posição;
  * Adicionar arquivos na primeira posição;
  * Adicionar nova versão dos arquivos.
* Habilitar assinatura digital após a conversão;
* Ignorar conversão e realizar apenas a assinatura dos arquivos PDF.

![Configurações da regra de conversão](/files/OVndfQIe4Sat7cdb1v50)

{% hint style="danger" %}
**Atenção:** antes de ativar essa regra é **altamente recomendável** configurar corretamente as informações sobre Processamento, Sucesso e Exceção, determinando assim para qual etapa, situação e pendência o documento será encaminhado de acordo com o resultado do processamento. Isso impedirá que o documento seja processado em looping, causando lentidão no servidor ou outros erros como a criação de arquivos corrompidos.
{% endhint %}

![Configuração de processamento, sucesso e exceção da regra](/files/aqChFyIFGdvJoeYEqkaJ)

#### Conversão de documentos para PDF com assinatura de arquivos

É possível efetuar, automaticamente, a conversão de documentos para o formato PDF assinados com um certificado pré-definido A1, compatível com o ICP-Brasil.

Isso confirma que todos os arquivos que passaram pela etapa de conversão não foram alterados por outros usuários, atestando a sua autenticidade por meio da assinatura.

O Zeev docs utiliza o padrão internacional *PAdES* (*PDF Advanced Electronic Signature*) no seu processo de assinatura digital. Este é um dos padrões de assinatura aceitos pelo ICP-Brasil e, geralmente, é utilizado exclusivamente para a assinatura de documentos em formato PDF, visto que utiliza o padrão "PDF ISO 32000-1", onde as assinaturas realizadas no documento podem ser interpretadas e visualizadas por qualquer visualizador de PDF.

{% hint style="info" %}
**Dica:** para que as assinaturas sejam validadas corretamente também é necessário efetuar a instalação dos certificados raiz ICP-Brasil no servidor. Consulte o suporte da Zeev para realizar o procedimento.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.stoque.com.br/zeevdocs/criar-bibliotecas/o-que-sao-regras-de-negocio/regra-para-converter-documento.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.