全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
提供给商家获取售后单详情信息
接口地址: http://api.vv-tool.com/tool/erps/afterSaleDetail
接口介绍: 商家获取售后单详细信息
请求方式: POST
返回格式: JSON
接口收费: 联系客服
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
shop_id | string | 是 | 店铺 id |
after_sale_id | String | 是 | 售后单 ID |
vvtype | int | 否 | 普通版 1,增强版 2,专业版 3,无效数据或则不传默认为 3 |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
process_info | Struct | - | 售后单及相关信息 |
-after_sale_info | Struct | - | 售后单信息 |
--after_sale_id | Int64 | 6965315853751632172 | 售后单 ID |
--after_sale_status | Int64 | 12 : "售后成功" | 售后状态:售后申请 6 拒绝售后申请 27 售后成功 12 售后退货中 7 售后已发货 11 售后退货拒绝 29 售后换货商家发货 13 售后换货用户收货 14 售后失败 28 订单取消成功 51 逆向交易已完成 53 |
--after_sale_status_desc | String | 12 : "售后成功" | 售后状态文案 |
--refund_type | Int64 | 4 : "无需退款" | 退款方式 |
--refund_type_text | String | 4 : "无需退款" | 退款方式文案 |
--refund_status | Int64 | 1 : "待退款" | 退款状态 |
--refund_total_amount | Int64 | 1000 | 售后总金额(含运费) |
--refund_post_amount | Int64 | 10 | 售后运费 |
--refund_promotion_amount | Int64 | 10 | 退款补贴总金额 |
--apply_time | Int64 | 1735660800 | 售后单申请时间 |
--update_time | Int64 | 1735660800 | 售后单更新时间 |
--reason | String | "做工粗糙 / 有瑕疵 / 破损或污渍" | 申请原因 |
--reason_code | Int64 | 2 | 原因码 |
--after_sale_type | Int64 | 2:"未发货仅退款" | 售后类型 :售后退货退款 0 售后退款 1 售前退款 2 换货 3 系统取消 4 用户取消 5 |
--after_sale_type_text | String | 2:"未发货仅退款" | 售后单类型文案 |
--reason_remark | String | "不喜欢这件商品” | 申请描述 |
--evidence | List | 凭证 | 凭证 |
--after_sale_apply_count | Int64 | 1 | 用户申请售后件数 |
--need_return_count | Int64 | 1 | 用户需退回件数, 数值为用户申请售后件数 - 商家未发货件数 |
--deduction_amount | Int64 | 10000 | 平台需要回收的金额(分) |
--disable_coupon_id | String | "12345" | 作废的券 ID |
--platform_discount_return_amount | Int64 | 100 | 平台优惠退回金额 |
--platform_discount_return_status | Int64 | 1 | 平台优惠退回状态,枚举:0:待退补贴;1:退补贴成功;2:退补贴失败 |
--kol_discount_return_amount | Int64 | 100 | 达人优惠退回金额 |
--kol_discount_return_status | Int64 | 1 | 达人优惠退回状态,枚举:0:待退补贴;1:退补贴成功;2:退补贴失败 |
--post_receiver | String | "张三" | 换货时的收货人名字(只有换货时,这个字段才会有值),此字段已加密,使用前需要解密 |
--post_tel_sec | String | "18740098531" | 换货时的收货人的联系电话(只有换货时,这个字段才会有值),此字段已加密,使用前需要解密 |
--post_address | Struct | - | 换货时的收货四级地址(只有换货时,这个字段才会有值) |
---province | Struct | - | 省 |
----id | String | "342" | 省 ID |
----name | String | "山东省" | 省名字 |
---city | Struct | - | 市 |
----id | String | "342" | 市 ID |
----name | String | "菏泽市" | 市名字 |
---town | Struct | - | 县 |
----id | String | "342" | 县 ID |
----name | String | "曹县" | 县名字 |
---detail | String | 23432 | 地址详情,此字段已加密,使用前需要解密 |
---landmark | String | 2432 | 收件地址标志物 |
---street | Struct | - | 街道 |
----id | String | "342" | 街道 ID |
----name | String | name | 街道名字 |
--risk_decsison_code | Int64 | 1 | 物流异常风控编码 |
--risk_decsison_reason | String | "多个售后单同一单号" | 物流异常风控理由 |
--risk_decsison_description | String | "退货物流可能存在异常,多个售后单物流单号一致,请仔细核对或与买家核实后尽快处理。" | 物流异常风控描述 |
--return_address | Struct | 退货地址 | |
---province | Struct | 省 | |
----id | String | "321" | 省 ID |
----name | String | "河北省" | 省名字 |
---city | Struct | 市 | |
----id | String | "432" | 市 ID |
----name | String | "石家庄" | 市名称 |
---town | Struct | 县/区 | |
----id | String | "432" | 县区 ID |
----name | String | "什么区" | 县区名字 |
---street | Struct | 街道 | |
----id | String | "432" | 街道 ID |
----name | String | "解放路" | 街道名称 |
---landmark | String | "" | 收件地址标志物 |
---detail | String | "新华书店门口左转一米" | 详细地址 |
--real_refund_amount | Int64 | 300 | 实际退款金额 |
--got_pkg | Int64 | 1 | 买家是否收到货,0 表示未收到货,1 表示收到货 |
--status_deadline | Int64 | 1735660800 | 逾期时间 |
--return_address_id | Int64 | 123123 | 退货地址 ID |
--exchange_sku_info | Struct | 换货 SKU 信息 | |
---sku_id | String | "10000" | 商品 skuid |
---code | String | "10000" | 商品编码 |
---num | Int64 | 1 | 替换数量 |
---out_sku_id | String | "10000" | 商家编号 |
---out_warehouse_id | String | "10000" | 区域库存仓 ID |
---supplier_id | String | "10000" | sku 外部供应商编码供应商 ID |
---url | String | "10000" | 商品图片 url |
---name | String | "10000" | 商品名称 |
---price | String | "10000" | 换货商品的价格,单位分 |
---spec_desc | String | "xx/xx/xx" | sku 规格信息 |
-arbitrate_info | Struct | - | 仲裁信息 |
--arbitrate_id | String | 12345 | 仲裁单 id |
--arbitrate_status | Int64 | 0 : "无需仲裁" | 仲裁状态 |
--is_required_evidence | Bool | 1 : "需要上传凭证" | 是否需要上传凭证 |
--arbitrate_status_deadline | String | 1735660800 | 仲裁截止时间 |
--arbitrate_opinion | String | 仲裁原因描述 | 仲裁原因 |
--arbitrate_conclusion | Int64 | 0 | 仲裁结果 |
--arbitrate_create_time | Int64 | 1735660800 | 仲裁单创建时间 |
--arbitrate_update_time | Int64 | 1735660800 | 仲裁单更新时间 |
--arbitrate_evidence_tmpl | Struct | - | 凭证示例 |
---images | List | 仲裁图片示例 | 仲裁图片示例 |
---describe | String | 仲裁描述 | 仲裁描述 |
---dead_line | Int64 | 1735660800 | 示例截止时间 |
--arbitrate_evidence | Struct | - | 仲裁证据 |
---images | List | 仲裁图片示例 | 仲裁图片 |
---describe | String | 仲裁描述 | 仲裁图片描述 |
--arbitrate_blame | Int64 | 1:商家责任,2:买家责任,3:双方有责,4:平台责任,5:达人责任 | 仲裁责任方 |
-after_sale_service_tag | Struct | - | 售后标签 |
--after_sale_service_tag | List | - | 售后服务标签 |
---tag_detail | String | "7 天" | 服务标签名称 |
---tag_detail_en | String | "supply_7day_return" | 服务标签英文代号 |
---tag_link_url | String | "https://school.jinritemai.com/doudian/web/article/101835?from=shop_article" | 服务跳转地址 |
-logistics_info | Struct | - | 物流信息 |
--return | Struct | - | 买家退货物流信息 |
---tracking_no | String | 12345 | 物流单号 |
---company_name | String | 顺丰 | 物流公司名称 |
---company_code | String | shunfeng | 物流公司编码 |
---logistics_time | Int64 | 1735660800 | 买家填写退货物流时间 |
--exchange | Struct | - | 卖家换货物流信息 |
---tracking_no | String | 12345 | 物流单号 |
---company_name | String | 顺丰 | 物流公司名称 |
---company_code | String | shunfeng | 物流公司编码 |
---logistics_time | Int64 | 1735660800 | 卖家填写换货物流时间 |
-after_sale_shop_remarks | List | 售后备注 | |
--order_id | Int64 | 12345 | 备注关联的订单 ID |
--after_sale_id | Int64 | 54321 | 备注关联的售后 ID |
--remark | String | "你好" | 备注内容 |
--create_time | Int64 | 173566080 | 创建时间 |
--operator | String | "小亮" | 操作人 |
order_info | Struct | - | 售后单关联订单信息 |
-shop_order_id | Int64 | 12345 | 店铺单 ID |
-sku_order_infos | List | - | sku 单信息 |
--sku_order_id | Int64 | 12345 | sku 单 ID |
--order_status | Int64 | 4:"订单取消" | 订单状态 |
--pay_amount | Int64 | 1000 | 买家实付金额(分) |
--post_amount | Int64 | 100 | 买家购买运费(分) |
--item_quantity | Int64 | 1 | 订单件数 |
--create_time | Int64 | 1735660800 | 订单创建时间 |
--tax_amount | Int64 | 100 | 购买税费(分) |
--is_oversea_order | Int64 | 0:不是 1:是 | 是否为跨境业务 |
--product_name | String | "耐克球鞋" | 商品名称 |
--product_id | Int64 | 12345 | 商品 ID |
--product_image | String | 商品图片链接 | 商品图片 |
--tags | List | - | 商品标签 |
---tag_detail | String | "极速退" | 服务标签名称 |
---tag_detail_en | String | "refund_auto_deal" | 服务标签英文代号 |
---tag_link_url | String | "https://school.jinritemai.com/doudian/web/article/101792?from=shop_article" | 服务跳转地址 |
--sku_spec | List | - | 商品规格信息 |
---name | String | "数量" | 规格名称 |
---value | String | 12 | 规格值 |
--shop_sku_code | String | "12345" | 商家 sku 自定义编码 |
--sku_id | Int64 | 12345 | skuID |
--item_sum_amount | Int64 | 1000 | sku 商品总原价(不含优惠) |
--sku_pay_amount | Int64 | 900 | 商品实际支付金额 |
--promotion_amount | Int64 | 100 | 优惠总金额 |
--pay_type | Int64 | 0 : "货到付款" 1:"在线支付" | 支付方式 |
--insurance_tags | List | - | 保险及其状态 |
---tag_detail | String | "运费险" | 服务标签名称 |
---tag_detail_en | String | returnfreight | 服务标签英文代号 |
---tag_link_url | String | 服务跳转链接 | 服务跳转地址 |
--after_sale_item_count | Int64 | 1 | 商品单对应的售后数量 |
withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"order_info": "",
"process_info": ""
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或则连接对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |