API ข้อมูลธุรกรรมค่าผ่านทาง Shell B2B Mobility - คู่มือเริ่มต้นอย่างรวดเร็ว

เวอร์ชัน API: 1.0.0 | การยืนยันตัวตน: OAuth 2.0 | สถานะ: Production

ภาพรวม

API ข้อมูลธุรกรรมค่าผ่านทาง Shell B2B Mobility เป็น API ที่ใช้ REST เป็นพื้นฐาน ซึ่งให้สิทธิ์เข้าถึงอย่างครบถ้วนต่อบันทึกธุรกรรมค่าผ่านทางและข้อมูลที่เกี่ยวข้องสำหรับลูกค้าบริการความคล่องตัวของ Shell API นี้ช่วยให้ผู้พัฒนาสามารถเรียกใช้ กรอง และวิเคราะห์ข้อมูลธุรกรรมค่าผ่านทางผ่านโปรแกรมได้ เพื่อการปรับยอดบัญชี การตรวจสอบใบแจ้งหนี้ การจัดการค่าใช้จ่าย และข้อกำหนดด้านการปฏิบัติตามกฎระเบียบ

คุณสมบัติหลัก

เรียกข้อมูลธุรกรรมค่าผ่านทางตามหมายเลขบัญชี
กรองธุรกรรมตามช่วงวันที่ (วันที่เริ่มต้นและวันที่สิ้นสุด)
ค้นหาตามสถานะใบแจ้งหนี้และ VRN (หมายเลขทะเบียนรถ)
ความสามารถในการจัดเรียงขั้นสูงตามหลายฟิลด์
รองรับการแบ่งหน้าสำหรับชุดข้อมูลขนาดใหญ่
การกรองฟิลด์ที่ยืดหยุ่นเพื่อเพิ่มประสิทธิภาพของข้อมูลที่ส่งกลับ
รายละเอียดค่าผ่านทางที่ครบถ้วน รวมถึงจุดเข้า/ออก
รองรับเครือข่ายและผู้ให้บริการเก็บค่าผ่านทางหลายแห่ง

การยืนยันตัวตน

OAuth 2.0 (วิธีการยืนยันตัวตนมาตรฐาน)

API ข้อมูลธุรกรรมค่าผ่านทาง Shell ใช้ กระบวนการ OAuth 2.0 Client Credentials เพื่อการยืนยันตัวตนที่ปลอดภัย.

กระบวนการ OAuth 2.0

ขั้นตอนที่ 1: รับโทเค็นการเข้าถึง

ขอโทเค็นการเข้าถึงจาก จุดปลายทางโทเค็น OAuth:

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: ใช้โทเค็นการเข้าถึงในการส่งคำขอ API

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

การจัดการโทเค็น

แนวทางปฏิบัติที่ดีที่สุดในการจัดการโทเค็น:

โทเค็นการเข้าถึงมีอายุการใช้งานจำกัด (โดยทั่วไป 15 นาที)
ใช้ระบบแคชโทเค็นเพื่อหลีกเลี่ยงการขอโทเค็นที่ไม่จำเป็น
รีเฟรชโทเค็นก่อนหมดอายุเพื่อรับประกันการให้บริการที่ไม่ถูกขัดจังหวะ
อย่าแบ่งปัน client_secret ของคุณหรือฝังมันไว้ในโค้ดฝั่งไคลเอนต์

สภาพแวดล้อม

API นี้มีให้บริการในสองสภาพแวดล้อม:

สภาพแวดล้อม	URL หลัก	วัตถุประสงค์
การผลิต	https://api.shell.com/toll-data/v1	สภาพแวดล้อมการผลิตจริง
การทดสอบ (UAT)	https://api-test.shell.com/toll-data/v1	สภาพแวดล้อมการทดสอบและการพัฒนา

URL โทเค็น OAuth:

สภาพแวดล้อม	URL โทเค็น
Production	https://api.shell.com/v2/oauth/token
ทดสอบ (UAT)	https://api-test.shell.com/v2/oauth/token

เคล็ดลับ: ควรทดสอบการผสานระบบของคุณใน สภาพแวดล้อมการทดสอบ ก่อนที่จะย้ายไปยังสภาพแวดล้อมการผลิต

เริ่มต้นอย่างรวดเร็ว

1. รับข้อมูลรับรอง OAuth ของคุณ

ติดต่อ ทีมสนับสนุนทางเทคนิคของ Shell
ขอข้อมูลรับรอง OAuth 2.0 (client_id และ client_secret)
ตรวจสอบ เงื่อนไขการให้บริการ

2. รับโทเค็นการเข้าถึง

ก่อนอื่น ให้รับโทเค็นการเข้าถึง OAuth ของคุณ:

ตัวอย่าง cURL:

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"

คำตอบ:

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

3. ส่งคำขอ API ครั้งแรก

ตัวอย่าง: ค้นหาธุรกรรมค่าผ่านทาง

ตัวอย่าง cURL:

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

ตัวอย่างคำตอบ:

{
  "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",
 "VehicleRegistration": "KN 00000",
      "CostCenter": "100",
 "SystemEntryDate": "20260123",
 "SystemEntryTime": "13:14:25",
 "TransactionDate": "20260120",
      "TransactionTime": "10:30:00",
 "PostingDate": "20260123",
 "PostingTime": "00:00:00",
 "PayerNumber": "NL20016398",
 "AccountNumber": "NL20027701",
      "AccountName": "Test Account Name",
 "StartDate": "20260120",
 "StartTime": "06:47:41",
 "EndDate": "20260120",
      "EndTime": "07:30:15",
 "TollGateEntry": "ROMA NORD",
 "TollGateExit": "BRENNERO",
 "DistanceDriven": "71.6",
      "RouteDescription": "ROMA NORD - BRENNERO",
 "TransactionType": "ค่าทาง",
 "ProductCode": "14",
 "ProductDescription": "ค่าทาง",
 "TransactionNetAmount": "127.1",
      "TransactionTax": "0.0",
 "TransactionGrossAmount": "127.1",
 "TransactionCurrencyCode": "EUR",
 "TransactionStatus": "Reporting",
 "InvoiceNumber": "8600397548",
 "InvoiceDate": "20260125",
 "InvoiceStatus": "Invoiced",
 "PaymentMethod": "Post Pay",
 "OBUSerialNumber": "00049000000836932426",
 "EmissionClass": "Euro 6",
      "ContractID": "fb75eb53-46eb-450b-862e-6045002c3fa8",
 "ShellTransactionID": "04176c5c-e7b2-49c8-bcb3-23d07ba583f2",
 "TollOperator": "Toll4Europe",
 "TollDomain": "Toll4Europe",
      "TariffRelevantInformation": "ประเภทรถ: 2, จำนวนเพลา: 2, ประเภททาง: ทางด่วน",
 "AdditionalTransactionInfo": "ตำแหน่ง: 1",
 "TCInvoiceNumber": "12343343",
      "TCInvoiceDate": "20260123"
    }
  ]
}

API Endpoints Reference

Toll Transactions

จุดปลาย	วิธีการ	คำอธิบาย
/toll-data/v1/transactions/search	POST	เรียกข้อมูลธุรกรรมค่าผ่านทางด้วยการกรองที่ยืดหยุ่น การกรองและแบ่งหน้า

กรณีการใช้งานทั่วไป:

เรียกข้อมูลธุรกรรมค่าผ่านทางตามช่วงวันที่
กรองตามสถานะใบแจ้งหนี้ (ออกใบแจ้งหนี้แล้ว, ยังไม่ออกใบแจ้งหนี้, ทั้งหมด)
ค้นหาตามหมายเลขทะเบียนรถ (VRN)
กรองตามกลุ่มบัตร
จัดเรียงธุรกรรมตามเกณฑ์หลายประการ
เลือกฟิลด์เฉพาะเพื่อปรับขนาดการตอบกลับให้เหมาะสม

กรณีการใช้งานทั่วไป

ส่วนนี้แสดงการเชื่อมโยงระหว่างสถานการณ์ธุรกิจทั่วไปกับรูปแบบการใช้งาน API เพื่อช่วยคุณระบุได้อย่างรวดเร็วว่าควรใช้ API อย่างไรให้เหมาะสมกับความต้องการเฉพาะของคุณ

กรณีการใช้งาน 1: การปรับยอดธุรกรรมค่าผ่านทางรายวัน

สถานการณ์: คุณจำเป็นต้องปรับยอดธุรกรรมค่าผ่านทางทั้งหมดจากกองยานพาหนะของคุณทุกวันเพื่อวัตถุประสงค์ทางบัญชี