商品发布说明

获取当前店铺可发布商品类目（cat_id）

涉及接口：

pdd.goods.authorization.cats 获取当前授权商家可发布的商品类目信息

pdd.goods.cats.get 商品标准类目接口（多平台类目映射匹配使用）

1. 入参parent_cat_id=0获取所有的可供发布的一级类目

2. 叶子类目获取：循环调用此接口，入参parent_cat_id= 上一次调用返回结果中选择的类目id，获得下一级类目id，直至获取叶子类目

要点：注意使用最子集类目ID才可用于发布商品，需循环调用上述接口直至获取到最子集类目。

a. 中文按照2个字符计算，最多填写30个汉字（60个字符）

b. 商品标题=商品描述+相关属性，需与当前商品的分类、属性一致

c. 错误填写可能会引起流量减少甚至商品下架，请准确填写！

上传商品发布、销售活动过程中所需的图片、视频等素材。

涉及接口：

a. 图片上传：pdd.goods.image.upload 商品图片上传接口

b. 视频上传：pdd.goods.video.upload 商品视频上传接口（部分类目可用，需申请）

pdd.goods.file.info.get 文件空间详情查询（查看上传视频的审核状态） c. 素材上传：（白底图、长图等，部分类目可用）

• 通过pdd.goods.filespace.image.upload上传图片到图片空间。图片空间限制5G，上传后在商家后台图片空间可见

• 通过pdd.goods.material.create接口上传白底图长图等素材到商品

• 通过pdd.goods.material.delete接口删除商品中的素材

• 通过pdd.goods.material.query接口查询商品素材列表

各业务素材要求说明如下：

准确获取商品必填、可选属性，有利于商品在搜索和推荐中露出。

涉及接口：

pdd.goods.cat.rule.get类目商品发布规则查询接口

pdd.goods.template.property.value.search 模板属性值搜索接口

pdd.goods.out.property.mapping.get 站内外属性映射接口

涉及标品：

1.根据类目id查该类目下的标品规则。pdd.goods.cat.rule.get

2.根据标品搜索接口模糊搜索标品。pdd.goods.spu.search

3.根据标品查询接口精确获取标品信息。pdd.goods.spu.get

4.商品发布时将获取的标品信息传到商品属性信息上。

具体操作：

通过pdd.goods.cat.rule.get查询该类目的商品发布需要的属性及其他发布规则

1. 通过叶子类目id获取该类目的发布规则，目前返回标品、商品服务、属性等规则。

2. 从返回参数中获取ref_pid、vid（输入型属性值无此参数）、value入参到商品上传或编辑接口的goods_properties字段。

3. 注：接口返回的属性中is_sale=true的为销售属性（标准属性），入参此类属性需与规格结合，直接从该接口获取spec_id（规格id）并同时入参到属性字段goods_properties与规格字段sku_list中的spec_id_list；

   4.获取商品规格

   设置商品销售的规格，一般规格至多2种（销售属性规格可增至4种）

    

   涉及接口：

   pdd.goods.spec.get 商品属性类目接口

   pdd.goods.spec.id.get 生成商家自定义的规格

    

   注意：

   a. 通过pdd.goods.spec.get接口获取对应要发布的商品所属叶子类目所需的规格id

   b. 根据获取到的生成规格属性id请使用pdd.goods.spec.id.get接口生成商家自定义规格

   c. 部分类目已切至新版属性发布，请使用pdd.goods.cat.rule.get获取到的规格值（标准规格is_sale=true）发布。

    

   一般规格类型不超过2（销售属性规格至多为4种），spec_id_list中入参不超过2个spec_id；

   “一般类目规格和不超过44”指所有规格值不超过44，如颜色和尺寸：“黑、白....”加上“X、XL....”总数不超过44。

   所有规格在spec_id_list中需按笛卡尔积入参，即是需要将两种规格两两组合，举例：若有颜色A、B和尺寸a、b则有[A，a][A，b][B，a][B，b]四条sku。

    

   5.设置商品价格及库存

   商品上传时需预设商品参考价格及各规格单买价、拼单价及库存等信息。

    

   注意要点：

   价格：

   • 参考价格应高于所有SKU中的最大单买价格。

   • SKU单买价格需要比拼单价格高至少一元。

   库存：

   • 预估当前库存加上库存增减值应该大于或等于0

   • 下架的sku不能修改库存

   • 商品在资源位不能减少库存

    

   6.服务与承诺设置

   设置商品类型、是否二手、预售信息、承诺发货时间、运费模板、拼单要求等。

    

   预售信息：预售时间不能小于当前时间+承诺发货时间+1天之和

   承诺发货时间：

   • 普通商品：当日发货、24小时、48小时

   • 进口商品：48小时

   • 直邮直供：5天

   • cc行邮：5天

   运费模板：pdd.goods.logistics.template.get商品运费模版接口

   三．发布商品
   1.直接发布上架

   将准备好的商品参数信息入参到pdd.goods.add商品新增接口提交发布。

    

   2.创建草稿并从草稿发布上架

   pdd.goods.edit.goods.commit 新增或编辑草稿接口

   pdd.goods.submit.goods.commit 编辑并提交草稿接口

    

   商品发布中涉及的详细校验规则如下：

   • sku规格基础校验：

   内容	判断条件	报错信息
   规格值基础校验	每个sku的规格值数量是否一致	部分sku的规格信息不完整
   是否存在规格值	部分sku的规格值为空
   父规格数校验	最多4个父规格	规格数量不可超过4个
   父规格数量是否和sku的规格值数量一致	sku的规格信息不一致
   sku数量校验	是否符合笛卡尔积	sku数量和规格乘积不一致
   是否在限制的数量范围内	sku数量超过限制
   sku规格结构校验	是否存在规格一样的sku	sku规格值重复
   每个sku的父规格需要一样	sku的父规格不一致

    

   • sku内容相关校验：

   内容	判断条件	报错信息
   sku数量校验	sku数量要大于0	请至少添加一条SKU信息
   至少要有一个上架的sku	当前SKU已经全部下架，不可提交
   规格名校验	规格名为空	规格名称不能为空
   是否含特殊字符	规格名称包含特殊字符，请删除后重新添加
   敏感词校验	规格名中含有违规词，请删除后重新操作
   sku预览图校验	数量大于1个的预览图不能为空	请上传sku缩略图
   sku外部编码	outSkuSn长度不能超过100	商家编码超出100个中文字符长度限制，请重新修改

    

   • sku价格相关校验：

   内容	判断条件	报错信息
   参考价格对比sku的单买价	参考价格不得高于最高sku单买价的X倍	参考价格不得高于最高sku单买价的X倍：XX元
   1.SKU单买价格必须小于参考价格	SKU单买价格必须小于参考价格
   类目差倍率校验	团购价不能低于类目最低价	拼单价最低值不符合该商品参考价格请修改后重试
   团购价不能高于类目最高价	拼单价最高值不符合该商品参考价格，请修改后重试
   对于限制不可有价格差的类目，判断sku价格是否存在差异	商品规格的价格需要相同，请将不同规格的价格调至相同。若规格间实际价格有差异，请分成多个商品发布。
   对于允许sku价格存在差异但有价格差限制的类目，判断sku价格差是否超出限制倍率	商品的价格的范围过大，请缩小不同规格的价格范围。若规格间实际价格差异很大，请分成多个商品发布。
   团购价和单买价价格差校验	普通：价格差 100（分）	SKU单买价格需要比拼单价格高至少一元，请重新设置
   单买价上限	SKU单买价格太大，超过10_0000_0000（分）	SKU单买价格太大
   多件优惠活动	商品价格必须高于多件优惠的优惠金额	商品价格必须高于多件优惠的优惠金额
   价格不能为0	只有每团必中价格可以为0，且需要全部sku价格都为0	SKU的价格和拼单价格不合法

    

   • sku库存相关校验：

   内容	报错信息
   库存相关校验	skuId:%d 已绑定 货品，请去库存中心编辑
   sku需要先与库存中心解绑才能删除
   预估当前库存加上库存增减值应该大于或等于0
   当前库存包含XX个预扣库存，无法调整至更低
   单个sku预估库存+库存增减值需小于等于200000000
   sku库存不能大于卡密数量
   虚拟优惠券商品不允许添加库存
   下架的sku不能修改库存

    四．查看发布状态并编辑

   使用草稿状态接口查询商品发布状态，根据商品状态信息编辑调整并重新提交。

    

   涉及接口如下：

   草稿查看

   pdd.goods.commit.detail.get 获取商品详情(单商品单草稿详情查询)

   pdd.goods.commit.list.get 草稿列表接口（根据草稿状态批量查询草稿）

   pdd.goods.commit.status.get 草稿状态查询接口（草稿id批量查询草稿）

   pdd.goods.latest.commit.status.get 批量goodsId查询最新的审核状态

    

   商品编辑

   1. 编辑线上商品：

   pdd.goods.information.update 商品编辑

   pdd.goods.quantity.update 接口修改sku库存

   pdd.goods.sku.price.update 接口更新sku价格

    

   2. 编辑草稿并提交：

   pdd.goods.submit.goods.commit 编辑并提交草稿接口