1. 订单-退货单
蔬东坡开放平台V2版本
  • 蔬东坡开发平台V2版本文档
    • 什么是蔬东坡开放平台
    • 开发指南
      • 接入说明
      • API调用协议
    • API列表
      • 鉴权
        • 获取access_token
      • 商品
        • 新增分类
        • 编辑分类
        • 删除分类
        • 获取分类
        • 获取商品单位
        • 新增商品
        • 获取商品SPU
        • 编辑商品
        • 获取商品客户类型价
        • 获取商品SKU
      • 客户
        • 新增客户
        • 获取客户列表
        • 获取客户类型列表
        • 集团列表
      • 采购员
        • 获取采购员
        • 新增采购员
      • 供应商
        • 新增供应商
        • 获取供应商
      • 库房
        • 现有库存查询
        • 入库列表
        • 出库详情
        • 出库列表
        • 入库详情
      • 订单
        • 创建订单
        • 获取订单列表
        • 获取订单详情
        • 获取订单标签
        • 完成订单
        • 关闭订单
        • 实收变更列表
        • 批量创建订单
        • 创建实收变更
        • 实收变更详情
        • 获取配送信息
        • 编辑订单(不支持重复商品)
        • 第三方单号查询
        • 创建实收变更(不支持重复商品)
      • 配送
        • 获取区域列表
        • 获取线路列表
        • 获取区域线路关系列表
        • 获取送货时间段
      • 采购
        • 采购列表
        • 采购单详情
        • 采购单创建
        • 采购收货保存
        • 采购单确认收货
      • 系统
      • 基础数据接口
        • 获得全部站点
        • 业务员列表
        • 获取所有仓库
        • 获取自定义字段列表
      • 订单-退货单
        • 创建退货单
          POST
        • 退货单列表
          GET
        • 退货单详情
          GET
        • 编辑退货单
          POST
      • 财务
        • 客户对账列表
        • 采购对账列表
        • 客户对账详情
        • 采购对账详情
        • 支付列表
        • 客户结算
        • 采购结算
      • 客户商品
        • 获取客户商品价格
      • 采购-退货单
        • 采购退货单列表
      • 协议价
        • 客户协议价
        • 客户协议价详情
        • 采购协议价
        • 采购协议价详情
      • 异步通知
        • 通知参数说明
      • 溯源
        • 获取溯源信息
    • API主要场景
      • 如何创建一个商品
      • 如何创建订单
      • 创建商城订单
    • 常见问题
      • 蔬东坡开放平台 V2 常见问题知识库
    • API升级公告
      • 16.8.0版本更新
      • 16.9.0版本更新
      • 17.0.0版本更新
      • 17.1.0版本更新
      • 17.2.0版本更新
      • 17.3.0版本更新
      • 17.5.0 版本更新
  • 数据模型
    • CustomizeFieldInput
    • PurchaseReceiptRequest
    • CustomizeFieldValue
    • PurchaseReceiptCommodity
    • PurchaseReceiptCost
    • PurchaseReceiptSuccessResponse
    • ErrorResponse
  1. 订单-退货单

创建退货单

POST
/openApiV2/OrderReturn/Create
该接口主要用于退货单创建
接口最大支持qps2
错误码释义
错误码错误内容解决方法
400320业务异常,具体以message内容为准---

请求参数

Header 参数

Body 参数application/json

示例
{
    "source_order_no": "DD260821192905015888",
    "order_id": 20614,
    "user_id": 1732,
    "return_date": "2026-08-20",
    "reason": "质量不好",
    "commodity_list": [
        {
            "order_commodity_id": 142071,
            "commodity_id":4700,
            "quantity": 0.01,
            "price": 6,
            "remark": "",
            "unit": "斤",
            "customize_fields": [
                {
                    "key": "customize_field_292",
                    "name": "【申请退货价】",
                    "value": 6,
                    "select_id": ""
                },
                {
                    "key": "customize_field_299",
                    "name": "【明细假数值】",
                    "value": 2.22,
                    "select_id": ""
                },
                {
                    "key": "customize_field_300",
                    "name": "【申请退货数】",
                    "value": 1,
                    "select_id": ""
                },
                {
                    "key": "customize_field_301",
                    "name": "【申请退货单价】",
                    "value": 6,
                    "select_id": ""
                },
                {
                    "key": "customize_field_302",
                    "name": "【申请退货金额】",
                    "value": 6,
                    "select_id": ""
                },
                {
                    "key": "customize_field_303",
                    "name": "【审批数】",
                    "value": "",
                    "select_id": ""
                },
                {
                    "key": "customize_field_304",
                    "name": "【审批单价】",
                    "value": 6,
                    "select_id": ""
                },
                {
                    "key": "customize_field_305",
                    "name": "【审批金额】",
                    "value": "",
                    "select_id": ""
                },
                {
                    "key": "customize_field_308",
                    "name": "【退货备注】",
                    "value": "1",
                    "select_id": ""
                },
                {
                    "key": "customize_field_309",
                    "name": "【明细退货理由】",
                    "value": "不乐意要",
                    "select_id": "59"
                },
                {
                    "key": "customize_field_311",
                    "name": "【计算申请单价】",
                    "value": 6,
                    "select_id": ""
                },
                {
                    "key": "customize_field_312",
                    "name": "【计算审批单价】",
                    "value": "",
                    "select_id": ""
                }
            ]
        }
    ],
    "customize_fields": [
        {
            "id": "285",
            "key": "customize_field_285",
            "name": "【退货事项备注】",
            "type": "1",
            "value": "单据备注",
            "select_id": ""
        },
        {
            "id": "286",
            "key": "customize_field_286",
            "name": "【退货运费】",
            "type": "4",
            "value": 2.5,
            "select_id": ""
        },
        {
            "id": "287",
            "key": "customize_field_287",
            "name": "退货原因【自】",
            "type": "2",
            "value": "多送了",
            "select_id": "46"
        },
        {
            "id": "288",
            "key": "customize_field_288",
            "name": "【申请退货均价】",
            "type": "3",
            "select_id": ""
        },
        {
            "id": "295",
            "key": "customize_field_295",
            "name": "【申请退货数合计】",
            "type": "3",
            "select_id": ""
        },
        {
            "id": "296",
            "key": "customize_field_296",
            "name": "【申请退货金额合计】",
            "type": "3",
            "value": 0,
            "select_id": ""
        },
        {
            "id": "297",
            "key": "customize_field_297",
            "name": "【审批数合计】",
            "type": "3",
            "select_id": ""
        },
        {
            "id": "298",
            "key": "customize_field_298",
            "name": "【审批金额合计】",
            "type": "3",
            "select_id": ""
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://scm.sdongpo.com/cc_thirdparty/openApiV2/OrderReturn/Create' \
--header 'Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJvcGVuQXBpVjIiLCJpYXQiOjE3ODczNjY5NDEsImV4cCI6MTc4NzQ1MzM0MSwiY2xhaW0iOnsiYXV0aF9hY2NvdW50X2lkIjowLCJjbGllbnRfaWQiOiIyY2YyMWM2MjNjMTZhMzVmIiwiY2xpZW50X3R5cGUiOjAsImF1dGhfdHlwZSI6MCwic2l0ZV9pZCI6IjYiLCJpc19hbGxvd2VkIjpudWxsLCJzaW5nbGVfaWQiOiIyY2YyMWM2MjNjMTZhMzVmNiJ9fQ.Qrz6QDUSfzjK8C8jfHHtWemuWTIDdJ1NLe0W0I3RohvmlvFGn_xjAIpRAiVSagM7Q_kDYT-l29NXaKKieCAyBmz6s40gM-QuAAbb5-e5cLiKmqBluOknnnrFSCcqvK_wbyI6UVwOxoA4NUloDkJi0zTSubd4hjOTIt376Utycv2zNUlNMPnby05y7WD26LlPUHBRebYowM38yzKU1b_2GtWHjgxlmVn0nOePf0rhzngcVykUgFhBrw7CP5AvQ7JuCnfHzU_oEOjRQa9Frjln0V9L9AEA-M-TeFZuHXv-aJYeLplzs5vN62f9J6qCvAqw43n0Yb8RuJwKnzMkcDrwuA' \
--header 'X-Request-Id: 921e69818917335cebcd1da7ecb8d863' \
--header 'Content-Type: application/json' \
--data '{
    "source_order_no": "DD260821192905015888",
    "order_id": 20614,
    "user_id": 1732,
    "return_date": "2026-08-20",
    "reason": "质量不好",
    "commodity_list": [
        {
            "order_commodity_id": 142071,
            "commodity_id":4700,
            "quantity": 0.01,
            "price": 6,
            "remark": "",
            "unit": "斤",
            "customize_fields": [
                {
                    "key": "customize_field_292",
                    "name": "【申请退货价】",
                    "value": 6,
                    "select_id": ""
                },
                {
                    "key": "customize_field_299",
                    "name": "【明细假数值】",
                    "value": 2.22,
                    "select_id": ""
                },
                {
                    "key": "customize_field_300",
                    "name": "【申请退货数】",
                    "value": 1,
                    "select_id": ""
                },
                {
                    "key": "customize_field_301",
                    "name": "【申请退货单价】",
                    "value": 6,
                    "select_id": ""
                },
                {
                    "key": "customize_field_302",
                    "name": "【申请退货金额】",
                    "value": 6,
                    "select_id": ""
                },
                {
                    "key": "customize_field_303",
                    "name": "【审批数】",
                    "value": "",
                    "select_id": ""
                },
                {
                    "key": "customize_field_304",
                    "name": "【审批单价】",
                    "value": 6,
                    "select_id": ""
                },
                {
                    "key": "customize_field_305",
                    "name": "【审批金额】",
                    "value": "",
                    "select_id": ""
                },
                {
                    "key": "customize_field_308",
                    "name": "【退货备注】",
                    "value": "1",
                    "select_id": ""
                },
                {
                    "key": "customize_field_309",
                    "name": "【明细退货理由】",
                    "value": "不乐意要",
                    "select_id": "59"
                },
                {
                    "key": "customize_field_311",
                    "name": "【计算申请单价】",
                    "value": 6,
                    "select_id": ""
                },
                {
                    "key": "customize_field_312",
                    "name": "【计算审批单价】",
                    "value": "",
                    "select_id": ""
                }
            ]
        }
    ],
    "customize_fields": [
        {
            "id": "285",
            "key": "customize_field_285",
            "name": "【退货事项备注】",
            "type": "1",
            "value": "单据备注",
            "select_id": ""
        },
        {
            "id": "286",
            "key": "customize_field_286",
            "name": "【退货运费】",
            "type": "4",
            "value": 2.5,
            "select_id": ""
        },
        {
            "id": "287",
            "key": "customize_field_287",
            "name": "退货原因【自】",
            "type": "2",
            "value": "多送了",
            "select_id": "46"
        },
        {
            "id": "288",
            "key": "customize_field_288",
            "name": "【申请退货均价】",
            "type": "3",
            "select_id": ""
        },
        {
            "id": "295",
            "key": "customize_field_295",
            "name": "【申请退货数合计】",
            "type": "3",
            "select_id": ""
        },
        {
            "id": "296",
            "key": "customize_field_296",
            "name": "【申请退货金额合计】",
            "type": "3",
            "value": 0,
            "select_id": ""
        },
        {
            "id": "297",
            "key": "customize_field_297",
            "name": "【审批数合计】",
            "type": "3",
            "select_id": ""
        },
        {
            "id": "298",
            "key": "customize_field_298",
            "name": "【审批金额合计】",
            "type": "3",
            "select_id": ""
        }
    ]
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "status": 1,
    "data": {
        "return_no": "RT25051618578255",
        "return_id": "913"
    },
    "errCode": 0,
    "message": ""
}
修改于 2026-08-25 08:40:56
上一页
获取自定义字段列表
下一页
退货单列表
Built with