Terug naar kennisbank
TechnologieMay 22, 20265 min read

Zo werkt Hubject RFID-integratie in de praktijk (een walkthrough in 5 stappen)

Wat er gebeurt tussen een kaarttap en het starten van een laadsessie wanneer uw netwerk via Hubject roamt — en de specifieke UID- en provisioning-details die bepalen of de tap slaagt.

Zo werkt Hubject RFID-integratie in de praktijk (een walkthrough in 5 stappen)

Runt u een Charge Point Operator (CPO)-netwerk of een e-Mobility Service Provider (eMSP) en wilt u dat de kaarten van uw klanten ook buiten uw thuisgebied werken, dan komt u onvermijdelijk uit bij een integratie met Hubject. De meeste exploitanten waarmee we werken, komen bij ons nadat ze al een contract met Hubject hebben getekend en nu naar de OICP-specificatie staren om uit te zoeken wat de kaart zelf moet doen.

Dit is de praktische walkthrough: wat gebeurt er tussen het aanbieden van een kaart en het starten van een laadsessie, waar bevindt uw kaartleverancier zich in die keten, en welke specifieke details bepalen of de tap daadwerkelijk slaagt.

De flow in 5 stappen

Wanneer een van uw bestuurders een RFID-kaart aanbiedt aan een Hubject-roaminglader op het netwerk van een andere CPO, gebeurt het volgende:

1.Kaarttap.: De bestuurder biedt de kaart aan aan de RFID-lezer van de lader. De lezer haalt de UID van de chip op — de fabriek-ingestelde unieke identifier, 4 of 7 bytes afhankelijk van de chipfamilie.
2.CPO stuurt de UID naar Hubject.: De backend van de host-CPO weet niet bij wie deze kaart hoort. De CPO verpakt de UID in een OICP AuthorizeStart-request en stuurt deze door naar Hubject. De request bevat de eigen CPO-ID, de EVSE-ID (het specifieke laadpunt) en de UID.
3.Hubject stuurt de UID door naar uw backend.: Hubject fungeert als clearinghouse: op basis van de OICP EvcoIDs en provider-ID-mappings die u hebt geregistreerd, weet Hubject dat deze UID bij uw eMSP hoort. De autorisatie-request wordt doorgestuurd naar uw CPO/eMSP-endpoint.
4.Uw backend autoriseert (of weigert).: Uw backend zoekt de UID op in uw gebruikersdatabase, controleert of het account in goede staat is, past optioneel tariefregels toe en retourneert een autorisatiebeslissing — Authorized met de contract-ID, of NotAuthorized met een redencode.
5.Hubject bevestigt terug naar de CPO.: De host-CPO ontvangt de autorisatie, de lader ontgrendelt en de sessie begint. Laadgegevens en eindfacturatie worden na afloop via Hubject afgerekend.

De volledige keten doorloopt doorgaans minder dan een seconde. Wanneer het misgaat, is dat vrijwel altijd op een van twee punten: het UID-formaat op uw kaart komt niet overeen met wat uw backend verwacht, of de provider-ID-mappings in uw Hubject-account omvatten de chiprange die u uitgeeft niet.

Wat de kaart zelf moet doen

De taak van de kaart in deze flow is klein maar specifiek: een UID aanbieden die uw backend herkent. Dat klinkt triviaal, totdat u kaarten gaat uitgeven op meerdere chipfamilies en merkt dat de sleutellengte in uw database hardcoded is.

Een aantal beslissingen moet vóór de eerste batch worden gemaakt:

UID-lengte.: MIFARE Classic geeft een 4-byte UID terug. Ultralight EV1 en DESFire EV2/EV3 retourneren 7-byte UID's. De Hubject OICP 2.3-specificatie accepteert zowel 4-byte als 7-byte UID's (evenals 10-byte), dus de keuze sluit u niet uit van de roaminghub — maar de databasekolom in uw eigen backend moet breed genoeg zijn om het gekozen formaat op te slaan. Als u later chipfamilies wilt mengen (een basiskaart op Ultralight EV1, een premium vlootkaart op DESFire), gebruik dan VARCHAR(20) of equivalent en normaliseer naar hex-strings.
UID-naar-klant mapping.: Bij het produceren van een productieserie leveren wij een CSV op die elke kaart-UID koppelt aan een klantgericht kaartnummer (of een sequentieel ID of elk ander veld dat u specificeert). Die mapping laadt u in uw gebruikersdatabase voordat u de kaarten activeert. Zonder mapping zou u elke kaart fysiek moeten uitlezen om uw database te vullen — onhaalbaar op productievolumes. Wij leveren deze CSV kosteloos mee.
Personalisatie.: Het klantgerichte kaartnummer is het nummer dat uw klantenservice de bestuurder zal vragen voor te lezen bij een telefoontje. We kunnen dit nummer met laser graveren of bedrukken op de kaart. Voor EV-laden specifiek is lasergraveren duurzamer dan bedrukken — de kaart leeft jarenlang in portemonnees en jaszakken.
Voorconfiguratie.: Sommige exploitanten willen dat de kaart geleverd wordt met cryptografische sleutels al geladen voor een specifieke applicatie. Dit verzorgen wij in de productieserie; u levert het sleutelmateriaal en de applicatie-ID's, wij provisionen ze op elke kaart vóór personalisatie. Dit is meer van toepassing op DESFire-uitrol dan op Ultralight EV1.

Veelvoorkomende faalpatronen (en hoe ze te vermijden)

Een korte lijst integratiekwesties die wij zijn tegengekomen:

Het UID-formaat van de kaart komt niet overeen met de backend.: Oplossing: bevestig 4-byte vs. 7-byte vóór de eerste productiebatch, en vertrouw niet op documentatie — tap fysiek een sample op uw testbackend voordat u de order plaatst.
De UID-range is niet onder uw provider-ID bij Hubject geregistreerd.: Oplossing: registreer de chip-UID-range in uw Hubject-portaal vóór go-live, niet erna.
Autorisatie-roundtrip te traag.: Oplossing: in de meeste gevallen is dit een backend-latency-probleem, niet een kaartprobleem. De kaart-naar-lader-handshake is snel. Ziet u vertragingen van >3 seconden, profileer dan de responstijd van uw CPO/eMSP-backend.
Klanten ontvangen kaarten, maar deze verschijnen niet in de gebruikersdatabase.: Oplossing: laad de UID-naar-klantnummer-CSV in uw database *voordat* u kaarten naar eindgebruikers verstuurt. Klinkt vanzelfsprekend; gaat bij de eerste batch bij de meeste exploitanten mis.

Wat u moet specificeren bij een kaartbestelling

Bent u op het punt om een kaartorder met ons (of een andere kaartleverancier) te scopen, dan ziet het specificatieblad dat Hubject-integratie soepel maakt er als volgt uit:

Chipfamilie (Ultralight EV1 / DESFire — zie [onze chipgids](/resources/which-rfid-chip-for-ev-charging/) voor de keuze)
Gewenste UID-lengte die teruggegeven wordt (4-byte legacy / 7-byte standaard)
Of DESFire-applicaties voorgeprovisioned moeten worden (en het sleutelmateriaal, indien van toepassing)
Het CSV-formaat dat u wenst voor de UID-naar-klantnummer-mapping (kolomvolgorde, scheidingsteken, encoding)
Of het klantgerichte nummer met laser gegraveerd, bedrukt, of beide moet worden

Krijg deze vijf punten goed en de Hubject-flow wordt een configuratie-exercitie in plaats van een debug-exercitie.

Wat nu te doen

Zit u in de fase waarin u chipfamilies vergelijkt voordat u zich vastlegt, lees dan Welke RFID-chip is geschikt voor EV-laden? voor het kader dat wij zouden voorstellen. Kent u de chip al en wilt u er een in handen hebben, vraag dan een voorbeeldpakket aan — wij sturen Ultralight EV1-, DESFire- en gerecycled-PVC-samples in één zending, zodat uw devteam de UID's in uw Hubject-testomgeving kan inlezen zonder enige verplichting.

Of vertel ons waarmee u integreert — chipvoorkeur, doelvolume, roaminghub, uitrolland — en wij komen terug met een bouwbare specificatie en het CSV-formaat klaar om in uw backend te droppen.

Share:

Klaar om uw laadnetwerk te verduurzamen?

Neem contact met ons op om te ontdekken hoe onze duurzame RFID-kaarten uw laadinfrastructuur kunnen verbeteren.

Zo werkt Hubject RFID-integratie in de praktijk (een walkthrough in 5 stappen) | ChargeRFID