发票服务
快手小店发票管理API，提供完整的电子发票处理功能。支持发票申请、发票查询、发票下载、发票状态管理、发票模板配置等核心功能，帮助商家规范化处理发票业务。
异步发票服务
kwaixiaodian.client.services.invoice.AsyncInvoiceService(client: AsyncBaseClient)
异步发票管理服务（对齐 Java SDK 与开放平台）。
方法：
| 名称 | 描述 |
|---|---|
subsidy_audit_info |
查询补贴发票审核信息。 |
amount_get |
查询可开票金额。 |
Functions
subsidy_audit_info(access_token: str, oid: str, uid: Optional[int] = None) -> InvoiceSubsidyAuditInfoResponse
async
查询补贴发票审核信息。
OpenAPI: open.invoice.subsidy.audit.info (GET)
Java: com.kuaishou.merchant.open.api.request.invoice.OpenInvoiceSubsidyAuditInfoRequest
(java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/invoice/OpenInvoiceSubsidyAuditInfoRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
oid
|
str
|
订单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvoiceSubsidyAuditInfoResponse |
InvoiceSubsidyAuditInfoResponse
|
补贴发票审核信息响应 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianValidationError
|
参数缺失或非法 |
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出 |
amount_get(access_token: str, from_type: str, to_type: str, to_id: Optional[int] = None, order_id: Optional[int] = None, uid: Optional[int] = None) -> InvoiceAmountGetResponse
async
查询可开票金额。
OpenAPI: open.invoice.amount.get (GET)
Java: com.kuaishou.merchant.open.api.request.invoice.OpenInvoiceAmountGetRequest
(java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/invoice/OpenInvoiceAmountGetRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
from_type
|
str
|
来源类型 |
必需 |
to_type
|
str
|
目标类型 |
必需 |
to_id
|
Optional[int]
|
目标ID（可选） |
None
|
order_id
|
Optional[int]
|
订单ID（可选） |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvoiceAmountGetResponse |
InvoiceAmountGetResponse
|
可开票金额查询响应 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianValidationError
|
参数缺失或非法 |
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出 |
同步发票服务
kwaixiaodian.client.services.invoice.SyncInvoiceService(client: SyncBaseClient)
同步发票管理服务（对齐 Java SDK 与开放平台）。
方法：
| 名称 | 描述 |
|---|---|
subsidy_audit_info |
查询补贴发票审核信息（同步）。 |
amount_get |
查询可开票金额（同步）。 |
Functions
subsidy_audit_info(access_token: str, oid: str, uid: Optional[int] = None) -> InvoiceSubsidyAuditInfoResponse
查询补贴发票审核信息（同步）。
OpenAPI: open.invoice.subsidy.audit.info (GET)
Java: com.kuaishou.merchant.open.api.request.invoice.OpenInvoiceSubsidyAuditInfoRequest
(java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/invoice/OpenInvoiceSubsidyAuditInfoRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
oid
|
str
|
订单ID |
必需 |
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvoiceSubsidyAuditInfoResponse |
InvoiceSubsidyAuditInfoResponse
|
补贴发票审核信息响应 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianValidationError
|
参数缺失或非法 |
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出 |
amount_get(access_token: str, from_type: str, to_type: str, to_id: Optional[int] = None, order_id: Optional[int] = None, uid: Optional[int] = None) -> InvoiceAmountGetResponse
查询可开票金额（同步）。
OpenAPI: open.invoice.amount.get (GET)
Java: com.kuaishou.merchant.open.api.request.invoice.OpenInvoiceAmountGetRequest
(java_sdk_reference/decompiled_source/com/kuaishou/merchant/open/api/request/invoice/OpenInvoiceAmountGetRequest.java)
参数：
| 名称 | 类型 | 描述 | 默认 |
|---|---|---|---|
access_token
|
str
|
访问令牌 |
必需 |
from_type
|
str
|
来源类型 |
必需 |
to_type
|
str
|
目标类型 |
必需 |
to_id
|
Optional[int]
|
目标ID（可选） |
None
|
order_id
|
Optional[int]
|
订单ID（可选） |
None
|
uid
|
Optional[int]
|
用户ID（可选） |
None
|
返回：
| 名称 | 类型 | 描述 |
|---|---|---|
InvoiceAmountGetResponse |
InvoiceAmountGetResponse
|
可开票金额查询响应 |
引发：
| 类型 | 描述 |
|---|---|
KwaixiaodianValidationError
|
参数缺失或非法 |
KwaixiaodianAPIError
|
当开放平台返回错误码或解析失败时抛出 |
发票数据模型
kwaixiaodian.models.invoice
发票管理相关数据模型（严格对齐 Java 参考）
仅保留 Java SDK 中存在的发票相关端点： - open.invoice.subsidy.audit.info (GET) - open.invoice.amount.get (GET)
类：
| 名称 | 描述 |
|---|---|
InvoiceSubsidyAuditInfoRequest |
补贴发票审核信息请求 |
SubsidyInvoiceInfo |
补贴发票审核信息（字段对齐 Java） |
InvoiceSubsidyAuditInfoResponse |
补贴发票审核信息响应 |
InvoiceAmountGetRequest |
发票可开金额查询请求 |
QueryInvoiceAmountData |
发票可开金额查询结果（字段对齐 Java） |
InvoiceAmountGetResponse |
发票可开金额查询响应 |
Classes
InvoiceSubsidyAuditInfoRequest
Bases: BaseRequest
补贴发票审核信息请求
API: open.invoice.subsidy.audit.info (GET) Java: OpenInvoiceSubsidyAuditInfoRequest