大麦家礼品代发API

# 查询退款单详情-根据退款单ID

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

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

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

# 请求参数

参数 类型 必选 描述
refund_id string 是 退款单业务主键 TQ+ID
need_time_out_info bool 否 需要退款单的超时信息
need_order_refund_operation bool 否 需要退款单伴随的所有退款操作信息
edition string 否 版本 默认:1(不传默认为1)
1:1.0,2:2.0

# 请求示例

{
    "refund_id": "TQ865149372**61198",
    "need_time_out_info": true,
    "need_order_refund_operation": true
}

# 请求代码示例

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

# 响应参数

名称 类型 描述
data object 数据信息
--op_order_refund_model_detail object 退款模型
----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
--deduct_money int 消耗点券
status int 状态码，0为成功

# 返回数据

{
"data": {
  "deduct_money":1,
    "op_order_refund_model_detail": {
      "alipay_payment_id": "2018042321001008760555342267",
      "apply_carriage": 0,
      "apply_payment": 1,
      "apply_reason": "颜色/图案/款式不符",
      "apply_reason_id": 20021,
      "apply_sub_reason_id": 0,
      "buyer_logistics_name": "其他",
      "buyer_member_id": "b2b-1624961198",
      "buyer_send_goods": true,
      "buyer_user_id": 1624961198,
      "can_refund_payment": 1,
      "crm_modify_refund": false,
      "dispute_request": 3,
      "dispute_type": 1,
      "ext_info": {
        "exmrf": "1",
        "ttid": "2",
        "prepaid_failure": "querybuyercreditlevelfail",
        "paylock": "seller",
        "reason": "20021",
        "applytextid": "null",
        "new_refund": "rp2",
        "biz_code": "cbu.general.refund",
        "dispute_trade_status": "4",
        "last_order": "0",
        "selleragreedrefundfee": "1",
        "oldreasonid": "20021",
        "sync": "0",
        "b2bsellerm_id": "b2b-1623492085",
        "sellerbatch": "true",
        "item_buy_amount": "0",
        "b2bbuyerm_id": "b2b-1624961198",
        "ability": "1",
        "refund_post_fee": "0",
        "selleraudit": "0",
        "eetraceid": "0b802ca915244768332374685efa19",
        "oltf": "1",
        "op_role": "user",
        "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",
        "seller_do_refund_nick": "alitestforisv01",
        "bgmtc": "2018-04-23 09: 48: 12"
      },
      "freight_bill": "12345134135435234",
      "frozen_fund": -1,
      "gmt_apply": "20180423171116000+0800",
      "gmt_completed": "20180423174713000+0800",
      "gmt_create": "20180423171116000+0800",
      "gmt_modified": "20180423174714000+0800",
      "goods_received": true,
      "goods_status": 3,
      "id": 8651493722961198,
      "new_refund_return": true,
      "only_refund": false,
      "order_entry_count_map": {
        "151267031009969811": 2
      },
      "order_entry_id_list": [151267031009969811],
      "order_id": 151267031008969811,
      "product_name": "欧洲站2018新款宽松显瘦烫金印花字母老鹰短袖t恤打底裤套装女潮",
      "refund_carriage": 0,
      "refund_goods": true,
      "refund_id": "tq8651493722961198",
      "refund_payment": 1,
      "reject_reason_id": 0,
      "reject_times": 0,
      "seller_delay_disburse": false,
      "seller_member_id": "b2b-1623492085",
      "seller_mobile": "19926555555",
      "seller_real_name": "琳琳",
      "seller_receive_address": "山东 聊城 解决了交流交流链接连接",
      "seller_user_id": 1623492085,
      "status": "refundsuccess",
      "support_new_steppay": true,
      "time_out_freeze": false,
      "trade_type_str": "50060",
      "refund_operation_list": [{
        "after_operate_status": "waitsellerreceive",
        "before_operate_status": "waitsellerreceive",
        "close_refund_step_id": 0,
        "crm_modify_refund": false,
        "discription": "卖家同意退货退款协议，退货退款成功",
        "gmt_create": "20180423174714000+0800",
        "gmt_modified": "20180423174714000+0800",
        "id": 50027795018,
        "message_status": 3,
        "msg_type": 7,
        "operate_remark": "退款成功",
        "operate_type_int": 8,
        "operator_login_id": "alitestforisv01",
        "operator_role_id": 2,
        "operator_user_id": 1623492085,
        "refund_id": "tq8651493722961198"
      },
      {
        "after_operate_status": "waitbuyersend",
        "before_operate_status": "waitbuyersend",
        "close_refund_step_id": 0,
        "crm_modify_refund": false,
        "discription": "买家声明退货，等待卖家确认。|物流公司：其他|物流单号：12345134135435234|说明：asdada|",
        "gmt_create": "20180423174651000+0800",
        "gmt_modified": "20180423174651000+0800",
        "id": 50027571423,
        "message_status": 3,
        "msg_type": 7,
        "operate_remark": "买家退货",
        "operate_type_int": 10,
        "operator_login_id": "alitestforisv02",
        "operator_role_id": 1,
        "operator_user_id": 1624961198,
        "refund_id": "tq8651493722961198"
      },
      {
        "after_operate_status": "waitselleragree",
        "before_operate_status": "waitselleragree",
        "close_refund_step_id": 0,
        "crm_modify_refund": false,
        "discription": "卖家确认收货地址：琳琳,
        19926555555,
        山东 聊城 解决了交流交流链接连接",
        "gmt_create": "20180423174544000+0800",
        "gmt_modified": "20180423174544000+0800",
        "id": 49967844797,
        "message_status": 3,
        "msg_type": 7,
        "operate_remark": "确认收货地址",
        "operate_type_int": 19,
        "operator_login_id": "alitestforisv01",
        "operator_role_id": 2,
        "operator_user_id": 1623492085,
        "refund_id": "tq8651493722961198"
      },
      {
        "close_refund_step_id": 0,
        "crm_modify_refund": false,
        "discription": "退款诉求：退货退款|申请原因：颜色/图案/款式不符|货品情况：已收到货|退款货品金额：0.01|退款运费金额：0.00|退款说明：asdad",
        "gmt_create": "20180423171116000+0800",
        "gmt_modified": "20180423171116000+0800",
        "id": 49962356896,
        "message_status": 3,
        "msg_type": 7,
        "operate_remark": "买家申请退款协议，等待卖家确认",
        "operate_type_int": 1,
        "operator_login_id": "alitestforisv02",
        "operator_role_id": 1,
        "operator_user_id": 1624961198,
        "refund_id": "tq8651493722961198"
      }],
      "buyer_login_id": "alitestforisv02",
      "seller_login_id": "alitestforisv01"
    },
    "status": 0
}

# 响应代码

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

← 6-f_1688-根据地址解析地区码 →