> 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/primeiros-passos/configure-o-seu-ocpi-handshake-com-a-enapi.md).

# Configure o seu OCPI Handshake com a ENAPI

## Configure o seu Handshake OCPI com a ENAPI

Um handshake OCPI é a configuração única que troca credenciais entre a sua plataforma e a ENAPI. Execute-o no portal em **Definições → Definições de Roaming → Novo Handshake** — um assistente guiado de 4 passos: **Método de handshake → Configurar ligação → Detalhes da ligação → Executar handshake**.

{% hint style="info" %}
Staging (`roaming.staging.enapi.com`) usa a mesma implementação OCPI que a produção (`roaming.enapi.com`) — se funcionar no staging, funciona em produção.
{% endhint %}

### Passo 1 — Método de handshake

Escolha quem faz a primeira chamada. Ambos produzem o mesmo par de credenciais.

* **A ENAPI inicia** — você fornece à ENAPI o seu URL de Versions e o Token A; a ENAPI inicia.
* **Você inicia** — a ENAPI fornece o seu URL de Versions e o Token A; a sua plataforma inicia.

### Passo 2 — Configurar ligação

Estas definições são as mesmas independentemente do método. Defina um **Rótulo** (opcional, para distinguir várias ligações) e escolha a **versão OCPI** (por exemplo, 2.2.1), depois responda às perguntas de comportamento abaixo.

{% hint style="info" %}
Estas definições são testadas no staging durante o onboarding — tudo o que precisar de ajuste é detetado aí.
{% endhint %}

#### Tokens codificados em Base64 (2.2.1+)

A OCPI 2.2.1 introduziu a codificação Base64 para o token no cabeçalho `Authorization` . O token no corpo das credenciais mantém-se inalterado em qualquer dos casos; apenas a representação no cabeçalho difere.

* **Desligado** — token em bruto no cabeçalho `Authorization` , em ambas as direções.
* **Ligado** — token codificado em Base64 no cabeçalho, em ambas as direções.

Combine com o que a sua plataforma faz.

#### Apenas DE\*ENA nos parâmetros de caminho do URL?

A ENAPI encaminha cada pedido sob a **party do remetente** . Se recebermos uma atualização de `ES*CPO`, por defeito o caminho é `locations/receiver/ES/CPO`.

* **Desligado** — o caminho usa a party do remetente original (`ES/CPO`). A maioria dos parceiros quer isto.
* **Ligado** — o caminho usa sempre a party da ENAPI (`DE/ENA`). Use apenas se a sua plataforma rejeitar caminhos que não correspondam à contraparte do handshake.

#### Topologia HUB (2.2.1+)

A ENAPI opera como um HUB, partilhando a função de HUB além de ambos os conjuntos de endpoints CPO e EMSP (SENDER + RECEIVER) durante a troca de credenciais. Escolha o que a sua plataforma aceita:

* **Suporte total** — aceita a função de HUB e vários endpoints por módulo. A ENAPI apresenta-se como `HUB`.
* **Suporte parcial** — aceita vários endpoints por módulo, mas não a função de HUB. A ENAPI envia `CPO` + `EMSP`.
* **Não suportado (EMSP)** — espera uma única contraparte CPO, um endpoint por módulo.
* **Não suportado (CPO)** — igual, espelhado: uma única contraparte EMSP, um endpoint por módulo.

#### A sua função — como a ENAPI sabe que tipo de party você é

O tipo de party na ENAPI é definido pela função que declarar no módulo Credentials durante o handshake. Não há nada separado para configurar: quaisquer funções que a sua plataforma enviar — CPO, EMSP, NSP, NAP, PTP — é como aparece na plataforma, o que as contrapartes veem no diretório de roaming e o que determina os módulos que troca.<br>

* **Declare todas as funções que opera**. A OCPI 2.2.1 e posterior permite que uma party envie várias funções numa única troca de credenciais. Se for simultaneamente CPO e eMSP, envie ambas e use uma única ligação.
* **A sua função vem das credenciais**, não de uma definição. Não há nada para alterar no Portal. Se declarou a função errada, ou se o seu negócio mudou, envie as funções corretas e atualize o handshake — as novas credenciais substituem o que a ENAPI tem registado.

⚠️ Verifique a função que a sua plataforma realmente envia.

* **Na OCPI 2.1.1 não há nada para verificar** — o objeto Credentials não tem array de roles, antecede o conceito. Qualquer party que não seja CPO e que se ligue na 2.1.1 é registada como eMSP.
* **Na 2.2.1 e posterior o array de roles existe, mas muitas plataformas preenchem-no com EMSP** independentemente do que operam. Recebemos regularmente credenciais de agregadores de dados e fornecedores de terminais de pagamento que se declaram eMSPs — muitas vezes porque a sua plataforma o fixa por defeito. Se for o seu caso, aparecerá como eMSP para todas as contrapartes até ser corrigido.
* **O que fazer:** se for um agregador de dados ou um PTP, ligue-se na 2.2.1 ou posterior e confirme que a sua plataforma envia realmente NSP / NAP ou PTP. Se já tiver enviado a função errada, envie a correta e atualize o handshake. Os PTPs devem preferir a 2.3.0, onde o módulo Payments está totalmente normalizado.

Veja [Funções e Partes no ENAPI](https://docs.enapi.com/enapi-documentation-pt/primeiros-passos/funcoes-e-partes-na-enapi.md) para saber o que cada função envia e recebe.

#### Cabeçalhos de routing OCPI-to-\*

Só relevante se alojar várias parties atrás de um único endpoint. Por exemplo, é um eMSP com várias parties sob um único handshake e precisa de que cada atualização EVSE seja enviada a cada party separadamente.

* **Desligado** — um pedido, sem cabeçalhos de routing; faz o routing internamente (a partir do caminho ou do token).
* **Ligado** — a ENAPI adiciona `OCPI-to-party-id` e `OCPI-to-country-code`, e distribui um pedido por cada party de destino.

### Passo 3 — Detalhes da ligação

Este passo depende do método escolhido no passo 1.

**A ENAPI inicia**: Forneça os detalhes de que a ENAPI precisa para o contactar:

* **URL de Versions** — onde a sua plataforma expõe as suas versões OCPI (por exemplo, `https://example.com/ocpi/versions`).
* **Token A (texto simples)** — um token que gera; a ENAPI usa-o uma vez para iniciar.

Clique em **Obter versões** para continuar.

**Você inicia**: Use os valores que a ENAPI mostra para iniciar do seu lado:

* **ID da ENAPI** — `DE*ENA`
* **Token A** (e **Token A codificado**, se a sua plataforma esperar Base64)
* **URL de Versions** — por exemplo, `https://roaming.staging.enapi.com/ocpi/versions`

Registe a ENAPI como contraparte no seu CPMS com estes valores e dispare o handshake (normalmente uma ação de "registar"/"ligar").

### Passo 4 — Executar handshake

A ENAPI conclui a troca de credenciais server-to-server: negocia a versão mutuamente suportada mais alta, obtém os endpoints dos módulos e troca o Token A pré-partilhado por uma credencial permanente. Quando termina, o handshake aparece como **Ativo** em Definições de Roaming.

### Próximos passos

* [O Portal da ENAPI](https://docs.enapi.com/enapi-documentation-pt/primeiros-passos/o-portal-enapi.md)
* [Testar a sua integração OCPI](https://docs.enapi.com/enapi-documentation-pt/primeiros-passos/testing-your-connection.md)
* [Roaming](https://docs.enapi.com/enapi-documentation-pt/roaming.md)


---

# 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://docs.enapi.com/enapi-documentation-pt/primeiros-passos/configure-o-seu-ocpi-handshake-com-a-enapi.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.
