El mismo análisis como Container On-Prem en su red
La API es el mismo núcleo de análisis que el programa de escritorio, empaquetado como imagen de Container que usted ejecuta On-Prem, es decir, en un servidor propio o en su clúster. Sus sistemas envían los archivos de tarjeta al Container por HTTP y reciben el análisis como JSON. El Container mantiene los archivos de tarjeta solo en memoria. No los guarda en el disco duro ni los escribe en ningún archivo de registro. No nos envía archivos de tarjeta ni resultados. Para que podamos contar cuántos conductores analiza con su licencia, se conecta con nuestro servidor de licencias en license.scernetta.com, en concreto tras el inicio, aproximadamente cada 6 horas y cuando aparece un conductor nuevo. En estas conexiones, el servidor de licencias recibe el texto de su archivo de licencia con el nombre de su empresa, el número de versión del Container, algunos valores técnicos de control y, por cada conductor nuevo, un código de conductor. El código de conductor lo calcula el Container en su servidor a partir de la tarjeta de conductor y de su clave secreta.
Para quién está pensado
Está pensado para flotas con TMS o ERP propio que quieran seguir procesando el análisis allí. Los proveedores de telemática que de todos modos ya recopilan datos de tarjeta pueden hacer que se comprueben directamente, y los proveedores de servicios que analizan tarjetas de conductor para muchos clientes se ahorran el rodeo a través de un programa de escritorio.
Cómo transcurre
Recibe de nosotros un archivo de licencia. Antes del primer inicio genera una sola vez, con un comando de la imagen de Container, una clave secreta a partir de la cual el Container calcula los códigos de conductor. Utilice esta clave en todas las instalaciones y guarde una copia. El Container se ejecuta en un servidor de su red y necesita allí una carpeta propia en la que registra qué conductores ya tienen una plaza de conductor. El servidor debe poder acceder a license.scernetta.com, directamente o a través de su proxy HTTP. Sus sistemas se autentican con una clave de API y entregan los archivos .ddd por HTTP, uno a uno o agrupados por conductor, y el Container los combina exactamente como lo hace el programa de escritorio. De vuelta llega un JSON con las jornadas, las infracciones en la vista elegida, las previsiones y los períodos no evaluables, que puede seguir procesando directamente.
Para toda una flota de una vez existe un endpoint por lotes. Sube todos los archivos en una sola solicitud, el Container los asigna por sí mismo a los conductores y calcula en segundo plano. Por cada conductor nuevo de la solicitud, el Container ocupa una plaza de conductor ya en el momento del envío. Si las plazas de conductor libres no alcanzan para todos los conductores nuevos, rechaza la solicitud completa y no ocupa ninguna plaza. El progreso y los resultados por conductor los consulta mediante un ID de tarea.
El mismo núcleo
El programa de escritorio y la API calculan con el mismo código. Para el mismo archivo y la misma vista, la API entrega los mismos resultados que el programa, como datos.
Dos vistas
Cada respuesta contiene una de las dos listas de infracciones. Por defecto se aplica la vista estricta, que deriva cada constatación del texto del reglamento e indica el artículo correspondiente. Conforme al Derecho de la UE puede consultar en su lugar la vista de referencia, que está calibrada frente al resultado de software consolidado. Conforme a las normas suizas ARV 1 y ARV 2 solo existe la vista estricta. Un endpoint propio entrega el catálogo de las reglas con sus referencias.
Informes
El informe del programa de escritorio también llega a través de la API, como HTML o como tablas CSV en un zip. A ello se añade un manifiesto de fuentes que registra qué archivo subido respalda cada día.
Autenticidad
Las firmas y los certificados de una tarjeta de conductor o de una descarga de unidad de vehículo pueden comprobarse a través de la API. La respuesta indica qué se ha verificado. Esta versión aún no comprueba las firmas de la primera generación de tarjetas, y eso no es indicio de manipulación.
Unidad de vehículo
También puede leerse el archivo de descarga del vehículo. Ve qué tarjetas estuvieron insertadas en un período y qué conductores condujeron con ellas.
Generaciones
Se leen tarjetas de conductor de la generación 1 y de la generación 2, incluida la versión 2. La API solo lee los archivos de unidades de vehículo en los formatos de la generación 2.
OpenAPI
La interfaz está descrita como especificación OpenAPI 3.1 que el propio Container entrega. La documentación en docs.scernetta.com se genera a partir de ella.
Cómo se cuentan los conductores
Cada tarjeta de conductor que analice durante el período de vigencia de su licencia cuenta una vez como conductor, con independencia de cuántas veces la analice. Si un conductor recibe una tarjeta renovada o una tarjeta de sustitución, sigue siendo el mismo conductor. Si recibe una tarjeta de otro país, cuenta como conductor nuevo. Un conductor conserva su plaza de conductor hasta el final del período de vigencia, aunque abandone antes su empresa. El recuento abarca todas sus instalaciones en conjunto, incluida una posible instalación de prueba. No ocupan plaza de conductor la tarjeta de ejemplo de nuestro sitio web, la comprobación de autenticidad ni los archivos de unidades de vehículo.
Licencia
La API se licencia según el número de conductores y se factura anualmente. El propio Container comprueba la autenticidad del archivo de licencia mediante la firma digital del archivo, y para ello no necesita ninguna conexión con nosotros. Cuando un conductor se analiza por primera vez durante el período de vigencia, el Container solicita a nuestro servidor de licencias una plaza de conductor para él. Si una licencia de pago caduca, el Container sigue calculando 14 días más, para que el análisis no se detenga cuando la renovación llega unos días más tarde. El precio lo indicamos a petición, porque depende del tamaño de la flota.
Sin conexión con el servidor de licencias
El Container sigue analizando a los conductores que ya tienen una plaza de conductor aunque no haya conexión con nuestro servidor de licencias, durante 30 días desde la última conexión, o durante 14 días con una licencia de prueba. Para conductores nuevos, una licencia de pago tiene una reserva por si nuestro servidor de licencias no está accesible durante más de un minuto. La reserva es una décima parte de las plazas de conductor, pero como mínimo 2 plazas por período de vigencia; con 30 plazas son, por tanto, 3. Para ello, el Container necesita su carpeta en el servidor. A estos conductores los comunica a posteriori, en cuanto el servidor de licencias vuelve a estar accesible. Una licencia de prueba no tiene reserva.
Lo que sale del servidor
Los archivos de tarjeta se procesan On-Prem, es decir, en su red, y nunca se transfieren a nosotros. El código de conductor lo calcula el Container en su servidor a partir de la tarjeta de conductor y de su clave secreta, que nunca recibimos. A partir del código no podemos saber quién es el conductor. Con su clave, sin embargo, el código puede volver a asignarse a un conductor, por lo que, según el RGPD, es un dato personal. Los últimos 20 mensajes que el Container ha enviado a nuestro servidor de licencias desde su inicio puede consultarlos en el Container y leerlos tal como eran antes de cifrarse.
La documentación de la interfaz se encuentra en docs.scernetta.com y se genera a partir del archivo OpenAPI. Comienza con una guía sobre el inicio, la licencia y el tratamiento de errores, y describe cada endpoint con sus parámetros.Ir a la documentación
Si quiere emplear la API, díganos qué sistemas desea conectar y de cuántos conductores o vehículos se trata. Le responderemos con un acceso.