LifestyleBrowser

e-Tax

e-tax.nta.go.jp

Japanese tax workflows for filings, certificates, and status tracking on e-Tax.

Tier: 💎 Platinum
Reward: ₩500,000
Auth: Browser
Operations: 6
Working now: 0 contributors
Status: Open

Scope

Build a high-trust Japanese tax workflow provider for e-Tax. It must handle My Number authentication boundaries, prepare tax filings, show all submission details, require explicit approval, and retrieve status or receipts without exposing sensitive data in logs.

Expected operations

search-proceduresSearch government or tax proceduresreadDifficulty: hard

Search available tax procedures on e-Tax by keyword and category. This targets the authenticated browser surface, not a public REST API.

Inputs

keywordstringoptional

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Outputs

procedure_idtitlecategoryagencyrequires_my_number_cardonline_available

Acceptance

Returns procedures matching the keyword or category from the authenticated portal.
Each procedure indicates whether a My Number card is required and if online submission is available.
Does not claim a public API; results come from the logged-in browser session.

Auth required for this operation.

check-prerequisitesCheck identity and document prerequisitesreadDifficulty: hard

Check the identity, My Number card, e-certificate, and document prerequisites required to start a selected procedure.

Inputs

procedure_idstringrequired
Procedure identifier
proc_final_return

Outputs

procedure_idrequired_documentscard_auth_requirede_cert_requiredprerequisite_status

Acceptance

Returns the required documents and authentication level for the procedure.

prepare-filingPrepare benefit, certificate, or tax filingwriteDifficulty: hard

Assemble a benefit application, certificate request, or tax filing draft with the collected inputs for review. This prepares but does not submit the request.

Inputs

procedure_idstringrequired
Procedure identifier
proc_final_return
form_dataobjectrequired
Collected form field values
{"income":5200000}
attachmentsarrayoptional
References to prepared attachments
["withholding_slip"]

Outputs

draft_idprocedure_idvalidation_warningsrequires_confirmation

Acceptance

Produces a filing draft with any validation_warnings and requires_confirmation true.
Does not submit to the agency; only a reviewable draft is returned.
Missing mandatory formData fields are surfaced as validation warnings.

submit-requestSubmit an approved requestwriteDifficulty: hard

Submit a prepared draft to the government or tax authority, executed only after explicit user confirmation through the authenticated session.

Inputs

draft_idstringrequired
Prepared draft id
drft_final_2025
confirmationbooleanrequired
Explicit user confirmation flag
true

Outputs

submission_idstatusaccepted_atreceipt_number

Acceptance

Submits only when confirmation is true and a valid draftId exists.
Returns a submission_id and receipt_number issued by the authority.
A draft failing prerequisite checks is not submitted.

get-statusGet application, filing, or payment statusreadDifficulty: hard

Retrieve the current status of a submitted application, tax filing, or payment from the portal.

Inputs

submission_idstringrequired
Submission identifier
sub_88213

Outputs

submission_idstatusstatus_updated_atpayment_statusnext_action

Acceptance

Returns the current status and last update time for the submission_id.

download-documentsDownload receipts, notices, or issued documentsreadDifficulty: hard

Download issued receipts, notices, or certificates produced by a completed procedure through the authenticated session.

Inputs

submission_idstringrequired
Submission identifier
sub_88213
document_typestringoptional
Document type to download
receipt

Outputs

document_iddocument_typedownload_urlissued_at

Acceptance

Returns downloadable document references only for the authenticated user's completed procedures.
Distinguishes receipts, notices, and issued certificates via document_type.
Documents not yet issued return a pending state rather than a broken link.