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.

PontoOCPPOCPI
O que ligaO carregador ao sistema central da própria rede (CSMS).Uma plataforma a outra: rede a app, rede a hub, rede a mapa.
ExemploO 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 implementaO fabricante do carregador e o sistema de gestão da rede.A plataforma de gestão (backend) de cada empresa.
FormatoMensagens JSON por WebSocket (1.6J e 2.x).API REST com JSON sobre HTTPS.
Quem mantémOpen 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.

PapelO que faz
CPOCharge Point Operator (operador)Opera a rede de eletropostos: é dono dos dados de local, carregador, preço e recarga.
eMSPe-Mobility Service ProviderDá ao motorista o acesso à recarga: o app, o cartão ou a tag que libera o carregador e a cobrança.
HubHub de roamingLiga 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 ProviderMostra os eletropostos ao motorista, em mapa ou navegação. Em geral só lê Locations (e Tariffs). É o papel da Recarregados.
NAPNational Access PointBase nacional com todos os locais públicos de recarga, que recebe e fornece os dados.
SCSPSmart Charging Service ProviderCalcula 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óduloPara que serveQuem manda → quem recebe
Versionsdesde a 2.0Lista as versões que a plataforma fala e os endereços de cada módulo.Todos
Credentialsdesde a 2.0Registro entre duas plataformas e troca dos tokens de acesso.Todos
Locationsdesde a 2.0Locais, carregadores (EVSE), conectores, potência, horário e status de cada carregador.CPO → eMSP, NSP, NAP
Tariffsdesde a 2.0Preços: por kWh, por tempo, por recarga, por tempo parado.CPO → eMSP, NSP, NAP
Tokensdesde a 2.0Cartões, tags e contas de app que podem liberar a recarga.eMSP → CPO
Sessionsdesde a 2.0A recarga em andamento: energia, tempo e custo até agora.CPO → eMSP
CDRsdesde a 2.0O registro final da recarga (Charge Detail Record), usado na cobrança entre as empresas.CPO → eMSP
Commandsdesde a 2.1Ordens remotas: iniciar e parar recarga, reservar, destravar o conector.eMSP → CPO
Charging Profilesdesde a 2.2Limites de potência ao longo do tempo (recarga inteligente).SCSP → CPO
Hub Client Infodesde a 2.2O 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ãoDataO que mudou
2.0dezembro de 2015Primeira versão pública: Locations, Tariffs, Tokens, Sessions e CDRs entre o operador (CPO) e o app do motorista (eMSP), ponto a ponto.
2.1abril de 2016Módulo Commands (iniciar e parar recarga, reservar, destravar conector) e autorização em tempo real.
2.1.1junho de 2017Correção de quatro erros da 2.1 e ajustes de texto.
2.2setembro de 2019Hubs 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.1outubro de 2021Ajustes 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.0fevereiro de 2025Protocolo 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:

  1. 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.
  2. 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).
  3. 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.
  4. Quem recebeu guarda o Token B, lê as versões da outra parte com ele e responde ao POST com o Token C.
  5. 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:

  1. 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).
  2. 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.
  3. publish: true só para locais abertos ao público; garagem particular com parking_type ON_DRIVEWAY.
  4. Carregador desativado com status REMOVED, em vez de sumir sem aviso; carregador ainda não instalado com PLANNED.
  5. 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.
  6. operator.name com o nome da rede como o motorista conhece.
  7. opening_times com twentyfourseven ou o horário de cada dia.
  8. 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.
  9. 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.
  10. 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

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.