LifestyleBrowser

Hometax

hometax.go.kr

Korean tax portal workflows for filings, certificates, status checks, and receipt downloads.

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

Scope

This provider covers browser-based Hometax flows. It is a high-trust, unofficial automation target with login, identity verification, filing preparation, explicit submission approval, status tracking, and receipt download requirements. Implementations must avoid exposing PII in logs or summaries.

Expected operations

search-tax-tasksSearch tax tasksreadDifficulty: medium

Search available tax actions by purpose so the correct government workflow can be selected before authentication or submission.

Inputs

querystringrequired

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.

Purpose or service name the user wants to complete.

Outputs

servicesservice_nameportalrequired_authresult_type

Acceptance

Returns candidate government tasks that match the user's purpose.
Returns only tax tasks that Hometax actually offers.
Does not imply submission is possible before the relevant portal and prerequisites are identified.

No account auth required for this operation.

check-required-docs-authCheck required documents and authentication methodreadDifficulty: medium

Inspect a selected task to determine the identity verification method, attached documents, and any prerequisites needed before proceeding.

Inputs

task_idstringrequired
Selected tax task identifier.
hometax-income-tax-return

Outputs

required_documentsauthentication_methodeligibilitysubmission_windowfee

Acceptance

Lists the documents or identity checks needed for the selected task.

prepare-tax-filingPrepare tax filing workflowwriteDifficulty: hard

Build a draft for a tax filing using the required personal and case details, then return a reviewable submission package.

Inputs

task_idstringrequired
Government task or filing identifier.
hometax-income-tax-return
profileobjectrequired
Minimal user or case information needed to populate the draft without leaking unnecessary personal data.
{"name":"Kim Min-su","residentIdLast4":"1234"}
attachmentsarrayoptional
Optional supporting documents or attachment references required by the workflow.
["income_statement.pdf"]

Outputs

draft_idrequired_fieldssubmission_summarydeadlineestimated_fee

Acceptance

Builds a draft only when the required task fields are available.

submit-approved-requestSubmit approved requestwriteDifficulty: hard

Send a prepared government request after explicit user approval and return the resulting filing or application identifier.

Inputs

draft_idstringrequired
Draft identifier created by the preparation step.
draft_4c2b1
user_approvedbooleanrequired
Explicit confirmation that the user reviewed the draft and agreed to submit it.
true
payment_methodstringoptional
Optional payment token or account reference if a fee must be charged.
bank_transfer_token

Outputs

application_idsubmitted_atreceipt_numberpayment_statusstatus

Acceptance

Refuses to submit if the user approval flag is absent or false.

get-application-statusGet application statusreadDifficulty: medium

Check the progress of a government filing or certificate request and return the current status, timestamps, and next action if one exists.

Inputs

application_idstringrequired
Application, filing, or receipt number to track.
APP-20260715-0091

Outputs

statusapplication_idsubmitted_atprocessed_atnext_step

Acceptance

Returns a concrete status for the supplied application identifier.

download-issued-documentsDownload issued documentsreadDifficulty: medium

Retrieve issued certificates, receipts, or payment confirmations after the corresponding request has completed successfully.

Inputs

document_idstringrequired
Issued document, receipt, or confirmation identifier.
RCPT-20260715-7781
formatstringoptional
Optional file format preference for the download.
pdf

Outputs

file_namedownload_urlissued_atdocument_typedocument_id

Acceptance

Returns only documents that were actually issued for the authenticated user.

Separates portal-specific authentication from general eligibility requirements.

Returns missing prerequisites instead of assuming the user can proceed immediately.

No account auth required for this operation.

Returns a review summary that exposes the final submission shape before any filing is sent.

Avoids echoing full sensitive identifiers in outputs or notes.

Auth required for this operation.

Returns an application or receipt identifier after successful submission.

Surfaces payment or portal validation failures rather than pretending the request was accepted.

Auth required for this operation.

Includes timestamps or next-step guidance when the portal exposes them.

Does not fabricate completion if the request is still pending or under review.

Auth required for this operation.

Provides a downloadable artifact or direct file reference when the portal supports it.

Rejects access when the document has not yet been issued or the identifier is invalid.

Auth required for this operation.