> For the complete documentation index, see [llms.txt](https://ajuda.rnp.br/diplomas-digitais/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.rnp.br/diplomas-digitais/passo-a-passo/conector-local-1/estrategias-de-retry.md).

# Estratégias de Retry

Pode ser necessário executar novamente um conjunto de passos para um determinado documento, por necessidade ou por ocorrência de uma situação de erro. 

Para tanto, o controle do fluxo pode ser feito via API de comunicação. Basicamente, os cenários em que pode ser necessário aplicar uma estratégia de retry são:

**Reiniciar completamente o processamento do arquivo** \
       a. Esse procedimento atualiza todo o contexto de processamento do documento, inclusive os responsáveis pela assinatura, caso uma nova configuração de responsáveis tenha sido criada para o grupo de documentos; 

**Reiniciar o processo de geração** \
       b. O documento retorna ao estado de início do processo de geração; 

**Reiniciar o processo de coleta de assinaturas** \
       c. O documento retorna ao estado de pronto para coleta de assinaturas; 

**Reiniciar o processo de finalização das assinaturas** (OBS: o reinício a partir daqui não exige a coleta novamente das assinaturas ) \
       d. A montagem do documento final é refeita 

**Reiniciar o processo de registro no serviço de preservação** \
       e. Deve ser usado nos casos em que houve falha no registro. Geralmente devido a entrada em algum código de erro no processo de registro; 

**Suspender um documento já processado e válido** \
       f. Suspende temporariamente um documento. O motivo deve ser informado; 

**Reativar um documento suspenso** \
       g. Reativa um documento suspenso. O motivo deve ser informado; 

**Iniciar o processo de revogação de um documento** \
      **h. Processo irreversível. No tocante ao Diploma Digital, para emissão de um novo diploma para a mesma pessoa, todo o processo de emissão deverá ser reiniciado com um novo id de documento e no que couber, nova documentação acadêmica.**

**OBSERVAÇÃO 1:** Como os documentos referentes a emissão do Diploma Digital dependem um do outro recomenda-se utilizar as funções de *retry* sempre em um documento base e em todos os documentos que dependem dele. Por exemplo, caso se deseje reiniciar o processo de emissão do XML da Documentação Acadêmica, deve-se também, após seu processamento, reiniciar o processo de emissão do Diploma Digital e, por conseguinte, o processo de conversão da representação visual para o formato PDF/A. 

\
**OBSERVAÇÃO 2:** Recomenda-se não utilizar as rotinas de retry com documentos que já se encontram com status válido, suspenso ou revogado (10,11 e 13, respectivamente). 

\
**OBSERVAÇÃO 3:** Nos casos que se deseje registrar novamente documento já válido, deve-se revogá-lo e iniciar um novo processo.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.rnp.br/diplomas-digitais/passo-a-passo/conector-local-1/estrategias-de-retry.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.