Shell B2B Mobility Card Transaction Data API - Snelstartgids

API-versie: 2.3.4 | Authenticatie: OAuth 2.0 | Status: Productie

Overzicht

De Shell Card Transaction Data API is een op REST gebaseerde API waarmee ontwikkelaars transactiegegevens van Shell-tankkaarten programmatisch kunnen ophalen en analyseren. De API biedt toegang tot geprijsde transacties, kosten, op-gebaseerde prijsstelling, bonusregels, uitzonderingen en overzichten van kaartgebruik.

Opmerking: Deze handleiding behandelt alleen eindpunten die via OAuth 2.0 worden geauthenticeerd (basispad: /transaction-data/v1). Oudere eindpunten met Basic Auth (/fleetmanagement/v1/transaction) zijn niet opgenomen, aangezien deze geleidelijk worden uitgefaseerd.

Belangrijkste functies

Details van geprijsde transacties ophalen, inclusief EV-transacties
Toegang tot brandstoftransactiegegevens met verkoopartikelen en kosten
Transactieoverzichtsgegevens ophalen voor brandstof- en NFR-transacties
Volumebased prijsstelling en bonusregels opvragen
Kostenposten en kostenoverzichtsgegevens ophalen
Toegang tot kaart- en transactie-uitzonderingen
Kaartgebruik en uitgavengegevens
Ondersteuning voor transactiezoekopdrachten met meerdere betalers

Belangrijke mededeling - OAuth 2.0

BELANGRIJK: OAuth 2.0 is nu de standaard authenticatiemethode

Nieuwe integraties: Gebruik OAuth 2.0 vanaf het begin
Bestaande integraties: Plan uw migratie naar OAuth 2.0
Verouderde methoden: Basic Auth wordt geleidelijk afgeschaft

Neem contact op met Shell Technische Ondersteuning om uw OAuth 2.0-inloggegevens (client_id en client_secret) te verkrijgen.

Authenticatie

OAuth 2.0 (standaard authenticatiemethode)

De Shell Card Transaction Data API maakt gebruik van de OAuth 2.0 Client Credentials-flow voor veilige authenticatie.

WAARSCHUWING: Alle klanten moeten plannen maken om over te stappen op OAuth 2.0-authenticatie. Dit is de aanbevolen en toekomstbestendige authenticatiemethode voor de Shell Card Transaction Data API. Oudere authenticatiemethoden worden geleidelijk afgeschaft.

OAuth 2.0-stroom

Stap 1: Verkrijg een toegangstoken

Vraag een toegangstoken aan via het OAuth-token-eindpunt:

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

grant_type=client_credentials&client_id=uw-client-id&client_secret=your-client-secret

Stap 2: Gebruik het toegangstoken in API-verzoeken

Authorization: Bearer 
Content-Type: application/json

Tokenbeheer

Best practices voor tokenbeheer:

Toegangstokens hebben een beperkte geldigheidsduur (meestal 15 minuten)
Implementeer token-caching om onnodige tokenverzoeken te voorkomen
Vernieuw tokens vóór het verstrijken van de geldigheidsduur om een ononderbroken dienstverlening te garanderen
Deel uw client_secret nooit en neem het niet op in client-side code

Strategie voor de invoering van OAuth 2.0

Waarom overstappen op OAuth 2.0?

Beveiligingsvoordelen:

Authenticatieprotocol volgens de industriestandaard
Toegangstokens met beperkte geldigheidsduur verminderen beveiligingsrisico’s
Er worden bij elk verzoek geen inloggegevens verzonden
Betere ondersteuning voor tokenrotatie en -intrekking

Operationele voordelen:

Verbeterde schaalbaarheid en prestaties
Betere monitoring- en auditmogelijkheden
Vereenvoudigd beheer van inloggegevens
Toekomstbestendige integratie

Migratietraject

Als u momenteel verouderde authenticatiemethoden gebruikt, volg dan dit migratietraject:

Vraag OAuth 2.0-inloggegevens aan via Technische ondersteuning van Shell
Implementeer OAuth-tokenbeheer in uw applicatie
Test grondig in de test-/sandbox-omgeving
Voer tijdens de overgang parallelle authenticatie uit (OAuth + verouderde methode) tijdens de overgang
Controleer en valideer de OAuth-integratie
Schakel over naar uitsluitend OAuth zodra de validatie is voltooid
Schakel de verouderde authenticatiemethode uit na succesvolle migratie

Omgevingen

De API is beschikbaar in twee omgevingen:

Omgeving	Basis-URL	Doel
Productie	https://api.shell.com	Live productieomgeving
Test (Sandbox)	https://api-test.shell.com/test	Test- en ontwikkelomgeving

Tip: Test uw integratie altijd in de Testomgeving voordat u naar productie overgaat.

Snel aan de slag

1. Verkrijg uw OAuth-inloggegevens

Neem contact op met de technische ondersteuning van Shell
Vraag OAuth 2.0-inloggegevens (client_id en client_secret) aan
Lees de gebruiksvoorwaarden

2. Verkrijg een toegangstoken

Verkrijg eerst uw OAuth-toegangstoken:

cURL-voorbeeld:

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=your-client-id&client_secret=your-client-secret"

Antwoord:

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

3. Doe je eerste API-verzoek

Voorbeeld: geprijsde transacties ophalen

cURL-voorbeeld:

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

Voorbeeld van een antwoord:

{
  "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": "Verenigd Koninkrijk",
 "CustomerCurrencyCode": "GBP",
 "CustomerCurrencySymbol": "£",
 "RebateonNetAmountInCustomerCurrency": 0,
 "EffectiveDiscountInCustomerCurrency": -0,22,
 "Effectieve eenheidskorting in valuta van de klant": -0,0051,
 "Eenheidsprijs in factuurvaluta": 1,1024,
 "Factuurbelasting": 0,
 "Bruto factuurbedrag": 57,25,
 "Nettobedrag factuur": 47,71,
 "BTW op nettobedrag in valuta van de klant": 9,54,
      "Bruto-eenheidsprijs klant": 0,
 "Bruto totaalverkoopwaarde klant": 57,52,
 "Netto totaalverkoopwaarde klant": 47,93,
      "TransactionTypeDescription": 9,59,
 "RebateonNetAmountInTransactionCurrency": -0,22,
 "EffectiveDiscountInTrxCurrency": -0,22,
      "Wisselkoers van afzender naar ontvanger": 0,
 "Kaarten": [
 275549
 ],
      "UnitDiscountTransactionCurrency": -0,005,
 "TransactionGrossAmount": 57,25,
 "TransactionNetAmount": 47,71,
      "TransactionTax": 9,54,
 "VATonNetAmount": 9,54,
 "DelcoListPriceUnitNet": 0,
 "DelcoRetailPriceUnitGross": 1,32888,
      "Eenheidsprijs in transactievaluta": 1,1074,
 "Delco-verkoopprijs per eenheid netto": 1,1074,
 "Delco-verkoopwaarde totaal bruto": 57,52,
      "DelcoRetailValueTotalNet": 47,93,
      "TransactionCurrencySymbol": "$",
 "DiscountType": 1,
 "DisputeStatus": false,
 "IsShellSite": false,
 "FleetIdInput": "YG67OUM",
 "IncomingProductCode": 23,
 "PostingDate": "20210802",
 "PostingTime": "14:15:22",
 "ProductCode": 30,
 "ProductName": "Loodvrije benzine - gemiddeld octaangehalte",
 "ProductGroupId": 22,
 "IncomingCurrencyCode": "GBP",
      "IncomingSiteDescription": "Shell Broadway Ring",
 "Location": "Shell Broadway Ring",
 "SiteName": "Shell Broadway Ring",
 "SiteCode": 32,
 "IncomingSiteNumber": 15,
 "InvoiceCurrencyCode": "GBP",
      "Factuurdatum": "20210802",
 "Factuurnummer": 3201016193,
      "Brandstofproduct": true,
 "BTW van toepassing": "Y",
 "Naam betaler": "Colours Services Ltd",
 "Betalingsnummer": "GB12121212",
      "ParentCustomerNumber": "GB12121212",
 "PayerGroup": "H312066",
 "PayerGroupName": "12162566 - FUEL CARD SERVICE",
      "Controlecijfer": 6,
 "Nettofactuurindicator": "Y",
 "Delco-code": 5,
 "Netwerkcode": 3,
 "Aankoopland": "Verenigd Koninkrijk",
 "Land van de locatie": "Verenigd Koninkrijk",
      "VATCountry": "Verenigd Koninkrijk",
 "DelcoName": "Shell U.K. Oil Products Limited",
 "Network": "Shell",
 "OdometerInput": 0,
 "OriginalSalesItemId": "Null",
 "FleetIDDescription": "YG67OUM",
 "ParentCustomerId": 6494,
 "PINIndicator": "Y, N",
      "ProductGroupName": "Kosten",
 "PurchasedInCountryCode": "GB",
 "Quantity": 43,28,
 "RebateRate": 0,0022,
 "ReceiptNumber": 6803,
      "RefundFlag": "Y",
 "SiteGroupId": 202,
 "SiteGroupName": "CZ 9100 ECONOMY NETWORK",
 "Latitude": 53.83606,
 "Longitude": -1,61854,
 "DelCoExchangeRate": 0,851858,
 "EuroRebateAmount": -0,258259,
 "NetEuroAmount": 56,01,
      "EuroVATAmount": 11,2,
 "ParentCustomerName": "FUEL CARD SERVICES LTD",
 "IsInvoiced": false,
 "TransactionCurrencyCode": "GBP",
 "CreditDebitCode": "D of C",
 "TransactionDate": "20210801",
 "TransactionTime": "12:16:58",
 "TransactionItemId": "H305908971030",
 "TrnIdentifier": "H305908971030",
 "Type": "SALE",
 "TransactionLine": 1,
 "TransactionType": "Purchase",
 "UTCOffset": "Europe/London",
 "VATCategory": "Standaard btw-tarief Verenigd Koninkrijk",
 "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": "Simple Fee",
 "Frequency": 1,
 "FeeRuleId": 1,
 "SystemEntryDate": "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": "Nationale weg",
 "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": 1,
  "PageSize": 1,
  "TotalPages": 5
}

Referentie API-eindpunten

Transacties met prijs

Eindpunt	Methode	Beschrijving
/transaction-data/v1/priced	POST	Details van transacties met prijs ophalen, inclusief EV-transacties (OAuth 2.0)
/transaction-data/v1/pricedtransaction	POST	Details van brandstoftransacties ophalen, inclusief verkoopartikelen en kosten (OAuth 2.0)
/transaction-data/v1/multipayerspricedtransactions	POST	Details van transactiegegevens met prijs voor meerdere betalers ophalen (OAuth 2.0)

Veelvoorkomende gebruiksscenario’s:

Transacties ophalen op basis van een datumbereik
Filteren op transactiestatus (Goedgekeurd, Afgewezen, enz.)
Zoeken op kaartnummer (PAN) of kenteken
Transacties voor het opladen van elektrische voertuigen ophalen
Transacties voor meerdere betalers opvragen

Transactieoverzichten

Eindpunt	Methode	Beschrijving
/transaction-data/v1/pricedtransactionssummary	POST	Transactieoverzichtsgegevens met prijzen ophalen voor brandstof en NFR, inclusief verkoopartikelen en kosten (OAuth 2.0)
/transaction-data/v1/cardusagesummary	POST	Uitgavenanalyse en gebruiksoverzicht voor een kaart ophalen (OAuth 2.0)

Retourneert:

Geaggregeerde transactiegegevens per periode
Totale volumes en bedragen
Uitsplitsing per producttype en categorie
Uitgavenanalyse op kaartniveau

Kostenbeheer

Eindpunt	Methode	Beschrijving
/transaction-data/v1/feessummary	POST	Overzichtgegevens van kostenposten ophalen voor de opgegeven betaler (OAuth 2.0)

Informatie over kosten:

Kostenposten ophalen die op transacties zijn toegepast
Overzicht van alle kosten per periode
Uitsplitsing van kosten naar type en categorie
Kostenanalyse op rekeningniveau

Opgebaseerde regels

Eindpunt	Methode	Beschrijving
/transaction-data/v1/volumebasedpricing	POST	De instellingen voor achterstalligheidsregels ophalen voor de opgegeven betaler (OAuth 2.0)
/transaction-data/v1/volumebasedbonus	POST	Instellingen voor bonus- en associatiebonusregels ophalen voor de opgegeven betaler (OAuth 2.0)

Volumebased functies:

Toegang tot volumebased prijsregels
Bonusberekeningsregels ophalen
Configuraties voor associatiebonussen ophalen
Structuren voor achterstalligheidsvergoedingen opvragen

Uitzonderingen

Eindpunt	Methode	Beschrijving
/transaction-data/v1/exceptions	POST	Uitzonderingen met betrekking tot kaarten of transacties ophalen (OAuth 2.0)

Soorten uitzonderingen:

Fouten bij transactievalidatie
Afwijkingen in kaartgebruik
Autorisatie-uitzonderingen
Waarschuwingen voor beleidsschendingen

Veelvoorkomende gebruiksscenario’s

In dit gedeelte worden veelvoorkomende bedrijfsscenario’s gekoppeld aan de juiste API-eindpunten, zodat u snel kunt bepalen welke API’s u moet gebruiken voor uw specifieke behoeften.

Gebruiksscenario 1: Dagelijkse transactieafstemming

Scenario: U moet dagelijks alle transacties van uw wagenparkkaarten afstemmen voor boekhoudkundige doeleinden.

Aanbevolen API: /transaction-data/v1/priced

Waarom deze API: Dit eindpunt biedt uitgebreide transactiegegevens, inclusief EV-oplaadtransacties, ondersteunt flexibele datumfiltering en omvat zowel gefactureerde als nog niet-gefactureerde transacties. Perfect voor dagelijkse afstemming met ondersteuning voor paginering bij grote datasets.

Belangrijkste parameters:

FromDate en ToDate - Stel in op de datum van gisteren
InvoiceStatus - Gebruik "A" voor alle transacties
PageSize – Stel in op 100 voor efficiënte gegevensopvraging

Gebruiksscenario 2: Factuurvalidatie en -verificatie

Scenario: Je hebt een factuur ontvangen en moet alle transactiegegevens verifiëren, inclusief kosten en toeslagen.

Aanbevolen API: /transaction-data/v1/pricedtransaction

Waarom deze API: Speciaal ontworpen om gedetailleerde informatie over brandstoftransacties te verstrekken, inclusief verkoopartikelen en alle bijbehorende kosten. Ideaal voor factuurvalidatie, aangezien deze overeenkomt met de factuurstructuur.

Belangrijkste parameters:

InvoiceNumber - Specifieke factuur die moet worden gevalideerd
InvoiceDate - Factuurdatum uit uw facturering
IncludeFees - Stel in op ‘true’ om alle kostenposten te zien

Gebruiksscenario 3: Analyse en rapportage van brandstofverbruik

Scenario: U moet de brandstofverbruikspatronen van uw wagenpark van de afgelopen maand analyseren om routes te optimaliseren en kosten te verlagen.

Aanbevolen API’s:

/transaction-data/v1/pricedtransactionssummary - Voor geaggregeerde gegevens

Waarom deze API’s: Samenvattings-endpoints bieden geaggregeerde gegevens per product, locatiegroep, en tijdsperiode, waardoor ze perfect zijn voor trendanalyse zonder grote transactievolumes te verwerken.

Belangrijkste parameters:

FromDate en ToDate - Ingesteld op de afgelopen 30 dagen
ProductCode - Filteren op specifieke brandstoftypen
ProductGroupName - Groepeer op brandstofcategorieën

Gebruiksscenario 4: Multi-vlootbeheer

Scenario: U beheert meerdere subaccounts of betalers en moet transactiegegevens van al deze accounts ophalen voor geconsolideerde rapportage.

Aanbevolen API: /transaction-data/v1/multipayerspricedtransactions

Waarom deze API: Speciaal ontworpen om transacties van meerdere betalers in één API-aanroep op te vragen, waardoor het aantal verzoeken aanzienlijk wordt verminderd en de prestaties voor scenario’s met meerdere betalingsstromen worden verbeterd.

Belangrijkste parameters:

Accounts - Array van betaler-ID’s en -nummers (max. 10 betalers)
InvoiceStatus - "A" voor alle transacties
FromDate en ToDate - Rapportageperiode

Gebruiksscenario 5: Uitzonderingsmonitoring en fraudedetectie

Scenario: U wilt ongebruikelijke transactiepatronen identificeren, zoals transacties met hoge waarden, buitensporige brandstofvolumes of kaarten met afwijkend gebruik, om fraude of misbruik te voorkomen.

Aanbevolen API: /transaction-data/v1/exceptions

Waarom deze API: Speciaal ontwikkeld voor het identificeren van transacties die vastgestelde drempels overschrijden, waardoor deze ideaal is voor het monitoren van uitzonderingen en mogelijke fraude.

Belangrijkste parameters:

Voorwaarde - Stel het type drempelwaarde in (ValueGreaterThan, VolumeGreaterThan, enz.)
Waarde - Definieer de drempelwaarde
OutputType - "Transaction" voor transactie-uitzonderingen
TransactionsFromDate en TransactionsToDate - Monitoringperiode

Gebruiksscenario 6: Analyse van kosten en toeslagen

Scenario: U moet inzicht hebben in alle kosten en toeslagen die op uw rekening worden toegepast om mogelijkheden voor kostenbesparing te identificeren of de facturering te valideren.

Aanbevolen API: /transaction-data/v1/feessummary

Waarom deze API: Biedt geaggregeerde informatie over kosten per kostensoort, productgroep en kostengroep, waardoor het eenvoudig is om kostenstructuren te analyseren en gebieden met hoge kosten te identificeren.

Belangrijkste parameters:

InvoiceStatus - „I“ voor uitsluitend gefactureerde kosten
FeeTypeGroup - Filter op „Kaartkosten“, „Rekeningkosten“, enz.
FromDate en ToDate – Analyseperiode

Gebruiksscenario 7: Bijhouden van individuele kaartuitgaven

Scenario: Een chauffeur vraagt zijn transactiegeschiedenis van de afgelopen 6 maanden op, of u moet de bestedingspatronen voor een specifieke kaart analyseren.

Aanbevolen API: /transaction-data/v1/cardusagesummary

Waarom deze API: Biedt een gedetailleerde uitgavenanalyse voor individuele kaarten over de afgelopen 7 maanden, gegroepeerd per locatie en product, ideaal voor rapportage op kaartniveau.

Belangrijkste parameters:

CardId of PAN - Specifieke kaart om te analyseren
CardExpiry - Voor aanvullende validatie
AccountId - Optioneel accountfilter

Gebruiksscenario 8: Controle op geschiktheid voor op volume gebaseerde prijsstelling

Scenario: U wilt controleren of uw account in aanmerking komt voor prijsniveaus op basis van volume en inzicht krijgen in uw huidige verbruiksniveaus ten opzichte van gedefinieerde drempels.

Aanbevolen API: /transaction-data/v1/volumebasedpricing

Waarom deze API: Toont uw regels voor achterstallige kosten, tariefconfiguraties en het huidige verbruik op basis van volume, zodat u inzicht krijgt in de tariefstructuren en kunt plannen om betere tariefniveaus te bereiken.

Belangrijkste parameters:

PayerNumber - Uw betalersaccount
IncludeHistory - Stel in op ‘true’ om historische berekeningen te zien
IncludeCurrentPeriodVolume - Stel in op ‘true’ voor een uitsplitsing per maand

Gebruiksscenario 9: Bonussen en kortingen bijhouden

Scenario: U hebt op volume gebaseerde bonusovereenkomsten en wilt uw voortgang ten opzichte van bonusdrempels bijhouden en eerder verdiende bonussen bekijken.

Aanbevolen API: /transaction-data/v1/volumebasedbonus

Waarom deze API: Biedt volledige details over bonusregels, het verbruik in de huidige periode en historische bonusberekeningen, waardoor u uw inkoop kunt optimaliseren om bonussen te maximaliseren.

Belangrijkste parameters:

PayerNumber - Uw betalersaccount
IncludeHistory - Stel in op ‘true’ om eerdere bonusbetalingen te zien
IncludeCurrentPeriodVolume - Stel in op 'true' om de voortgang van de huidige periode bij te houden

Gebruiksvoorbeelden

Voorbeeld 1: Prijsgebonden transacties ophalen (inclusief EV)

Verzoek:

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

Antwoord:

{
  "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": "Verenigd Koninkrijk",
 "CustomerCurrencyCode": "GBP",
 "CustomerCurrencySymbol": "£",
 "RebateonNetAmountInCustomerCurrency": 0,
 "EffectiveDiscountInCustomerCurrency": -0,22,
 "Effectieve eenheidskorting in valuta van de klant": -0,0051,
 "Eenheidsprijs in factuurvaluta": 1,1024,
 "Factuurbelasting": 0,
 "Bruto factuurbedrag": 57,25,
 "Nettobedrag op factuur": 47,71,
      "BTW op nettobedrag in valuta van de klant": 9,54,
 "Bruto-eenheidsprijs voor de klant": 0,
 "Bruto-totaalwaarde voor de klant": 57,52,
 "Totaal brutoverkoopwaarde klant": 47,93,
 "Beschrijving transactietype": 9,59,
 "Korting op nettobedrag in transactievaluta": -0,22,
      "Effectieve korting in transactievaluta": -0,22,
 "Wisselkoers tussen land van afzender en land van ontvanger": 0,
 "Kaarten": [
        275549
 ],
 "UnitDiscountTransactionCurrency": -0,005,
 "TransactionGrossAmount": 57,25,
 "TransactionNetAmount": 47,71,
      "TransactionTax": 9,54,
 "VATonNetAmount": 9,54,
 "DelcoListPriceUnitNet": 0,
 "DelcoRetailPriceUnitGross": 1,32888,
      "Eenheidsprijs in transactievaluta": 1,1074,
 "Delco-verkoopprijs per eenheid netto": 1,1074,
      "Delco-verkoopwaarde totaal bruto": 57,52,
 "Delco-verkoopwaarde totaal netto": 47,93,
 "Transactievalutasymbool": "$",
 "Kortingstype": 1,
 "DisputeStatus": false,
 "IsShellSite": false,
 "FleetIdInput": "YG67OUM",
 "IncomingProductCode": 23,
 "PostingDate": "20210802",
      "PostingTime": "14:15:22",
 "ProductCode": 30,
 "ProductName": "Loodvrije benzine - gemiddeld octaangehalte",
      "ProductGroupId": 22,
 "IncomingCurrencyCode": "GBP",
 "IncomingSiteDescription": "Shell Broadway Ring",
 "Location": "Shell Broadway Ring",
 "SiteName": "Shell Broadway Ring",
      "Locatiecode": 32,
 "Inkomend locatienummer": 15,
 "Factuurvalutacode": "GBP",
 "Factuurdatum": "20210802",
 "Factuurnummer": 3201016193,
 "FuelProduct": true,
 "VATApplicable": "Y",
 "PayerName": "Colours Services Ltd",
 "PayerNumber": "GB12121212",
 "ParentCustomerNumber": "GB12121212",
 "PayerGroup": "H312066",
 "PayerGroupName": "12162566 - FUEL CARD SERVICE",
      "CheckDigit": 6,
 "NetInvoiceIndicator": "Y",
 "DelcoCode": 5,
 "NetworkCode": 3,
 "PurchasedInCountry": "Verenigd Koninkrijk",
 "Land van de locatie": "Verenigd Koninkrijk",
 "BTW-land": "Verenigd Koninkrijk",
 "Naam leverancier": "Shell U.K. Oil Products Limited",
 "Netwerk": "Shell",
 "Kilometerstand": 0,
 "Oorspronkelijke verkooppost-ID": "Null",
      "FleetIDDescription": "YG67OUM",
 "ParentCustomerId": 6494,
 "PINIndicator": "Y, N",
 "ProductGroupName": "Kosten",
 "PurchasedInCountryCode": "GB",
 "Quantity": 43,28,
 "RebateRate": 0,0022,
 "ReceiptNumber": 6803,
 "RefundFlag": "Y",
 "SiteGroupId": 202,
 "SiteGroupName": "CZ 9100 ECONOMY NETWORK",
      "Latitude": 53,83606,
 "Longitude": -1,61854,
 "DelCoExchangeRate": 0,851858,
      "EuroRebateAmount": -0,258259,
 "NetEuroAmount": 56,01,
 "EuroVATAmount": 11,2,
 "ParentCustomerName": "FUEL CARD SERVICES LTD",
 "IsInvoiced": false,
 "TransactionCurrencyCode": "GBP",
 "CreditDebitCode": "D of C",
 "TransactionDate": "20210801",
 "TransactionTime": "12:16:58",
 "TransactionItemId": "H305908971030",
 "TrnIdentifier": "H305908971030",
 "Type": "SALE",
 "TransactionLine": 1,
 "TransactionType": "Aankoop",
 "UTCOffset": "Europe/London",
 "VATCategory": "Standaard btw-tarief Verenigd Koninkrijk",
 "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": "Simple Fee",
      "Frequentie": 1,
 "Kostenregel-ID": 1,
 "Systeeminvoerdatum": "20210828",
 "Systeeminvoertijd": "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": "Nationale weg",
 "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
}

Voorbeeld 2: Details van brandstoftransacties ophalen

Verzoek:

POST /transaction-data/v1/pricedtransaction

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

Antwoord:

{
  "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",
 "TransactionTime": "string",
          "UTCOffset": "string",
 "FleetIdInput": "XYZ1234",
          "OdometerInput": 12345,
 "DriverName": "ANDREW GILBERRY",
 "VehicleRegistration": "MV65YLH",
          "Factuurvalutacode": "GBP",
 "Factuurvalutasymbool": "$",
 "TransactionCurrencyCode": "GBP",
 "TransactionCurrencySymbol": "$",
 "TransactionNetAmount": 0,
 "TransactionTax": 0,
 "TransactionGrossAmount": 0,
 "InvoiceNetAmount": 0,
 "InvoiceTax": 0,
 "InvoiceGrossAmount": 0,
 "PurchasedInCountry": "Duitsland",
          "AccountId": 29484,
 "AccountNumber": "GB99215176",
 "AccountName": "MATTHEW ALGIE & COMPANY LIMITED",
          "AccountShortName": "string",
 "Quantity": 0,
 "FuelProduct": true,
 "UnitPriceInTransactionCurrency": 0,
 "UnitPriceInInvoiceCurrency": 0,
          "Eenheidskorting in transactievaluta": 0,
 "Eenheidskorting in factuurvaluta": 0,
 "Is gefactureerd": true,
 "Factuurnummer": "S04500493",
          "Factuurdatum": "string",
 "Locatiecode": "050001 -\tCHARNOCK RICHARD NTHBOUND MWSA 0755",
 "Locatienaam": "050001 -\tCHARNOCK RICHARD NTHBOUND MWSA 0755",
 "Locatieland": "Duitsland",
 "Locatie": {
 "Breedtegraad": "37.4224764",
 "Lengtegraad": "122.0842499"
          },
 "CardGroupName": "006240 FIRE BRIGHT SOLUTIONS",
 "ReceiptNumber": "1234",
 "ProductCode": "10 - TMF-kosten",
 "ProductName": "Loodvrije benzine - Hoog octaangehalte",
 "ProductGroupId": 1,
 "ProductGroupName": "Bovenliggende productgroep",
 "DelCoExchangeRate": 0,
 "ColCoExchangeRate": 0,
 "IsShellSite": true,
          "Network": "100013\tSTEINDORFER",
 "SiteGroupId": 202,
 "SiteGroupName": "CZ 9100 ECONOMY NETWORK",
 "PostingDate": "string",
 "IssuerCode": "7002",
 "PurchasedInCountryCode": "NL",
 "CustomerCountryCode": "NL",
 "CustomerCountry": "Nederland",
 "ReleaseCode": "8",
          "CardGroupId": "string",
 "CardSequenceNumber": "2",
 "CheckDigit": "string",
 "FleetIDDescription": "string",
          "VATRate": "0,20 voor 20%",
 "VATCategory": "1-Nultarief",
 "VATonNetAmount": 0,
 "VATCountry": "Nederland",
          "EffectieveKortingInTransactievaluta": 0,
 "Transactietype": "Aankoop bij fysieke kaart, anders leeg",
 "PIN-indicator": "“PIN gebruikt”",
 "BTW-toepasselijk": "Y",
 "Nettofactuurindicator": "Y",
 "CustomerCurrencyCode": "GBP",
 "CustomerCurrencySymbol": "£",
 "EffectiveUnitDiscountInCustomerCurrency": 0,
 "Effectieve korting in valuta van de klant": 0,
 "BTW op nettobedrag in valuta van de klant": 0,
 "Kortingstype": "2 pence per eenheid",
 "Transactiestatus": "U",
 "SalesItemId": 18315958002,
 "PayerGroup": "string",
 "PayerGroupName": "12119008 - SHELL GROUP OF COMPANIES",
 "RefundFlag": "string",
 "OriginalSalesItemId": "string",
 "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": "string",
 "DisputeStatus": "No Dispute",
 "RebateRate": 28,279,
 "DelCoToColCoExchangeRate": 1,
 "NetEuroAmount": 0,
 "EuroVATAmount": 0,
 "ParentCustomerNumber": "string",
 "ParentCustomerName": "string",
 "ParentCustomerId": 0,
 "IncomingSiteNumber": "100021",
 "IncomingSiteDescription": "HN3 INTI_02-82.02",
 "IncomingCurrencyCode": "GBP",
          "IncomingProductCode": "30",
 "CreditDebitCode": "D",
 "CorrectionFlag": "Y",
 "Additional1": "string",
 "Additional2": "string",
 "Additional3": "string",
 "Additional4": "string",
 "RebateonNetAmountInCustomerCurrency": -0,735,
 "RebateonNetAmountInTransactionCurrency": "AVEE PTUAZONW CUBFAO COSFS",
          "TrnIdentifier": "string",
 "CardType": "string",
          "DelcoListPriceUnitNet": 30,5,
 "DelcoRetailPriceUnitNet": 1,921,
 "DelcoRetailPriceUnitGross": 0,
 "DelcoRetailValueTotalNet": 0,
 "DelcoRetailValueTotalGross": 0,
 "CustomerRetailPriceUnitGross": 0,
 "CustomerRetailValueTotalNet": 0,
 "EVPrintedNumber": "3792",
 "IsRFID": true,
 "TokenTypeDescription": "string"
 }
 ]
    }
  ],
  "Page": 1,
  "PageSize": 1,
  "TotalPages": 15
}

Voorbeeld 3: Overzicht van geprijsde transacties ophalen

Verzoek:

POST /transaction-data/v1/pricedtransactionssummary

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

Antwoord:

{
  "RequestId": "2b0cbe11-f109-4c43-9201-49af0370df1c",
  "Status": "SUCCESS",
  "Data": [
    {
 "ProductId": 1234,
      "ProductCode": "10",
 "ProductName": "Diesel AGO",
 "ProductGroupId": 1,
 "ProductGroupName": "Brandstoffen",
 "TotalFuelQuantity": 1250,75,
      "TotalNetAmount": 5420,50,
 "TotalGrossAmount": 6504,60,
 "InvoiceCurrencyCode": "GBP",
 "InvoiceCurrencySymbol": "£",
      "CustomerRetailValueTotalNet": 5420,50,
 "CustomerRetailValueTotalGross": 6504,60
    }
  ]
}

Voorbeeld 4: Prijsoverzicht ophalen

Verzoek:

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

Antwoord:

{
    "RequestId": "5f1bded6-416d-4478-ab7f-33905d7b5d4b",
    "Status": "SUCCESS",
    "Data": [
 {
            "CustomerRetailValueTotalGross": 114,13,
 "CustomerRetailValueTotalNet": 95,11,
 "InvoiceCurrencyCode": "EUR",
 "InvoiceCurrencySymbol": "€",
            "ProductCode": "21",
 "ProductGroupId": 3,
 "ProductGroupName": "Autobenzine",
            "ProductId": 21,
 "ProductName": "Loodvrij - Hoog octaangehalte",
 "SiteGroupId": 104,
 "SiteGroupName": "Standaard Shell-tankstations Oostenrijk",
 "TotalFuelQuantity": 17,0,
            "TotalGrossAmount": 114,13,
            "TotalNetAmount": 95,11
 }
    ]
}

Voorbeeld 5: Transacties met prijzen voor meerdere betalers ophalen

Verzoek:

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
}

Antwoord:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Data": [
    {
 "Transactions": [
 {
 "Type": "SalesItem"
 }
 ],
      "CardId": 275549,
 "CardPAN": "7002051006629891000",
 "CardExpiry": "20250812",
 "TransactionDate": "20250812",
 "TransactionTime": "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,
 "TransactionTax": 9,54,
 "TransactionGrossAmount": 57,25,
 "InvoiceNetAmount": 47,71,
      "InvoiceTax": 9,54,
 "InvoiceGrossAmount": 57,25,
 "PurchasedInCountry": "Duitsland",
 "AccountId": 29484,
      "AccountNumber": "GB99215176",
 "AccountName": "MATTHEW ALGIE & COMPANY LIMITED",
      "AccountShortName": "MATTHEW",
 "Quantity": 43,28,
 "FuelProduct": true,
 "UnitPriceInTransactionCurrency": 1,1074,
 "UnitPriceInInvoiceCurrency": 1,1024,
 "Eenheidskorting in transactievaluta": -0,005,
 "Eenheidskorting in factuurvaluta": -0,0051,
 "Is gefactureerd": true,
 "Factuurnummer": "S04500493",
 "Factuurdatum": "20250815 09:30:00",
 "Locatiecode": "050001",
 "Locatienaam": "CHARNOCK RICHARD NTHBOUND MWSA 0755",
 "Locatieland": "Duitsland",
 "Locatie": {
 "Breedtegraad": "53.83606",
        "Longitude": "-1.61854"
 },
 "CardGroupName": "006240 FIRE BRIGHT SOLUTIONS",
 "ReceiptNumber": "6803",
 "ProductCode": "10",
 "ProductName": "Loodvrij - Hoog octaangehalte",
 "ProductGroupId": 2,
 "ProductGroupName": "Alle brandstoffen",
 "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": "Nederland",
 "ReleaseCode": "8",
 "CardGroupId": "40000",
      "Kaartvolgnummer": "617",
 "Controlecijfer": "6",
 "Vloot-ID-beschrijving": "YG67OUM",
      "VATRate": 0,2,
 "VATCategory": "1-Standaardtarief",
 "VATonNetAmount": 9,54,
 "VATCountry": "Nederland",
 "EffectiveDiscountInTrxCurrency": -0,22,
 "TransactionType": "Aankoop",
 "PINIndicator": "PIN gebruikt",
 "VATApplicable": "Y",
 "NetInvoiceIndicator": "N",
 "CustomerCurrencyCode": "GBP",
 "CustomerCurrencySymbol": "£",
 "EffectiveUnitDiscountInCustomerCurrency": -0,0051,
 "EffectiveDiscountInCustomerCurrency": -0,22,
 "BTW op nettobedrag in valuta van de klant": 9,54,
 "Kortingstype": "2 pence per eenheid",
      "Transactiestatus": "I",
 "Verkoopartikel-ID": 18315958002,
 "Betalersgroep": "H312066",
 "Naam betalersgroep": "12119008 - SHELL GROUP OF COMPANIES",
 "RefundFlag": "N",
 "OriginalSalesItemId": 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,
 "DisputeStatus": "Geen geschil",
 "Kortingspercentage": 28,279,
 "Wisselkoers afzender-ontvanger": 1,
 "Nettobedrag in euro": 56,01,
 "EuroVATAmount": 11,2,
 "ParentCustomerNumber": "GB12121212",
 "ParentCustomerName": "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,
 "RebateonNetAmountInCustomerCurrency": -0,735,
 "Korting op nettobedrag in transactievaluta": -0,735,
 "TrnIdentifier": "H305908971030",
 "CardType": "GB STD FLT NAT SINGLE R9",
 "DelcoListPriceUnitNet": 30,5,
 "DelcoRetailPriceUnitNet": 1,1074,
 "DelcoRetailPriceUnitGross": 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
}

Voorbeeld 6: Prijsregels op basis van volume ophalen

Verzoek:

POST /transaction-data/v1/volumebasedpricing

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

Antwoord:

{
  "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-Betaling aan betaler",
          "BonusPaidToAccountId": 123456,
 "BonusPaidToAccountNumber": "GB000000123",
          "BonusPaidToAccountShortName": "12345",
 "BonusPaidToAccountFullName": "GB000000123",
 "Frequency": "3-Weekly – Monday",
          "VolgendeBerekeningsdatum": "20231223",
 "VorigeBerekeningsdatum": "20231223",
 "BasisVergoedingsregel": "3-Eenmalig bedrag",
 "ValutacodeVergoedingsregel": "GBP",
          "FeeRuleCurrencySymbol": "£",
 "FeeRuleAvailableFrom": "20231223",
 "FeeRuleAvailableTo": "20231223",
 "FeeRuleLocations": [
 {
 "DelcoId": 866,
              "Country": "Verenigd Koninkrijk",
 "CountryCode": "UK",
 "FuelNetworkId": 100007,
 "NetworkName": "VALERO",
 "SiteGroupId": 100007,
 "SiteGroupName": "VALERO ENERGY LTD",
 "SiteCode": 999493,
 "SiteId": 100007,
 "SiteName": "VALERO ENERGY LTD"
 }
          ],
 "FeeRuleProducts": [
 {
 "ProductGroupID": 3,
 "ProductGroupName": "Motorbenzine",
 "ProductCode": "30 voor Diesel AGO",
 "ProductId": "30 for Diesel AGO",
 "ProductName": "Diesel AGO"
 }
 ],
 "FeeRuleTiers": [
 {
              "TierMinimum": 1234,
 "TierMaximum": 1234,
 "Value": 1234,12
 }
 ]
 }
      ],
 "CurrentPeriodConsumption": [
 {
 "FeeRuleId": 12345,
          "FeeRuleDescription": "NL/GAGO/D018/UP0.0120>1",
 "PriceRuleID": 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",
 "TotalVolume": 12356,66
 }
 ],
 "Warnings": [
 {
 "Message": "Het systeem is buiten gebruik vanwege een upgrade.",
          "Type": "Systeemstoring"
 }
 ]
    }
  ]
}

Voorbeeld 7: Regels voor op volume gebaseerde bonussen ophalen

Verzoek:

POST /transaction-data/v1/volumebasedbonus

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

Antwoord:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Data": [
    {
 "Configuration": [
        {
 "PricingAccountId": 123456,
 "PricingAccountNumber": "GB000000123",
          "PricingAccountShortName": "MATTHEW",
 "PricingAccountFullName": "MATTHEW",
          "FeeRuleId": 1,
 "FeeRuleDescription": "NL/GAGO/D018/UP0.0120>1",
 "FeeRuleDateEffective": "20231223",
 "FeeRuleDateTerminated": "20231223",
 "BonusPaidTo": "1-Betalen aan betaler",
 "BonusPaidToAccountId": 123456,
          "BonusPaidToAccountNumber": "GB000000123",
 "BonusPaidToAccountShortName": "12345",
          "BonusPaidToAccountFullName": "GB000000123",
 "Frequency": "3-Weekly – Monday",
 "NextCalculationDate": "20231223",
 "PreviousCalculatedDate": "20231223",
 "FeeRuleBasis": "3-Lump Sum",
          "Valutacode vergoedingsregel": "GBP",
 "Valutasymbool vergoedingsregel": "£",
 "Geldig vanaf": "20231223",
 "Geldig tot": "20231223",
 "FeeRuleLocations": [
 {
 "DelcoId": 866,
              "Country": "Verenigd Koninkrijk",
 "CountryCode": "UK",
 "FuelNetworkId": 100007,
 "NetworkName": "VALERO",
 "SiteGroupId": 100007,
 "SiteGroupName": "VALERO ENERGY LTD",
 "SiteCode": 999493,
 "SiteId": 100007,
 "SiteName": "VALERO ENERGY LTD"
 }
 ],
 "FeeRuleProducts": [
 {
 "ProductGroupID": 3,
 "ProductGroupName": "Motorbenzine",
 "ProductCode": "30 voor Diesel AGO",
 "ProductId": "30 voor Diesel AGO",
 "ProductName": "Diesel AGO"
            }
 ],
 "FeeRuleTiers": [
 {
 "TierMinimum": 1234,
 "TierMaximum": 1234,
 "Value": 1234,12
 }
 ],
 "Gekoppelde rekeningen": [
 {
 "Gekoppelde rekening-ID": 12345,
              "Gekoppeld rekeningnummer": "GB000000123",
 "Gekoppelde rekening (korte naam)": "Korte naam van de rekening",
 "Gekoppelde rekening (volledige naam)": "Volledige naam van de rekening"
 }
          ]
 }
 ],
 "CurrentPeriodConsumption": [
 {
 "FeeRuleId": 12345,
 "FeeRuleDescription": "NL/GAGO/D018/UP0.0120>1",
 "Month": 1,
 "Year": 2018,
 "TotalVolume": 10000,78
 }
 ],
 "HistoricalBonusPaid": [
 {
          "PayerId": 12345,
 "PayerNumber": "GB000000123",
 "PayerShortName": "Jorden",
 "PayerFullName": "MATTHEW",
 "AccountId": 123456,
 "AccountNumber": "GB000000123",
 "AccountShortName": "SALT",
 "AccountFullName": "ABCD1234",
 "InvoiceAccountId": 12345,
 "InvoiceAccountNumber": "GB000000123",
          "Korte naam factuurrekening": "DFE1234",
 "Volledige naam factuurrekening": "AZAD PVT LMT",
 "Id kostenregel": 12345,
          "FeeRuleDescription": "NL/GAGO/D018/UP0.0120>1",
 "FromDate": "20231223",
          "Tot en met": "20231223",
 "Bonus uitbetaald aan": "5-Uitbetaling aan gelieerde klanten",
 "FeeItemId": 12345,
 "FeeRuleBasis": "2-Percentage van de opbrengst",
 "FeeItemCurrencyCode": "GBP",
 "FeeItemCurrencySymbol": "$",
 "ProratedVolume": 123,12,
 "TotalVolume": 123,12,
          "FeeProduct": "1562-Bonus diesel Shell",
 "InvoiceGrossAmount": 123,12,
 "InvoiceNetAmount": 123,12,
          "InvoiceVATAmount": 123,12,
 "IsFeeCancelled": true,
 "FeeItemTierProratedVolume": 123,12,
 "FeeItemTierTotalVolume": 123,12,
          "TierMinimum": 123,
 "TierRate": 123,12
 }
 ]
    }
  ],
  "Warnings": [
    {
 "Message": "Het systeem is buiten gebruik vanwege een upgrade.",
 "Type": "Systeemstoring"
    }
  ]
}

Voorbeeld 8: Overzicht van kosten ophalen

Verzoek:

POST /transaction-data/v1/feessummary

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

Antwoord:

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

Voorbeeld 9: Transactie-uitzonderingen ophalen

Verzoek:

POST /transaction-data/v1/exceptions

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

Antwoord:

{
  "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",
 "AccountNumber": "GB99215176",
 "AccountShortName": "MATTHEW",
 "KortNaamBetaler": "MATTHEW",
 "Dag": 2,
 "Week": 2,
 "Maand": 5,
 "Jaar": 2017,
 "TotaalTransacties": 4,
          "TotalSalesItems": 4,
 "TotalQuantity": 261,
 "TotalAmount": 100,21,
 "CurrencyCode": "GBP",
 "CurrencySymbol": "$"
        }
 ],
 "Transactie-uitzonderingen": [
 {
 "Verkoopartikel-ID": 18315958002,
 "Kaart-ID": 1234,
 "Product-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",
 "InvoiceCurrencySymbol": "$",
 "TransactionCurrencyCode": "GBP",
 "TransactionCurrencySymbol": "£",
          "TransactionNetAmount": 123,12,
 "TransactionTax": 123,12,
 "TransactionGrossAmount": 123,12,
 "InvoiceNetAmount": 123,12,
          "InvoiceTax": 123,12,
 "InvoiceGrossAmount": 123,1,
 "PurchasedInCountry": "Frankrijk",
 "AccountId": 1234,
 "AccountNumber": "GB99215176",
          "AccountName": "MATTHEW ALGIE & COMPANY LIMITED",
 "AccountShortName": "MATTHEW ALGIE & COMPANY LIMITED",
 "Quantity": 123,12,
          "Brandstofproduct": true,
 "Eenheidsprijs in transactievaluta": 123,12,
 "Eenheidsprijs in factuurvaluta": 123,12,
 "Eenheidskorting in transactievaluta": 123,12,
 "UnitDiscountInvoiceCurrency": 123,12,
 "IsInvoiced": true,
 "InvoiceNumber": "S04500493",
          "Factuurdatum": "20231223",
 "Locatiecode": "50001",
 "Locatienaam": "CHARNOCK RICHARD NTHBOUND MWSA 0755",
          "Land van vestiging": "Duitsland",
 "Locatie": {
 "Lat": "37.4224764",
            "Lng": "122.0842499"
 },
 "CardGroupName": "006240 FIRE BRIGHT SOLUTIONS",
 "ReceiptNumber": "1234",
 "ProductCode": "TMF-kosten",
 "ProductName": "Loodvrij - Hoog octaangehalte",
 "ProductGroupId": 1234,
 "ProductGroupName": "Bovenliggende productgroep",
 "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": "Nederland",
 "ReleaseCode": "8 voor 702188",
 "CardGroupId": "200",
 "CardSequenceNumber": "2",
 "CheckDigit": "GHE1234",
 "FleetIDDescription": "Voorbeeldbeschrijving",
 "VATRate": 0,2,
 "VATCategory": "3-BTW-vrijgesteld",
 "VATonNetAmount": 12,21,
 "VATCountry": "Nederland",
 "EffectiveDiscountInTrxCurrency": 0,
 "TransactionType": "Aankoop bij fysieke kaart, anders leeg",
 "PINIndicator": "Y",
          "VATApplicable": "Y",
          "Nettofactuurindicator": "Ja",
 "Valutacode klant": "GBP",
 "Valutasymbool klant": "£",
 "Effectieve eenheidskorting in valuta klant": 123,12,
 "Effectieve korting in valuta van de klant": 123,12,
 "BTW op nettobedrag in valuta van de klant": 123,12,
 "Kortingstype": "3-procent",
 "Transactiestatus": "U",
          "Betalersgroep": "12119008",
 "Terugbetalingsvlag": "N",
 "OorspronkelijkeVerkooppost-ID": "1231",
 "Delco-naam": "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\tTeruggeboekt naar de website",
 "Kortingspercentage": 28,279,
 "Wisselkoers tussen afrekenings- en boekingsvaluta": 1,
 "Nettobedrag in euro": 37,93,
          "EuroRebateAmount": 0,
 "EuroVATAmount": 7,96,
          "ParentCustomerNumber": "DRG1234"
 }
 ]
    }
  ]
}

Voorbeeld 10: Overzicht van kaartgebruik ophalen

Verzoek:

POST /transaction-data/v1/cardusagesummary

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

Antwoord:

{
  "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,
 "TotalGross": 123,12,
          "TotalNet": 123,12,
          "CurrencyCode": "GBP",
 "CurrencySymbol": "£",
 "ProductGroupId": 1234,
 "ProductGroupName": "Motorbenzine"
 }
 ]
    }
  ]
}

Foutafhandeling

Veelvoorkomende foutcodes

HTTP-status	Foutcode	Beschrijving	Oplossing
200	N.v.t.	Status: GESLAAGD	N.v.t.
200	E0001	Validatiefout	Controleer de verzoekparameters
401	E0003	Geen toestemming	Controleer of het OAuth-token geldig is
403	E0003	Toegang geweigerd	Controleer gebruikersrechten
404	E0005	Bron niet gevonden	Controleer of de eindpunt-URL en de bron bestaan
500	E0002	Onbekende fout / Interne serverfout	Neem contact op met de ondersteuning

Aanbevolen werkwijzen

1. Gebruik OAuth 2.0-authenticatie

BELANGRIJK: Alle klanten moeten overstappen op OAuth 2.0-authenticatie. Implementeer goed tokenbeheer:

Sla toegangstokens op in de cache en hergebruik ze totdat ze verlopen
Vernieuw tokens voordat ze verlopen (aanbevolen: 60 seconden van tevoren)
Sla clientgegevens veilig op (gebruik omgevingsvariabelen of een geheimenbeheerder)
Log toegangstokens nooit op en maak ze nooit zichtbaar in client-side code

2. Gebruik Request-ID's

Voeg altijd een uniek RequestId (GUID-formaat) toe voor traceerbaarheid van begin tot eind

3. Implementeer paginering

Gebruik bij grote transactiedatasets paginering om time-outs te voorkomen:

Stel een geschikte PageSize in (aanbevolen: 50-100 records)
Verwerk pagina’s sequentieel of parallel
Verwerk TotalPages en TotalRecords in de antwoorden

4. Gebruik datumfilters verstandig

Bij het opvragen van transactiegegevens:

Beperk datumbereiken om grote resultatensets te vermijden
Gebruik FromDate- en ToDate-filters consequent
Overweeg om per maand of week te zoeken voor betere prestaties

5. Test in de sandbox-omgeving

Test de integratie altijd in de test-/sandbox-omgeving voordat u naar productie overgaat

6. Sla referentiegegevens op in de cache

Sla op volume gebaseerde prijs- en bonusregels op in de cache om het aantal API-aanroepen te minimaliseren:

Deze regels veranderen zelden
Vernieuw de cache periodiek (bijv. dagelijks)
Gebruik de parameter IncludeHistory alleen wanneer dat nodig is

SDK’s en codevoorbeelden

Shell biedt officiële SDK’s en uitgebreide codevoorbeelden om uw integratie met de Transaction Data API te versnellen.

Beschikbare SDK-talen

Python - Volledig uitgeruste SDK met ondersteuning voor OAuth 2.0
TypeScript - Typeveilige SDK met volledige typedefinities
Java - SDK op enterprise-niveau
C#/.NET - Volledige .NET-integratie
PHP - Gebruiksvriendelijke PHP-bibliotheek
Ruby - Ruby-gem voor naadloze integratie

Bekijk officiële SDK's & documentatie bekijken

Ondersteuning en bronnen

Technische ondersteuning

Ondersteuning: Technische ondersteuning voor Shell
OAuth 2.0-migratie: Ondersteuning voor OAuth 2.0-migratie

Documentatie

Hulp krijgen

Geef bij contact met de ondersteuning het volgende op:

Uw client_id (deel nooit uw client_secret of toegangstokens)
RequestId uit het API-antwoord
Tijdstempel van het verzoek
Omgeving (Productie/Test)

Laatst bijgewerkt: 16 juni 2026
Documentversie: 1.0
API-versie: 2.3.4

Selecteer uw taal

Shell B2B Mobility Card Transaction Data API - Snelstartgids

Overzicht

Belangrijkste functies

Belangrijke mededeling - OAuth 2.0

Authenticatie

OAuth 2.0 (standaard authenticatiemethode)

OAuth 2.0-stroom

Stap 1: Verkrijg een toegangstoken

Stap 2: Gebruik het toegangstoken in API-verzoeken

Tokenbeheer

Strategie voor de invoering van OAuth 2.0

Waarom overstappen op OAuth 2.0?

Beveiligingsvoordelen:

Operationele voordelen:

Migratietraject

Omgevingen

Snel aan de slag

1. Verkrijg uw OAuth-inloggegevens

2. Verkrijg een toegangstoken

cURL-voorbeeld:

Antwoord:

3. Doe je eerste API-verzoek

cURL-voorbeeld:

Voorbeeld van een antwoord:

Referentie API-eindpunten

Transacties met prijs

Transactieoverzichten

Kostenbeheer

Opgebaseerde regels

Uitzonderingen

Veelvoorkomende gebruiksscenario’s

Gebruiksscenario 1: Dagelijkse transactieafstemming

Gebruiksscenario 2: Factuurvalidatie en -verificatie

Gebruiksscenario 3: Analyse en rapportage van brandstofverbruik

Gebruiksscenario 4: Multi-vlootbeheer

Gebruiksscenario 5: Uitzonderingsmonitoring en fraudedetectie

Gebruiksscenario 6: Analyse van kosten en toeslagen

Gebruiksscenario 7: Bijhouden van individuele kaartuitgaven

Gebruiksscenario 8: Controle op geschiktheid voor op volume gebaseerde prijsstelling

Gebruiksscenario 9: Bonussen en kortingen bijhouden

Gebruiksvoorbeelden

Voorbeeld 1: Prijsgebonden transacties ophalen (inclusief EV)

Verzoek:

Antwoord:

Voorbeeld 2: Details van brandstoftransacties ophalen

Verzoek:

Antwoord:

Voorbeeld 3: Overzicht van geprijsde transacties ophalen

Verzoek:

Antwoord:

Voorbeeld 4: Prijsoverzicht ophalen

Verzoek:

Antwoord:

Voorbeeld 5: Transacties met prijzen voor meerdere betalers ophalen

Verzoek:

Antwoord:

Voorbeeld 6: Prijsregels op basis van volume ophalen

Verzoek:

Antwoord:

Voorbeeld 7: Regels voor op volume gebaseerde bonussen ophalen

Verzoek:

Antwoord:

Voorbeeld 8: Overzicht van kosten ophalen

Verzoek:

Antwoord:

Voorbeeld 9: Transactie-uitzonderingen ophalen

Verzoek:

Antwoord:

Voorbeeld 10: Overzicht van kaartgebruik ophalen

Verzoek:

Antwoord:

Foutafhandeling

Veelvoorkomende foutcodes

Aanbevolen werkwijzen

1. Gebruik OAuth 2.0-authenticatie

2. Gebruik Request-ID's

3. Implementeer paginering

4. Gebruik datumfilters verstandig

5. Test in de sandbox-omgeving