商品明细

获取商品明细

支持应用：OMS

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/pdd/goods/detail/get

参数名	类型	必须	说明
appid	String	必填	合作伙伴AppId
timestamp	String	必填	当前时间戳
tb_seller_nick	String	必填	拼多多账号, 非店铺名称
sign	String	必填	如何计算生成见示例代码
goods_id	LONG	必填	32342143

二、请求示例代码

Java

@Test
    public void PddGoodsDetailGet() throws Exception {
        String seller_nick = Config.PddSellerNick; // 拼多多卖家账号
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid", Config.AppId);
        data.put("seller_nick", seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("goods_id", "160210883299");
        // 参数签名
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.PddGoodsDetailGetUrl, data);

    }

三、返回结果

返回结果如下

{
    "code": 0,
    "message": "ok",
    "data": {
        "bad_fruit_claim": 0,
        "buy_limit": 999999,
        "carousel_gallery_list": ["https://t16img.yangkeduo.com/garner-api/583314e6541c02a1bdf468c1aa66f0f6.jpeg"],
        "cat_id": 18056,
        "cost_template_id": 197590968702499,
        "country_id": 0,
        "customer_num": 2,
        "customs": "",
        "delivery_one_day": 0,
        "delivery_type": null,
        "detail_gallery_list": ["https://t16img.yangkeduo.com/garner-api/c983f38fa4e71e1330b8f32c8aff5b71.jpeg"],
        "end_production_date": null,
        "fabric_content_id": null,
        "fabric_id": null,
        "goods_desc": "杯架A测试商品请不要拍",
        "goods_id": 160210883299,
        "goods_name": "A4白纸一张十圆不支持退货,不要乱拍!",
        "goods_pattern": 3,
        "goods_property_list": [{
            "punit": "",
            "ref_pid": 310,
            "template_pid": 137041,
            "vid": 67,
            "vvalue": "太力"
        }, {
            "punit": "",
            "ref_pid": 317,
            "template_pid": 137039,
            "vid": 12854,
            "vvalue": "塑料"
        }],
        "goods_trade_attr": null,
        "goods_travel_attr": null,
        "goods_type": 1,
        "hd_thumb_url": "http://t00img.yangkeduo.com/goods/images/2020-08-01/7c64ec4a8ef337bc373b96162ace562f.jpeg",
        "image_url": "",
        "invoice_status": 0,
        "is_customs": 0,
        "is_folt": 1,
        "is_group_pre_sale": null,
        "is_pre_sale": 0,
        "is_refundable": 1,
        "is_sku_pre_sale": 0,
        "lack_of_weight_claim": 0,
        "mai_jia_zi_ti": null,
        "market_price": 4000,
        "order_limit": 999999,
        "origin_country_id": 0,
        "out_source_goods_id": null,
        "out_source_type": null,
        "outer_goods_id": "g100",
        "oversea_goods": null,
        "oversea_type": 0,
        "paper_length": null,
        "paper_net_weight": null,
        "paper_plies_num": null,
        "paper_width": null,
        "pre_sale_time": 0,
        "production_license": null,
        "production_standard_number": null,
        "quan_guo_lian_bao": 0,
        "request_id": "16338768845354782",
        "second_hand": 0,
        "shang_men_an_zhuang": null,
        "shelf_life": null,
        "shipment_limit_second": 172800,
        "size_spec_id": null,
        "sku_list": [{
            "is_onsale": 1,
            "length": null,
            "limit_quantity": 999999,
            "multi_price": 1000,
            "out_sku_sn": "s50cm",
            "out_source_sku_id": null,
            "oversea_sku": {
                "measurement_code": null,
                "measurement_unit": null,
                "specifications": null,
                "taxation": null
            },
            "price": 1500,
            "quantity": 81,
            "reserve_quantity": 0,
            "sku_id": 648106686604,
            "sku_pre_sale_time": null,
            "sku_property_list": null,
            "spec": [{
                "parent_id": 1216,
                "parent_name": "尺寸",
                "spec_id": 72930,
                "spec_name": "50cm"
            }],
            "thumb_url": "https://t16img.yangkeduo.com/garner-api/70ec7360c13688309252f88a9ce49965.jpeg",
            "weight": 0
        }, {
            "is_onsale": 1,
            "length": null,
            "limit_quantity": 999999,
            "multi_price": 1900,
            "out_sku_sn": "s100cm",
            "out_source_sku_id": null,
            "oversea_sku": {
                "measurement_code": null,
                "measurement_unit": null,
                "specifications": null,
                "taxation": null
            },
            "price": 3300,
            "quantity": 111111,
            "reserve_quantity": 0,
            "sku_id": 648106686605,
            "sku_pre_sale_time": null,
            "sku_property_list": null,
            "spec": [{
                "parent_id": 1216,
                "parent_name": "尺寸",
                "spec_id": 42,
                "spec_name": "100cm"
            }],
            "thumb_url": "https://t16img.yangkeduo.com/garner-api/385531de9957fb1f3de0ce48956ee432.jpeg",
            "weight": 0
        }],
        "sku_type": null,
        "song_huo_an_zhuang": null,
        "song_huo_ru_hu": null,
        "start_production_date": null,
        "status": 1,
        "thumb_url": "http://t00img.yangkeduo.com/goods/images/2020-08-01/e153908d8b9fd170578848f81d504645.jpeg",
        "tiny_name": "",
        "video_gallery": [],
        "warehouse": "",
        "warm_tips": "",
        "zhi_huan_bu_xiu": 0
    },
    "trace_id": ""
}

说明： code为0表示成功，非0为失败，message会包含失败原因。

四、返回参数说明

参数接口	参数类型	例子	说明
bad_fruit_claim	INTEGER		坏果包赔
buy_limit	LONG		限购次数
carousel_gallery_list	STRING[]		商品轮播图列表
cat_id	LONG		叶子类目ID
cost_template_id	LONG		运费模版id
country_id	INTEGER		地区/国家id
customer_num	LONG		团购人数
customs	STRING		海关名称
delivery_one_day	INTEGER		是否当日发货,0 否，1 是
detail_gallery_list	STRING[]		商品详情图
goods_desc	STRING		商品描述
goods_id	LONG		商品id
goods_name	STRING		商品名称
goods_property_list	OBJECT[]		商品属性列表
punit	STRING		属性单位
ref_pid	LONG		引用属性id
template_pid	LONG		模板属性Id
vid	LONG		基础属性值Id
vvalue	STRING		基础属性值
goods_trade_attr	OBJECT		日历商品交易相关信息
advances_days	INTEGER		提前预定天数，默认为0表示当天可预定
booking_notes	OBJECT		预订须知
url	STRING		预定须知图片地址
life_span	INTEGER		卡券有效期，日历日期后多少天可用。默认值为0表示仅限日历日当天使用
goods_travel_attr	OBJECT		日历商品出行信息
need_tourist	BOOLEAN		出行人是否必填（默认是）
type	INTEGER		日历商品类型1:旅行类,2:住宿类,3:票务类
goods_type	INTEGER		商品类型：1-国内普通商品，2-进口，3-国外海淘，4-直邮 ,5-流量,6-话费,7,优惠券;8-QQ充值,9-加油卡 暂时支持1-普通商品的上架
image_url	STRING		商品主图
invoice_status	INTEGER		是否支持正品发票；0-不支持、1-支持
is_customs	INTEGER		是否需要上报海关 0:否 1:是
is_folt	INTEGER		是否支持假一赔十，0-不支持，1-支持
is_pre_sale	INTEGER		是否预售,1-预售商品，0-非预售商品
is_refundable	INTEGER		是否7天无理由退换货，1-支持，0-不支持
lack_of_weight_claim	INTEGER		缺重包退
mai_jia_zi_ti	STRING		买家自提模版id
market_price	LONG		参考价格，单位为分
order_limit	LONG		单次限量
outer_goods_id	STRING		商家编码（商品维度），同其他接口中的outer_goods_id 、out_goods_id、out_goods_sn、outer_goods_sn 都为商家编码（goods维度）。
out_source_goods_id	STRING		第三方商品Id
out_source_type	INTEGER		第三方商品来源
oversea_goods	OBJECT		oversea_goods
bonded_warehouse_key	STRING		保税仓唯一标识
consumption_tax_rate	INTEGER		消费税率
customs_broker	STRING		清关服务商
hs_code	STRING		海关编号
value_added_tax_rate	INTEGER		增值税率
oversea_type	INTEGER		oversea_type
pre_sale_time	LONG		预售时间
quan_guo_lian_bao	INTEGER		0：不支持全国联保；1：支持全国联保
second_hand	INTEGER		是否二手 1:是 0:否
shang_men_an_zhuang	STRING		上门安装模版id
shipment_limit_second	LONG		承诺发货时间（ 秒）
size_spec_id	LONG		尺码表id
skuType	INTEGER		库存方式（0：普通型，1：日历型）
sku_list	OBJECT[]		sku列表
is_onsale	INTEGER		上下架状态 1：上架 0 ：下架
length	LONG		sku送装参数：长度
limit_quantity	LONG		sku购买限制
multi_price	LONG		商品团购价格 单位分
out_sku_sn	STRING		商家编码（sku维度），同其他接口中的outer_id 、out_id、out_sku_sn、outer_sku_sn、out_sku_id、outer_sku_id 都为商家编码（sku维度）。
out_source_sku_id	STRING		第三方sku Id
oversea_sku	OBJECT		oversea_sku
measurement_code	STRING		计量单位编码，从接口pdd.gooods.sku.measurement.list获取desc
specifications	STRING		规格
taxation	INTEGER		税费
price	LONG		商品单买价格 单位分
quantity	LONG		库存
reserve_quantity	LONG		预扣库存
sku_id	LONG		sku编码
spec	OBJECT[]		商品规格列表
parent_id	LONG		自定义规格所属的规格ID
parent_name	STRING		商品规格ID对应的规格名称
spec_id	LONG		自定义规格ID
spec_name	STRING		自定义规格名称
thumb_url	STRING		sku预览图
weight	LONG		重量，单位为g
sku_property_list	OBJECT[]		sku属性
punit	STRING		属性单位
ref_pid	LONG		属性id
value	STRING		属性值
vid	LONG		属性值id
sku_pre_sale_time	INTEGER		sku预售时间，单位秒
song_huo_an_zhuang	STRING		送货入户并安装模版id
song_huo_ru_hu	STRING		送货入户模版id
status	INTEGER		商品状态 1:上架，2：下架，3：售罄 4：已删除
tiny_name	STRING		短标题，示例：新包装，保证产品的口感和新鲜度。单颗独立小包装，双重营养，1斤家庭分享装，更实惠新疆一级骏枣夹核桃仁。
video_gallery	OBJECT[]		商品视频
file_id	LONG		商品视频id
video_url	STRING		商品视频url
warehouse	STRING		保税仓
warm_tips	STRING		水果类目温馨提示
zhi_huan_bu_xiu	INTEGER		只换不修的天数，目前只支持0和365
delivery_type	INTEGER		发货方式。0：无物流发货；1：有物流发货。
is_group_pre_sale	INTEGER		是否成团预售。0：不是；1:是。
is_sku_pre_sale	INTEGER		是否sku预售，0：否，1：是