茂阳
  1. 订单-退货单
茂阳
  • 蔬东坡开放平台API文档
    • 什么是蔬东坡开放平台
    • 开发入门
      • API调用协议
      • 签名生成规则
    • 基础数据接口
      • 获得全部站点
      • 发货时间段列表
      • 用户类型列表
      • 商品分类列表
      • 获得全部仓库
      • 业务员新增
      • 获取采购员、供应商数据
      • 区域列表
      • 供应商新增
      • 商品单位列表
      • 业务员列表
    • 库房
      • 订单发货出库
      • 批次库存列表
    • 商品
      • 商品标签
      • 编辑商品分类
      • 新增商品分类
      • 删除商品分类
      • 新建商品
      • 搜索商品
      • 更新商品
    • 订单
      • 新增实收变更
      • 订单标签
      • 查询实收变更详情
      • 订单商品标签查询
      • 搜索订单
      • 批量创建订单
      • 新建订单
      • 完成订单
      • 订单关闭
      • 获取配送信息
    • 采购单
      • 新增采购单
      • 采购单收货
      • 采购单查询
      • 编辑采购单
    • 客户协议价
      • 客户类型列表
      • 协议价详情
      • 客户协议价列表
    • 客户
      • 获取下单商品信息
      • 获取线路列表
      • 新增客户
      • 获取集团列表
      • 搜索客户
    • 异步通知
      • 通知参数说明
    • 订单-退货单
      • 退货单列表
        GET
      • 退货单详情
        GET
      • 创建退货单
        POST
      • 审核拒绝退货单
        POST
    • 商品-溯源
      • 查询商品溯源
    • 出、入库单查询
      • 入库单查询
      • 出库单查询
    • 客户类型
      • 获得可下单商品列表
    • 现有库存查询
      • 现有库存查询
    • 库房-分拣
      • 分拣条形码获取订单明细
    • 采购-退货单
      • 搜索采购退货单
      • 保存采购退货单
    • 财务
      • 采购结算单列表
      • 客户结算单列表
  1. 订单-退货单

退货单列表

GET
/openApi/order/returnList

请求参数

Query 参数
timestamp
integer 
当前时间戳
必需
示例值:
{{timestamp}}
appid
string 
必需
open_appid_api,由服务端分配唯一标示appid
sign
string 
签名参数(32位)
必需
示例值:
{{sign}}
notice
string 
可选
site_id
string 
站点
可选
page
string 
页码
可选
page_size
string 
每页大小
可选
store_id
string 
仓库ID
可选
return_no
string 
退货单号
可选
return_type
string 
退货单类型
可选
user_code
string 
客户编码
可选
status
string 
可选
退货单状态 (100:待审核,1:已审核, 2:待入库,3:待退款, 4:已完成, 5:已关闭, 101包含待审核、待入库、待退款)
start_time
string 
可选
退货单创建日期-开始
end_time
string 
可选
退货单创建日期-结束
start_date
string 
可选
源订单发货日期-开始
end_date
string 
可选
源订单发货日期-截止
return_start_date
string 
退货日期-开始
可选
return_end_date
string 
退货日期-截止
可选
audit_start_time
string 
可选
开始审核时间,13.8.0及以上版本支持
audit_end_time
string 
可选
结束审核时间,13.8.0及以上版本支持
refer_id
string 
业务员id
可选
commodity_id
string 
商品ID
可选
source
string 
可选
订单来源 1 后台 2 微信 3 PC商城 4 商城app 5 分拣APP 6 供应商H5 7 小程序 8 供应商PC 9 开放API 11 支付宝服务号 12 配送APP 13 PC集团 14 支付回调 15 集采平台
start_update_time
array[string]
可选
更新时间, 搜索起始时间
示例值:
[]
end_update_time
string 
可选
更新时间, 搜索起始时间

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://basesfpstest.sdongpo.com/openApi/order/returnList?timestamp={{timestamp}}&appid=&sign={{sign}}&notice&site_id&page&page_size&store_id&return_no&return_type&user_code&status&start_time&end_time&start_date&end_date&return_start_date&return_end_date&audit_start_time&audit_end_time&refer_id&commodity_id&source&end_update_time'

返回响应

🟢200成功
application/json
Body
status
integer 
必需
data
object 
必需
list
array [object {28}] 
必需
pageParams
object 
必需
sum
object 
必需
message
string  | null 
必需
示例
{
    "status": 1,
    "data": {
        "list": [
            {
                "id": "185",
                "user_id": "2020",
                "order_id": "2267",
                "delivery_date": "2024-11-27",
                "type": "0",
                "status": "100",
                "price": "0.50",
                "actual_price": "0.00",
                "store_id": "1001",
                "store_in_id": "0",
                "remark": "货物变质、损坏",
                "audit_opinion": "",
                "create_time": "2024-11-26 18:06:50",
                "op_id": "2",
                "site_id": "6",
                "shop_name": "首单客户",
                "user_name": "首单客户",
                "user_code": "67459be029c68",
                "order_no": "DD241126180521653708",
                "return_no": "RT24112618983721",
                "status_desc": "待审核",
                "order_create_time": "2024-11-26 18:05:21",
                "store_in_no": null,
                "account_tel": "15368951111",
                "store_name": "默认库房岳麓区中电软件园",
                "source": "1",
                "update_time": "2025-03-25 10:41:15",
                "source_txt": "后台"
            }
        ],
        "pageParams": {
            "page": "1",
            "total_page": 176,
            "page_size": "1",
            "count": "176"
        },
        "sum": {
            "price": "1953.48",
            "actual_price": "1287.66",
            "return_service_charge": "105.90",
            "true_actual_price": "1393.56"
        }
    },
    "message": null
}
上一页
通知参数说明
下一页
退货单详情
Built with