大麦家礼品代发API

# 查询退款单列表(卖家视角)

接口地址： http://www.damaijia168.com/vv/external/1688order-refund-list

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

参数 类型 必选 值 示例
Authorization string 是 授权 access_token 1798c6aadec33d1bc2f5b707f1049aefexxxx

# 请求参数

参数 类型 必选 描述
order_id int 否 订单Id
apply_start_time string 否 退款申请时间（起始）
apply_end_time string 否 退款申请时间(截止)
refund_status_set java.util.Set 否 退款状态列表
buyer_member_id string 否 买家memberId
buyer_login_id string 否 买家loginId
current_page_num int 否 查询页码，起始页码为0
page_size int 否 页大小
logistics_no string 否 退货运单号
modify_start_time string 否 退款修改时间(起始)
modify_end_time string 否 退款修改时间(截止)
dipsute_type int 否 1:售中退款，2:售后退款；0:所有退款单
edition string 否 版本 默认:1(不传默认为1)
1:1.0,2:2.0

# 请求示例

{

}

# 请求代码示例

cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例

# 响应参数

名称 类型 描述
data object 数据信息
--op_order_refund_models array 退款单列表
----aftersale_agree_timeout bool 售后超时标记
----aftersale_auto_disburse bool 售后自动打款
----alipay_payment_id string 支付宝交易号
----apply_carriage int 运费的申请退款金额，单位：分
----apply_expect int 买家原始输入的退款金额(可以为空)
----apply_payment int 买家申请退款金额，单位：分
----apply_reason string 申请原因
----apply_reason_id int 申请原因ID
----apply_sub_reason string 二级退款原因
----apply_sub_reason_id int 二级退款原因Id
----asyn_err_code string
----asyn_sub_err_code string
----buyer_alipay_id string 买家支付宝ID
----buyer_logistics_name string 买家退货物流公司名
----buyer_member_id string 买家会员ID
----buyer_send_goods bool 买家是否已经发货（如果有退货的流程）
----buyer_user_id int 买家阿里帐号ID(包括淘宝帐号Id)
----can_refund_payment int 最大能够退款金额，单位：分
----crm_modify_refund bool 是否小二修改过退款单
----disburse_channel string 极速到账打款渠道
----dispute_request int 售后退款要求
----dispute_type int 纠纷类型：售中退款 售后退款，默认为售中退款
----ext_info object 扩展信息
----freight_bill string 运单号
----frozen_fund long 实际冻结账户金额,单位：分
----gmt_apply string 申请退款时间
----gmt_completed string 完成时间
----gmt_create string 创建时间
----gmt_freezed string 该退款单超时冻结开始时间
----gmt_modified string 修改时间
----gmt_time_out string 该退款单超时完成的时间期限
----goods_received bool 买家是否已收到货
----goods_status int 1：买家未收到货 2：买家已收到货 3：买家已退货
----id int 退款单编号
----instant_refund_type string 极速到账退款类型
----insufficient_account bool 交易4.0退款余额不足
----insufficient_bail bool 极速到账退款保证金不足
----new_refund_return bool 是否新流程创建的退款退货
----only_refund bool 是否仅退款
----order_entry_count_map object 子订单退货数量
----order_entry_id_list array 退款单包含的订单明细，时间逆序排列
----order_id int 退款单对应的订单编号
----prepaid_balance int 极速退款垫资金额,该值不为空时,只代表该退款单可以走垫资流程,但不代表一定垫资成功
----product_name string 产品名称(退款单关联订单明细的货品名称)
----refund_carriage int 运费的实际退款金额，单位：分
----refund_goods bool 是否要求退货
----refund_id string 退款单逻辑主键
----refund_payment int 实际退款金额，单位：分
----reject_reason string 卖家拒绝原因
----reject_reason_id int 卖家拒绝原因Id
----reject_times int 退款单被拒绝的次数
----seller_alipay_id string 卖家支付宝ID
----seller_delay_disburse bool 是否卖家延迟打款，即安全退款
----seller_member_id string 卖家会员ID
----seller_mobile string 收货人手机
----seller_real_name string 收货人姓名
----seller_receive_address string 买家退货时卖家收货地址
----seller_tel string 收货人电话
----seller_user_id int 卖家阿里帐号ID(包括淘宝帐号Id)
----status string 退款状态
----support_new_steppay bool 是否支持交易4.0
----task_status string 工单子状态，没有流到CRM创建工单时为空
----time_out_freeze bool 是否超时系统冻结，true代表冻结，false代表不冻结
----time_out_operate_type string 超时后执行的动作
----trade_type_str string 交易类型，用来替换枚举类型的tradeType
----refund_operation_list array 操作记录列表
------after_operate_status string 操作后的退款状态
------before_operate_status string 操作前的退款状态
------close_refund_step_id long 分阶段订单正向操作关闭退款时的阶段ID
------crm_modify_refund bool 是否小二修改过退款单
------discription string 描述、说明
------email string 联系人EMAIL
------freight_bill string 运单号
------gmt_create string 创建时间
------gmt_modified string 修改时间
------id int 主键，退款操作记录流水号
------message_status int 凭证状态，1:正常 2:后台小二屏蔽
------mobile string 联系人手机
------msg_type int 留言类型 3:小二留言给买家和卖家 4:给买家的留言 5:给卖家的留言 7:cbu的普通留言等同于淘宝的1
------operate_remark string 操作备注
------operate_type_int int 操作类型 取代operateType
------operator_id string 操作者-memberID
------operator_login_id string 操作者-loginID
------operator_role_id int 操作者角色名称 买家 卖家 系统
------operator_user_id int 操作者-userID
------phone string 联系人电话
------refund_address string 退货地址
------refund_id string 退款记录ID
------reject_reason string 卖家拒绝退款原因
------vouchers array 凭证图片地址
------logistics_company object 物流公司详情
--------company_name string 快递公司名
--------company_no string 物流公司编号
--------company_phone string 物流公司服务电话
--------gmt_create string 创建时间
--------gmt_modified string 修改时间
--------id int ID
--------spelling string 全拼
--------support_print bool 是否支持打印
----buyer_login_id string 买家LoginId
----seller_login_id string 卖家LoginId
----total_count int 符合条件总的记录条数
----current_page_num int 查询的当前页码
--deduct_money int 消耗点券
status int 状态码，0为成功

# 返回数据

{
"data": {
    "deduct_money":1,
    "op_order_refund_models": [
      {
        "alipay_payment_id": "2018061421001008760569923894",
        "apply_carriage": 0,
        "apply_payment": 1,
        "apply_reason": "不想买了，已与卖家协商一致",
        "apply_reason_id": 20028,
        "apply_sub_reason_id": -1,
        "buyer_member_id": "b2b-1624961198",
        "buyer_user_id": 1624961198,
        "can_refund_payment": 1,
        "dispute_request": 3,
        "dispute_type": 1,
        "ext_info": {
          "exmrf": "1",
          "ttid": "2",
          "reason": "20028",
          "applytextid": "null",
          "new_refund": "rp2",
          "biz_code": "cbu.general.refund",
          "last_order": "0",
          "selleragreedrefundfee": "1",
          "oldreasonid": "20028",
          "b2bsellerm_id": "b2b-1623492085",
          "sellerbatch": "true",
          "item_buy_amount": "0",
          "b2bbuyerm_id": "b2b-1624961198",
          "ability": "1",
          "selleraudit": "0",
          "eetraceid": "0ab2dbd215300798520175927d07d3",
          "oltf": "0",
          "op_role": "timeout",
          "applyinitrefundfee": "1",
          "is_virtual": "0",
          "logistics_company_id": "-1",
          "item_price": "0",
          "intercept_status": "0",
          "refund_from": "2",
          "restart_for_xiaoer": "1",
          "app_name": "tosp-aftersales",
          "abnormaldisputestatus": "0",
          "pay_mode": "alipay",
          "workflow_name": "cbureturnandrefund",
          "sgr": "1",
          "enfunddetail": "1",
          "bgmtc": "2018-06-14 14: 20: 21"
        },
        "frozen_fund": -1,
        "gmt_apply": "20180622141034000+0800",
        "gmt_completed": "20180702141113000+0800",
        "gmt_create": "20180622141034000+0800",
        "gmt_modified": "20180702141113000+0800",
        "goods_status": 2,
        "id": 10426553019961198,
        "order_id": 177681528398969820,
        "product_name": "短袖撞色领保罗衫定做纯棉广告衫定制印字logo刺绣男现货批发 白色/橙领 s等3种",
        "refund_carriage": 0,
        "refund_id": "tq10426553019961198",
        "refund_payment": 1,
        "reject_reason_id": 0,
        "reject_times": 0,
        "seller_member_id": "b2b-1623492085",
        "seller_user_id": 1623492085,
        "status": "refundclose"
      }
    ],
    "total_count": 1,
    "current_page_num": 0
  },
  "status": 0
}

# 响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时，请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误，请联系客服 检查您的接口地址填写是否正确，其他问题联系客服解决
203 暂不支持当前接口
204 请求异常：无该接口权限，请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常：API调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权

← 6-8_1688-取消交易 →