Shell B2B Mobility Card Transaction Data API – Schnellstartanleitung

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

Übersicht

Die Shell-Karten-Transaktionsdaten-API ist eine REST-basierte API, die es Entwicklern ermöglicht, Transaktionsdaten von Shell-Tankkarten programmgesteuert abzurufen und zu analysieren. Die API bietet Zugriff auf Transaktionen mit Preisangaben, Gebühren, volumenbasierte Preisgestaltung, Bonusregeln, Ausnahmen und Zusammenfassungen zur Kartennutzung.

Hinweis: Dieser Leitfaden behandelt ausschließlich OAuth 2.0-authentifizierte Endpunkte (Basispfad: /transaction-data/v1). Ältere Endpunkte mit Basic-Auth-Authentifizierung (/fleetmanagement/v1/transaction) sind nicht enthalten, da sie schrittweise auslaufen.

Wichtigste Funktionen

Abfrage von Transaktionsdetails mit Preisangaben, einschließlich EV-Transaktionen
Zugriff auf Details zu Kraftstofftransaktionen mit Verkaufsartikeln und Gebühren
Abruf von Transaktionsübersichtsdaten für Kraftstoff- und NFR-Transaktionen
Abfrage von volumenbasierten Preis- und Bonusregeln
Abruf von Gebührenposten und Gebührenübersichtsdaten
Zugriff auf Karten- und Transaktionsausnahmen
Analyse von Kartennutzungs- und Ausgabendaten
Unterstützung für Transaktionsabfragen

Wichtiger Hinweis – OAuth 2.0

WICHTIG: OAuth 2.0 ist nun die Standard-Authentifizierungsmethode

Neue Integrationen: Verwenden Sie OAuth 2.0 von Anfang an
Bestehende Integrationen: Planen Sie Ihre Migration zu OAuth 2.0
Veraltete Methoden: Basic Auth wird auslaufen

Wenden Sie sich an den den technischen Support von Shell zu wenden, um Ihre OAuth 2.0-Anmeldedaten (client_id und client_secret) zu erhalten.

Authentifizierung

OAuth 2.0 (Standard-Authentifizierungsmethode)

Die Shell Card Transaction Data API nutzt den OAuth 2.0-Client-Credentials-Flow für eine sichere Authentifizierung.

WARNUNG: Alle Kunden sollten die Umstellung auf OAuth 2.0-Authentifizierung ein. Dies ist die empfohlene und zukunftssichere Authentifizierungsmethode für die Shell Card Transaction Data API. Ältere Authentifizierungsmethoden werden schrittweise abgeschafft.

OAuth 2.0-Ablauf

Schritt 1: Zugriffstoken abrufen

Fordern Sie ein Zugriffstoken vom OAuth-Token-Endpunkt:

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

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

Strategie zur Einführung von OAuth 2.0

Warum auf OAuth 2.0 umsteigen?

Sicherheitsvorteile:

Branchenübliches-Standard-Authentifizierungsprotokoll
Zeitlich begrenzte Zugriffstoken reduzieren Sicherheitsrisiken
Bei jeder Anfrage werden keine Anmeldedaten übertragen
Bessere Unterstützung für Token-Rotation und -Widerruf

Betriebliche Vorteile:

Verbesserte Skalierbarkeit und Leistung
Bessere Überwachungs- und Prüfungsmöglichkeiten
Vereinfachte Verwaltung von Anmeldedaten
Zukunftssichere Integration

Migrationspfad

Wenn Sie derzeit veraltete Authentifizierungsmethoden verwenden, folgen Sie diesem Migrationspfad:

Fordern Sie OAuth 2.0-Anmeldedaten an bei Shell Technical Support
Implementieren Sie die OAuth-Token-Verwaltung in Ihrer Anwendung
Führen Sie gründliche Tests in der Test-/Sandbox-Umgebung durch
Führen Sie während der Umstellung eine parallele Authentifizierung (OAuth + veraltete Methode) durch
Überwachen und validieren Sie OAuth-Integration
Wechseln Sie zu „Nur OAuth“, sobald die Validierung abgeschlossen ist
Stellen Sie die veraltete Authentifizierung nach erfolgreicher Migration ein

Umgebungen

Die API ist in zwei Umgebungen verfügbar:

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

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

Schnellstart

1. Beziehen Sie Ihre OAuth-Anmeldedaten

Kontaktieren Sie den technischen Support von Shell
Beantragen Sie OAuth 2.0-Anmeldedaten (client_id und client_secret)
Lesen Sie die Nutzungsbedingungen

2. Beziehen Sie ein Zugriffstoken

Beziehen Sie zunächst Ihr OAuth-Zugriffstoken:

cURL-Beispiel:

curl -X POST https://api-test.shell.com/test/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": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

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

Beispiel: Abgerufene Transaktionen

cURL-Beispiel:

curl -X POST https://api-test.shell.com/test/transaction-data/v1/priced \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "Filters": {
 "ColCoCode": "5",
 "PayerNumber": "DE26667080",
 "InvoiceStatus": "A",
        "IncludeFees": true,
 "FromDate": "2024-12-01 00:00:00",
        "ToDate": "2025-01-20 00:00:00"
    },
    "Page": 1,
    "PageSize": 1
}'

Beispielantwort:

{
  "RequestId": "9d2dee33-7803-485a-a2b1-2c7538e597ee",
  "Status": "SUCCESS",
  "Data": [
    {
 "AccountName": "Blue Colour Ltd",
 "AccountId": 29484,
 "AccountNumber": "DE26667080",
 "AccountShortName": "Mathew",
 "Additional1": "GBALLEGO0002452",
 "Additional2": "GBALLEGO0002452",
 "Additional3": "GBALLEGO0002452",
 "Additional4": "GBALLEGO0002452",
 "AllowClearing": „Null“,
 „AuthorisationCode“: 300796,
 „TransactionStatus“: „Y“,
 „DriverName“: „SATTY BHAMRA“,
      „CardExpiryPeriod“: 2204,
 „CardExpiry“: „20220101“,
 „CardGroupId“: 40000,
 „CardGroupName“: „006240 FIRE BRIGHT SOLUTIONS“,
 „IssuerCode“: 7002,
 „CardPAN“: „7002053465789891000“,
 „ReleaseCode“: 9,
      "CardSequenceNumber": 617,
 "CardType": "GB STD FLT NAT SINGLE R9",
 "ColCoCode": "014",
 "UnitDiscountInvoiceCurrency": -0,0051,
      "ColCoExchangeRate": 0,851858,
 "InvoiceCurrencySymbol": "GBP",
 "CorrectionFlag": true,
 "CRMNumber": 10,
 "CustomerCountry": „Vereinigtes Königreich“,
 „Kundenwährungscode“: „GBP“,
 „Kundenwährungssymbol“: „£“,
 „Rabatt auf Nettobetrag in Kundenwährung“: 0,
      "Effektiver Rabatt in Kundenwährung": -0,22,
 "Effektiver Stückrabatt in Kundenwährung": -0,0051,
 "Stückpreis in Rechnungswährung": 1,1024,
 "Rechnungssteuer": 0,
      "Rechnungsbruttobetrag": 57,25,
 "Rechnungsnettbetrag": 47,71,
 "MwSt. auf den Nettbetrag in Kundenwährung": 9,54,
 "Kundenverkaufspreis pro Einheit (brutto)": 0,
      "Kundenverkaufswert gesamt (brutto)": 57,52,
 "Kundenverkaufswert gesamt (netto)": 47,93,
 "Transaktionsartbeschreibung": 9,59,
 "Rabatt auf Nettobetrag in Transaktionswährung": -0,22,
 „Effektiver Rabatt in Transaktionswährung“: -0,22,
 „Wechselkurs von Landeswährung zu Kundenwährung“: 0,
 „Karten“: [
 275549
 ],
      „Stückrabatt in Transaktionswährung“: -0,005,
 „Bruttobetrag der Transaktion“: 57,25,
 „Nettobetrag der Transaktion“: 47,71,
      "TransactionTax": 9,54,
 "VATonNetAmount": 9,54,
 "DelcoListPriceUnitNet": 0,
      "Delco-Einzelhandelspreis pro Einheit (brutto)": 1,32888,
 "Stückpreis in Transaktionswährung": 1,1074,
 „Delco-Einzelhandelspreis pro Einheit (netto)“: 1,1074,
 „Delco-Einzelhandelswert gesamt (brutto)“: 57,52,
 „Delco-Einzelhandelswert gesamt (netto)“: 47,93,
      "TransactionCurrencySymbol": "$",
 "DiscountType": 1,
      "Streitfallstatus": false,
 "IstShell-Standort": false,
 "Flotten-ID-Eingabe": "YG67OUM",
 "Eingehender Produktcode": 23,
 "Buchungsdatum": „20210802“,
 „Buchungszeit“: „14:15:22“,
 „Produktcode“: 30,
 „Produktname“: „Bleifrei – mittlere Oktanzahl“,
 „Produktgruppen-ID“: 22,
      "IncomingCurrencyCode": "GBP",
 "IncomingSiteDescription": "Shell Broadway Ring",
 "Location": "Shell Broadway Ring",
 "SiteName": "Shell Broadway Ring",
 "SiteCode": 32,
      "Standortnummer": 15,
 "Rechnungswährungscode": "GBP",
 "Rechnungsdatum": "20210802",
 „Rechnungsnummer“: 3201016193,
 „Kraftstoffprodukt“: true,
      "Mehrwertsteueranwendbar": "Y",
 "Zahlername": "Colours Services Ltd",
 "Zahlernummer": "GB12121212",
 "ÜbergeordneteKundennummer": "GB12121212",
      "Zahlergruppe": "H312066",
 "Name der Zahlergruppe": "12162566 – FUEL CARD SERVICE",
 "Prüfziffer": 6,
 "Netto-Rechnungs-Kennzeichen": "Y",
 "Delco-Code": 5,
 „NetworkCode“: 3,
 „PurchasedInCountry“: „Vereinigtes Königreich“,
      "Standortland": "Vereinigtes Königreich",
 "USt.-Land": "Vereinigtes Königreich",
 "Delco-Name": "Shell U.K. Oil Products Limited",
 "Netzwerk": "Shell",
 "Kilometerstand": 0,
 "Original-Verkaufsartikel-ID": "Null“,
 „FleetIDDescription“: „YG67OUM“,
 „ParentCustomerId“: 6494,
 „PINIndicator“: „Y, N“,
 „ProductGroupName“: „Gebühren“,
 „PurchasedInCountryCode“: „GB“,
 „Quantity“: 43,28,
 „RebateRate“: 0,0022,
 „ReceiptNumber“: 6803,
 „RefundFlag“: „Y“,
 „SiteGroupId“: 202,
 „SiteGroupName“: „CZ 9100 ECONOMY NETWORK“,
 „Latitude“: 53,83606,
      "Längengrad": -1,61854,
 "DelCo-Wechselkurs": 0,851858,
 "Euro-Rabattbetrag": -0,258259,
      "Nettobetrag in Euro": 56,01,
 "Euro-MwSt.-Betrag": 11,2,
 "Name des übergeordneten Kunden": "FUEL CARD SERVICES LTD",
 „IsInvoiced“: false,
 „TransactionCurrencyCode“: „GBP“,
 „CreditDebitCode“: „D oder C“,
 „TransactionDate“: „20210801“,
      "TransactionTime": "12:16:58",
 "TransactionItemId": "H305908971030",
 "TrnIdentifier": "H305908971030",
 "Type": "SALE",
      "TransactionLine": 1,
 "TransactionType": "Kauf",
 "UTCOffset": "Europe/London",
 „VATCategory“: „Standard-Mehrwertsteuersatz des Vereinigten Königreichs“,
 „VATRate“: 0,2,
 „VehicleRegistration“: „YG67OUM“,
      "IsCancelled": "Y",
 "ColCoGrossAmount": 57,25,
      "ColCoNetAmount": 47,71,
 "ColCoVATAmount": 9,54,
 "OriginalCurrencySymbol": "$",
 "OriginalCurrencyCode": "$",
      "OriginalVATAmount": 0,
 "EmbossText": "PARKLANE PROPERTIES LTD",
      "OriginalExchangeRate": 0,
 "OriginalTransactionItemInvoiceDate": "20220202",
 "FeeTypeId": 1,
      "LineItemDescription": true,
 "FeeRuleDescription": "Einfache Gebühr",
 "Frequency": 1,
 "FeeRuleId": 1,
 „Systemerfassungsdatum“: „20210828“,
 „Systemerfassungszeit“: „20:21:08“,
 „Ist manuell“: „Y“,
 „Ursprüngliche Transaktionsposten-ID“: „Y",
 „OriginalTransactionItemInvoiceNumber“: 6750802,
 „OriginalTransactionItemInvoiceId“: 234,
 „PayerShortName“: „FUEL CARD SERVICES LTD“,
 „ReverseCharge“: „Y“,
 „OriginalGrossAmount“: 57,25,
      "OriginalNetAmount": 57,25,
 "UnitOfMeasure": "L",
 "RoadType": "Nationalstraße",
 "CustomerCountryIsoCode": "DE",
 "EVOperator": "Shell Recharge",
 "EVSerialId": "GBALLEGO0002452",
 "EVChargePointSerial": "GBALLEGO0002452",
 "EVChargePointConnectorType": 5,
 "EVChargePointConnectorTypeDescription": "DC 50 kW",
 "EVChargeDuration": "PT3205S",
      "EVChargeStartDate": "2021-08-01",
 „EVChargeStartTime“: „20:08:01“,
 „EVChargeEndDate“: „2022-08-01“,
 „EVChargeEndTime“: „20:08:01“,
 „HostingCollectingCompanyNumber": 0,
 "TransactionId": 0,
 "FuelOnly": true,
 "EVPrintedNumber": "ZZ2WJ53ZZ5",
 "IsRFID": true
    }
  ],
  "Seite": 1,
  "Seitengröße": 1,
  "Gesamtseiten": 5
}

API-Endpunkt-Referenz

Preisgebundene Transaktionen

Endpunkt	Methode	Beschreibung
/transaction-data/v1/priced	POST	Details zu kostenpflichtigen Transaktionen einschließlich EV-Transaktionen abrufen (OAuth 2.0)
/transaction-data/v1/pricedtransaction	POST	Details zu Kraftstofftransaktionen mit Verkaufsartikeln und Gebühren abrufen (OAuth 2.0)
/transaction-data/v1/multipayerspricedtransactions	POST	Details zu Transaktionen mit Preisangaben für mehrere Zahler abrufen (OAuth 2.0)

Häufige Anwendungsfälle:

Transaktionen nach Datumsbereich abrufen
Nach Transaktionsstatus filtern (Genehmigt, Abgelehnt usw.)
Nach Karten-PAN oder Kfz-Kennzeichen suchen
EV-Ladetransaktionen abrufen
Transaktionen über mehrere Zahler hinweg abfragen

Transaktionsübersichten

Endpunkt	Methode	Beschreibung
/transaction-data/v1/pricedtransactionssummary	POST	Zusammenfassungsdaten zu kostenpflichtigen Transaktionen für Kraftstoff und NFR mit Verkaufsartikeln und Gebühren abrufen (OAuth 2.0)
/transaction-data/v1/cardusagesummary	POST	Ausgabenanalyse und Nutzungsübersicht für eine Karte abrufen (OAuth 2.0)

Gibt Folgendes zurück:

Aggregierte Transaktionsdaten nach Zeitraum
Gesamtvolumina und -beträge
Aufschlüsselung nach Produkttyp und Kategorie
Ausgabenanalyse auf Kartenebene

Gebührenmanagement

Endpunkt	Methode	Beschreibung
/transaction-data/v1/feessummary	POST	Zusammenfassende Daten zu Gebührenposten für den angegebenen Zahler abrufen (OAuth 2.0)

Gebühreninformationen:

Auf Transaktionen angewandte Gebührenposten abrufen
Zusammenfassung aller Gebühren nach Zeitraum
Gebührenaufschlüsselung nach Art und Kategorie
Gebührenanalyse auf Kontoebene

Volumenbasierte Regeln

Endpunkt	Methode	Beschreibung
/transaction-data/v1/volumebasedpricing	POST	Einstellungen für Gebühren bei Zahlungsrückständen des angegebenen Zahlers abrufen (OAuth 2.0)
/transaction-data/v1/volumebasedbonus	POST	Einstellungen für Bonus- und Assoziationsbonusregeln für den angegebenen Zahler abrufen (OAuth 2.0)

Volumenbasierte Funktionen:

Auf volumenbasierte Preisregeln zugreifen
Bonusberechnungsregeln abrufen
Konfigurationen für Partnerboni abrufen
Gebührenstrukturen für Zahlungsrückstände abfragen

Ausnahmen

Endpunkt	Methode	Beschreibung
/transaction-data/v1/exceptions	POST	Karten- oder transaktionsbezogene Ausnahmen abrufen (OAuth 2.0)

Ausnahmetypen:

Fehler bei der Transaktionsvalidierung
Anomalien bei der Kartennutzung
Autorisierungsausnahmen
Warnungen wegen Richtlinienverstößen

Häufige Anwendungsfälle

In diesem Abschnitt werden häufige Geschäftsszenarien den entsprechenden API-Endpunkten zugeordnet, damit Sie schnell erkennen können, welche APIs Sie für Ihre spezifischen Anforderungen verwenden sollten.

Anwendungsfall 1: Täglicher Transaktionsabgleich

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

Empfohlene API: /transaction-data/v1/priced

Warum diese API: Dieser Endpunkt liefert umfassende Transaktionsdetails, einschließlich Transaktionen zum Laden von Elektrofahrzeugen, unterstützt flexible Datumsfilterung und umfasst sowohl in Rechnung gestellte als auch noch nicht in Rechnung gestellte Transaktionen. Ideal für den täglichen Abgleich mit Paginierungsunterstützung für große Datensätze.

Wichtige Parameter:

FromDate und ToDate – Auf das gestrige Datum setzen
InvoiceStatus – Verwenden Sie „A“ für alle Transaktionen
PageSize – Auf 100 setzen für einen effizienten Datenabruf

Anwendungsfall 2: Rechnungsprüfung und -verifizierung

Szenario: Sie haben eine Rechnung erhalten und müssen alle Transaktionsdetails, einschließlich Gebühren und Entgelte, zu überprüfen.

Empfohlene API: /transaction-data/v1/pricedtransaction

Warum diese API: Speziell entwickelt, um detaillierte Informationen zu Kraftstofftransaktionen bereitzustellen, einschließlich Verkaufspositionen und aller damit verbundenen Gebühren. Ideal für die Rechnungsvalidierung, da sie der Rechnungsstruktur entspricht.

Wichtige Parameter:

InvoiceNumber – Zu validierende Rechnung
InvoiceDate – Rechnungsdatum aus Ihrer Abrechnung
IncludeFees – Auf „true“ setzen, um alle Gebührenposten anzuzeigen

Anwendungsfall 3: Analyse und Berichterstellung zum Kraftstoffverbrauch

Szenario: Sie müssen die Kraftstoffverbrauchsmuster Ihrer gesamten Flotte für den vergangenen Monat analysieren, um Routen zu optimieren und Kosten zu senken.

Empfohlene APIs:

/transaction-data/v1/pricedtransactionssummary – Für aggregierte Daten

Warum diese APIs: Zusammenfassungs-Endpunkte liefern aggregierte Daten nach Produkt, Standortgruppe und Zeitraum und eignen sich somit ideal für Trendanalysen, ohne dass große Transaktionsvolumina verarbeitet werden müssen.

Wichtige Parameter:

FromDate und ToDate – Auf die letzten 30 Tage festlegen
ProductCode – Nach bestimmten Kraftstoffarten filtern
ProductGroupName – Nach Kraftstoffkategorien gruppieren

Anwendungsfall 4: Verwaltung mehrerer Fuhrparks

Szenario: Sie verwalten mehrere Unterkonten oder Zahler und müssen Transaktionsdaten aus allen Konten abrufen, um konsolidierte Berichte zu erstellen.

Empfohlene API: /transaction-data/v1/multipayerspricedtransactions

Warum diese API: Speziell entwickelt, um Transaktionen über mehrere Zahler hinweg in einem einzigen API-Aufruf abzufragen, was die Anzahl der Anfragen erheblich reduziert und die Leistung in Szenarien mit mehreren Flotten verbessert.

Wichtige Parameter:

Accounts – Array aus Zahler-IDs und -Nummern (max. 10 Zahler)
InvoiceStatus – „A“ für alle Transaktionen
FromDate und ToDate – Berichtszeitraum

Anwendungsfall 5: Ausnahmemonitoring und Betrugserkennung

Szenario: Sie möchten ungewöhnliche Transaktionsmuster wie Transaktionen mit hohem Wert, übermäßige Kraftstoffmengen oder Karten mit abnormaler Nutzung identifizieren, um Betrug oder Missbrauch zu verhindern.

Empfohlene API: /transaction-data/v1/exceptions

Warum diese API: Speziell entwickelt zur Identifizierung von Transaktionen, die definierte Schwellenwerte überschreiten, und somit ideal für die Überwachung von Ausnahmen und potenziellem Betrug.

Wichtige Parameter:

Condition – Schwellenwerttyp festlegen (ValueGreaterThan, VolumeGreaterThan usw.)
Wert – Definieren Sie den Schwellenwert
Ausgabetyp – „Transaction“ für Transaktionsausnahmen
TransactionsFromDate und TransactionsToDate – Überwachungszeitraum

Anwendungsfall 6: Gebühren- und Kostenanalyse

Szenario: Sie müssen alle Gebühren und Kosten , die auf Ihr Konto angewendet werden, um Einsparpotenziale zu identifizieren oder die Abrechnung zu überprüfen.

Empfohlene API: /transaction-data/v1/feessummary

Warum diese API: Liefert aggregierte Gebühreninformationen nach Gebührentyp, Produktgruppe und Gebührengruppe und erleichtert so die Analyse von Gebührenstrukturen sowie die Identifizierung kostenintensiver Bereiche.

Wichtige Parameter:

InvoiceStatus – „I“ für ausschließlich in Rechnung gestellte Gebühren
FeeTypeGroup – Filter nach „Kartengebühren“, „Kontogebühren“ usw.
FromDate und ToDate – Analysezeitraum

Anwendungsfall 7: Nachverfolgung der Ausgaben einzelner Karten

Szenario: Ein Fahrer fordert seine Transaktionshistorie der letzten 6 Monate an, oder Sie müssen die Ausgabemuster für eine bestimmte Karte analysieren.

Empfohlene API: /transaction-data/v1/cardusagesummary

Warum diese API: Bietet eine detaillierte Ausgabenanalyse für einzelne Karten der letzten 7 Monate, gruppiert nach Standort und Produkt – ideal für die Berichterstellung auf Kartenebene.

Wichtige Parameter:

CardId oder PAN – Zu analysierende Karte
CardExpiry – Zur zusätzlichen Validierung
AccountId – Optionaler Kontofilter

Anwendungsfall 8: Prüfung der Berechtigung für volumenbasierte Preisgestaltung

Szenario: Sie möchten prüfen, ob Ihr Konto für volumenbasierte-basierte Preisstufen qualifiziert ist und möchten Ihre aktuellen Verbrauchswerte im Vergleich zu definierten Schwellenwerten nachvollziehen.

Empfohlene API: /transaction-data/v1/volumebasedpricing

Warum diese API: Zeigt Ihre Regeln für Verzugsgebühren, Stufenkonfigurationen und den aktuellen Volumenverbrauch an und hilft Ihnen so, die Preisstrukturen zu verstehen und zu planen, wie Sie bessere Stufen erreichen können.

Wichtige Parameter:

PayerNumber – Ihr Zahlerkonto
IncludeHistory – Auf „true“ setzen, um historische Berechnungen anzuzeigen
IncludeCurrentPeriodVolume – Auf „true“ setzen, um eine monatliche Aufschlüsselung zu erhalten

Anwendungsfall 9: Nachverfolgung von Boni und Rabatten

Szenario: Sie haben volumenbasierte Bonusvereinbarungen und möchten Ihren Fortschritt in Richtung der Bonus-Schwellenwerte verfolgen sowie zuvor verdiente Boni einsehen.

Empfohlene API: /transaction-data/v1/volumebasedbonus

Warum diese API: Liefert vollständige Details zu Bonusregeln, zum Verbrauch der aktuellen Periode sowie historische Bonusberechnungen und ermöglicht es Ihnen so, den Einkauf zu optimieren, um die Boni zu maximieren.

Wichtige Parameter:

PayerNumber – Ihr Zahlerkonto
IncludeHistory – Auf „true“ setzen, um vergangene Bonuszahlungen anzuzeigen
IncludeCurrentPeriodVolume – Auf „true“ setzen, um den Fortschritt der aktuellen Periode zu verfolgen

Anwendungsbeispiele

Beispiel 1: Abgerechnete Transaktionen abrufen (einschließlich EV)

Anfrage:

POST /transaction-data/v1/priced

{
  "PageSize": 1,
  "Page": 1,
  "Filters": {
    "ColCoCode": "5",
    "ColCoId": 5,
    "InvoiceStatus": "A",
    "PayerNumber": "DE26685263",
    "AccountId": 29484,
    "AccountNumber": "DE26667080",
    "CardPAN": "7002051006629890645",
    "FromDate": "2022-01-01 00:00:00",
    "ToDate": "2022-01-31 00:00:00",
    "IncludeFees": true
  }
}

Antwort:

{
  "RequestId": "9d2dee33-7803-485a-a2b1-2c7538e597ee",
  "Status": "SUCCESS",
  "Data": [
    {
 "AccountName": "Blue Colour Ltd",
      "AccountId": 29484,
 "AccountNumber": "DE26667080",
      "AccountShortName": "Mathew",
 "Additional1": "GBALLEGO0002452",
 "Additional2": "GBALLEGO0002452",
 "Additional3": "GBALLEGO0002452",
      "Additional4": "GBALLEGO0002452",
 "AllowClearing": "Null",
 "AuthorisationCode": 300796,
 "TransactionStatus": „Y“,
 „DriverName“: „SATTY BHAMRA“,
 „CardExpiryPeriod“: 2204,
 „CardExpiry“: „20220101“,
      "Kartengruppen-ID": 40000,
 "Kartengruppenname": "006240 FIRE BRIGHT SOLUTIONS",
 "Aussteller-Code": 7002,
 "Karten-PAN": "7002053465789891000",
 „ReleaseCode“: 9,
 „CardSequenceNumber“: 617,
 „CardType“: „GB STD FLT NAT SINGLE R9“,
 „ColCoCode": "014",
 "UnitDiscountInvoiceCurrency": -0,0051,
 "ColCoExchangeRate": 0,851858,
 "InvoiceCurrencySymbol": "GBP",
 "CorrectionFlag": true,
 "CRM-Nummer": 10,
 "Kundenland": "Vereinigtes Königreich",
 "Kundenwährungscode": "GBP",
 "Kundenwährungssymbol": "£",
      "Rabatt auf Nettobetrag in Kundenwährung": 0,
 "Effektiver Rabatt in Kundenwährung": -0,22,
 "Effektiver Einheitsrabatt in Kundenwährung": -0,0051,
 "Einheitspreis in Rechnungswährung": 1,1024,
 „Rechnungssteuer“: 0,
 „Rechnungsbruttobetrag“: 57,25,
 „Rechnungsnettobetrag“: 47,71,
 „MwSt. auf den Nettobetrag in Kundenwährung“: 9,54,
 „Brutto-Einzelhandelspreis pro Einheit für den Kunden“: 0,
 „Brutto-Gesamtwert des Einzelhandelspreises für den Kunden“: 57,52,
      "Kunden-Verkaufswert gesamt netto": 47,93,
 "Transaktionsart-Beschreibung": 9,59,
 "Rabatt auf Nettobetrag in Transaktionswährung": -0,22,
 „Effektiver Rabatt in Transaktionswährung“: -0,22,
 „Wechselkurs von Landeswährung zu Kundenwährung“: 0,
 „Karten“: [
        275549
 ],
 „Einheitsrabatt in Transaktionswährung“: -0,005,
 „Transaktionsbruttobetrag“: 57,25,
 „Transaktionsnettbetrag“: 47,71,
 „Transaktionssteuer“: 9,54,
 „VATonNetAmount“: 9,54,
 „DelcoListPriceUnitNet“: 0,
 „DelcoRetailPriceUnitGross“: 1,32888,
      "Stückpreis in Transaktionswährung": 1,1074,
 "Delco-Einzelhandelspreis pro Einheit netto": 1,1074,
      "Delco-Verkaufswert gesamt (brutto)": 57,52,
 "Delco-Verkaufswert gesamt (netto)": 47,93,
 "Transaktionswährungssymbol": "$",
 "Rabattart": 1,
 "Streitfallstatus": false,
 „IsShellSite“: false,
 „FleetIdInput“: „YG67OUM“,
 „IncomingProductCode“: 23,
 „PostingDate“: „20210802",
 "Buchungszeit": "14:15:22",
 "Produktcode": 30,
 "Produktname": "Bleifrei – mittlere Oktanzahl",
 "Produktgruppen-ID": 22,
      "IncomingCurrencyCode": "GBP",
 "IncomingSiteDescription": "Shell Broadway Ring",
 "Location": "Shell Broadway Ring",
      "Standortname": "Shell Broadway Ring",
 "Standortcode": 32,
 "EingehendeStandortnummer": 15,
 "Rechnungswährungscode": "GBP",
      "Rechnungsdatum": "20210802",
 "Rechnungsnummer": 3201016193,
 "Kraftstoffprodukt": true,
 "Mehrwertsteuer anwendbar": "Y",
      "Name des Zahlers": "Colours Services Ltd",
 "Zahlernummer": "GB12121212",
 "Übergeordnete Kundennummer": "GB12121212",
 "Zahlergruppe": "H312066",
      "Name der Zahlergruppe": "12162566 – FUEL CARD SERVICE",
 "Prüfziffer": 6,
 "Netto-Rechnungskennzeichen": "Y",
      "DelcoCode": 5,
 "NetworkCode": 3,
 "PurchasedInCountry": "Vereinigtes Königreich",
 "SiteCountry": "Vereinigtes Königreich",
 "VATCountry": "Vereinigtes Königreich",
      "DelcoName": "Shell U.K. Oil Products Limited",
 "Network": "Shell",
 "OdometerInput": 0,
 "OriginalSalesItemId": "Null",
      "Flotten-ID-Beschreibung": "YG67OUM",
 "ÜbergeordneteKunden-ID": 6494,
 "PIN-Kennzeichen": "Y, N",
 "Produktgruppenbezeichnung": "Gebühren",
 "Land des Kaufs (Code)": "GB",
 "Quantity": 43,28,
 "RebateRate": 0,0022,
 "ReceiptNumber": 6803,
 "RefundFlag": „Y“,
 „Standortgruppen-ID“: 202,
 „Standortgruppenname“: „CZ 9100 ECONOMY NETWORK“,
 „Breitengrad“: 53,83606,
      "Longitude": -1,61854,
 "DelCoExchangeRate": 0,851858,
 "EuroRebateAmount": -0,258259,
      "Nettobetrag in Euro": 56,01,
 "Euro-MwSt.-Betrag": 11,2,
 "Name des übergeordneten Kunden": "FUEL CARD SERVICES LTD",
 "Wurde in Rechnung gestellt": false,
 "Währungscode der Transaktion": "GBP",
 „CreditDebitCode“: „D oder C“,
 „TransactionDate“: „20210801“,
 „TransactionTime“: „12:16:58",
 „TransactionItemId“: „H305908971030“,
 „TrnIdentifier“: „H305908971030“,
 „Type“: „SALE“,
      "TransactionLine": 1,
 "TransactionType": "Kauf",
 "UTCOffset": "Europe/London",
 "VATCategory": "Standard-Mehrwertsteuersatz des Vereinigten Königreichs",
 "VATRate": 0,2,
 "VehicleRegistration": "YG67OUM",
 "IsCancelled": "Y",
 "ColCoGrossAmount": 57,25,
      "ColCoNetAmount": 47,71,
 "ColCoVATAmount": 9,54,
 "OriginalCurrencySymbol": "$",
 "OriginalCurrencyCode": "$",
      "OriginalVATAmount": 0,
 "EmbossText": "PARKLANE PROPERTIES LTD",
 "OriginalExchangeRate": 0,
 "OriginalTransactionItemInvoiceDate": "20220202",
      "Gebührenart-ID": 1,
 "Positionsbeschreibung": true,
 "Gebührenregelbeschreibung": "Einfache Gebühr",
 "Häufigkeit": 1,
 "Gebührenregel-ID": 1,
 "Systemerfassungsdatum": "20210828",
 "SystemEntryTime": "20:21:08",
 "IsManual": "Y",
 "OriginalTransactionItemId": "Y",
      "OriginalTransactionItemInvoiceNumber": 6750802,
 "OriginalTransactionItemInvoiceId": 234,
 "PayerShortName": "FUEL CARD SERVICES LTD",
 "ReverseCharge": "Y",
 „OriginalGrossAmount“: 57,25,
 „OriginalNetAmount“: 57,25,
 „UnitOfMeasure“: „L“,
 „RoadType“: „National Road“,
 „CustomerCountryIsoCode": "DE",
 "EVOperator": "Shell Recharge",
 "EVSerialId": "GBALLEGO0002452",
 "EVChargePointSerial": "GBALLEGO0002452",
 „EVChargePointConnectorType“: 5,
 „EVChargePointConnectorTypeDescription“: „DC 50 kW“,
 „EVChargeDuration“: „PT3205S“,
      "EVChargeStartDate": "2021-08-01",
 "EVChargeStartTime": "20:08:01",
 "EVChargeEndDate": "2022-08-01",
 "EVChargeEndTime": "20:08:01",
 "HostingCollectingCompanyNumber": 0,
 "TransactionId": 0,
 "FuelOnly": true,
 "EVPrintedNumber": "ZZ2WJ53ZZ5",
 "IsRFID": true
    }
  ],
  "Page": 3,
  "PageSize": 30,
  "TotalPages": 5
}

Beispiel 2: Details zu Kraftstofftransaktionen abrufen

Anfrage:

POST /transaction-data/v1/pricedtransaction

{
  "Filters": {
    "ColCoCode": 14,
    "InvoiceStatus": "A",
    "PayerId": 12345,
    "PayerNumber": "NL10042616"
  },
  "Page": 1,
  "PageSize": 50
}

Antwort:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Data": [
    {
 "Transactions": [
 {
 "Type": "SalesItem /FeeItem",
 "CardId": 0,
 "CardPAN": "7002051006629891000",
 "CardExpiry": "2026-06-16",
 "TransactionDate": "2026-06-16",
          "Transaktionszeit": "Zeichenkette",
 "UTC-Offset": "Zeichenkette",
 "Flotten-ID (Eingabe)": "XYZ1234",
          "OdometerInput": 12345,
 "DriverName": "ANDREW GILBERRY",
 "VehicleRegistration": "MV65YLH",
 "InvoiceCurrencyCode": "GBP",
          "Rechnungswährungssymbol": "$",
 "Transaktionswährungscode": "GBP",
 "Transaktionswährungssymbol": "$",
 "Transaktions-Nettobetrag": 0,
 "Transaktionssteuer": 0,
 "Transaktions-Bruttobetrag": 0,
 "Rechnungs-Nettobetrag": 0,
 "Rechnungssteuer": 0,
 „Rechnungsbruttobetrag“: 0,
 „Kaufland“: „Deutschland“,
 „Konto-ID“: 29484,
 „Kontonummer“: „GB99215176“,
          "Kontoname": "MATTHEW ALGIE & COMPANY LIMITED",
 "Kontoname (Kurzform)": "Zeichenkette",
 "Menge": 0,
          "Kraftstoffprodukt": true,
 "Stückpreis in Transaktionswährung": 0,
 "Stückpreis in Rechnungswährung": 0,
          "Einheitsrabatt in Transaktionswährung": 0,
 "Einheitsrabatt in Rechnungswährung": 0,
 "Ist in Rechnung gestellt": true,
 "Rechnungsnummer": „S04500493“,
 „Rechnungsdatum“: „Zeichenkette“,
 „Standortcode“: „050001 -\tCHARNOCK RICHARD NTHBOUND MWSA 0755“,
          "Standortname": "050001 -\tCHARNOCK RICHARD NTHBOUND MWSA 0755",
 "Standortland": "Deutschland",
 "Standort": {
            "Breitengrad": "37.4224764",
 "Längengrad": "122.0842499"
 },
 "Kartengruppenname": "006240 FIRE BRIGHT SOLUTIONS",
 "Belegnummer": "1234",
 "Produktcode": "10 – TMF-Gebühren",
 "Produktname": "Bleifrei – Hohe Oktanzahl",
          "ProductGroupId": 1,
 "ProductGroupName": "Übergeordnete Produktgruppe",
 "DelCoExchangeRate": 0,
 "ColCoExchangeRate": 0,
 "IsShellSite": true,
 "Network": "100013\tSTEINDORFER",
 „Standortgruppen-ID“: 202,
 „Standortgruppenname“: „CZ 9100 ECONOMY NETWORK“,
 „Buchungsdatum“: „Zeichenkette“,
 „Aussteller-Code“: „7002“,
          "PurchasedInCountryCode": "NL",
 "CustomerCountryCode": "NL",
 "CustomerCountry": "Niederlande",
 "ReleaseCode": "8",
 "CardGroupId": "Zeichenkette",
 "CardSequenceNumber": "2",
 "Prüfziffer": "Zeichenkette",
 "Flotten-ID-Beschreibung": "Zeichenkette",
 "Mehrwertsteuersatz": "0,20 für 20 %",
 "Mehrwertsteuerkategorie": "1 – Nullsatz",
          "MwSt. auf Nettobetrag": 0,
 "MwSt.-Land": "Niederlande",
 "Effektiver Rabatt in Transaktionswährung": 0,
          "TransactionType": "Kauf bei Vorlage der Karte, andernfalls leer",
 "PINIndicator": "„PIN verwendet“",
 "VATApplicable": "Y",
 "NetInvoiceIndicator": "Y",
          "Kundenwährungscode": "GBP",
 "Kundenwährungssymbol": "£",
 "Effektiver Einheitsrabatt in Kundenwährung": 0,
 "Effektiver Rabatt in Kundenwährung": 0,
 "MwSt. auf Nettobetrag in Kundenwährung": 0,
 „DiscountType“: „2 Pence pro Einheit“,
 „TransactionStatus“: „U“,
 „SalesItemId“: 18315958002,
 „PayerGroup“: „Zeichenkette“,
 „PayerGroupName“: „12119008 – SHELL GROUP OF COMPANIES“,
 „RefundFlag“: „Zeichenkette“,
 „OriginalSalesItemId“: „Zeichenkette“,
 „DelcoName“: „SHELL NEDERLAND VERKOOPMAATSCHAPPIJ BV“,
          "DelcoCode": "14",
 "PayerNumber": "NL10042616",
 "PayerName": "V.M. LE COMTE",
 "CardExpiryPeriod": "1901",
 "AuthorisationCode": "1011256",
 "TransactionId": "io9KVXk1UkW57XWKyeaHHg",
 „TransactionLine“: „1“,
 „AllowClearing“: „Y“,
 „CRMNumber“: „Zeichenkette“,
 „DisputeStatus“: „Keine Beanstandung“,
          "Rabattquote": 28,279,
 "WechselkursDelCoToColCo": 1,
 "Nettobetrag in Euro": 0,
 "MwSt.-Betrag in Euro": 0,
          "ParentCustomerNumber": "Zeichenkette",
 "ParentCustomerName": "Zeichenkette",
 "ParentCustomerId": 0,
 "IncomingSiteNumber": "100021",
          "Beschreibung des empfangenden Standorts": "HN3 INTI_02-82.02",
 "Währungscode des Empfängers": "GBP",
 "IncomingProductCode": "30",
 "CreditDebitCode": "D",
 "CorrectionFlag": "Y",
 "Additional1": "Zeichenkette",
 "Zusatzangabe2": "Zeichenkette",
 "Zusatzangabe3": "Zeichenkette",
 "Zusatzangabe4": "Zeichenkette",
 „Rabatt auf Nettobetrag in Kundenwährung“: -0,735,
 „Rabatt auf Nettobetrag in Transaktionswährung“: „AVEE PTUAZONW CUBFAO COSFS“,
 „TrnIdentifier“: „Zeichenkette“,
          "Kartentyp": "Zeichenkette",
 "Delco-Listenpreis-Einheit netto": 30,5,
 "Delco-Verkaufspreis-Einheit netto": 1,921,
 „DelcoRetailPriceUnitGross“: 0,
 „DelcoRetailValueTotalNet“: 0,
 „DelcoRetailValueTotalGross“: 0,
          "CustomerRetailPriceUnitGross": 0,
 "CustomerRetailValueTotalNet": 0,
 "EVPrintedNumber": "3792",
 "IsRFID": true,
 "TokenTypeDescription": "Zeichenkette"
 }
 ]
    }
  ],
  "Page": 1,
  "PageSize": 1,
  "TotalPages": 15
}

Beispiel 3: Zusammenfassung der Transaktionen mit Preis abrufen

Anfrage:

POST /transaction-data/v1/pricedtransactionssummary

{
    "Filters": {
 "ColCoCode": 9,
 "PayerId": 12,
 "InvoiceStatus": "A",
 "FromDate": "2024-03-20",
 "ToDate": "2024-09-17",
 „PurchasedInCountryCode“: „AT“
    }
}

Antwort:

{
  „RequestId“: „2b0cbe11-f109-4c43-9201-49af0370df1c",
  "Status": "SUCCESS",
  "Data": [
    {
 "ProductId": 1234,
      "ProductCode": "10",
 "ProductName": "Diesel AGO",
 "ProductGroupId": 1,
 "ProductGroupName": "Kraftstoffe",
 "TotalFuelQuantity": 1250,75,
      "Gesamtnettobetrag": 5420,50,
 "Gesamtbruttobetrag": 6504,60,
 "Rechnungswährungscode": "GBP",
 "Rechnungswährungssymbol": "£",
      "CustomerRetailValueTotalNet": 5420,50,
 "Gesamtbruttowert für Kunden": 6504,60
    }
  ]
}

Beispiel 4: Preisübersicht abrufen

Anfrage:

 POST /transaction-data/v1/pricedsummary
    
    {
  "Filters": {
    "ColCoCode": 86,
    "PayerNumber": "GB000000123",
    "CardId": 275549,
    "FromDate": "20240225",
    "ToDate": "20240225",
    "FuelOnly": false
  }
}

Antwort:

{
    "RequestId": "5f1bded6-416d-4478-ab7f-33905d7b5d4b",
    "Status": "SUCCESS",
    "Data": [
 {
 "CustomerRetailValueTotalGross": 114,13,
 "CustomerRetailValueTotalNet": 95,11,
 "InvoiceCurrencyCode": "EUR",
 "Rechnungswährungssymbol": "€",
 "Produktcode": "21",
 "Produktgruppen-ID": 3,
 "Produktgruppenname": "Motorenbenzin",
 "Produkt-ID": 21,
 "Produktname": "Bleifrei – hohe Oktanzahl",
            "Standortgruppen-ID": 104,
 "Standortgruppenname": "Standard-Shell-Tankstellen Österreich",
 "Gesamtkraftstoffmenge": 17,0,
            "Gesamtbruttobetrag": 114,13,
 "Gesamtnettobetrag": 95,11
 }
    ]
}

Beispiel 5: Transaktionen mit mehreren Zahlern abrufen

Anfrage:

POST /transaction-data/v1/multipayerspricedtransactions

{
  "ColCoCode": 86,
  "Accounts": [
    {
 "PayerId": 12345,
      "PayerNumber": "GB987654322"
    },
    {
 "PayerId": 12346,
      "PayerNumber": "GB000000124"
    }
  ],
  "InvoiceStatus": "A",
  "FromDate": "20220101",
  "ToDate": "20220131",
  "PageSize": 50,
  "Page": 1
}

Antwort:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Data": [
    {
 "Transactions": [
 {
 "Type": "SalesItem"
 }
 ],
 "CardId": 275549,
      "CardPAN": "7002051006629891000",
 "CardExpiry": "20250812",
      "Transaktionsdatum": "20250812",
 "Transaktionszeit": "14:30:45",
 „UTCOffset“: „+01:00:00“,
 „FleetIdInput“: „XYZ1234“,
 „OdometerInput“: 12345,
      "DriverName": "ANDREW GILBERRY",
 "VehicleRegistration": "MV65YLH",
 "InvoiceCurrencyCode": "GBP",
 "InvoiceCurrencySymbol": "£",
 "TransactionCurrencyCode": "GBP",
 "TransactionCurrencySymbol": "£",
 "TransactionNetAmount": 47,71,
      "Transaktionssteuer": 9,54,
 "Transaktionsbruttobetrag": 57,25,
      "Rechnungs-Nettobetrag": 47,71,
 "Rechnungs-Steuer": 9,54,
 "Rechnungs-Bruttobetrag": 57,25,
 "Kaufland": "Deutschland",
 "Kontonummer": 29484,
 „Kontonummer“: „GB99215176“,
 „Kontoname“: „MATTHEW ALGIE & COMPANY LIMITED",
 „Konto-Kurzname“: „MATTHEW“,
 „Menge“: 43,28,
 „Kraftstoffprodukt“: true,
 „Einheitspreis in Transaktionswährung“: 1,1074,
      "Stückpreis in Rechnungswährung": 1,1024,
 "Einheitsrabatt in Transaktionswährung": -0,005,
 "Einheitsrabatt in Rechnungswährung": -0,0051,
 "In Rechnung gestellt": true,
 "Rechnungsnummer": "S04500493",
 "Rechnungsdatum": "20250815 09:30:00",
 "Standortcode": "050001",
 "Standortname": "CHARNOCK RICHARD NTHBOUND MWSA 0755",
 "Standortland": "Deutschland",
 "Standort": {
 "Breitengrad": "53.83606",
 "Längengrad": "-1.61854"
 },
      "Kartengruppenname": "006240 FIRE BRIGHT SOLUTIONS",
 "Belegnummer": "6803",
 "Produktcode": "10",
      "ProductName": "Bleifrei – Hohe Oktanzahl",
 "ProductGroupId": 2,
 "ProductGroupName": "Alle Kraftstoffe",
 "DelCoExchangeRate": 0,851858,
      "ColCoExchangeRate": 0,851858,
 "IsShellSite": true,
 "Network": "SHELL",
 "SiteGroupId": 202,
 "SiteGroupName": "CZ 9100 ECONOMY NETWORK",
 „PostingDate“: „20250812 14:30:45“,
 „IssuerCode“: „7002“,
 „PurchasedInCountryCode“: "DE",
 "CustomerCountryCode": "NL",
 "CustomerCountry": "Niederlande",
 "ReleaseCode": "8",
 "CardGroupId": "40000",
 "CardSequenceNumber": "617",
      "Prüfziffer": "6",
 "Flotten-ID-Beschreibung": "YG67OUM",
 "Mehrwertsteuersatz": 0,2,
 "Mehrwertsteuerkategorie": "1-Standardsteuersatz",
      "MwSt. auf Nettobetrag": 9,54,
 "MwSt.-Land": "Niederlande",
      "EffectiveDiscountInTrxCurrency": -0,22,
 "TransactionType": "Kauf",
 "PINIndicator": "PIN verwendet",
 "VATApplicable": "Y",
 "NetInvoiceIndicator": "N",
 "Kundenwährungscode": "GBP",
 "Kundenwährungssymbol": "£",
 "Effektiver Einheitsrabatt in Kundenwährung": -0,0051,
      "Effektiver Rabatt in Kundenwährung": -0,22,
 "MwSt. auf Nettobetrag in Kundenwährung": 9,54,
      "Rabattart": "2 Pence pro Einheit",
 "Transaktionsstatus": "I",
 "Verkaufsartikel-ID": 18315958002,
      "Zahlergruppe": "H312066",
 "Name der Zahlergruppe": "12119008 – SHELL GROUP OF COMPANIES",
 "Rückerstattungsflag": "N",
 "Ursprüngliche Verkaufsartikel-ID": null,
      "DelcoName": "SHELL NEDERLAND VERKOOPMAATSCHAPPIJ BV",
 "DelcoCode": "014",
 "PayerNumber": "GB987654322",
      "PayerName": "V.M. LE COMTE",
 "CardExpiryPeriod": "2504",
 "AuthorisationCode": "011256",
      "TransactionId": "io9KVXk1UkW57XWKyeaHHg",
 "TransactionLine": "1",
 "AllowClearing": "Y",
 "CRMNumber": null,
      "Streitfallstatus": "Kein Streitfall",
 "Rabattquote": 28,279,
 "Wechselkurs zwischen Abrechnungs- und Erfassungswährung": 1,
 "Nettobetrag in Euro": 56,01,
      "Euro-MwSt.-Betrag": 11,2,
 "Übergeordnete Kundennummer": "GB12121212",
 "Name des übergeordneten Kunden": "FUEL CARD SERVICES LTD",
 "ParentCustomerId": 6494,
 "IncomingSiteNumber": "100021",
 "IncomingSiteDescription": "HN3 INTI_02-82.02",
 "IncomingCurrencyCode": "GBP",
 "IncomingProductCode": "30",
 "CreditDebitCode": "D",
 "CorrectionFlag": "N",
 "Additional1": "GBALLEGO0002452",
 "Additional2": null,
 "Additional3": null,
 „Additional4“: null,
 „Rabatt auf Nettobetrag in Kundenwährung“: -0,735,
 „Rabatt auf Nettobetrag in Transaktionswährung“: -0,735,
 „TrnIdentifier“: „H305908971030“,
 „CardType“: „GB STD FLT NAT SINGLE R9“,
      "Delco-Listenpreis-Einheit netto": 30,5,
 "Delco-Verkaufspreis-Einheit netto": 1,1074,
 "Delco-Verkaufspreis-Einheit brutto": 1,32888,
      "DelcoRetailValueTotalNet": 47,93,
 "DelcoRetailValueTotalGross": 57,52,
 "CustomerRetailPriceUnitGross": 1,32888,
 „CustomerRetailValueTotalNet“: 47,93,
 „EVPrintedNumber“: „3792“,
 „IsRFID“: true,
 „TokenTypeDescription“: „Fleet Card“
    }
  ],
  "Page": 1,
  "PageSize": 20,
  "TotalPages": 15,
  "TotalRecords": 300
}

Beispiel 6: Mengenabhängige Preisregeln abrufen

Anfrage:

POST /transaction-data/v1/volumebasedpricing

{
  "ColCoId": 1,
  "ColCoCode": 86,
  "PayerId": 12345,
  "PayerNumber": "GB000000123",
  "IncludeHistory": true,
  "IncludeCurrentPeriodVolume": true
}

Antwort:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Data": [
    {
      "Configuration": [
 {
 "PricingAccountId": 123456,
 "PricingAccountNumber": "GB000000123",
          "PricingAccountShortName": "ABCD1234",
 "PricingAccountFullName": "ABCD1234",
 "FeeRuleId": 12345,
 „FeeRuleDescription“: „NL/GAGO/D018/UP0.0120>1“,
 „FeeRuleDateEffective“: „20231223“,
 „FeeRuleDateTerminated“: „20231223",
 „BonusPaidTo“: „1-Pay to Payer“,
          "BonusPaidToAccountId": 123456,
 "BonusPaidToAccountNumber": "GB000000123",
 "BonusPaidToAccountShortName": "12345",
          "BonusPaidToAccountFullName": "GB000000123",
 "Frequency": "3-Wöchentlich – Montag",
 "NextCalculationDate": "20231223",
 "PreviousCalculatedDate": "23.12.2023",
 "FeeRuleBasis": "3-Pauschalbetrag",
 "FeeRuleCurrencyCode": "GBP",
 "FeeRuleCurrencySymbol": "£",
          "Gebührenregel-Gültig-Ab": "20231223",
 "Gebührenregel-Gültig-Bis": "20231223",
 "Gebührenregel-Standorte": [
 {
 "Delco-ID": 866,
              "Country": "Vereinigtes Königreich",
 "CountryCode": "UK",
 "FuelNetworkId": 100007,
 "NetworkName": "VALERO",
 "SiteGroupId": 100007,
              "Standortgruppenbezeichnung": "VALERO ENERGY LTD",
 "Standortcode": 999493,
              "Standort-ID": 100007,
 "Standortname": "VALERO ENERGY LTD"
 }
 ],
 "Gebührenregel-Produkte": [
 {
              "ProductGroupID": 3,
 "ProductGroupName": "Motorenbenzin",
 "ProductCode": "30 für Diesel AGO",
 "ProductId": "30 für Diesel AGO",
 "ProductName": "Diesel AGO"
 }
          ],
 „FeeRuleTiers“: [
 {
 „TierMinimum“: 1234,
 „TierMaximum“: 1234,
 „Value“: 1234,12
 }
          ]
 }
 ],
 „CurrentPeriodConsumption“: [
 {
 „FeeRuleId“: 12345,
 „FeeRuleDescription“: "NL/GAGO/D018/UP0.0120>1",
 "Preisregel-ID": 100005,
          "PriceRuleDescription": "PL/GAGO/GMOT/UL0.055",
 "TotalVolume": 10000,78,
 "NextFeeCreationDate": "20231223"
 }
 ],
 "History": [
 {
 "FromDate": "20231223",
 "ToDate": "20231223",
 "FeesRuleID": 8081,
 "FeesRuleDescription": "PT/P067/D120/P4.0",
 "Gesamtvolumen": 12356,66
 }
 ],
      "Warnungen": [
 {
 "Meldung": "Das System ist wegen einer Aktualisierung nicht verfügbar.",
 "Typ": "Systemausfall"
 }
 ]
    }
  ]
}

Beispiel 7: Abfrage volumenbasierter Bonusregeln

Anfrage:

POST /transaction-data/v1/volumebasedbonus

{
  "ColCoId": 1,
  "ColCoCode": 86,
  "PayerId": 12345,
  "PayerNumber": "GB000000123",
  "IncludeHistory": true,
  "IncludeCurrentPeriodVolume": true
}

Antwort:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Data": [
    {
 "Configuration": [
 {
 "PricingAccountId": 123456,
          "PricingAccountNumber": "GB000000123",
 "PricingAccountShortName": "MATTHEW",
 "PricingAccountFullName": "MATTHEW",
 "FeeRuleId": 1,
          "Gebührenregelbeschreibung": "NL/GAGO/D018/UP0.0120>1",
 "Gebührenregel-Gültigkeitsdatum": "20231223",
 "Gebührenregel-Ablaufdatum": "20231223",
          "BonusPaidTo": "1-Zahlung an den Zahler",
 "BonusPaidToAccountId": 123456,
 "BonusPaidToAccountNumber": "GB000000123",
          "BonusPaidToAccountShortName": "12345",
 "BonusPaidToAccountFullName": "GB000000123",
          "Frequenz": "3-wöchentlich – Montag",
 "NächstesBerechnungsdatum": "20231223",
 "VorherigesBerechnungsdatum": "20231223",
 "Gebührenregelgrundlage": "3-Einmalzahlung",
 "FeeRuleCurrencyCode": "GBP",
 "FeeRuleCurrencySymbol": "£",
 "FeeRuleAvailableFrom": "20231223",
          "Gebührenregel gültig bis": "20231223",
 "Standorte der Gebührenregel": [
 {
              "DelcoId": 866,
 "Country": "Vereinigtes Königreich",
 "CountryCode": "UK",
 "FuelNetworkId": 100007,
 "Netzwerkname": "VALERO",
 "Standortgruppen-ID": 100007,
 "Standortgruppenname": "VALERO ENERGY LTD",
 "Standortcode": 999493,
 "Standort-ID": 100007,
 "Standortname": "VALERO ENERGY LTD"
 }
 ],
 "Gebührenregel-Produkte": [
 {
 "Produktgruppen-ID": 3,
              "ProductGroupName": "Motorenbenzin",
 "ProductCode": "30 für Diesel AGO",
 "ProductId": "30 für Diesel AGO",
 "ProductName": "Diesel AGO"
 }
 ],
          "FeeRuleTiers": [
 {
 "TierMinimum": 1234,
 "TierMaximum": 1234,
 "Value": 1234,12
            }
 ],
 „AssociatedAccounts“: [
 {
 „AssociatedAccountId“: 12345,
 „AssociatedAccountNumber“: „GB000000123“,
 „AssociatedAccountShortName“: „Kurzname des Kontos“,
              "AssociatedAccountFullName": "Vollständiger Name des Kontos"
 }
 ]
 }
 ],
 "CurrentPeriodConsumption": [
 {
          "Gebührenregel-ID": 12345,
 "Gebührenregelbeschreibung": "NL/GAGO/D018/UP0.0120>1",
          "Monat": 1,
 "Jahr": 2018,
 "Gesamtvolumen": 10000,78
 }
      ],
 „HistoricalBonusPaid“: [
 {
 „PayerId“: 12345,
 „PayerNumber“: „GB000000123“,
          "Kurzname des Zahlers": "Jorden",
 "Vollständiger Name des Zahlers": "MATTHEW",
 "Konto-ID": 123456,
          "Kontonummer": "GB000000123",
 "Kontoname (kurz)": "SALT",
 "Kontoname (vollständig)": "ABCD1234",
 "Rechnungskonto-ID": 12345,
          "Rechnungskontonummer": "GB000000123",
 "Kurzbezeichnung des Rechnungskontos": "DFE1234",
          "Rechnungskonto-Vollname": "AZAD PVT LMT",
 "Gebührenregel-ID": 12345,
 "Gebührenregel-Beschreibung": "NL/GAGO/D018/UP0.0120>1",
          "FromDate": "20231223",
 "ToDate": "20231223",
 "BonusPaidTo": "5 – Auszahlung an verbundene Kunden",
          "Gebührenposten-ID": 12345,
 "Gebührenregel-Grundlage": "2-Prozentsatz des Aufschlags",
 "Gebührenposten-Währungscode": "GBP",
 "Gebührenposten-Währungssymbol": "$",
 "ProratedVolume": 123,12,
 "TotalVolume": 123,12,
 "FeeProduct": "1562-Bonus-Diesel Shell",
          "Rechnungsbruttobetrag": 123,12,
 "Rechnungsnettobetrag": 123,12,
          "Rechnungs-MwSt.-Betrag": 123,12,
 "Gebühr storniert": true,
 "Gebührenposition-Stufen-anteilig berechnetes Volumen": 123,12,
 "Gebührenposition-Stufen-Gesamtvolumen": 123,12,
          "Mindestmenge der Stufe": 123,
 "TierRate": 123,12
 }
 ]
    }
  ],
  "Warnungen": [
    {
 "Meldung": "Das System ist wegen einer Aktualisierung nicht verfügbar.",
 "Typ": "Systemausfallage“
    }
  ]
}

Beispiel 8: Gebührenübersicht abrufen

Anfrage:

POST /transaction-data/v1/feessummary

{
  "ColCoId": 1,
  "ColCoCode": 86,
  "PayerId": 12345,
  "PayerNumber": "GB000000123",
  "CardId": 275549,
  "InvoiceStatus": "I",
  "FromDate": "20240101",
  "ToDate": "20240131",
  "FeeTypeGroup": "Kartengebühren"
}

Antwort:

{
  "RequestId": "2b0cbe11-f109-4c43-9201-49af0370df1c",
  "Status": "SUCCESS",
  "Data": [
    {
 "FeeTypeGroup": "Kartengebühren",
 "FeeTypeId": 1,
 "FeeType": "Kartenjahresgebühr",
 "ProductId": 1234,
      "ProductCode": "FEE",
 "ProductName": "Kartengebühr",
 "TotalFeeAmount": 125,00,
 "InvoiceCurrencyCode": "GBP",
 "InvoiceCurrencySymbol": "£"
    }
  ]
}

Beispiel 9: Transaktionsausnahmen abrufen

Anfrage:

POST /transaction-data/v1/exceptions

{
  "ColCoId": 1,
  "ColCoCode": 86,
  "PayerId": 12345,
  "PayerNumber": "GB000000123",
  "TransactionsFromDate": "20231223",
  "TransactionsToDate": "20240131",
  "Value": 100,
  "Condition": 5,
  "OutputType": "Transaction"
}

Antwort:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Data": [
    {
 "CardsExceptions": [
        {
 „AccountId“: 29484,
 „CardId“: 1234,
 „PAN“: „ABCD1234“,
 „DriverName“: „ANDREW GILBERRY“,
 „VRN“: „34235“,
 „PayerId“: 123455,
 „PayerNumber“: „GB000000123“,
          "Kontonummer": "GB99215176",
 "Konto-Kurzname": "MATTHEW",
 "Zahler-Kurzname": "MATTHEW",
 "Tag": 2,
 "Woche": 2,
          "Monat": 5,
 "Jahr": 2017,
 "Gesamtzahl der Transaktionen": 4,
 "Gesamtzahl der Verkaufsartikel": 4,
 "Gesamtmenge": 261,
          "Gesamtbetrag": 100,21,
 "Währungscode": "GBP",
 "Währungssymbol": "$"
 }
 ],
 "Transaktionsausnahmen": [
 {
 "Verkaufsartikel-ID": 18315958002,
 „Karten-ID“: 1234,
 „Artikel-ID“: 2,
 „TransactionGUID“: „ABCD1234“,
 „TransactionDate“: „20231223“,
 „CustomerInvoiceValueTotalGross“: 123,12,
 „CardPAN“: „7002051006629891000",
 „CardExpiry“: „20311223 12:12:12“,
 „TransactionTime“: „12:12:12",
 „UTCOffset“: „+12:12:12“,
 „FleetIdInput“: "XYZ1234",
 "OdometerInput": 1234,
 "DriverName": "SALT",
 "VehicleRegistration": "MV65YLH",
 "InvoiceCurrencyCode": "GBP",
          "Rechnungswährungssymbol": "$",
 "Transaktionswährungscode": "GBP",
          "Transaktionswährungssymbol": "£",
 "Transaktionsnettobetrag": 123,12,
 "Transaktionssteuer": 123,12,
 "Transaktionsbruttobetrag": 123,12,
          "Rechnungs-Nettobetrag": 123,12,
 "Rechnungs-Steuer": 123,12,
 "Rechnungs-Bruttobetrag": 123,1,
 "Kaufland": "Frankreich",
 "Kontonummer": 1234,
 „Kontonummer“: „GB99215176“,
          "Kontoname": "MATTHEW ALGIE & COMPANY LIMITED",
 "Kontoname (Kurzform)": "MATTHEW ALGIE & COMPANY LIMITED",
 "Menge": 123,12,
          "FuelProduct": true,
 "UnitPriceInTransactionCurrency": 123,12,
          "Stückpreis in Rechnungswährung": 123,12,
 "Stückrabatt in Transaktionswährung": 123,12,
 "Stückrabatt in Rechnungswährung": 123,12,
 "„IsInvoiced“: true,
 „InvoiceNumber“: „S04500493“,
 „InvoiceDate“: „20231223“,
          "Standortcode": "50001",
 "Standortname": "CHARNOCK RICHARD NTHBOUND MWSA 0755",
 "Standortland": "Deutschland",
          "Standort": {
 "Breitengrad": "37.4224764",
 "Längengrad": "122.0842499"
 },
 "Kartengruppenname": "006240 FIRE BRIGHT SOLUTIONS",
          "ReceiptNumber": "1234",
 "ProductCode": "TMF-Gebühren",
 "ProductName": "Bleifrei – hohe Oktanzahl",
 "ProductGroupId": 1234,
          "ProductGroupName": "Übergeordnete Produktgruppe",
 "DelCoExchangeRate": 123,12,
 "ColCoExchangeRate": 123,12,
 „IsShellSite“: true,
 „Network“: „Shell PH“,
 „SiteGroupId“: 202,
 „SiteGroupName": "CZ 9100 ECONOMY NETWORK",
 "PostingDate": "20231223 12:12:12",
 "IssuerCode": "7077 = CRT",
          "PurchasedInCountryCode": "NL",
 "CustomerCountryCode": "NL",
 "CustomerCountry": "Niederlande",
 "ReleaseCode": "8 für 702188",
 "CardGroupId": "200",
 „CardSequenceNumber“: „2“,
 „CheckDigit“: „GHE1234“,
 „FleetIDDescription“: „Beispielbeschreibung“,
 „VATRate“: 0,2,
 „VATCategory“: „3 – Mehrwertsteuerbefreit“,
          "MwSt. auf Nettobetrag": 12,21,
 "MwSt.-Land": "Niederlande",
 "Effektiver Rabatt in Transaktionswährung": 0,
 "Transaktionsart": "Kauf bei Vorlage der Karte, sonst leer",
          "PIN-Indikator": "Y",
 "Mehrwertsteuer anwendbar": "Y",
 "Netto-Rechnungsindikator": "Y",
          "Kundenwährungscode": "GBP",
 "Kundenwährungssymbol": "£",
 "Effektiver Einheitsrabatt in Kundenwährung": 123,12,
 "Effektiver Rabatt in Kundenwährung": 123,12,
          "MwSt. auf Nettobetrag in Kundenwährung": 123,12,
          "Rabattart": "3-Prozent",
 "Transaktionsstatus": "U",
 "Zahlergruppe": "12119008",
 "Rückerstattungsflag": "N",
 "ID der ursprünglichen Verkaufsposition": "1231",
          "DelcoName": "SHELL NEDERLAND VERKOOPMAATSCHAPPIJ BV",
 "DelcoCode": "NL10042616",
 "PayerName": "V.M. LE COMTE",
 "CardExpiryPeriod": "1901",
 „AuthorisationCode“: „11256“,
 „TransactionId": "io9KVXk1UkW57XWKyeaHHg",
 "TransactionLine": "1",
 "AllowClearing": "Y",
 "CRMNumber": "ABCD1234",
          "DisputeStatus": "6\tRückbuchung an die Website",
 "RebateRate": 28,279,
 „DelCoToColCoExchangeRate“: 1,
 „NetEuroAmount“: 37,93,
 „EuroRebateAmount“: 0,
          "Euro-MwSt.-Betrag": 7,96,
 "ÜbergeordneteKundennummer": "DRG1234"
        }
 ]
    }
  ]
}

Beispiel 10: Zusammenfassung der Kartennutzung abrufen

Anfrage:

POST /transaction-data/v1/cardusagesummary

{
  "ColCoId": 1,
  "ColCoCode": 86,
  "PayerId": 12345,
  "PayerNumber": "GB000000123",
  "AccountId": 1234,
  "AccountNumber": "GB000000123",
  "CardId": 1234,
  "PAN": "7882861007636000020",
  "CardExpiry": "20311223"
}

Antwort:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Data": [
    {
 „UsageSummary“: [
 {
 „Date“: „20170930“,
 „ProductId“: 1,
          "ProductCode": "2",
 "ProductName": "Diesel AGO",
 "IsFuelProduct": true,
 "SiteGroupId": 1234,
 "SiteGroupName": "UK 9500 MOTORWAY NETWORK",
 "TotalVolume": 123,12,
 "Gesamtbrutto": 123,12,
 "Gesamtnetto": 123,12,
 "Währungscode": "GBP",
 "Währungssymbol": "£",
          "ProductGroupId": 1234,
 "ProductGroupName": "Motorenbenzin"
 }
 ]
    }
  ]
}

Fehlerbehandlung

Häufige Fehlercodes

HTTP-Status	Fehlercode	Beschreibung	Lösung
200	N/A	Status: ERFOLG	k. A.
200	E0001	Validierungsfehler	Anfrageparameter überprüfen
401	E0003	Nicht autorisiert	Überprüfen Sie, ob das OAuth-Token gültig ist
403	E0003	Zugriff verweigert	Überprüfen Sie die Benutzerberechtigungen
404	E0005	Ressource nicht gefunden	Überprüfen Sie, ob die Endpunkt-URL und die Ressource vorhanden sind
500	E0002	Unbekannter Fehler / Interner Serverfehler	Wenden Sie sich an den Support

Bewährte Verfahren

1. OAuth 2.0-Authentifizierung einführen

WICHTIG: Alle Kunden sollten auf die OAuth 2.0-Authentifizierung umsteigen. Implementieren Sie ein ordnungsgemäßes Token-Management:

Cachen Sie Zugriffstoken und wiederverwenden Sie diese bis zum Ablauf
Aktualisieren Sie Token, bevor sie ablaufen (empfohlen: 60 Sekunden vorher)
Speichern Sie Client-Anmeldedaten sicher (verwenden Sie Umgebungsvariablen oder einen Secret Manager)
Protokollieren oder offenlegen Sie Zugriffstoken niemals im clientseitigen Code

2. Verwenden Sie Request-IDs

Fügen Sie stets eine eindeutige RequestId (im GUID-Format) für die lückenlose Rückverfolgbarkeit ein

3. Paginierung implementieren

Bei großen Transaktionsdatensätzen Paginierung verwenden, um Timeouts zu vermeiden:

Angemessene PageSize festlegen (empfohlen: 50–100 Datensätze) fest
Verarbeiten Sie Seiten nacheinander oder parallel
Behandeln Sie „TotalPages“ und „TotalRecords“ in den Antworten

4. Datumsfilter sinnvoll einsetzen

Bei der Abfrage von Transaktionsdaten:

Datumsbereiche einschränken, um große Ergebnismengen zu vermeiden
FromDate- und ToDate-Filter konsequent verwenden
Für eine bessere Leistung eine Abfrage nach Monat oder Woche in Betracht ziehen

5. Testen Sie in einer Sandbox-Umgebung

Testen Sie die Integration immer in der Test-/Sandbox-Umgebung, bevor Sie in die Produktion wechseln

6. Referenzdaten zwischenspeichern

Speichern Sie volumenbasierte Preis- und Bonusregeln im Cache, um API-Aufrufe zu minimieren:

Diese Regeln ändern sich selten
Aktualisieren Sie den Cache regelmäßig (z. B. täglich)
Verwenden Sie den Parameter „IncludeHistory“ nur bei Bedarf

SDK & Code-Beispiele

Shell stellt offizielle SDKs und umfassende Code-Beispiele bereit, um Ihre Integration mit der Transaction Data API zu beschleunigen.

Verfügbare SDK-Sprachen

Python – Voll ausgestattetes SDK mit OAuth 2.0-Unterstützung
TypeScript – Typsicheres SDK mit vollständigen Typdefinitionen
Java – SDK für den Einsatz in Unternehmen
C#/.NET – Vollständige .NET-Integration
PHP – Einfach zu verwendende PHP-Bibliothek
Ruby – Ruby-Gem für nahtlose Integration

Offizielle SDKs und Dokumentation anzeigen

Support und Ressourcen

Technischer Support

Support: Technischer Support von Shell
OAuth 2.0-Migration: Unterstützung bei der OAuth 2.0-Migration

Dokumentation

Hilfe erhalten

Geben Sie bei der Kontaktaufnahme mit dem Support Folgendes an:

Ihre client_id an (geben Sie niemals Ihr client_secret oder Ihre Zugriffstoken weiter)
RequestId aus der API-Antwort
Zeitstempel der Anfrage
Umgebung (Produktion/Test)

Letzte Aktualisierung: 16. Juni 2026
Dokumentversion: 1.0
API-Version: 2.3.4

Wählen Sie Ihre Sprache

Shell B2B Mobility Card Transaction Data API – Schnellstartanleitung

Übersicht

Wichtigste Funktionen

Wichtiger Hinweis – OAuth 2.0

Authentifizierung

OAuth 2.0 (Standard-Authentifizierungsmethode)

OAuth 2.0-Ablauf

Schritt 1: Zugriffstoken abrufen

Schritt 2: Verwenden des Zugriffstokens in API-Anfragen

Token-Verwaltung

Strategie zur Einführung von OAuth 2.0

Warum auf OAuth 2.0 umsteigen?

Sicherheitsvorteile:

Betriebliche Vorteile:

Migrationspfad

Umgebungen

Schnellstart

1. Beziehen Sie Ihre OAuth-Anmeldedaten

2. Beziehen Sie ein Zugriffstoken

cURL-Beispiel:

Antwort:

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

cURL-Beispiel:

Beispielantwort:

API-Endpunkt-Referenz

Preisgebundene Transaktionen

Transaktionsübersichten

Gebührenmanagement

Volumenbasierte Regeln

Ausnahmen

Häufige Anwendungsfälle

Anwendungsfall 1: Täglicher Transaktionsabgleich

Anwendungsfall 2: Rechnungsprüfung und -verifizierung

Anwendungsfall 3: Analyse und Berichterstellung zum Kraftstoffverbrauch

Anwendungsfall 4: Verwaltung mehrerer Fuhrparks

Anwendungsfall 5: Ausnahmemonitoring und Betrugserkennung

Anwendungsfall 6: Gebühren- und Kostenanalyse

Anwendungsfall 7: Nachverfolgung der Ausgaben einzelner Karten

Anwendungsfall 8: Prüfung der Berechtigung für volumenbasierte Preisgestaltung

Anwendungsfall 9: Nachverfolgung von Boni und Rabatten

Anwendungsbeispiele

Beispiel 1: Abgerechnete Transaktionen abrufen (einschließlich EV)

Anfrage:

Antwort:

Beispiel 2: Details zu Kraftstofftransaktionen abrufen

Anfrage:

Antwort:

Beispiel 3: Zusammenfassung der Transaktionen mit Preis abrufen

Anfrage:

Antwort:

Beispiel 4: Preisübersicht abrufen

Anfrage:

Antwort:

Beispiel 5: Transaktionen mit mehreren Zahlern abrufen

Anfrage:

Antwort:

Beispiel 6: Mengenabhängige Preisregeln abrufen

Anfrage:

Antwort:

Beispiel 7: Abfrage volumenbasierter Bonusregeln

Anfrage:

Antwort:

Beispiel 8: Gebührenübersicht abrufen

Anfrage:

Antwort:

Beispiel 9: Transaktionsausnahmen abrufen

Anfrage:

Antwort:

Beispiel 10: Zusammenfassung der Kartennutzung abrufen

Anfrage:

Antwort:

Fehlerbehandlung

Häufige Fehlercodes

Bewährte Verfahren

1. OAuth 2.0-Authentifizierung einführen

2. Verwenden Sie Request-IDs

3. Paginierung implementieren

4. Datumsfilter sinnvoll einsetzen

5. Testen Sie in einer Sandbox-Umgebung