Para redes de recarga

Os eletropostos da sua rede no mapa, sempre atualizados

Conecte a plataforma OCPI da rede uma vez. Conectores, potência, preço e horário de todos os pontos passam a vir dela, no site, no app e no planejador de viagem da Recarregados.

  • Grátis
  • Só leitura
  • OCPI 2.3.0, 2.2.1, 2.2, 2.1.1
  • A cada 6 horas
  1. Crie a conta e preencha a redeRazão social, CNPJ, e-mail técnico e o aceite da autorização.
  2. Conecte a plataformaToken de leitura ou registro OCPI, do jeito que ela pede.
  3. Veja o testeQuantos locais entram, quais ficam de fora e por quê. Nada é gravado.
  4. Conferimos e publicamosEm até 2 dias úteis. Depois, o mapa se atualiza sozinho.

Pontos certos onde o motorista procura

Mapa, páginas de eletroposto, cidade, estado e rede, no site e no app. Ponto novo entra sozinho; ponto desativado sai na leitura seguinte.

Preço e potência oficiais no planejador

O planejador de viagem calcula o tempo e o custo de cada parada com a potência e o R$/kWh que a sua plataforma publica, em vez de uma estimativa.

Combina com o perfil oficial

Logo, fotos, comodidades e contato continuam no perfil oficial de cada ponto, grátis. O Destaque Pro é opcional e não muda a integração.

Para o time técnico

A Recarregados entra na sua plataforma como uma parte que só lê (papel NSP). Lemos os módulos Locations e Tariffs e mais nada. Novo no OCPI? O guia do OCPI em português explica papéis, módulos, versões e o registro com Token A, B e C.

Endereço de versões da Recarregados
https://recarregados.com/ocpi/versions
Party
BR*RCR (Recarregados), papel NSP
Versões
2.3.0, 2.2.1 e 2.1.1 nos dois sentidos; da sua plataforma lemos também a 2.2.
Módulos que lemos
locations (obrigatório, como SENDER) e tariffs (opcional)

Três jeitos de conectar

Escolha o que a sua plataforma suporta. Os três terminam no mesmo lugar.

Jeito 1

Token de leitura

A plataforma gera um token só para a Recarregados.

  1. Na sua plataforma, crie um acesso para a Recarregados com leitura de Locations e, se houver, Tariffs.
  2. No painel, escolha “Tenho um token de leitura” e cole a URL de versions e o token.

Jeito 2

Registro com o Token A da rede

O jeito padrão do OCPI entre duas plataformas.

  1. Na sua plataforma, gere um Token A para a Recarregados.
  2. No painel, escolha “Tenho um Token A para registro” e cole a URL de versions e o Token A.
  3. Nós buscamos as suas versões, enviamos as nossas credenciais (POST credentials) e guardamos o token definitivo que a sua plataforma devolve.

Jeito 3

Registro com o Token A da Recarregados

Quando a sua plataforma prefere iniciar o registro.

  1. No painel, escolha “Quero que a Recarregados gere o Token A”. O token aparece uma vez e vale 7 dias.
  2. Na sua plataforma, cadastre a Recarregados com o nosso endereço de versões e esse Token A.
  3. A sua plataforma faz POST no nosso credentials com o token dela e a URL de versions; nós conferimos que Locations responde e devolvemos o nosso token definitivo.

Como lemos

  • Cabeçalho Authorization: Token <token>: em base64 na 2.2/2.3 e como texto na 2.1.1. Se a sua plataforma recusar um formato, tentamos o outro.
  • Toda requisição leva X-Request-ID e X-Correlation-ID, e também OCPI-from-country-code/OCPI-from-party-id (BR/RCR) e o OCPI-to da sua party, quando conhecida.
  • GET em Locations e Tariffs com paginação pelo cabeçalho Link: <…>; rel="next" (e X-Total-Count, que mostramos no teste). A próxima página precisa estar no mesmo domínio.
  • Uma leitura a cada 6 horas, mais as que você pedir no painel. Nada de PUT ou PATCH: não recebemos atualizações em tempo real.
  • Limites: https na porta padrão, endereço público, sem redirecionamento; 20 s e 8 MB por requisição; até 400 páginas, 20.000 registros e 40 s por leitura. Uma rede maior que isso: fale com a gente.
  • A resposta precisa vir no envelope OCPI (data, status_code 1000). Um erro OCPI aparece no painel com o código e a mensagem da sua plataforma.

O que cada campo vira no mapa

OCPINo mapa
Location.id (+ country_code e party_id)Referência fixa do local. Não troque: um id novo vira um ponto novo.
nameNome do eletroposto.
address, city, state, postal_codeEndereço. A cidade do mapa sai do limite do IBGE que contém a coordenada; o texto só desempata perto da divisa.
coordinatesPosição do pino (5 casas decimais). Coordenada a mais de 10 km da cidade escrita no endereço deixa o local de fora.
operator.nameRede mostrada no ponto e na página da rede (ou a rede que escolhemos com você).
evses[].connectors[]Conectores agrupados por tipo, corrente e potência, com a quantidade.
max_electric_power (ou voltagem × amperagem × fases)Potência em kW de cada conector e a potência máxima do ponto.
evses[].status REMOVEDCarregador ignorado. Local sem nenhum outro carregador sai do mapa.
evses[].status PLANNEDSe todos os carregadores restantes são planejados, o local aparece como Em breve, fora do planejador e da busca de recarga agora. Em locais já operacionais, os conectores planejados não entram na potência ou quantidade disponível.
evses[].capabilitiesSem pagamento por cartão (CREDIT_CARD_PAYABLE, DEBIT_CARD_PAYABLE ou CONTACTLESS_CARD_SUPPORT), o ponto diz que a recarga é pelo app ou cadastro da rede.
tariff_ids → TariffsPreço por kWh, taxa por recarga e por hora, ou “Grátis”.
opening_timesHorário (24 horas ou por dia da semana).
publish (2.2/2.3)false tira o local do mapa.
parking_type ON_DRIVEWAYGaragem particular: fica de fora.
last_updatedData da última atualização mostrada no ponto.

Conectores

standardNo mapa
IEC_62196_T2_COMBOCCS2
IEC_62196_T2Tipo 2
CHADEMOCHAdeMO
GBT_DC / GBT_ACGB/T
IEC_62196_T1_COMBO / IEC_62196_T1CCS1 / Tipo 1
TESLA_S / TESLA_RTesla
DOMESTIC_* / NEMA_5_20Tomada
Outro valorEntra como “conector não informado” (com a corrente e a potência).

Corrente contínua vem de power_type: DC (ou de um conector só DC, como CCS2 e CHAdeMO).

Preços (Tariffs)

  • R$/kWh do componente ENERGY, com o imposto quando a tarifa informa vat. É o número que o planejador usa para o custo das paradas.
  • Vale o elemento sem restrição. Só elementos com restrição (horário, potência) contam quando todos dizem o mesmo valor.
  • Só BRL, e só entre R$ 0,30 e R$ 10,00 por kWh. Fora disso, o ponto fica sem preço por kWh.
  • O texto do preço é o tariff_alt_text em português, quando a tarifa traz um; sem ele, montamos “R$ 1,99/kWh + R$ 2,00 por recarga” com os componentes ENERGY, FLAT e TIME.
  • Todos os componentes zerados = “Grátis”. O preço do ponto é o do conector mais potente; com AC e DC diferentes, os dois aparecem.
  • Sem módulo Tariffs, o preço que já estava no ponto operacional continua. Locais Em breve não exibem preço de recarga.

O que entra, o que fica de fora e o que sai

Fica de fora (o teste do painel diz quais e por quê):

  • publish: false (OCPI 2.2/2.3) ou estacionamento particular (ON_DRIVEWAY);
  • sem coordenada, coordenada 0,0 ou fora do Brasil;
  • coordenada que contradiz o endereço (a mais de 10 km da cidade escrita);
  • sem conectores informados ou todos os carregadores removidos;
  • a menos de 150 m de outro ponto que não conseguimos confirmar que é o mesmo: espera a conferência à mão.

Pontos que já estavam no mapa. Quando o local é o mesmo (mesmo lugar e mesmo carregador, ou a até 30 m sem outra rede no ponto), a integração passa a ser a fonte dele: conectores, potência, forma de pagamento, preço e horário passam a vir da rede. Nome e endereço só mudam em pontos que vieram só da integração. Avaliações e check-ins dos motoristas continuam no ponto.

Em breve. Locais somente com carregadores PLANNED aparecem com aviso e conectores previstos. Não entram no planejador nem na busca Recarregar agora. Quando a rede informa que começaram a operar, a mesma ficha passa a aceitar planejamento.

Saída. Um local que some do feed, vira publish: false ou fica sem conectores (ou com todos os carregadores removidos) sai do mapa na leitura seguinte e volta sozinho se reaparecer. Se uma leitura tirar de uma vez mais de 30% dos locais publicados (e mais de 5), nada sai até a nossa equipe conferir. Uma leitura que devolve zero locais é tratada como erro e não tira nada.

Falhas. Uma leitura que falha tenta de novo em 1 hora, depois em 2, 4… até uma vez por dia. O erro aparece no painel e para a nossa equipe.

Segurança

  • O token da sua plataforma fica cifrado (AES-256-GCM) e nunca volta para a tela: o painel mostra só os últimos 4 caracteres.
  • Os tokens que a Recarregados entrega ficam guardados só como hash. Trocar o token (PUT credentials) ou encerrar (DELETE credentials) funciona a qualquer momento, pelo OCPI ou pelo painel.
  • Pedimos o mínimo: leitura de Locations e Tariffs. Um token com mais permissões funciona, mas não precisamos delas.
  • A sua plataforma só aceita IPs liberados? Fale com a gente antes de conectar.

O que fazemos com os dados

Mostramos os pontos no mapa, nas páginas e no planejador, e nada além disso: não revendemos a base, não publicamos download nem lista completa e não enviamos os dados para bases abertas. Está tudo na autorização de uso dos dados, que a rede aceita no painel. Pedida a retirada, os pontos que vieram só da integração saem em até 30 dias.

Sem OCPI?

Poucos pontos: o perfil oficial de cada eletroposto é grátis e você mesmo mantém preço, horário e status (Meus eletropostos).

Muitos pontos sem plataforma OCPI: fale com o Thiago. Recebemos uma planilha com os mesmos campos.

Pronto para conectar? Abrir o painel da integração.

Perguntas frequentes

Quanto custa integrar a minha rede?

Nada. A integração é grátis e não é exclusiva: a rede continua livre para mandar os dados a qualquer outro aplicativo. O Destaque Pro é um produto à parte e não depende da integração.

A Recarregados consegue iniciar ou cobrar recargas?

Não. Somos só leitura (papel NSP no OCPI): lemos Locations e Tariffs. Não usamos Commands, Sessions, CDRs nem Tokens, e não vemos dados de motoristas.

De quanto em quanto tempo o mapa é atualizado?

A cada 6 horas, e na hora quando você pede no painel. Nunca lemos mais de uma vez por hora sem pedido da rede.

Vocês mostram se o carregador está livre ou ocupado?

Ainda não. O estado em tempo real (AVAILABLE, CHARGING) muda a cada minuto e exige que a plataforma nos envie as mudanças; hoje lemos a cada poucas horas. O estado no mapa vem dos relatos dos motoristas e do aviso de manutenção do perfil oficial.

Os pontos da minha rede já estão no mapa. Vão aparecer duplicados?

Não. Quando o local já existe (mesmo lugar e mesmo carregador), a integração passa a ser a fonte dele: conectores, potência, preço e horário passam a vir da rede. Se houver outro ponto a menos de 150 m que não dá para confirmar, o local espera a nossa conferência em vez de virar um segundo pino.

E se a minha plataforma tirar um local do ar?

Ele sai do mapa na leitura seguinte e volta sozinho se reaparecer. Se uma leitura tirar de uma vez mais de 30% dos locais (e mais de 5), nada sai até a nossa equipe conferir, para um erro da plataforma não esvaziar o mapa.

Meu preço muda por horário. Como aparece?

Mostramos o preço geral (o elemento da tarifa sem restrição). Quando todo preço tem restrição de horário ou de potência e os valores são diferentes, o ponto fica sem preço por kWh e o texto alternativo da tarifa (tariff_alt_text) aparece no lugar.

Como os impostos da tarifa OCPI 2.3.0 são tratados?

O campo tax_included informa se o preço já inclui impostos (YES), se não há impostos aplicáveis (N/A) ou se precisam ser somados (NO). Nos dois primeiros casos usamos o preço informado. Em NO somamos o VAT de cada componente; se faltar uma alíquota, ou se faltar tax_included na 2.3.0, o preço fica não informado. Campos adicionais de estacionamento e acessibilidade são aceitos, mas ainda não são exibidos no mapa.

Não tenho plataforma OCPI. Tem outro jeito?

Tem. Para poucos pontos, o perfil oficial de cada eletroposto é grátis e você mesmo mantém preço, horário e status. Para muitos pontos sem OCPI, fale com a gente: recebemos uma planilha com os mesmos campos.

Como paro a integração ou tiro os pontos?

No painel, “Pausar leituras” ou “Desconectar” (ou DELETE no nosso credentials, se houve registro). Os pontos ficam como estão até você pedir a retirada; pedida, sai tudo o que veio só da integração em até 30 dias.