Roaming entre redes · OCPI 2.2.1

Conductores de otras redes en tus cargadores. Y los tuyos en los de ellas.

Las redes se conectan mediante un estándar abierto y el conductor carga con la app o tarjeta que ya usa.

Conectar mi red Documentación técnica

Red PlugrPayRed asociada

OCPI 2.2.1

RPApp de la red asociada

Green Park SP

Calle Augusta, 500 · 2 disponibles

Disponible mediante roaming

Conductor de otra red

Carga autorizada

ALLOWED

Cómo funciona

Qué ocurre entre las dos redes

01
Las redes se presentan
Cada parte recibe una clave de acceso para comunicarse de forma segura.
02
Los puntos aparecen en la app
La red asociada recibe la lista de electrolineras, conectores y disponibilidad.
03
El conductor es autorizado
Su red responde de inmediato si puede cargar.
04
Se cierra la cuenta
Enviamos el resumen de energía, tiempo y valor para cobrar al conductor.

Endpoints disponibles

Base URL: https://api.plugrpay.com.br

Método	Ruta	Descripción	Auth
GET	/ocpi/2.2/versions	Versiones OCPI compatibles	Público
GET	/ocpi/2.2/credentials	Credenciales y roles del CPO PlugrPay	x-token
GET	/ocpi/2.2/locations	Lista de electrolineras (objetos Location)	x-token
POST	/ocpi/2.2/tokens/:uid/authorize	Autorización del token del conductor	x-token
GET	/ocpi/2.2/sessions	Sesiones de carga activas e históricas	x-token
GET	/ocpi/2.2/cdrs	Charge Detail Records para facturación	x-token

Ejemplo: GET /ocpi/2.2/locations

GET https://api.plugrpay.com.br/ocpi/2.2/locations?offset=0&limit=10 HTTP/1.1
Host: api.plugrpay.com.br
x-token: your-ocpi-token
Accept: application/json

HTTP/1.1 200 OK
{
  "status_code": 1000,
  "status_message": "Success",
  "timestamp": "2025-05-16T10:00:00Z",
  "data": [
    {
      "id": "charging-station-uuid",
      "type": "ON_STREET",
      "name": "Shopping Norte EV01",
      "address": "Av. Brasil, 1500",
      "city": "São Paulo",
      "postal_code": "01310-100",
      "country": "BRA",
      "coordinates": {
        "latitude": "-23.561684",
        "longitude": "-46.655981"
      },
      "evses": [
        {
          "uid": "connector-uuid",
          "status": "AVAILABLE",
          "connectors": [
            {
              "id": "1",
              "standard": "CCS2",
              "format": "SOCKET",
              "power_type": "AC_3_PHASE",
              "max_voltage": 400,
              "max_amperage": 32,
              "max_electric_power": 22000
            }
          ]
        }
      ],
      "last_updated": "2025-05-16T09:55:00Z"
    }
  ],
  "total_count": 142,
  "limit": 10,
  "offset": 0
}

Autenticación

Usamos el esquema TOKEN_A de OCPI: un token opaco enviado en el headerx-token en cada solicitud.

Socio → PlugrPay

El socio usa el token que proporcionamos al registrar la conexión.

GET https://api.plugrpay.com.br/ocpi/2.2/locations HTTP/1.1
x-token: plugrpay-ocpi-token
Host: api.plugrpay.com.br

PlugrPay → Socio

Usamos el token proporcionado durante el intercambio de credenciales.

GET /versions HTTP/1.1
x-token: <partner-token>
Host: api.partner.example

Atención: Todos los endpoints OCPI (excepto /versions) requieren el headerx-token. Las solicitudes sin token o con token inválido recibenHTTP 401 con status_code: 2001.

Entorno de prueba

Valida tu integración sin afectar datos de producción.

Base URLhttps://api.plugrpay.com.br

Token de pruebaplugrpay-ocpi-demo-token

Swagger UIhttps://api.plugrpay.com.br/ocpi/docs

Prueba rápida con curl

# 1. Verificar versiones compatibles (sin autenticación)
curl https://api.plugrpay.com.br/ocpi/2.2/versions

# 2. Listar electrolineras con el token de prueba
curl https://api.plugrpay.com.br/ocpi/2.2/locations \
  -H "x-token: plugrpay-ocpi-demo-token" \
  -H "Accept: application/json"

# 3. Verificar credenciales del CPO
curl https://api.plugrpay.com.br/ocpi/2.2/credentials \
  -H "x-token: plugrpay-ocpi-demo-token"

¿Conectamos nuestras redes?

Escribe a integradores@plugrpay.com.br y habilitaremos el entorno de prueba.

Enviar correo Abrir la documentación