Thực hành tốt nhất với SIP
SIP là gì?
SIP là viết tắt của Shopee International Platform (Nền tảng Quốc tế Shopee). Sau khi tham gia dự án SIP, Shopee sẽ giúp bạn vận hành shop, bao gồm thiết lập và gửi các hoạt động marketing theo đặc điểm của thị trường địa phương. Sau khi mở shop, bạn chỉ cần liên kết tài khoản nhận tiền trước, định kỳ kiểm tra tồn kho sản phẩm, tham gia các chương trình khuyến mãi để xác nhận giá và giao hàng đúng thời hạn!
Thuật ngữ:
P shop (shop chính): Trong mô hình vận hành SIP, shop do người bán tự vận hành độc lập, còn được gọi là shop chính;
A shop (shop liên kết): Shop do Shopee vận hành thay cho người bán, còn được gọi là shop liên kết;
CB SIP (SIP xuyên biên giới): Nếu người bán xuyên biên giới vận hành shop chính, chúng tôi gọi đó là chế độ CB SIP;
Local SIP (SIP nội địa): Nếu người bán nội địa vận hành shop chính, chúng tôi gọi đó là chế độ Local SIP;
SIP rate (Tỷ lệ SIP): Chỉ áp dụng cho CBSIP. Tỷ lệ điều chỉnh giá SIP là tỷ lệ chiết khấu mà người bán đặt cho shop liên kết dựa trên giá vốn của sản phẩm. Khi sản phẩm được bán trong shop liên kết, Shopee sẽ tự động tính giá thanh toán cuối cùng cho người bán dựa trên giá vốn và tỷ lệ điều chỉnh giá SIP.
SIP Item price (Giá mặt hàng SIP): Giá vốn của sản phẩm, dựa trên đó Shopee sẽ tính giá bán của sản phẩm ở A shop và giá thanh toán của sản phẩm.
Settlement price (Giá thanh toán): Giá thanh toán của sản phẩm, Shopee sẽ thanh toán cho người bán dựa trên giá này.
1. Ủy quyền SIP Shop
1.1 Người bán không phải CNSC
1.1.1 Quy trình ủy quyền
Vui lòng tham khảo bài viết Ủy quyền và Xác thực. Khi người bán đăng nhập vào tài khoản SIP P Shop, vào trang ủy quyền và nhấp xác nhận ủy quyền, SIP P Shop sẽ được ủy quyền cho APP này.
1.1.2 Lấy code
Sau khi ủy quyền thành công, bạn có thể lấy trực tiếp shop_id của P Shop và code khả dụng qua callback url.
1.1.3 Lấy token P shop
Bạn có thể gọi API v2.public.get_access_token và tải lên shop id và code của P shop sau khi ủy quyền thành công. API sẽ trả về access token và refresh token khả dụng cho P shop.
1.1.5 Làm mới Access token
Lúc này, access token và refresh token nhận được ở bước thứ ba có thể dùng cho P shop. Sau đó bạn có thể gọi API v2.public.refresh_access_token để làm mới access token và refresh token của P shop.
Lưu ý:
-
Sau khi access_token mới được tạo, access_token cũ vẫn còn hiệu lực trong 5 phút.
-
Ủy quyền lại sẽ kích hoạt làm mới refresh_token và access_token.
-
Gọi interface Refresh access token trong thời hạn hiệu lực của ủy quyền.
-
Nếu refresh_token và access_token mới được trả về bị mất, vui lòng xem FAQ
1.2 Người bán CNSC
1.2.1 Quy trình ủy quyền
Vui lòng tham khảo bài viết Ủy quyền và Xác thực. Khi người bán đăng nhập vào tài khoản chính và vào trang ủy quyền, danh sách shop thuộc mỗi merchant sẽ hiển thị nhãn "SIP" cho SIP P Shop. Bạn có thể nhấp "xem" để xem tất cả thông tin A Shop và trạng thái ủy quyền. Chọn SIP P Shop và nhấp "Xác nhận ủy quyền", khi đó tất cả SIP A Shop thuộc P shop đó sẽ được tự động ủy quyền cho APP này.
Lưu ý
Tất cả các shop chưa liên kết với merchant trong tài khoản chính sẽ được liệt kê trong danh sách "Unupgraded Shop Group". Nếu các shop trong danh sách Unupgraded Shop Group có logo SIP, điều đó cũng có nghĩa là chúng là SIP P Shop.
1.2.2 Lấy code
Sau khi ủy quyền thành công, bạn có thể lấy trực tiếp main_account_id và code khả dụng qua callback url.
1.2.3 Lấy token
Bạn có thể gọi API v2.public.get_access_token và tải lên main_account_id và code sau khi ủy quyền thành công. merchant_id_list sẽ trả về tất cả merchant hiện đang được ủy quyền, và shop_id_list sẽ trả về tất cả các shop hiện đang được ủy quyền, bao gồm SIP P shop, A shop và các ID shop không phải SIP. Access_token và Refresh_token có thể dùng chung cho tất cả merchant id và shop id tại thời điểm đó.
1.2.4 Lấy mối quan hệ shop
Sau đó bạn cần gọi API v2.merchant.get_shop_list_by_merchant để lấy danh sách các shop được ủy quyền liên kết với một merchant, và gọi API v2.shop.get_shop_info. Khi đó bạn sẽ lấy được thông tin như 1) Shop có thuộc SIP shop không. 2) Danh sách A shop thuộc một P shop.
- Nếu là shop thông thường, is_sip=false và trường sip_affi_shops sẽ không được trả về;
- Nếu là SIP P shop, is_sip=true, trường sip_affi_shops sẽ được trả về và là danh sách ID A shop;
- Nếu là SIP A shop, is_sip=true và trường sip_affi_shops sẽ không được trả về.
1.2.5 Làm mới Access Token
Lưu ý rằng access_token và refresh_token của mỗi shop id và mỗi merchant id cần được lưu riêng biệt. Khi gọi API v2.public.refresh_access_token, hãy làm mới access token và refresh token của từng shop id và từng merchant id riêng lẻ.
2. Quản lý sản phẩm
2.1 Logic thông tin sản phẩm
| Thông tin | Logic đồng bộ |
| Thông tin cơ bản sản phẩm (tên/mô tả, v.v.) | Tạo: Sau khi người bán tạo sản phẩm P shop, Shopee sẽ tự động dịch thông tin sản phẩm sang ngôn ngữ A shop địa phương và tạo sản phẩm A shop. Cập nhật: Nếu người bán chỉnh sửa sản phẩm P shop, Shopee sẽ tự động đồng bộ thông tin sản phẩm mới sang sản phẩm A shop. |
| Trạng thái sản phẩm | Nếu sản phẩm P shop bị ẩn hoặc xóa, sản phẩm A shop cũng sẽ bị ẩn hoặc xóa. Người bán không thể cập nhật trạng thái sản phẩm của A shop. |
| Tồn kho sản phẩm | Tồn kho sản phẩm P shop bằng với tồn kho sản phẩm A shop. Ví dụ, có 2 A shop thuộc P shop là A shop1 và A shop2, tồn kho P shop=10, thì tồn kho A shop1=A shop2=10. Khi A shop1 bán 1 sản phẩm, tồn kho P shop=A shop1=A shop2=9. |
| Giá sản phẩm | Khi người bán cập nhật giá sản phẩm trong P shop, Shopee sẽ đồng bộ sang giá sản phẩm trong A shop. |
2.2 Logic giá
SIP Item Price
Phản hồi của API v2.product.get_item_base_info và v2.product.get_model_list:
"price_info": [
\{
"currency": "MYR",
"original\_price": 179.58,
"current\_price": 179.58
"sip\_item\_price\_currency": "CNY",
"sip\_item\_price": 230.87,
"sip\_item\_price\_source": "auto"
\}
Lưu ý
- Nếu mặt hàng là sản phẩm P shop và không có biến thể, hãy gọi API v2.product.get_item_base_info để lấy sip_item_price/sip_item_price_source/sip_item_price_currency của mặt hàng.
- Nếu mặt hàng là sản phẩm P shop và có biến thể, hãy gọi API v2.product.get_model_list để lấy sip_item_price/sip_item_price_source/sip_item_price_currency của model.
- Nếu mặt hàng không phải SIP P shop, các trường sip_item_price/sip_item_price_source/sip_item_price_currency sẽ không được trả về bởi API v2.product.get_item_base_info và v2.product.get_model_list.
3. Quản lý đơn hàng
3.1 Logic đồng bộ đơn hàng
3.1.1 CB SIP
Vui lòng lấy riêng danh sách đơn hàng SIP P shop và danh sách đơn hàng SIP A shop để xử lý. Trong đó:
- Đơn hàng trong SIP A shop sẽ không hiển thị buyer_total_amount cho người bán P shop trong chi tiết đơn hàng.
- Đối với các đơn hàng trong SIP A shop, tiền tệ trong API get_order_detail sẽ là CNY hoặc USD.
3.1.2 Local SIP
Shopee tự động đồng bộ đơn hàng SIP A shop sang SIP P shop, vì vậy bạn chỉ cần lấy và xử lý danh sách đơn hàng SIP P shop. Những đơn hàng P shop được tạo bởi A shop, người nhận là kho trung chuyển Shopee tại địa phương — kho trung chuyển Shopee sẽ thực hiện giao hàng xuyên biên giới và gửi đến Người mua cuối cùng.
Lưu ý
Đối với cơ chế push đơn hàng, đơn hàng của P shop và A shop sẽ được push đồng thời. Đối với người bán CB SIP, cần chú ý đến push của cả P shop và A shop. Đối với người bán Local SIP, chỉ cần chú ý đến push của P shop.
Để biết thêm quy trình xử lý đơn hàng, vui lòng tham khảo: https://open.shopee.com/developer-guide/229
4. Thu nhập đơn hàng
- API v2.payment.get_escrow_detai sẽ trả về cả số tiền đơn hàng theo tiền tệ A shop và tiền tệ P shop tương ứng.
- Thu nhập đơn hàng trong Local SIP A shop cũng được chuyển đổi sang tiền tệ P theo mặc định, không khác gì đơn hàng P shop.
Vui lòng chú ý đến các tham số của API v2.payment.get_escrow_detail như bên dưới:
"✓" nghĩa là API sẽ trả về tham số này.
"×" nghĩa là API sẽ không trả về tham số này.
| Trường | Đơn hàng SIP P shop | Đơn hàng SIP A shop |
| escrow_amount | escrow_amount=buyer_total_amount+shopee_discount+voucher_from_shopee+coins+payment_promotion-buyer_transaction_fee-cross_border_tax-commission_fee-service_fee-seller_transaction_fee-seller_coin_cash_back-escrow_tax-final_product_vat_tax-final_shipping_vat_tax-drc_adjustable_refund-reverse_shipping_fee+rsf_seller_protection_fee_claim_amount-rsf_seller_protection_fee_premium_amount+final_shipping_fee(có thể dương/âm). | escrow_amount=tổng giá thanh toán của tất cả Asku - service_fee - commission_fee -seller_return_refund - drc_adjustable_refund. |
| buyer_total_amount | ✓ | × |
| actual_shipping_fee | ✓ | × |
| buyer_paid_shipping_fee | ✓ | × |
| buyer_transaction_fee | ✓ | × |
| estimated_shipping_fee | ✓ | × |
| campaign_fee | ✓ | × |
| coins | ✓ | × |
| cross_border_tax | ✓ | × |
| escrow_tax | ✓ | × |
| final_product_protection | ✓ | × |
| final_product_vat_tax | ✓ | × |
| final_shipping_fee | ✓ | × |
| final_shipping_vat_tax | ✓ | × |
| seller_transaction_fee | ✓ | × |
| order_chargeable_weight | ✓ | × |
| original_cost_of_goods_sold | ✓ | × |
| original_shopee_discount | ✓ | × |
| payment_promotion | ✓ | × |
| reverse_shipping_fee | ✓ | × |
| rsf_seller_protection_fee_claim_amount | ✓ | × |
| rsf_seller_protection_fee_premium_amount | ✓ | × |
| seller_coin_cash_back | ✓ | × |
| seller_discount | ✓ | × |
| seller_lost_compensation | ✓ | × |
| seller_shipping_discount | ✓ | × |
| seller_transaction_fee | ✓ | × |
| shipping_fee_discount_from_3pl | ✓ | × |
| shopee_discount | ✓ | × |
| shopee_shipping_rebate | ✓ | × |
| voucher_from_seller | ✓ | × |
| voucher_from_shopee | ✓ | × |
| aff_currency | × | ✓ |
| commission_fee_pri | × | ✓ |
| drc_adjustable_refund_pri | × | ✓ |
| escrow_amount_pri | × | ✓ |
| original_price_pri | × | ✓ |
| refund_amount_to_buyer_pri | × | ✓ |
| seller_return_refund_pri | × | ✓ |
| service_fee_pri | × | ✓ |
| sip_subsidy_pri | × | ✓ |
| pri_currency | × | ✓ |
| sip_subsidy | × | ✓ |
5. Quyền API
Hiện tại, SIP A shop chỉ có thể gọi một số API nhất định. Vui lòng xem danh sách chi tiết.