V兔API开放平台

参数	类型	必选	描述
shop_id	string	是	店铺 id
order_id	String	否	订单 ID
aftersale_type	Int64	否	售后类型，枚举为 0(退货退款),1(已发货仅退款),2(未发货仅退款),3(换货)
aftersale_status	Int64	否	售后状态，枚举为 2(发货前退款待处理),3(发货后仅退款待处理),4(退货待处理),5(换货待处理),6(同意退款，退款失败),7(同意退款，退款成功),8(待商家处理),9(待商家收货),10(同意退款，退款中),11(仲裁中),12(售后关闭),13(待买家退货),14(等待用户收货),15(换货成功),16(拒绝售后),17(退货后拒绝退款),18(待商家上传凭证),19(仲裁中-待商家举证),20(仲裁中-待商家举证或协商期)
reason	Int64	否	售后理由分类，枚举为 1(七天无理由退货),2(非七天无理由退货)
logistics_status	Int64	否	退货物流状态，枚举为 1(全部),2(已发货),3(未发货)
pay_type	Int64	否	付款方式，枚举为 1(全部), 2(货到付款),3(线上付款)
refund_type	Int64	否	退款类型，枚举为 0(原路退款),1(线下退款),2(备用金),3(保证金),4(无需退款)
arbitrate_status	List	否	仲裁状态，枚举为 0(未介入),1(客服处理中),2(仲裁结束-支持买家),3(仲裁结束-支持卖家),4(待商家举证),5(待与买家协商),6(仲裁结束),255(取消)
order_flag	List	否	订单插旗
start_time	Int64	否	申请时间开始，单位为秒
end_time	Int64	否	申请时间结束，单位为秒
amount_start	Int64	否	金额下限，单位为分
amount_end	Int64	否	金额上限，单位为分
risk_flag	Int64	否	风控标签，枚举为-1(退货正常),1(退货异常)
order_by	List	否	排序方式，优先级按照列表顺序从前往后依次减小，写法为"< 字段名称 > < 排序方式 >"，字段名称目前支持"status_deadline"（逾期时间）和"apply_time"（申请时间），排序方式目前支持"asc"（升序）和"desc"（降序）。按照"逾期时间"升序排列，会优先返回临近逾期时间的数据。
page	Int64	是	页数，从 0 开始
size	Int64	是	每页数量，最多 500 个
aftersale_id	String	否	售后 ID
vvtype	int	否	普通版 1，增强版 2，专业版 3，无效数据或则不传默认为 3

请求示例

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

响应参数

名称	类型	示例值	描述
items	List		售后列表元素
-aftersale_info	Struct		售后信息
--aftersale_id	String	"6986853269519810849"	售后 ID
--aftersale_order_type	Int64	1	售后订单类型，枚举为-1(历史订单),1(商品单),2(店铺单)
--aftersale_type	Int64	0	售后类型，枚举为 0(退货退款),1(已发货仅退款),2(未发货仅退款),3(换货)
--aftersale_status	Int64	11	售后状态，枚举为 6(待商家同意),7(待买家退货),11(待商家二次同意),12(售后成功),13(换货待买家收货),14(换货成功),27(商家一次拒绝),28(售后失败),29(商家二次拒绝)
--related_id	String	"4821780700279174718"	关联的订单 ID
--apply_time	Int64	1626753592	申请时间
--update_time	Int64	1626860666	最近更新时间
--status_deadline	Int64	1626926420	当前节点逾期时间
--refund_amount	Int64	20	售后退款金额，单位为分
--refund_post_amount	Int64	0	售后退运费金额，单位为分
--aftersale_num	Int64	1	售后数量
--part_type	Int64	0	部分退类型
--aftersale_refund_type	Int64	0	售后退款类型，枚举为-1(历史数据默认值),0(订单货款/原路退款),1(货到付款线下退款),2(备用金),3(保证金),4(无需退款),5(平台垫付)
--refund_type	Int64	0	退款方式
--arbitrate_status	Int64	0	仲裁状态，枚举为 0(无仲裁记录),1(仲裁中),2(客服同意),3(客服拒绝),4(待商家举证),5(协商期),255(仲裁结束)
--create_time	Int64	1626753592	售后单创建时间
--refund_tax_amount	Int64	0	退税费
--left_urge_sms_count	Int64	0	商家剩余发送短信（催用户寄回）次数
--return_logistics_code	String	"XY123123123"	退货物流单号
--risk_decision_code	Int64	0	风控码
--risk_decision_reason	String	""	风控理由
--risk_decision_description	String	""	风控描述
--return_promotion_amount	Int64	0	退优惠金额
--refund_status	Int64	1	退款状态
--arbitrate_blame	Int64	1:商家责任，2:买家责任，3:双方有责，4:平台责任，5:达人责任	仲裁责任方
--exchange_sku_info	Struct		换货 SKU 信息
---sku_id	String	"1709160688834615"	换货 SkuID
---code	String	"10000"	换货 SKU code
---num	Int64	1	换货数目
---out_sku_id	String	"10000"	商家编号
---out_warehouse_id	String	"10000"	区域库存仓 ID
---supplier_id	String	"10000"	sku 外部供应商编码供应商 ID
---url	String	"http://xxxxx"	商品图片 url
---name	String	"xxx"	商品名称
---price	String	"100"	换货商品的价格，单位分
---spec_desc	String	"xx/xx/xx"	sku 规格信息
-order_info	Struct		订单信息
--shop_order_id	String	"4821780700279174718"	店铺单订单 ID
--related_order_info	List		售后关联的订单信息
---sku_order_id	String	"4821780700279174718"	商品单信息
---order_status	Int64	3	订单状态，枚举为 2(未发货),3(已发货),5(已收货或已完成),255(已完成)
---pay_amount	Int64	20	付款金额
---post_amount	Int64	0	付运费金额
---item_num	Int64	1	购买数量
---create_time	Int64	1626753467	下单时间
---tax_amount	Int64	0	税费
---is_oversea_order	Int64	0	是否为海外订单
---product_name	String	小兔子 T 恤	商品名称
---product_id	Int64	9999888777666	商品 ID
---product_image	String	https://bytedance.com/image/rabbit.jpg	商品图片
---tags	List		订单标签
----tag_detail	String	超级售后	标签中文名称
----tag_detail_en	String	super_after_sale	标签编号
----tag_link_url	String	http://what_is_super_after_sale.bytedance.com/faq	标签链接
---sku_spec	List		商品规格
----name	String	颜色	规格类型名称
----value	String	白	规格值
---shop_sku_code	String	""	商家 SKU 编码
---logistics_code	String	"RABBIT123123"	发货物流编码
---aftersale_pay_amount	Int64	20	售后退款金额
---aftersale_post_amount	Int64	0	售后退运费金额
---aftersale_tax_amount	Int64	0	售后退税费金额
---aftersale_item_num	Int64	1	售后商品数量
---promotion_pay_amount	Int64	0	优惠券金额
---price	Int64	20	价格
--order_flag	Int64	0	订单插旗
-text_part	Struct		文案部分
--logistics_text	String	"已发货"	正向物流发货状态文案
--aftersale_status_text	String	"待商家审核"	售后状态文案
--aftersale_type_text	String	"退货退款"	售后类型文案
--return_logistics_text	String	"已发货"	退货物流发货状态文案
--aftersale_refund_type_text	String	"保证金"	售后退款类型文案
--reason_text	String	"无理由退款"	售后理由文案
--bad_item_text	String	""	坏单比例文案
--arbitrate_status_text	String	""	仲裁状态文案
-seller_logs	List		卖家插旗日志
--content	String	"买家觉得小兔子太可爱了，不想要了"	插旗日志内容
--op_name	String	"兔子店铺 CEO"	插旗操作人
--create_time	String	1626675161	插旗时间
--star	Int64	0	插旗类型
has_more	Bool	true	是否还有更多
total	Int64	1025	当前搜索条件下，匹配到的总数量
page	Int64	0	页码，从 0 开始
size	Int64	10	当前返回售后数量
withholding_money	int		该接口扣费金额（点券）

返回数据

{
  "code": 0,
  "msg": "操作成功",
  "msec": 1469,
  "time": 1617270403,
  "data":  {
    "has_more": "true",
    "items": [
      {
        "aftersale_info": "",
        "order_info": "",
        "seller_logs": [
          {
            "content": "\"买家觉得小兔子太可爱了，不想要了\"",
            "create_time": "1626675161",
            "op_name": "\"兔子店铺CEO\"",
            "star": "0"
          }
        ],
        "text_part": ""
      }
    ],
    "page": "0",
    "size": "10",
    "total": "1025"
  }
}

响应代码

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

售后列表接口

请求头参数

请使用新的生成 token 接口 点击查看详情

请求参数

请求示例

请求代码示例

响应参数

返回数据

响应代码

请使用新的生成 token 接口点击查看详情