ホーム/会計/仕訳

仕訳（Journal Entries）

仕訳の作成・更新・転記・取消など、仕訳ライフサイクル全体を管理します。

エンドポイント

GET	/api/v1/accounting/journals	仕訳一覧を取得
POST	/api/v1/accounting/journals	仕訳を作成
GET	/api/v1/accounting/journals/{id}	仕訳を取得
PATCH	/api/v1/accounting/journals/{id}	仕訳を更新
DELETE	/api/v1/accounting/journals/{id}	仕訳を削除
POST	/api/v1/accounting/journals/{id}/post	仕訳を転記
POST	/api/v1/accounting/journals/{id}/void	仕訳を取消

GET/api/v1/accounting/journals

仕訳一覧を取得

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

クエリパラメータ

名前	型	必須	説明
fiscal_year_id	string	任意	会計年度 ID で絞り込み
status	string	任意	ステータスで絞り込み（draft / posted / void）
search	string	任意	摘要で検索
limit	integer	任意	取得件数（デフォルト: 20, 最大: 100）
offset	integer	任意	取得開始位置（デフォルト: 0）

コード例

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

POST/api/v1/accounting/journals

仕訳を作成

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

リクエストボディ

名前	型	必須	説明
date	string	必須	仕訳日付（YYYY-MM-DD）
fiscal_year_id	string	必須	会計年度 ID
description	string	任意	摘要
	object[]	必須	仕訳行

コード例

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

GET/api/v1/accounting/journals/{id}

仕訳を取得

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

パスパラメータ

名前	型	必須	説明
id	string	任意	仕訳 ID

コード例

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

PATCH/api/v1/accounting/journals/{id}

仕訳を更新

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

パスパラメータ

名前	型	必須	説明
id	string	任意	仕訳 ID

リクエストボディ

名前	型	必須	説明
date	string	任意	仕訳日付（YYYY-MM-DD）
description	string	任意	摘要
	object[]	任意	仕訳行

コード例

curl -X PATCH "https://api.blueai.jp/api/v1/accounting/journals/je_123e4567e89b12d3a456426614174000" \
  -H "Cookie: better-auth.session_token=<token>"

DELETE/api/v1/accounting/journals/{id}

仕訳を削除

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

パスパラメータ

名前	型	必須	説明
id	string	任意	仕訳 ID

コード例

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

POST/api/v1/accounting/journals/{id}/post

仕訳を転記

下書き状態の仕訳を転記（確定）します。転記後は編集できません。

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

パスパラメータ

名前	型	必須	説明
id	string	任意	仕訳 ID

コード例

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

POST/api/v1/accounting/journals/{id}/void

仕訳を取消

転記済みの仕訳を取消（無効化）します。逆仕訳が自動生成されます。

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

パスパラメータ

名前	型	必須	説明
id	string	任意	仕訳 ID

コード例

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