---
title: "Renotarizações"
description: "Renotarização na API do Digiploma: renovação automática do carimbo de tempo de arquivamento (AD-RA) dos XMLs assinados, antes que ele expire."
canonical: "https://docs.lacunasoftware.com/articles/digiploma/api/restamps"
locale: "pt-BR"
product: "Digiploma"
last_updated: "2026-10-11"
---

# Renotarizações

As assinaturas de um diploma precisam continuar verificáveis muito depois de os certificados que as geraram expirarem. Por isso, cada
arquivo XML assinado traz um carimbo de tempo de arquivamento (política AD-RA da ICP-Brasil), que deixa de valer quando expira o
certificado da Autoridade de Carimbo do Tempo (ACT). Antes que isso aconteça, o Digiploma **renotariza** o arquivo: acrescenta um novo
carimbo de tempo de arquivamento, o que estende a preservação das assinaturas.

Isso acontece automaticamente com os arquivos XML assinados de:

* diplomas (o XML do diploma e o XML da documentação acadêmica);
* históricos escolares finais e segundas vias (os históricos parciais, não);
* currículos escolares;
* requisições de registro (o XML do diploma assinado pela registradora), somente quando a instância habilita isso.

Quando um documento é concluído, o Digiploma cadastra uma **renotarização** com a data de expiração do carimbo de tempo de arquivamento do
arquivo. Um job diário, à noite (por padrão, no horário de Brasília), renotariza os arquivos que expiram em menos de 180 dias (por padrão)
e cadastra uma nova renotarização para a nova data de expiração. Em uma instalação on-premises, esses padrões são
[configuráveis](https://docs.lacunasoftware.com/articles/digiploma/on-premises/settings#configurações-de-renotarização-e-carimbo-de-tempo). Uma renotarização que falha é tentada de novo nos dias seguintes. A renotarização vem ativada
por padrão; o administrador da instância pode desativá-la para uma organização. [Revalidação de diplomas](https://docs.lacunasoftware.com/articles/digiploma/revalidation) explica por
que ela é necessária, com um diagrama do ciclo.

## Listar renotarizações

`GET /api/restamps` retorna uma página das renotarizações da organização. Exige a permissão `ViewRestamp`.

| Parâmetro | Descrição |
|---|---|
| `DocumentTypes` | Tipos de documento; pode ser repetido: `Degree`, `AcademicDocumentation`, `Registration`, `AcademicTranscript`, `Curriculum`. |
| `Status` | `Restamped` (aplicada), `NonRestamped` (pendente) ou `WithError`. |
| `RestampFilterField` | A data a que se referem `StartDateUtc`, `EndDateUtc` e a ordenação: `ExpiringDate` (padrão), a expiração do carimbo de tempo de arquivamento, ou `RestampDate`, a data em que o arquivo foi renotarizado. |
| `StartDateUtc`, `EndDateUtc` | De `StartDateUtc` (inclusive) até `EndDateUtc` (exclusive). |
| `Q` | Texto a buscar no identificador. |

Também aceita os [parâmetros de paginação](https://docs.lacunasoftware.com/articles/digiploma/api#paginação).

| Campo | Descrição |
|---|---|
| `id` | A renotarização. |
| `documentType`, `documentId` | O documento. Para `Degree` e `AcademicDocumentation`, `documentId` é o id do diploma. |
| `identifier` | O CPF do aluno ou o código de um currículo. |
| `archivingExpiringDate` | Quando expira o carimbo de tempo de arquivamento atual. |
| `date` | Quando o arquivo foi renotarizado; `null` enquanto pendente. |
| `errorReason` | O erro, se não foi possível cadastrar a renotarização ou se ela falhou. |
| `creationDate`, `updateDate` | |

## Webhooks

`RestampCreated`, `RestampUpdated`, `RestampApplied` e `RestampApplyingError` informam o andamento de cada renotarização, mas vêm
desativados por padrão e só são enviados quando a instância os habilita. Veja [Webhooks](https://docs.lacunasoftware.com/articles/digiploma/api/webhooks).
