メインコンテンツへ
BlueAI
ホーム/会計/勘定科目

勘定科目(Accounts)

勘定科目の作成・更新・削除と、初期データの一括投入を行います。

|

エンドポイント

GET/api/v1/accounting/accounts勘定科目一覧を取得
POST/api/v1/accounting/accounts勘定科目を作成
PATCH/api/v1/accounting/accounts/{id}勘定科目を更新
DELETE/api/v1/accounting/accounts/{id}勘定科目を削除
POST/api/v1/accounting/accounts/seed勘定科目を一括投入
GET/api/v1/accounting/accounts

勘定科目一覧を取得

認証が必要ですセッション Cookie または Bearer トークンを含めてください

クエリパラメータ

名前必須説明
search
string任意科目名・科目コードで検索
account_type
string任意科目区分で絞り込み(asset / liability / equity / revenue / expense)
limit
integer任意取得件数(デフォルト: 100, 最大: 500)
offset
integer任意取得開始位置(デフォルト: 0)

コード例

curl "https://api.blueai.jp/api/v1/accounting/accounts" \
  -H "Cookie: better-auth.session_token=<token>"
POST/api/v1/accounting/accounts

勘定科目を作成

認証が必要ですセッション Cookie または Bearer トークンを含めてください

リクエストボディ

名前必須説明
code
string必須科目コード
name
string必須科目名
account_type
string必須科目区分(asset / liability / equity / revenue / expense)
parent_id
string任意親科目 ID
description
string任意説明
tax_category
string任意税区分

コード例

curl -X POST "https://api.blueai.jp/api/v1/accounting/accounts" \
  -H "Cookie: better-auth.session_token=<token>"
PATCH/api/v1/accounting/accounts/{id}

勘定科目を更新

認証が必要ですセッション Cookie または Bearer トークンを含めてください

パスパラメータ

名前必須説明
id
string任意勘定科目 ID

リクエストボディ

名前必須説明
code
string任意科目コード
name
string任意科目名
account_type
string任意科目区分(asset / liability / equity / revenue / expense)
parent_id
string任意親科目 ID
description
string任意説明
tax_category
string任意税区分

コード例

curl -X PATCH "https://api.blueai.jp/api/v1/accounting/accounts/acc_123e4567e89b12d3a456426614174000" \
  -H "Cookie: better-auth.session_token=<token>"
DELETE/api/v1/accounting/accounts/{id}

勘定科目を削除

認証が必要ですセッション Cookie または Bearer トークンを含めてください

パスパラメータ

名前必須説明
id
string任意勘定科目 ID

コード例

curl -X DELETE "https://api.blueai.jp/api/v1/accounting/accounts/acc_123e4567e89b12d3a456426614174000" \
  -H "Cookie: better-auth.session_token=<token>"
POST/api/v1/accounting/accounts/seed

勘定科目を一括投入

日本の標準的な勘定科目体系を一括で作成します。初回セットアップ時に使用します。

認証が必要ですセッション Cookie または Bearer トークンを含めてください

コード例

curl -X POST "https://api.blueai.jp/api/v1/accounting/accounts/seed" \
  -H "Cookie: better-auth.session_token=<token>"