来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Significant OpenAPI Updates
Dear Developers
Please find below the OpenAPI updates released this time. These changes aim to enhance functionality, improve flexibility, and provide better integration support.
§2 1. [VN Only] Add ‘household’ type in ‘invoice_type’ field
1. [VN Only] Add ‘household’ type in ‘invoice_type’ field
In the Vietnamese (VN) tax system, the Household Receipt is a legal electronic invoice type for individual consumers, primarily used to record household or personal consumption, not for corporate accounting purposes. This invoice type is regulated by the Vietnamese tax system and is being gradually rolled out in e-commerce transactions.
To support this invoice type, the Shopee Open API has extended the capabilities of the v2.order.get_buyer_invoice_info API. After the update:
- The ‘invoice_type’ field now returns the value ‘household’.
- The response now includes a ‘household_address_breakdown’ field, used to return detailed address information for Household invoices.
Specific updates are as follows:
| Name | Type | Description |
|---|---|---|
| invoice_type | string | Type of invoice requested: {1: personal, 2: company,3.household(NEW)}. |
| household_address_breakdown | object | Household address breakdown-Only for VN |
| >>household_region | string | Region of the household address. |
| >>household_state | string | State of the household address. |
| >>household_city | string | City of the household address. |
| >>household_province | string | Province of the household address. |
| >>household_district | string | District of the household address. |
| >>household_town | string | Town of the household address. |
| >>household_barangay | string | Barangay of the household address. |
| >>household_postcode | string | Postal code of the household address. |
| >>household_detailed_address | string | Detailed street address of the household. |
| >>household_additional_info | string | Additional address information provided by the buyer. |
| >>household_full_address | string | Full formatted household address. |
Related APIs：
v2.order.get_buyer_invoice_info
Effective Date on Live：
Lived
§3 2. [TH Only] New Response Field th_import_duty
2. [TH Only] New Response Field th_import_duty
Thailand has introduced Import Duty on imported goods priced less than 1,500 THB, effective 1 Jan 2026.
To support this change, a new response field th_import_duty is added to Open API payment interfaces.
API & Field Update
| API | Response Field | Description |
|---|---|---|
| v2.payment.get_escrow_detail | th_import_duty | [TH only] Import Duty collected for goods entering Thailand |
| v2.payment.get_escrow_detail_batch | th_import_duty | [TH only] Import Duty collected for goods entering Thailand |
Related APIs：
v2.payment.get_escrow_detail
v2.payment.get_escrow_detail_batch
Effective Date on Live：
Lived
尊敬的开发者
请查收本次的 OpenAPI 功能更新。这些改动旨在提升功能灵活性、优化使用体验，并为集成提供更好的支持。
§4 1. 【仅适用于VN】invoice_type新增返回“household”类型
1. 【仅适用于VN】invoice_type新增返回“household”类型
在越南（VN）税务体系中，Household Receipt（家庭户发票）是一种面向个人消费者的合法电子发票类型，主要用于记录家庭或个人消费场景，而非企业财务入账用途。该发票类型由越南税务系统规范管理，并在电商交易场景中逐步推广使用。
为支持该发票类型，Shopee Open API 对 v2.order.get_buyer_invoice_info 接口进行了能力扩展。更新后：
- invoice_type 字段新增返回值 household
- 响应中新增 household_address_breakdown 字段，用于返回 Household 发票的详细地址信息
具体接口更新如下：
| Name | Type | Description |
|---|---|---|
| invoice_type | string | Type of invoice requested: {1: personal, 2: company,3.household(NEW)}. |
| household_address_breakdown | object | Household address breakdown -Only for VN |
| >>household_region | string | Region of the household address. |
| >>household_state | string | State of the household address. |
| >>household_city | string | City of the household address. |
| >>household_province | string | Province of the household address. |
| >>household_district | string | District of the household address. |
| >>household_town | string | Town of the household address. |
| >>household_barangay | string | Barangay of the household address. |
| >>household_postcode | string | Postal code of the household address. |
| >>household_detailed_address | string | Detailed street address of the household. |
| >>household_additional_info | string | Additional address information provided by the buyer. |
| >>household_full_address | string | Full formatted household address. |
影响接口：
v2.order.get_buyer_invoice_info
上线时间：
Lived
§5 2.【仅适用于TH】新增响应字段 th_import_duty
2.【仅适用于TH】新增响应字段 th_import_duty
自 2026 年 1 月 1 日 起，泰国对 价格低于 1,500 泰铢的进口商品 收取进口关税。
为支持此变更，Open API Payment 接口新增响应字段 th_import_duty。
API 及字段更新
| 接口 | 响应字段 | 说明 |
|---|---|---|
| v2.payment.get_escrow_detail | th_import_duty | 【仅限TH】 针对进入泰国的货物征收的进口关税 |
| v2.payment.get_escrow_detail_batch | th_import_duty | 【仅限TH】 针对进入泰国的货物征收的进口关税 |
影响接口：
v2.payment.get_escrow_detail
v2.payment.get_escrow_detail_batch
上线时间：
已上线