Demandes CEE

Présentation

Dans le cadre des fiches standardisées et bonifiées pour le covoiturage courte et longue distance, le RPC de preuve de covoiturage met à disposition des opérateurs de covoiturage, une API (Application Programming Interface permettant à ces derniers de vérifier en partie l'éligibilité d'un dossier de demande CEE (vérification de l'historique et du dédoublonnage) et de récolter des données du RPC nécessaires à la bonne constitution du dossier avant envoi de celui-ci par l'opérateur de covoiturage au PNCEE.

Cette API a pour but de fluidifier et de fiabiliser les demandes de dossier afin d'éviter un maximum de refus de ces derniers par le PNCEE en cas de doublon par exemple.

Ressources utiles

Arrêté de création des opérations standardisées CEE covoiturage (fonctionnement non bonifié)
Arrêté de création de la bonification : en cours

Objectifs

vérification de l'éligibilité d'un usager à l'opération standardisée :
- vérification de l'historique : invalidation des usagers ayant déjà bénéficié d'opérations spécifiques 3 ans avant la réalisation du trajet. Comparatif sur la base des données transmises par les opérateurs
- vérification dédoublonnage : invalidation des usagers ayant déjà bénéficié de l'opération standardisée quelque soit la plateforme de covoiturage utilisée.
confirmation de l'éligibilité et mise à disposition d'éléments constitutifs du dossier de demande de prime
- transmission des éléments suivants : journey_id; status et token (signature RPC)

Vérifier un token

Pour vérifier le token, il faut disposer des informations suivantes :

SIRET de l'opérateur ;
type de trajet (short ou long) ;
numéro de permis de conduire ;
horodatage au format ISO 8601 UTC (ex: 2022-11-22T08:54:19Z).

Ces informations sont utilisées pour former une chaîne de caractères comme suit siret/type/permis/horadatage, exemple : 13002526500013/short/051227308989/2022-11-22T08:54:19Z. Cette chaîne est hachée via un SHA512 et constitue le message.

Ce message est signé via une clé RSA et peut donc être vérifié avec la clé publique du Registre ci-après :

Technique de dédoublonnage

Le processus de dédoublonnage permet d'identifier les bénéficiaires potentiellement en double dans la base de données. Il s'appuie sur plusieurs critères pour comparer les enregistrements et déterminer s'ils correspondent à la même personne.

L'algorithme de dédoublonnage fonctionne de la manière suivante. Si l'un des champs suivants est similaire avec un enregistrement existant, la tentative d'enregistrement est considéré comme un doublon.

Permis de conduire (driver_license): Le numéro de permis de conduire est un identifiant unique qui permet de dédoublonner les bénéficiaires avec certitude.
Clé d'identité (identity_key): Si la clé d'identité est définie pour un bénéficiaire, elle est utilisée pour le dédoublonner de manière unique.
Nom tronqué et numéro de téléphone tronqué (phone_trunc & last_name_trunc): Cette combinaison permet de détecter les bénéficiaires dont les noms et les numéros de téléphone sont similaires, même si l'orthographe exacte peut varier. Cette combinaison n'est utilisée que sur les enregistrements passés qui n'ont pas de clé d'identité.

Cette correspondance est faite de manière distincte sur la courte et la longue distance. Elle est également limitée dans le temps à la date de l'enregistrement qui a eu une correspondance en fonction de la nature de l'opération (spécifique ou standardisée).