API Shell B2B Mobility pour les données de transactions de péage - Guide de démarrage rapide

Version de l'API : 1.0.0 | Authentification : OAuth 2.0 | Statut : Production

Présentation

L'API Shell B2B Mobility « Données de transactions de péage » est une API basée sur REST qui offre un accès complet aux enregistrements de transactions de péage et aux données associées pour les clients de Shell Mobility. Cette API permet aux développeurs de récupérer, filtrer et analyser par programmation les données de transactions de péage à des fins de rapprochement comptable, de vérification de facturation, de gestion des dépenses et de conformité réglementaire.

Principales fonctionnalités

Récupérer les données de transactions de péage par numéro de compte
Filtrer les transactions par plage de dates (dates de début et de fin)
Recherche par statut de facture et numéro d'immatriculation du véhicule (VRN)
Fonctionnalités de tri avancées sur plusieurs champs
Prise en charge de la pagination pour les grands ensembles de données
Filtrage flexible des champs pour optimiser la charge utile de la réponse
Détails complets sur les péages, y compris les points d’entrée etde sortie
Prise en charge de plusieurs réseaux et opérateurs de péage

Authentification

OAuth 2.0 (méthode d’authentification standard)

L’API Shell Toll Transaction Data utilise le flux « Client Credentials » d’OAuth 2.0 pour une authentification sécurisée.

Flux OAuth 2.0

Étape 1 : Obtenir un jeton d’accès

Demander un jeton d’accès au point de terminaison de jetons OAuth:

POST /oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&client_id=votre-id-client&client_secret=votre-secret-client

Étape 2 : Utiliser le jeton d’accès dans les requêtes API

Authorization: Bearer 
Content-Type: application/json
RequestId : eb621f45-a543-4d9a-a934-2f223b263c42

Gestion des jetons

Meilleures pratiques en matière de gestion des jetons :

Les jetons d’accès ont une durée de vie limitée (généralement 15 minutes)
Mettez en place une mise en cache des jetons pour éviter les requêtes inutiles
Actualisez les jetons avant leur expiration pour garantir un service ininterrompu
Ne partagez jamais votre client_secret et ne l’intégrez jamais dans du code côté client

Environnements

L’API est disponible dans deux environnements :

Environnement	URL de base	Objectif
Production	https://api.shell.com/toll-data/v1	Environnement de production en direct
Test (UAT)	https://api-test.shell.com/toll-data/v1	Environnement de test et de développement

URL des jetons OAuth :

Environnement	URL du jeton
Production	https://api.shell.com/v2/oauth/token
Test (UAT)	https://api-test.shell.com/v2/oauth/token

Conseil : Testez toujours votre intégration dans l’environnement de test avant de passer en production.

Démarrage rapide

1. Obtenez vos identifiants OAuth

Contactez le support technique de Shell
Demandez des identifiants OAuth 2.0 (client_id et client_secret)
Consultez les conditions d’utilisation

2. Obtenir un jeton d’accès

Commencez par obtenir votre jeton d’accès OAuth :

Exemple avec cURL :

curl -X POST https://api-test.shell.com/v2/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=votre-id-client&client_secret=votre-secret-client"

Réponse :

{
  "access_token": "eyJhbGciOi*******5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 899
}

3. Effectuez votre première requête API

Exemple : recherche de transactions de péage

Exemple avec cURL :

curl -X POST https://api-test.shell.com/toll-data/v1/transactions/search \
  -H "Authorization: Bearer eyJhbGci******NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -H "RequestId: eb621f45-a543-4d9a-a934-2f223b263c42" \
  -d '{
    "Filters": {
 "ColCoCode": 86,
 "PayerNumber": "NL20016398",
 "AccountNumber": "NL20027701",
        "Filter": "All",
 "FromDate": "2026-01-01",
 "ToDate": "2026-01-31"
    },
    "Page": 1,
    « PageSize » : 10
}'

Exemple de réponse :

{
  « RequestId » : « eb621f45-a543-4d9a-a934-2f223b263c42 »,
  "Status": "SUCCESS",
  "Page": 1,
  "TotalRecords": 150,
  "TotalPages": 15,
  "PageSize": 10,
  "Data": [
    {
 "NetworkDescription": "Societa Autostradali",
 "TollChargerCode": "410|610",
 "DelcoCode": "714",
      "NomDelco" : "Shell Fleet Solutions Consorzio",
 "CodeRéseau" : "TLI",
 "Réseau" : "euroShell Consortio",
 "PaysD'achat" : "Italie",
      « PurchasedInCountryCode » : « IT »,
 « CardNumber » : « 707737*******334272 »,
 « CardId » : 123456789,
 « CardGroupName » : « Shell Fleet Solutions Consorzio »,
      "Immatriculation du véhicule" : "KN 00000",
 "Centre de coûts" : "100",
 "Date de saisie dans le système" : "20260123",
 "Heure de saisie dans le système" : "13:14:25",
      « TransactionDate » : « 20260120 »,
 « TransactionTime » : « 10:30:00 »,
 « PostingDate » : « 20260123 »,
      "Heure de comptabilisation" : "00:00:00",
 "Numéro du payeur" : "NL20016398",
 "Numéro de compte" : "NL20027701",
 "Nom du compte" : "Nom du compte test",
      "DateDeDébut" : "20260120",
 "HeureDeDébut" : "06:47:41",
 "DateDeFin" : "20260120",
 "HeureDeFin" : "07:30:15",
      "Point d'entrée du péage" : "ROMA NORD",
 "Point de sortie du péage" : "BRENNERO",
 "Distance parcourue" : "71,6",
 "Description de l'itinéraire" : "ROMA NORD - BRENNERO",
      "TypeDeTransaction" : "Péage routier",
 "CodeProduit" : "14",
 "DescriptionProduit" : "Péage routier",
 "MontantNetDeLaTransaction" : "127,1",
 "TaxeDeLaTransaction" : "0,0",
      « Montant brut de la transaction » : « 127,1 »,
 « Code de devise de la transaction » : « EUR »,
 « Statut de la transaction » : « Déclaration »,
 « Numéro de facture » : « 8600397548 »,
      "DateDeFacture" : "20260125",
      "InvoiceStatus" : "Facturé",
 "PaymentMethod" : "Paiement différé",
 "OBUSerialNumber" : "00049000000836932426",
      "EmissionClass" : "Euro 6",
 "ContractID" : "fb75eb53-46eb-450b-862e-6045002c3fa8",
      "ShellTransactionID" : "04176c5c-e7b2-49c8-bcb3-23d07ba583f2",
      "TollOperator" : "Toll4Europe",
 "TollDomain" : "Toll4Europe",
 "TariffRelevantInformation" : "Classe de véhicule : 2, Nombre d'essieux : 2, Catégorie de route : Autoroute",
      "AdditionalTransactionInfo" : "Emplacement : 1",
 "TCInvoiceNumber" : "12343343",
 « TCInvoiceDate » : « 20260123 »
    }
  ]
}

Référence des points de terminaison API

Transactions de péage

Point de terminaison	Méthode	Description
/toll-data/v1/transactions/search	POST	Récupérer les données des transactions de péage avec filtrage et pagination flexibles

Cas d’utilisation courants :

Récupérer les transactions de péage par plage de dates
Filtrer par statut de facturation (Facturées, Non facturées, Toutes)
Recherche par numéro d’immatriculation du véhicule (VRN)
Filtrer par groupe de cartes
Trier les transactions selon plusieurs critères
Sélectionner des champs spécifiques pour optimiser la taille de la réponse

Cas d’utilisation courants

Cette section met en correspondance des scénarios métier courants avec des modèles d’utilisation de l’API afin de vous aider à déterminer comment utiliser l’API en fonction de vos besoins spécifiques.

Cas d’utilisation n° 1 : Rapprochement quotidien des transactions de péage

Scénario : Vous devez rapprocher quotidiennement toutes les transactions de péage de votre flotte à des fins comptables.