Jak w praktyce działa integracja RFID z Hubject (przewodnik w 5 krokach)

Jeśli zarządzają Państwo siecią operatora punktów ładowania (CPO) lub świadczą usługi jako dostawca usług elektromobilności (eMSP) i chcą Państwo, aby karty Państwa klientów działały poza rodzimym obszarem, integracja z Hubject będzie niezbędnym krokiem. Większość operatorów, z którymi współpracujemy, zgłasza się do nas już po podpisaniu umowy z Hubject, analizując specyfikację OICP i próbując ustalić, jakie wymagania musi spełniać sama karta.

Oto praktyczny przewodnik: co dzieje się od momentu przyłożenia karty przez kierowcę do rozpoczęcia sesji ładowania, jakie miejsce w tym łańcuchu zajmuje dostawca kart oraz jakie konkretne szczegóły decydują o tym, czy autoryzacja zakończy się sukcesem.

Przepływ w 5 krokach

Gdy Państwa kierowca przykłada kartę RFID do ładowarki obsługującej roaming Hubject w sieci innego CPO, proces przebiega następująco:

1.Przyłożenie karty.: Kierowca zbliża kartę do czytnika RFID w ładowarce. Czytnik pobiera UID chipu – fabrycznie ustawiony unikalny identyfikator o długości 4 lub 7 bajtów, w zależności od rodziny chipów.

2.CPO przesyła UID do Hubject.: System backendowy goszczącego CPO nie wie, do kogo należy ta karta. Pakuje UID do żądania OICP AuthorizeStart i przekazuje je do Hubject. Żądanie zawiera ID danego CPO, EVSE ID (konkretny punkt ładowania) oraz UID.

3.Hubject przekazuje UID do Państwa backendu.: Hubject działa jako izba rozliczeniowa: na podstawie zarejestrowanych przez Państwa identyfikatorów OICP EvcoIDs oraz mapowania ID dostawców wie, że ten UID należy do Państwa eMSP. Przekazuje żądanie autoryzacji do punktu końcowego (endpointu) Państwa CPO/eMSP.

4.Państwa backend autoryzuje (lub odrzuca) transakcję.: Państwa system sprawdza UID w bazie danych użytkowników, weryfikuje status konta, opcjonalnie stosuje reguły taryfowe i zwraca decyzję o autoryzacji – Authorized wraz z ID umowy lub NotAuthorized z kodem przyczyny.

5.Hubject potwierdza autoryzację operatorowi CPO.: Goszczący CPO otrzymuje potwierdzenie, ładowarka odblokowuje się i rozpoczyna się sesja. Dane o ładowaniu i ostateczne rozliczenie są procesowane przez Hubject po zakończeniu sesji.

Cały ten proces trwa zazwyczaj krócej niż sekundę. Jeśli dochodzi do błędu, najczęściej dzieje się to w jednym z dwóch punktów: format UID na karcie nie odpowiada oczekiwaniom Państwa backendu lub zakresy chipów, które Państwo wydają, nie zostały uwzględnione w mapowaniu ID dostawców na koncie Hubject.

Co musi zapewniać sama karta

Rola karty w tym procesie jest niewielka, ale kluczowa: musi ona przedstawić UID, który Państwa backend będzie w stanie rozpoznać. Brzmi to prosto, dopóki nie zaczną Państwo wydawać kart z różnych rodzin chipów i nie okaże się, że długość klucza w bazie danych została zakodowana na stałe.

Przed wysyłką pierwszej partii należy podjąć kilka decyzji:

•

Długość UID.: MIFARE Classic zwraca 4-bajtowy UID. Ultralight EV1 oraz DESFire EV2/EV3 zwracają UID 7-bajtowy. Specyfikacja Hubject OICP 2.3 akceptuje zarówno 4-bajtowe, jak i 7-bajtowe UID (a także 10-bajtowe), więc wybór ten nie blokuje dostępu do platformy roamingowej – jednak kolumna w Państwa bazie danych musi być wystarczająco szeroka, aby pomieścić wybrany format. Jeśli planują Państwo w przyszłości mieszać rodziny chipów (np. podstawowa karta na Ultralight EV1, karta flotowa premium na DESFire), warto użyć typu VARCHAR(20) lub odpowiednika i ujednolicić zapis do ciągów szesnastkowych (hex).

•

Mapowanie UID do klienta.: Przy realizacji zamówienia produkcyjnego dostarczamy plik CSV, który mapuje UID każdej karty na widoczny dla klienta numer karty (lub sekwencyjny identyfikator, bądź dowolne inne wskazane pole). To mapowanie należy zaimportować do bazy danych użytkowników przed aktywacją kart. Bez tego musieliby Państwo fizycznie odczytać każdą kartę, aby wprowadzić ją do bazy – co przy wolumenach produkcyjnych jest niewykonalne. Plik CSV dostarczamy bez dodatkowych opłat.

•

Personalizacja.: Widoczny na karcie numer to identyfikator, o którego podanie poprosi dział obsługi klienta, gdy kierowca zadzwoni z problemem. Możemy wygrawerować laserowo lub nadrukować ten numer na karcie. W przypadku ładowania pojazdów elektrycznych grawerowanie laserowe jest znacznie trwalsze niż nadruk – karta spędza lata w portfelach i kieszeniach.

•

Wstępna konfiguracja.: Niektórzy operatorzy wymagają, aby karty były dostarczane z już wgranymi kluczami kryptograficznymi dla konkretnej aplikacji. Realizujemy to w procesie produkcyjnym; Państwo dostarczają strukturę kluczy i identyfikatory aplikacji, a my wgrywamy je na każdą kartę przed etapem personalizacji. Ma to większe znaczenie przy wdrożeniach DESFire niż Ultralight EV1.

Typowe problemy integracyjne (i jak ich unikać)

Oto krótka lista problemów wdrożeniowych, z którymi najczęściej się spotykamy:

•

Format UID karty nie zgadza się z backendem.: Rozwiązanie: potwierdzić format (4-bajtowy vs 7-bajtowy) przed pierwszą partią produkcyjną i nie polegać wyłącznie na dokumentacji – przed złożeniem zamówienia należy fizycznie przetestować próbkę na własnym backendzie testowym.

•

Zakres UID nie został zarejestrowany w Hubject pod Państwa ID dostawcy.: Rozwiązanie: zarejestrować zakresy UID chipów w portalu Hubject przed uruchomieniem usługi produkcyjnej, a nie po nim.

•

Zbyt wolna autoryzacja (round-trip).: Rozwiązanie: najczęściej jest to problem z opóźnieniem po stronie backendu, a nie samej karty. Komunikacja między kartą a ładowarką jest błyskawiczna. Jeśli opóźnienia przekraczają 3 sekundy, należy przeanalizować czas reakcji backendu CPO/eMSP.

•

Klienci otrzymują karty, ale nie ma ich w bazie danych.: Rozwiązanie: zaimportować plik CSV z mapowaniem UID do bazy danych *przed* wysyłką kart do użytkowników końcowych. Brzmi to oczywiście, ale jest to najczęstszy błąd operatorów przy pierwszej partii.

Co należy określić przy zamawianiu kart

Jeśli przygotowują się Państwo do określenia specyfikacji zamówienia kart u nas (lub u dowolnego innego dostawcy), specyfikacja gwarantująca bezproblemową integrację z Hubject powinna zawierać:

•Rodzinę chipów (Ultralight EV1 / DESFire – pomoc w wyborze znajdą Państwo w naszym przewodniku po chipach)

•Oczekiwaną długość zwracanego UID (starszy standard 4-bajtowy / współczesny standard 7-bajtowy)

•Informację, czy aplikacje DESFire mają być wstępnie skonfigurowane (oraz strukturę kluczy, jeśli tak)

•Format pliku CSV do mapowania UID na numer klienta (kolejność kolumn, separator, kodowanie)

•Informację, czy numer widoczny dla klienta ma być grawerowany laserowo, drukowany, czy jedno i drugie

Zadbanie o te pięć elementów sprawi, że integracja z Hubject stanie się prostym zadaniem konfiguracyjnym, a nie procesem debugowania.

Co zrobić dalej

Jeśli są Państwo na etapie porównywania rodzin chipów przed podjęciem decyzji, polecamy lekturę artykułu Który chip RFID wybrać do ładowania pojazdów elektrycznych?, który ułatwi dokonanie wyboru. Jeśli chip jest już wybrany i chcą Państwo przetestować go w praktyce, zachęcamy do zamówienia pakietu próbnego – wysyłamy próbki Ultralight EV1, DESFire oraz kart z recyklingu PVC w jednej paczce. Państwa zespół deweloperski będzie mógł odczytać UID i przetestować je w środowisku testowym Hubject jeszcze przed złożeniem zamówienia.

Mogą Państwo również opisać nam swoje wymagania integracyjne – preferowany chip, planowany wolumen, platformę roamingową oraz kraj wdrożenia – a my przygotujemy gotową specyfikację techniczną i format CSV dopasowany do Państwa backendu.

Jak w praktyce działa integracja RFID z Hubject (przewodnik w 5 krokach)

Przepływ w 5 krokach

Co musi zapewniać sama karta

Typowe problemy integracyjne (i jak ich unikać)

Co należy określić przy zamawianiu kart

Co zrobić dalej

Gotowi na ekologiczne zmiany w Państwa sieci ładowania?

Powiązane artykuły

Przejrzystość danych i cen według AFIR 2026: Co standard DATEX II oznacza dla technologii RFID i roamingu

Zgodność z AFIR 2026: Terminy dla ładowania EV i lista kontrolna RFID