V兔API开放平台

参数	类型	必选	描述
shop_id	string	是	店铺 id
product_id	int	是	商品 ID
web_site	string	否	站点信息，指定调用的 API 是属于国际站（alibaba）还是 1688 网站（1688）
scene	string	否	业务场景零售通(lst) 1688 市场(1688)

请求示例

{
  "order_id": "201089727630969811",
  
"delayed_days": 7
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/1688get-commodity' --header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf' --header 'Content-Type: application/json' --data-raw '{
    "product_id":1
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/1688get-commodity',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "product_id":1
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"product_id\":1\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/1688get-commodity")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

响应参数

名称	类型	描述
code	int	返回状态码
msg	string	返回码描述
msec	int	接口执行时间
time	int	接口返回时间
data	object	数据信息
product_info	object	商品详细信息
product_id	int	商品 ID
product_type	string	商品类型，在线批发商品(wholesale)或者询盘商品(sourcing)，1688 网站缺省为 wholesale
category_id	int	类目 ID，标识商品所属类目
attributes	array	商品属性和属性值
attribute_id	int	属性 ID
attribute_name	string	属性名称
value_id	int	属性值 ID
value	string	属性值
is_custom	bool	是否为自定义属性，国际站无需关注
group_id	int[]	分组 ID，确定商品所属分组。1688 可传入多个分组 ID，国际站同一个商品只能属于一个分组，因此默认只取第一个
status	string	商品状态。published:上网状态;member expired:会员撤销;auto expired:自然过期;expired:过期(包含手动过期与自动过期);member deleted:会员删除;modified:修改;new:新发;deleted:删除;TBD:to be delete;approved:审批通过;auditing:审核中;untread:审核不通过;
subject	string	商品标题，最多 128 个字符
description	string	商品详情描述，可包含图片中心的图片 URL
language	string	语种，参见 FAQ 语种枚举值，1688 网站默认传入 CHINESE
period_of_validity	int	信息有效期，按天计算，国际站无此信息
biz_type	int	业务类型。1：商品，2：加工，3：代理，4：合作，5：商务服务。国际站按默认商品。
picture_auth	bool	是否图片私密信息，国际站此字段无效
image	object	商品主图
images	array	主图列表，使用相对路径，需要增加域名：https://cbu01.alicdn.com/
is_watermark	bool	是否打水印，是(true)或否(false)，1688 无需关注此字段，1688 的水印信息在上传图片时处理
is_watermark_frame	bool	水印是否有边框，有边框(true)或者无边框(false)，1688 无需关注此字段，1688 的水印信息在上传图片时处理
watermark_position	string	水印位置，在中间(center)或者在底部(bottom)，1688 无需关注此字段，1688 的水印信息在上传图片时处理
sku_infos	array	sku 信息
attributes	array	SKU 属性值，可填多组信息
attribute_id	int	sku 属性 ID
att_value_id	int	sku 值 ID，1688 不用关注
attribute_value	string	sku 值内容，国际站不用关注
custom_value_name	string	自定义属性值名称，1688 无需关注
sku_image_url	string	sku 图片
attribute_display_name	string	sku 属性 ID 所对应的显示名，比如颜色，尺码
attribute_name	string	sku 属性 ID 所对应的显示名，比如颜色，尺码
attr_type	string	sku 属性类型；1-表示该属性是规格属性；2-表示该属性是规格扩展属性
cargo_number	string	指定规格的货号，国际站无需关注
amount_on_sale	int	可销售数量，国际站无需关注
retail_price	double	建议零售价，国际站无需关注
price	int	报价时该规格的单价，国际站注意要点：含有 SKU 属性的在线批发产品设定具体价格时使用此值，若设置阶梯价格则使用 priceRange
price_range	array	阶梯报价，1688 无需关注
start_quantity	int
price	int
sku_code	string	商品编码，1688 无需关注
sku_id	int	skuId, 国际站无需关注
spec_id	string	specId, 国际站无需关注
consign_price	int	分销基准价。代销场景均使用该价格。无 SKU 商品查看 saleInfo 中的 consignPrice
sale_info	object	商品销售信息
support_online_trade	bool	是否支持网上交易。true：支持 false：不支持，国际站不需关注此字段
mix_whole_sale	bool	是否支持混批，国际站无需关注此字段
sale_type	string	销售方式，按件卖(normal)或者按批卖(batch)，1688 站点无需关注此字段
price_auth	bool	是否价格私密信息，国际站无需关注此字段
price_ranges	array	区间价格。按数量范围设定的区间价格
start_quantity	int
price	int
amount_on_sale	int	可售数量，国际站无需关注此字段
unit	string	计量单位
min_order_quantity	int	最小起订量，范围是 1-99999。
batch_number	int	每批数量，默认为空或者非零值，该属性不为空时 sellunit 为必填
retailprice	int	建议零售价，国际站无需关注
tax	string	税率相关信息，内容由用户自定，国际站无需关注
sellunit	string	售卖单位，如果为批量售卖，代表售卖的单位，该属性不为空时 batchNumber 为必填，例如 1"手"=12“件"的"手"，国际站无需关注
quote_type	int	普通报价-FIXED_PRICE("0"),SKU 规格报价-SKU_PRICE("1"),SKU 区间报价（商品维度）-SKU_PRICE_RANGE_FOR_OFFER("2"),SKU 区间报价（SKU 维度）-SKU_PRICE_RANGE("3")，国际站无需关注
consign_price	int	分销基准价。代销场景均使用该价格。有 SKU 商品查看 skuInfo 中的 consignPrice
delivery_limit	int	发货时间限制（非买保发货周期），按开计算
shipping_info	object	商品物流信息
freight_template_id	int	运费模板 ID，0 表示运费说明，1 表示卖家承担运费，其他值表示使用运费模版。此参数可调用运费模板相关 API 获取
unit_weight	int	单位重量
package_size	string	尺寸，单位是厘米，长宽高范围是 1-9999999。1688 无需关注此字段
volume	int	体积，单位是立方厘米，范围是 1-9999999，1688 无需关注此字段
handling_time	int	备货期，单位是天，范围是 1-60。1688 无需处理此字段
send_goods_address_id	int	发货地址 ID，国际站无需处理此字段
send_goods_address_text	string	发货地描述
extend_infos	array	商品扩展信息
key	string	扩展结构的 key
value	string	扩展结构的 value
supplier_user_id	string	供应商用户 ID
quality_level	int	质量星级(0-5)
supplier_login_id	string	供应商 loginId
category_name	string	类目名
main_vedio	string	主图视频播放地址
product_cargo_number	string	商品货号，产品属性中的货号
cross_border_offer	bool	是否海外代发
reference_price	string	参考价格，返回价格区间，可能为空
create_time	string	创建时间
last_update_time	string	最后操作时间
expire_time	string	过期时间
modify_time	string	修改时间
approved_time	string	审核时间
last_repost_time	string	最后重发时间
booked_count	string	成交量
product_line	string	产品线
detail_vedio	string	详情视频
international_trade_info	object	商品国际贸易信息，1688 无需处理此字段
fob_currency	string	FOB 价格货币，参见 FAQ 货币枚举值
fob_min_price	string	FOB 最小价格
fob_max_price	string	FOB 最大价格
fob_unit_type	string	FOB 计量单位，参见 FAQ 计量单位枚举值
payment_methods	array	付款方式，参见 FAQ 付款方式枚举值
min_order_quantity	int	最小起订量
min_order_unit_type	string	最小起订量计量单位，参见 FAQ 计量单位枚举值
supply_quantity	int	supplyQuantity
supply_unit_type	string	供货能力计量单位，参见 FAQ 计量单位枚举值
supply_period_type	string	供货能力周期，参见 FAQ 时间周期枚举值
delivery_port	string	发货港口
delivery_time	string	发货期限
consignment_date	int	新发货期限
packaging_desc	string	常规包装
biz_group_infos	array	产品业务的支持信息，support 为 false 说明不支持。
support	bool	是否支持
description	string	垂直市场名字，如微供市场、货品市场
code	string	垂直市场标记
seller_login_id	string	卖家旺旺 ID
intelligent_info	object	商品算法智能改写信息，包含算法优化后的商品标题和图片信息，未改写的则直接返回原标题和原图片
title	string	算法优化后的商品标题
images	array	算法优化后的商品图片
sku_images	array	算法优化后的规格图片
sku_id	int	skuId
image_url	string	算法处理后的图片地址，未处理则返回原图片地址
description_images	array	算法优化后的详情图片
processing	object	加工定制信息
image_list	array	产品样图
image_id	int	图片 ID
image_name	string	图片名称
image_url	string	图片地址
relation_category_list	array	涵盖品类
category_id	string	类目 ID
category_name	string	类目名称
attribute_list	array	加工定制属性
key	string	属性 key
name	string	属性名
value	string	属性值
value_name	string	属性值名称
relation_offer	object	关联的现货
stock_offers	int[]	关联的现货
trade_attributes	object	交易信息
refer_price_list	array	加工方式的参考价格
key	string	参考价 key
refer_price	object	参考价内容
prop_list	array	参考价属性列表
key	int	属性 key
value	string	属性值
amount	int	起订量
price	int	价格区间（最低价）
max_price	int	价格区间（最高价）
reserve_range_list	array	出货周期
begin_amount	int	订货数量
date	int	预计出货时间（天）
end_amount	int	订货截止数量
sample_price	int	打样价格（支持打样需传此参数，单位：元）
sample_date	int	打样周期（支持打样需传此参数，单位：天）
unit_name	string	计量单位
min_reserve_amount	int	最小预定数量
max_reserve_amount	int	最大预定数量
biz_group_infos	array	产品业务的支持信息，support 为 false 说明不支持。
support	bool	是否支持
description	string	垂直市场名字，如微供市场、货品市场
code	string	垂直市场标记
withholding_money	int	该接口扣费金额（点券）

返回数据


{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
    "expire_time": "20281215124625000+0800",
    "biz_group_infos": [
        {
            "support": false,
            "description": "零售通",
            "code": "is_retail_offer"
  },
        {
            "support": false,
            "description": "微供商品",
            "code": "is_micro_supply"
  },
        {
            "support": false,
            "description": "1688企业内部商城",
            "code": "is_emall_offer"
  },
        {
            "support": false,
            "description": "1688代销产品",
            "code": "is_consign_market_offer"
  },
        {
            "support": false,
            "description": "代发业务产品",
            "code": "has_linked_to_supplier"
  }
    ],
    "create_time": "20181216141253000+0800",
    "approved_time": "20181218124625000+0800",
    "product_info": {
        "product_id": 584240750353,
        "product_type": "wholesale",
        "category_id": 1043766,
        "attributes": [
            {
                "attribute_id": 2176,
                "attribute_name": "品牌",
                "value": "忆江南",
                "is_custom": false
    },
    
            {
      
                "attribute_id": 7869,
      
                "attribute_name": "是否进口",
      
                "value": "否",
      
                "is_custom": false
            
    },
    
            {
      
                "attribute_id": 159484581,
      
                "attribute_name": "原产国/地区",
      
                "value": "澳大利亚",
      
                "is_custom": false
            
    }
        ],
    
        "status": "published",
    
        "subject": "susui素水品牌304真空镀铜500ml透明盖高档保温杯高档随手保温杯",
    
        "description": "susui素水品牌304真空镀铜500ml透明盖高档保温杯高档随手保温杯",
    
        "language": "chinese",
    
        "period_of_validity": 3650,
    
        "biz_type": 1,
    
        "picture_auth": false,
    
        "image": {
      
            "images": [
                "img/ibank/2015/681/907/20397091861984794539.jpg",
      
                "img/ibank/2015/781/907/20397091871984794539.jpg",
      
                "img/ibank/2015/981/907/20397091891984794539.jpg",
      
                "img/ibank/2015/131/099/20369901311984794539.jpg",
      
                "img/ibank/2015/371/099/20369901731984794539.jpg",
      
                "img/ibank/2015/141/099/20369901411984794539.jpg",
      
                "img/ibank/2015/551/099/20369901551984794539.jpg"
            ]
        
    },
    
        "sku_infos": [
            {
      
                "attributes": [
                    {
        
                        "attribute_id": 3216,
        
                        "attribute_value": "清新蓝",
        
                        "sku_image_url": "img/ibank/2015/131/099/20369901311984794539.jpg",
        
                        "attribute_display_name": "颜色",
        
                        "attribute_name": "颜色"
                    
      },
      
                    {
        
                        "attribute_id": 2340,
        
                        "attribute_value": "500ml",
        
                        "attribute_display_name": "容量",
        
                        "attribute_name": "容量"
                    
      }
                ],
      
                "cargo_number": "",
      
                "amount_on_sale": 1000,
      
                "sku_code": "3941927601960",
      
                "sku_id": 3941927601960,
      
                "spec_id": "8ee78ffbdcb30c53861739e60be04325",
      
                "consign_price": 23
            
    }
        ],
    
        "sale_info": {
      
            "support_online_trade": true,
      
            "mix_whole_sale": false,
      
            "sale_type": "normal",
      
            "price_auth": false,
      
            "price_ranges": [
                {
        
                    "start_quantity": 3,
        
                    "price": 23
                
      },
      
                {
        
                    "start_quantity": 50,
        
                    "price": 22
                
      },
      
                {
        
                    "start_quantity": 500,
        
                    "price": 21
                
      }
            ],
      
            "amount_on_sale": 4047,
      
            "min_order_quantity": 3,
      
            "quote_type": 2,
      
            "consign_price": 23
        
    },
    
        "shipping_info": {
      
            "freight_template_id": 0
        
    },
    
        "extend_infos": [
            {
      
                "key": "is_support_step_pay",
      
                "value": "false"
            
    },
    
            {
      
                "key": "is_support_mix",
      
                "value": "false"
            
    },
    
            {
      
                "key": "is_alipay_supported",
      
                "value": "true"
            
    }
        ],
    
        "quality_level": 6,
    
        "product_cargo_number": "透明盖保温杯",
    
            "processing":  {
      
      "attribute_list":  [
        {
        
          "key":  "production_capacity",
        
          "name":  "生产产能",
        
          "value":  "10",
        
          "value_name":  "双"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "2201",
        
          "value_name":  "来样加工"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "2202",
        
          "value_name":  "来图加工"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "2204",
        
          "value_name":  "贴牌加工"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "2305",
        
          "value_name":  "加印logo"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "2306",
        
          "value_name":  "包装物料"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "9999",
        
          "value_name":  "其他加工"
        
      },
      
        {
        
          "key":  "production_grade",
          "name":  "生产档次",
          "value":  "v2",
          "value_name":  "中等"
      },
        {
          "key":  "production_grade",
          "name":  "生产档次",
          "value":  "v1",
          "value_name":  "高级"
      },
        {
          "key":  "production_grade",
          "name":  "生产档次",
          "value":  "v4",
          "value_name":  "大众"
      }
      ],
      "image_list":  [
        {
          "image_id":  15307542938,
          "image_name":  "b2de9c82d158ccbf256dd55512d8bc"
      }
      ],
      "relation_category_list":  [
        {
          "category_id":  "54>127484008>201158704",
          "category_name":  "服饰配件、饰品>手套/袖套>婚庆手套"
      }
      ],
      "relation_offer":  {
        "stock_offers":  [
          631375849349
        ]
      },
      "trade_attributes":  {
        "refer_price_list":  [
          {
            "key":  "2306",
            "refer_price":  {
              "amount":  10,
              "max_price":  1000.0,
              "price":  100.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "包装物料"
            }
              ]
          }
        },
          {
            "key":  "2305",
            "refer_price":  {
              "amount":  10,
              "max_price":  1000.0,
              "price":  100.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "加印logo"
            }
              ]
          }
        },
          {
            "key":  "2204",
            "refer_price":  {
              "amount":  10,
              "max_price":  1000.0,
              "price":  100.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "贴牌加工"
            }
              ]
          }
        },
          {
            "key":  "2202",
            "refer_price":  {
              "amount":  10,
              "max_price":  1000.0,
              "price":  100.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "来图加工"
            }
              ]
          }
        },
          {
            "key":  "2201",
            "refer_price":  {
              "amount":  1000,
              "max_price":  10000.0,
              "price":  1000.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "来样加工"
            }
              ]
          }
        },
          {
            "key":  "9999",
            "refer_price":  {
              "amount":  10,
              "max_price":  1000.0,
              "price":  100.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "其他加工"
            }
              ]
          }
        }
        ],
        "reserve_range_list":  [
          {
            "begin_amount":  2000,
            "date":  2000
        }
        ],
        "sample_price":  100.0,
        "sample_time":  100,
        "unit_name":  "件"
      }
    },
        "create_time": "20181216141253000+0800",
        "last_update_time": "20181218124625000+0800",
        "expire_time": "20281215124625000+0800"
  },
    "last_update_time": "20181218124625000+0800",
    "last_repost_time": "20181218124625000+0800"
}

}

响应代码

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