e-bookkeeping-compliance

Name: e-bookkeeping-compliance
Author: kazukinagata

348stars34forks

How to install e-bookkeeping-compliance?

kazukinagata/shinkoku/e-bookkeeping-compliance

$npx -y skills add kazukinagata/shinkoku --skill e-bookkeeping-compliance

Installs into the current project.

Summary

優良な電子帳簿の要件チェック・コンプライアンス診断を実行する。「優良な電子帳簿」「電帳法対応」「電子帳簿の要件確認」「税務調査の準備」「75万円控除の条件」「帳簿の要件を満たしているか」「e-bookkeeping compliance」で起動。

Files · 1

View on GitHub

SKILL.md

1	# 優良な電子帳簿コンプライアンス診断
2
3	税務調査への備え、または優良な電子帳簿の要件充足状況を診断するスキル。
4	電子帳簿保存法施行規則第5条第5項（優良な電子帳簿の要件）に基づき、
5	shinkoku の帳簿データが要件を満たしているかを自動チェックする。
6
7	## 前提知識
8
9	- 電帳法の要件詳細: /tax-ebookkeeping-context を実行する
10	- システム概要書: `docs/system-overview.md`
11
12	---
13
14	## Step 0: 前提確認
15
16	ユーザーに以下を確認する:
17
18	1. DB パス: `--db-path` に使用するデータベースファイルのパス
19	2. 対象年度: `--fiscal-year` に使用する会計年度
20	3. 届出書の提出状況: 「国税関係帳簿の電磁的記録等による保存等に係る届出書」を所轄税務署に提出済みか
21
22	> 届出について: 優良な電子帳簿の保存を適用するには、あらかじめ届出書の提出が必要です。
23	> 令和9年分から適用する場合は、令和8年中に届出書を提出する必要があります。
24	> 届出書の様式は国税庁ウェブサイトからダウンロードできます。
25
26	---
27
28	## Step 1: 自動診断 & サマリー出力
29
30	以下のコマンドを実行してシステムの適合状況を診断する。
31	結果はテーブル形式でユーザーに提示する。
32
33	### チェック項目と実行コマンド
34
35	\| # \| 要件 \| 条文 \| チェック方法 \|
36	\|---\|------\|------\|------------\|
37	\| G1 \| システム関係書類の備付け \| 施行規則2条2項1号 \| `docs/system-overview.md` ファイルの存在を確認 \|
38	\| G2 \| 見読可能性の確保 \| 施行規則2条2項2号 \| `shinkoku ledger trial-balance --db-path <db> --fiscal-year <year>` を実行し、正常出力を確認 \|
39	\| G3 \| ダウンロード対応 \| 施行規則2条2項3号 \| `shinkoku ledger search --db-path <db> --input <params> --format csv` を実行し、CSV出力を確認 \|
40	\| G4 \| 訂正・削除履歴 \| 施行規則5条5項1号イ \| `shinkoku ledger audit-log --db-path <db>` を実行し、テーブルが機能することを確認 \|
41	\| G5 \| 相互関連性の確保 \| 施行規則5条5項1号ロ \| `shinkoku ledger general-ledger --db-path <db> --fiscal-year <year> --account-code <code>` を実行し、仕訳帳⇔総勘定元帳の関連を確認 \|
42	\| G6 \| 取引先検索 \| 施行規則5条5項1号ハ \| `counterparty_contains` パラメータで検索を実行 \|
43	\| G7 \| 日付・金額の範囲指定検索 \| 施行規則5条5項1号ハ \| `date_from`/`date_to`/`amount_min`/`amount_max` パラメータで検索を実行 \|
44	\| G8 \| 組合せ検索 \| 施行規則5条5項1号ハ \| 日付+取引先+金額を組み合わせた検索を実行 \|
45
46	### 診断手順
47
48	1. G1: `docs/system-overview.md` の存在を確認する
49	2. G2: 残高試算表を生成する
50	```bash
51	shinkoku ledger trial-balance --db-path <db> --fiscal-year <year>
52	```
53	3. G3: 仕訳をCSV形式で出力する
54	```bash
55	shinkoku ledger search --db-path <db> --input <params> --format csv
56	```
57	（params には `{"fiscal_year": <year>, "limit": 5}` を指定）
58	4. G4: 監査ログを取得する
59	```bash
60	shinkoku ledger audit-log --db-path <db>
61	```
62	5. G5: 任意の勘定科目で総勘定元帳を出力する（仕訳が存在する科目を使用）
63	```bash
64	shinkoku ledger general-ledger --db-path <db> --fiscal-year <year> --account-code <code>
65	```
66	6. G6-G8: 検索機能のテスト
67	```bash
68	# G6: 取引先検索
69	shinkoku ledger search --db-path <db> --input <params>
70	# params: {"fiscal_year": <year>, "counterparty_contains": "<取引先名の一部>"}
71
72	# G7: 範囲指定検索
73	# params: {"fiscal_year": <year>, "date_from": "<開始日>", "date_to": "<終了日>", "amount_min": 1, "amount_max": 1000000}
74
75	# G8: 組合せ検索
76	# params: {"fiscal_year": <year>, "date_from": "...", "counterparty_contains": "...", "amount_min": 1}
77	```
78
79	### サマリー出力形式
80
81	診断結果を以下のテーブル形式で出力する:
82
83	```
84	## 優良な電子帳簿コンプライアンス診断結果
85
86	\| # \| 要件 \| 条文 \| 結果 \| 備考 \|
87	\|---\|------\|------\|------\|------\|
88	\| G1 \| システム関係書類 \| 施行規則2条2項1号 \| ✓ / ✗ \| ... \|
89	\| G2 \| 見読可能性 \| 施行規則2条2項2号 \| ✓ / ✗ \| ... \|
90	\| G3 \| ダウンロード対応 \| 施行規則2条2項3号 \| ✓ / ✗ \| ... \|
91	\| G4 \| 訂正・削除履歴 \| 施行規則5条5項1号イ \| ✓ / ✗ \| ... \|
92	\| G5 \| 相互関連性 \| 施行規則5条5項1号ロ \| ✓ / ✗ \| ... \|
93	\| G6 \| 取引先検索 \| 施行規則5条5項1号ハ \| ✓ / ✗ \| ... \|
94	\| G7 \| 範囲指定検索 \| 施行規則5条5項1号ハ \| ✓ / ✗ \| ... \|
95	\| G8 \| 組合せ検索 \| 施行規則5条5項1号ハ \| ✓ / ✗ \| ... \|
96	```
97
98	不適合項目がある場合は、対応方法を案内する。
99
100	---
101
102	## Step 2: エビデンス出力（任意）
103
104	ユーザーが「詳細を確認」「エビデンスを出力」と依頼した場合に実行する。
105
106	### (a) 帳簿出力
107
108	以下のコマンドで各帳簿を出力し、テーブル形式でユーザーに提示する:
109
110	```bash
111	# 残高試算表
112	shinkoku ledger trial-balance --db-path <db> --fiscal-year <year>
113
114	# 損益計算書
115	shinkoku ledger pl --db-path <db> --fiscal-year <year>
116
117	# 貸借対照表
118	shinkoku ledger bs --db-path <db> --fiscal-year <year>
119
120	# 総勘定元帳（主要科目）
121	shinkoku ledger general-ledger --db-path <db> --fiscal-year <year> --account-code <code>
122	```
123
124	CSV出力も可能であることを案内:
125	```bash
126	# CSV 形式で出力する場合は --format csv を追加
127	shinkoku ledger trial-balance --db-path <db> --fiscal-year <year> --format csv
128	```
129
130	### (b) 監査ログ
131
132	```bash
133	shinkoku ledger audit-log --db-path <db> --fiscal-year <year>
134	```
135
136	変更履歴をテーブル形式で表示する。
137
138	### (c) 検索デモ
139
140	日付範囲・金額範囲・取引先の各検索を実演し、検索機能が正常に動作することを確認する。
141
142	### (d) システム関係書類
143
144	`docs/system-overview.md` の場所を案内する。必要に応じて内容を表示する。
145
146	---
147
148	## Step 3: 結果サマリー & 次のアクション
149
150	### 全要件充足の場合
151
152	```
153	## 診断結果: 全要件適合
154
155	shinkoku は優良な電子帳簿の要件（施行規則第5条第5項）を
156	技術的に充足しています。
157
158	### 次のアクション
159	1. 届出書の提出（未提出の場合）
160	- 「国税関係帳簿の電磁的記録等による保存等に係る届出書」を所轄税務署に提出
161	2. 定期的なバックアップの実施
162	3. 帳簿データの7年間保存の確保
163	```
164
165	### 不足事項がある場合
166
167	不足事項と対応アクションを一覧で表示する。
168
169	### 免責事項
170
171	```
172	> 注記: 本システムは電子帳簿保存法施行規則第5条第5項に定める優良な電子帳簿の
173	> 技術的要件を満たすよう設計されています。令和3年度税制改正により事前承認制度は
174	> 廃止されており、JIIMA認証等の第三者認証は法令上の要件ではありません
175	> （ただし要件充足の確認手段として活用できます）。
176	> 優良な電子帳簿の保存の適用にあたっては、あらかじめ所轄税務署への届出書の
177	> 提出が必要です（電子帳簿保存法第8条第4項）。
178	```
179
180	### 制限事項
181
182	```
183	> 制限事項:
184	> - 監査ログ（journal_audit_log）はアプリケーション層で記録しており、
185	> データベースの直接操作による変更は記録されません。
186	> 改ざん防止のためのデータベーストリガーは今後の対応予定です。
187	> - タイムスタンプは UTC で記録されています（JST への変換は今後対応予定）。
188	> - 操作者情報の記録は個人利用を前提としているため、現在は未実装です。
189	```

People who liked this also viewed

6 picks

Type

e-bookkeeping-compliance

348stars34forks

View on GitHub

How to install e-bookkeeping-compliance?

kazukinagata/shinkoku/e-bookkeeping-compliance

$npx -y skills add kazukinagata/shinkoku --skill e-bookkeeping-compliance

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# 優良な電子帳簿コンプライアンス診断
2
3	税務調査への備え、または優良な電子帳簿の要件充足状況を診断するスキル。
4	電子帳簿保存法施行規則第5条第5項（優良な電子帳簿の要件）に基づき、
5	shinkoku の帳簿データが要件を満たしているかを自動チェックする。
6
7	## 前提知識
8
9	- 電帳法の要件詳細: /tax-ebookkeeping-context を実行する
10	- システム概要書: `docs/system-overview.md`
11
12	---
13
14	## Step 0: 前提確認
15
16	ユーザーに以下を確認する:
17
18	1. DB パス: `--db-path` に使用するデータベースファイルのパス
19	2. 対象年度: `--fiscal-year` に使用する会計年度
20	3. 届出書の提出状況: 「国税関係帳簿の電磁的記録等による保存等に係る届出書」を所轄税務署に提出済みか
21
22	> 届出について: 優良な電子帳簿の保存を適用するには、あらかじめ届出書の提出が必要です。
23	> 令和9年分から適用する場合は、令和8年中に届出書を提出する必要があります。
24	> 届出書の様式は国税庁ウェブサイトからダウンロードできます。
25
26	---
27
28	## Step 1: 自動診断 & サマリー出力
29
30	以下のコマンドを実行してシステムの適合状況を診断する。
31	結果はテーブル形式でユーザーに提示する。
32
33	### チェック項目と実行コマンド
34
35	\| # \| 要件 \| 条文 \| チェック方法 \|
36	\|---\|------\|------\|------------\|
37	\| G1 \| システム関係書類の備付け \| 施行規則2条2項1号 \| `docs/system-overview.md` ファイルの存在を確認 \|
38	\| G2 \| 見読可能性の確保 \| 施行規則2条2項2号 \| `shinkoku ledger trial-balance --db-path <db> --fiscal-year <year>` を実行し、正常出力を確認 \|
39	\| G3 \| ダウンロード対応 \| 施行規則2条2項3号 \| `shinkoku ledger search --db-path <db> --input <params> --format csv` を実行し、CSV出力を確認 \|
40	\| G4 \| 訂正・削除履歴 \| 施行規則5条5項1号イ \| `shinkoku ledger audit-log --db-path <db>` を実行し、テーブルが機能することを確認 \|
41	\| G5 \| 相互関連性の確保 \| 施行規則5条5項1号ロ \| `shinkoku ledger general-ledger --db-path <db> --fiscal-year <year> --account-code <code>` を実行し、仕訳帳⇔総勘定元帳の関連を確認 \|
42	\| G6 \| 取引先検索 \| 施行規則5条5項1号ハ \| `counterparty_contains` パラメータで検索を実行 \|
43	\| G7 \| 日付・金額の範囲指定検索 \| 施行規則5条5項1号ハ \| `date_from`/`date_to`/`amount_min`/`amount_max` パラメータで検索を実行 \|
44	\| G8 \| 組合せ検索 \| 施行規則5条5項1号ハ \| 日付+取引先+金額を組み合わせた検索を実行 \|
45
46	### 診断手順
47
48	1. G1: `docs/system-overview.md` の存在を確認する
49	2. G2: 残高試算表を生成する
50	```bash
51	shinkoku ledger trial-balance --db-path <db> --fiscal-year <year>
52	```
53	3. G3: 仕訳をCSV形式で出力する
54	```bash
55	shinkoku ledger search --db-path <db> --input <params> --format csv
56	```
57	（params には `{"fiscal_year": <year>, "limit": 5}` を指定）
58	4. G4: 監査ログを取得する
59	```bash
60	shinkoku ledger audit-log --db-path <db>
61	```
62	5. G5: 任意の勘定科目で総勘定元帳を出力する（仕訳が存在する科目を使用）
63	```bash
64	shinkoku ledger general-ledger --db-path <db> --fiscal-year <year> --account-code <code>
65	```
66	6. G6-G8: 検索機能のテスト
67	```bash
68	# G6: 取引先検索
69	shinkoku ledger search --db-path <db> --input <params>
70	# params: {"fiscal_year": <year>, "counterparty_contains": "<取引先名の一部>"}
71
72	# G7: 範囲指定検索
73	# params: {"fiscal_year": <year>, "date_from": "<開始日>", "date_to": "<終了日>", "amount_min": 1, "amount_max": 1000000}
74
75	# G8: 組合せ検索
76	# params: {"fiscal_year": <year>, "date_from": "...", "counterparty_contains": "...", "amount_min": 1}
77	```
78
79	### サマリー出力形式
80
81	診断結果を以下のテーブル形式で出力する:
82
83	```
84	## 優良な電子帳簿コンプライアンス診断結果
85
86	\| # \| 要件 \| 条文 \| 結果 \| 備考 \|
87	\|---\|------\|------\|------\|------\|
88	\| G1 \| システム関係書類 \| 施行規則2条2項1号 \| ✓ / ✗ \| ... \|
89	\| G2 \| 見読可能性 \| 施行規則2条2項2号 \| ✓ / ✗ \| ... \|
90	\| G3 \| ダウンロード対応 \| 施行規則2条2項3号 \| ✓ / ✗ \| ... \|
91	\| G4 \| 訂正・削除履歴 \| 施行規則5条5項1号イ \| ✓ / ✗ \| ... \|
92	\| G5 \| 相互関連性 \| 施行規則5条5項1号ロ \| ✓ / ✗ \| ... \|
93	\| G6 \| 取引先検索 \| 施行規則5条5項1号ハ \| ✓ / ✗ \| ... \|
94	\| G7 \| 範囲指定検索 \| 施行規則5条5項1号ハ \| ✓ / ✗ \| ... \|
95	\| G8 \| 組合せ検索 \| 施行規則5条5項1号ハ \| ✓ / ✗ \| ... \|
96	```
97
98	不適合項目がある場合は、対応方法を案内する。
99
100	---
101
102	## Step 2: エビデンス出力（任意）
103
104	ユーザーが「詳細を確認」「エビデンスを出力」と依頼した場合に実行する。
105
106	### (a) 帳簿出力
107
108	以下のコマンドで各帳簿を出力し、テーブル形式でユーザーに提示する:
109
110	```bash
111	# 残高試算表
112	shinkoku ledger trial-balance --db-path <db> --fiscal-year <year>
113
114	# 損益計算書
115	shinkoku ledger pl --db-path <db> --fiscal-year <year>
116
117	# 貸借対照表
118	shinkoku ledger bs --db-path <db> --fiscal-year <year>
119
120	# 総勘定元帳（主要科目）
121	shinkoku ledger general-ledger --db-path <db> --fiscal-year <year> --account-code <code>
122	```
123
124	CSV出力も可能であることを案内:
125	```bash
126	# CSV 形式で出力する場合は --format csv を追加
127	shinkoku ledger trial-balance --db-path <db> --fiscal-year <year> --format csv
128	```
129
130	### (b) 監査ログ
131
132	```bash
133	shinkoku ledger audit-log --db-path <db> --fiscal-year <year>
134	```
135
136	変更履歴をテーブル形式で表示する。
137
138	### (c) 検索デモ
139
140	日付範囲・金額範囲・取引先の各検索を実演し、検索機能が正常に動作することを確認する。
141
142	### (d) システム関係書類
143
144	`docs/system-overview.md` の場所を案内する。必要に応じて内容を表示する。
145
146	---
147
148	## Step 3: 結果サマリー & 次のアクション
149
150	### 全要件充足の場合
151
152	```
153	## 診断結果: 全要件適合
154
155	shinkoku は優良な電子帳簿の要件（施行規則第5条第5項）を
156	技術的に充足しています。
157
158	### 次のアクション
159	1. 届出書の提出（未提出の場合）
160	- 「国税関係帳簿の電磁的記録等による保存等に係る届出書」を所轄税務署に提出
161	2. 定期的なバックアップの実施
162	3. 帳簿データの7年間保存の確保
163	```
164
165	### 不足事項がある場合
166
167	不足事項と対応アクションを一覧で表示する。
168
169	### 免責事項
170
171	```
172	> 注記: 本システムは電子帳簿保存法施行規則第5条第5項に定める優良な電子帳簿の
173	> 技術的要件を満たすよう設計されています。令和3年度税制改正により事前承認制度は
174	> 廃止されており、JIIMA認証等の第三者認証は法令上の要件ではありません
175	> （ただし要件充足の確認手段として活用できます）。
176	> 優良な電子帳簿の保存の適用にあたっては、あらかじめ所轄税務署への届出書の
177	> 提出が必要です（電子帳簿保存法第8条第4項）。
178	```
179
180	### 制限事項
181
182	```
183	> 制限事項:
184	> - 監査ログ（journal_audit_log）はアプリケーション層で記録しており、
185	> データベースの直接操作による変更は記録されません。
186	> 改ざん防止のためのデータベーストリガーは今後の対応予定です。
187	> - タイムスタンプは UTC で記録されています（JST への変換は今後対応予定）。
188	> - 操作者情報の記録は個人利用を前提としているため、現在は未実装です。
189	```

People who liked this also viewed

6 picks

Type