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.
Para redes de recarga
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.
Mapa, páginas de eletroposto, cidade, estado e rede, no site e no app. Ponto novo entra sozinho; ponto desativado sai na leitura seguinte.
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.
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.
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.
https://recarregados.com/ocpi/versionsBR*RCR (Recarregados), papel NSPlocations (obrigatório, como SENDER) e tariffs (opcional)Escolha o que a sua plataforma suporta. Os três terminam no mesmo lugar.
Jeito 1
A plataforma gera um token só para a Recarregados.
Jeito 2
O jeito padrão do OCPI entre duas plataformas.
Jeito 3
Quando a sua plataforma prefere iniciar o registro.
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.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.data, status_code 1000). Um erro OCPI aparece no painel com o código e a mensagem da sua plataforma.| OCPI | No mapa |
|---|---|
Location.id (+ country_code e party_id) | Referência fixa do local. Não troque: um id novo vira um ponto novo. |
name | Nome do eletroposto. |
address, city, state, postal_code | Endereço. A cidade do mapa sai do limite do IBGE que contém a coordenada; o texto só desempata perto da divisa. |
coordinates | Posição do pino (5 casas decimais). Coordenada a mais de 10 km da cidade escrita no endereço deixa o local de fora. |
operator.name | Rede 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 REMOVED | Carregador ignorado. Local sem nenhum outro carregador sai do mapa. |
evses[].status PLANNED | Se 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[].capabilities | Sem 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 → Tariffs | Preço por kWh, taxa por recarga e por hora, ou “Grátis”. |
opening_times | Horário (24 horas ou por dia da semana). |
publish (2.2/2.3) | false tira o local do mapa. |
parking_type ON_DRIVEWAY | Garagem particular: fica de fora. |
last_updated | Data da última atualização mostrada no ponto. |
standard | No mapa |
|---|---|
IEC_62196_T2_COMBO | CCS2 |
IEC_62196_T2 | Tipo 2 |
CHADEMO | CHAdeMO |
GBT_DC / GBT_AC | GB/T |
IEC_62196_T1_COMBO / IEC_62196_T1 | CCS1 / Tipo 1 |
TESLA_S / TESLA_R | Tesla |
DOMESTIC_* / NEMA_5_20 | Tomada |
Outro valor | Entra 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).
ENERGY, com o imposto quando a tarifa informa vat. É o número que o planejador usa para o custo das paradas.BRL, e só entre R$ 0,30 e R$ 10,00 por kWh. Fora disso, o ponto fica sem preço por kWh.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.Fica de fora (o teste do painel diz quais e por quê):
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.
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.
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.
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.
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.
A cada 6 horas, e na hora quando você pede no painel. Nunca lemos mais de uma vez por hora sem pedido da rede.
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.
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.
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.
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.
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.
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.
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.