2.8 运费账单批量更新接口

请求URL

• {domain}/open-api/jt/wallet/update/delivery/bill

请求方式

• POST

请求头

参数名	必选	类型	说明
Content-Type	是	string	application/json

请求体参数

参数名	必选	类型	说明
appId	是	string	Application APPID
param	是	string	Parameter body
sign	是	string	Signature

param 参数

参数名	必选	类型	长度	示例	说明
timestamp	是	long	-	1677495496979	毫秒时间戳
billOrderIdList	是	List	5000	-	极兔运费账单编号
billFinalDate	是	string	-	-	运费账单最迟结算日期（不能小于当日）

请求示例

请求体

{
  "appId": "733b887a4a784708bb369524db5b6ded",
  "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
  "param": "{\"timestamp\":1715595802,\"billOrderIdList\":[\"BillOrder001\",\"BillOrder002\"],\"billFinalDate\":\"2024-06-28\"}"
}

How to construct request body

---

响应参数

参数名	类型	说明
code	integer	response code
message	string	response message
data	List	data

data参数

参数名	类型	说明
jtUuid	string	极兔用户uuid
uuid	string	钱包用户uuid
billOrderId	string	极兔Delivery商户订单号
billNumber	string	钱包侧Delivery流水号
billFinalDate	string	运费账单最迟结算日期
failCode	integer	错误码
failReason	string	错误信息

响应示例

响应数据体

{
  "code": 10000,
  "message": "Success",
  "data": [{
    "billOrderId": "BillOrder001", 
    "billNumber": "BillNumber001", 
    "billFinalDate": "2025-06-12",
    "failCode": null,
    "failReason":  null
    },
    {
      "billOrderId": "BillOrder002", 
      "billNumber": null, 
      "billFinalDate": null,
      "failCode": 21703,
      "failReason":  "Delivery bill not found"
    }]
}

Code Collection

失败响应示例

{
  "code": 1002,
  "message": "merchant white ip forbidden"
}