Japan statutory calculations: net pay, social insurance, tax walls, holidays. Cited sources, x402.
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.
Mart402 product catalog: all products, prices, payment config, error codes, rate limits. Free.
This tool takes no arguments.
Mart402 product catalog: all products, prices, payment config, error codes, rate limits. Free.
No arguments.
{
"type": "object",
"properties": {}
}Re-fetch a previously paid result for free by receipt id (every paid response carries receipt_id).
| Argument | Type | Description |
|---|---|---|
| receipt_id* | string | receipt_id from a paid response (rcpt_...) |
{
"type": "object",
"required": [
"receipt_id"
],
"properties": {
"receipt_id": {
"type": "string",
"description": "receipt_id from a paid response (rcpt_...)"
}
}
}Free recorded sample response for a paid product (from real production runs, marked sample:true) - see the exact response shape before paying anything. Available: document-pipeline, enrich, extract, jp-bonus-net, jp-business-days, jp-company, jp-consumption-tax, jp-crypto-tax, jp-dependent-threshold, jp-mortgage, jp-overtime-wage, jp-payroll-net, jp-payroll-suite, jp-payslip-audit, jp-retirement-tax, jp-social-insurance, meal-vision, ocr, parse, pdf-info, pdf-merge, pdf-pages, portrait-analysis, report-pack, structured, style-profile, style-report, verify.
| Argument | Type | Description |
|---|---|---|
| product* | string | One of: document-pipeline, enrich, extract, jp-bonus-net, jp-business-days, jp-company, jp-consumption-tax, jp-crypto-tax, jp-dependent-threshold, jp-mortgage, jp-overtime-wage, jp-payroll-net, jp-payroll-suite, jp-payslip-audit, jp-retirement-tax, jp-social-insurance, meal-vision, ocr, parse, pdf-info, pdf-merge, pdf-pages, portrait-analysis, report-pack, structured, style-profile, style-report, verify. Product id (see the enum) |
{
"type": "object",
"required": [
"product"
],
"properties": {
"product": {
"enum": [
"document-pipeline",
"enrich",
"extract",
"jp-bonus-net",
"jp-business-days",
"jp-company",
"jp-consumption-tax",
"jp-crypto-tax",
"jp-dependent-threshold",
"jp-mortgage",
"jp-overtime-wage",
"jp-payroll-net",
"jp-payroll-suite",
"jp-payslip-audit",
"jp-retirement-tax",
"jp-social-insurance",
"meal-vision",
"ocr",
"parse",
"pdf-info",
"pdf-merge",
"pdf-pages",
"portrait-analysis",
"report-pack",
"structured",
"style-profile",
"style-report",
"verify"
],
"type": "string",
"description": "One of: document-pipeline, enrich, extract, jp-bonus-net, jp-business-days, jp-company, jp-consumption-tax, jp-crypto-tax, jp-dependent-threshold, jp-mortgage, jp-overtime-wage, jp-payroll-net, jp-payroll-suite, jp-payslip-audit, jp-retirement-tax, jp-social-insurance, meal-vision, ocr, parse, pdf-info, pdf-merge, pdf-pages, portrait-analysis, report-pack, structured, style-profile, style-report, verify. Product id (see the enum)"
}
}
}Bonus net pay: social insurance and withholding tax (official rate table, based on previous month salary). $0.01/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this for ONE bonus payment: its social insurance and withholding tax (the tax rate depends on the previous month's salary after social insurance). For annual totals use jp_payroll_net.
| Argument | Type | Description |
|---|---|---|
| age | integer | Age in years (selects care-insurance and other age-gated rules) |
| as_of | string | Calculation reference date YYYY-MM-DD (default today); selects the rules version |
| bonus_yen* | integer | Bonus amount in yen |
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| dependents | integer | Dependents object (see /catalog input spec) |
| prefecture* | string | Prefecture (romaji or Japanese), e.g. 'Tokyo' |
| ytd_bonus_yen | integer | Bonus paid so far in the fiscal year (health-insurance annual cap check) |
| previous_month_after_si_yen |
Japanese holidays, business-day arithmetic, statutory filing deadlines with holiday shift, wareki conversion. $0.003/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Required by mode (default add): add -> from, days; between -> from, to; holidays -> year; deadline -> kind, base_date; wareki -> date.
| Argument | Type | Description |
|---|---|---|
| to | string | End date YYYY-MM-DD |
| date | string | Date YYYY-MM-DD |
| days | integer | Number of business days to add |
| from | string | Start date YYYY-MM-DD |
| kind | string | One of: withholding_tax_monthly, social_insurance_monthly, corporate_tax, consumption_tax_corporate, income_tax_final, consumption_tax_individual, depreciable_assets, legal_records. Statutory deadline kind (see enum) |
| mode | string | Required by mode (default add): add -> from, days; between -> from, to; holidays -> year; deadline -> kind, base_date; wareki -> date. |
| year | integer | Calendar year |
| base_date | string | Base date YYYY-MM-DD for deadline calculation |
| x_payment |
Japanese company site to a standard profile JSON (name, address, representative, capital, contact). $0.03/site. Choose this when you have the URL of a Japanese company's OWN site and want its standard profile fields read from the page; for name/domain lookups use enrich_company (country_hint: jp).
| Argument | Type | Description |
|---|---|---|
| url* | string | Absolute http(s) URL of the input (web page or PDF, per tool) |
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Absolute http(s) URL of the input (web page or PDF, per tool)"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
}
}
}Consumption tax: per-rate invoice rounding, qualified-invoice validation, simplified taxation, 20% special. $0.01/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Required by mode (default invoice_totals): invoice_totals -> lines; validate_invoice -> document; simplified -> taxable_sales_excl_yen, category; two_percent -> taxable_sales_excl_yen, taxable_period_start, taxable_period_end.
| Argument | Type | Description |
|---|---|---|
| mode | string | Required by mode (default invoice_totals): invoice_totals -> lines; validate_invoice -> document; simplified -> taxable_sales_excl_yen, category; two_percent -> taxable_sales_excl_yen, taxable_period_start, taxable_period_end. |
| as_of | string | Calculation reference date YYYY-MM-DD (default today); selects the rules version |
| lines | array | Invoice lines [{amount_yen, qty, rate_key: standard|reduced}] |
| category | string | Simplified-taxation business class 1-6 |
| document | object | Qualified-invoice fields to validate (registration_number etc.) |
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| taxable_period_end | string |
Japan crypto-asset tax: realized income under the NTA total-average or moving-average method (sell/spend/exchange as disposals, fees deductible), verified against the official NTA FAQ examples. $0.05/call. Deterministic, cites primary sources; errors and unverified rules are never billed.
| Argument | Type | Description |
|---|---|---|
| year | integer | Calendar year |
| as_of | string | Calculation reference date YYYY-MM-DD (default today); selects the rules version |
| method | string | One of: total_average, moving_average. Cost method: total_average or moving_average |
| opening | array | Carried-over holdings [{asset, qty, cost_jpy}] |
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| transactions* | array | Crypto transactions list (max 300) - see /catalog input spec |
| other_taxable_income_yen | integer | Other taxable income in yen (returns incremental income tax as reference) |
{
"type": "object",
"required": [
"transactions"
],
"properties": {
"year": {
"type": "integer",
"default": 2026,
"description": "Calendar year"
},
"as_of": {
"type": "string",
"format": "date",
"description": "Calculation reference date YYYY-MM-DD (default today); selects the rules version"
},
"method": {
"enum": [
"total_average",
"moving_average"
],
"type": "string",
"default": "total_average",
"description": "One of: total_average, moving_average. Cost method: total_average or moving_average"
},
"opening": {
"type": "array",
"description": "Carried-over holdings [{asset, qty, cost_jpy}]"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"transactions": {
"type": "array",
"description": "Crypto transactions list (max 300) - see /catalog input spec"
},
"other_taxable_income_yen": {
"type": "integer",
"description": "Other taxable income in yen (returns incremental income tax as reference)"
}
}
}Income-wall analysis: tax, social insurance (1.06M/1.30M), spousal and student-dependent walls. $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this for 'how much can be earned before ...' questions: it locates the income walls (tax, social insurance, spousal, student dependent) for an annual income. It does not compute take-home pay (use jp_payroll_net).
| Argument | Type | Description |
|---|---|---|
| year | integer | Calendar year |
| as_of | string | Calculation reference date YYYY-MM-DD (default today); selects the rules version |
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| annual_income_yen* | integer | Expected annual income in yen |
{
"type": "object",
"required": [
"annual_income_yen"
],
"properties": {
"year": {
"type": "integer",
"default": 2026,
"description": "Calendar year"
},
"as_of": {
"type": "string",
"format": "date",
"description": "Calculation reference date YYYY-MM-DD (default today); selects the rules version"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"annual_income_yen": {
"type": "integer",
"description": "Expected annual income in yen"
}
}
}Mortgage schedules (level payment/principal), total interest, prepayment effect. $0.005/call. Deterministic, cites primary sources; errors and unverified rules are never billed.
| Argument | Type | Description |
|---|---|---|
| method | string | One of: level_payment, level_principal. Cost method: total_average or moving_average |
| months* | integer | Loan term in months |
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| prepayment | object | Optional prepayment {at_month, amount_yen, mode: reduce_term|reduce_payment} |
| annual_rate* | number | Annual interest rate as a decimal, e.g. 0.01 |
| principal_yen* | integer | Loan principal in yen |
{
"type": "object",
"required": [
"principal_yen",
"annual_rate",
"months"
],
"properties": {
"method": {
"enum": [
"level_payment",
"level_principal"
],
"type": "string",
"default": "level_payment",
"description": "One of: level_payment, level_principal. Cost method: total_average or moving_average"
},
"months": {
"type": "integer",
"description": "Loan term in months"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"prepayment": {
"type": "object",
"description": "Optional prepayment {at_month, amount_yen, mode: reduce_term|reduce_payment}"
},
"annual_rate": {
"type": "number",
"description": "Annual interest rate as a decimal, e.g. 0.01"
},
"principal_yen": {
"type": "integer",
"description": "Loan principal in yen"
}
}
}Overtime premium pay (Labor Standards Act Art.37, official rounding notice) and Article-36 limit check. $0.015/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Required by mode (default pay): pay -> monthly_salary_yen, monthly_scheduled_hours, hours; check36 -> monthly_overtime_hours.
| Argument | Type | Description |
|---|---|---|
| mode | string | Required by mode (default pay): pay -> monthly_salary_yen, monthly_scheduled_hours, hours; check36 -> monthly_overtime_hours. |
| hours | object | Hours worked |
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| monthly_salary_yen | integer | Monthly base salary in yen |
| monthly_overtime_hours | array | List of monthly overtime hours (36-agreement check) |
| monthly_scheduled_hours | number | Scheduled working hours per month |
{
"type": "object",
"required": [],
"properties": {
"mode": {
"enum": [
"pay",
"check36"
],
"type": "string",
"default": "pay",
"description": "Required by mode (default pay): pay -> monthly_salary_yen, monthly_scheduled_hours, hours; check36 -> monthly_overtime_hours."
},
"hours": {
"type": "object",
"description": "Hours worked"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"monthly_salary_yen": {
"type": "integer",
"description": "Monthly base salary in yen"
},
"monthly_overtime_hours": {
"type": "array",
"description": "List of monthly overtime hours (36-agreement check)"
},
"monthly_scheduled_hours": {
"type": "number",
"description": "Scheduled working hours per month"
}
}
}Annual gross salary to net take-home (social insurance + income tax + resident tax). Exact NTA Beppyo-5 table. $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this for a whole YEAR: annual gross salary to annual take-home after social insurance, income tax and resident tax. For one bonus use jp_bonus_net; for one month's premiums only use jp_social_insurance; to check an actual payslip use jp_payslip_audit.
| Argument | Type | Description |
|---|---|---|
| age | integer | Age in years (selects care-insurance and other age-gated rules) |
| year | integer | Calendar year |
| as_of | string | Calculation reference date YYYY-MM-DD (default today); selects the rules version |
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| dependents | object | Dependents object (see /catalog input spec) |
| prefecture* | string | Prefecture (romaji or Japanese), e.g. 'Tokyo' |
| annual_bonus_yen | integer | Annual bonus total in yen |
| annual_gross_yen |
Japan payroll suite: net salary + social insurance + income walls (+bonus) in one call. Flat $0.05. Choose this when you want take-home pay, social insurance and the income walls (and the bonus, if given) together from one annual figure in one call; if you only need the take-home amount, jp_payroll_net is cheaper.
| Argument | Type | Description |
|---|---|---|
| age | integer | Age in years (selects care-insurance and other age-gated rules) |
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| dependents | object | Dependents object (see /catalog input spec) |
| prefecture* | string | Prefecture (romaji or Japanese), e.g. 'Tokyo' |
| annual_bonus_yen | integer | Annual bonus total in yen |
| annual_gross_yen* | integer | Annual gross salary in yen |
| previous_month_after_si_yen | integer | Previous month's pay after social insurance (withholding table lookup) |
Audit a Japanese payslip: recompute statutory premiums and withholding tax from official tables and diff against the actual amounts, with per-item verdicts (match/explainable/mismatch). $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this when you HAVE an actual payslip and want each deduction checked against the official tables (match/explainable/mismatch); to compute expected amounts from a salary alone use jp_payroll_net or jp_social_insurance.
| Argument | Type | Description |
|---|---|---|
| age | integer | Age in years (selects care-insurance and other age-gated rules) |
| as_of | string | Calculation reference date YYYY-MM-DD (default today); selects the rules version |
| payslip* | object | Payslip fields to audit - see /catalog input spec |
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| prefecture* | string | Prefecture (romaji or Japanese), e.g. 'Tokyo' |
| standard_monthly_yen | integer | Standard monthly remuneration if known (else estimated from salary) |
{
"type": "object",
"required": [
"prefecture",
"payslip"
],
"properties": {
"age": {
"type": "integer",
"default": 30,
"description": "Age in years (selects care-insurance and other age-gated rules)"
},
"as_of": {
"type": "string",
"format": "date",
"description": "Calculation reference date YYYY-MM-DD (default today); selects the rules version"
},
"payslip": {
"type": "object",
"required": [
"monthly_gross_yen"
],
"properties": {
"monthly_gross_yen": {
"type": "integer"
}
},
"description": "Payslip fields to audit - see /catalog input spec"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"prefecture": {
"type": "string",
"description": "Prefecture (romaji or Japanese), e.g. 'Tokyo'"
},
"standard_monthly_yen": {
"type": "integer",
"description": "Standard monthly remuneration if known (else estimated from salary)"
}
}
}Retirement income tax: deduction by years of service, half-taxation rules, exact withholding rounding. $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed.
| Argument | Type | Description |
|---|---|---|
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| disability | boolean | True if retirement is due to disability (extra deduction) |
| is_officer | boolean | True for an officer/executive (short-service officer rules) |
| payout_yen* | integer | Retirement allowance paid, in yen |
| years_of_service* | integer | Years of service (retirement income deduction) |
{
"type": "object",
"required": [
"payout_yen",
"years_of_service"
],
"properties": {
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"disability": {
"type": "boolean",
"default": false,
"description": "True if retirement is due to disability (extra deduction)"
},
"is_officer": {
"type": "boolean",
"default": false,
"description": "True for an officer/executive (short-service officer rules)"
},
"payout_yen": {
"type": "integer",
"description": "Retirement allowance paid, in yen"
},
"years_of_service": {
"type": "integer",
"description": "Years of service (retirement income deduction)"
}
}
}Monthly social insurance premiums from the official Kyokai-Kenpo grade table (FY2026). $0.01/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this when you only need the monthly social insurance premiums for a given monthly remuneration (official grade table); no tax is computed - for take-home pay use jp_payroll_net.
| Argument | Type | Description |
|---|---|---|
| age | integer | Age in years (selects care-insurance and other age-gated rules) |
| as_of | string | Calculation reference date YYYY-MM-DD (default today); selects the rules version |
| x_payment | string | Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| prefecture* | string | Prefecture (romaji or Japanese), e.g. 'Tokyo' |
| monthly_remuneration_yen* | integer | Monthly remuneration in yen (grade table lookup) |
{
"type": "object",
"required": [
"monthly_remuneration_yen",
"prefecture"
],
"properties": {
"age": {
"type": "integer",
"default": 30,
"description": "Age in years (selects care-insurance and other age-gated rules)"
},
"as_of": {
"type": "string",
"format": "date",
"description": "Calculation reference date YYYY-MM-DD (default today); selects the rules version"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"prefecture": {
"type": "string",
"description": "Prefecture (romaji or Japanese), e.g. 'Tokyo'"
},
"monthly_remuneration_yen": {
"type": "integer",
"description": "Monthly remuneration in yen (grade table lookup)"
}
}
}| integer |
| Previous month's pay after social insurance (withholding table lookup) |
{
"type": "object",
"required": [
"bonus_yen",
"prefecture"
],
"properties": {
"age": {
"type": "integer",
"default": 30,
"description": "Age in years (selects care-insurance and other age-gated rules)"
},
"as_of": {
"type": "string",
"format": "date",
"description": "Calculation reference date YYYY-MM-DD (default today); selects the rules version"
},
"bonus_yen": {
"type": "integer",
"description": "Bonus amount in yen"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"dependents": {
"type": "integer",
"default": 0,
"description": "Dependents object (see /catalog input spec)"
},
"prefecture": {
"type": "string",
"description": "Prefecture (romaji or Japanese), e.g. 'Tokyo'"
},
"ytd_bonus_yen": {
"type": "integer",
"default": 0,
"description": "Bonus paid so far in the fiscal year (health-insurance annual cap check)"
},
"previous_month_after_si_yen": {
"type": "integer",
"description": "Previous month's pay after social insurance (withholding table lookup)"
}
}
}| string |
| Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged. |
| saturday_off | boolean | Treat Saturdays as non-business days (default true) |
{
"type": "object",
"required": [],
"properties": {
"to": {
"type": "string",
"format": "date",
"description": "End date YYYY-MM-DD"
},
"date": {
"type": "string",
"format": "date",
"description": "Date YYYY-MM-DD"
},
"days": {
"type": "integer",
"description": "Number of business days to add"
},
"from": {
"type": "string",
"format": "date",
"description": "Start date YYYY-MM-DD"
},
"kind": {
"enum": [
"withholding_tax_monthly",
"social_insurance_monthly",
"corporate_tax",
"consumption_tax_corporate",
"income_tax_final",
"consumption_tax_individual",
"depreciable_assets",
"legal_records"
],
"type": "string",
"description": "One of: withholding_tax_monthly, social_insurance_monthly, corporate_tax, consumption_tax_corporate, income_tax_final, consumption_tax_individual, depreciable_assets, legal_records. Statutory deadline kind (see enum)"
},
"mode": {
"enum": [
"add",
"between",
"holidays",
"deadline",
"wareki"
],
"type": "string",
"default": "add",
"description": "Required by mode (default add): add -> from, days; between -> from, to; holidays -> year; deadline -> kind, base_date; wareki -> date."
},
"year": {
"type": "integer",
"description": "Calendar year"
},
"base_date": {
"type": "string",
"format": "date",
"description": "Base date YYYY-MM-DD for deadline calculation"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"saturday_off": {
"type": "boolean",
"default": true,
"description": "Treat Saturdays as non-business days (default true)"
}
}
}| Taxable period last day YYYY-MM-DD (two_percent) |
| taxable_period_start | string | Taxable period first day YYYY-MM-DD (two_percent) |
| taxable_sales_excl_yen | integer | Taxable sales excluding tax, in yen |
{
"type": "object",
"required": [],
"properties": {
"mode": {
"enum": [
"invoice_totals",
"validate_invoice",
"simplified",
"two_percent"
],
"type": "string",
"default": "invoice_totals",
"description": "Required by mode (default invoice_totals): invoice_totals -> lines; validate_invoice -> document; simplified -> taxable_sales_excl_yen, category; two_percent -> taxable_sales_excl_yen, taxable_period_start, taxable_period_end."
},
"as_of": {
"type": "string",
"format": "date",
"description": "Calculation reference date YYYY-MM-DD (default today); selects the rules version"
},
"lines": {
"type": "array",
"description": "Invoice lines [{amount_yen, qty, rate_key: standard|reduced}]"
},
"category": {
"type": "string",
"description": "Simplified-taxation business class 1-6"
},
"document": {
"type": "object",
"description": "Qualified-invoice fields to validate (registration_number etc.)"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"taxable_period_end": {
"type": "string",
"format": "date",
"description": "Taxable period last day YYYY-MM-DD (two_percent)"
},
"taxable_period_start": {
"type": "string",
"format": "date",
"description": "Taxable period first day YYYY-MM-DD (two_percent)"
},
"taxable_sales_excl_yen": {
"type": "integer",
"description": "Taxable sales excluding tax, in yen"
}
}
}| integer |
| Annual gross salary in yen |
{
"type": "object",
"required": [
"annual_gross_yen",
"prefecture"
],
"properties": {
"age": {
"type": "integer",
"default": 30,
"description": "Age in years (selects care-insurance and other age-gated rules)"
},
"year": {
"type": "integer",
"default": 2026,
"description": "Calendar year"
},
"as_of": {
"type": "string",
"format": "date",
"description": "Calculation reference date YYYY-MM-DD (default today); selects the rules version"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"dependents": {
"type": "object",
"description": "Dependents object (see /catalog input spec)"
},
"prefecture": {
"type": "string",
"description": "Prefecture (romaji or Japanese), e.g. 'Tokyo'"
},
"annual_bonus_yen": {
"type": "integer",
"default": 0,
"description": "Annual bonus total in yen"
},
"annual_gross_yen": {
"type": "integer",
"description": "Annual gross salary in yen"
}
}
}{
"type": "object",
"required": [
"annual_gross_yen",
"prefecture"
],
"properties": {
"age": {
"type": "integer",
"description": "Age in years (selects care-insurance and other age-gated rules)"
},
"x_payment": {
"type": "string",
"description": "Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged."
},
"dependents": {
"type": "object",
"description": "Dependents object (see /catalog input spec)"
},
"prefecture": {
"type": "string",
"description": "Prefecture (romaji or Japanese), e.g. 'Tokyo'"
},
"annual_bonus_yen": {
"type": "integer",
"description": "Annual bonus total in yen"
},
"annual_gross_yen": {
"type": "integer",
"description": "Annual gross salary in yen"
},
"previous_month_after_si_yen": {
"type": "integer",
"description": "Previous month's pay after social insurance (withholding table lookup)"
}
}
}