請求書と台帳

管理画面での場所: 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)。

動作内容

NexCMP 内のすべての金額は USD セント単位で保存され、1回記録されます。重要な概念として、ウォレット台帳が残高の信頼できる情報源（シングル・ソース・オブ・トゥルース）となり、請求書、トップアップ支払い、レポートはそこから構築されるビューとなります。台帳は**追記型（append-only）**であり、間違いの修正は履歴を編集するのではなく、逆仕訳エントリを追加することによって行われます。

要件

項目	要件
ロール	管理者。
販売者の詳細	System › Settings › GeneralのSeller & invoicingタブ（/settings?tab=seller）、**Seller details (printed on invoices)**カードで、法的名称、税金ID、住所、連絡先メールアドレス、請求書番号のプレフィックスを設定します。
依存関係	入金用のPayment channels。

構成要素

管理画面タブ	リストされる内容	一般的な用途
Overview	本日の売上および今月の売上、種類別の台帳合計（入金、請求、返金、調整、バウチャー）、ステータス別の請求書、保留中の返金、ショートカット、過去30日間のサービス別支出	日次確認
Transactions	ウォレット台帳（1移動につき1行）	顧客の残高を説明する
Invoices	請求書、およびすべてのサービスのすべての購入履歴を表示する2つ目のビューOrders	書類の検索、再送信、支払済みのマーク
Top-ups	決済ゲートウェイを通じて受領した支払い	支払いの確認と返金
Payouts	カードの返金、アフィリエイト報酬、リセラーの出金	出金の承認
Vouchers	トップアップコード	Promotionsを参照
Reports	サービス別、リセラー別の売上	会計

トランザクション（台帳）

列：日時、顧客、種類、サービス、金額（符号付き）、VM、参照ID、アクター、メモ。フィルター：種類、サービス、顧客ID、サイト（リセラーがいる場合）、日付範囲、およびVMリンク。

種類	意味
deposit	ゲートウェイからのトップアップ
charge	サービスの代金として引き落とされた金額（注文、更新、時間制の利用など）
refund	ウォレットに返金された金額
adjust	管理者によるクレジットまたはデビット、およびトップアップコード（参照IDはvch:で開始）。概要ではバウチャーが独自の行として表示されます

すべての行にはdep:stripe:<payment-id>のような参照IDがあり、同じ参照IDを二重に書き込むことはできないため、重複したWebhookによって二重に入金されることはありません。手動調整を追加するにはCustomers › List › customer › Credit / debitを使用します。理由は必須であり、正の金額を指定すると資金不足でロックされたVMのロック解除も試行され、アクションは2段階で確認されます。

請求書

請求書は、顧客がウォレットから支払う形でのサービスの購入や更新を行った際、またはトップアップ時に自動的に作成されます。番号の形式は<prefix><YYYYMM>-<000001>（例：NX202610-000042）で、リセラーサイトでは独自のプレフィックスと連番が使用されます。プレフィックスを変更しても、既存の番号が変更されることはありません。

項目	値
種類	レシート、更新、トップアップ、手動、返金
ステータス	未払い、支払済み、期限切れ、キャンセル済み、返金済み

行に対するアクション：

アクション	効果
View / Print	請求書を開きます。ポータルから印刷したり、PDFとして保存することもできます。
Mark paid（未払いまたは期限切れのみ）	ウォレット残高を移動せずに支払済みにマークします。顧客からNexCMP以外で支払いを受けた場合に使用します。理由は必須です。更新請求書の場合、ロックされたVMの期間延長とロック解除も行われます。
Cancel（未払いまたは期限切れのみ）	請求書をキャンセルします。理由は必須です。
Resend	請求書を再度メールで送信します。

手動請求書の作成 (タブ上部のボタン): 顧客ID、1〜50行の明細 (説明、数量、単価)、任意のVM ID、任意の支払期限日数 (0〜365、デフォルトは7)、任意のメモ。未払いとして作成され、お客様はBilling › Invoice Historyで確認できます。

サービスの未払い請求書は、残高が補充され次第ウォレットから自動的に精算されるため、お客様の操作は入金のみとなります。

トップアップ（入金）

試行ごとに1行：日時、顧客、決済ゲートウェイと方法、種類（トップアップまたは自動トップアップ）、ステータス（保留中、完了、失敗、返金済み、紛争中、キャンセル済み）、お客様の支払額、手数料、ウォレットへの入金額、ゲートウェイの参照番号と完了日時。完了したStripeおよびPayPalの支払いにはRefund操作があります。Webhookを確認するには、決済チャネルのページ（Payment channels）を使用します。

出金

3つのサブタブ：Card refunds（返金リクエストの承認または拒否。リクエストは完了した支払いから作成されます）、Affiliate payouts（紹介報酬の引き出し）、Reseller withdrawals（リセラーの引き出し）。すべての決定は監査されます。

レポート

Revenue（30日間のトレンド、月別、上位顧客）、By service、By reseller。

お客様の画面

Billingでは、お客様はBalance、Deposit、Redeem code、Settings（自動トップアップ）、およびInvoice History、Payment Order、Ledger、Orders（サービスとタイプでフィルタリングできる1つのリスト内のすべてのサービス）のタブ付き履歴を利用できます。各請求書にはView、Print、Save as PDFがあり、金額はUSDで表示され、表示通貨で任意に切り替えることもできます。

確認

1. テスト顧客として少額のトップアップを行います。
2. Transactionsにdepositの行が表示され、Top-upsに支払いがCompletedとして表示され、Overviewの収益が増加します。
3. 購入を行います：chargeの行が表示され、Invoicesに設定した販売者の詳細を含むReceiptまたはRenewalの請求書が表示されます。

制限と注意事項

• 追記専用。 元帳の行を編集または削除する方法はありません。理由を添えて調整（アジャストメント）を追加してください。
• 通貨。 金額はUSDです。表示通貨は装飾的なものです（Currency and exchange ratesを参照してください）。
• カードへの返金は2段階のプロセス（リクエスト、次にPayoutsでの承認）です。USDTや銀行振込は元の支払方法には返金されません。
• すべてが監査されます。 入力された理由とともに、System › Logs › Admin actionsに記録されます。
• 注文と請求書の違い。 時間単位の使用量は時間ごとに請求されません。Ordersビューでは日別にグループ化されるため、引き続き確認できます。

トラブルシューティング

症状	原因	対処法
顧客の残高が正しくないように見える	予期しない課金、調整、またはクーポン	Transactionsを顧客IDでフィルタリングし、参照番号とメモを確認します。
"請求書はすでに支払い済みです" (409)	支払い済みの請求書に対して「支払済みにする」を実行した	特に行うべきことはありません。
請求書をキャンセルできない	キャンセルできるのは未払いまたは期限切れの請求書のみです	支払い済みの請求書の場合は、返金または調整を使用してください。
請求書に販売者の詳細が表示されない	入力されていない	System › Settings › General › Seller & invoicingでSeller detailsを入力してください。
クレジットカード/デビットカードが拒否された	金額がゼロ、または$100,000を超えています	1セントから$100,000の間の金額を使用してください。
支払いが長期間Pendingのままになっている	Webhookが欠落している	Gateway eventsを確認し、再再生（リプレイ）してください。