[중요] 3PF PFF Shop 모드 지원 및 3PF 상점 업그레이드에 대한 안내

*다음은 지난 11월 21일 발송된 “[Important] 3PF PFF Shop Mode Support & 3PF Shop Upgrade”와 동일한 내용의 한국어 안내입니다.

Shopee는 이전에 3PF Shop 모드를 출시했으며, 이 기간에는 판매자가 단일 샵에서 제품에 대한 현지 창고 재고 및 CB 창고 재고를 설정할 수 있는 3PF PFF Shop 모드를 추가로 지원할 예정입니다. 제품의 현지 창고 재고가 충분할 경우 현지 물류 채널을 먼저 사용하여 주문 처리하고, 제품의 현지 창고 재고가 소진되고 CB 창고 재고가 있는 경우 CB 물류 채널을 사용하여 주문 처리합니다. 풀필먼트 오더에 대한 API 호출 흐름은 변경되지 않았습니다.

구체적인 업데이트는 다음과 같습니다:

1. 새로운 필드 통합

1. v2.shop.get_shop_info에 shop_fulfillment_flag 필드를 추가하여 샵의 풀필먼트 유형을 반환하며, 현재 다음 유형을 포함합니다:

2. v2.logistics.get_channel_list에 support_cross_border 필드를 추가하여 물류 채널이 현지 물류 채널인지 CB 물류 채널인지 나타냅니다. support_cross_border가 false를 반환하면 물류 채널은 현지 물류 채널임을 의미하고, true를 반환하면 CB 물류 채널임을 의미합니다.

3. v2.merchant.get_merchant_warehouse_location_list에 warehouse_name 필드를 추가하여 판매자가 사용할 수 있는 창고의 창고 이름을 반환합니다.

KRSC 판매자인 경우 머천트 ID 1에는 다음 샵이 포함됩니다.

그러면 API 응답은 다음과 같습니다.

참고: 이 API는 머천트 아래의 모든 location_id와 warehouse_name 간의 대응을 반환합니다. 일반 CB Shop의 경우 재고를 업데이트 시 KR 판매자의 경우 KRZ location_id로 업데이트하고 CN 판매자의 경우 CNZ location_id로 업데이트하면 됩니다.

4. v2.product.get_item_base_info 및 v2.product.get_model_list에 현재 location_id의 재고가 판매 가능한지 여부를 나타내는 if_saleable 필드를 추가합니다. 로직은 다음과 같습니다:

우의 머천트 ID 1을 예로 들어, MTSKU 생성 시에 설정한 카테고리/속성/브랜드가 MY, ID, SG 및 PH 마켓에서 로컬 및 CB 제품으로 판매할 수 있다면, 재고가 다음과 같이 설정되어 있습니다:

KRZ: 500

MY001Z: 400

ID001Z: 300

MY002Z: 200

SG001Z: 100

위의 MTSKU를 MY Shop 1, ID Shop 2, SG Shop 4, PH Shop 5에 게시한 후 재고는 다음과 같습니다.

MTSKU의 재고 한도가 0-1000이고 SG Shop 4가 예약 재고를 200으로 설정했다고 가정하면 MTSKU 재고를 업데이트할 때:

- KRZ, MY001Z, ID001Z, SG001Z의 재고 합계는 1000 이하여야 합니다.

- KRZ, SG001Z의 재고 합계가 200보다 커야 합니다.

이후 판매자가 MTSKU 카테고리를 다음 조건을 충족하는 카테고리로 수정하는 경우:

- MY, SG, PH 지역에서는 로컬 제품이 아닌 CB 제품으로만 판매 가능합니다.

- ID 지역에서는 로컬 상품과 CB 상품으로 모두 판매가 가능합니다.

그러면 MY, SG 지역의 현지 창고 재고는 판매할 수 없게 되며 재고는 다음과 같습니다.

2. 새로운 API 통합

1. v2.merchant.get_merchant_warehouse_list

이 API는 판매자의 창고 목록과 창고 이름, 주소, location_id 등과 같은 세부 정보를 가져오는 데 사용됩니다. API 설계에 대한 자세한 내용은 이 문서를 참조하세요. (참고: 이 문서는 통합을 준비하기 위한 참조용으로만 제공되었으며 최종 버전에 대한 최종 공지 및 API reference를 참조하세요.)

참고: v2.merchant.get_merchant_warehouse_location_list는 나중에 오프라인 될 예정이므로, v2.merchant.get_merchant_warehouse_list API가 출시된 후 가능한 한 빨리 이 새로운 API로 전환하세요.

2. v2.merchant.get_warehouse_eligible_shop_list

이 API는 판매자 창고에 적합한 샵 목록을 가져오는 데 사용됩니다. API 설계는 이 문서를 참조하세요. (참고: 이 문서는 통합을 준비하기 위한 참조용으로만 제공되었으며 최종 버전에 대한 최종 공지 및 API reference를 참조하세요.)

3. 기존 필드 통합

3PF PFF Shop의 경우 v2.order.get_order_detail에서 반환된 product_location_id 필드를 사용하여 현지 판매자 창고 또는 CB 판매자 창고를 통해 주문을 처리해야 하는지 결정할 수 있습니다.

MY Shop3를 예시로 들어보겠습니다.

이 샵에서의 주문의 경우, 만약 product_location_id가 MY002Z를 반환하면 주문은 현지 판매자 창고에서 처리되어야 하고, product_location_id가 KRZ를 반환하면 주문은 CB 판매자 창고에서 처리되어야 합니다.

다음 타임라인을 참고하세요.

"v2.merchant.get_merchant_warehouse_location_list에 Warehouse_name 필드 추가"는 2023년 11월 2일에 출시되었으며 나머지 변경 사항은 2023년 12월 14일에 출시됩니다.

2023년 12월 14일 이후에는 동일한 지역에 여러 창고를 보유한 판매자의 경우 location_id 형식이 변경되며, 이는 {shop_region}+Z 형식이 아닙니다. 이는 판매자가 해당 location_id를 정확하게 식별하지 못하는 것을 방지하기 위함입니다. 창고로 인해 제품 재고 관리가 불가능할 수 있으니, v2.merchant.get_merchant_warehouse_location_list의 Warehouse_name 필드에 최대한 빨리 통합해 주시고, 2023년 12월 17일 이전에 통합이 완료될 수 있도록 해주시기 바랍니다. 많은 이해와 협조 부탁드립니다.

필드 및 API 통합 일정 목록:

통합 과정에서 문제가 발생할 경우 티켓 접수 시 제목에 [3PF Developer Integration Problems]를 기재해 주시면 전담팀에서 답변해 드립니다.