Lingxing
切换旧版

查询订单已退货数量

POST/basicOpen/customerService/returnOrder/getReturnQty

根据系统单号或商品行号查询订单商品的已退货数量。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/customerService/returnOrder/getReturnQtyHTTPSPOST1

请求参数

globalOrderNointeger
系统单号,与 orderItemNo 至少传一个;来源:查询订单管理订单列表 返回的 data>>list>>global_order_no
orderItemNoarray<any>
商品行号,与 globalOrderNo 至少传一个;来源:查询订单管理订单列表 返回的 data>>list>>item_info>>order_item_no

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/customerService/returnOrder/getReturnQty?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
  "globalOrderNo": 103290951812762112
}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-09-01 12:00:00
dataobject必填
响应数据
隐藏子属性
globalOrderNointeger必填
系统单号
示例 103290951812762110
returnQtyarray<object>必填
已退货数量集合
隐藏子属性
numinteger必填
已退货数量
示例 1
orderItemNostring必填
商品行号
示例 ITEM-001
pidinteger必填
本地产品ID
示例 1

返回成功示例

{
  "code": 0,
  "message": "success",
  "error_details": [],
  "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
  "response_time": "2026-09-01 12:00:00",
  "data": {
    "globalOrderNo": 103290951812762112,
    "returnQty": [
      {
        "num": 1,
        "orderItemNo": "ITEM-001",
        "pid": 1
      }
    ]
  }
}