壳牌 B2B 移动通行费交易数据 API - 快速入门指南

API 版本： 1.0.0 | 身份验证： OAuth 2.0 | 状态： 生产环境

概述

壳牌 B2B 移动出行过路费交易数据 API 是一个基于 REST 的 API，为壳牌移动出行客户提供对过路费交易记录及相关数据的全面访问权限。该 API 使开发人员能够通过编程方式检索、筛选和分析通行费交易数据，以满足账户对账、账单核验、费用管理及合规要求。

主要功能

按账号检索通行费交易数据
按日期范围（起始日期和结束日期）筛选交易
按发票状态和车辆登记号（VRN）（车辆登记号）
支持按多个字段进行高级排序
支持对大型数据集进行分页
灵活的字段筛选功能，可优化响应负载
包括进出点在内的全面通行费详情
支持多个收费网络和运营商

身份验证

OAuth 2.0（标准身份验证方法）

Shell 收费交易数据 API 使用 OAuth 2.0 客户端凭据流程 进行安全身份验证。

OAuth 2.0 流程

步骤 1：获取访问令牌

向 OAuth 令牌端点请求访问令牌：

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

grant_type=client_credentials&client_id=您的客户端 ID&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	测试与开发环境

OAuth 令牌 URL：

环境	令牌 URL
生产环境	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=您的客户端 ID&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",
      "网络代码": "TLI",
 "网络": "euroShell Consortio",
 "购买国家": "意大利",
 "购买国家代码": "IT",
 "卡号": "707737*******334272",
 "卡号": 123456789,
 "卡组名称": "Shell Fleet Solutions Consorzio",
 "车辆注册号": "KN 00000",
      "成本中心": "100",
 "系统录入日期": "20260123",
 "系统录入时间": "13:14:25",
      "交易日期": "20260120",
 "交易时间": "10:30:00",
 "过账日期": "20260123",
 "过账时间": "00:00:00",
      "付款人编号": "NL20016398",
 "账号": "NL20027701",
 "账户名称": "测试账户名称",
 "开始日期": "20260120",
 "开始时间": "06:47:41",
 "结束日期": "20260120",
 "结束时间": "07:30:15",
      "收费站入口": "ROMA NORD",
 "收费站出口": "BRENNERO",
 "行驶距离": "71.6",
 "路线描述": "ROMA NORD - BRENNERO",
      "交易类型": "道路税",
 "产品代码": "14",
 "产品描述": "道路税",
 "交易净金额": "127.1",
      "交易税额": "0.0",
 "交易总金额": "127.1",
 "交易货币代码": "EUR",
 "交易状态": "报送中",
      "发票编号": "8600397548",
 "发票日期": "20260125",
 "发票状态": "已开票",
 "支付方式": "后付费",
      "OBU序列号": "00049000000836932426",
      "排放标准": "欧6",
 "合同ID": "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 端点参考

通行费交易

端点	方法	描述
/toll-data/v1/transactions/search	POST	通过灵活的筛选和分页功能检索通行费交易数据

常见用例：

按日期范围检索通行费交易记录
按发票状态筛选（已开票、未开票、全部）
按车辆注册号 (VRN) 搜索
按卡组筛选
按多个条件排序交易记录
选择特定字段以优化响应大小

常见用例

本节将常见业务场景与 API 使用模式进行映射，以帮助您快速确定如何根据 API以满足您的具体需求。

用例 1：每日通行费交易对账

场景： 出于会计核算目的，您需要每天对车队中的所有通行费交易进行对账。

推荐API： /toll-data/v1/transactions/search

为何选择此 API： 该端点提供全面的通行费交易详情，支持灵活的日期筛选，同时涵盖已开票和未开票交易，并针对大型数据集提供分页功能。非常适合日常对账工作流程。

关键参数：

FromDate 和 ToDate - 进行每日对账时，请设置为昨天的日期
Search.InvoiceStatus - 选择“全部”以同时包含已开票和未开票的交易
PageSize - 设置为 100 以实现高效的数据检索
Filter - 选择“全部”以获取完整的交易详情