NexBlue Guía de integración de AutoCharge

Implementa el registro de vehículos, la autorización automática y la asociación de transacciones en tu CPMS utilizando los cargadores « NexBlue ».

ProtocoloOCPP 1.6
Identidad del vehículoDirección MAC
Clave de configuraciónAutoChargeEnabled
Modelos compatibles
SDU

Edge 2 · Edge Max · Point 2

MDU

Delta · Delta Max

1. Compatibilidad

1.1 Compatibilidad con cargadores

Antes de activar la función AutoCharge en un cargador, envía Obtener configuración para recuperar las claves de configuración compatibles. Un archivo vacío clave La matriz solicita todas las claves compatibles.

CPMS → Cargador · GetConfiguration.req
[
  2,
  "ac-config-001",
  "GetConfiguration",
  {
    "key": []
  }
]

Comprueba si AutoChargeEnabled está presente en clave de configuración.

Charger → CPMS · GetConfiguration.conf · extracto de la respuesta
[
  3,
  "ac-config-001",
  {
    "configurationKey": [
      {
        "key": "AutoChargeEnabled",
        "readonly": false,
        "value": "false"
      }
    ],
    "unknownKey": []
  }
]
Resultado de la consulta Interpretación
Key regresó con valor = "true" La función AutoCharge está disponible y activada.
Key regresó con valor = "false" La función AutoCharge está disponible, pero desactivada.
Clave que no figura en la lista completa, o que aparece en unknownKey La función AutoCharge no es compatible con el firmware actual del cargador.

También puedes consultar la clave directamente con {"key":["AutoChargeEnabled"]}. Una consulta fallida o que ha agotado el tiempo de espera no constituye una prueba de apoyo.

1.2 Compatibilidad con los vehículos

La capacidad del cargador y la compatibilidad del vehículo se comprueban por separado. Un vehículo compatible debe proporcionar una dirección MAC legible, estable y única.

Durante las pruebas de integración:

  • Comprueba que tu CPMS reciba Autorizar con idTag = VID:<MAC> cuando el vehículo está conectado.
  • Completa el registro y repite las sesiones de conexión. Comprueba que el VID se mantenga constante y que la autorización automática se realice correctamente.
  • Anota el modelo del vehículo y la versión del software junto con los resultados de la prueba. Excluye los vehículos de los que se sepa que utilizan identificadores aleatorios o compartidos.

Las listas de vehículos de terceros sirven como referencia orientativa. El hecho de que un vehículo sea compatible con otra red de recarga no garantiza su compatibilidad con los cargadores de CA de NexBlue . Vuelve a validar los vehículos afectados si una actualización de software modifica su identificación o su comportamiento de recarga.

En el caso de los vehículos cuya identificación no se haya verificado, ten a mano tus métodos de autorización habituales.

2. Configuración

Clave de configuración de OCPP Tipo Valor
AutoChargeEnabled Booleano verdadero: activa la función «AutoCharge».
false: desactiva la función «AutoCharge».

Una vez que hayas comprobado que el cargador es compatible, envía Modificar configuración con AutoChargeEnabled configurar en «verdadero» para activar la función, o "false" para desactivarlo. Los valores de configuración se transmiten como cadenas de caracteres.

Reconocer los identificadores de los vehículos en la entrada Authorize.req.idTag valores con el siguiente formato:

VID:<MAC>

El MAC de ejemplo 00155D0665D6 se convierte en VID:00155D0665D6.

3. Matriculación de vehículos

Implementa la interfaz de registro, la confirmación del usuario y la vinculación del VID a la cuenta en tu CPMS. El cargador proporciona el identificador del vehículo.

  1. Proporciona un proceso de registro para un usuario autenticado y pídele que conecte el vehículo.
  2. Cuando el cargador se conecta Preparación, espera un Autorizar solicitud en la que figure el VID del vehículo.
Charger → CPMS · Authorize.req
[
  2,
  "ac-auth-001",
  "Authorize",
  {
    "idTag": "VID:00155D0665D6"
  }
]
  1. Busca el número de identificación del vehículo (VID). Si se trata de un vehículo no matriculado, vuelve atrás. No válido o Bloqueado.
  2. Una vez que el usuario haya confirmado el registro, vincula el VID a la cuenta y envía IniciarTransacciónRemota.
  3. Procesa el cargador Iniciar transacción solicitar y devolver el transactionId en StartTransaction.conf.
  4. Ocuparse de lo siguiente Transferencia de datos mensaje para asociar el vehículo a la transacción, tal y como se define en la sección 5.

4. Autorización automática

Para las sesiones de plug-in posteriores, gestiona las entradas Autorizar solicita lo siguiente:

01

Lee el identificador del vehículo desde idTag = VID:<MAC>.

02

Consulta la vinculación de la cuenta del vehículo y comprueba su estado de autorización.

03

Volver Aceptado para un vehículo autorizado. Devolución No válido para un VID desconocido o Bloqueado por un registro bloqueado.

04

Cuando el cargador envía Iniciar transacción, procesar la solicitud y devolver el identificador de la transacción.

Mantén la identificación del vehículo separada de la autorización. El hecho de recibir un VID no autoriza el uso del vehículo; es tu CPMS quien decide si la cuenta asociada puede realizar el cargo.

5. Metadatos de la transacción

Una vez que hayas devuelto tu CPMS StartTransaction.conf, ten en cuenta lo siguiente NexBlue Transferencia de datos mensaje que vincula la dirección MAC del vehículo con la transacción.

Cargador → CPMS · DataTransfer.req
[
  2,
  "ac-data-001",
  "DataTransfer",
  {
    "vendorId": "com.nexblue.autocharge/v1",
    "messageId": "VID",
    "data": "{\"VID\":\"00155D0665D6\",\"TransactionID\":\"111111111\"}"
  }
]
Campo Valor / formato
vendorId com.nexblue.autocharge/v1
messageId VID
datos Cadena codificada en JSON que contiene VID y ID de transacción.
data.VID Dirección MAC del vehículo sin el VÍDEO: prefijo.
data.TransactionID Identificador de transacción devuelto en StartTransaction.conf, representado como una cadena de caracteres.

Descifrar datos en formato JSON, localiza la transacción utilizando ID de transacción, y asociarlo con VID. Los nombres de los campos distinguen entre mayúsculas y minúsculas; VID contiene la dirección MAC sin el VÍDEO: prefijo.