商品新增接口

单个商品发布,需要配合pdd.goods.image.upload上传主图及商品详情图片。

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/pdd/goods/add

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

request_data请求报文示例

{
  "multi_price": 80000,
  "thumb_url": "https://img.pddpic.com/open-gw/2021-10-11/ffc9a1e35840c3cf7f7af66f56c004c1.jpeg",
  "two_pieces_discount": 95,
  "shipment_limit_second": "86400",
  "is_onsale": 0,
  "is_folt": true,
  "image_url":"https://img.pddpic.com/garner-api-open/2025-08-11/39b3e14a36a0e0e4e79681381d6e6c73.jpg",
  "sku_properties": [
    {
      "template_pid": 96688,
      "template_module_id": 22326,
      "ref_pid": 310,
      "pid": 5,
      "value": "",
      "value_unit": ""
    }
  ],
  "second_hand": false,
  "price": 80000,
  "cat_id": 8464,
  "limit_quantity": 999,
  "is_pre_sale": false,
  "goods_name": "女装测试的宝贝,不要拍!!!",
  "quantity": 100,
  "weight": 100,
  "goods_desc": "女装测试的内容,好宝贝",
  "detail_gallery": [
    "https://img.pddpic.com/garner-api-open/2025-08-11/767ce4d219ac4364eb868457af68e70e.jpg",
    "https://img.pddpic.com/garner-api-open/2025-08-11/39b3e14a36a0e0e4e79681381d6e6c73.jpg"
  ],
  "carousel_gallery": [
    "https://img.pddpic.com/garner-api-open/2025-08-11/767ce4d219ac4364eb868457af68e70e.jpg"
  ],
  "is_refundable": true,
  "sku_list": [
    {
      "id": 0,
      "limit_quantity": 0,
      "out_sku_sn": "",
      "spec_id_list": "[765]",
      "is_onsale": 0,
      "price_in_yuan": "10",
      "multi_price": 79900,
      "price": 80000,
      "quantity": 20,
      "thumb_url": "https://img.pddpic.com/garner-api-open/2025-08-11/767ce4d219ac4364eb868457af68e70e.jpg",
      "thumb_url_file_id": 898996070,
      "weight": 0,
      "spec": [
        {
          "parent_id": 1216,
          "parent_name": "尺寸",
          "spec_id": 765,
          "spec_name": "小号"
        }
      ],
      "sku_srv_templates": ""
    },
    {
      "id": 0,
      "limit_quantity": 0,
      "out_sku_sn": "",
      "spec_id_list": "[767]",
      "is_onsale": 1,
      "price_in_yuan": "11",
      "multi_price": 79900,
      "price": 80000,
      "quantity": 20,
      "thumb_url": "https://img.pddpic.com/garner-api-open/2025-08-11/767ce4d219ac4364eb868457af68e70e.jpg",
      "thumb_url_file_id": 898953569,
      "weight": 0,
      "spec": [
        {
          "parent_id": 1216,
          "parent_name": "尺寸",
          "spec_id": 767,
          "spec_name": "大号"
        }
      ],
      "sku_srv_templates": ""
    }
  ],
  "market_price": 82000,
  "goods_type": "2",
  "cost_template_id": "163280639235619",
  "country_id": "10"
}

相关的商品部分入参见拼多多文档

2. 请求示例代码(Java)


  @Test
    public void PddGoodsAddRequestByReqData() 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());
       String reqData ="{\n" + "  \"multi_price\": 80000,\n" + "  \"thumb_url\": \"https://img.pddpic.com/open-gw/2021-10-11/ffc9a1e35840c3cf7f7af66f56c004c1.jpeg\",\n" + "  \"two_pieces_discount\": 95,\n" + "  \"shipment_limit_second\": \"86400\",\n" + "  \"is_onsale\": 0,\n" + "  \"is_folt\": true,\n" + "  \"image_url\":\"https://img.pddpic.com/garner-api-open/2025-08-11/39b3e14a36a0e0e4e79681381d6e6c73.jpg\",\n" + "  \"sku_properties\": [\n" + "    {\n" + "      \"template_pid\": 96688,\n" + "      \"template_module_id\": 22326,\n" + "      \"ref_pid\": 310,\n" + "      \"pid\": 5,\n" + "      \"value\": \"\",\n" + "      \"value_unit\": \"\"\n" + "    }\n" + "  ],\n" + "  \"second_hand\": false,\n" + "  \"price\": 80000,\n" + "  \"cat_id\": 8464,\n" + "  \"limit_quantity\": 999,\n" + "  \"is_pre_sale\": false,\n" + "  \"goods_name\": \"女装测试的宝贝,不要拍!!!\",\n" + "  \"quantity\": 100,\n" + "  \"weight\": 100,\n" + "  \"goods_desc\": \"女装测试的内容,好宝贝\",\n" + "  \"detail_gallery\": [\n" + "    \"https://img.pddpic.com/garner-api-open/2025-08-11/767ce4d219ac4364eb868457af68e70e.jpg\",\n" + "    \"https://img.pddpic.com/garner-api-open/2025-08-11/39b3e14a36a0e0e4e79681381d6e6c73.jpg\"\n" + "  ],\n" + "  \"carousel_gallery\": [\n" + "    \"https://img.pddpic.com/garner-api-open/2025-08-11/767ce4d219ac4364eb868457af68e70e.jpg\"\n" + "  ],\n" + "  \"is_refundable\": true,\n" + "  \"sku_list\": [\n" + "    {\n" + "      \"id\": 0,\n" + "      \"limit_quantity\": 0,\n" + "      \"out_sku_sn\": \"\",\n" + "      \"spec_id_list\": \"[765]\",\n" + "      \"is_onsale\": 0,\n" + "      \"price_in_yuan\": \"10\",\n" + "      \"multi_price\": 79900,\n" + "      \"price\": 80000,\n" + "      \"quantity\": 20,\n" + "      \"thumb_url\": \"https://img.pddpic.com/garner-api-open/2025-08-11/767ce4d219ac4364eb868457af68e70e.jpg\",\n" + "      \"thumb_url_file_id\": 898996070,\n" + "      \"weight\": 0,\n" + "      \"spec\": [\n" + "        {\n" + "          \"parent_id\": 1216,\n" + "          \"parent_name\": \"尺寸\",\n" + "          \"spec_id\": 765,\n" + "          \"spec_name\": \"小号\"\n" + "        }\n" + "      ],\n" + "      \"sku_srv_templates\": \"\"\n" + "    },\n" + "    {\n" + "      \"id\": 0,\n" + "      \"limit_quantity\": 0,\n" + "      \"out_sku_sn\": \"\",\n" + "      \"spec_id_list\": \"[767]\",\n" + "      \"is_onsale\": 1,\n" + "      \"price_in_yuan\": \"11\",\n" + "      \"multi_price\": 79900,\n" + "      \"price\": 80000,\n" + "      \"quantity\": 20,\n" + "      \"thumb_url\": \"https://img.pddpic.com/garner-api-open/2025-08-11/767ce4d219ac4364eb868457af68e70e.jpg\",\n" + "      \"thumb_url_file_id\": 898953569,\n" + "      \"weight\": 0,\n" + "      \"spec\": [\n" + "        {\n" + "          \"parent_id\": 1216,\n" + "          \"parent_name\": \"尺寸\",\n" + "          \"spec_id\": 767,\n" + "          \"spec_name\": \"大号\"\n" + "        }\n" + "      ],\n" + "      \"sku_srv_templates\": \"\"\n" + "    }\n" + "  ],\n" + "  \"market_price\": 82000,\n" + "  \"goods_type\": \"2\",\n" + "  \"cost_template_id\": \"163280639235619\",\n" + "  \"country_id\": \"10\"\n" + "}";
       data.put("request_data",reqData);
        // 参数签名
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.PddGoodsAddRequestUrl, data);

    }

3. 返回结果

返回结果如下。

{
  "code": 0,
  "data": {
    "goods_commit_id": 164489173095,
    "goods_id": 794029426838,
    "matched_spu_id": null,
    "request_id": "17549067735883097"
  },
  "message": "ok"
}

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

文档更新时间: 2025-08-14 23:21   作者:admin