---
title: "Conversão para PDF/A - Sessões de assinatura"
description: "Conversão automática de PDF para PDF/A antes da assinatura no Rest PKI Core, com ConvertToPdfA em PdfSignatureOptions, a partir da versão 4.2.0."
canonical: "https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions/pdf-a-conversion"
locale: "pt-BR"
product: "Rest PKI Core"
last_updated: "2026-07-22"
---

# Conversão para PDF/A - Sessões de assinatura

A partir da versão 4.2.0, o Rest PKI Core pode converter automaticamente um documento PDF para o formato **PDF/A** (padrão de
arquivamento de longo prazo) logo antes da assinatura. Para isso, especifique `ConvertToPdfA = true` em `PdfSignatureOptions`.

> **Aviso**
>
> Esta operação requer no mínimo a versão **4.2.2** da biblioteca cliente `Lacuna.RestPkiCore.Client`. Certifique-se de
> atualizar o pacote antes de utilizá-la.

> **Observação**
>
> Essa funcionalidade depende de um serviço de conversão para PDF/A previamente habilitado e configurado na sua instância do
> Rest PKI Core. Caso o serviço não esteja disponível, a chamada falhará com uma `ApiException` (código `PdfAConversionNotAvailable`)
> ao tentar realizar a conversão.

## Em sessões de assinatura

Ao criar uma [sessão de assinatura](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions), informe `PdfSignatureOptions.ConvertToPdfA = true` para converter para PDF/A todos
os documentos PDF assinados durante a sessão (tanto os enviados pelo usuário quanto os [pré-definidos](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions#predefined-documents)
que não especifiquem sua própria opção):

Em .NET:

```cs
var response = await restPkiService.CreateSignatureSessionAsync(new CreateSignatureSessionRequest() {
	...
	PdfSignatureOptions = new PdfSignatureOptions {
		ConvertToPdfA = true,
	},
});
return Redirect(response.RedirectUrl);
```

Também é possível especificar a opção individualmente em cada documento pré-definido, sobrepondo a opção definida no nível da
sessão:

```cs
var documents = new List<SignatureSessionDocumentToSign> {
	new SignatureSessionDocumentToSign {
		File = FileReference.FromFile(pdfPath),
		PdfSignatureOptions = new PdfSignatureOptions {
			ConvertToPdfA = true,
		},
	},
	...
};
```

Integração direta por API:

```plaintext
POST {endpoint}/api/signature-sessions
{
	...
	"pdfSignatureOptions": {
		"convertToPdfA": true
	}
}
```

## Na assinatura avulsa

A mesma opção está disponível em `PdfSignatureOptions` ao usar o fluxo de assinatura local (`PrepareSignatureAsync`), fora do
contexto de sessões de assinatura.
