Create Invoice

board_clients_list で顧客を検索する。

• 結果が大きくファイル保存される場合は、保存先ファイルを jq でフィルタ:

  cat [保存先ファイル] | jq -r '.[0].text' | jq '.[] | select(.name | test("企業名"))'
  

• 顧客が未登録の場合は board_clients_create で新規作成（name, name_disp が必須）

3. Board担当者の確認

board_users_list でユーザー一覧を取得する。

• 1ページ10件のページネーションあり。見つかるまで page パラメータを進める
• ユーザーに担当者を確認する（選択肢を提示）

4. 請求日の確認

ユーザーに請求日を確認する。メール等に期限がある場合はそれを踏まえて選択肢を提示する。

5. 案件の作成

board_projects_create で案件を登録する。

必須パラメータ:

一括請求の場合の追加必須:

よく使うオプション:

レスポンスから invoices[0].id を必ず控える（次の手順で使用）。

6. 請求書明細の登録

board_documents_invoices_update で請求書の明細を追加する。

重要: id にはプロジェクト作成レスポンスの invoices[0].id を使う（プロジェクトIDではない、請求リストのIDでもない）。

パラメータ:

{
  "id": "[invoices[0].id]",
  "details": [
    {
      "description": "摘要テキスト",
      "quantity": 1,
      "unit": "式",
      "unit_price": 30000,
      "tax_rate": 10,
      "tax_included_flg": 0,
      "document_detail_kbn": 1
    }
  ],
  "total": 30000,
  "tax": 3000
}

• document_detail_kbn: 1(通常), 2(見出し), 3(小計)
• tax_included_flg: 0(税抜), 1(内税)
• 複数明細がある場合は details 配列に追加

7. 完了報告

以下を表形式でユーザーに報告する:

• 案件No、案件名、顧客名、担当者
• 受注ステータス、請求日、支払期限
• 小計、消費税、合計金額
• 「Boardから請求書PDFを発行・送付してください」と案内

マスタ情報

支払条件

既知の顧客（随時追加）

注意事項

• clients_list の結果は大きいためファイルに保存される。jq でフィルタして検索する
• users_list はページネーションあり（1ページ10件）
• 書類更新のIDを間違えると「指定のリソースは見つかりません」エラーになる
• 日本語で作業する