全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
获取商品详情
接口地址: http://api.vv-tool.com/tool/erps/productdetail
接口介绍: 获取商品的详细信息(默认读取的是线上数据,而非草稿数据;如无线上数据,则读取草稿数据)
请求方式: POST
返回格式: JSON
接口收费: 联系客服
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
shop_id | String | 是 | 店铺 id |
product_id | String | 否 | 商品 id |
out_product_id | String | 否 | 外部商品 id |
show_draft | String | 否 | "true":读取草稿数据;"false":读取上架数据 |
vvtype | int | 否 | 普通版 1,增强版 2,专业版 3 目前此接口只支持 2 |
请求示例
{
shop_id: 1234444,
product_id: 123131,
show_draft: true,
out_product_id: 12344,
vvtype: 2
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
product_id | Int64 | 3539925204033339668 | 商品 ID |
product_id_str | String | 3539925204033339668 | 商品 ID,字符串格式 |
out_product_id | Int64 | 11111 | 商品外部 ID |
outer_product_id | String | 11111 | 商品外部 ID 字符串 |
open_user_id | Int64 | 1 | open 应用 id |
name | String | xxx 爽肤水 | 商品名称 |
description | String | <img src="https://tosv.boe.byted.org/obj/temai/54cbf542128eff94a3549284817c0af5bf5c2960www800-800" style="width:100%;"> | 详情 HTML |
delivery_method | Int32 | 7 | 承诺发货时间,单位是天 不传则默认为 2 天,presell_type 为 0 或 2 均只支持传入 2,presell_type 为 1 时支持可选值为: 2、3、5、7、10、15 |
cdf_category | String | 1 | 海南免税:海关限购分类编码 |
status | Int64 | 1 | 商品上下架状态:0 上架 1 下架 2 已删除 |
spec_id | Int64 | 1 | 规格 id |
check_status | Int64 | 1 | 商品审核状态:1 未提审 2 审核中 3 审核通过 4 审核驳回 5 封禁 7 审核通过,待上架状态 |
mobile | String | 15677775555 | 手机号 |
brand_id | Int64 | 12344 | 品牌 id |
is_sub_product | Bool | true | 是否是组套商品的子商品 |
draft_status | Int64 | 2 | 草稿状态:0 无草稿,1 未提审,2 待审核,3 审核通过,4 审核未通过 |
category_detail | Struct | - | 新类目的详情 |
first_cid | Int64 | 23264 | 一级类目 id |
second_cid | Int64 | 0 | 二级类目 id |
third_cid | Int64 | 0 | 三级类目 id |
fourth_cid | Int64 | 0 | 四级类目 id |
first_cname | String | 教育培训 | 一级类目名 |
second_cname | String | 学习卡 | 二级类目名 |
third_cname | String | - | 三级类目名 |
fourth_cname | String | - | 四级类目名 |
pay_type | Int64 | 1 | 支持的支付方式:0 货到付款 1 在线支付 2 两者都支持 |
recommend_remark | String | 真的很好啊 | 商家推荐语 |
extra | String | - | 扩展字段 |
is_create | Int64 | 1 | 已废弃,无业务意义 |
create_time | String | 2021-03-29 15:52:52 | 创建时间 |
update_time | String | 2021-03-29T15:52:52+08:00 | 更新时间 |
pic | List | ["https://sf6-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800"] | 商品主图 |
product_format | String | {"货号":"8888"} | 属性名称 |
spec_pics | List | - | 规格图片 |
spec_detail_id | Int64 | 1695459998447656 | id |
pic | String | temai/b637513c50b994f4c89de56a17886caca5d6569awww800-800 | uri |
spec_prices | List | - | sku 详情 |
sku_id | Int64 | 1695459998495774 | sku id |
out_sku_id | Int64 | 0 | 外部 sku id |
outer_sku_id | String | 0 | 字符串形式外部 sku id |
spec_detail_ids | List | [1695459998494734, 1695459998494766] | 规格 id |
stock_num | Int64 | 13 | // 当前现货可售库存、当前预售可售库存(物理库存) |
price | Int64 | 102 | 价格 |
code | String | aaa | 编码 |
step_stock_num | Int64 | 0 | 阶梯库存 |
prom_stock_num | Int64 | 0 | 活动库存 |
prom_step_stock_num | Int64 | 0 | 活动阶梯库存 |
spec_detail_id1 | Int64 | 1695459998494734 | 规格 ID |
spec_detail_id2 | Int64 | 1695459998494734 | 规格 ID |
spec_detail_id3 | Int64 | 0 | 规格 ID |
sku_type | Int64 | 0 | sku 类型 |
supplier_id | String | 123 | 供应商编码 |
promotion_stock_num | Int64 | 0 | 活动现货库存 |
promotion_step_stock_num | Int64 | 0 | 活动阶梯库存 |
customs_report_info | Struct | - | 海关申报要素 |
hs_code | String | 1564564 | 海关代码 |
first_measure_qty | Double | 1 | 法定第一计量数量 |
second_measure_qty | Double | 1 | 法定第二计量数量 |
first_measure_unit | String | - | 法定第一计量单位 |
second_measure_unit | String | - | 法定第二计量单位 |
unit | String | - | 售卖单位 |
report_name | String | - | 品名 |
report_brand_name | String | - | 品牌 |
usage | String | - | 用途 |
g_model | String | - | 规格型号 |
bar_code | String | - | 条形码 |
lock_stock_num | Int64 | 1 | 现货订单锁定库存 |
lock_step_stock_num | Int64 | 1 | 阶梯订单锁定库存 |
stock_num_map | Map | - | 仓 ID-> 库存映射 |
tax_exemption_sku_info | Struct | - | 海南免税 sku 信息 |
is_suit | Int32 | 1 | 是否套装(0 否 1 是) |
suit_num | Int64 | 10 | 套装数量 |
volume | Int64 | 100 | 净含量 |
presell_delay | Int64 | 5 | sku 预售、现货 + 预售、新预售模式下,sku 对应的预售天数 |
- | specs | List | 销售属性 |
id | Int64 | 1713023986705415 | 销售属性 id |
spec_id | Int64 | 1713023983665214 | 规格 id |
name | String | 颜色 | 销售属性 |
pid | Int64 | 1713023986705415 | 销售属性 id |
is_leaf | Int16 | 0 | 是否是销售属性值 |
values | List | - | 销售属性值 |
id | Int64 | 1695459998447656 | 销售属性值 ID |
spec_id | Int64 | 1713023983665214 | 规格 ID |
name | String | 红色 | 销售属性值 |
pid | Int64 | 1695459998447640 | 销售属性 ID |
is_leaf | Int16 | 1 | 是否是销售属性值 |
status | Int16 | 1 | 状态 |
img | String | https://xxxx.byted.org/obj/temai/54cbf542128eff94a3549284817c0af5bf5c2960www800-800 | 头图,主图第一张 |
presell_type | Int64 | 1 | 预售类型,1-全款预售,0-非预售,2-阶梯库存 |
maximum_per_order | Int64 | 5 | 每个用户每次下单限购件数 |
limit_per_buyer | Int64 | 5 | 每个用户累计限购件数 |
minimum_per_order | Int64 | 1 | 每个用户每次下单至少购买的件数 |
quality_list | List | - | 资质信息 |
quality_key | String | 3457***9470978 | 资质 key |
quality_name | String | 进货凭证 | 资质名称 |
quality_attachments | List | - | 资质链接 |
media_type | Int64 | 1 | 1-图片,2-pdf |
url | String | http://www.byted***.com/YYYY | 资质 url |
logistics_info | Struct | - | 跨境物流信息 |
customs_clear_type | Int64 | 1 | 通关模式,1BBC 2BC 3 邮关 |
origin_country_id | Int64 | 123 | 原产国 id |
source_country_id | Int64 | 123 | 货源国 id |
brand_country_id | Int64 | 123 | 品牌所在地 id |
tax_payer | Int64 | 0 | 税金承担方,0 商家承担,1 用户承担 |
net_weight_qty | Double | 100 | 商品净重 |
after_sale_service | String | {"supply_7day_return":"2"} | 售后服务 |
price_has_tax | Int64 | 0 | 商品价格是否含税 |
appoint_delivery_day | Int64 | 2 | 可预约发货天数 |
product_format_new | String | {"1088":[{"Value":0,"Name":"小 33 学二年级","PropertyId":1088,"PropertyName":"适用学龄段","diy_type":1}],"1319":[{"Value":0,"Name":"1","PropertyId":1319,"PropertyName":"适用地区","diy_type":0}],"1618":[{"Value":0,"Name":"9787218122861","PropertyId":1618,"PropertyName":"ISBN 编号","diy_type":0}],"1831":[{"Value":0,"Name":"小学英语看图说话写话二年级","PropertyId":1831,"PropertyName":"书名","diy_type":0}],"2000":[{"Value":34762,"Name":"无","PropertyId":2000,"PropertyName":"作者地区","diy_type":0}],"2229":[{"Value":0,"Name":"1","PropertyId":2229,"PropertyName":"编者","diy_type":0}],"3271":[{"Value":0,"Name":"1","PropertyId":3271,"PropertyName":"出版时间","diy_type":0}],"449":[{"Value":0,"Name":"1","PropertyId":449,"PropertyName":"作者","diy_type":0}],"501":[{"Value":7310,"Name":"否","PropertyId":501,"PropertyName":"是否是套装","diy_type":0}],"855":[{"Value":0,"Name":"陕西人民教育出版社","PropertyId":855,"PropertyName":"出版社名称","diy_type":0}]} | 类目属性 |
standard_brand_id | Int64 | 121354 | 品牌库 brand id,原 brand_id 代表商标关系 id |
market_price | Int64 | 12000 | 划线价 单位分 |
discount_price | Int64 | 12000 | 售卖价 单位分 |
car_vin_code | String | VIN11111111111111 | 汽车 vin 码 |
need_recharge_mode | Bool | false | 生活娱乐充值模式 |
account_template_id | String | 1 | 多账号充值账号模板 |
presell_config_level | Int64 | 2 | 发货模式:presell_type = 0 现货;presell_type = 2 阶梯;presell_type = 1 && presell_config_level = 0 全款预售;presell_type = 1 && presell_config_level = 1 sku 预售;presell_type = 1 && presell_config_level = 2 现货 + 预售;presell_type = 1 && presell_config_level = 3 新预售 |
delivery_delay_day | Int64 | 2 | 现货模式的发货天数;阶梯模式现货部分的发货天数,9999= 当日发、1= 次日发 |
presell_delay | Int64 | 4 | 阶梯模式阶梯部分的发货天数;商品全款预售模式,预售天数 |
withholding_money | Int64 | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"product_id": 3472490447010721067,
"product_id_str": "3472490447010721067",
"out_product_id": 1617004369,
"outer_product_id": "1617004369",
"open_user_id": 0,
"name": "抖店开放平台自动化测试专用,勿动谢谢",
"description": "<img src=\"https://sf6-ttcdn-tos.pstatp.com/obj/temai/93addf0cd27c5ac835767731e33aa1dfe02c5854www750-1336\" style=\"width:100%;\">",
"market_price": 200,
"discount_price": 100,
"status": 0,
"spec_id": 1695459998447624,
"check_status": 2,
"mobile": "18888888888",
"first_cid": 1305,
"second_cid": 1399,
"third_cid": 2523,
"category_detail": {
"first_cid": 20077,
"second_cid": 21129,
"third_cid": 0,
"fourth_cid": 0,
"first_cname": "教育培训",
"second_cname": "学习卡",
"third_cname": "",
"fourth_cname": ""
},
"pay_type": 1,
"recommend_remark": "remark...",
"extra": "{\"category_detail\":{\"first_cid\":20077,\"first_cname\":\"教育培训\",\"fourth_cid\":0,\"fourth_cname\":\"\",\"is_leaf\":true,\"second_cid\":21129,\"second_cname\":\"学习卡\",\"third_cid\":0,\"third_cname\":\"\"},\"class_quality\":\"https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800,https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800\",\"is_publish\":1,\"quality_list\":[{\"quality_key\":\"1\",\"quality_name\":\"进货凭证1\",\"quality_attachments\":[{\"media_type\":1,\"url\":\"https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800\"},{\"media_type\":1,\"url\":\"https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800\"}]},{\"quality_key\":\"2\",\"quality_name\":\"进货凭证2\",\"quality_attachments\":[{\"media_type\":1,\"url\":\"https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800\"}]}],\"quality_report\":\"\",\"stone\":{\"remark\":\"商家备注\"}}",
"is_create": 0,
"create_time": "2021-03-29 15:52:52",
"update_time": "2021-03-29T15:52:52+08:00",
"pic": [
"https://sf6-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800"
],
"product_format": "{\"货号\":\"8888\"}",
"spec_pics": [
{
"spec_detail_id": 1695459998447656,
"pic": "temai/b637513c50b994f4c89de56a17886caca5d6569awww800-800"
},
{
"spec_detail_id": 1695459998447672,
"pic": "temai/b637513c50b994f4c89de56a17886caca5d6569awww800-800"
},
{
"spec_detail_id": 1695459998494734,
"pic": "temai/b637513c50b994f4c89de56a17886caca5d6569awww800-800"
}
],
"spec_prices": [
{
"sku_id": 1695459998495774,
"out_sku_id": 0,//外部商家sku_id
"outer_sku_id": "",//新增,推荐使用,外部商家sku_id,支持字符串和数字2种
"spec_detail_ids": [
1695459998494734,
1695459998494766
],
"stock_num": 13,
"price": 102,
"code": "",
"settlement_price": 102,
"step_stock_num": 0,
"prom_stock_num": 0,
"prom_step_stock_num": 0,
"spec_detail_id1": 1695459998494734,
"spec_detail_id2": 1695459998494766,
"spec_detail_id3": 0,
"sku_type": 0,
"supplier_id": "",
"promotion_stock_num": null,
"promotion_step_stock_num": null,
"customs_report_info": {
"hs_code": "",
"first_measure_qty": 0,
"second_measure_qty": 0,
"first_measure_unit": "",
"second_measure_unit": "",
"unit": "",
"report_name": "",
"report_brand_name": "",
"usage": "",
"g_model": "",
"bar_code": ""
},
"lock_stock_num": 0,
"lock_step_stock_num": 0,
"stock_num_map": null
},
{
"sku_id": 1695459998495758,
"out_sku_id": 0,
"outer_sku_id": "",
"spec_detail_ids": [
1695459998447672,
1695459998494766
],
"stock_num": 12,
"price": 101,
"code": "",
"settlement_price": 101,
"step_stock_num": 0,
"prom_stock_num": 0,
"prom_step_stock_num": 0,
"spec_detail_id1": 1695459998447672,
"spec_detail_id2": 1695459998494766,
"spec_detail_id3": 0,
"sku_type": 0,
"supplier_id": "",
"promotion_stock_num": null,
"promotion_step_stock_num": null,
"customs_report_info": {
"hs_code": "",
"first_measure_qty": 0,
"second_measure_qty": 0,
"first_measure_unit": "",
"second_measure_unit": "",
"unit": "",
"report_name": "",
"report_brand_name": "",
"usage": "",
"g_model": "",
"bar_code": ""
},
"lock_stock_num": 0,
"lock_step_stock_num": 0,
"stock_num_map": null
},
{
"sku_id": 1695459998494782,
"out_sku_id": 123456788,
"outer_sku_id": "123456788",
"spec_detail_ids": [
1695459998447656,
1695459998494766
],
"stock_num": 11,
"price": 100,
"code": "16076589507w",
"settlement_price": 100,
"step_stock_num": 0,
"prom_stock_num": 0,
"prom_step_stock_num": 0,
"spec_detail_id1": 1695459998447656,
"spec_detail_id2": 1695459998494766,
"spec_detail_id3": 0,
"sku_type": 0,
"supplier_id": "56788",
"promotion_stock_num": null,
"promotion_step_stock_num": null,
"customs_report_info": {
"hs_code": "",
"first_measure_qty": 0,
"second_measure_qty": 0,
"first_measure_unit": "",
"second_measure_unit": "",
"unit": "",
"report_name": "",
"report_brand_name": "",
"usage": "",
"g_model": "",
"bar_code": ""
},
"lock_stock_num": 0,
"lock_step_stock_num": 0,
"stock_num_map": null
}
],
"specs": [
{
"id": 1695459998447640,
"spec_id": 1695459998447624,
"name": "颜色",
"pid": 0,
"is_leaf": 0,
"values": [
{
"id": 1695459998447656,
"spec_id": 1695459998447624,
"name": "红色",
"pid": 1695459998447640,
"is_leaf": 1,
"status": 0
},
{
"id": 1695459998447672,
"spec_id": 1695459998447624,
"name": "黄色",
"pid": 1695459998447640,
"is_leaf": 1,
"status": 0
},
{
"id": 1695459998494734,
"spec_id": 1695459998447624,
"name": "蓝色",
"pid": 1695459998447640,
"is_leaf": 1,
"status": 0
}
]
},
{
"id": 1695459998494750,
"spec_id": 1695459998447624,
"name": "尺寸",
"pid": 0,
"is_leaf": 0,
"values": [
{
"id": 1695459998494766,
"spec_id": 1695459998447624,
"name": "S",
"pid": 1695459998494750,
"is_leaf": 1,
"status": 0
}
]
}
],
"img": "https://sf6-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800",
"presell_type": 0,
"maximum_per_order": 0,
"limit_per_buyer": 0,
"minimum_per_order": 1,
"quality_list": [
{
"quality_key": "1",
"quality_name": "进货凭证1",
"quality_attachments": [
{
"media_type": 1,
"url": "https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800"
},
{
"media_type": 1,
"url": "https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800"
}
]
},
{
"quality_key": "2",
"quality_name": "进货凭证2",
"quality_attachments": [
{
"media_type": 1,
"url": "https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800"
}
]
}
],
"logistics_info": {
"customs_clear_type": 0,
"origin_region_id": 0,
"source_region_id": 0,
"brand_region_id": 0,
"tax_payer": 0,
"net_weight_qty": 0
},
"after_sale_service": "{\"supply_7day_return\":\"2\"}",
"price_has_tax": 0
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或则连接对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |