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(多种退货类型)