[Important] 3PF Seller CBSC Migration & Upgrade for Product and Stock Management

[Important] 3PF Seller CBSC Migration & Upgrade for Product and Stock Management

Dear Developer,

We are about to launch the CBSC x 3PF project, 3PF sellers need to switch from “use Local Seller Center to manage shop products” to “use CNSC to manage global products” (Refer to Creating global products, Publishing global products), and support setting stocks for different locations vis Open API, the API call flow for fulfillment orders has no change.

The specific updates are as follows:

1. New API integration

Get the list of warehouse location_id available to 3PF sellers: v2.merchant.get_merchant_warehouse_location_list.

• For Non-3PF and Multi-warehouse sellers, the API will not return the list of available warehouse location_id.

2. New field integration

The seller_stock field will support location_id to set stock, and the logic of stock allocation is as follows:

If a CNSC seller, merchant id 1 includes shop:

TW shop1 (Non-3PF)

MY shop2 (3PF)

SG shop3 (3PF)

Sellers set their stock as:

CNZ 100

MYZ 200

SGZ 300

So the stock will be:

Assuming that the limit of global product stock is 0-1000, and SG shop3 sets reserved stock=50, when updating the global product stock:

1. The sum stock of CNZ, SGZ, and MYZ needs to be less than or equal to 1000;

2. The stock of SGZ needs to be greater than or equal to 50.

Note:

1. The new field will apply to all CB sellers, not only 3PF sellers but also normal CBSC sellers, so you can serve all CB sellers at the same time after switching to the new field;

2. For 3PF sellers, must use the new field (seller_stock) to update stock, no transition period;

3. For normal CBSC sellers, there is a 3-month transition period, can use both the old field (normal_stocl) and the new field (seller_stock) to update stock during the transition period, but the old fields will be completely deprecated on August 10, please complete the switching of the new field (seller_stock) before then, and the transition plan is shown in the following table:

3. Update/Get data

4. Q&A

Q1: How to judge whether the shop is a 3PF shop？

A: Call the v2.shop.get_shop_info Open API, if is_3pf=true, the shop is a 3PF shop.

Q2: Is the authorization flow for 3PF sellers affected?

A: Yes, after the project is launched, 3PF sellers need to switch to using CBSC to manage products, so they can only use the Main account to authorize Shop and Merchant, refer to Authorization and Authentication.

Q3: Will the platform provide 3PF test account in Sandbox environment for testing?

A: Yes, refer to: 3PF Testing Account.

Effective Date on Live: Lived

尊敬的开发者，

您好，我们即将推出CBSC x 3PF项目，3PF卖家需要由“使用Local Seller Center管理店铺商品”切换为“使用CBSC管理全球商品” (参考：创建全球商品、发布全球商品)，并且支持分站点仓库设置库存，履约订单的API调用流程无变化。

具体更新如下：

1. 新接口对接

获取3PF卖家可用的仓库location_id列表：v2.merchant.get_merchant_warehouse_location_list。

• 非3PF卖家以及Multi-warehouse卖家，API将不返回可用的仓库location_id列表。

2. 新字段对接

seller_stock字段将支持分location_id设置库存，库存分配逻辑如下：

假如某CNSC卖家，merchant id 1包含以下店铺：

TW shop1 (Non-3PF)

MY shop2 (3PF)

SG shop3 (3PF）

卖家分别设置库存为：

CNZ 100

MYZ 200

SGZ 300

则库存情况如下：

假设全球商品的库存合法值为0-1000，SG shop 3设置了活动库存为50， 则更新全球商品库存时：

1）CNZ+SGZ+MYZ库存总和需小于等于1000；

2）SGZ库存需大于等于50。

注意：

1）新字段将适用于所有CB卖家，包括3PF卖家与普通跨境卖家，因此您切换新字段后可同时服务所有CB卖家；

2）针对3PF卖家，必须使用新字段 (seller_stock) 更新库存，不存在过渡期；

3）对于普通跨境卖家，存在3个月的过渡期，在此期间既可以使用旧字段 (normal_stock) 也可以使用新字段 (seller_stock) 更新库存，但是平台将于8月10日弃用旧字段 (normal_stock)，请在此之前完成新字段 (seller_stock) 的切换，过渡方案如下表所示：

3. 更新/获取数据

4. Q&A

Q1：如何判断Shop是否为3PF Shop？

A: 调用v2.shop.get_shop_info接口，若is_3pf=true，则该Shop为3PF Shop。

Q2: 3PF卖家的授权流程是否受到影响？

A：是的，该项目上线后，3PF卖家需要切换为使用CBSC管理商品，因此只能使用Main account授权Shop与Merchant，参考：授权与鉴权。

Q3: 平台是否提供沙箱环境的3PF测试账号用于测试？

A: 是的，参考：3PF测试账号。

上线时间：已上线

CBSC x 3PF 프로젝트가 곧 런칭될 예정입니다. 이에 따라, 3PF 판매자는 Global products 관리를 위해 CBSC를 사용해야 합니다(Creating global products, Publishing global products 참조). 또한 Open API를 통해 다양한 창고 위치에 대한 재고 설정을 지원합니다. 풀필먼트 오더에 대한 API 호출 흐름은 변경되지 않습니다.

구체적인 업데이트 내용은 다음과 같습니다:

1. 새로운 API 연동

3PF 판매자에게 제공되는 창고 위치(location_id) 목록 가져오기: v2.merchant.get_merchant_warehouse_location_list.

• 3PF가 아닌 샵은 API에서 사용 가능한 창고 위치(location_id) 목록을 반환하지 않습니다.

2. 새로운 필드 추가

seller_stock 필드는 재고 설정을 위해 location_id를 지원하며, 재고 할당 로직은 다음과 같습니다:

예시)

CBSC 셀러의 머천트 ID 1에 포함된 샵:

TW shop1 (Non-3PF)

MY shop2 (3PF)

SG shop3 (3PF)

판매자가 설정한 재고값:

CNZ 100

MYZ 200

SGZ 300

재고 정보:

Global product 재고의 한도가 0에서 1000이라고 가정하고 SG shop3의 reserved stock을 50으로 설정했을 때, Global product 재고를 업데이트할 때는 다음과 같은 조건이 필요합니다:

1. CNZ, SGZ, MYZ의 재고 합은 1000 이하이어야 합니다. (CNZ+SGZ+MYZ =< 1000)

2. SGZ의 재고는 50 이상이어야 합니다. (SGZ >= 50)

참고 사항:

1. 새로운 필드는 3PF 판매자뿐만 아니라 일반 CBSC 판매자를 포함한 모든 CB 판매자에 적용됩니다. 따라서 새로운 필드로 전환한 후에는 모든 CB 판매자를 동시에 지원할 수 있습니다;

2. 3PF 샵은 새로운 필드 (seller_stock)를 사용하여 재고를 업데이트해야 하며, 별도 전환 기간은 없습니다;

3. 일반 CBSC 판매자의 경우 3개월의 전환 기간이 있으며, 전환 기간 동안에는 기존 필드 (normal_stock)와 새로운 필드 (seller_stock)를 모두 사용하여 재고를 업데이트할 수 있습니다. 하지만 기존 필드(normal_stock)는 8월 10일까지만 지원하며 이후에는 종료되어 사용이 불가하오니 반드시 기한 내 새로운 필드 (seller_stock)로의 전환을 완료해주시기 바랍니다.

세부 전환 계획은 아래와 같습니다:

3. 데이터 업데이트/조회 API

4. Q&A

Q1: 샵이 3PF 샵인지 어떻게 판단할까요?

A: v2.shop.get_shop_info Open API를 호출하고, is_3pf=true라면 해당 샵은 3PF 샵입니다.

Q2: 3PF 판매자의 인증 과정에 영향이 있나요?

A: 네. 3PF 판매자가 기존 마켓별 셀러센터 (local SC) 에서 CBSC로 전환이 되었다면, 메인 계정을 사용하여 샵과 머천트를 인증해야 합니다. CBSC 전환 후 메인 계정을 통한 인증이 이뤄지지 않으면 샵에 대한 접근이 불가하여 API 업데이트가 불가합니다. 인증 관련해서는 해당 문서(Authorization and Authentication)를 참고해 주시기 바랍니다.

Q3: 테스트를 위한 샌드박스 환경의 3PF 테스트 계정을 제공하나요?

A: 네. 다음 문서를 참조하세요: 3PF Testing Account.

온라인 시간: 온라인.