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, 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 que não especifiquem sua própria opção):

Em .NET:

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:

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

Integração direta por API:

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.