---
title: 发票与总账
description: 记录 NexCMP 中资金流向的地方——钱包总账、发票、充值付款、退款与出金、代金券以及收入报告。
url: https://nexcmp.com/zh-cn/docs/billing/invoices-and-ledger/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 发票与总账 {#invoices-and-ledger}

> **管理后台位置：**Finance › Billing (`/billing`)，包含 Overview、Transactions (`/billing/ledger`)、Invoices (`/billing/invoices`)、Top-ups (`/billing/deposits`)、Payouts (`/billing/payouts`)、Vouchers (`/billing/vouchers`) 和 Reports (`/billing/reports`) 标签页。**用户门户位置：**Billing (`/billing`)。

## 功能说明 {#what-it-does}

NexCMP 中的每个金额均以美元分（USD cents）存储并记录一次。核心理念：**钱包总账**是余额的唯一真实数据源；发票、充值付款和报告都是基于它生成的视图。总账是**只追加的**——错误只能通过添加红冲分录来修正，绝不能通过编辑历史记录来修改。

## 前提条件 {#requirements}

| 项目 | 要求 |
|---|---|
| 角色 | 管理员。 |
| 卖家详情 | 在 **System › Settings › General** 的 **Seller & invoicing** (`/settings?tab=seller`) 标签页、**Seller details (printed on invoices)** 卡片中设置法定名称、税号、地址、联系邮箱和发票号前缀。 |
| 依赖项 | 用于资金流入的 [Payment channels](https://nexcmp.com/zh-cn/docs/billing/payment-channels/)。 |

## 组成部分 {#the-pieces}

| 管理后台标签页 | 列表内容 | 典型用途 |
|---|---|---|
| **Overview** | 今日与本月营收、按类型划分的账单总计（充值、扣款、退款、调整、代金券）、按状态划分的发票、待处理退款、快捷方式、过去30天内每个服务的消费 | 每日检查 |
| **Transactions** | 钱包账本，每行代表一笔资金变动 | 解释客户的余额 |
| **Invoices** | 发票，以及包含每项服务每次购买记录的第二个视图 **Orders** | 查找单据、重新发送、标记为已支付 |
| **Top-ups** | 通过网关收到的付款 | 检查付款、进行退款 |
| **Payouts** | 信用卡退款、联盟返佣、分销商提现 | 批准资金流出 |
| **Vouchers** | 充值码 | 参见 [Promotions](https://nexcmp.com/zh-cn/docs/billing/promotions/) |
| **Reports** | 按服务、按分销商统计的营收 | 会计核算 |

### Transactions (ledger) {#transactions-ledger}

列：时间、客户、**类型**、服务、金额（带符号）、虚拟机、参考号、操作人、备注。筛选器：类型、服务、客户ID、站点（当您拥有分销商时）、日期范围以及虚拟机链接。

| 类型 | 说明 |
|---|---|
| `deposit` | 来自网关的充值 |
| `charge` | 为服务扣除的资金（订单、续费、按小时计费等） |
| `refund` | 退回到钱包的资金 |
| `adjust` | 管理员信用额度或借方，以及充值码（参考号以 `vch:` 开头）——概览将代金券显示为单独的一行 |

每一行都有一个参考号，例如 `dep:stripe:<payment-id>`；同一参考号永不重复写入，这就是重复的Webhook无法进行两次入账的原因。使用 **Customers › List › customer › Credit / debit** 添加手动调整：必须填写原因，正数金额还会尝试解锁因资金不足而被锁定的虚拟机，且该操作分两步确认。

![显示钱包账目明细行（包含类型、服务、金额和参考号）的Transactions选项卡](https://nexcmp.com/zh-cn/docs/images/billing/invoices-and-ledger-01-ledger.webp)

### Invoices {#invoices}

当客户购买或续费使用钱包支付的项目，或进行充值时，系统会自动创建发票。编号类似于 `<prefix><YYYYMM>-<000001>`（例如 `NX202610-000042`）；分销商站点使用其自己的前缀和序列。更改前缀时，现有编号永远不会改变。

| 字段 | Values |
|---|---|
| 类型 | Receipt, Renewal, Top-up, Manual, Refund |
| 状态 | Unpaid, Paid, Overdue, Cancelled, Refunded |

Actions on a row:

| 操作 | Effect |
|---|---|
| **View** / **Print** | 打开发票；门户也可以打印或保存为PDF。 |
| **Mark paid**（仅限未付或逾期账单） | 将其标记为已支付 **而不移动钱包资金**——当客户在 NexCMP 之外向您付款时使用此功能。必须填写原因。对于续费发票，它还会延长并解锁被锁定的虚拟机。 |
| **Cancel**（仅限未付或逾期账单） | 取消发票。必须填写原因。 |
| **Resend** | 再次发送发票电子邮件。 |

**Create manual invoice**（标签页顶部的按钮）：客户 ID、1 到 50 行（描述、数量、单价）、可选的虚拟机 ID、可选的到期天数（0 到 365，默认 7）、可选备注。创建时为未支付状态；客户可在 **Billing › Invoice History** 中查看。

**只要账户中有余额，服务的未付账单就会从钱包中自动结算**，因此客户只需进行充值即可。


### Top-ups (payments) {#top-ups-payments}

每行代表一次尝试：时间、客户、**网关和支付方式**、类型（充值或自动充值）、状态（pending、completed、failed、refunded、disputed、canceled）、客户支付金额、手续费、进入钱包的金额、网关参考号及完成时间。已完成的 Stripe 和 PayPal 支付具有 **Refund** 操作。使用网关事件页面查看 Webhook（[Payment channels](https://nexcmp.com/zh-cn/docs/billing/payment-channels/)）。

### Payouts {#payouts}

三个子标签页：**Card refunds**（批准或拒绝退款请求；请求由已完成的支付创建）、**Affiliate payouts**（佣金提现）和 **Reseller withdrawals**。每一项决定均会记录审计日志。

### Reports {#reports}

**Revenue**（30 天趋势、按月统计、顶级客户）、**By service** 和 **By reseller**。

![展示收入 KPI 和三十天趋势的报表标签页](https://nexcmp.com/zh-cn/docs/images/billing/invoices-and-ledger-03-reports.webp)

## 客户所见内容 {#what-the-customer-sees}

在 **Billing** 中，客户拥有 **Balance**、**Deposit**、**Redeem code**、**Settings**（自动充值）以及包含 **Invoice History**、**Payment Order**、**Ledger** 和 **Orders**（所有服务列表，可按服务和类型筛选）标签页的历史记录。每个账单都有 **View**、**Print** 和 **Save as PDF**；金额以美元显示，也可按显示货币呈现。

## 验证 {#verify}

1. 以测试客户身份进行小额充值。
2. **Transactions** 显示 `deposit` 行，**Top-ups** 将支付显示为 *Completed*，并且 **Overview** 收入增加。
3. 购买某项服务：出现 `charge` 行，并且 **Invoices** 显示带有您配置的卖家详细信息的 *Receipt* 或 *Renewal* 账单。

## 限制与注意事项 {#limits-notes}

- **仅追加。** 无法编辑或删除分类账行；请添加带有原因的调整项。
- **币种。** 金额单位为USD；显示币种仅为外观展示（参见[Currency and exchange rates](https://nexcmp.com/zh-cn/docs/catalog/currency-and-exchange-rates/)）。
- **退款至银行卡**分为两步（发起申请，然后在Payouts中审批）；USDT和银行转账无法退回到原支付源。
- **所有操作均有审计**，记录在System › Logs › Admin actions中并附带你填写的理由。
- **订单与账单。** 小时级用量不会按小时开具账单；Orders视图会按天进行分组，以便你随时查看。

## 故障排查 {#troubleshooting}

| 症状 | 原因 | 解决办法 |
|---|---|---|
| 客户余额似乎不正确 | 出现了意料之外的扣款、调整或代金券 | 通过客户ID筛选**Transactions**，并查看参考信息与备注。 |
| "发票已支付" (409) | 对已付款的账单重复标记已付款 | 无需处理。 |
| 无法取消账单 | 只有未付款或逾期账单才能被取消 | 对于已付款的账单，请使用退款或调账。 |
| 账单上缺少卖家详情 | 未填写 | 在System › Settings › General › Seller & invoicing中完整填写**Seller details**。 |
| 信用卡/借记卡被拒绝 | 金额为零或超过$100,000 | 使用介于 1 分到 $100,000 之间的金额。 |
| 某笔付款长时间显示*Pending* | 缺少Webhook | 查看**Gateway events**并进行重试。 |