本文へ移動
cccskills
無料GitHub で公開

voucher-entry

証憑(画像/PDF)の読み取りから証憑登録・自動仕訳(承認待ち)までの手順

インストール方法を見る

含まれるファイル(1)

  • SKILL.md3.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Skill: 証憑入力と自動仕訳

画像/PDFの証憑を読み取り、証憑登録し、過去の仕訳パターンから自動仕訳して承認待ち伝票を作成する。

前提

  • describe_image(describe-image MCP): 画像/PDFのOCR
  • voucher-mcp: 証憑登録・仕訳伝票の作成・参照
  • knowledge/wiki/accounting/仕訳パターン.md: 学習済みの仕分けパターン

手順

1. OCRで証憑を読み取る

describe_image を呼び、以下をJSONで抽出する:

この帳票から 会社名/発行日/金額/消費税/税率/請求番号/取引内容 を読み取り、
以下のJSON形式で出力してください:
{"company":"...","issueDate":"...","amount":...,"tax":...,"taxRate":...,"invoiceNo":"...","description":"..."}
不明な項目は null。

抽出結果は必ず読み手として確認する(金額の桁や会社名の誤読に注意)。

2. 取引先と伝票種別を特定する

  • get_companies で会社名を照合して companyId を確定(部分一致可、一致しない場合は候補を複数挙げて人間に確認)
  • get_voucher_classes で伝票種別(請求書/領収書/仕入 等)を選んで voucherClassId を確定

3. 証憑を登録する

create_voucher_with_file で証憑登録+ファイル添付:

{voucherClassId, issueDate, companyId, amount, taxRuleId?, filePath, description?, invoiceNo?}
  • taxRuleId は get_tax_rules で取得(省略時は税額0)
  • 登録結果の voucher.id を保持する

4. 仕訳を決定する(自動仕訳)

knowledge/wiki/accounting/仕訳パターン.md を読み、証憑の「伝票種別 × 取引先」に合致するパターンを探す。

  • 合致するパターンがある: 借方/貸方科目をそのパターンに従って決定し、create_cross_slip で作成(承認待ち)
    • 証憑の方向: 伝票種別が send=true なら貸方側、send=false なら借方側に証憑IDを紐付ける
    • 明細行: debitAccount/debitSubAccount/debitAmount / creditAccount/creditSubAccount/creditAmount、証憑IDは debitVoucherId or creditVoucherId
  • パターンにない新規ケース: 自動仕訳せず、推定の提案(借方/貸方の候補)を人間に提示して判断を仰ぐ
  • 参考: 過去の類似仕訳は get_journal で確認できる

5. 承認待ちを確認・通知する

list_cross_slips(承認待ち)で作成した伝票が承認待ちに入っていることを確認し、人間に通知する。

注意

  • 金額・日付・会社名の誤読は必ず人間が承認時に確認できるように、作成した伝票の摘要(application1)に「OCR: <取引内容>」を残す
  • 自動仕訳が誤っていた場合は、その結果を journal-learning でパターンに反映する(自分の推測を「事実」にしない)

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

journal-learning

無料日本語概要

過去の仕訳日記帳から仕分けパターンを確認・更新し、wikiのパターンページを保守する手順

BeesNestInc/hieronymus102026年8月18日 更新

BeesNestInc のスキルをすべて見る

このスキルの問題を報告する