邢增宾
coupang 台湾本土与已对接差异化
coding-TK 全托 缺陷
2025-01-22 上线计划
2026-01-29 上线计划
2026-01-28 上线计划
2026-02-03 上线计划
2026-02-10 上线计划
2026-03-02 上线计划
2026-03-04 上线计划
2026-03-11上线计划
2026-03-12上线计划
2026-03-16上线计划
2026-03-18上线计划
20260320上线计划
2026-03-23上线计划
2026-03-25上线计划
2026-04-01上线计划
2026-04-15上线计划
本文档使用 MrDoc 发布
-
+
首页
coupang 台湾本土与已对接差异化
## 文档地址 > 切换到繁体中文即为台湾版 - https://developers.coupangcorp.com/hc/zh-tw/articles/360033645114-%E6%89%B9%E6%AC%A1%E6%9F%A5%E8%A9%A2%E5%95%86%E5%93%81%E5%BA%AB%E5%AD%98%E8%B3%87%E8%A8%8A # 类目限制 > 台湾卖家 目前仅支持以下商品类别: 服饰、时尚配件、厨房/文具/办公用品/居家/运动、休闲用品/玩具、嗜好用品/汽车配件、家具/家饰、图书。 # 刊登 ## 接口差异 刊登接口路径无差异 - 台湾: https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products - 现有: https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products ## 请求参数差异 ### 字段取值差异化 ``` { "displayCategoryCode": 56137, "sellerProductName": "test_클렌징오일_관리용_상품명", "vendorId": "A00012345", "saleStartedAt": "2017-11-30T00:00:00", "saleEndedAt": "2099-01-01T23:59:59", "displayProductName": "해피바스 솝베리 클렌징 오일", "brand": "해피바스", "generalProductName": "솝베리 클렌징 오일", "productGroup": "클렌징 오일", "deliveryMethod": "SEQUENCIAL", # 配送方式: 非必填 台湾-仅可使用SEQUENCIAL(正常配送)作为配送方式 "deliveryCompanyCode": "KDEXP", "deliveryChargeType": "FREE", # 配送费用种类 - 如果 multiShippingInfos 列表中只有一组配送信息,请直接使用该组信息中的 deliveryChargeType 值 - 如果 multiShippingInfos 列表中有两组配送信息,请依照以下规则选取: - 若 deliveryChargeType 不同:请依照以下优先级选择其中一个:FREE > CONDITIONAL_FREE > NOT_FREE - 若相同:可任选一个值。 "deliveryCharge": 0, "freeShipOverAmount": 0, # 有条件免运金额: 非必填 只能输入 1 元新台币或更高金额,为免费配送,请输入 0 - 如果 multiShippingInfos 列表中只有一组配送信息,请直接使用该组信息中的 deliveryChargeType 值。 - 如果 multiShippingInfos 列表中有两组配送信息,请依照以下规则选择 - 若 deliveryChargeType 不同:请依照以下优先级选择 deliveryCharge:FREE> CONDITIONAL_FREE > NOT_FREE - 若 deliveryChargeType 相同:请选择列表中运费最低的 freeShipOverAmount 值 "deliveryChargeOnReturn": 2500, "remoteAreaDeliverable": "N", "unionDeliveryType": "UNION_DELIVERY", "returnCenterCode": "1000274592", # 返回位置中心代码: 台湾:当 pickUpBranchType 为 HOME 时,请使用 multiReturnInfos 中的 returnCenterCode 字段值。 "returnChargeName": "반품지_1", # 返回位置名称 :台湾:当 pickUpBranchType 为 HOME 时,请使用 multiReturnInfos 中的 returnChangeName 字段值。 "outboundShippingPlaceCode": 3001800430, # 出货地点地址代码: 非必填 台湾:在 multiShippingInfo 中,当 deliveryCompanyType 为 HOME_DELIVERY 时,取出 outboundShippingPlaceId 的值。 "companyContactNumber": "02-1234-678", # 退货地址联络电话: 台湾:当 pickUpBranchType 为 HOME 时,请使用 multiReturnInfos 中的 companyContactNumber 栏位值。 "returnZipCode": "135-090", # 退货地址邮递区号 台湾:当 pickUpBranchType 为 HOME 时,请使用 multiReturnInfos 中的 returnZipCode 栏位值。 "returnAddress": "서울특별시 강남구 삼성동", # 退货地址地址: 台湾:当 pickUpBranchType 为 HOME 时,请使用 multiReturnInfos 中的 returnAddress 栏位值。 "returnAddressDetail": "333", # 退货地址详细地址 台湾:当 pickUpBranchType 为 HOME 时,请使用 multiReturnInfos 中的 returnAddressDetail 栏位值。 "returnCharge": 2500, # 退货运费 台湾:当 pickUpBranchType 为 HOME 时,请使用 multiReturnInfos 中的 returnCharge 栏位值。 "outboundShippingPlaceCode": "74010", "vendorUserId": "wing_loginId_123", "requested": true, "items": [ { "itemName": "200ml_1개", "originalPrice": 13000, "salePrice": 10000, "maximumBuyCount": "100", "maximumBuyForPerson": "0", "outboundShippingTimeDay": "1", # 标准发货日(天) 台湾: 从multiShippingInfo列表中,选取 deliveryCompanyType 为 HOME_DELIVERY 的 outboudShippingPlaceId 值。并将配送前置时间的单位从小时转换为天(例如:24小时转换为1天),最大值为144小时。 "maximumBuyForPersonPeriod": "1", "unitCount": 1, "adultOnly": "EVERYONE", "taxType": "TAX", "parallelImported": "NOT_PARALLEL_IMPORTED", "overseasPurchased": "NOT_OVERSEAS_PURCHASED", "pccNeeded": "false", "externalVendorSku": "0001", "barcode": "", "emptyBarcode": true, "emptyBarcodeReason": "상품확인불가_바코드없음사유", "modelNo": "171717", "extraProperties": { "coupangSalePrice": 5000, "onlineSalePriceForBooks": 10000, "transactionType": "manufacturer", "businessType": "Beauty" }, "certifications": [ { "certificationType": "NOT_REQUIRED", "certificationCode": "" } ], "searchTags": [ "검색어1", "검색어2" ], "images": [ { "imageOrder": 0, "imageType": "REPRESENTATION", "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2018/06/25/3719529368/27a6b898-ff3b-4a27-b1e4-330a90c25e9c.jpg" } ], "notices": [ { "noticeCategoryName": "화장품", "noticeCategoryDetailName": "용량(중량)", "content": "상세페이지 참조" } ], "attributes": [ # 属性列表(属性) 台湾: 台湾地区Softline类别仅可注册在商品类别资料中定义的必填购买选项,查看必选(https://developers.coupangcorp.com/hc/article_attachments/50192804601113) { "attributeTypeName": "수량", "attributeValueName": "1개" }, { "attributeTypeName": "개당 용량", "attributeValueName": "200ml" } ], "contents": [ { "contentsType": "TEXT", "contentDetails": [ { "content": "<html><div></div><div><img src='http://image11.coupangcdn.com/image/product/content/vendorItem/2018/06/26/196713/738d905f-ed80-4fd8-ad21-ed87b195a19e.jpg' /><div></html>", "detailType": "TEXT" } ] } ], "offerCondition": "NEW", "offerDescription": "" }, { "itemName": "200ml_2개", "originalPrice": 26000, "salePrice": 20000, "maximumBuyCount": 100, "maximumBuyForPerson": 0, "outboundShippingTimeDay": 2, "maximumBuyForPersonPeriod": 1, "unitCount": 1, "adultOnly": "EVERYONE", "taxType": "TAX", "parallelImported": "NOT_PARALLEL_IMPORTED", "overseasPurchased": "NOT_OVERSEAS_PURCHASED", "pccNeeded": "false", "externalVendorSku": "0001", "barcode": "", "emptyBarcode": true, "emptyBarcodeReason": "상품확인불가_바코드없음사유", "modelNo": "171717", "extraProperties": { "coupangSalePrice": 5000, "onlineSalePriceForBooks": 10000, "transactionType": "manufacturer", "businessType": "Beauty" }, "certifications": [ { "certificationType": "NOT_REQUIRED", "certificationCode": "" } ], "searchTags": [ "검색어1", "검색어2" ], "images": [ { "imageOrder": 0, "imageType": "REPRESENTATION", "vendorPath": "http://image11.coupangcdn.com/image/product/image/vendoritem/2018/06/26/3001519145/74100e2a-d1ad-4b50-9c78-840c12a3e10d.jpg" } ], "notices": [ { "noticeCategoryName": "화장품", "noticeCategoryDetailName": "용량(중량)", "content": "상세페이지 참조" } ], "attributes": [ { "attributeTypeName": "수량", "attributeValueName": "2개" }, { "attributeTypeName": "개당 용량", "attributeValueName": "200ml" } ], "contents": [ { "contentsType": "TEXT", "contentDetails": [ { "content": "<html><div></div><div><img src='http://image11.coupangcdn.com/image/product/content/vendorItem/2018/06/26/196713/738d905f-ed80-4fd8-ad21-ed87b195a19e.jpg' /><div></html>", "detailType": "TEXT" } ] } ], "offerCondition": "NEW", "offerDescription": "" } ], "requiredDocuments": [ { "templateName": "기타인증서류", "vendorDocumentPath": "http://image11.coupangcdn.com/image/product/content/vendorItem/2018/07/02/41579010/eebc0c30-8f35-4a51-8ffd-808953414dc1.jpg" } ], "extraInfoMessage": "", "manufacture": "아모레퍼시픽", "bundleInfo": { "bundleType": "SINGLE" } } ``` ### 新增字段 ``` - multiShippingInfos(多种航运信息): 非必填 每个元素的 deliveryCompanyType 值都必须不同。最多只能列出两个值(HOME_DELIVERY, CVS。HOME_DELIVERY 为必填项目。) "multiShippingInfos": [ { "deliveryChargeType": "FREE", # 运费类型: 非必填 FREE(免运)、NOT_FREE(非免运)、CONDITIONAL_FREE(有条件免运,可以自由设定门槛金额。) - 免运:请设定「退货时的初始运费(单趟)[deliveryChargeOnReturn]」与「退货运费(单趟)[returnCharge]」 - 非免运:若为非免运,请设定标准运费 [deliveryCharge] 和单趟退货运费 - 有条件免运:请设定标准运费和单趟退货运费 - 货到付款:适用于货到付款的商品类别已定义于规范总,卖家可参考卖家支持中心<span style="color: red;">(待验证,官网说的类型只有前三种,解释却有此条)</span> "deliveryCompanyCode": "TWL_KERRY", # 快递公司编码: 非必填 deliveryCompanyCode可参考数值(TWL_KERRY,TWL_FM) "deliveryCharge": 65, # 标准运费: 非必填 针对付费配送和有条件免运,请输入单趟运费金额。 "freeShipOverAmount": 0, # 有条件免运金额: 非必填 只能输入 1 元新台币或更高金额。 若为免运,请输入 0。 "deliveryChargeOnReturn": 0, # 退货时的初始运费: 非必填 顾客退回免费配送商品时需支付的运费。 "deliveryMethod": "SEQUENCIAL", # 交货方式: 非必填 在台湾,配送方式仅接受 SEQUENCIAL(正常配送)。 "outboundShippingPlaceId": 21962637, # 配送地点地址代码: 非必填 选择合并配送(仅韩国支持合并配送)时为必填字段。 可使用配送地点查询API进行确认。 "deliveryCompanyType": "HOME_DELIVERY", # 请选择您想新增的配送方式 : 非必填 HOME_DELIVERY (宅配) 类型为必选,而 CVS (超商 为选填。 "outboundShippingTime": 48 # 预计出货天数/小时: 非必填 请输入从订单日期(D日)起算,商品预计多久后会出货。例如:若商品在隔天(D+1)出货,请输入「24」。 } ] - multiReturnInfos(多种退货类型): 非必填 可列出各种不同的 pickUpbranchType (取货分店类型) 。 列表中最多可包含 2 个元素。 "multiReturnInfos": [ { "pickUpBranchId": 19399, # 提货仓库: 非必填 如果 pickUpBranchType 为 CVS (超商),请将此字段设为超商的 ID。如果 pickUpBranchType 为 home (宅配),请将此字段留空。 "pickUpBranchGroupCode": "TWL_KERRY", # 提货仓库分组代码: 非必填 TWL_KERRY、TWL_FM "pickUpBranchType": "HOME", # 退货类型: 非必填 Home(宅配收件) 类型为必填,而 CVS(超商) 则为选填。 "sellerProductId": 1190, "returnCenterCode": "1002043483", # 退货地址中心代码: 非必填 建立退货地址后,请撷取并输入退货地址中心代码。退货地址可通过 WING 或「退货地址创建 API」建立。如果您无法建立退货地址,请输入 “NO_RETURN_CENTERCODE” 来手动新增退货地址信息。 "returnChargeName": "测试地址", # 返回位置名称: 非必填 在 Coupang Wing 上检查或通过退货地址查询 API 注册退货地址。查询返回地点并输入shippingPlaceName的显示值' 台湾 当 pickUpBranchType 为 HOME 时,请使用 multiReturnInfos 中的 returnChangeName 字段值。 "companyContactNumber": "0919754091", # 退货地址联络电话: 非必填 请通过Coupang WING查询或使用退货地址查询API注册退货地址。 "returnZipCode": "110", # 退货地址邮递区号: 非必填 请通过Coupang WING查询或使用退货地址查询API注册退货地址。 "returnAddress": "台北市 信義區", # 退货地址: 非必填 请通过Coupang WING查询或使用退货地址查询API注册退货地址。 "returnAddressDetail": "信義路五段7號台北101大楼13樓", # 退货详细地址: 请通过Coupang WING查询或使用退货地址查询API注册退货地址。 "returnCharge": 0 # 退货运费: 非必填 取回退货商品的单趟运费。仅能输入退货时的初始运费金额的100%至150%。请使用 multiReturnInfos 中 pickUpBranchType 为 HOME 的 returnCharge 值。 } ] ``` ## 响应参数差异 无差异 # 同步 > 台湾版API 没有同步商品相关API,但是可以复用现有的同步逻辑 现有的同步逻辑需要增加下面俩个字段对象(对象中具体字段参考新增字段)对应的处理逻辑 - multiShippingInfos(多种航运信息) - multiReturnInfos(多种退货类型)
xingzengbin
2026年1月7日 18:52
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
分享
链接
类型
密码
更新密码