Read your China e-tax bureau records through an API

What you can build on the e-tax bureau

• Get filed returns

  Build this

  Reads 申报信息查询 (filing records) under 我要查询 > 一户式查询 for a filing date range or tax period, with corrected and voided returns if you ask.

  Takes

  Filing date from and to, tax period (optional), return name (optional)

  Returns

  Return name, tax period start and end, filing date, corrected or voided

• List unpaid social insurance fees

  Build this

  Reads 单位社保费缴费 (employer social insurance payment) under 社保费业务 > 申报缴纳: the fees that were declared but not yet paid.

  Takes

  Filing date from and to (optional)

  Returns

  Filing date, fee period, amount due

• Get a social insurance fee certificate

  Build this

  Opens 单位社保费完税证明 (employer social insurance tax payment certificate), queries a fee period, selects the payments and issues the certificate, or re-prints one under 补打.

  Takes

  Fee period from and to, first issue or re-print

  Returns

  Fee period, payments covered, certificate document

• Approve a tax agency's request

  Build this

  Opens 代理办税申请任务 under 我的待办 > 其他, checks the agency and service items, and selects 同意 so the agency can file for you.

  Takes

  Agency name, service items expected

  Returns

  Agency name, service items, result

Automate the e-tax bureau with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Monthly check of returns not yet filed for last period

  Build this

  Starts

  Every month on the 10th at 9:00

  Step 1

  Get the filed returns for last month's tax period.

  Step 2

  Compare them with the list of returns you file each month, and keep the ones not filed yet.

  Step 3

  Email you the returns still to file, or a line saying all are filed.

• Daily hand-over of unpaid social insurance fees to payroll

  Build this

  Starts

  Every weekday at 9:00

  Step 1

  List the unpaid social insurance fees in 单位社保费缴费.

  Step 2

  Stop when there are none.

  Step 3

  Post each item's filing date, fee period and amount due to your payroll system's webhook.

• Corrected and voided returns, for accounting

  Build this

  Starts

  Every Monday at 8:00

  Step 1

  Get the filed returns for the last 90 days, with corrected and voided ones.

  Step 2

  Keep the returns that became corrected or voided since the last run.

  Step 3

  Email you each one with its name, tax period, filing date and whether it was corrected or voided.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get filed returns” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "etax.chinatax.gov.cn/get_filed_returns",
    "input": {
      "filed_from": "2026-10-01",
      "filed_to": "2026-10-31"
    }
  }'

{
  "status": "completed",
  "data": {
    "taxpayer": "Acme (Shanghai) Trading Co., Ltd.",
    "returns": [
      {
        "return_name": "增值税及附加税费申报表（一般纳税人适用）",
        "tax_period_start": "2026-09-01",
        "tax_period_end": "2026-09-30",
        "filed_on": "2026-10-14",
        "corrected": false,
        "voided": false
      }
    ],
    "count": 1
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

The e-tax bureau’s own options

The State Taxation Administration offers 乐企, a direct link between its systems and a company's own system for issuing digital invoices and filing taxes. It is for large companies that apply and are approved: 50 million yuan of revenue the year before, a credit rating of A or B, and tested access. Everyone else files on the e-tax bureau's website or app.

Read on November 12, 2026: 乐企 conditions and application (Liaoning tax bureau), Exporting filed returns (Shanghai Tax, on The Paper), Social insurance fees and certificates (Shanghai Tax, on The Paper).

Signing in to the e-tax bureau

A tax agency signs in under 代理业务 with its own 纳税人识别号, the staff member's ID or mobile number and 个人用户密码, then a code requested with 接收验证码. A person signs in by scanning with the 个人所得税 APP, or with a password and a text-message code. With Fous you sign in through the site's own sign-in with your own account; the login is sealed with AES-256 and code and AI agents never see it.

Worth knowing

Corrections replace the whole return

申报更正与作废 only corrects a return in full: there is no difference or supplementary correction. A return can be voided only within the filing period and before any tax is paid.

Quarterly income tax returns lock

Only the last filed 企业所得税 quarterly return can be corrected, and once the annual return is filed, that year's quarterly returns can no longer be corrected.

Agencies need the client's 同意

A tax agency files through the 代理业务 channel after entering the agreement under 涉税专业服务机构管理. When it covers 纳税申报代理, the client must approve the 代理办税申请任务 in 我的待办 first.

Employee records start in December 2023

职工缴费记录开具 issues an employee's social insurance payment record only for fee periods from December 2023 onwards.

More in Government: East and South-East Asia, Oceania

• 登記情報提供サービス
• Cổng thông tin hóa đơn điện tử
• SIPP Online
• Edabu
• PhilHealth EPRS
• Virtual Pag-IBIG for Employers
• KWSP i-Akaun (Majikan)
• 自然人电子税务局（扣缴端）
• eMPF Platform
• My.SSS Employer Portal
• SSO e-Service
• BIR eFPS
• RD e-Filing
• Coretax DJP
• myIR
• MyTax

Other industries: Income Tax e-Filing Portal, GetYourGuide Supplier Portal, Oficina Virtual CCSS (SICERE), EmaraTax, e-ΕΦΚΑ, Planning Portal.