Japan tax rules by date: invoice tax, tax rates, withholding, stamp duty, deadlines, rule changes
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Return the date N Japanese business days after (or before, if N is negative) a start date; the start date itself is never counted. Same calendars as jp_business_days_between (national holidays from the Cabinet Office CSV; "bank" also skips Dec 31–Jan 3). Use it for "5営業日後" style deadlines. N must be a non-zero integer from -400 to 400.
何営業日後か。負の数なら前。0 は不可
始めの日(YYYY-MM-DD)。この日は数えない
national=土日と国民の祝日・休日を休み(既定)。bank=それに加えて 12/31〜1/3 も休み(銀行の休日)
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http japan-tax-rules https://tax.cyclixagents.com/mcp
Return the date N Japanese business days after (or before, if N is negative) a start date; the start date itself is never counted. Same calendars as jp_business_days_between (national holidays from the Cabinet Office CSV; "bank" also skips Dec 31–Jan 3). Use it for "5営業日後" style deadlines. N must be a non-zero integer from -400 to 400.
| Argument | Type | Description |
|---|---|---|
| days* | integer | 何営業日後か。負の数なら前。0 は不可 |
| start* | string | 始めの日(YYYY-MM-DD)。この日は数えない |
| calendar | string | national=土日と国民の祝日・休日を休み(既定)。bank=それに加えて 12/31〜1/3 も休み(銀行の休日) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start",
"days"
],
"properties": {
"days": {
"type": "integer",
"maximum": 400,
"minimum": -400,
"description": "何営業日後か。負の数なら前。0 は不可"
},
"start": {
"type": "string",
"maxLength": 10,
"description": "始めの日(YYYY-MM-DD)。この日は数えない"
},
"calendar": {
"enum": [
"national",
"bank"
],
"type": "string",
"description": "national=土日と国民の祝日・休日を休み(既定)。bank=それに加えて 12/31〜1/3 も休み(銀行の休日)"
}
},
"additionalProperties": false
}Count Japanese business days (営業日) between two dates, skipping Saturdays, Sundays and the official Japanese holidays from the Cabinet Office CSV. Calendar "bank" also skips Dec 31–Jan 3 (銀行の休日, 銀行法施行令 第5条). By default the start date is not counted and the end date is counted. It is meant for deadlines, payment terms (支払期日), delivery dates and "how many 営業日" questions. At most 1,100 days apart; dates outside the holiday data (currently up to 2027-12-31) return an error.
| Argument | Type | Description |
|---|---|---|
| end* | string | 終わりの日(YYYY-MM-DD) |
| start* | string | 始めの日(YYYY-MM-DD) |
| calendar | string | national=土日と国民の祝日・休日を休み(既定)。bank=それに加えて 12/31〜1/3 も休み(銀行の休日) |
| count_end | boolean | 終わりの日を数えるか(既定 true) |
| count_start | boolean | 始めの日を数えるか(既定 false) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"maxLength": 10,
"description": "終わりの日(YYYY-MM-DD)"
},
"start": {
"type": "string",
"maxLength": 10,
"description": "始めの日(YYYY-MM-DD)"
},
"calendar": {
"enum": [
"national",
"bank"
],
"type": "string",
"description": "national=土日と国民の祝日・休日を休み(既定)。bank=それに加えて 12/31〜1/3 も休み(銀行の休日)"
},
"count_end": {
"type": "boolean",
"description": "終わりの日を数えるか(既定 true)"
},
"count_start": {
"type": "boolean",
"description": "始めの日を数えるか(既定 false)"
}
},
"additionalProperties": false
}Convert between Gregorian dates and Japanese era dates (和暦: 昭和 Showa, 平成 Heisei, 令和 Reiwa), handling the exact switch days (昭和 began 1926-12-25, 平成 began 1989-01-08, 令和 began 2019-05-01) and 元年 (first year). Use it when filling Japanese forms, contracts or documents that require 和暦, or when reading a 和暦 date. Modes: {to:"wareki", date:"YYYY-MM-DD"}; {to:"seireki", era, year, month, day}; {to:"wareki", year_only} (lists every era in that year). A 平成 date after 2019-04-30 (e.g. 平成31年5月1日) is read as that day and the correct 令和 form is returned with a note; a Showa date from 1989-01-08 on (e.g. 昭和64年1月8日, Showa 64-01-08), dates that do not exist, and dates before 1926-12-25 return an error.
| Argument | Type | Description |
|---|---|---|
| to* | string | wareki=西暦から和暦へ、seireki=和暦から西暦へ |
| day | integer | |
| era | string | to が seireki の時の元号 |
| date | string | to が wareki の時の西暦の日(YYYY-MM-DD) |
| year | integer | 元号の年(元年は 1) |
| month | integer | |
| year_only | integer | to が wareki で、年だけ変える時の西暦の年 |
List the usual deadlines for a sole proprietor in Japan for one year, from National Tax Agency pages: the opening notice (開業届, due by the income-tax return deadline of the opening year), the blue-return application (青色申告承認申請: March 15, or within 2 months of opening when the business started on or after January 16), the income-tax return (March 15 of the next year), the consumption-tax return for individuals (March 31), the two estimated-tax installments (予定納税: July 31, November 30) and the special withholding-tax payment dates (納期の特例: July 10, January 20). Each date is moved to the next day when it falls on a weekend, national holiday, December 29–31 or January 1–3 (国税通則法 第10条第2項). Give the year and/or the opening date; each item says when it applies, and the caller decides which apply. For a business opened before 2026-01-01 the opening-notice deadline is not given (the article changed on that day). Years are accepted up to one year before the end of the holiday data.
| Argument | Type | Description |
|---|---|---|
| year | integer | 何年分か(西暦・今は 2026 年分まで)。省くと開業の日の年 |
| business_start_date | string | 開業の日(YYYY-MM-DD)。入れると開業届・青色申告承認申請の期限も出す |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"year": {
"type": "integer",
"maximum": 2026,
"minimum": 1955,
"description": "何年分か(西暦・今は 2026 年分まで)。省くと開業の日の年"
},
"business_start_date": {
"type": "string",
"maxLength": 10,
"description": "開業の日(YYYY-MM-DD)。入れると開業届・青色申告承認申請の期限も出す"
}
},
"additionalProperties": false
}List Japanese national holidays (国民の祝日) and official substitute/citizens' holidays (振替休日・国民の休日, shown as 「休日」) between two dates, or check one date, using the Cabinet Office (内閣府) official CSV. The dates come from the published CSV only, including 春分の日/秋分の日, substitute holidays and one-off holidays. Give either `date`, or `from` and `to` (at most 1,100 days apart). Returns an error for dates outside the published data (currently 1955-01-01 to 2027-12-31) instead of guessing.
| Argument | Type | Description |
|---|---|---|
| to | string | 一覧の終わり(YYYY-MM-DD) |
| date | string | 1日だけ確かめる時(YYYY-MM-DD) |
| from | string | 一覧の始め(YYYY-MM-DD) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": "string",
"maxLength": 10,
"description": "一覧の終わり(YYYY-MM-DD)"
},
"date": {
"type": "string",
"maxLength": 10,
"description": "1日だけ確かめる時(YYYY-MM-DD)"
},
"from": {
"type": "string",
"maxLength": 10,
"description": "一覧の始め(YYYY-MM-DD)"
}
},
"additionalProperties": false
}Work out the amounts on a Japanese invoice in one call by combining the other Tax Compass calculations: subtotal, consumption tax rounded once per tax rate (国税庁 Q&A 問57), withholding tax on item-1 fees paid to a resident individual (No.2795; on the tax-excluded fee when the consumption tax (or its equivalent) is stated separately on the invoice, which the NTA allows also for issuers not registered for the invoice system; otherwise on the tax-included amount), the transfer amount (振込額), the payment due dates under 取適法 if terms are given, and a check of numbers already written on the invoice. For an issuer not registered for the invoice system (免税事業者) it adds the NTA Q&A 問26-2 notes on what such an invoice may and may not show. Whether a fee is subject to withholding and which tax rate applies are chosen by the caller.
| Argument | Type | Description |
|---|---|---|
| lines* | array | |
| stated | object | 請求書に書いた数(検算する時。書いてある物だけ入れる) |
| rounding* | string | 1円未満の処理。切り捨て・四捨五入・切り上げ |
| price_basis* | string | 行の金額が税抜(tax_excluded)か税込(tax_included)か。1枚の中ではどちらかに揃える |
| withholding | object | 日本に住む個人に払う第1号の報酬として源泉徴収する時だけ入れる |
| payment_terms | object | 支払期日もまとめて出す時(jp_payment_due_date と同じ入力) |
Calculate Japanese consumption tax on a qualified invoice (適格請求書 / インボイス) the way Japan's National Tax Agency requires: sum the lines per tax rate (10% standard, 8% reduced, and 1% for food sold 2027-04-01 to 2029-03-31 — that 1% rate is still a bill in the Diet, so give each 1% line its transaction date and the answer marks it rule_status bill), then round the tax ONCE per rate per invoice — never per line. It applies to writing, checking or explaining a Japanese invoice, receipt (適格簡易請求書) or delivery note total (納品書), and to questions about why per-item tax (消費税 端数処理) adds up differently. It calculates one invoice from a single issuer; when one document carries invoices of several businesses, the agency-delivery case (代理交付) must be rounded per business and per rate. Rounding direction (切り捨て floor / 四捨五入 round_half_up / 切り上げ ceil) is the issuer's choice. All lines of one invoice must use the same price basis (税抜 or 税込). Returns per-rate totals, the correct tax, and what per-line rounding would have given, with NTA sources. It does not check other invoice requirements such as the registration number.
| Argument | Type | Description |
|---|---|---|
| lines* | array | |
| rounding* | string | 1円未満の処理。切り捨て・四捨五入・切り上げ |
| price_basis* | string | 行の金額が税抜(tax_excluded)か税込(tax_included)か。1枚の中ではどちらかに揃える |
| transaction_date | string | 取引(譲渡)の日 YYYY-MM-DD。行に date が無い時に使う。税率 1 の行には、どちらかの日が要る |
Compute payment-term dates under Japan's 中小受託取引適正化法 (取適法, in force from 2026-01-01, formerly the 下請法) Article 3, using the JFTC text: the 60th day counted with the receipt date as day 1, the deemed due dates (receipt date if no due date was set; the 60th day if it was set later), and for an agreed due date or a monthly cut-off rule (締め日・支払月・支払日) the payment date, its day number and whether it is within 60 days. For a monthly rule only (the two-month treatment applies to monthly cut-off rules, not to an agreed due date) it also gives the last day of the JFTC's two-month treatment (受領後2か月以内) and whether the payment is within it, and whether the payment date is a bank holiday and the postponement fits the JFTC's conditions. Special cut-off rules for continuously provided services are not covered. It does not decide whether the act applies to a transaction. Dates must be within the holiday data (currently up to 2027-12-31).
| Argument | Type | Description |
|---|---|---|
| monthly | object | 月単位の締切制度(例:末日締め翌月末日払い=cutoff_day "end"・pay_month_offset 1・pay_day "end") |
| received_on* | string | 給付を受領した日(役務は提供を受けた日。日数がかかる役務は終わった日)YYYY-MM-DD |
| agreed_due_date | string | 決めた支払期日(YYYY-MM-DD)。monthly と一緒には使わない |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"received_on"
],
"properties": {
"monthly": {
"type": "object",
"required": [
"cutoff_day",
"pay_month_offset",
"pay_day"
],
"properties": {
"pay_day": {
"anyOf": [
{
"type": "integer",
"maximum": 28,
"minimum": 1
},
{
"enum": [
"end"
],
"type": "string"
}
],
"description": "支払日(1〜28 か \"end\"=末日)"
},
"cutoff_day": {
"anyOf": [
{
"type": "integer",
"maximum": 28,
"minimum": 1
},
{
"enum": [
"end"
],
"type": "string"
}
],
"description": "締め日(1〜28 か \"end\"=末日)"
},
"pay_month_offset": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "締めた月から何か月後に払うか(0=当月・1=翌月・2=翌々月)"
}
},
"description": "月単位の締切制度(例:末日締め翌月末日払い=cutoff_day \"end\"・pay_month_offset 1・pay_day \"end\")",
"additionalProperties": false
},
"received_on": {
"type": "string",
"maxLength": 10,
"description": "給付を受領した日(役務は提供を受けた日。日数がかかる役務は終わった日)YYYY-MM-DD"
},
"agreed_due_date": {
"type": "string",
"maxLength": 10,
"description": "決めた支払期日(YYYY-MM-DD)。monthly と一緒には使わない"
}
},
"additionalProperties": false
}Upcoming (and in-progress) changes to Japanese business rules in date order — consumption tax (the proposed 1% food rate, still a bill), invoice transitional credit steps (80→70→50→30→0%), the 2割/3割 special rules, income tax basic deduction, withholding tables, the defense special income tax, minimum wage, employment insurance rates, the child-support levy, the working-pension threshold and the departure tax. Each item has effective dates, a status (in_force / enacted / bill / planned) computed against today, a one-line summary in Japanese, the official source URL and the date Cyclix Agents checked it, and the Tax Compass tool that calculates it if there is one. Filter by as_of (list items that start on or after it, or are still in effect on it — a change with no end date stays in effect), until, areas and statuses. Only items whose numbers were checked against the official source are listed; it is not a complete list of all law changes.
| Argument | Type | Description |
|---|---|---|
| areas | array | 分野で絞る(省くと全部) |
| as_of | string | この日以後に始まる変更と、この日に当てはまっている変更(終わりの日が無い物を含む)を出す YYYY-MM-DD。省くと今日(日本時間) |
| until | string | この日までに始まる変更だけ YYYY-MM-DD(省くと全部) |
| statuses | array | 状態で絞る(省くと全部)。bill は国会で未成立 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"areas": {
"type": "array",
"items": {
"enum": [
"consumption_tax",
"invoice",
"withholding",
"income_tax",
"social_insurance",
"labor",
"pension",
"other"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1,
"description": "分野で絞る(省くと全部)"
},
"as_of": {
"type": "string",
"maxLength": 10,
"description": "この日以後に始まる変更と、この日に当てはまっている変更(終わりの日が無い物を含む)を出す YYYY-MM-DD。省くと今日(日本時間)"
},
"until": {
"type": "string",
"maxLength": 10,
"description": "この日までに始まる変更だけ YYYY-MM-DD(省くと全部)"
},
"statuses": {
"type": "array",
"items": {
"enum": [
"in_force",
"enacted",
"bill",
"planned"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"description": "状態で絞る(省くと全部)。bill は国会で未成立"
}
},
"additionalProperties": false
}Look up Japanese stamp duty (印紙税) for a paper receipt for sales proceeds (領収書, 第17号の1 売上代金の受取書), a real-estate transfer contract (不動産売買契約書, 第1号の1) or a contract for work (請負契約書, 第2号), including the reduced rates for real-estate transfer and construction contracts made from 2014-04-01 to 2027-03-31. It looks up the amount in the NTA table for the document type the caller specifies (e.g. receipts under ¥50,000 are non-taxable); which document type a document is, is chosen by the caller (the user). `amount` is the tax-inclusive total written on the document (pass null when no amount is written; omitting it is an error); when consumption tax is stated separately (or both tax-inclusive and tax-exclusive prices are written), set consumption_tax_separately_stated with consumption_tax_amount, or pass amount_excluding_consumption_tax (with consumption_tax_separately_stated: true) instead of amount — consumption tax is then excluded, as the NTA circular says. Per NTA No.7108, a contract based on a construction contract that also lists design or other work is treated as a whole as a construction contract. Based on National Tax Agency tables (laws as of 2026-04-01). It does not decide which document number a document falls under, and does not cover other document types or electronic documents.
| Argument | Type | Description |
|---|---|---|
| amount | any | 書類の金額(円・消費税額等を含めた税込の合計)。消費税を区分して書いている時も税込の合計を入れる。金額を書いていないなら null を明示する(渡さないと誤り)。amount_excluding_consumption_tax とどちらか片方だけ |
| created_on | string | 書類を作った日(YYYY-MM-DD)。無ければ今日(日本の日付) |
| document_type* | string | 呼ぶ側(利用者)が選ぶ書類の種類。receipt=売上代金の領収書(第17号の1)、real_estate_transfer_contract=不動産の譲渡の契約書(第1号の1)、construction_contract=建設工事の請負(第2号。建設工事の契約に基づく書類なら、設計など建設工事以外の事を一緒に書いていても全体がこれ)、other_work_contract=建設工事以外の請負(第2号) |
Japanese income tax basic deduction (基礎控除) for a given year (年分, 2025–2030), with the table by total income (合計所得金額) and, optionally, the deduction for one total income. The 2026 tax reform (enacted 2026-03-31, in force 2026-12-01) raised it: for 2026 and 2027 it is ¥1,040,000 up to ¥4.89 million of total income, ¥670,000 up to ¥6.55 million, ¥620,000 up to ¥23.5 million, then 480k/320k/160k/0; from 2028 it is ¥990,000 up to ¥1.32 million and ¥620,000 above. 2025 is the earlier table (95/88/68/63/58万円). Also returns the minimum employment income deduction (給与所得控除の最低保障: 65万 / 74万 / 69万) and the income line for dependants (扶養親族の所得要件 58万 → 62万), and the salary-only income tax line (年収の壁 160万 → 178万 → 168万円). The extra amount on top of ¥620,000 applies to residents only. Income tax only — not resident tax or social insurance.
| Argument | Type | Description |
|---|---|---|
| year | integer | 年分(西暦 2025〜2030)。例:令和8年分=2026。省くと as_of の年 |
| as_of | string | year を省く時の日 YYYY-MM-DD(その年分)。両方省くと今日(日本時間) |
| resident | boolean | 居住者か(省くと true)。非居住者は上乗せ(措法41の16の2)が無い |
| total_income | integer | 合計所得金額(円)。年収(収入)ではない。入れるとその人の基礎控除の額を返す |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2025,
"description": "年分(西暦 2025〜2030)。例:令和8年分=2026。省くと as_of の年"
},
"as_of": {
"type": "string",
"maxLength": 10,
"description": "year を省く時の日 YYYY-MM-DD(その年分)。両方省くと今日(日本時間)"
},
"resident": {
"type": "boolean",
"description": "居住者か(省くと true)。非居住者は上乗せ(措法41の16の2)が無い"
},
"total_income": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0,
"description": "合計所得金額(円)。年収(収入)ではない。入れるとその人の基礎控除の額を返す"
}
},
"additionalProperties": false
}Look up the Japanese consumption tax rate (消費税率) that applies on a given date (as_of = the date of the sale) for a category the caller chooses: standard (10%: dining out 外食, alcohol 酒類 and most goods), reduced_food (8% reduced rate for food and drinks 飲食料品) or newspaper (8% for subscription newspapers issued twice a week or more). It answers with the rate under the law now in force, its national/local split, and a separate pending_change for the proposed 1% food rate for sales from 2027-04-01 to 2029-03-31 (消費税 1% いつから) — that cut is still a bill in the Diet (it had not been enacted when checked on 2026-11-21), so it is marked rule_status bill and answer_is_final false, never as the confirmed rate. Use it for questions such as 'what is the consumption tax rate on date X'. Dates from 2019-10-01 to 2031-12-31.
| Argument | Type | Description |
|---|---|---|
| as_of | string | 取引(譲渡)の日 YYYY-MM-DD。省くと今日(日本時間) |
| category* | string | standard=標準税率(外食・酒類・ほとんどの物)、reduced_food=軽減税率の飲食料品、newspaper=週2回以上発行の新聞の定期購読。どれにあたるかは呼ぶ側(利用者)が選ぶ |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"category"
],
"properties": {
"as_of": {
"type": "string",
"maxLength": 10,
"description": "取引(譲渡)の日 YYYY-MM-DD。省くと今日(日本時間)"
},
"category": {
"enum": [
"standard",
"reduced_food",
"newspaper"
],
"type": "string",
"description": "standard=標準税率(外食・酒類・ほとんどの物)、reduced_food=軽減税率の飲食料品、newspaper=週2回以上発行の新聞の定期購読。どれにあたるかは呼ぶ側(利用者)が選ぶ"
}
},
"additionalProperties": false
}Japanese invoice system (インボイス) transitional measure (経過措置): how much of the deemed input consumption tax on a purchase from a tax-exempt business or a consumer (免税事業者等からの課税仕入れ) may still be credited on a given purchase date — 80% until 2026-09-30, 70% from 2026-10-01 to 2028-09-30, 50% to 2030-09-30, 30% to 2031-09-30, then 0% (2割控除・7割控除 いつから). The percentage follows the date of the purchase (services: the day the whole service is completed; goods: the day of delivery). With an optional tax-included amount it also computes the deemed creditable amount: amount × 7.8/110 (reduced rate: 6.24/108) × percent, rounded once (NTA invoice Q&A 問130). Amended by the 2026 tax reform law enacted 2026-03-31. Dates from 2023-10-01 to 2031-12-31.
| Argument | Type | Description |
|---|---|---|
| rate | string | その仕入れの税率 %(省くと 10)。8 は軽減税率。どちらかは呼ぶ側(利用者)が選ぶ |
| as_of | string | 課税仕入れの日 YYYY-MM-DD(役務は全部が完了した日・商品は引渡しの日)。省くと今日(日本時間) |
| amount | integer | 免税事業者等に払った対価の額(税込・円)。入れると控除できる額も計算する |
| rounding | string | 1円未満の処理(省くと切り捨て)。問130 は切捨て又は四捨五入 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"rate": {
"enum": [
"8",
"10"
],
"type": "string",
"description": "その仕入れの税率 %(省くと 10)。8 は軽減税率。どちらかは呼ぶ側(利用者)が選ぶ"
},
"as_of": {
"type": "string",
"maxLength": 10,
"description": "課税仕入れの日 YYYY-MM-DD(役務は全部が完了した日・商品は引渡しの日)。省くと今日(日本時間)"
},
"amount": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0,
"description": "免税事業者等に払った対価の額(税込・円)。入れると控除できる額も計算する"
},
"rounding": {
"enum": [
"floor",
"round_half_up"
],
"type": "string",
"description": "1円未満の処理(省くと切り捨て)。問130 は切捨て又は四捨五入"
}
},
"additionalProperties": false
}Japanese consumption tax special rules for small businesses that became taxable because they registered for invoices: the 2割特例 (pay 20% of output tax) applies to each taxable period that contains any day from 2023-10-01 to 2026-09-30, and the new 3割特例 (pay 30% of output tax, individuals only) applies to the 2027 and 2028 calendar years. Give a date and the taxpayer type (individual = calendar year; corporation = give the business year start and end) and it says whether that taxable period is inside each window. It only checks the period; whether the other conditions are met (base-period sales of ¥10 million or less, not taxable anyway, etc.) is for the caller to decide. From the 2026 tax reform law enacted 2026-03-31 (NTA invoice Q&A 問114, 114-2).
| Argument | Type | Description |
|---|---|---|
| as_of | string | 課税期間に含まれる日 YYYY-MM-DD(2023-10-01〜2031-12-31。法人の課税期間が 2023-10-01 より前に始まる時はその初日から)。省くと今日(日本時間) |
| period_end | string | 法人の課税期間(事業年度)の末日 YYYY-MM-DD |
| period_start | string | 法人の課税期間(事業年度)の初日 YYYY-MM-DD |
| taxpayer_type* | string | individual=個人事業者(課税期間は暦年)、corporation=法人 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"taxpayer_type"
],
"properties": {
"as_of": {
"type": "string",
"maxLength": 10,
"description": "課税期間に含まれる日 YYYY-MM-DD(2023-10-01〜2031-12-31。法人の課税期間が 2023-10-01 より前に始まる時はその初日から)。省くと今日(日本時間)"
},
"period_end": {
"type": "string",
"maxLength": 10,
"description": "法人の課税期間(事業年度)の末日 YYYY-MM-DD"
},
"period_start": {
"type": "string",
"maxLength": 10,
"description": "法人の課税期間(事業年度)の初日 YYYY-MM-DD"
},
"taxpayer_type": {
"enum": [
"individual",
"corporation"
],
"type": "string",
"description": "individual=個人事業者(課税期間は暦年)、corporation=法人"
}
},
"additionalProperties": false
}Calculate Japanese withholding income tax (源泉徴収税額, including the special reconstruction surtax / from 2027 the defense surtax) on fees paid to a RESIDENT INDIVIDUAL for manuscripts, lectures, design, illustration, photos for print, translation and similar work (所得税法 第204条第1項第1号 fees). Formula: up to ¥1,000,000 → 10.21%; above → (amount − 1,000,000) × 20.42% + 102,100; yen fractions are dropped. Use it when drafting or checking a Japanese freelance invoice or payment (請求書の源泉徴収・手取り). Handles consumption tax shown separately on the invoice. Does NOT cover lawyers, tax accountants, judicial scriveners (司法書士) and other item-2 professionals, sales agents (外交員), hostesses, prizes, corporations or non-residents — corporations and non-residents return an error. It does not judge whether a payment is such a fee.
| Argument | Type | Description |
|---|---|---|
| amount* | integer | 1回に払う報酬(円)。消費税を区分して書いているならその消費税を含めた請求の額 |
| fee_kind* | string | 第1号の報酬の種類(呼ぶ側=利用者が選ぶ):原稿料・講演料・デザイン料・イラスト・印刷物に載せる写真・翻訳・その他の第1号。計算は同じ |
| payee_type* | string | 受け取る人(呼ぶ側=利用者が選ぶ)。resident_individual=日本に住む個人(これだけ計算する。corporation・non_resident は対象外の誤りを返す) |
| income_date | string | その報酬の所得が生ずる日(YYYY-MM-DD・ふつうは仕事を終えた日)。払う日ではない。2027年からの内訳の注意書きを変えるためだけに使い、税額は変わらない |
| consumption_tax_amount | integer | 請求書に区分して書いた消費税の額(上が true の時だけ) |
Count the length of a post on X (formerly Twitter) exactly as X does, using X's official twitter-text library: weighted characters where CJK (Japanese, Chinese, Korean) and emoji count 2, most Latin characters count 1, every URL counts 23, text is NFC-normalized, and the limit is 280 (about 140 Japanese characters). It is meant for checking X posts, especially Japanese ones, against the limit. is_valid is also false for an empty text or text with characters X does not accept. Counts only the text given (auto-added reply @mentions and attached media are not counted by X). Long posts for paid accounts are not covered; the text may be at most 1,000 UTF-16 code units, also after NFC normalization. The text is not stored or returned.
| Argument | Type | Description |
|---|---|---|
| text* | string | 数える本文(UTF-16 で 1,000 まで。NFC にした後も 1,000 まで) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 1000,
"description": "数える本文(UTF-16 で 1,000 まで。NFC にした後も 1,000 まで)"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 21, 2026.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"to"
],
"properties": {
"to": {
"enum": [
"wareki",
"seireki"
],
"type": "string",
"description": "wareki=西暦から和暦へ、seireki=和暦から西暦へ"
},
"day": {
"type": "integer",
"maximum": 31,
"minimum": 1
},
"era": {
"enum": [
"showa",
"heisei",
"reiwa",
"昭和",
"平成",
"令和"
],
"type": "string",
"description": "to が seireki の時の元号"
},
"date": {
"type": "string",
"maxLength": 10,
"description": "to が wareki の時の西暦の日(YYYY-MM-DD)"
},
"year": {
"type": "integer",
"maximum": 99,
"minimum": 1,
"description": "元号の年(元年は 1)"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"year_only": {
"type": "integer",
"maximum": 2100,
"minimum": 1926,
"description": "to が wareki で、年だけ変える時の西暦の年"
}
},
"additionalProperties": false
}| transaction_date | string | 取引(譲渡)の日 YYYY-MM-DD。行に date が無い時に使う。税率 1 の行には、どちらかの日が要る |
| issuer_registered* | boolean | 請求書を出す人が適格請求書発行事業者(インボイスの登録をしている)か |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"price_basis",
"rounding",
"lines",
"issuer_registered"
],
"properties": {
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"rate"
],
"properties": {
"date": {
"type": "string",
"maxLength": 10,
"description": "この行の取引(譲渡)の日 YYYY-MM-DD(8% と 1% が混ざる請求書の時など)"
},
"rate": {
"enum": [
"1",
"8",
"10"
],
"type": "string",
"description": "税率(%)。8 は軽減税率。1 は 2027-04-01〜2029-03-31 の飲食料品の税率で、まだ法案(成立していない)。どの税率かは呼ぶ側(利用者)が選ぶ"
},
"amount": {
"type": "integer",
"maximum": 1000000000000,
"minimum": -1000000000000,
"description": "円。値引きは負の数"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"stated": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"maximum": 1000000000000,
"minimum": -1000000000000
},
"subtotal": {
"type": "integer",
"maximum": 1000000000000,
"minimum": -1000000000000
},
"consumption_tax": {
"type": "integer",
"maximum": 1000000000000,
"minimum": -1000000000000
},
"transfer_amount": {
"type": "integer",
"maximum": 1000000000000,
"minimum": -1000000000000
},
"withholding_tax": {
"type": "integer",
"maximum": 1000000000000,
"minimum": -1000000000000
}
},
"description": "請求書に書いた数(検算する時。書いてある物だけ入れる)",
"additionalProperties": false
},
"rounding": {
"enum": [
"floor",
"round_half_up",
"ceil"
],
"type": "string",
"description": "1円未満の処理。切り捨て・四捨五入・切り上げ"
},
"price_basis": {
"enum": [
"tax_excluded",
"tax_included"
],
"type": "string",
"description": "行の金額が税抜(tax_excluded)か税込(tax_included)か。1枚の中ではどちらかに揃える"
},
"withholding": {
"type": "object",
"required": [
"fee_kind"
],
"properties": {
"fee_kind": {
"enum": [
"manuscript",
"lecture",
"design",
"illustration",
"photo",
"translation",
"other_item1"
],
"type": "string",
"description": "第1号の報酬の種類(原稿・講演・デザイン・イラスト・写真・翻訳・その他第1号)"
},
"income_date": {
"type": "string",
"maxLength": 10,
"description": "その報酬の所得が生ずる日(YYYY-MM-DD・内訳の注意書きだけに使う)"
},
"consumption_tax_separately_stated": {
"type": "boolean",
"description": "請求書で消費税(相当)額を報酬の額と区分して書くか(既定 true)。false なら税込の額が源泉の対象"
}
},
"description": "日本に住む個人に払う第1号の報酬として源泉徴収する時だけ入れる",
"additionalProperties": false
},
"payment_terms": {
"type": "object",
"required": [
"received_on"
],
"properties": {
"monthly": {
"type": "object",
"required": [
"cutoff_day",
"pay_month_offset",
"pay_day"
],
"properties": {
"pay_day": {
"anyOf": [
{
"type": "integer",
"maximum": 28,
"minimum": 1
},
{
"enum": [
"end"
],
"type": "string"
}
],
"description": "支払日(1〜28 か \"end\"=末日)"
},
"cutoff_day": {
"anyOf": [
{
"type": "integer",
"maximum": 28,
"minimum": 1
},
{
"enum": [
"end"
],
"type": "string"
}
],
"description": "締め日(1〜28 か \"end\"=末日)"
},
"pay_month_offset": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "締めた月から何か月後に払うか(0=当月・1=翌月・2=翌々月)"
}
},
"description": "月単位の締切制度(例:末日締め翌月末日払い=cutoff_day \"end\"・pay_month_offset 1・pay_day \"end\")",
"additionalProperties": false
},
"received_on": {
"type": "string",
"maxLength": 10,
"description": "給付を受領した日(役務は提供を受けた日。日数がかかる役務は終わった日)YYYY-MM-DD"
},
"agreed_due_date": {
"type": "string",
"maxLength": 10,
"description": "決めた支払期日(YYYY-MM-DD)。monthly と一緒には使わない"
}
},
"description": "支払期日もまとめて出す時(jp_payment_due_date と同じ入力)",
"additionalProperties": false
},
"transaction_date": {
"type": "string",
"maxLength": 10,
"description": "取引(譲渡)の日 YYYY-MM-DD。行に date が無い時に使う。税率 1 の行には、どちらかの日が要る"
},
"issuer_registered": {
"type": "boolean",
"description": "請求書を出す人が適格請求書発行事業者(インボイスの登録をしている)か"
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"price_basis",
"rounding",
"lines"
],
"properties": {
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"rate"
],
"properties": {
"date": {
"type": "string",
"maxLength": 10,
"description": "この行の取引(譲渡)の日 YYYY-MM-DD(8% と 1% が混ざる請求書の時など)"
},
"rate": {
"enum": [
"1",
"8",
"10"
],
"type": "string",
"description": "税率(%)。8 は軽減税率。1 は 2027-04-01〜2029-03-31 の飲食料品の税率で、まだ法案(成立していない)。どの税率かは呼ぶ側(利用者)が選ぶ"
},
"amount": {
"type": "integer",
"maximum": 1000000000000,
"minimum": -1000000000000,
"description": "円。値引きは負の数"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"rounding": {
"enum": [
"floor",
"round_half_up",
"ceil"
],
"type": "string",
"description": "1円未満の処理。切り捨て・四捨五入・切り上げ"
},
"price_basis": {
"enum": [
"tax_excluded",
"tax_included"
],
"type": "string",
"description": "行の金額が税抜(tax_excluded)か税込(tax_included)か。1枚の中ではどちらかに揃える"
},
"transaction_date": {
"type": "string",
"maxLength": 10,
"description": "取引(譲渡)の日 YYYY-MM-DD。行に date が無い時に使う。税率 1 の行には、どちらかの日が要る"
}
},
"additionalProperties": false
}| business_related | boolean | 領収書だけ。営業に関しない受取書なら false(非課税)。既定 true |
| consumption_tax_amount | integer | 区分して書いた消費税額等(円) |
| amount_excluding_consumption_tax | integer | 税抜の額(円)を amount の代わりに渡す時。消費税額等を区分して書いているか、税込と税抜の両方を書いている書類だけで、consumption_tax_separately_stated: true も要る。この額で表を引き、consumption_tax_amount は使わない |
| consumption_tax_separately_stated | boolean | 消費税額等を具体的に書いている時、または税込と税抜の両方を書いている時は true(消費税額=税込−税抜)。既定 false |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_type"
],
"properties": {
"amount": {
"anyOf": [
{
"type": "integer",
"maximum": 1000000000000,
"minimum": 0
},
{
"type": "null"
}
],
"description": "書類の金額(円・消費税額等を含めた税込の合計)。消費税を区分して書いている時も税込の合計を入れる。金額を書いていないなら null を明示する(渡さないと誤り)。amount_excluding_consumption_tax とどちらか片方だけ"
},
"created_on": {
"type": "string",
"maxLength": 10,
"description": "書類を作った日(YYYY-MM-DD)。無ければ今日(日本の日付)"
},
"document_type": {
"enum": [
"receipt",
"real_estate_transfer_contract",
"construction_contract",
"other_work_contract"
],
"type": "string",
"description": "呼ぶ側(利用者)が選ぶ書類の種類。receipt=売上代金の領収書(第17号の1)、real_estate_transfer_contract=不動産の譲渡の契約書(第1号の1)、construction_contract=建設工事の請負(第2号。建設工事の契約に基づく書類なら、設計など建設工事以外の事を一緒に書いていても全体がこれ)、other_work_contract=建設工事以外の請負(第2号)"
},
"business_related": {
"type": "boolean",
"description": "領収書だけ。営業に関しない受取書なら false(非課税)。既定 true"
},
"consumption_tax_amount": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0,
"description": "区分して書いた消費税額等(円)"
},
"amount_excluding_consumption_tax": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0,
"description": "税抜の額(円)を amount の代わりに渡す時。消費税額等を区分して書いているか、税込と税抜の両方を書いている書類だけで、consumption_tax_separately_stated: true も要る。この額で表を引き、consumption_tax_amount は使わない"
},
"consumption_tax_separately_stated": {
"type": "boolean",
"description": "消費税額等を具体的に書いている時、または税込と税抜の両方を書いている時は true(消費税額=税込−税抜)。既定 false"
}
},
"additionalProperties": false
}| consumption_tax_separately_stated | boolean | 請求書で報酬と消費税の額がはっきり分かれているか(既定 false) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"payee_type",
"fee_kind",
"amount"
],
"properties": {
"amount": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0,
"description": "1回に払う報酬(円)。消費税を区分して書いているならその消費税を含めた請求の額"
},
"fee_kind": {
"enum": [
"manuscript",
"lecture",
"design",
"illustration",
"photo",
"translation",
"other_item1"
],
"type": "string",
"description": "第1号の報酬の種類(呼ぶ側=利用者が選ぶ):原稿料・講演料・デザイン料・イラスト・印刷物に載せる写真・翻訳・その他の第1号。計算は同じ"
},
"payee_type": {
"enum": [
"resident_individual",
"corporation",
"non_resident"
],
"type": "string",
"description": "受け取る人(呼ぶ側=利用者が選ぶ)。resident_individual=日本に住む個人(これだけ計算する。corporation・non_resident は対象外の誤りを返す)"
},
"income_date": {
"type": "string",
"maxLength": 10,
"description": "その報酬の所得が生ずる日(YYYY-MM-DD・ふつうは仕事を終えた日)。払う日ではない。2027年からの内訳の注意書きを変えるためだけに使い、税額は変わらない"
},
"consumption_tax_amount": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0,
"description": "請求書に区分して書いた消費税の額(上が true の時だけ)"
},
"consumption_tax_separately_stated": {
"type": "boolean",
"description": "請求書で報酬と消費税の額がはっきり分かれているか(既定 false)"
}
},
"additionalProperties": false
}