Shell B2B Mobility API für Mauttransaktionsdaten – Schnellstartanleitung

API-Version: 1.0.0 | Authentifizierung: OAuth 2.0 | Status: Produktion

Übersicht

Die Shell B2B Mobility API für Mauttransaktionsdaten ist eine REST-basierte API, die Shell-Mobilitätskunden umfassenden Zugriff auf Mauttransaktionsdatensätze und zugehörige Daten bietet. Mit dieser API können Entwickler Mauttransaktionsdaten abrufen, filtern und Mauttransaktionsdaten programmgesteuert abzufragen, zu filtern und zu analysieren – beispielsweise für den Kontenabgleich, die Rechnungsprüfung, das Spesenmanagement und zur Erfüllung von Compliance-Anforderungen.

Wichtigste Funktionen

Mauttransaktionsdaten nach Kontonummer abrufen
Transaktionen nach Datumsbereich (Start- und Enddatum) filtern
Suche nach Rechnungsstatus und VRN (Fahrzeugkennzeichen)
Erweiterte Sortierfunktionen für mehrere Felder
Unterstützung von Paginierung für große Datensätze
Flexible Feldfilterung zur Optimierung der Antwortdaten
Umfassende Mautdetails einschließlich Ein- und Ausfahrtspunkte
Unterstützung mehrerer Mautnetze und Betreiber

Authentifizierung

OAuth 2.0 (Standard-Authentifizierungsmethode)

Die Shell Toll Transaction Data API verwendet den OAuth 2.0 Client Credentials-Ablauf für die sichere Authentifizierung.

OAuth 2.0-Ablauf

Schritt 1: Zugriffstoken abrufen

Fordern Sie ein Zugriffstoken vom OAuth-Token-Endpunkt an:

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

grant_type=client_credentials&client_id=Ihre-Client-ID&client_secret=Ihr-Client-Secret

Schritt 2: Verwenden des Zugriffstokens in API-Anfragen

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

Token-Verwaltung

Bewährte Verfahren für die Token-Verwaltung:

Zugriffstoken haben eine begrenzte Gültigkeitsdauer (in der Regel 15 Minuten)
Implementieren Sie Token-Caching, um unnötige Token-Anfragen zu vermeiden
Aktualisieren Sie Token vor Ablauf, um einen unterbrechungsfreien Dienst zu gewährleisten
Geben Sie Ihr `client_secret` niemals weiter und betten Sie es nicht in clientseitigen Code ein

Umgebungen

Die API ist in zwei Umgebungen verfügbar:

Umgebung	Basis-URL	Zweck
Produktion	https://api.shell.com/toll-data/v1	Live-Produktionsumgebung
Test (UAT)	https://api-test.shell.com/toll-data/v1	Test- und Entwicklungsumgebung

OAuth-Token-URLs:

Umgebung	Token-URL
Produktion	https://api.shell.com/v2/oauth/token
Test (UAT)	https://api-test.shell.com/v2/oauth/token

Tipp: Testen Sie Ihre Integration immer in der Testumgebung, bevor Sie in die Produktion wechseln.

Schnellstart

1. OAuth-Anmeldedaten abrufen

Kontakt technischen Support von Shell
Beantragen Sie OAuth 2.0-Anmeldeinformationen (client_id und client_secret)
Lesen Sie die Nutzungsbedingungen

2. Zugriffstoken abrufen

Rufen Sie zunächst Ihr OAuth-Zugriffstoken ab:

cURL-Beispiel:

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=Ihre-Client-ID&client_secret=Ihr-Client-Secret"

Antwort:

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

3. Führen Sie Ihre erste API-Anfrage durch

Beispiel: Mauttransaktionen suchen

cURL-Beispiel:

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
}'

Beispielantwort:

{
  "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",
      "DelcoName": "Shell Fleet Solutions Consorzio",
 "NetworkCode": "TLI",
 "Network": "euroShell Consortio",
 "PurchasedInCountry": "Italy",
      "PurchasedInCountryCode": "IT",
 "CardNumber": "707737*******334272",
 "CardId": 123456789,
 "CardGroupName": "Shell Fleet Solutions Consorzio",
      "Fahrzeugkennzeichen": "KN 00000",
 "Kostenstelle": "100",
 "Erfassungsdatum": "20260123",
 "Erfassungszeit": "13:14:25",
 „Transaktionsdatum“: „20260120“,
 „Transaktionszeit“: „10:30:00“,
 „Buchungsdatum“: „20260123“,
      "Buchungszeit": "00:00:00",
 "Zahlernummer": "NL20016398",
 "Kontonummer": "NL20027701",
      "Kontoname": "Test-Kontoname",
 "Startdatum": "20260120",
 "Startzeit": "06:47:41",
 "Enddatum": "20260120",
      "EndTime": "07:30:15",
 "TollGateEntry": "ROMA NORD",
 "TollGateExit": "BRENNERO",
 "DistanceDriven": "71,6",
      "Streckenbeschreibung": "ROMA NORD – BRENNERO",
 "Transaktionstyp": "Maut",
 "Produktcode": "14",
 "Produktbeschreibung": "Maut",
 "Nettobetrag der Transaktion": "127,1",
      "Transaktionssteuer": "0,0",
 "Transaktionsbruttobetrag": "127,1",
 "Transaktionswährungscode": "EUR",
 "Transaktionsstatus": "Meldung",
 "Rechnungsnummer": "8600397548",
 "Rechnungsdatum": "20260125",
      "Rechnungsstatus": "In Rechnung gestellt",
 "Zahlungsart": "Nachzahlung",
 "OBU-Seriennummer": "00049000000836932426",
      "Emissionsklasse": "Euro 6",
 "Vertrags-ID": "fb75eb53-46eb-450b-862e-6045002c3fa8",
      "ShellTransactionID": "04176c5c-e7b2-49c8-bcb3-23d07ba583f2",
 "Mautbetreiber": "Toll4Europe",
      "Mautbereich": "Toll4Europe",
 "TarifrelevanteInformationen": "Fahrzeugklasse: 2, Achsanzahl: 2, Straßenkategorie: Autobahn",
      "AdditionalTransactionInfo": "Standort: 1",
 "TCInvoiceNumber": "12343343",
 "TCInvoiceDate": "20260123"
    }
  ]
}

API-Endpunkte – Referenz

Mauttransaktionen

Endpunkt	Methode	Beschreibung
/toll-data/v1/transactions/search	POST	Mauttransaktionsdaten mit flexibler Filterung und Paginierung abrufen

Häufige Anwendungsfälle:

Mauttransaktionen nach Datumsbereich abrufen
Nach Rechnungsstatus filtern (In Rechnung gestellt, nicht in Rechnung gestellt, alle)
Nach Kfz-Kennzeichen (VRN) suchen
Nach Kartengruppe filtern
Transaktionen nach mehreren Kriterien sortieren
Bestimmte Felder auswählen, um die Antwortgröße zu optimieren

Häufige Anwendungsfälle

In diesem Abschnitt werden gängige Geschäftsszenarien den API-Nutzungsmustern zugeordnet, damit Sie schnell erkennen können, wie Sie die API für Ihre spezifischen Anforderungen nutzen können.

Anwendungsfall 1: Täglicher Abgleich der Mauttransaktionen

Szenario: Sie müssen täglich alle Mauttransaktionen Ihrer Flotte für Buchhaltungszwecke abgleichen.