---
title: "Marcas de validação em PDF - Rest PKI Core"
description: "Como o Rest PKI Core adiciona marcas de validação a um PDF antes da primeira assinatura, o arquivo marcado (markedFile) e a política de marcação do PDF (Never, WhenPossible, Always)."
canonical: "https://docs.lacunasoftware.com/articles/rest-pki/core/integration/pdf-marking"
locale: "pt-BR"
product: "Rest PKI Core"
last_updated: "2026-10-20"
---

# Marcas de validação em PDF - Rest PKI Core

Antes da **primeira assinatura** de um PDF, o [Rest PKI Core](https://docs.lacunasoftware.com/articles/rest-pki/core) pode gerar uma cópia dele com **marcas de validação**: elementos
visuais, como o link para verificar o documento, que ajudam quem lê o PDF a conferir a assinatura. A aparência das marcas vem das opções de
marcação da organização (*subscription*). Essa cópia é o **arquivo marcado**, e é ela que recebe a assinatura quando o PDF é marcado.

O arquivo marcado aparece como `markedFile` no resumo do documento (`GET api/documents/{id}`) e nas [notificações por webhook](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/webhooks).
Ele só existe quando o arquivo original é um PDF e foi marcado; caso contrário, é nulo. Aplicações que fazem assinaturas CMS de PDFs podem entregar
o arquivo marcado ao usuário no lugar do arquivo `.p7s`: ele é um PDF que qualquer pessoa consegue abrir. Em assinaturas CMS destacadas (*detached*),
o arquivo marcado é o arquivo de dados que corresponde ao `.p7s`.

Uma cossignatura de um documento que já foi assinado no sistema nunca recebe marcas. A marcação só se aplica às assinaturas feitas por `api/signature` (duas etapas) e por sessões de assinatura; as APIs compatíveis com o Rest PKI legado não marcam o PDF.

## Política de marcação

A **política de marcação do PDF** decide se o PDF é marcado antes de ser assinado e o que acontece quando as marcas não podem ser adicionadas.
Adicionar marcas a um PDF que já tem assinaturas as invalidaria, e é aí que as políticas se diferenciam:

| Valor | No dashboard | Comportamento |
| --- | --- | --- |
| `Never` | Nunca | Nenhuma marca é adicionada: o PDF original é assinado. |
| `WhenPossible` (padrão) | Quando possível | O Rest PKI Core tenta adicionar as marcas. Se o PDF enviado já tem assinaturas (por exemplo, foi assinado fora do sistema), o arquivo marcado é descartado sem aviso e o PDF original é assinado. |
| `Always` | Sempre | As marcas são obrigatórias. Se o PDF enviado já tem assinaturas, a [assinatura em duas etapas](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/two-step-signatures) falha com o código `PdfAlreadySigned` e, na [sessão de assinatura](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions), o signatário vê o erro de arquivo já assinado. |

## Configuração

A política é definida por organização, na opção **Política de marcação do PDF** do dashboard. A opção **Usar padrão do sistema** deixa a organização
sem política própria, e vale então a configuração `Pdf:MarkingPolicy` da instância, cujo padrão é `WhenPossible`. Veja
[Configurações de PDF](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/settings/pdf). A política não é escolhida por requisição.

Não confunda com as marcas personalizadas de uma assinatura PAdES (`PdfSignatureOptions.Marks`) nem com as marcas de `api/pdf/AddMarks`: são
outros recursos, descritos em [Carimbos em PDF](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/pdf-stamp#carimbos-e-marcas-em-pdf).