# Turn 自然人电子税务局（扣缴端） into an API

> Read each company's 人员信息采集 (employee records), 专项附加扣除信息 (special deductions) and 综合所得申报 (monthly withholding filings) from 单位办税 with one API call each. A workflow can check every company you file for each month and email you the ones whose filing is not done.

Page: https://fous.com/automate/natural-person-e-tax-bureau-withholding
Updated: 2026-11-12

Works with your own 自然人电子税务局（扣缴端） account. Fous is an independent product.

## What you can build on the e-tax bureau

### Get the employee records of a company

Switches to the company in 单位办税 and reads the list under 扣缴申报 > 人员信息采集 (employee records).

- Takes: Company
- Returns: Name, ID type, ID number, employment type, employment status, start date

### Get special deductions for a company

Reads the 专项附加扣除信息 (special additional deductions) recorded for the company's employees in 单位办税.

- Takes: Company, year
- Returns: Name, ID number, deduction type, monthly amount, valid from, valid to

### Check a month's withholding filing

Opens 扣缴申报 > 综合所得申报 for one 税款所属月份 (tax period) and reads where that month's filing and payment stand.

- Takes: Company, tax period
- Returns: Tax period, filing status, number of people, total income, tax payable, payment status

### Add a new employee

Adds one person under 扣缴申报 > 人员信息采集 for the company, with the details from your HR record, and saves them.

- Takes: Company, name, ID type, ID number, employment type, start date, mobile number
- Returns: Name, ID number, employment type, status

## Automate the e-tax bureau with a workflow

A [workflow](/product/workflows) 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 filing check across every company

Starts: Every month on the 10th at 9:00 China Standard Time

1. For each company you name, check the 综合所得申报 for last month's 税款所属月份.
2. Keep the companies whose filing is not complete or whose tax is not paid.
3. Email you the list with tax period, filing status, tax payable and payment status.

### Employee records compared with your HR system

Starts: Every Monday at 8:00 China Standard Time

1. For each company, get the employee records in 人员信息采集.
2. Keep the people not there on the last run, or whose status changed since it.
3. Post them to your HR system's webhook with name, ID number, employment type and status.

### Special deductions handed to payroll

Starts: Every month on the 1st at 7:00 China Standard Time

1. For each company, get this year's 专项附加扣除信息 for its employees.
2. Keep the deductions that changed since the last run, and stop when there are none.
3. Post them to your payroll system's webhook with employee, deduction type and monthly amount.

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](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get the employee records of a company” would look like.

Example request:

```
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_employee_records",
    "input": {
      "company": "Acme Trading (Shanghai) Co., Ltd."
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "company": "Acme Trading (Shanghai) Co., Ltd.",
    "employees": [
      {
        "name": "张三",
        "id_type": "居民身份证",
        "id_number": "3101**********0000",
        "employment_type": "雇员",
        "employment_status": "正常",
        "start_date": "2024-03-01"
      }
    ],
    "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 describes two ways for an employer to file individual income tax withholding: the 扣缴客户端 (withholding client) and 单位办税 in the web version of 自然人电子税务局. The tax authority's guides describe no API for employers or payroll software. Web withholding is mainly for companies with 300 or fewer current employees.

| Option | What it covers | What it takes |
| --- | --- | --- |
| 扣缴客户端 (withholding client) | Employee records, monthly withholding filings, corrections and the withholding fee refund under 代扣代缴. | Installed on a computer at the company. Records can be exported from 人员信息采集. |
| Personal income tax app | Granting a person 企业办税权限 (company filing rights), and scanning the QR code for 扫码登录 on the web version. | The legal representative's, finance lead's or filing clerk's own real-name account. |
| The e-tax bureau by hand | 单位办税: 人员信息采集, 专项附加扣除信息采集, 扣缴申报, 税款缴纳 and 查询统计, one company at a time. | A real-name account with filing rights for each company, switched with 切换. |

Read on November 12, 2026: [Jiangsu Tax Service: signing in to the web version and switching companies](https://jiangsu.chinatax.gov.cn/art/2020/12/18/art_8353_323916.html), [State Taxation Administration](https://www.chinatax.gov.cn/).

## Signing in to the e-tax bureau

The web version opens on 扫码登录, a QR code you scan with the 个人所得税 (personal income tax) app, and also offers 密码登录 with a mobile number or ID number and a password. To use 单位办税, the person signing in must be the legal representative, the finance lead or a filing clerk with filing rights. With Fous you sign in once through the site's own sign-in with your own account, and the login is sealed with AES-256.

## Worth knowing

- **Filing rights are granted per person**: The legal representative or finance lead can use 单位办税 once registered under their real name. Anyone else needs 办税权限 granted under 个人信息管理 > 个人信息 > 办税权限管理 or in the app, or the 单位办税 button does not appear.
- **One company at a time**: 单位办税 shows one company. You move to the next with the 切换 button, so a method takes the company as an input and a workflow loops over your companies.
- **Web withholding suits up to 300 employees**: Web withholding is mainly for companies with 300 or fewer current employees of the types 雇员, 保险营销员, 证券经纪人 and 实习学生. You can use the client and the web version side by side, but never for the same task at once.
- **Corrections go month by month**: A correction starts from 扣缴申报 > 综合所得申报 with the 税款所属月份 and 我要更正. If later months are affected, correct them in order, or their cumulative figures may be wrong.

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

- [登記情報提供サービス](https://fous.com/automate/registry-information-service.md)
- [Cổng thông tin hóa đơn điện tử](https://fous.com/automate/hoadondientu.md)
- [SIPP Online](https://fous.com/automate/sipp-online.md)
- [Edabu](https://fous.com/automate/edabu.md)
- [PhilHealth EPRS](https://fous.com/automate/philhealth-eprs.md)
- [Virtual Pag-IBIG for Employers](https://fous.com/automate/virtual-pag-ibig-for-employers.md)
- [KWSP i-Akaun (Majikan)](https://fous.com/automate/kwsp-i-akaun-majikan.md)
- [eMPF Platform](https://fous.com/automate/empf-platform.md)
- [My.SSS Employer Portal](https://fous.com/automate/my-sss-employer-portal.md)
- [SSO e-Service](https://fous.com/automate/sso-e-service.md)
- [BIR eFPS](https://fous.com/automate/bir-efps.md)
- [RD e-Filing](https://fous.com/automate/rd-e-filing.md)
- [全国统一规范电子税务局](https://fous.com/automate/china-e-tax-bureau.md)
- [Coretax DJP](https://fous.com/automate/coretax-djp.md)
- [myIR](https://fous.com/automate/myir.md)
- [MyTax](https://fous.com/automate/mytax.md)

Other industries: [Income Tax e-Filing Portal](/automate/income-tax-e-filing-portal), [Agoda YCS](/automate/agoda-ycs), [AFPnet](/automate/afpnet), [KRA iTax](/automate/kra-itax), [e-Zamówienia](/automate/e-zamowienia), [ePortal ESTV](/automate/eportal-estv).

## Frequently asked questions

### Does 自然人电子税务局（扣缴端） have an API?

Not one the tax authority describes for employers. Its pages describe filing withholding in the 扣缴客户端 or in 单位办税 on the web version, with employee records added by hand or imported. With Fous you build methods on the web version that return JSON.

### Why is there no 单位办税 button when I sign in?

Your account has no filing rights for that company yet. The legal representative or finance lead grants them under 个人信息管理 > 个人信息 > 办税权限管理 with 新增授权人员, or in the personal income tax app under 企业办税权限.

### Can I file for several companies from one account?

Yes, if each company has granted you filing rights. In 单位办税 you finish one company, then use 切换 to move to the next. With Fous, a workflow loops over your companies and calls the same method for each.

### Where is the withholding fee refund claimed?

Under 扣缴申报 > 退付手续费核对 on the web version, or 代扣代缴 > 退付手续费核对 in the client. For 2025 the window ran from 1 January to 31 March 2026. You confirm the year's withholding data, check the 结报单, enter the bank details and apply.

### Is Fous affiliated with 国家税务总局 (State Taxation Administration)?

No. Fous is an independent product. You use it with your own 自然人电子税务局 account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of 自然人电子税务局（扣缴端） (国家税务总局 (State Taxation Administration)). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.