> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subotiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 发票

<AccordionGroup>
  <Accordion title="Subotiz 中有哪些发票类型？各自代表什么？">
    Subotiz 为每张发票分配一个发票类型，用于标识产生扣费的账单场景。可用类型包括：

    * **一次性支付** —— 客户完成一次性商品购买时生成。
    * **免费试用** —— 在需要支付方式的免费试用流程中生成，如试用激活或支付方式收集。
    * **订阅创建** —— 订阅首次创建并完成首次扣款时生成。
    * **订阅续订** —— 订阅在计费周期开始时自动续订时生成。
    * **订阅变更扣款** —— 订阅升级、降级或修改并产生额外费用时生成。
    * **订阅激活** —— 订阅激活并产生计费扣款时生成。

    发票类型仅用于业务识别，不影响支付状态或结算结果。
  </Accordion>

  <Accordion title="Subotiz 的发票有哪些状态？各自代表什么？">
    Subotiz 共显示七种发票状态：

    * **成功** —— 支付已成功完成。
    * **失败** —— 支付尝试未成功。
    * **待支付** —— 发票已生成但支付尚未完成。
    * **支付处理中** —— 支付正在处理中，等待确认。
    * **重试中** —— 订阅续订支付失败，当前处于自动重试周期内，状态会根据重试结果自动更新。
    * **已退款** —— 发票全额已退款。
    * **部分退款** —— 发票金额的一部分已退款。

    发票状态反映当前的支付或退款状态，与反映账单场景的发票类型是不同的字段。
  </Accordion>

  <Accordion title="如何在 Subotiz 中搜索特定发票？">
    在 Subotiz 后台的发票模块中，可以通过多种方式搜索和筛选发票：

    * 通过搜索栏按客户邮箱或发票 ID 搜索。
    * 按状态筛选，查看特定支付或退款状态的发票，如成功、失败、重试中或已退款。
    * 按发票类型筛选，查看特定账单场景的发票，如订阅续订或一次性支付。
    * 按时间范围筛选，将结果缩小到特定时间段。

    多个筛选条件可以组合使用。点击任意发票行可进入完整的发票详情页，查看完整账单和支付信息。
  </Accordion>

  <Accordion title="可以为 Subotiz 中的每张发票生成并下载正式 PDF 发票吗？">
    不是所有发票都可以。生成正式发票文件仅适用于以下三种状态的发票：成功、全部退款、部分退款。状态为失败或仍处于处理中的发票（如待支付、支付处理中、重试中）不支持生成发票文件。

    如需生成发票：

    1. 进入 Subotiz 后台的发票模块。
    2. 打开符合条件的发票。
    3. 点击右上角的生成发票按钮。

    系统会自动生成 PDF 文件并下载至本地。
  </Accordion>

  <Accordion title="生成发票时修改了收票人信息，会影响客户资料吗？">
    不会。在生成发票时对收票人信息（姓名、邮箱和账单地址）所做的修改，仅作用于当次生成的发票文件，不会修改客户资料或任何历史账单记录。这些字段默认基于发票记录和客户资料预填充，但您所做的任何修改仅限于当次生成的 PDF 文件。这样商家可以根据账务或税务需求灵活调整发票信息，而不影响客户数据。
  </Accordion>

  <Accordion title="可以对同一张发票多次生成 PDF 吗？重复生成会影响支付或订阅吗？">
    可以。同一张发票记录可以多次生成 PDF 文件，不限次数。每次生成时都可以更新或调整收票人信息。重复生成发票文件不会对支付结果、退款状态或订阅关系产生任何影响，纯属文件生成操作。请注意，历史已生成的发票文件不会自动更新，每份文件反映的是生成时的信息。
  </Accordion>

  <Accordion title="下载的发票 PDF 文件包含哪些内容？">
    生成的发票 PDF 包含以下信息：

    * 发票编号
    * 支付方式与支付时间
    * 货币代码
    * 发票主体信息（Merchant of Record 模式下显示开票主体，非 MOR 模式可能不显示）
    * 收票人信息（姓名、邮箱和账单地址）
    * 项目明细（单价、数量、折扣和金额）
    * 小计与总金额
    * 退款信息（如适用）

    对于部分或全额退款的发票，退款明细和调整后的最终金额会反映在文件中。发票主体信息来源于企业资料，保持企业信息最新可确保发票准确、规范。
  </Accordion>

  <Accordion title="订阅续订支付失败了，为什么发票状态显示的是「重试中」而不是「失败」？">
    当订阅续订支付失败时，Subotiz 会激活智能重试（Smart Retry）机制，发票状态会设置为重试中而非失败。这个状态表示首次支付失败，但系统当前仍在自动重试周期内，会根据智能重试计划再次尝试扣款。发票状态会根据重试结果自动更新：如果某次重试成功，状态变更为成功；如果所有重试均失败，状态更新为失败。在重试中状态期间，商家无需进行任何操作。
  </Accordion>

  <Accordion title="我想发起退款，可以直接在发票页面操作吗？">
    不可以。退款无法直接从发票页面发起。Subotiz 中的所有退款都通过对应的交易单进行处理。

    如需发起退款：

    1. 前往交易单模块。
    2. 找到对应的订单。
    3. 从那里发起退款操作。

    退款完成后，发票状态会自动更新以反映退款结果——全额退款后变为全部退款，部分退款后变为部分退款。退款失败时发票状态保持不变。发票页面仅用于查看账单记录和生成发票文件。
  </Accordion>

  <Accordion title="我看到一张金额为 $0 的发票，这是系统错误吗？">
    不是，零金额发票不是系统错误。Subotiz 在某些特定场景下可能会生成金额为 \$0 的发票。主要有两种情况：

    1. 在订阅续订场景下首次生成 \$0 发票时：系统仍可能发起支付流程，用于完成或验证支付方式绑定。支付网关确认成功后（即使金额为 \$0），发票状态会更新为成功。
    2. 对于一次性购买或已绑定支付方式的场景，无需进行支付方式验证时：系统直接生成发票并标记为成功，不会触发支付流程，也不会生成对应的支付记录。

    零金额发票是正常的账单行为，用于准确记录该计费事件。
  </Accordion>
</AccordionGroup>