全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
商品列表完整版
接口地址： http://api.vv-tool.com/tool/erps/productgetDetailItemList
接口介绍： 商品列表完整版
请求方式： POST
返回格式： JSON
接口收费： 联系客服
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | string | 是 | 店铺 id |
| id | string | 否 | 商品编号，使用 id 查询其他条件可以不填 |
| status | integer | 否 | 商品审核结果(0 为编辑中，1 为待审核，2 为审核通过) |
| createTimeFrom | integer | 否 | 商品创建时间开始时间，Unix-Time 时间戳 |
| createTimeTo | integer | 否 | 商品创建时间结束时间，Unix-Time 时间戳 |
| updateTimeFrom | integer | 否 | 商品更新时间开始时间，Unix-Time 时间戳 |
| updateTimeTo | integer | 否 | 商品更新时间结束时间，Unix-Time 时间戳 |
| buyable | boolean | 否 | 是否在架上 |
| stockGte | integer | 否 | 库存大于等于某数 |
| stockLte | integer | 否 | 库存小于等于某数 |
| pageNo | integer | 否 | 返回页码 默认 1，页码从 1 开始 PS：当前采用分页返回，数量和页数会一起传，如果不传，则采用 默认值 |
| pageSize | integer | 否 | 返回数量，默认 50 最大 100 |
| barcode | string | 否 | 商品条码 |
| skucode | string | 否 | 小红书编码 |
| freeze | boolean | 否 | 是否被冻结 true 为已冻结，false 为未冻结 |
| singlePackOnly | boolean | 否 | 只返回单品类型的商品 |
| showDeleted | boolean | 否 | - |
| lastId | string | 否 | 查询起始商品 id，全店商品时间倒序 |
| isChannel | boolean | 否 | 不传返回全部，传 true 只返回渠道商品，传 false 只返回非渠道商品 |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| code | int | 返回状态码 | |
| msg | string | 返回码描述 | |
| msec | int | 接口执行时间 | |
| time | int | 接口返回时间 | |
| data | object | 数据信息 | |
| --withholding_money | int | 该接口扣费金额（点券） | |
| --currentPage | integer | 1 | 当前返回页 |
| --pageSize | integer | 50 | 查询总数 |
| --total | integer | 500 | 总商品数 |
| --hits | array | 商品详情列表 | |
| ----spuData | object | - | |
| ----id | string | spu 标题 | spuId,创建时不填，删除更新必填 |
| ----name | string | spu 标题 | spu 标题 |
| ----ename | string | spuEName | spu 英文名 |
| ----aliasName | string | spu 别名 | spu 别名 |
| ----shortName | string | spu 短标题，不得超过 30 的长度，其中中文字符占两个长度 | spu 短标题 |
| ----businessLineId | string | 52d0****7d4b | 业务线条 ID |
| ----brandId | string | 52dd****7d4b | 品牌 ID |
| ----categoryId | string | 5a31****9df5 | 末级商品类目 ID |
| ----attributes | array | spu 属性 | |
| ----shippingTemplateId | string | null | 运费模板 ID |
| ----shippingGrossWeight | integer | 100 | 商品物流重量（克），当运费模版选择按重量计费时，该值必须大于 0 |
| ----saleMethod | string | DEFAULT/BOUTIQUE/SUPERMARKET | 售卖方式 |
| ----variantIds | array | spu 下商品规格列表 | |
| ----isAutoOffSale | boolean | True | 是否自动下架，创建不需要，渠道商品更新时候使用 |
| ----autoOffSaleTime | integer | 1617877270000 | 自动下架时间，创建不需要，渠道商品更新时候使用 |
| ----inventoryType | integer | 1 | 库存类型（1: 普通库存；3: 独立库存），创建不需要，渠道商品更新时候使用，若普通商品修改库存为独立库存可能导致无法售卖 |
| ----spuType | string | NORMAL | spuType 0:NORMAL(普通商品),1:UNION(组合商品) |
| ----isChannel | boolean | True | 是否为渠道商品，true:是渠道商品，false：非渠道商品 |
| ----createTime | integer | spu 创建时间 | |
| ----updateTime | integer | spu 更新时间 | |
| ----itemData | object | - | |
| ----spuId | string | spu 标题 | spu 编号 |
| ----id | string | 6123**5132 | itemId,仅更新删除返回使用 |
| ----skuData | object | sku 信息 | |
| ----skuCode | string | 65a0****f4d2 | sku 编号，仅用于返回 |
| ----ipq | integer | 100 | 打包数 |
| ----originalPrice | number | 88 | 市场价 |
| ----price | number | 80 | 售价 |
| ----stock | integer | 5000 | 库存 |
| ----logisticsName | string | red_auto | 物流模式名 |
| ----logisticsPlanId | string | 5e37***a9f0 | 物流方案 Id |
| ----logisticsDeclarationMode | string | uncertain | 物流申报模式 |
| ----whCode | string | CPartner | 仓库编码 |
| ----priceType | integer | 1 | 是否包税 |
| ----erpCode | string | 001231 | 商家编码 |
| ----articleNo | string | 123d12fd | 商品货号 |
| ----inventoryType | integer | 1 | 商品库存类型 |
| ----splData | object | spl 信息 | |
| ----id | string | 65a0****d22f | spl 编号，仅用于返回 |
| ----feature | string | 使用简单功能强大 | 八字真言：创建时必填 |
| ----imageUrls | array | 主图 url | |
| ----transparentImageUrl | string | http://img.xiaohongshu.com/items/123456789 | 透明图 |
| ----imageDescUrls | array | 图文描述 | |
| ----userGuideImageUrls | array | 使用指南图片 | |
| ----variants | array | 规格列表 | |
| ----marketingImageUrl | string | http://img.xiaohongshu.com/items/123456789 | 营销主图 |
| ----deliveryTime | object | 发货时间信息 | |
| ----time | string | 2021/06/01 | 发货时间，相对时间(X)付款后 X 天内发货，绝对时间(YYYY/MM/DD)该天 24 点之前发货 |
| ----type | string | ABSOLUTE_TIME | 发货时间类型，DEFAULT:不设置 RELATIVE_TIME:相对时间 ABSOLUTE_TIME:绝对时间 |
| ----desc | string | 商品非常好用 | 商品描述 |
| ----videoUrl | string | http://img.xiaohongshu.com/items/123456789 | 主图视频 |
| ----faqs | array | 常见问题 | |
| ----specImageUrl | string | http://img.xiaohongshu.com/items/123456789 | 规格图（店铺为薯店时必填） |
| ----spvData | object | spv 信息 | |
| ----id | string | 65a0****d22f | SPV 编号，仅用于返回 |
| ----nonDescVariants | array | SPV 规格 | |
| ----barcode | string | RedTest20200507001 | 商品条形码，创建特定品类必填 |
| ----country | string | 中国 | 原产国 |
| ----netWeight | number | 150 | 净重（单位克） |
| ----grossWeight | number | 130 | 毛重（单位克） |
| ----unit | string | 件/辆/把 | 计量单位 |
| ----buyable | boolean | True | 是否在架上，仅用于返回 |
| ----unionItemDetails | array | 组合商品子商品信息，仅返回使用 | |
| ----createTime | integer | 商品创建时间，仅返回使用 | |
| ----updateTime | integer | 商品更新时间，仅返回使用 | |
| ----name | string | 商品名称，仅返回使用 | |
| ----additionalData | object | 商品额外信息，仅返回使用 |
返回数据
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |