对接文档
temu 推送消息文档
ozon
ozon 调研任务:19835
本文档使用 MrDoc 发布
-
+
首页
temu 推送消息文档
### # 类目 队列(每天晚上自动同步推送): > ```PRODUCT_CATEGORY_TEMU_1000000001_QUEUE``` 公有云 > ```PRODUCT_CATEGORY_TEMU_1000000002_QUEUE``` 私有云 > ```PRODUCT_CATEGORY_TEMU_1000000003_QUEUE``` 海外版 队列(接口同步推送): > ```PRODUCT_CATEGORY_SINGLE_TEMU_1000000001_QUEUE``` 公有云 > ```PRODUCT_CATEGORY_SINGLE_TEMU_1000000002_QUEUE``` 私有云 > ```PRODUCT_CATEGORY_SINGLE_TEMU_1000000003_QUEUE``` 海外版 结构如下: ```json [{ "categoryId": 17, "categoryIdPath": "1,2,16,17", "categoryType": 0, "displayCategoryName": "其他(铁克诺音乐)", "displayCategoryNamePath": "CD和黑胶唱片,电子音乐、DJ舞曲,铁克诺音乐,其他(铁克诺音乐)", "isLeaf": 1, "originalCategoryName": "其他(铁克诺音乐)", "originalCategoryNamePath": "CD和黑胶唱片,电子音乐、DJ舞曲,铁克诺音乐,其他(铁克诺音乐)", "parentCategoryId": 16 }] ``` 字段解释: > ```categoryId```:类目 ID > ```categoryIdPath```:类目 ID 路径 > ```categoryType```:类目类型,0:未分类,1:服饰类 > ```displayCategoryName```:展示的类目名称(一般为中文) > ```displayCategoryNamePath```:展示的类目名称路径(一般为中文) > ```isLeaf```:是否也叶子节点 true:是 false:否 > ```originalCategoryName```:平台返回的原始类目名称(可能为各个国家的语言) > ```originalCategoryNamePath```:平台返回的原始类目名称(可能为各个国家的语言) > ```parentCategoryId```:父类目 ID ### # 类目属性 队列: > ```PRODUCT_CATEGORY_ATTRIBUTE_TEMU_1000000001_QUEUE``` 公有云 > ```PRODUCT_CATEGORY_ATTRIBUTE_TEMU_1000000002_QUEUE``` 私有云 > ```PRODUCT_CATEGORY_ATTRIBUTE_TEMU_1000000003_QUEUE``` 海外版 结构如下: ```json { "categoryId": 39107, // 类目 ID "attributes": { // 类目属性 "chooseAllQualifySpec": false, // 未知(忽略) "inputMaxSpecNum": 2, // 最多变种父规格数(对应叶子类目的规格数量) "singleSpecValueNum": 20, // 单个规格最多选项值 "properties": [{ // 属性列表 "chooseMaxNum": 1, // 最大选择数量(属性枚举最大可以选择的数量) "controlType": 1, // 控制类型,1:单选枚举,16:文本输入 "feature": 0, // 功能,0:普通属性,1:颜色属性,2:尺码属性(第二变种属性) "inputMaxNum": 0, // 最大输入数量 "isSale": false, // 是否必须用作销售规格,即 SKU 的规格(即是否可以用来做变种)(等同于 spec(决定 sku 的规格,例如颜色、尺码这类销售属性。决定了 SKU),必须作为规格) "mainSale": false, // 是否为主销售属性 "maxValue": "", // 最大值 "minValue": "", // 最小值 "name": "长度", // 属性名称 "pid": 12, // 属性 pid "propertyValueType": 0, // 属性值类型 "refPid": 28, // 属性 refPid "required": false, // 是否必填 "templatePid": 474946, // 属性 templatePid "valuePrecision": 0, // 未知 "valueRule": 0, // 属性值的规则,未知 "valueUnit": [""], // 属性值的单位(比如 %) "values": [{ // 属性值的可选项(属性枚举值) "value": "长款", "vid": 291 }, { "value": "中长", "vid": 622 }] }] } } ``` ### # 刊登结果推送 队列: > ```PUBLISH_PRODUCT_RESULT_TEMU_1000000001_QUEUE``` 公有云 > ```PUBLISH_PRODUCT_RESULT_TEMU_1000000002_QUEUE``` 私有云 > ```PUBLISH_PRODUCT_RESULT_TEMU_1000000003_QUEUE``` 海外版 结构如下: ```json { "id": 114083857765577364, // 任务 ID "flag": 9, // 任务状态,1:待刊登 2:刊登中 6:刊登失败 7:部分失败 9:刊登成功 "productId": "1729542726388189931", // 刊登成功的商品 ID "result": "刊登成功", // 结果描述/错误描述 "updateTime": 1665487719619 // 更新时间 } ``` ### # 店铺同步结果推送 队列: > ```ONLINE_PRODUCT_DOWNLOAD_TEMU_1000000001_QUEUE``` 公有云 > ```ONLINE_PRODUCT_DOWNLOAD_TEMU_1000000002_QUEUE``` 私有云 > ```ONLINE_PRODUCT_DOWNLOAD_TEMU_1000000003_QUEUE``` 海外版 结构如下: ```json { "shopStatus": 2, // 同步状态 1: 成功 2:同步中 3:同步失败 "total": 1491, // 本次同步商品数 "resultMessage": "拉取中" // 同步信息 } ``` ```json { "shopStatus": 1, "resultMessage": "店铺同步成功。", "version": "1673574931989" // 同步的版本号 } ``` ### # 同步商品结果推送 队列: > ```ONLINE_PRODUCT_DOWNLOAD_TEMU_1000000001_QUEUE``` 公有云 > ```ONLINE_PRODUCT_DOWNLOAD_TEMU_1000000002_QUEUE``` 私有云 > ```ONLINE_PRODUCT_DOWNLOAD_TEMU_1000000003_QUEUE``` 海外版 结构如下: ```json { "data": "{\"createdAt\":1673507714000,\"productJitMode\":{\"quickSellAgtSignStatus\":null,\"matchJitMode\":false},\"extCode\":\"\",\"productId\":434525774,\"leafCat\":{\"catId\":140609,\"catName\":\"苹果手机\"},\"productSkuSummaries\":[{\"productSkuId\":9031161864,\"extCode\":\"\",\"productSkuWhExtAttr\":{\"productSkuWeight\":{\"value\":10000},\"productSkuWmsWeight\":null,\"productSkuWmsVolume\":null,\"productSkuVolume\":{\"len\":100,\"width\":100,\"height\":100},\"productSkuBarCodes\":[],\"productSkuSensitiveAttr\":{\"sensitiveTypes\":[],\"isSensitive\":0},\"productSkuNewSensitiveAttr\":{\"sensitiveList\":[100000]}},\"virtualStock\":null,\"productSkuSpecList\":[{\"specId\":70235936,\"parentSpecName\":\"版本\",\"specName\":\"iphone 13\",\"parentSpecId\":70235935},{\"specId\":70228922,\"parentSpecName\":\"bg颜色3\",\"specName\":\"天蓝\",\"parentSpecId\":70211927},{\"specId\":70235946,\"parentSpecName\":\"机身内存\",\"specName\":\"128G\",\"parentSpecId\":70235945}],\"supplierPrice\":22200}],\"categories\":{\"cat4\":{\"catId\":0,\"catName\":\"\"},\"cat5\":{\"catId\":0,\"catName\":\"\"},\"cat2\":{\"catId\":140608,\"catName\":\"手机\"},\"cat3\":{\"catId\":140609,\"catName\":\"苹果手机\"},\"cat10\":{\"catId\":0,\"catName\":\"\"},\"cat1\":{\"catId\":140607,\"catName\":\"数码产品\"},\"leafCat\":null,\"cat8\":{\"catId\":0,\"catName\":\"\"},\"cat9\":{\"catId\":0,\"catName\":\"\"},\"cat6\":{\"catId\":0,\"catName\":\"\"},\"cat7\":{\"catId\":0,\"catName\":\"\"}},\"productSkcId\":7140914543,\"mainImageUrl\":\"https://img.htjdemo.com/product/Fancyalgo/VirtualModelMatting/bf0c2a6ffccb66c1d0590d1726f6f15b.jpg\",\"productName\":\"退样品6\"}", // 商品数据 "version": "1673524789598" // 版本号 } ``` ### # 商品数据 非服饰类目: ```json { "createdAt": 1673507714000, // 创建时间 "productJitMode": { // 货品 JIT 模式信息 "quickSellAgtSignStatus": 0, // 快速售卖协议签署状态 0-未签署 1-已签署 "matchJitMode": false // 是否 JIT 模式 }, "extCode": "", // SKC 货号 "productId": 434525774, // 商品 ID "leafCat": { // 叶子类目信息 "catId": 140609, "catName": "苹果手机" }, "productSkuSummaries": [{ // sku 信息 "productSkuId": 9031161864, // sku ID "extCode": "", // SKU 货号 "productSkuWhExtAttr": { // SKU 拓展信息 "productSkuWeight": { // SKU 商品重量 "value": 10000 }, "productSkuWmsWeight": { // SKU 商品WMS重量 "value": 10000 }, "productSkuWmsVolume": { // SKU 商品WMS体积 "len": 100, // SKU 商品长度 "width": 100, // SKU 商品宽度 "height": 100 // SKU 商品高度 }, "productSkuVolume": { // SKU 商品体积 "len": 100, // SKU 商品长度 "width": 100, // SKU 商品宽度 "height": 100 // SKU 商品高度 }, "productSkuBarCodes": [{ "code": "", // 条码 "codeType": "" // 条码类型 (1: EAN, 2: UPC, 3: ISBN) }], "productSkuSensitiveAttr": { // 敏感属性 "sensitiveTypes": [1], // 未知 "isSensitive": 0 // 是否敏感属性,0:非敏感,1:敏感 }, "productSkuNewSensitiveAttr": { // 新敏感属性 "sensitiveList": [100000] } }, "virtualStock": 1, // SKU 商品虚拟库存 "productSkuSpecList": [{ // SKU 商品属性 "specId": 70235936, // 属性值 ID "parentSpecName": "版本", // 父规格属性名称 "specName": "iphone 13", // 属性值名称 "parentSpecId": 70235935 // 父规格属性 ID }, { "specId": 70228922, "parentSpecName": "bg颜色3", "specName": "天蓝", "parentSpecId": 70211927 }, { "specId": 70235946, "parentSpecName": "机身内存", "specName": "128G", "parentSpecId": 70235945 }], "supplierPrice": 22200 // 供应商价格 }], "categories": { // 类目信息 "cat4": { "catId": 0, "catName": "" }, "cat5": { "catId": 0, "catName": "" }, "cat2": { "catId": 140608, "catName": "手机" }, "cat3": { "catId": 140609, "catName": "苹果手机" }, "cat10": { "catId": 0, "catName": "" }, "cat1": { "catId": 140607, "catName": "数码产品" }, "leafCat": null, "cat8": { "catId": 0, "catName": "" }, "cat9": { "catId": 0, "catName": "" }, "cat6": { "catId": 0, "catName": "" }, "cat7": { "catId": 0, "catName": "" } }, "productSkcId": 7140914543, // SKC ID "mainImageUrl": "https://img.htjdemo.com/product/Fancyalgo/VirtualModelMatting/bf0c2a6ffccb66c1d0590d1726f6f15b.jpg", // 主图 "productName": "退样品6" // 商品名称 } ``` 服饰类目: ```json { "createdAt": 1674893630000, "extCode": "", "productId": 997764212, "productJitMode": { "quickSellAgtSignStatus": null, "matchJitMode": false }, "leafCat": { "catId": 39107, "catName": "女装连衣裙" }, "productSkuSummaries": [{ "productSkuId": 3623777350, "productSkuWhExtAttr": { "productSkuWeight": { "value": 5000 }, "productSkuWmsVolume": null, "productSkuWmsWeight": null, "productSkuVolume": { "len": 10, "width": 10, "height": 10 }, "productSkuBarCodes": null, "productSkuSensitiveAttr": { "sensitiveTypes": [], "isSensitive": 0 }, "productSkuNewSensitiveAttr": { "sensitiveList": [100000] } }, "extCode": "rice-L", "virtualStock": null, "productSkuSpecList": [{ "specId": 15060, "parentSpecName": "颜色", "specName": "米白色", "parentSpecId": 1001 }, { "specId": 11002, "parentSpecName": "尺码", "specName": "L", "parentSpecId": 3001 }], "supplierPrice": 1000150 }, { "productSkuId": 7962611411, "productSkuWhExtAttr": { "productSkuWeight": { "value": 5000 }, "productSkuWmsVolume": null, "productSkuWmsWeight": null, "productSkuVolume": { "len": 10, "width": 10, "height": 10 }, "productSkuBarCodes": null, "productSkuSensitiveAttr": { "sensitiveTypes": [], "isSensitive": 0 }, "productSkuNewSensitiveAttr": { "sensitiveList": [100000] } }, "extCode": "rice-M", "virtualStock": null, "productSkuSpecList": [{ "specId": 15060, "parentSpecName": "颜色", "specName": "米白色", "parentSpecId": 1001 }, { "specId": 9005, "parentSpecName": "尺码", "specName": "M", "parentSpecId": 3001 }], "supplierPrice": 1000150 }], "categories": { "cat4": { "catId": 39107, "catName": "女装连衣裙" }, "cat5": { "catId": 0, "catName": "" }, "cat2": { "catId": 28946, "catName": "女士时尚" }, "cat3": { "catId": 28947, "catName": "女装" }, "cat10": { "catId": 0, "catName": "" }, "cat1": { "catId": 27011, "catName": "服装、鞋靴和珠宝饰品" }, "leafCat": null, "cat8": { "catId": 0, "catName": "" }, "cat9": { "catId": 0, "catName": "" }, "cat6": { "catId": 0, "catName": "" }, "cat7": { "catId": 0, "catName": "" } }, "productSkcId": 9203921079, "mainImageUrl": "https://img.kwcdn.com/product/enhanced_images/717ae8088d40a84e5888f9178e2af720_enhanced.jpg", "productName": "这是一个测试的连衣裙-mbz" } ``` ### # 平台报错整理: > 1 没填币种,"currencyType": "CNY"(currencyType 币种 字段(CNY: 人民币, USD: 美元,香港主体入参 USD) {"success":false,"requestId":"pg-1fa661fe-fb02-4ad8-85b9-f38f90b0b452","errorCode":3000000,"errorMsg":"币种不能为空;"} > 2 每个类目有自己的重量限制 {"success":false,"requestId":"pg-f28e55f0-08eb-4902-8667-5d638b21e0b0","errorCode":2000081,"errorMsg":"重量不符合类目2~99999g限制,无法售卖"} > 3 产地和站外链接(产地必须填,站外链接可以填空,但是要传) {"success":false,"requestId":"pg-e0fb2d7d-b944-4ab9-a24e-ed7ea461d70f","errorCode":1000003,"errorMsg":"参数错误:产地必填"} {"success":false,"requestId":"pg-d8f9b6e9-0bac-4088-bbb8-55fa184ea7d0","errorCode":3000000,"errorMsg":"站外商品链接不能为空;"} > 4 productPropertyReqs 普通属性中的 templatePid 填写错误或不存,需要更新属性 {"success":false,"requestId":"pg-942c0962-ce4c-49e1-a1e6-0d65af4ead1c","errorCode":2000047,"errorMsg":"存在不合法的普通属性"} > 5 某个属性的选项发生了变化所以传的 vid 不存在了 {"success":false,"requestId":"pg-5b2956ff-478b-4bf0-a5c3-ff3c10e9d213","errorCode":6000002,"errorMsg":"属性[×××]校验错误:属性值×××不存在,请刷新页面后重新创建货品"} > 6 productSpecPropertyReqs 销售属性中的 templatePid 填写错误或不存,需要更新属性 {"success":false,"requestId":"pg-c945a809-ec3a-43ab-a25e-4c19d027b862","errorCode":2000048,"errorMsg":"存在不合法的销售属性"} > 7 修改 productSkuReqs 中 productSkuSpecReqs 中的 specName name为其他的值报错,因此服饰类目sku中的规格名必须填属性拉下来的,并且规格id 和父规格id也要从属性中拉取下来的 {"success":false,"requestId":"pg-7b74eddd-87b8-4b86-97c9-b3be74ee91e0","errorCode":2000004,"errorMsg":"不合法的规格属性:颜色_红色"} > 8 当去掉 isSale 为true 的尺码属性报错 {"success":false,"requestId":"pg-60977ee0-f57f-47b5-adfe-db153b8fb016","errorCode":1000003,"errorMsg":"参数错误:参数错误:SKU销售规格属性值列表重复"} > 9 当 showSizeTemplateIds 和sizeTemplateIds 填写的ID错误或不存在时 {"success":false,"requestId":"pg-94e61490-4893-400e-814f-ddbad79570de","errorCode":6000012,"errorMsg":"重点展示尺码模板不合法"} > 10 sku 数量和规格乘积不一致时: {"success":false,"requestId":"pg-c2df9138-8d94-457c-b444-94f08419e13a","errorCode":1000003,"errorMsg":"参数错误:参数错误:SKU数量和规格乘积不一致"} > 11 productSpecPropertyReqs 中的属性和 sku 里面的属性不匹配时: {"success":false,"requestId":"pg-bd8d5ad2-5fb6-4697-83a7-0205ac77525a","errorCode":1000003,"errorMsg":"服饰类目sku规格必须包含skc规格信息"} > 12 当传给平台的字段格式不匹配时,比如 该传数字,而实际传的数组。 {"success":false,"requestId":"pg-6fc48ae8-4038-44d6-aa9c-fa2933b85075","errorCode":4000000,"errorMsg":"SYSTEM_EXCEPTION"} > 13 必填属性缺失 {"success":false,"requestId":"pg-4a4d088f-84d4-4249-b6ae-af5d24541755","errorCode":6000002,"errorMsg":"货品类目属性更新,请刷新页面后重新创建货品"} > 14 长宽高限制 长宽高单位为 mm,重量单位为 mg,填写体积与重量,材积重量一定要小于实际重量。长宽高最大限制为 299.9cm,重量最大限制 99999.9g ### # 不同分类的商品标题长度限制 ``` 分类ID 分类名称 限制长度 1 CD 和黑胶唱片 100 653 办公用品 200 1464 宠物用品 100 2096 大家电 150 2542 电子 500 4673 工业和科学 150 9711 家居厨房用品 250 13512 家居装修 250 15945 健康和家居用品 250 17719 乐器 250 18768 美容和个人护理 250 19858 汽车用品 250 23177 视频游戏 250 24252 手机和配件 250 24389 庭院、草坪和园艺 250 25439 玩具与游戏 200 26207 母婴用品 250 27011 服装、鞋靴和珠宝饰品 250 31148 运动与户外用品 250 ``` ### # 服饰类目和非服饰类目刊登的入参区别 > 1 服饰类目 > 可变种的销售属性在类目属性接口中返回。 > ```productSpecPropertyReqs``` 字段中需要填写所有子 sku 都会使用的到的销售属性和值,例如使用了颜色中的米白色和白色,尺码中的 L 和 M 变种,那么该字段的值如下: ```json "productSpecPropertyReqs": [{ "templatePid": 474944, "pid": 13, "refPid": 63, "propName": "颜色", "propValue": "米白色", "vid": 433, "valueUnit": "", "parentSpecName": "颜色", "parentSpecId": 1001, "specName": "米白色", "specId": 15060, "valueGroupId": 1, "valueGroupName": "白色系" }, { "templatePid": 474944, "pid": 13, "refPid": 63, "propName": "颜色", "propValue": "白色", "vid": 376, "valueUnit": "", "parentSpecName": "颜色", "parentSpecId": 1001, "specName": "白色", "specId": 2001, "valueGroupId": 1, "valueGroupName": "白色系" }, { "templatePid": 474945, "pid": 14, "refPid": 65, "propName": "尺码", "propValue": "L", "vid": 319, "valueUnit": "", "parentSpecName": "尺码", "parentSpecId": 3001, "specName": "L", "specId": 11002, "valueGroupId": 2, "valueGroupName": "中国码" }, { "templatePid": 474945, "pid": 14, "refPid": 65, "propName": "尺码", "propValue": "M", "vid": 317, "valueUnit": "", "parentSpecName": "尺码", "parentSpecId": 3001, "specName": "M", "specId": 9005, "valueGroupId": 2, "valueGroupName": "中国码" }] ``` > ```productSkcReqs``` 表示颜色的变种集合,对于一个确定的颜色(比如白色),如果下面还有尺码的变种,那么这部分的变种是在一个集合之中。```productSkcReqs``` 下的 ```mainProductSkuSpecReqs``` 应该填写为: ```json "mainProductSkuSpecReqs": [{ "specId": 2001, "parentSpecName": "颜色", "parentSpecId": 1001, "specName": "白色" }], ``` 而 ```productSkuReqs``` 之中应该填写白色的其他尺码(L 和 M)的变种商品信息。例如: ```json "productSkuReqs": [{ "thumbUrl": "https://img.kwcdn.com/product/enhanced_images/717ae8088d40a84e5888f9178e2af720_enhanced.jpg", "productSkuSpecReqs": [{ "specId": 2001, "parentSpecName": "颜色", "parentSpecId": 1001, "specName": "白色" }, { "specId": 11002, "parentSpecName": "尺码", "parentSpecId": 3001, "specName": "L" }], "supplierPrice": 1000150, "productSkuWhExtAttrReq": { "productSkuWeightReq": { "value": 500 }, "productSkuSensitiveLimitReq": {}, "productSkuVolumeReq": { "len": 10, "width": 10, "height": 10 }, "productSkuSensitiveAttrReq": { "isSensitive": 0, "sensitiveList": [] } }, "extCode": "white-L" }, { "thumbUrl": "https://img.kwcdn.com/product/enhanced_images/717ae8088d40a84e5888f9178e2af720_enhanced.jpg", "productSkuSpecReqs": [{ "specId": 2001, "parentSpecName": "颜色", "parentSpecId": 1001, "specName": "白色" }, { "specId": 9005, "parentSpecName": "尺码", "parentSpecId": 3001, "specName": "M" }], "supplierPrice": 1000150, "productSkuWhExtAttrReq": { "productSkuWeightReq": { "value": 500 }, "productSkuSensitiveLimitReq": {}, "productSkuVolumeReq": { "len": 10, "width": 10, "height": 10 }, "productSkuSensitiveAttrReq": { "isSensitive": 0, "sensitiveList": [] } }, "extCode": "white-M" }], ``` > 2 非服饰类目 > 如果类目属性中有返回销售属性,应该优先使用类目属性中的销售属性来变种,如果类目属性中没有返回,那么应该使用父规格接口返回的数据数选两个父规格来做变种。 > 如果使用了父规格来做变种,可以使用```生成子规格属性```接口来生成变种的选项(例如选了颜色规格来变种,调用生成子规格属性接口来生成红色)那么 ```productSpecPropertyReqs``` 的值应该为空,例如: ```json "productSpecPropertyReqs": [], ``` 对应的 ```productSkcReqs``` 中的 ```mainProductSkuSpecReqs```也为空,但是内容需要填写为如下: ```json "mainProductSkuSpecReqs": [{ "specId": 0, "parentSpecName": "", "parentSpecId": 0, "specName": "" }], ```
chenjunan
2023年2月19日 10:46
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
分享
链接
类型
密码
更新密码