kakutey-bookkeeping

kakutey-bookkeeping

kakutey の仕訳登録ワークフローを支援するスキル。勘定科目の確認、単発・一括の仕訳登録、登録済み仕訳の一覧表示を行う。

前提条件

kakutey CLI がインストールされ、アプリが起動している必要があります。

# インストール
npm install -g kakutey-cli

# 状態確認
kakutey health

リソース

• API 仕様: api_journals.md
• CLI ヘルプ: kakutey journals --help, kakutey accounts --help

ワークフロー

A. 年次一括記帳

仕訳データを JSON ファイルとして準備し、一括登録する。

1. 勘定科目を確認して、科目名を把握する

   kakutey accounts list
   kakutey accounts list --category expense
   

2. 仕訳データ JSON を準備する（配列形式）

   [
     {
       "date": "2025-01-15",
       "description": "文房具購入",
       "lines": [
         {"side": "debit", "account": "消耗品費", "amount": 1000},
         {"side": "credit", "account": "現金", "amount": 1000}
       ]
     }
   ]
   

3. 一括登録する

   kakutey journals bulk-add journals.json
   

4. 登録内容を確認する

   kakutey journals list 2025-01-01 2025-12-31
   

B. 日常の仕訳登録

単発の取引を登録する。

# 簡易形式（2行仕訳）
kakutey journals add '{"date":"2025-03-10","description":"サンプル商事 打ち合わせ交通費","debit_account":"旅費交通費","credit_account":"現金","amount":500}'

# 複合仕訳（3行以上）
kakutey journals add '{"date":"2025-01-01","description":"開始仕訳","lines":[{"side":"debit","account":"現金","amount":50000},{"side":"debit","account":"普通預金","amount":100000},{"side":"credit","account":"元入金","amount":150000}]}'

# ファイルから登録
kakutey journals add --file journal.json

CLI コマンド一覧

コマンド	説明
kakutey accounts list [--category <type>]	勘定科目一覧（entity_id, code, name, category）
kakutey journals add '<json>'	仕訳を1件登録（簡易形式 or 複合仕訳形式）
kakutey journals add --file <path>	JSON ファイルから仕訳を1件登録
kakutey journals bulk-add <file>	JSON ファイルから仕訳を一括登録
kakutey journals list <start> <end>	指定期間の仕訳一覧を表示（entity_id 付き）

関連スキル

• kakutey-evidence: 仕訳に証憑（領収書等）を紐付ける場合に使用
• kakutey-corrections: 登録済み仕訳の修正・削除を行う場合に使用