NexBlue Integrationsguide för AutoCharge

Implementera fordonsregistrering, automatisk auktorisering och transaktionskoppling i ditt CPMS med hjälp av laddare från NexBlue .

ProtokollOCPP 1.6
FordonsidentitetMAC-adress
KonfigurationsnyckelAutoChargeEnabled
Modeller som stöds
SDU

Edge 2 · Edge Max · Point 2

MDU

Delta · Delta Max

1. Kompatibilitet

1.1 Stöd för laddare

Innan du aktiverar AutoCharge på en laddare ska du skicka GetConfiguration för att hämta de konfigurationsnycklar som stöds. En tom nyckel array begär alla nycklar som stöds.

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

Kontrollera om AutoChargeEnabled finns i konfigurationsnyckel.

Laddare → CPMS · GetConfiguration.conf · utdrag ur svaret
[
  3,
  "ac-config-001",
  {
    "configurationKey": [
      {
        "key": "AutoChargeEnabled",
        "readonly": false,
        "value": "false"
      }
    ],
    "unknownKey": []
  }
]
Sökresultat Tolkning
Nyckeln återlämnades tillsammans med värde = "true" AutoCharge stöds och är aktiverat.
Nyckeln återlämnades tillsammans med värde = "false" AutoCharge stöds men är inaktiverat.
Nyckel saknas i den fullständiga listan, eller finns med i okänd nyckel AutoCharge stöds inte av den nuvarande firmwareversionen för laddaren.

Du kan också göra en sökning direkt på nyckeln med {"key":["AutoChargeEnabled"]}. En misslyckad eller tidsavbruten förfrågan utgör inte ett stöd.

1.2 Fordonskompatibilitet

Laddarens kapacitet och fordonets kompatibilitet kontrolleras separat. Ett kompatibelt fordon måste tillhandahålla en läsbar, stabil och unik MAC-adress.

Under integrationstestningen:

  • Kontrollera att ditt CPMS tar emot Godkänn med idTag = VID:<MAC> när fordonet är anslutet.
  • Slutför registreringen och upprepa plug-in-sessionerna. Kontrollera att VID-värdet förblir oförändrat och att den automatiska auktoriseringen lyckas.
  • Notera fordonsmodellen och programvaruversionen tillsammans med testresultaten. Uteslut fordon som man vet använder slumpmässiga eller delade identifierare.

Fordonslistor från tredje part används som referens vid granskning. Att ett fordon stöds av ett annat laddningsnätverk innebär inte att det är kompatibelt med växelströmsladdare från NexBlue . Kontrollera berörda fordon på nytt om en programuppdatering ändrar identifieringsuppgifterna eller laddningsbeteendet.

För fordon utan verifierad identifiering bör du se till att dina befintliga auktoriseringsmetoder är tillgängliga.

2. Konfiguration

OCPP-konfigurationsnyckel Typ Värde
AutoChargeEnabled Boolesk sant: Aktivera AutoCharge.
false: inaktivera AutoCharge.

När du har kontrollerat att laddaren stöds, skicka Ändra konfiguration med AutoChargeEnabled ställ in på "sant" för att aktivera funktionen, eller "false" för att inaktivera den. Konfigurationsvärdena överförs som strängar.

Identifiera fordonets identifieringsnummer i inkommande Authorize.req.idTag värden enligt följande format:

VID:<MAC>

Exemplet MAC 00155D0665D6 blir VID:00155D0665D6.

3. Fordonsregistrering

Implementera registreringsgränssnittet, användarbekräftelsen och kopplingen mellan VID och konto i ert CPMS. Laddaren tillhandahåller fordonets identifieringsnummer.

  1. Skapa en registreringsprocess för en inloggad användare och uppmana denne att ansluta fordonet.
  2. När laddaren ansluts Förberedelser, räkna med en Godkänn förfrågan som innehåller fordonets VID.
Laddare → CPMS · Authorize.req
[
  2,
  "ac-auth-001",
  "Authorize",
  {
    "idTag": "VID:00155D0665D6"
  }
]
  1. Sök upp fordonets VID-nummer. För ett oregistrerat fordon, gå tillbaka Ogiltigt eller Blockerad.
  2. När användaren har bekräftat registreringen ska du koppla VID:en till kontot och skicka Starta transaktion på distans.
  3. Behandla laddarens StartTransaction begära och returnera transaktions-ID i StartTransaction.conf.
  4. Hantera det som följer Dataöverföring meddelande för att koppla fordonet till transaktionen, enligt definitionen i avsnitt 5.

4. Automatisk auktorisering

Vid efterföljande plug-in-sessioner ska du hantera inkommande Godkänn begär följande:

01

Läs av fordonets identifieringsnummer från idTag = VID:<MAC>.

02

Sök upp fordonets kontokoppling och kontrollera dess behörighetsstatus.

03

Återgå Godkänt för ett godkänt fordon. Återgå Ogiltigt för en okänd VID eller Blockerad vid en blockerad registrering.

04

När laddaren sänder StartTransaction, bearbeta begäran och returnera transaktions-ID:t.

Håll fordonets identifieringsnummer (VID) åtskilt från behörigheten. Att erhålla ett VID innebär inte att fordonet är behörigt; det är ditt CPMS-system som avgör om det tillhörande kontot får göra avdrag.

5. Metadata för transaktioner

När dina CPMS-resultat har kommit tillbaka StartTransaction.conf, räkna med följande NexBlue Dataöverföring meddelande som kopplar samman fordonets MAC-adress med transaktionen.

Laddare → CPMS · DataTransfer.req
[
  2,
  "ac-data-001",
  "DataTransfer",
  {
    "vendorId": "com.nexblue.autocharge/v1",
    "messageId": "VID",
    "data": "{\"VID\":\"00155D0665D6\",\"TransactionID\":\"111111111\"}"
  }
]
Fält Värde / format
leverantörs-ID com.nexblue.autocharge/v1
messageId VID
data En JSON-kodad sträng som innehåller VID och Transaktions-ID.
data.VID Fordonets MAC-adress utan VID: prefix.
data.TransactionID Transaktions-ID som returneras i StartTransaction.conf, uttryckt som en sträng.

Avkoda data som JSON, sök upp transaktionen med hjälp av Transaktions-ID, och koppla det till VID. Fältnamn är skiftlägeskänsliga; VID innehåller MAC-adressen utan VID: prefix.