Volver a Recursos
Tecnología22 de mayo de 20267 min read

Cómo funciona realmente la integración de RFID con Hubject (guía paso a paso en 5 etapas)

Qué sucede entre el contacto de la tarjeta y la sesión de recarga de VE cuando su red opera en itinerancia a través de Hubject, además de los detalles específicos de UID y aprovisionamiento que determinan el éxito de la lectura.

Cómo funciona realmente la integración de RFID con Hubject (guía paso a paso en 5 etapas)

Si usted gestiona una red de Operadores de Puntos de Recarga (CPO) o es un Proveedor de Servicios de Movilidad Eléctrica (eMSP) y desea que las tarjetas de sus clientes funcionen fuera de su territorio local, tendrá que integrarse con Hubject. La mayoría de los operadores con los que trabajamos acuden a nosotros tras haberse registrado en Hubject, cuando se encuentran analizando la especificación OICP para intentar descifrar qué debe hacer exactamente la tarjeta.

Esta es la guía práctica paso a paso: qué ocurre desde que un conductor aproxima su tarjeta hasta que se inicia una sesión de recarga, qué papel desempeña su proveedor de tarjetas en esa cadena y cuáles son los detalles específicos que determinan si la lectura de la tarjeta se realiza con éxito.

El flujo de 5 pasos

Cuando un conductor de su red aproxima una tarjeta RFID a un cargador con itinerancia/roaming de Hubject en la red de otro CPO, el proceso es el siguiente:

1.Lectura de la tarjeta.: El conductor aproxima la tarjeta al lector de tarjetas RFID del cargador. El lector extrae el UID del chip (el identificador único establecido de fábrica, de 4 o 7 bytes según la familia del chip).
2.El CPO envía el UID a Hubject.: El backend del CPO anfitrión no sabe a quién pertenece esta tarjeta. Empaqueta el UID en una solicitud AuthorizeStart de OICP y la reenvía a Hubject. La solicitud incluye el ID del propio CPO, el EVSE ID (el punto de recarga específico) y el UID.
3.Hubject reenvía el UID al backend de usted.: Hubject actúa como cámara de compensación: sabe que este UID pertenece a su eMSP basándose en los EvcoIDs de OICP y en las asignaciones de ID de proveedor que usted ha registrado. Reenvía la solicitud de autorización al endpoint de su CPO/eMSP.
4.El backend de usted autoriza (o rechaza).: El backend de usted busca el UID en su base de datos de usuarios, comprueba si la cuenta está al corriente de pago, aplica opcionalmente las reglas de tarificación y devuelve una decisión de autorización: Authorized (autorizado) con el ID del contrato, o NotAuthorized (no autorizado) con un código de motivo.
5.Hubject confirma la autorización al CPO.: El CPO anfitrión recibe la autorización, el cargador se desbloquea y comienza la sesión. Los datos de recarga y la facturación final se liquidan a través de Hubject una vez finalizada la sesión.

Normalmente, toda la cadena se completa en menos de un segundo. Cuando falla, casi siempre se debe a uno de estos dos puntos: el formato del UID de su tarjeta no coincide con lo que espera su backend, o las asignaciones de ID de proveedor en su cuenta de Hubject no incluyen el rango de chips que está emitiendo.

Lo que la tarjeta debe hacer

La función de la tarjeta en este flujo es sencilla pero muy específica: presentar un UID que el backend de usted sea capaz de reconocer. Esto parece trivial hasta que se empiezan a emitir tarjetas de múltiples familias de chips y se descubre que la longitud de la clave de la base de datos está predefinida de forma fija.

Es necesario tomar algunas decisiones antes de enviar el primer lote:

Longitud del UID.: MIFARE Classic devuelve un UID de 4 bytes. Ultralight EV1 y DESFire EV2/EV3 devuelven UID de 7 bytes. La especificación OICP 2.3 de Hubject acepta tanto UID de 4 bytes como de 7 bytes (así como de 10 bytes), por lo que la elección no le excluye del nodo de itinerancia/roaming; sin embargo, la columna de la base de datos de su propio backend debe tener la longitud suficiente para almacenar el formato que elija. Si prevé combinar familias de chips más adelante (una tarjeta básica con Ultralight EV1 y una tarjeta de flota premium con DESFire), utilice un VARCHAR(20) o equivalente y normalice a cadenas hexadecimales.
Asociación de UID a cliente.: Cuando fabricamos un lote de producción, entregamos un archivo CSV que asocia el UID de cada tarjeta con un número de tarjeta orientado al cliente (o un ID secuencial, o cualquier campo que usted especifique). Esa asociación es la que usted carga en su base de datos de usuarios antes de activar las tarjetas. Sin ella, tendría que leer físicamente cada tarjeta para registrarla en su base de datos, lo cual resulta inviable para volúmenes de producción. Entregamos este archivo CSV sin coste adicional.
Personalización.: El número de tarjeta orientado al cliente es el que su equipo de atención al cliente solicitará al conductor cuando este llame por teléfono. Podemos grabar con láser o imprimir este número en la propia tarjeta. Específicamente para la recarga de VE, el grabado con láser es más duradero que la impresión, ya que la tarjeta se guarda en carteras y bolsillos durante años.
Preconfiguración.: Algunos operadores requieren que la tarjeta se entregue con claves criptográficas ya cargadas para una aplicación específica. Nosotros nos encargamos de esto durante el proceso de producción; usted nos proporciona las claves y los ID de aplicación, y nosotros los aprovisionamos en cada tarjeta antes de la personalización. Esto es más relevante para despliegues con DESFire que con Ultralight EV1.

Errores comunes (y cómo evitarlos)

A continuación, se detalla una breve lista de los problemas de integración que observamos con mayor frecuencia:

El formato del UID de la tarjeta no coincide con el del backend.: Solución: confirme si utilizará 4 bytes o 7 bytes antes del primer lote de producción y no se fíe únicamente de la documentación; realice una lectura física de una muestra en su backend de prueba antes de realizar el pedido.
El rango de UID no está registrado en Hubject bajo su ID de proveedor.: Solución: registre el rango de UID de los chips en su portal de Hubject antes del lanzamiento, no después.
El tiempo de ida y vuelta de la autorización (Authorize) es demasiado lento.: Solución: en la mayoría de los casos, se trata de un problema de latencia del backend, no de la tarjeta. El intercambio de información entre la tarjeta y el cargador es rápido. Si experimenta retrasos de más de 3 segundos, analice el tiempo de respuesta del backend de su CPO/eMSP.
Los clientes reciben las tarjetas pero estas no aparecen en la base de datos de usuarios.: Solución: cargue el archivo CSV de asociación de UID a cliente en su base de datos *antes* de enviar las tarjetas a los usuarios finales. Parece obvio, pero es el error en el que caen la mayoría de los operadores en su primer lote.

Qué especificar al solicitar sus tarjetas

Si está a punto de definir un pedido de tarjetas con nosotros (o con cualquier otro proveedor de tarjetas), la hoja de especificaciones para que la integración con Hubject sea sencilla debe incluir lo siguiente:

Familia de chip (Ultralight EV1 / DESFire; consulte nuestra guía de chips para decidir)
Longitud de UID requerida (4 bytes heredado / 7 bytes estándar)
Si necesita que las aplicaciones DESFire estén preaprovisionadas (y, en tal caso, las claves correspondientes)
El formato CSV que desea para la asociación de UID a número de cliente (orden de columnas, separador, codificación)
Si el número orientado al cliente debe grabarse con láser, imprimirse o ambos

Si define correctamente estos cinco puntos, el flujo de Hubject se convertirá en un mero ejercicio de configuración en lugar de un proceso de resolución de errores.

Qué hacer a continuación

Si se encuentra en la fase de comparar familias de chips antes de decidirse, lea ¿Qué chip RFID es el adecuado para la recarga de vehículos eléctricos? para conocer el enfoque que sugerimos. Si ya tiene claro el chip que necesita y desea ver una muestra física, solicite un paquete de muestras: enviamos muestras de Ultralight EV1, DESFire y PVC reciclado de una sola vez, para que su equipo de desarrollo pueda leer los UID en su entorno de pruebas de Hubject antes de asumir cualquier compromiso.

O bien, cuéntenos qué está integrando (preferencia de chip, volumen objetivo, nodo de itinerancia/roaming, país de despliegue) y le responderemos con una especificación viable y el formato CSV listo para integrar en su backend.

Share:

¿Preparado para la transición ecológica de su red de recarga?

Póngase en contacto con nosotros para descubrir cómo nuestras tarjetas RFID sostenibles pueden mejorar su infraestructura de recarga de VE.

Cómo funciona realmente la integración de RFID con Hubject (guía paso a paso en 5 etapas) | ChargeRFID