ユーザーガイド請求書発行

請求書発行

VAT 計算、PDF 生成、Stripe 支払いを使用して、複数の通貨で請求書を作成、送信、追跡します。

請求書の作成、送信、追跡

NomadBill 請求書発行を使用して、専門的な請求書を作成し、VAT を計算し、ブランド付き PDF をエクスポートし、電子メールで請求書を送信し、Stripe を介してオンライン支払いを受け入れます。下書きおよび送信された請求書を管理し、支払いの進行状況を追跡し、会社全体で請求書番号の一貫性を保つことができます。

承認された見積から開始する場合は、Quotes.

請求書のステータス

NomadBill は、status と payment_status という 2 つの個別のフィールドで請求書を追跡します。請求書のバッジでは支払い情報が優先されるため、payment_status が paid の場合、一般的な status フィールドが別の状態を示していても、請求書は支払い済みとして表示されます。

分野価値観それが何を意味するか
statusdraft、sent、paid、overdueドキュメントのライフサイクルステータス
payment_statusunpaid、pending、paid、failed決済処理状況

これを読む実際的な方法は次のとおりです。

  • draft — 請求書はまだ編集中であり、送信は完了していません。
  • sent — 請求書は配信されたか、送信済みとしてマークされています。
  • overdue — 期日が過ぎましたが、請求書はまだ決済されていません。
  • paid — 請求書は決済されています。

支払い固有の状態にさらに詳細な情報が追加されます。

  • unpaid — 支払いはまだ記録されていません。
  • pending — 支払いが進行中です。
  • paid — 支払いは正常に完了しました。
  • failed — 支払いの試行は完了しませんでした。

請求書の UI に paid が表示されている場合、その支払い状態がバッジ表示の一般的なドキュメント ステータスよりも優先されます。

請求書の作成

請求書エリアから新しい請求書を作成し、顧客情報と請求情報を入力して品目を追加し、送信前に内容を確認します。NomadBill は未完了の請求書を下書きとして保存するため、後から編集を再開できます。

新しい請求書を開く

請求書 に移動し、新しい請求書を作成します。 NomadBill は、会社のコンテキストに基づいて文書を作成し、請求書の作成時に番号を割り当てます。

請求書が開くと、編集可能な請求フィールド、品目、合計、およびドキュメント設定が表示されます。

顧客と請求の詳細を追加する

顧客情報、請求日、期日、通貨、言語を入力します。 PDF と電子メールのラベルが正しく表示されるように、受信者に一致する請求書の言語を選択してください。

保存後、請求書は、送信するか、別のマークを付けるまで、下書き ステータスのままになります。

広告申込情報を追加する

各製品またはサービスを、名前、数量、単価を含む個別の項目として追加します。範囲、請求期間、成果物を明確にする必要がある場合は、説明を含めます。

アイテムを追加または編集すると、小計が更新されます。

VAT と合計を確認する

請求書を送信する前に、VAT の割合を確認してください。 NomadBill は小計と VAT パーセンテージから合計を計算するため、PDF または支払いリンクを生成する前に金額を確認できます。

正しいレビュー手順を実行すると、明確な小計、VAT の金額、および最終合計が表示されます。

支払いのエクスポート、送信、または回収

請求書が正しいと思われたら、PDF を生成して電子メールで送信するか、顧客にオンラインで支払いを依頼する場合は Stripe チェックアウトを有効にします。送信後、NomadBill は請求書の受信者や送信日などの配送の詳細を記録できます。

その時点で、請求書は編集からアクティブな追跡に移行します。

品目

各請求書明細には小規模で一貫した構造が保存されるため、料金を明確かつ予測可能に保つことができます。明細項目には次のものが含まれます。

  • id — オプションの内部識別子
  • name — 品目のタイトル
  • description — オプションの詳細テキスト
  • quantity — 請求するユニット数
  • price — ユニットあたりの価格

請求対象のサービス、製品、または請求期間ごとに 1 つの明細項目を使用します。これにより、PDF が読みやすくなり、顧客が合計がどのように構築されたかを理解するのに役立ちます。

NomadBill は、広告申込情報のドラッグ アンド ドロップによる並べ替えもサポートしています。コアサービスを最初にリストし、払い戻し可能な経費を最後にリストするなど、請求書で伝えたいストーリーに合わせて項目を並べ替えます。

VATの計算

NomadBill は、小計と VAT の割合から請求書の合計を計算します。式は次のとおりです。

total = subtotal + (subtotal x vat_percentage / 100)

デフォルトの VAT レートは 19% で、これはドイツの標準レートと一致します。値が 0 ～ 100 の許容範囲内にある限り、必要に応じて請求書ごとの VAT パーセンテージを変更できます。

つまり:

  • 0 は、VAT 免除またはゼロ評価請求書に有効です
  • 19 はデフォルトの開始点です
  • 100 は許容される上限です

特に管轄区域を越えて請求する場合や混合税処理を扱う場合は、請求書を送信する前に VAT レートを確認してください。

通貨と言語

NomadBill は、5 つの請求書通貨と 4 つの請求書言語をサポートしています。これらの値は強制されるため、請求書では常にサポートされているオプションのいずれかが使用されます。

サポートされている通貨

  • EUR
  • USD
  • GBP
  • CHF
  • AED

サポートされている請求書の言語

  • DE
  • EN
  • FR
  • ES

デフォルト通貨の選択方法

NomadBill は、次の順序で請求書の通貨を解決します。

  1. 請求書通貨 — 請求書にすでに通貨がある場合は、その値が使用されます。
  2. 会社のデフォルト通貨 — 請求書に明示的な通貨がない場合、NomadBill は会社のデフォルトをチェックします。
  3. グローバル通貨優先 — 最初の 2 つのどちらも存在しない場合、NomadBill は、ローカル ブラウザ ストレージに nb.currency として保存されているグローバル通貨に戻ります。

この優先順位により、既存の請求書が安定した状態に保たれると同時に、会社全体およびユーザー レベルのフォールバックが提供されます。

請求書の番号付​​け

請求書番号には、R-00001 の形式が使用されます。 R プレフィックスは文書タイプを識別し、数値部分は先頭にゼロが付いた 5 桁を使用します。

NomadBill は、各企業に次の文書番号をアトミックに割り当てるデータベース関数を通じて番号を生成します。複数の人が同時に請求書を作成する場合、シーケンスは競合状態から安全に保たれるため、これは重要です。

日常の使用には 2 つの詳細が重要です。

  • 請求書番号は 会社ごとであり、すべてのアカウントでグローバルに共有されるわけではありません。
  • 各請求書番号は、company_id と invoice_number の組み合わせにより、同じ会社内で一意である必要があります。

PDF世代

NomadBill は、ダウンロード、共有、または電子メール配信のために請求書を PDF ドキュメントとしてエクスポートできます。 PDF エンジンは、標準の請求書データと会社のブランドを使用して、完成したドキュメントを作成します。

生成された PDF は、15 mm の余白のある A4 ポートレート レイアウトを使用し、以下を含めることができます。

  • 会社のロゴ
  • ブランドカラー
  • 品目テーブル
  • 合計ブロック
  • 銀行詳細
  • フッター

PDF 出力では、4 つの請求書言語すべてもサポートされているため、ラベルは請求書で選択された言語で表示されます。カスタム PDF レイアウトを使用する場合、NomadBill はテンプレートベースのレンダリングもサポートします。

PDF テンプレート

引用

請求書をメールで送信する

NomadBill は、送信者アドレスとして noreply@nomadbill.co を使用して、再送信を通じて請求書メールを送信します。 HTML コンテンツとオプションの PDF 添付ファイルを含むドキュメント電子メール、またはデータベースに配信の詳細を記録する概要形式の電子メールを送信できます。

請求書の概要メールを送信すると、NomadBill は次の追跡フィールドを更新します。

  • sent_at — 請求書の送信日
  • sent_to — 受信者が受信したもの
  • email_status — sent に設定します

電子メールの内容には次のものが含まれます。

  • 文書番号
  • 顧客の名前
  • オプションのカスタムメッセージ
  • 合計金額

これにより、送信配信と、請求書レコード内の基本的な監査証跡の両方が得られます。

Stripe での支払いの受け入れ

顧客がホストされたチェックアウト ページを通じて支払いを行うようにする場合は、請求書で Stripe を有効にします。 NomadBill は、請求書の Stripe チェックアウト セッションを作成し、顧客を Stripe に送信して支払いを完了させます。

Stripe フローの仕組み

請求書に対して Stripe を有効にする

請求書の Stripe をオンにして、stripe_enabled をアクティブにします。これにより、請求書はオンライン支払いの対象としてマークされます。

有効にすると、請求書でホストされた支払いセッションを作成できるようになります。

チェックアウトセッションを作成する

NomadBill は、請求書の合計から Stripe Checkout セッションを作成します。 Stripe に送信される金額は、Math.round(total_amount * 100) を使用してセントに変換され、通貨コードは Stripe API の小文字に変換されます。

これにより、Stripe は期待する形式で金額を受け取ることができます。

お客様を Stripe にリダイレクトします

顧客は、Stripe がホストするチェックアウト ページにリダイレクトされ、支払いを安全に完了します。請求書ページ内でカードの詳細を直接収集する必要はありません。

リダイレクトが成功した場合は、顧客が Stripe での支払いを完了していることを意味します。

成功またはキャンセルの処理

支払い後、Stripe は顧客を次の 2 つの請求ルートのいずれかに送り返します。

  • 成功: /invoices/$id/pay/success
  • キャンセル: /invoices/$id/pay/cancel

成功ページでは支払いが確認され、購入追跡がトリガーされます。キャンセル ページを使用すると、顧客は再試行できます。

Webhook 確認後に請求書を更新する

Stripe が checkout.session.completed Webhook イベントを送信すると、NomadBill は請求書を payment_status=paid および status=paid に更新します。

この Webhook の更新により、NomadBill 内の有料状態が確定します。

定期的な請求書

定期的な請求書を使用すると、請求書を繰り返しの請求パターンの一部としてマークできます。 NomadBill は、これを is_recurring フラグと recurring_frequency 値とともに保存します。

サポートされている繰り返し頻度は次のとおりです。

  • 毎週
  • 毎月
  • 四半期ごと
  • 毎年

定期的な請求書はメタデータのみです。 NomadBill は自動 cron ジョブを実行せず、このフラグだけからスケジュールに従って新しい請求書を生成しません。

定期的な設定を使用して、繰り返しの請求にラベルを付けて整理しますが、自動サブスクリプション エンジンとして依存しないでください。

次に何をすべきか

PDF テンプレートの管理

引用符を使用する

Was this page helpful?