> For the complete documentation index, see [llms.txt](https://docs.enapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enapi.com/enapi-documentation-pt/compensacao-de-cdr/referencia-das-regras-de-validacao.md).

# Referência das regras de validação

Todas as regras, o que verificam e valores típicos.

<figure><img src="https://4024764934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheBP0sH0U1Rrp1jIot9S%2Fuploads%2FnUJBqmceiaHTsdGoIMag%2FScreenshot%202026-05-04%20at%2009.45.42%20(1).png?alt=media&amp;token=0fd9d797-7b1b-4963-bbb2-d374bae00167" alt="" width="563"><figcaption><p>Definição da regra de validação de liquidação de CDR.</p></figcaption></figure>

### Validação de Energia

Falha se o total de kWh estiver fora do intervalo especificado.

* **Limites típicos:** 0,1 kWh (mín) a 200–300 kWh (máx).
* **Quando ajustar:** aumente o limite superior para HPC ou carregamento de camiões. Baixe o mínimo apenas se quiser detetar sessões perto de zero como CDRs.

### Validação de Custo

Falha se o custo total estiver fora do intervalo especificado.

Útil como uma verificação geral de bom senso — deteta CDRs que são gratuitos quando não deveriam ser, ou múltiplos do custo esperado.

### Validação de Duração

Falha se a duração da sessão estiver fora do intervalo especificado.

* **Limites típicos:** 60 segundos (mín) a 86 400 segundos / 24 horas (máx).
* **Quando ajustar:** aperte o máximo se a sua rede tiver um tempo limite automático da estação inferior a 24 h.

### Validação de Timestamp

Falha nos problemas comuns de timestamp:

* Hora de início após a hora de fim.
* Timestamps no futuro.
* CDRs entregues muito depois de a sessão ter terminado.

### CDR duplicado

Falha se a ENAPI receber mais do que um CDR do CPO para o que parece ser a mesma sessão de carregamento. Uma sessão é tratada como duplicada quando todos estes correspondem:

* IDs de localização e de EVSE
* UID do token
* Energia entregue
* Horas de início e fim, dentro de uma janela de 5 minutos

Não é necessária configuração, os critérios de correspondência são fixos.

### CDRs em falta

Assinala sessões concluídas que nunca geraram um CDR dentro de um período de tolerância.

* **Período de tolerância típico:** 6 a 24 horas (21 600–86 400 segundos).
* **Porque é importante:** os CDRs em falta são fuga silenciosa de receita — sem esta regra, nada os assinala.

### Consistência do Custo da Tarifa

Falha se o custo reportado do CDR diferir do custo calculado independentemente pela ENAPI em mais de 2%.

A nossa regra mais valiosa. Deteta bugs no motor de preços, aplicação incorreta da tarifa e erros de introdução manual. A ENAPI calcula o custo esperado a partir da tarifa ativa e dos dados da sessão, e depois compara.

### Validação da Velocidade de Carregamento

Falha se a energia entregue exceder o que o carregador poderia fisicamente entregar durante a duração da sessão. Tolerância de 5% incorporada para absorver ruído do contador.

Deteta falhas do contador e corrupção de dados — quando um carregador de 50 kW reporta 500 kWh numa sessão de 20 minutos, é isto que o assinala.

### Validação do Token

Falha se o token usado para iniciar a sessão não era válido nessa altura, ou se o eMSP recusou a autorização mas a sessão aconteceu na mesma.


---

# 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://docs.enapi.com/enapi-documentation-pt/compensacao-de-cdr/referencia-das-regras-de-validacao.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.
