Not tax advice. Computation tools only. Have a professional check your work before filing.
openaccountants/skills/jp-etax-filing.md

Use this skill with your AI agent

View on GitHub

Paste this skill into your AI agent's context, or save the file to your project. Works with any AI agent that reads markdown.

jp-etax-filing.md500 lines19.2 KB
v10Japan
Not yet verified by an accountantContact accountant
1---
2name: jp-etax-filing
3description: >
4 Use this skill whenever asked about filing a Japanese tax return electronically via e-Tax (確定申告書等作成コーナー). Trigger on phrases like "e-Tax", "電子申告", "e-Tax filing", "確定申告書等作成コーナー", "how to file taxes in Japan online", "e-Tax submission", "マイナンバーカード認証", "QR code authentication e-Tax", "blue return financial statements", "決算書入力", "所得税申告書", "consumption tax return filing", "消費税申告書作成", or any question about the step-by-step process of filing income tax or consumption tax returns electronically in Japan. This skill covers the complete e-Tax workflow: authentication, financial statement entry (決算書), income tax return entry (申告書B), consumption tax return entry, and electronic submission. ALWAYS read this skill before assisting with any Japan e-Tax filing work.
5version: 1.0
6jurisdiction: JP
7tax_year: 2025
8category: international
9depends_on:
10 - jp-income-tax
11 - jp-consumption-tax
12---
13 
14# Japan e-Tax Filing (電子申告) -- Self-Employed Skill v1.0
15 
16> **Based on work by [Kazuki Nagata (@kazukinagata)](https://github.com/kazukinagata/shinkoku)**, licensed under MIT. Adapted for the OpenAccountants format.
17 
18---
19 
20## Section 1 -- Quick Reference
21 
22| Field | Value |
23|---|---|
24| Country | Japan (日本) |
25| System | e-Tax (国税電子申告・納税システム) |
26| Portal URL | https://www.keisan.nta.go.jp/ |
27| Portal Name | 確定申告書等作成コーナー (Tax Return Preparation Corner) |
28| Authentication | My Number Card (マイナンバーカード) via smartphone QR code or IC card reader |
29| Tax Authority | National Tax Agency (国税庁 NTA) |
30| Filing Deadline (Income Tax) | 15 March of the following year |
31| Filing Deadline (Consumption Tax) | 31 March of the following year |
32| Contributor | Open Accountants Community |
33| Validated by | Pending -- requires sign-off by a Japanese 税理士 (Zeirishi) |
34| Skill version | 1.0 |
35 
36---
37 
38## Section 2 -- Prerequisites
39 
40Before starting the e-Tax filing process, ensure:
41 
421. **Income tax calculations are complete** -- use the `jp-income-tax` skill to compute all figures
432. **Financial statements (決算書) are prepared** -- P/L (損益計算書) and B/S (貸借対照表) for blue return filers
443. **Consumption tax calculations are complete** (if applicable) -- use the `jp-consumption-tax` skill
454. **Taxpayer profile is ready** -- name, address, My Number (マイナンバー), tax office name, business type, trade name (屋号)
465. **Authentication method is available** -- My Number Card + smartphone with マイナポータル app, or IC card reader
47 
48### Required Documents at Hand
49 
50| Document | Japanese Name | Purpose |
51|---|---|---|
52| My Number Card | マイナンバーカード | Authentication + electronic signature |
53| Withholding certificates | 源泉徴収票 | Employment income data |
54| Payment records | 支払調書 | Business withholding data |
55| Insurance premium certificates | 控除証明書 | Deduction claims |
56| Prior year return (optional) | 前年の確定申告書 | Reference for estimated tax |
57| Bank account details | 口座情報 | Refund account or payment method |
58 
59---
60 
61## Section 3 -- e-Tax Screen Flow Overview
62 
63The 確定申告書等作成コーナー follows this overall flow:
64 
65```
66Step 1: Submission Method Selection (CC-AA-010)
67
68Step 2: Return Type Selection (CC-AE-090)
69
70Step 3: My Number Portal Linkage (CC-AE-600)
71
72Step 4: Pre-submission Confirmation (CC-AA-024)
73
74Step 5: QR Code Authentication (CC-AA-440) ★ Manual step
75
76Step 6: Financial Statements Entry (決算書コーナー)
77 ├── P/L Entry (損益計算書)
78 ├── Blue Return Deduction (青色申告特別控除)
79 ├── B/S Entry (貸借対照表)
80 ├── Income Confirmation (所得確認)
81 └── Address/Name Entry (住所・氏名)
82
83Step 7: Income Tax Return Entry (所得税コーナー)
84 ├── Income Type Selection (所得選択)
85 ├── Income Entry by Type (収入入力)
86 ├── Deductions Entry -- Part 1 (控除入力1/2)
87 ├── Deductions Entry -- Part 2 (控除入力2/2)
88 ├── Calculation Result Confirmation (計算結果確認)
89 ├── Payment Method (納付方法)
90 ├── Resident Tax Settings (住民税)
91 ├── Personal Information (基本情報)
92 └── My Number Entry (マイナンバー)
93
94Step 8: Consumption Tax Return (消費税コーナー) -- if applicable
95 ├── Method Determination (条件判定)
96 ├── Income Category Selection (所得区分選択)
97 ├── Sales Entry (売上入力)
98 └── Calculation Result (計算結果)
99
100Step 9: Electronic Signature & Submission ★ Manual step
101
102Step 10: Data File Save (.data)
103```
104 
105---
106 
107## Section 4 -- Step-by-Step Filing Workflow
108 
109### 4.1 Submission Method Selection (提出方法の選択)
110 
111**Screen: CC-AA-010**
112 
113| Question | Answer |
114|---|---|
115| Do you have a My Number Card (マイナンバーカード)? | Yes (はい) |
116| Do you have a compatible smartphone or IC card reader? | Yes (はい) |
117| Method | Select "Use Smartphone" (スマートフォンを使用する) |
118 
119### 4.2 Return Type Selection (申告書等の選択)
120 
121**Screen: CC-AE-090**
122 
123Select the appropriate return type for the tax year:
124 
125| Option | When to Select |
126|---|---|
127| Income Tax (所得税) | Salary income only, no business income |
128| Financial Statements + Income Tax (決算書・収支内訳書+所得税) | **Self-employed with business income** -- most common |
129| Consumption Tax (消費税) | File separately after income tax |
130| Gift Tax (贈与税) | Gift tax only |
131 
132**For self-employed taxpayers, select "Financial Statements + Income Tax".**
133 
134### 4.3 My Number Portal Linkage
135 
136**Screen: CC-AE-600**
137 
138Select "Do not use My Number Portal linkage" (マイナポータル連携を利用しない) unless you have already configured the linkage.
139 
140### 4.4 Pre-submission Confirmation
141 
142**Screen: CC-AA-024**
143 
144Review the terms of use and click "Agree and proceed" (利用規約に同意して次へ).
145 
146### 4.5 QR Code Authentication (QRコード認証)
147 
148**Screen: CC-AA-440**
149 
150**This requires manual action by the taxpayer:**
151 
1521. A QR code appears on screen
1532. Open the マイナポータル app on your smartphone
1543. Scan the QR code displayed on the computer screen
1554. Authenticate with your My Number Card (hold card to phone's NFC reader)
1565. Enter your 4-digit PIN (利用者証明用電子証明書の暗証番号)
1576. The screen will automatically proceed after successful authentication
158 
159**Troubleshooting:** If the QR code does not display, ensure you are using a supported browser (Chrome or Edge on Windows, Safari on macOS). Linux is not officially supported.
160 
161---
162 
163## Section 5 -- Financial Statements Entry (決算書コーナー)
164 
165This section applies to self-employed taxpayers filing a blue return (青色申告).
166 
167### 5.1 Select Statement Type
168 
169| Option | When to Select |
170|---|---|
171| Blue Return Financial Statements (青色申告決算書) | Blue return filers (most common) |
172| Income/Expense Statement (収支内訳書) | White return filers |
173| Blue Return -- Cash Basis (青色申告決算書・現金主義用) | Cash-basis filers (rare) |
174 
175### 5.2 Profit & Loss Statement (損益計算書) Entry
176 
177Enter the fiscal period (typically January 1 -- December 31) and the following data:
178 
179**Revenue Section:**
180- Monthly sales breakdown (月別売上) -- 12 months
181- Monthly cost of goods sold (月別仕入) -- if applicable
182- Personal consumption (家事消費等)
183- Miscellaneous income (雑収入)
184 
185**Expense Section (経費):**
186 
187| Line | Expense Category | Japanese Name |
188|---|---|---|
189| 8 | Taxes and public charges | 租税公課 |
190| 9 | Packing and shipping | 荷造運賃 |
191| 10 | Utilities | 水道光熱費 |
192| 11 | Travel and transportation | 旅費交通費 |
193| 12 | Communication | 通信費 |
194| 13 | Advertising | 広告宣伝費 |
195| 14 | Entertainment | 接待交際費 |
196| 15 | Insurance | 損害保険料 |
197| 16 | Repairs | 修繕費 |
198| 17 | Consumables | 消耗品費 |
199| 18 | Depreciation | 減価償却費 (sub-form entry) |
200| 19 | Welfare | 福利厚生費 |
201| 20 | Salaries | 給料賃金 (sub-form entry) |
202| 21 | Subcontracting | 外注工賃 |
203| 22 | Interest | 利子割引料 (sub-form entry) |
204| 23 | Rent | 地代家賃 (sub-form entry) |
205| 24 | Bad debts | 貸倒金 |
206| 25 | Tax adviser fees | 税理士等の報酬 |
207| 26-30 | Custom expense categories | 任意科目 |
208| 31 | Miscellaneous | 雑費 |
209 
210### 5.3 Blue Return Special Deduction (青色申告特別控除)
211 
212The system presents a Q&A to determine the deduction amount:
213 
214| Deduction | Conditions |
215|---|---|
216| JPY 650,000 | Double-entry bookkeeping + e-Tax submission (required for this amount) |
217| JPY 550,000 | Double-entry bookkeeping + paper submission |
218| JPY 100,000 | Simplified bookkeeping |
219 
220**If filing via e-Tax and selecting JPY 650,000, the system will verify e-Tax submission is being used. Paper filing with this selection will trigger error KS-E10089.**
221 
222### 5.4 Balance Sheet (貸借対照表) Entry
223 
224Enter opening and closing balances for:
225 
226**Assets (資産の部):**
227Cash, deposits, accounts receivable, securities, inventory, prepayments, buildings, equipment, vehicles, tools/fixtures, land, and custom asset accounts.
228 
229**Liabilities & Equity (負債・資本の部):**
230Notes payable, accounts payable, borrowings, accrued expenses, deposits received, allowance for bad debts, capital (元入金), owner's draws (事業主貸), owner's contributions (事業主借), and pre-deduction income.
231 
232**The system will reject the entry (error KS-E40003) if total assets ≠ total liabilities + equity at year-end.**
233 
234### 5.5 Address and Name Entry (住所・氏名等)
235 
236Enter personal details, business information, and the submitting tax office:
237 
238| Field | Details |
239|---|---|
240| Postal code | 7-digit postal code |
241| Prefecture and address | Full residential address |
242| Business address | If different from home |
243| Tax office | Submitting tax office name (所轄税務署) |
244| Full name | In kanji |
245| Business type | e.g., IT consultant, designer, writer |
246| Trade name (屋号) | If applicable |
247| Submission date | Date of filing |
248 
249---
250 
251## Section 6 -- Income Tax Return Entry (所得税コーナー)
252 
253After completing financial statements, the system transitions to the income tax return.
254 
255### 6.1 Income Type Selection (所得種類の選択)
256 
257Check all applicable income types:
258 
259| Income Type | Japanese | Typical Selection |
260|---|---|---|
261| Employment | 給与 | If also employed |
262| Business (commercial) | 事業(営業等) | **Self-employed: always check** |
263| Business (agriculture) | 事業(農業) | If applicable |
264| Real estate | 不動産 | If rental income |
265| Miscellaneous (business/other) | 雑(業務・その他) | Side income, crypto |
266| Public pension | 公的年金等 | If receiving pension |
267| Retirement | 退職金 | If received |
268| Stocks/dividends | 株式等 | If applicable |
269| Temporary income | 一時 | Insurance payouts, prizes |
270 
271### 6.2 Income Entry by Type
272 
273For each selected income type, enter the relevant data through dedicated sub-forms:
274 
275**Employment income (給与所得):** Enter data from withholding certificates (源泉徴収票) -- payment amount, withheld tax, social insurance premiums, and employer details.
276 
277**Business income (事業所得):** Automatically populated from the financial statements entered in Step 5.
278 
279**Miscellaneous income (雑所得):** Enter revenue, expenses, and payer details for each item.
280 
281### 6.3 Deductions Entry -- Part 1 (支出系控除)
282 
283| Deduction | Japanese | Data Source |
284|---|---|---|
285| Social insurance premiums | 社会保険料控除 | Partially from withholding certificate |
286| Small enterprise mutual aid | 小規模企業共済等掛金控除 | iDeCo, mutual aid contribution certificates |
287| Life insurance premiums | 生命保険料控除 | Insurance premium certificates |
288| Earthquake insurance | 地震保険料控除 | Insurance certificates |
289| Casualty losses | 雑損控除 | If applicable |
290| Medical expenses | 医療費控除 | Medical expense summary |
291| Charitable donations | 寄附金控除 | Furusato nozei + other donation receipts |
292 
293### 6.4 Deductions Entry -- Part 2 (人的控除・住宅控除等)
294 
295| Deduction | Japanese | Notes |
296|---|---|---|
297| Spouse deduction | 配偶者(特別)控除 | Based on spouse's income |
298| Dependent deduction | 扶養控除 | By age category |
299| Widow/single parent | 寡婦・ひとり親控除 | If applicable |
300| Working student | 勤労学生控除 | If applicable |
301| Disability | 障害者控除 | If applicable |
302| Basic deduction | 基礎控除 | Calculated automatically |
303| Housing loan deduction | 住宅借入金等特別控除 | First year requires details |
304| Estimated tax paid | 予定納税額 | If advance payments were made |
305| Loss carryforward | 繰越損失額 | Blue return only, up to 3 years |
306 
307### 6.5 Calculation Result Confirmation (計算結果の確認)
308 
309The system displays the computed tax:
310 
311| Item | What to Verify |
312|---|---|
313| Total income (合計所得金額) | Matches your working paper |
314| Total deductions (所得控除合計) | Matches your calculations |
315| Taxable income (課税所得金額) | Rounded down to nearest JPY 1,000 |
316| Computed tax (算出税額) | Rate table correctly applied |
317| Tax credits | Housing loan, dividend credits |
318| Reconstruction surtax (復興特別所得税) | 2.1% of base income tax |
319| Total tax (所得税及び復興特別所得税) | Sum of income tax + reconstruction tax |
320| Withholding credits (源泉徴収税額) | All withholding properly credited |
321| Tax due or refund (申告納税額/還付) | Final amount to pay or receive |
322 
323**Cross-check all figures against your income tax working paper. Any discrepancy should be investigated before proceeding.**
324 
325### 6.6 Payment Method (納付方法)
326 
327If tax is due:
328 
329| Method | Japanese | Notes |
330|---|---|---|
331| Account transfer | 振替納税 | Auto-debit from bank account |
332| Electronic payment | 電子納税 | Direct debit or internet banking |
333| Credit card | クレジットカード納付 | Fee applies |
334| Convenience store | コンビニ納付 | For amounts under JPY 300,000 |
335| Bank counter | 金融機関等での窓口納付 | Traditional method |
336 
337If a refund is due, enter bank account details (bank name, branch, account number, account holder).
338 
339### 6.7 Personal Information & My Number
340 
341Enter personal details (name in kana and kanji, phone number, address, tax office, occupation, trade name) and your 12-digit My Number (マイナンバー). The system validates the check digit.
342 
343---
344 
345## Section 7 -- Consumption Tax Return (消費税コーナー)
346 
347If you are a taxable business (課税事業者) for consumption tax, file the consumption tax return after completing the income tax return.
348 
349### 7.1 Method Determination (条件判定)
350 
351| Field | What to Enter |
352|---|---|
353| Base period taxable sales (基準期間の課税売上高) | Sales from 2 years prior |
354| Qualified invoice issuer (インボイス発行事業者) | Yes/No |
355| Simplified taxation elected (簡易課税) | Yes/No |
356| Accounting method | Tax-inclusive (税込) or tax-exclusive (税抜) |
357 
358The system determines which computation route to use:
359 
360| Condition | Route |
361|---|---|
362| Invoice registrant + 20% special measure elected | 2割特例 route |
363| Simplified taxation elected + base sales ≤ JPY 50M | 簡易課税 route |
364| All other cases | 本則課税 (general) route |
365 
366### 7.2 Sales Entry
367 
368Enter total sales broken down by:
369- Taxable sales amount (tax-inclusive total)
370- Reduced rate (8%) portion (軽減税率適用分)
371- Tax-exempt sales (免税売上)
372- Non-taxable sales (非課税売上)
373- Returns/allowances by rate category
374 
375### 7.3 Calculation Result (計算結果)
376 
377The system displays:
378 
379| Item | Description |
380|---|---|
381| Taxable base amount (課税標準額) | Sales ÷ 1.10 (or 1.08), rounded down to JPY 1,000 |
382| National consumption tax (消費税額) | Base × 7.8% (standard) or 6.24% (reduced) |
383| Input tax credit (控除税額) | Varies by method |
384| Differential tax (差引税額) | Output tax − input tax credit, rounded down to JPY 100 |
385| Local consumption tax (地方消費税) | Differential × 22/78, rounded down to JPY 100 |
386| Total tax due (合計納付税額) | National + local |
387 
388### 7.4 Taxpayer Information
389 
390Enter address, tax office, name, My Number, and payment method for the consumption tax return.
391 
392---
393 
394## Section 8 -- Electronic Signature and Submission
395 
396### 8.1 Save Input Data (Strongly Recommended)
397 
398Before submitting, save input data as a `.data` file using the "Save input data" (入力データの一時保存) button. This file allows you to:
399- Resume filing if interrupted
400- Reference data for next year's return
401- Restore data if a correction filing (修正申告) is needed
402 
403### 8.2 Electronic Signature
404 
405Sign the return electronically using your My Number Card:
4061. Enter your signature PIN (署名用パスワード -- 6-16 alphanumeric characters)
4072. Hold your My Number Card to the smartphone's NFC reader
4083. Wait for confirmation
409 
410### 8.3 Submission
411 
412**Review the final confirmation page carefully before submitting.**
413 
414After confirming all figures are correct, click the submit button. Record the receipt number (受付番号) displayed after successful submission.
415 
416### 8.4 Post-Submission
417 
4181. **Save the post-submission `.data` file** -- it contains the receipt number and submission timestamp
4192. **Check your e-Tax message box** for the receipt notification (受信通知)
4203. **If consumption tax return is pending**, proceed to file it after the income tax submission
4214. **Note payment deadlines:** Income tax by March 15, consumption tax by March 31
422 
423---
424 
425## Section 9 -- Common Errors and Troubleshooting
426 
427| Error Code | Description | Resolution |
428|---|---|---|
429| KS-E10089 | e-Tax submission required for JPY 650,000 deduction | Must submit electronically, not on paper |
430| KS-E10001 | Required field missing | Check all mandatory fields are filled |
431| KS-E40003 | Balance sheet does not balance | Verify total assets = total liabilities + equity |
432| KS-W10035 | Print confirmation | Acknowledge with OK to proceed |
433| KS-W90011 | Data will be reset | Acknowledge with OK if intentional |
434 
435### QR Code Not Displaying
436 
437If the QR code does not appear on the authentication screen:
438- Ensure you are using a supported browser (Chrome/Edge on Windows, Safari on macOS)
439- Linux is not officially supported by the NTA
440- Try refreshing the page
441 
442### Authentication Failures
443 
444- Ensure the My Number Card is not expired
445- Check that the correct PIN is being used (4-digit user authentication PIN, not the 6-16 digit signature PIN)
446- Hold the card steady against the phone's NFC reader for several seconds
447 
448---
449 
450## Section 10 -- Key Deadlines and Calendar
451 
452| Item | Deadline | Notes |
453|---|---|---|
454| Income tax filing | March 15 | 確定申告 deadline |
455| Income tax payment | March 15 | Same as filing |
456| Consumption tax filing | March 31 | Sole proprietors |
457| Consumption tax payment | March 31 | Same as filing |
458| Account transfer (振替納税) date | Late April (income tax), late April (consumption tax) | Exact date announced annually |
459| Estimated tax 1st instalment | July 31 | If prior year tax > JPY 150,000 |
460| Estimated tax 2nd instalment | November 30 | If prior year tax > JPY 150,000 |
461 
462---
463 
464## Section 11 -- Data File Management
465 
466### The `.data` File
467 
468The 確定申告書等作成コーナー allows saving and loading `.data` files at any point during the process.
469 
470| Action | When to Use |
471|---|---|
472| Save during entry | To create a checkpoint before complex sections |
473| Save before submission | To preserve a pre-submission backup |
474| Save after submission | To preserve receipt number and submission details |
475| Load saved data | To resume from a previous session via "保存データを利用して作成" |
476 
477**Best practice:** Save `.data` files at three points: (1) after completing financial statements, (2) before electronic submission, and (3) after successful submission.
478 
479---
480 
481## PROHIBITIONS
482 
483- NEVER submit a tax return without the taxpayer's explicit confirmation of all figures
484- NEVER enter the electronic signature PIN -- this must be done by the taxpayer personally
485- NEVER click the final submission button -- this must be done by the taxpayer personally
486- NEVER select the JPY 650,000 blue return deduction for paper filing (will cause error KS-E10089)
487- NEVER skip the balance sheet balance check -- assets must equal liabilities + equity
488- NEVER proceed past the QR code authentication step without confirmation that authentication succeeded
489- NEVER present e-Tax filing as a substitute for professional review -- all returns should be reviewed by a 税理士
490 
491---
492 
493## Disclaimer
494 
495This skill and its outputs are provided for informational and computational purposes only and do not constitute tax, legal, or financial advice. Open Accountants and its contributors accept no liability for any errors, omissions, or outcomes arising from the use of this skill. All outputs must be reviewed and signed off by a qualified professional (such as a 税理士 or equivalent licensed practitioner in Japan) before filing or acting upon.
496 
497The 確定申告書等作成コーナー screen layout and form fields are maintained by the National Tax Agency and may change without notice. Always verify against the live system.
498 
499The most up-to-date, verified version of this skill is maintained at [openaccountants.com](https://openaccountants.com). Log in to access the latest version, request a professional review from a licensed accountant, and track updates as tax law changes.
500 

Run this skill, then get an accountant to check it

After running the full skill pack in Claude, sign up and upload your worksheet. We'll connect you with a trusted accountant in our network who can review your numbers before you file.

Discussions(0)

No discussions yet. Verified accountants can post questions about this skill.

Quality

Q2: Research-verified

Deep research against tax authority sources. Not yet tested on real data.

Needs real client data + practitioner sign-off to reach Q1.

Accountant Review

Unverified
0/44

About

Use this skill whenever asked about filing a Japanese tax return electronically via e-Tax (確定申告書等作成コーナー). Trigger on phrases like "e-Tax", "電子申告", "e-Tax filing", "確定申告書等作成コーナー", "how to file taxes in Japan online", "e-Tax submission", "マイナンバーカード認証", "QR code authentication e-Tax", "blue return financial statements", "決算書入力", "所得税申告書", "consumption tax return filing", "消費税申告書作成", or any question about the step-by-step process of filing income tax or consumption tax returns electronically in Japan. This skill covers the complete e-Tax workflow: authentication, financial statement entry (決算書), income tax return entry (申告書B), consumption tax return entry, and electronic submission. ALWAYS read this skill before assisting with any Japan e-Tax filing work.

JPty-2025

Use this skill

This skill is open source and free to use in any AI agent. Copy it, download it, or clone the repo. If you find an error, flag it — a licensed accountant will review.

3 of 4 in the JP workflow: