Shell B2B Mobility API voor toltransactiegegevens – Snelstartgids

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

Overzicht

De Shell B2B Mobility API voor toltransactiegegevens is een op REST gebaseerde API die uitgebreide toegang biedt tot toltransactiegegevens en gerelateerde gegevens voor mobiliteitsklanten van Shell. Met deze API kunnen ontwikkelaars, filteren en analyseren van toltransactiegegevens via programmeerwegen voor het afstemmen van rekeningen, het controleren van facturen, onkostenbeheer en naleving van regelgeving.

Belangrijkste functies

Toltransactiegegevens ophalen op basis van accountnummer
Transacties filteren op datumbereik (van- en tot-datum)
Zoeken op factuurstatus en VRN (voertuigregistratienummer)
Geavanceerde sorteermogelijkheden op meerdere velden
Ondersteuning voor paginering bij grote datasets
Flexibele veldfiltering om de responsgrootte te optimaliseren
Uitgebreide tolgegevens, inclusief op- en afritpunten
Ondersteuning voor meerdere tolnetwerken en exploitanten

Authenticatie

OAuth 2.0 (standaard authenticatiemethode)

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

OAuth 2.0-stroom

Stap 1: Verkrijg een toegangstoken

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

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

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

Stap 2: Gebruik het toegangstoken in API-verzoeken

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

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 nooit je client_secret en verwerk deze niet in client-side code

Omgevingen

De API is beschikbaar in twee omgevingen:

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

OAuth-token-URL's:

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

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 aan (client_id en client_secret)
Bekijk servicevoorwaarden

2. Verkrijg een toegangstoken

Verkrijg eerst je OAuth-toegangstoken:

cURL-voorbeeld:

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

Antwoord:

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

3. Doe je eerste API-verzoek

Voorbeeld: Zoek toltransacties

cURL-voorbeeld:

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

Voorbeeld van een antwoord:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Page": 1,
  "TotalRecords": 150,
  "TotalPages": 15,
  "PageSize": 10,
  "Data": [
    {
 "NetworkDescription": "Societa Autostradali",
 "TollChargerCode": "410|610",
 "DelcoCode": "714",
 "DelcoName": "Shell Fleet Solutions Consorzio",
 "NetworkCode": "TLI",
 "Network": "euroShell Consortio",
      "Aankoopland": "Italië",
 "Aankooplandcode": "IT",
 "Kaartnummer": "707737*******334272",
      "CardId": 123456789,
 "CardGroupName": "Shell Fleet Solutions Consorzio",
 "VehicleRegistration": "KN 00000",
 "CostCenter": "100",
      "Systeeminvoerdatum": "20260123",
 "Systeeminvoertijd": "13:14:25",
 "Transactiedatum": "20260120",
 "Transactietijd": "10:30:00",
      "Boekingsdatum": "20260123",
 "Boekings tijd": "00:00:00",
      "Betalingsnummer": "NL20016398",
 "Rekeningnummer": "NL20027701",
 "Rekeningnaam": "Testrekeningnaam",
 "Startdatum": "20260120",
      "StartTime": "06:47:41",
 "EndDate": "20260120",
      "Eindtijd": "07:30:15",
 "Toegang tolstation": "ROMA NORD",
 "Uitgang tolstation": "BRENNERO",
 "Afgelegde afstand": "71,6",
      "Routebeschrijving": "ROMA NORD - BRENNERO",
 "Transactietype": "Wegbelasting",
 "Productcode": "14",
 "Productbeschrijving": "Wegbelasting",
 "NettobedragTransactie": "127,1",
 "BelastingTransactie": "0,0",
 "BrutoBedragTransactie": "127,1",
      "TransactionCurrencyCode": "EUR",
 "TransactionStatus": "Rapportage",
      "Factuurnummer": "8600397548",
 "Factuurdatum": "20260125",
 "Factuurstatus": "Gefactureerd",
 "Betaalmethode": "Achteraf betalen",
      "OBUSerialNumber": "00049000000836932426",
 "EmissionClass": "Euro 6",
      "ContractID": "fb75eb53-46eb-450b-862e-6045002c3fa8",
      "ShellTransactionID": "04176c5c-e7b2-49c8-bcb3-23d07ba583f2",
      "TollOperator": "Toll4Europe",
 "TollDomain": "Toll4Europe",
      "TariffRelevantInformation": "Voertuigklasse: 2, Aantal assen: 2, Wegcategorie: Snelweg",
 "AdditionalTransactionInfo": "Locatie:1",
 "TCInvoiceNumber": "12343343",
      "TCInvoiceDate": "20260123"
    }
  ]
}

Referentie API-eindpunten

Toltransacties

Eindpunt	Methode	Beschrijving
/toll-data/v1/transactions/search	POST	Toltransactiegegevens ophalen met flexibele filteropties en paginering

Veelvoorkomende gebruiksscenario’s:

Toltransacties ophalen op basis van een datumbereik
Filteren op factuurstatus (Gefactureerd, Niet-gefactureerd, Alles)
Zoeken op kenteken (VRN)
Filteren op kaartgroep
Transacties sorteren op meerdere criteria
Selecteer specifieke velden om de responsgrootte te optimaliseren

Veelvoorkomende gebruiksscenario’s

In dit gedeelte worden veelvoorkomende bedrijfsscenario’s gekoppeld aan API-gebruikspatronen, zodat u snel kunt zien hoe u de API voor uw specifieke behoeften kunt inzetten.

Gebruiksscenario 1: Dagelijkse afstemming van toltransacties

Scenario: U moet dagelijks alle toltransacties van uw wagenpark afstemmen voor boekhoudkundige doeleinden.