> 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.