Guia para redes de recarga
OCPI: o que é, como funciona e como integrar a sua rede
OCPI (Open Charge Point Interface) é o protocolo aberto e gratuito que as plataformas de recarga de carro elétrico usam para trocar dados entre si: onde ficam os eletropostos e quais conectores têm, quanto custa carregar, quem pode carregar e quanto cada recarga custou. É mantido pela EVRoaming Foundation; a versão mais recente é a 2.3.0 (fevereiro de 2025), e as versões 2.2.1 e 2.1.1 continuam em uso.
OCPI x OCPP: qual a diferença?
Os dois nomes se parecem e os dois são abertos, mas trabalham em pontas diferentes. O OCPP fica dentro da rede: liga cada carregador ao sistema central. O OCPI fica entre empresas: liga a plataforma da rede ao app de outra empresa, a um hub de roaming ou a um mapa. Uma rede costuma usar os dois.
| Ponto | OCPP | OCPI |
|---|---|---|
| O que liga | O carregador ao sistema central da própria rede (CSMS). | Uma plataforma a outra: rede a app, rede a hub, rede a mapa. |
| Exemplo | O carregador avisa ao sistema que a recarga começou e quanta energia entregou. | O app de outra empresa mostra o seu ponto, libera a recarga e recebe o CDR para cobrar. |
| Quem implementa | O fabricante do carregador e o sistema de gestão da rede. | A plataforma de gestão (backend) de cada empresa. |
| Formato | Mensagens JSON por WebSocket (1.6J e 2.x). | API REST com JSON sobre HTTPS. |
| Quem mantém | Open Charge Alliance. | EVRoaming Foundation. |
Os papéis: CPO, eMSP, Hub, NSP, NAP e SCSP
O OCPI descreve quem faz o quê no mercado de recarga. Uma mesma empresa pode ter mais de um papel: muitas redes são, ao mesmo tempo, operadoras (CPO) e donas de um app (eMSP). Desde a versão 2.2, uma plataforma conecta uma vez e declara todos os papéis que atende.
| Papel | O que faz |
|---|---|
| CPOCharge Point Operator (operador) | Opera a rede de eletropostos: é dono dos dados de local, carregador, preço e recarga. |
| eMSPe-Mobility Service Provider | Dá ao motorista o acesso à recarga: o app, o cartão ou a tag que libera o carregador e a cobrança. |
| HubHub de roaming | Liga um ou mais CPOs a um ou mais eMSPs, para cada um ter uma conexão só em vez de uma por parceiro. |
| NSPNavigation Service Provider | Mostra os eletropostos ao motorista, em mapa ou navegação. Em geral só lê Locations (e Tariffs). É o papel da Recarregados. |
| NAPNational Access Point | Base nacional com todos os locais públicos de recarga, que recebe e fornece os dados. |
| SCSPSmart Charging Service Provider | Calcula perfis de recarga inteligente (quanta potência, quando) e os manda a outras partes. |
Os módulos do OCPI
Cada assunto é um módulo, com endereço próprio. Uma plataforma só implementa os módulos dos papéis que tem: um mapa lê Locations e Tariffs; um app de roaming usa também Tokens, Sessions, CDRs e Commands.
| Módulo | Para que serve | Quem manda → quem recebe |
|---|---|---|
| Versionsdesde a 2.0 | Lista as versões que a plataforma fala e os endereços de cada módulo. | Todos |
| Credentialsdesde a 2.0 | Registro entre duas plataformas e troca dos tokens de acesso. | Todos |
| Locationsdesde a 2.0 | Locais, carregadores (EVSE), conectores, potência, horário e status de cada carregador. | CPO → eMSP, NSP, NAP |
| Tariffsdesde a 2.0 | Preços: por kWh, por tempo, por recarga, por tempo parado. | CPO → eMSP, NSP, NAP |
| Tokensdesde a 2.0 | Cartões, tags e contas de app que podem liberar a recarga. | eMSP → CPO |
| Sessionsdesde a 2.0 | A recarga em andamento: energia, tempo e custo até agora. | CPO → eMSP |
| CDRsdesde a 2.0 | O registro final da recarga (Charge Detail Record), usado na cobrança entre as empresas. | CPO → eMSP |
| Commandsdesde a 2.1 | Ordens remotas: iniciar e parar recarga, reservar, destravar o conector. | eMSP → CPO |
| Charging Profilesdesde a 2.2 | Limites de potência ao longo do tempo (recarga inteligente). | SCSP → CPO |
| Hub Client Infodesde a 2.2 | O hub avisa quais plataformas estão ligadas a ele e se estão no ar. | Hub → demais |
As versões do OCPI
A versão mais recente é a 2.3.0, de fevereiro de 2025. Uma plataforma pode oferecer várias versões ao mesmo tempo no endereço de versions, e cada parceiro conecta pela mais nova que os dois falam. A próxima geração (OCPI 3) está em desenvolvimento entre os contribuintes da EVRoaming Foundation.
| Versão | Data | O que mudou |
|---|---|---|
| 2.0 | dezembro de 2015 | Primeira versão pública: Locations, Tariffs, Tokens, Sessions e CDRs entre o operador (CPO) e o app do motorista (eMSP), ponto a ponto. |
| 2.1 | abril de 2016 | Módulo Commands (iniciar e parar recarga, reservar, destravar conector) e autorização em tempo real. |
| 2.1.1 | junho de 2017 | Correção de quatro erros da 2.1 e ajustes de texto. |
| 2.2 | setembro de 2019 | Hubs de roaming com roteamento de mensagens, plataformas com vários papéis, novos papéis (Hub, NSP, NAP, SCSP), recarga inteligente (Charging Profiles) e token em base64 no cabeçalho. |
| 2.2.1 | outubro de 2021 | Ajustes da 2.2: country_code e party_id no token do CDR, novos tipos de conector e de corrente (AC bifásica), comando de início com conector escolhido. |
| 2.3.0 | fevereiro de 2025 | Protocolo extensível, vaga de estacionamento ligada ao carregador, eMSPs aceitos por carregador, telefone de suporte do local, informações de acessibilidade, impostos à moda norte-americana e sinais de Plug & Charge (ISO 15118). Módulos opcionais publicados à parte: Payments e Bookings. A 2.ª edição (junho de 2026) trouxe o módulo Invoice Reconciliation. |
Como duas plataformas se conectam: Token A, B e C
Tudo começa no endereço de versions de cada lado e no módulo credentials. Na versão 2.2.1, o registro segue estes passos:
- A plataforma que vai receber o registro cria o Token A e o entrega à outra por fora do protocolo (e-mail, painel), junto com o endereço de versions.
- A outra plataforma usa o Token A para ler versions e os detalhes da versão escolhida (a lista de módulos e endereços).
- Ela cria o Token B e manda as próprias credenciais (Token B, endereço de versions, papéis, country_code e party_id) num POST para credentials.
- Quem recebeu guarda o Token B, lê as versões da outra parte com ele e responde ao POST com o Token C.
- Dali em diante cada lado usa o token que recebeu: o Token C de um lado, o Token B do outro. O Token A é descartado. Trocar tokens é um PUT em credentials; encerrar, um DELETE.
Toda requisição leva Authorization: Token <token> (em base64 desde a 2.2; texto puro na 2.1.1). As respostas vêm num envelope com data, status_code (1000 = ok) e timestamp, e as listas longas são paginadas com offset, limit, o cabeçalho Link e X-Total-Count.
Conexão direta ou por hub de roaming
O OCPI nasceu ponto a ponto: duas plataformas se conectam direto, com um contrato entre elas. É o jeito mais simples quando a rede tem poucos parceiros. Com muitos parceiros, um hub de roaming concentra as conexões: a rede liga uma vez no hub e o hub repassa as mensagens. As versões até a 2.1.1 não foram pensadas para hubs; a 2.2 trouxe o roteamento de mensagens com os cabeçalhos OCPI-from-* e OCPI-to-*.
Para que uma rede brasileira usa OCPI
- Roaming. O motorista com o app de outra empresa carrega nos seus pontos, e as duas acertam a cobrança pelos CDRs. Usa Locations, Tariffs, Tokens, Sessions, CDRs e Commands.
- Aparecer em mapas e apps de navegação. Quem mostra eletropostos (o papel NSP) lê só Locations e Tariffs: o ponto aparece com conector, potência, preço e horário certos sem ninguém digitar nada.
- Um dado só, em todo lugar. Ponto novo, preço novo ou carregador desativado mudam na plataforma da rede e chegam sozinhos a todos os parceiros.
O primeiro passo é ter uma plataforma de gestão (CSMS) com o módulo OCPI: pergunte ao seu fornecedor quais versões e módulos ele oferece e como gerar um token ou um Token A para um parceiro.
Na Recarregados
Integre a sua rede ao mapa, grátis
A Recarregados é o NSP BR*RCR: lê Locations e Tariffs nas versões 2.3.0, 2.2.1, 2.2, 2.1.1, a cada 6 horas, e mostra conectores, potência, preço e horário oficiais no mapa, nas páginas de eletroposto e no planejador de viagem. A rede conecta sozinha pelo painel, com token de leitura ou registro OCPI, e vê uma leitura de teste antes de publicar. Não é exclusivo e não mexe em recargas.
Checklist dos dados antes de abrir o OCPI
Quem lê o OCPI mostra o que a plataforma manda. Estes pontos evitam pino no lugar errado, preço sumido e ponto duplicado em qualquer parceiro:
- Um id estável por local. Id novo é ponto novo para quem lê; não use número de série de hardware no uid do carregador (a especificação recomenda evitar).
- Coordenadas do ponto exato, em graus decimais, dentro da cidade escrita no endereço. Na Recarregados, um pino a mais de 10 km da cidade do endereço fica de fora.
- publish: true só para locais abertos ao público; garagem particular com parking_type ON_DRIVEWAY.
- Carregador desativado com status REMOVED, em vez de sumir sem aviso; carregador ainda não instalado com PLANNED.
- Cada conector com standard, power_type, max_voltage, max_amperage e max_electric_power: é daí que saem o tipo (CCS2, Tipo 2…) e a potência em kW.
- operator.name com o nome da rede como o motorista conhece.
- opening_times com twentyfourseven ou o horário de cada dia.
- capabilities com CREDIT_CARD_PAYABLE, DEBIT_CARD_PAYABLE ou CONTACTLESS_CARD_SUPPORT quando o carregador aceita cartão; sem eles, quem lê entende que a liberação é pelo app.
- Tarifas em BRL, com tariff_alt_text em português ("R$ 1,99/kWh + R$ 2,00 por recarga"); preço sem imposto acompanhado do vat. Na Recarregados, R$/kWh fora de R$ 0,30 a R$ 10,00 fica de fora.
- last_updated real em cada objeto, e paginação com limit, offset, cabeçalho Link (rel="next") e X-Total-Count.
O que cada campo vira no mapa da Recarregados está na tabela da documentação da integração.
Glossário do OCPI
- CDR
- Charge Detail Record: o registro final de uma recarga, com energia, tempo e custo, que o operador manda ao app do motorista para a cobrança.
- Connector
- A tomada ou o cabo de um carregador, com padrão (CCS2, Tipo 2, CHAdeMO…), tipo de corrente e potência.
- country_code e party_id
- Identificam cada empresa no OCPI: país (ISO 3166-1, duas letras) e um código de três caracteres. A Recarregados é BR*RCR.
- CPO
- Charge Point Operator: a empresa que opera os eletropostos e é dona dos dados de local, preço e recarga.
- CSMS
- Charging Station Management System: o sistema central da rede, que fala OCPP com os carregadores e, quando tem o módulo, OCPI com outras plataformas.
- eMSP
- e-Mobility Service Provider: a empresa que dá ao motorista o acesso à recarga (app, cartão, tag) e cobra dele.
- EVSE
- Electric Vehicle Supply Equipment: a parte do eletroposto que carrega um carro por vez. Um local tem um ou mais EVSEs; cada EVSE, um ou mais conectores.
- Hub de roaming
- Plataforma intermediária que liga vários operadores a vários apps: cada um faz uma conexão só, com o hub.
- Location
- O local de recarga no OCPI: endereço, coordenadas, horário, operador e a lista de EVSEs.
- NSP
- Navigation Service Provider: quem mostra os eletropostos em mapa ou navegação, lendo Locations e Tariffs.
- OCPP
- Open Charge Point Protocol: o protocolo entre o carregador e o sistema central da rede (não entre empresas).
- Roaming
- Carregar na rede de uma empresa usando o app ou o cartão de outra, com a cobrança acertada entre elas.
- Tariff
- A tarifa no OCPI: componentes de preço por energia (ENERGY), tempo (TIME), recarga (FLAT) e tempo parado (PARKING_TIME), com restrições opcionais.
- Token A, B e C
- Os tokens do registro entre duas plataformas: o A é entregue por fora e só serve para o registro; o B e o C são os definitivos de cada lado.
Perguntas frequentes
O que é OCPI?
OCPI (Open Charge Point Interface) é o protocolo aberto e gratuito que as plataformas de recarga de carro elétrico usam para trocar dados entre si: onde ficam os eletropostos e quais conectores têm, quanto custa carregar, quem pode carregar e quanto cada recarga custou. É mantido pela EVRoaming Foundation; a versão mais recente é a 2.3.0 (fevereiro de 2025), e as versões 2.2.1 e 2.1.1 continuam em uso.
Qual a diferença entre OCPI e OCPP?
O OCPP liga o carregador ao sistema central da própria rede: é por ele que o carregador avisa que a recarga começou. O OCPI liga uma plataforma a outra: é por ele que o app de outra empresa ou um mapa vê os pontos, os preços e as recargas da rede. Uma rede costuma usar os dois.
O OCPI é pago?
Não. A especificação é aberta, gratuita e publicada no GitHub pela EVRoaming Foundation. Quem quer participar do desenvolvimento da próxima versão (OCPI 3) pode se tornar contribuinte da fundação.
Qual versão do OCPI usar?
A mais nova é a 2.3.0, de fevereiro de 2025. Uma plataforma pode oferecer várias versões ao mesmo tempo na lista de versions, e cada parceiro conecta pela mais nova que os dois falam. A Recarregados lê as versões 2.3.0, 2.2.1, 2.2, 2.1.1.
O que são o Token A, o Token B e o Token C?
São os tokens do registro entre duas plataformas. O Token A é criado por quem vai receber o registro e entregue por fora do protocolo; a outra parte o usa uma vez para ler as versões e mandar as próprias credenciais com o Token B; quem recebeu responde com o Token C. Depois disso o Token A é descartado e cada lado usa o token que recebeu.
Preciso de um hub de roaming para usar OCPI?
Não. O OCPI nasceu ponto a ponto: duas plataformas se conectam direto. Um hub ajuda quando a rede quer muitos parceiros com uma conexão só, e desde a versão 2.2 o protocolo tem regras para isso.
O OCPI mostra se o carregador está livre?
Sim. O status de cada EVSE (AVAILABLE, CHARGING, OUTOFORDER…) faz parte do módulo Locations, e o operador pode mandar cada mudança na hora para quem recebe. A Recarregados ainda lê a cada 6 horas e não mostra esse status no mapa.
Como colocar os eletropostos da minha rede no mapa da Recarregados por OCPI?
Crie uma conta, preencha a rede no painel de integração e conecte a plataforma com um token de leitura ou pelo registro OCPI (Token A). O painel faz uma leitura de teste, a equipe confere em até 2 dias úteis e o mapa passa a se atualizar sozinho a cada 6 horas. É grátis, só leitura e não exclusivo.
Fontes
- Especificação OCPI (todas as versões), EVRoaming Foundation no GitHub
- EVRoaming Foundation
- OCPP, Open Charge Alliance
Datas, papéis, módulos e o registro por credentials foram conferidos no histórico de versões, na terminologia e no capítulo de credentials da especificação (2.2.1 e 2.3.0). Achou algo desatualizado? Avise a gente.