税务机关编码

概述

税务机关编码是税务部门用于标识各级税务机关的唯一代码，采用统一的编码规则，确保全国范围内税务机关的唯一性和可追溯性。环能聚合API支持全国各级税务机关编码的查询和验证。

编码结构

总长度： 11位数字

组成：省级(2位) + 市级(2位) + 县级(2位) + 乡镇级(3位) + 顺序码(2位)

校验规则：符合GB/T 15540-1995标准

省级税务机关编码

省份	税务机关编码	税务总局名称	备注
北京市	`11000000000`	国家税务总局北京市税务局	直辖市
天津市	`12000000000`	国家税务总局天津市税务局	直辖市
河北省	`13000000000`	国家税务总局河北省税务局	-
山西省	`14000000000`	国家税务总局山西省税务局	-
内蒙古自治区	`15000000000`	国家税务总局内蒙古自治区税务局	自治区
辽宁省	`21000000000`	国家税务总局辽宁省税务局	-
吉林省	`22000000000`	国家税务总局吉林省税务局	-
黑龙江省	`23000000000`	国家税务总局黑龙江省税务局	-
上海市	`31000000000`	国家税务总局上海市税务局	直辖市
江苏省	`32000000000`	国家税务总局江苏省税务局	-
浙江省	`33000000000`	国家税务总局浙江省税务局	-
安徽省	`34000000000`	国家税务总局安徽省税务局	-
福建省	`35000000000`	国家税务总局福建省税务局	-
江西省	`36000000000`	国家税务总局江西省税务局	-
山东省	`37000000000`	国家税务总局山东省税务局	-
河南省	`41000000000`	国家税务总局河南省税务局	-
湖北省	`42000000000`	国家税务总局湖北省税务局	-
湖南省	`43000000000`	国家税务总局湖南省税务局	-
广东省	`44000000000`	国家税务总局广东省税务局	-
广西壮族自治区	`45000000000`	国家税务总局广西壮族自治区税务局	自治区
海南省	`46000000000`	国家税务总局海南省税务局	-
重庆市	`50000000000`	国家税务总局重庆市税务局	直辖市
四川省	`51000000000`	国家税务总局四川省税务局	-
贵州省	`52000000000`	国家税务总局贵州省税务局	-
云南省	`53000000000`	国家税务总局云南省税务局	-
西藏自治区	`54000000000`	国家税务总局西藏自治区税务局	自治区
陕西省	`61000000000`	国家税务总局陕西省税务局	-
甘肃省	`62000000000`	国家税务总局甘肃省税务局	-
青海省	`63000000000`	国家税务总局青海省税务局	-
宁夏回族自治区	`64000000000`	国家税务总局宁夏回族自治区税务局	自治区
新疆维吾尔自治区	`65000000000`	国家税务总局新疆维吾尔自治区税务局	自治区

市级税务机关编码示例

北京市市级税务机关

市级区域	税务机关编码	税务局名称
东城区	`11010100000`	国家税务总局北京市东城区税务局
西城区	`11010200000`	国家税务总局北京市西城区税务局
朝阳区	`11010500000`	国家税务总局北京市朝阳区税务局
丰台区	`11010600000`	国家税务总局北京市丰台区税务局
石景山区	`11010700000`	国家税务总局北京市石景山区税务局
海淀区	`11010800000`	国家税务总局北京市海淀区税务局
门头沟区	`11010900000`	国家税务总局北京市门头沟区税务局
房山区	`11011100000`	国家税务总局北京市房山区税务局
通州区	`11011200000`	国家税务总局北京市通州区税务局
顺义区	`11011300000`	国家税务总局北京市顺义区税务局

编码规则详解

编码结构分解

11位编码结构

XX XX XX XXX XX
│  │  │  │   │
│  │  │  │   └── 顺序码 (2位)
│  │  │  └------ 乡镇级代码 (3位)
│  │  └--------- 县级代码 (2位)
│  └------------ 市级代码 (2位)
└--------------- 省级代码 (2位)

特殊编码规则

编码类型	规则	示例	说明
省级汇总	后9位为0	`11000000000`	表示省级税务机关
市级汇总	后7位为0	`11010000000`	表示市级税务机关
县级汇总	后5位为0	`11010100000`	表示县级税务机关
乡镇级	后2位为0	`11010100100`	表示乡镇级税务机关
基层税务所	完整11位	`11010100101`	具体税务所代码

API使用示例

查询税务机关信息

请求示例

GET /api/v1/tax-authority/info?code=11010500000 HTTP/1.1
Host: api.huaneng.com
X-App-Key: your_app_key
X-Timestamp: 1640995200000
X-Signature: your_signature

响应示例

{
    "code": 0,
    "message": "success",
    "data": {
        "tax_authority_code": "11010500000",
        "tax_authority_name": "国家税务总局北京市朝阳区税务局",
        "level": "district",
        "parent_code": "11010000000",
        "region_name": "北京市朝阳区",
        "address": "北京市朝阳区朝阳门外大街甲10号",
        "phone": "010-12366",
        "postal_code": "100020",
        "enabled": true
    },
    "timestamp": 1640995200000,
    "request_id": "req_123456789"
}

数据验证规则

编码验证

验证项	规则	正则表达式	示例
格式验证	11位数字	`^\d{11}$`	`11010500000`
省级编码	后9位为0	`^\d{2}0{9}$`	`11000000000`
市级编码	后7位为0	`^\d{4}0{7}$`	`11010000000`
县级编码	后5位为0	`^\d{6}0{5}$`	`11010100000`

常见问题

Q&A

Q: 如何获取最新的税务机关编码？

A: 可以通过税务机关编码查询接口获取最新的编码信息，或下载官方发布的编码表。

Q: 编码发生变更怎么办？

A: 系统会自动同步最新的编码变更，建议定期调用查询接口获取更新。

Q: 如何验证编码的有效性？

A: 使用税务机关编码验证接口，系统会返回编码的详细信息和有效性状态。