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. 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 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.

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.