Chuyển tới nội dung chính

v2.payment.get_escrow_detail_batch

POST /api/v2/payment/get_escrow_detail_batch

Sử dụng API này để lấy chi tiết thu nhập đơn hàng theo lô.

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/payment/get_escrow_detail_batch

Tham số chung

NameTypeSampleDescription
partner_idint1Partner ID được gán khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu.
timestamptimestamp1610000000Dùng để chỉ định thời điểm gửi yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1Token dùng để truy cập API, xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ.
shop_idint600000Mã định danh duy nhất của Shopee cho một cửa hàng. Tham số bắt buộc cho hầu hết các API.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Chữ ký được tạo từ partner_id, đường dẫn api, timestamp, access_token, shop_id và partner_key qua thuật toán HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tham số Request

NameTypeRequiredSampleDescription
order_sn_liststring[]TrueMã định danh duy nhất của Shopee cho một đơn hàng. Giới hạn [1,50]. Số lượng yêu cầu khuyến nghị từ 1 đến 20 đơn hàng.

Tham số Response

NameTypeSampleDescription
responseobject[]
escrow_detailobjectChi tiết escrow cho một đơn hàng.
order_snstringMã định danh duy nhất của Shopee cho một đơn hàng.
buyer_user_namestringTên đăng nhập của người mua.
return_order_sn_liststring[]Danh sách số serial của đơn hoàn trả.
order_incomeobject
escrow_amountfloatTổng số tiền người bán dự kiến nhận cho đơn hàng, sẽ thay đổi trước khi hoàn tất đơn hàng. Đối với cửa hàng không phải cb sip affiliate (công thức mới): escrow_amount= original_cost_of_goods_sold-original_shopee_discount+seller_return_refund+ shopee_discounts- voucher_from_seller- seller_coin_cash_back+ buyer_paid_shipping_fee- actual_shipping_fee+ shopee_shipping_rebate+ shipping_fee_discount_from_3pl- reverse_shipping_fee+ rsf_seller_protection_fee_claim_amount+ fsf_seller_protection_fee_claim_amount- final_return_to_seller_shipping_fee- seller_transaction_fee- service_fee- commission_fee- campaign_fee- shipping_seller_protection_fee_premium_amount- delivery_seller_protection_fee_premium_amount-final_escrow_product_gst- order_ams_commission fee- escrow_tax-sales_tax_on_lvg-reverse_shipping_fee_sst-shipping_fee_sst-withholding_tax-overseas_return_service_fee-vat_on_imported_goods - withholding_vat_tax - withholding_pit_tax - seller_order_processing_fee + buyer_paid_packaging_fee - trade_in_bonus_seller - fbs_fee - ads_escrow_top_up_fee_or_technical_support_fee - th_import_duty Đối với cửa hàng cb sip affiliate: escrow_amount=escrow_amount_pri * exchange_rate Lưu ý: Số tiền hoàn trả = nếu RR có thể điều chỉnh, sẽ bằng drc_adjustable_refund
order_original_pricefloatGiá gốc của sản phẩm trước bất kỳ khuyến mãi/chiết khấu nào theo đơn vị tiền tệ niêm yết. Trả về tổng phụ nếu số lượng > 1.
original_pricefloatGiá gốc của sản phẩm trước bất kỳ khuyến mãi/chiết khấu nào theo đơn vị tiền tệ niêm yết. Trả về tổng phụ của sản phẩm đó nếu số lượng > 1.
order_selling_pricefloatGiá trị trường này = tổng đơn giá sản phẩm. Với trường hợp không phải bundle deal, giá trị bằng order_original_price; với bundle deal, đây là tổng giá sản phẩm trước bundle deal nhưng sau khuyến mãi sản phẩm. Trả về tổng phụ nếu số lượng > 1. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
bcrs_depositfloat0.10Phí đặt cọc $0.10 mỗi chai do người mua trả trong khuôn khổ Chương trình hoàn trả bình đựng đồ uống SG của NEA. Giá trị này có thể được cập nhật sau RR/hủy đơn.
order_seller_discountfloatTổng chiết khấu người bán cung cấp cho đơn hàng này. Trả về tổng phụ nếu số lượng > 1. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
seller_discountfloatTổng cuối cùng của chiết khấu người bán cho mỗi sản phẩm trong đơn hàng. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
order_discounted_pricefloatTổng giá chiết khấu cho đơn hàng này. Trả về tổng phụ nếu số lượng > 1. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
shopee_discountfloatTổng cuối cùng của chiết khấu Shopee cho mỗi sản phẩm trong đơn hàng. Số tiền này trả về giá trị hoàn trả còn lại (tức là Hoàn trả sản phẩm Shopee còn lại + Hoàn trả PIX Shopee còn lại) cho người bán. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
voucher_from_sellerfloatGiá trị cuối cùng của voucher do Người bán cung cấp cho đơn hàng. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
voucher_from_shopeefloatGiá trị cuối cùng của voucher do Shopee cung cấp cho đơn hàng. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
coinsfloatGiá trị này cho biết tổng số tiền khấu trừ khi người mua dùng Shopee Coins khi thanh toán. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
cross_border_taxfloatSố tiền người mua phát sinh khi mua sản phẩm ngoài quốc gia/khu vực của họ. Có thể thay đổi sau hoàn trả. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
payment_promotionfloatSố tiền được khấu trừ qua khuyến mãi thanh toán. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
commission_feefloatPhí hoa hồng do nền tảng Shopee tính nếu có. Đối với cửa hàng CB SIP affiliate: commission_fee=commission_fee_pri * exchange_rate
service_feefloatSố tiền Shopee tính cho người bán cho các dịch vụ bổ sung. Đối với cửa hàng CB SIP affiliate: service_fee=service_fee_pri * exchange_rate
seller_transaction_feefloatPhí giao dịch do người bán trả cho đơn hàng. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
seller_lost_compensationfloatBồi thường cho người bán trong trường hợp mất kiện hàng. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
seller_coin_cash_backfloatGiá trị coin do Người bán cung cấp cho khách hàng mua tại cửa hàng. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
escrow_taxfloatThuế xuyên biên giới do chính phủ Indonesia áp đặt lên người bán. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
final_shipping_feefloatSố tiền điều chỉnh cuối cùng mà người bán phải chịu trong escrow. Có thể âm hoặc dương. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
actual_shipping_feefloatChi phí vận chuyển thực tế cuối cùng của đơn hàng và là số dương. Với kênh logistics không tích hợp là 0. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
shopee_shipping_rebatefloatKhoản trợ cấp phí vận chuyển của nền tảng cho người bán. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
shipping_fee_sstfloatThuế Dịch vụ tính trên Phí Vận chuyển do Người bán Trả cho vận chuyển xuôi, theo quy định SST Malaysia về phí vận chuyển cho tất cả đơn hàng. Phí Vận chuyển do Người bán Trả được định nghĩa là Phí Vận chuyển Thực tế trừ đi tổng Phí Vận chuyển do Người mua Trả và Hoàn trả Phí Vận chuyển từ Shopee. (Chỉ áp dụng cho cửa hàng không phải cb sip affiliate)
shipping_fee_discount_from_plfloatChiết khấu phí vận chuyển từ 3PL. Hiện chỉ áp dụng cho ID. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
seller_shipping_discountfloatChiết khấu phí vận chuyển do người bán xác định. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
estimated_shipping_feefloatPhí vận chuyển ước tính được Shopee tính dựa trên tiêu chuẩn của đơn vị vận chuyển. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
seller_voucher_codefloatDanh sách mã voucher do người bán cung cấp. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
drc_adjustable_refundfloatSố tiền hoàn trả có thể điều chỉnh từ Trung tâm giải quyết tranh chấp Shopee.
refund_amount_to_buyerfloatSố tiền trả lại cho Người bán trong trường hợp trả hàng một phần.
cost_of_goods_soldfloatSố tiền cuối cùng người mua thanh toán cho sản phẩm trong đơn hàng. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
original_cost_of_goods_soldfloatSố tiền người mua thanh toán cho sản phẩm trong đơn hàng. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
original_shopee_discountfloatTổng chiết khấu Shopee cho mỗi sản phẩm trong đơn hàng. Số tiền này trả về giá trị hoàn trả ban đầu (tức là Hoàn trả sản phẩm Shopee ban đầu + Hoàn trả PIX Shopee ban đầu) cho người bán. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
itemsobject[]Đối tượng này chứa thông tin chi tiết cho tất cả sản phẩm trong đơn hàng, bao gồm sản phẩm thông thường và sản phẩm hoạt động khuyến mãi.
item_idint64ID của sản phẩm.
item_namestringTên sản phẩm.
item_skustringSKU sản phẩm là mã định danh do người bán xác định, đôi khi gọi là SKU cha. SKU sản phẩm có thể được gán cho một sản phẩm trong danh sách Shopee.
model_idint64ID của biến thể thuộc cùng một sản phẩm.
model_namestringTên biến thể thuộc cùng một sản phẩm. Người bán có thể cung cấp nhiều biến thể. Mỗi kết hợp màu sắc và kích thước là một biến thể riêng biệt.
model_skustringSKU biến thể là mã định danh do người bán xác định, chỉ dành cho mục đích nội bộ. Nhiều người bán gán SKU theo loại, kích thước và màu sắc.
original_pricefloatGiá gốc của sản phẩm trước bất kỳ khuyến mãi/chiết khấu nào theo đơn vị tiền tệ niêm yết. Trả về tổng phụ của sản phẩm đó nếu số lượng > 1.
original_price_prifloatGiá thanh toán đã thỏa thuận theo đơn vị tiền tệ chính. (Chỉ hiển thị cho cửa hàng CB SIP affiliate)
selling_pricefloatVới trường hợp không phải bundle deal, giá trị bằng original_price; với bundle deal, đây là tổng giá trước bundle deal nhưng sau khuyến mãi sản phẩm. Trả về tổng phụ nếu số lượng > 1. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
discounted_pricefloatGiá sau chiết khấu theo đơn vị tiền tệ niêm yết. Trả về tổng phụ nếu số lượng > 1. Nếu không có chiết khấu, giá trị bằng original_price.
bcrs_depositfloat0.10Phí đặt cọc $0.10 mỗi chai do người mua trả trong khuôn khổ Chương trình hoàn trả bình đựng đồ uống SG của NEA. Đây là giá trị ban đầu và không được cập nhật sau RR/hủy đơn.
seller_discountfloatChiết khấu do người bán cung cấp cho sản phẩm này.
shopee_discountfloatChiết khấu do Shopee cung cấp cho sản phẩm này.
discount_from_coinfloatGiá trị bù trừ của sản phẩm này khi người mua sử dụng Shopee Coins khi thanh toán. Với sản phẩm bundle deal, giá trị này trả về 0. Do giới hạn kỹ thuật, trường này sẽ trả về giá trị không chính xác với trường hợp bundle deal nếu không được cấu hình thành 0.
discount_from_voucher_shopeefloatSố tiền khấu trừ khi người mua dùng voucher Shopee.
discount_from_voucher_sellerfloatSố tiền khấu trừ khi người mua dùng voucher của người bán.
activity_typestringLoại sản phẩm, mặc định là "". bundle deal: "bundle_deal", add on deal: "add_on_deal"
activity_idint64Nếu bundle_deal thì đây là ID của bundle deal, nếu add_on_deal thì đây là ID của add on deal.
is_main_itembooleanCho biết đây là sản phẩm chính hay phụ trong add_on_deal.
quantity_purchasedint32Số lượng sản phẩm giống nhau được mua cùng lúc bởi cùng một người mua.
is_b2c_shop_itembooleanCho biết đây có phải là sản phẩm thuộc sở hữu B2C hay không.
ams_commission_feefloatSố tiền phí hoa hồng affiliate. Áp dụng cho sản phẩm bán qua Chương trình Affiliate.
is_kitbooleanCho biết sản phẩm này có phải là kit hay không. (Chỉ dành cho người bán nội địa BR)
kit_itemsobjectChỉ áp dụng cho người bán nội địa BR.
mt_item_idfloatMã định danh sản phẩm của nhà bán trong bộ kit. (Chỉ dành cho người bán nội địa BR)
mt_model_idfloatMô hình sản phẩm của nhà bán trong bộ kit. (Chỉ dành cho người bán nội địa BR)
total_qtyfloatSố lượng của thành phần cụ thể này trong bộ kit. (Chỉ dành cho người bán nội địa BR)
parent_item_pricefloatGiá của sản phẩm khi được niêm yết riêng lẻ.
item_price_proratedfloatGiá của sản phẩm khi được niêm yết trong bộ kit (tức là phân bổ theo tỷ lệ). (Chỉ dành cho người bán nội địa BR)
promotion_listobject[]
promotion_typestringseller_discountCho biết loại khuyến mãi ở cấp sản phẩm hoặc cấp gói áp dụng cho sản phẩm. Mỗi sản phẩm có thể liên kết với tối đa một khuyến mãi sản phẩm và một khuyến mãi gói cùng lúc. Khuyến mãi sản phẩm: low_price_promotion deep_discount platform_sale seller_discount flash_sale wholesale welcome_package_free_gift brand_flash_sale in_shop_flash_sale synced_promo platform_streaming_price seller_streaming_price exclusive_streamer_price price_bidding_with_rebate price_bidding_without_rebate seller_advisor_price selling_price settlement_price campaign_settlement_price local_sip_settlement_price platform_exclusive_price seller_exclusive_price seller_member_exclusive_sku item_price order_sync_price Khuyến mãi gói: bundle_deal add_on_deal_main add_on_deal_sub
promotion_idint64871828283Mã định danh duy nhất của một khuyến mãi cụ thể được áp dụng cho một sản phẩm. Mỗi promotion_id tương ứng với một quy tắc hoặc chiến dịch khuyến mãi riêng biệt, được xác định theo một promotion_type cụ thể. Giá trị được biểu thị ở định dạng chuỗi số.
escrow_amount_prifloatTổng số tiền theo đơn vị tiền tệ chính người bán dự kiến nhận. (Chỉ hiển thị cho đơn hàng cb sip affiliate)
buyer_total_amount_prifloatTổng số tiền người mua đã thanh toán theo đơn vị tiền tệ chính. (Chỉ hiển thị cho đơn hàng cb sip affiliate)
original_price_prifloatGiá gốc của sản phẩm trước bất kỳ khuyến mãi/chiết khấu nào theo đơn vị tiền tệ chính. Trả về tổng phụ nếu số lượng > 1. (Chỉ hiển thị cho đơn hàng cb sip affiliate)
seller_return_refund_prifloatSố tiền trả lại cho Người bán trong trường hợp trả hàng một phần theo đơn vị tiền tệ chính. (Chỉ hiển thị cho cửa hàng cb sip affiliate)
commission_fee_prifloatPhí hoa hồng do Shopee tính theo đơn vị tiền tệ chính. (Chỉ hiển thị cho cửa hàng cb sip affiliate)
service_fee_prifloatSố tiền Shopee tính cho người bán theo đơn vị tiền tệ chính. (Chỉ hiển thị cho cửa hàng cb sip affiliate)
drc_adjustable_refund_prifloatSố tiền hoàn trả có thể điều chỉnh từ Trung tâm giải quyết tranh chấp Shopee theo đơn vị tiền tệ chính sau khi phân bổ. (Chỉ áp dụng cho cửa hàng cb sip affiliate)
pri_currencystringĐơn vị tiền tệ của quốc gia/khu vực nơi người bán thực sự hoạt động. (Chỉ hiển thị cho cửa hàng cb sip affiliate)
aff_currencystringĐơn vị tiền tệ của quốc gia/khu vực nơi cửa hàng được mở. (Chỉ hiển thị cho cửa hàng cb sip affiliate)
exchange_ratefloatTỷ giá từ đơn vị tiền tệ cửa hàng chính sang đơn vị tiền tệ cửa hàng affiliate.
reverse_shipping_feefloatShopee tính phí vận chuyển ngược cho đơn hàng bị trả lại. Giá trị của trường này sẽ không âm.
reverse_shipping_fee_sstfloatThuế Dịch vụ tính trên Phí Vận chuyển Ngược cho vận chuyển ngược, theo quy định SST Malaysia về phí vận chuyển cho tất cả đơn hàng. (Chỉ áp dụng cho cửa hàng không phải cb sip affiliate)
final_product_protectionfloatTổng số tiền bảo vệ sản phẩm được mua khi đặt hàng.
credit_card_promotionfloatGiá trị này cho biết số tiền được khấu trừ qua khuyến mãi thẻ tín dụng.
credit_card_transaction_feefloatGiá trị này cho biết tổng phí giao dịch. credit_card_transaction_fee=buyer_transaction_fee+seller_transaction_fee
final_product_vat_taxfloatThuế giá trị gia tăng theo quy định VAT của EU. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
final_shipping_vat_taxfloatThuế giá trị gia tăng cho giá sản phẩm theo quy định VAT của EU. (Chỉ áp dụng cho cửa hàng không phải cb sip affiliate)
campaign_feefloatPhí chiến dịch do nền tảng Shopee tính. Chỉ áp dụng cho một số cửa hàng nội địa Indonesia.
sip_subsidyfloatSố tiền trợ cấp SIP là chênh lệch giữa giá thanh toán và giá người mua thực trả. (Chỉ khả dụng cho Cửa hàng CB SIP A)
sip_subsidy_prifloatSố tiền trợ cấp SIP theo đơn vị tiền tệ chính. (Chỉ khả dụng cho Cửa hàng CB SIP A)
rsf_seller_protection_fee_claim_amountfloatSố tiền bồi thường bảo hiểm nếu người bán tham gia chương trình bảo hiểm. Bao gồm phí vận chuyển ngược trong trường hợp RR.
rsf_seller_protection_fee_premium_amountfloatSố tiền Shopee tính cho người bán cho dịch vụ bổ sung. Chỉ áp dụng cho đơn hàng PH nội địa.
final_escrow_product_gstfloatThuế hàng hóa và dịch vụ cho giá sản phẩm bắt buộc với hàng nhập khẩu theo quy định GST Singapore. (Chỉ áp dụng cho cửa hàng không phải cb sip affiliate bán tại Singapore)
final_escrow_shipping_gstfloatThuế hàng hóa và dịch vụ cho phí vận chuyển bắt buộc với hàng nhập khẩu theo quy định GST Singapore. (Chỉ áp dụng cho cửa hàng không phải cb sip affiliate bán tại Singapore)
delivery_seller_protection_fee_premium_amountfloat[Hiện chỉ áp dụng cho đơn hàng ID nội địa] Phí bảo hiểm tính cho người bán khi kiện hàng được 3PL lấy.
order_ams_commission_feefloatSố tiền phí hoa hồng affiliate cho đơn hàng này. Áp dụng cho đơn hàng bán qua Chương trình Affiliate.
buyer_payment_methodfloatPhương thức thanh toán người mua sử dụng khi thanh toán đơn hàng.
instalment_planfloatGói trả góp người mua chọn khi thanh toán. Chỉ áp dụng khi phương thức thanh toán hỗ trợ trả góp.
sales_tax_on_lvgfloatThuế Bán hàng trên Hàng hóa Giá trị Thấp (LVG) bắt buộc cho hàng nhập khẩu (đơn hàng nước ngoài) theo quy định SST Malaysia cho các đơn hàng chọn lọc (ví dụ: đơn hàng CB LVG tại MY)
withholding_taxfloatChỉ dành cho cửa hàng nội địa PH và ID. PH: Theo quy định của Cục Thuế nội địa PH, Thuế khấu trừ áp dụng cho các khoản tiền gửi của Shopee đến nhà cung cấp trực tuyến. ID: Theo quy định của Tổng cục Thuế ID, Thuế khấu trừ áp dụng cho thu nhập trong hóa đơn qua Shopee liên quan đến doanh thu của Người bán.
overseas_return_service_feefloatPhí dịch vụ hoàn trả hải ngoại tính cho người bán đăng ký chương trình ORS. (Chỉ áp dụng cho cửa hàng không phải cb sip affiliate)
prorated_coins_value_offset_return_itemsfloatGiá trị phân bổ từ giá trị tiền mặt tương đương của coin bù trừ do RR có thể điều chỉnh. Trả về 0 cho RR đầy đủ hoặc đơn hàng thông thường.
prorated_shopee_voucher_offset_return_itemsfloatĐây là giá trị hoàn trả phân bổ từ chiết khấu voucher Shopee do RR có thể điều chỉnh. Trường này chỉ được cập nhật khi có RR có thể điều chỉnh. Nếu là RR đầy đủ hoặc đơn hàng thông thường sẽ trả về 0.
prorated_seller_voucher_offset_return_itemsfloatĐây là giá trị hoàn trả phân bổ từ chiết khấu voucher người bán do RR có thể điều chỉnh. Trường này chỉ được cập nhật khi có RR có thể điều chỉnh. Nếu là RR đầy đủ hoặc đơn hàng thông thường sẽ trả về 0.
prorated_payment_channel_promo_bank_offset_return_itemsfloatGiá trị phân bổ từ khuyến mãi kênh thanh toán ngân hàng do RR có thể điều chỉnh. Trả về 0 cho RR đầy đủ hoặc đơn hàng thông thường.
prorated_payment_channel_promo_shopee_offset_return_itemsfloatGiá trị phân bổ từ khuyến mãi kênh thanh toán Shopee do RR có thể điều chỉnh. Trả về 0 cho RR đầy đủ hoặc đơn hàng thông thường.
fsf_seller_protection_fee_claim_amountfloatSố tiền bồi thường cho người bán nếu tham gia chương trình dịch vụ phí vận chuyển. Bao gồm phí vận chuyển xuôi trong trường hợp hủy do giao hàng thất bại. Chỉ áp dụng cho PH nội địa từ tháng 6/2024.
shipping_seller_protection_fee_amountfloatPhí dịch vụ tính cho người bán tại MY, ID, PH nội địa (từ tháng 6/2024) do đăng ký chương trình bổ sung.
final_return_to_seller_shipping_feefloatSố tiền phí tính cho người bán (nếu có) đối với đơn hàng giao hàng thất bại.
vat_on_imported_goodsfloat7% VAT được tính cho hàng nhập khẩu vào Thái Lan.
withholding_vat_taxfloat1.0Theo quy định pháp luật Việt Nam, các nền tảng thương mại điện tử cần khấu trừ thuế VAT áp dụng cho tất cả hộ kinh doanh VN và người bán cá nhân VN.
withholding_pit_taxfloat2.0Theo quy định pháp luật Việt Nam, các nền tảng thương mại điện tử cần khấu trừ Thuế Thu nhập Cá nhân áp dụng cho tất cả hộ kinh doanh VN và người bán cá nhân VN.
tax_registration_codestring8881234567-888Dành cho thuế khấu trừ VN. Đây là Mã số thuế (TRN) từ thông tin người bán tại thời điểm tạo đơn hàng.
seller_order_processing_feefloat3.0Phí xử lý đơn hàng là số tiền tính cho người bán với mỗi đơn hàng được tạo.
buyer_paid_packaging_feefloatPhí tính cho người mua về vật liệu đóng gói.
trade_in_bonus_sellerfloatChiết khấu do Người bán/Nhà bán lẻ cung cấp cho người mua chọn đổi sản phẩm cũ.
fbs_feefloatPhí Shopee thực hiện (FBS) áp dụng cho đơn hàng này. Chỉ dành cho đơn hàng PH nội địa.
net_commission_feefloatSố tiền phí sau khi trừ hoàn trả theo tỷ lệ. Tổng phí hoa hồng ròng áp dụng cho đơn hàng. -chỉ dành cho người bán nội địa BR.
net_service_feefloatSố tiền phí sau khi trừ hoàn trả theo tỷ lệ. Tổng phí dịch vụ ròng áp dụng cho đơn hàng. -chỉ dành cho người bán nội địa BR.
net_commission_fee_info_listobjectTrả về phân tích chi tiết các phí hoa hồng ròng. -chỉ dành cho người bán nội địa BR.
rule_idfloatMã định danh duy nhất của quy tắc hoa hồng để tính phí hoa hồng ròng.
fee_amountfloatSố tiền phí hoa hồng ròng được tính dựa trên quy tắc hoa hồng tương ứng.
rule_display_namestringTên hiển thị của quy tắc hoa hồng để tham khảo và dễ đọc.
net_service_fee_info_listobjectTrả về phân tích chi tiết các phí dịch vụ ròng. -chỉ dành cho người bán nội địa BR.
rule_idfloatMã định danh duy nhất của quy tắc phí dịch vụ để tính phí dịch vụ ròng.
fee_amountfloatSố tiền phí dịch vụ ròng được tính dựa trên quy tắc phí dịch vụ tương ứng.
rule_display_namestringTên hiển thị của quy tắc phí dịch vụ để tham khảo và dễ đọc.
categorystringDanh mục phí dịch vụ, cho biết loại dịch vụ được tính phí.
seller_product_rebateobjectKhoản hoàn trả Shopee do người bán chịu. -chỉ dành cho người bán nội địa BR.
amountfloatĐây là phần hoàn trả Shopee do người bán chịu.
commission_fee_offsetfloatĐây là khoản bù trừ cho phí hoa hồng gộp, giảm xuống thành giá trị ròng.
service_fee_offsetfloatĐây là khoản bù trừ cho phí dịch vụ gộp, giảm xuống thành giá trị ròng.
pix_discountfloat[Chỉ dành cho BR] Tổng cuối cùng của chiết khấu pix cho đơn hàng. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate)
prorated_pix_discount_offset_return_itemsfloat[Chỉ dành cho BR] Giá trị phân bổ từ chiết khấu pix do RR có thể điều chỉnh. Trả về 0 cho RR đầy đủ hoặc đơn hàng thông thường.
ads_escrow_top_up_fee_or_technical_support_feefloatBao gồm cả phí nạp tiền quảng cáo escrow (tự động nạp vào số dư quảng cáo) và phí hỗ trợ kỹ thuật (do Shopee tính). Loại phí thực tế trong trường này thay đổi tùy theo loại người bán và khu vực bán hàng, có thể là một trong các loại sau trên Shopee Seller Center: Phí Nạp Escrow Quảng cáo: Dành cho người bán nội địa MY TH SG VN PH ID và người bán CNCB/JPCB/KRCB bán tại PH và ID; Dành cho người bán JPCB bán tại SG, MY, TH và VN. Phí Hỗ trợ Kỹ thuật: Dành cho người bán CNCB bán tại SG, MY, TH và VN. Phí Tăng trưởng Lưu lượng: Dành cho người bán KRCB bán tại SG, MY, TH và VN.
th_import_dutyfloat[TH only] Import Duty collected for imported goods entering Thailand
buyer_payment_infoobjectThông tin thanh toán của người mua tại thời điểm thanh toán đơn hàng (giá trị snapshot).
buyer_payment_methodstringPhương thức thanh toán người mua sử dụng.
buyer_service_feestringPhí dịch vụ bổ sung Shopee tính cho Người mua khi thanh toán. Hiện chỉ áp dụng cho ID. Đây là giá trị ban đầu.
buyer_tax_amountfloatSố tiền thuế do người mua trả. Hiện tại là thuế tùy chỉnh cho đơn hàng CB tại TW, CL, MX.
buyer_total_amountfloatTổng số tiền người mua đã thanh toán tại thời điểm thanh toán.
bcrs_discountfloat0.10Phí đặt cọc $0.10 mỗi chai do người mua trả trong khuôn khổ Chương trình hoàn trả bình đựng đồ uống SG của NEA. Đây là giá trị ban đầu và không được cập nhật sau RR/hủy đơn.
credit_card_promotionfloatKhuyến mãi do thẻ tín dụng cung cấp. Đây là giá trị ban đầu.
icms_tax_amountfloatThuế icms do người mua trả. Chỉ áp dụng cho khu vực BR. Đây là giá trị ban đầu.
import_tax_amountfloatThuế nhập khẩu do người mua trả. Đây là giá trị ban đầu (không được cập nhật sau RR/hủy đơn).
initial_buyer_txn_feefloatPhí giao dịch do người mua trả cho đơn hàng. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate). Hầu hết các khu vực đều có phí này tính cho người mua khi thanh toán tùy theo quy tắc phí áp dụng tại mỗi khu vực. Đây là giá trị ban đầu (không được cập nhật sau RR/hủy đơn).
insurance_premiumfloatPhí bảo hiểm do người mua trả. Hiện chỉ áp dụng cho một số khu vực như ID & BR. Đây là giá trị ban đầu.
iof_tax_amountfloatThuế iof do người mua trả. Chỉ áp dụng cho khu vực BR. Đây là giá trị ban đầu.
is_paid_by_credit_cardbooleanĐơn hàng này có được thanh toán bằng thẻ tín dụng hay không.
merchant_subtotalfloatTổng giá sản phẩm do người mua trả khi thanh toán. Đây là giá trị ban đầu.
seller_voucherfloatVoucher do người bán cung cấp. Đây là giá trị ban đầu.
shipping_feefloatPhí vận chuyển do người mua trả. (Chỉ hiển thị cho cửa hàng không phải cb sip affiliate). Đây là giá trị ban đầu (không được cập nhật sau RR/hủy đơn).
shipping_fee_sst_amountfloatThuế SST trên phí vận chuyển do người mua trả. Hiện chỉ áp dụng cho MY. Đây là giá trị ban đầu.
shopee_voucherfloatVoucher do Shopee cung cấp. Đây là giá trị ban đầu.
shopee_coins_redeemedfloatSố coin người mua dùng khi thanh toán. Đây là giá trị ban đầu.
buyer_paid_packaging_feefloatPhí tính cho người mua về vật liệu đóng gói.
trade_in_bonusfloatTổng số tiền tất cả các khoản thưởng đổi máy được áp dụng cho giao dịch từ cả bốn bên: Shopee, Người bán, Ngân hàng và Đối tác đổi máy.
bulky_handling_feefloatPhí tính cho người mua cho việc xử lý và vận chuyển đặc biệt đối với sản phẩm vượt ngưỡng trọng lượng/kích thước. Chỉ dành cho người bán nội địa ID.
discount_pixfloatChiết khấu do PIX cung cấp. (Chỉ áp dụng cho khu vực BR)
request_idstringc19642ca9935aa8a693c243e816fea41Mã định danh của yêu cầu API dùng để theo dõi lỗi.
errorstringError code
messagestringError message