Shell B2B Mobility útdíj-tranzakciós adatok API – Gyors útmutató

API-verzió: 1.0.0 | Hitelesítés: OAuth 2.0 | Állapot: Termelés

Áttekintés

A Shell B2B Mobility útdíj-tranzakciós adat API egy REST-alapú API, amely átfogó hozzáférést biztosít az útdíj-tranzakciós rekordokhoz és a kapcsolódó adatokhoz a Shell mobilitási ügyfelei számára. Ez az API lehetővé teszi a fejlesztők számára, hogy programozási úton lekérjék, szűrjék és elemezzék az útdíj-tranzakciós adatokat számlaegyeztetés, számlázás-ellenőrzés, költségkezelés és megfelelési követelmények céljából.

Főbb jellemzők

Útdíj-tranzakciós adatok lekérése számlaszám alapján
Tranzakciók szűrése dátumtartomány szerint (kezdő és záró dátum)
Keresés számlaállapot és VRN (jármű-nyilvántartási szám) alapján
Speciális rendezési lehetőségek több mező alapján
Oldalszámozás támogatása nagy adathalmazok esetén
Rugalmas mezőszűrés a válaszadatok optimalizálása érdekében
Átfogó útdíj-adatok, beleértve a be- és kilépési pontokat
Több útdíjhálózat és szolgáltató támogatása

Hitelesítés

OAuth 2.0 (szabványos hitelesítési módszer)

A Shell útdíj-tranzakciós adat-API a OAuth 2.0 ügyfélhitelesítési folyamatot a biztonságos hitelesítéshez.

OAuth 2.0 folyamat

1. lépés: Hozzáférési token beszerzése

Kérjen hozzáférési tokent az OAuth token végponttól:

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

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

2. lépés: A hozzáférési token használata az API-kérelmekben

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

Tokenkezelés

A tokenkezelés bevált gyakorlatai:

A hozzáférési tokenek élettartama korlátozott (általában 15 perc)
Vezessen be token-gyorsítótárazást a felesleges token-lekérdezések elkerülése érdekében
A szolgáltatás zavartalan működésének biztosítása érdekében frissítse a tokeneket lejáratuk előtt
Soha ne ossza meg a client_secret értékét, és ne ágyazza be azt a kliensoldali kódba

Környezetek

Az API két környezetben érhető el:

Környezet	Alap-URL	Cél
Termelési környezet	https://api.shell.com/toll-data/v1	Éles termelési környezet
Teszt (UAT)	https://api-test.shell.com/toll-data/v1	Tesztelési és fejlesztési környezet

OAuth-token URL-ek:

Környezet	Token URL
Termelés	https://api.shell.com/v2/oauth/token
Teszt (UAT)	https://api-test.shell.com/v2/oauth/token

Tipp: Mindig tesztelje az integrációt a Tesztkörnyezetben, mielőtt átállna a termelésre.

Gyors útmutató

1. Szerezze be az OAuth hitelesítő adatait

Vegye fel a kapcsolatot a Shell műszaki támogatással
Kérjen OAuth 2.0 hitelesítő adatokat (client_id és client_secret)
Olvassa el a szolgáltatási feltételek áttekintése

2. Hozzáférési token beszerzése

Először szerezze be az OAuth hozzáférési tokenjét:

cURL-példa:

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

Válasz:

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

3. Az első API-lekérdezés elvégzése

Példa: Útdíj-tranzakciók keresése

cURL-példa:

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

Példa a válaszra:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Page": 1,
  "TotalRecords": 150,
  "TotalPages": 15,
  "PageSize": 10,
  "Data": [
    {
      "NetworkDescription": "Societa Autostradali",
 "TollChargerCode": "410|610",
 "DelcoCode": "714",
 "DelcoName": "Shell Fleet Solutions Consorzio",
      "NetworkCode": "TLI",
 "Network": "euroShell Consortio",
 "PurchasedInCountry": "Italy",
      "PurchasedInCountryCode": "IT",
 "CardNumber": "707737*******334272",
 "CardId": 123456789,
 "CardGroupName": "Shell Fleet Solutions Consorzio",
      "Jármű-nyilvántartási szám": "KN 00000",
 "Költségközpont": "100",
 "Rendszerbeviteli dátum": "20260123",
 "Rendszerbeviteli idő": "13:14:25",
      "Tranzakció dátuma": "20260120",
 "Tranzakció ideje": "10:30:00",
 "Könyvelés dátuma": "20260123",
      "Könyvelési idő": "00:00:00",
 "Fizetőszám": "NL20016398",
 "Számlaszám": "NL20027701",
 "Számla neve": "Teszt számla neve",
      "StartDate": "20260120",
 "StartTime": "06:47:41",
 "EndDate": "20260120",
 "EndTime": "07:30:15",
      "TollGateEntry": "ROMA NORD",
 "TollGateExit": "BRENNERO",
 "DistanceDriven": "71,6",
      "Útvonal leírása": "ROMA NORD – BRENNERO",
 "Tranzakció típusa": "Útdíj",
 "Termék kód": "14",
 "Termék leírása": "Útdíj",
      "Tranzakció nettó összege": "127,1",
 "Tranzakció adója": "0,0",
 "Tranzakció bruttó összege": "127,1",
 "Tranzakció pénznemkódja": "EUR",
      "TransactionStatus": "Jelentés",
 "InvoiceNumber": "8600397548",
 "InvoiceDate": "20260125",
      "Számlaállapot": "Kiszámlázva",
 "Fizetési mód": "Utólagos fizetés",
 "OBU sorozatszám": "00049000000836932426",
      "Kibocsátási osztály": "Euro 6",
 "Szerződésazonosító": "fb75eb53-46eb-450b-862e-6045002c3fa8",
      "ShellTransactionID": "04176c5c-e7b2-49c8-bcb3-23d07ba583f2",
      "Útdíjszedő": "Toll4Europe",
 "Útdíjszedő-tartomány": "Toll4Europe",
      "TariffRelevantInformation": "Járműosztály: 2, Tengelyek száma: 2, Úttípus: Autópálya",
 "AdditionalTransactionInfo": "Helyszín: 1",
      "TCInvoiceNumber": "12343343",
 "TCInvoiceDate": "20260123"
    }
  ]
}

API végpontok hivatkozása

Útdíj-tranzakciók

Végpont	Módszer	Leírás
/toll-data/v1/transactions/search	POST	Útdíj-tranzakciós adatok lekérése rugalmas szűréssel és oldalozással

Gyakori felhasználási esetek:

Útdíj-tranzakciók lekérése dátumtartomány szerint
Szűrés számlaállapot szerint (Számlázott, Számlázatlan, Összes)
Keresés jármű-nyilvántartási szám (VRN) alapján
Szűrés kártyacsoport szerint
Tranzakciók rendezése több kritérium szerint
Konkrét mezők kiválasztása a válasz méretének optimalizálása érdekében

Gyakori felhasználási esetek

Ez a szakasz a gyakori üzleti forgatókönyveket az API-használati mintákhoz rendeli hozzá, hogy segítsen Önnek gyorsan azonosítani, hogyan használhatja az API-t az Ön konkrét igényeinek megfelelően.