接入文档 /基础数据/税收分类编码

税收分类编码

开票明细必须对应税局的税收分类编码（19 位）。推荐在业务系统中为商品预先维护编码与税率，以下接口用于按商品名称匹配编码、查询编码简称以及浏览编码库。也可以在控制台「税收分类编码规则」中配置名称匹配规则，开票时不传编码由系统匹配。

按商品名称匹配编码

POST/tax-code/product

根据商品名称智能匹配税收分类编码，一次可传多个名称。该服务按次计费，额度不足时返回 调用次数不足。

参数	类型	必填	说明
appKey	string	条件必填	服务密钥 Key，与 appSecret 成对使用；传了 accessToken 时可不传
appSecret	string	条件必填	服务密钥 Secret
accessToken	string	条件必填	访问令牌，通过获取访问令牌接口获取；传了 accessToken 则无需 appKey / appSecret
taxNumber	string	必填	企业纳税人识别号，指定本次操作的开票企业；必须是该密钥已关联的企业
names	array	必填	商品 / 服务名称数组

json

{
  "appKey": "你的appKey",
  "appSecret": "你的appSecret",
  "taxNumber": "91320211MA1WML8X6T",
  "names": ["技术服务费", "笔记本电脑"]
}

json

{
  "code": 1,
  "message": "获取成功",
  "content": [
    { "code": "3040201010000000000", "name": "信息系统服务", "shortName": "生产生活服务", "rate": 0.06 },
    { "code": "1090511010000000000", "name": "便携式计算机", "shortName": "计算机设备", "rate": 0.13 }
  ]
}

字段	类型	说明
code	string	税收分类编码（19 位）
name	string	货物与劳务名称
shortName	string	商品和服务分类简称（票面 `简称` 中的内容）
rate	double	推荐税率，匹配失败时为 `null`

按编码查询简称

POST/tax-code/short-name

参数	类型	必填	说明
appKey	string	条件必填	服务密钥 Key，与 appSecret 成对使用；传了 accessToken 时可不传
appSecret	string	条件必填	服务密钥 Secret
accessToken	string	条件必填	访问令牌，通过获取访问令牌接口获取；传了 accessToken 则无需 appKey / appSecret
taxNumber	string	必填	企业纳税人识别号，指定本次操作的开票企业；必须是该密钥已关联的企业
nos	array	必填	税收分类编码数组

json

{
  "appKey": "你的appKey",
  "appSecret": "你的appSecret",
  "taxNumber": "91320211MA1WML8X6T",
  "nos": ["3040201010000000000"]
}

json

{
  "code": 1,
  "message": "获取成功",
  "content": [
    { "no": "3040201010000000000", "shortName": "生产生活服务" }
  ]
}

编码树

GET/tax-code/tree

返回税收分类编码库的树形结构（货物、劳务、服务、无形资产、不动产等大类及其子级），数据来源于 EasyAPI 编码库，结构较大，建议缓存。

参数	类型	必填	说明
appKey	string	条件必填	服务密钥 Key，与 appSecret 成对使用；传了 accessToken 时可不传
appSecret	string	条件必填	服务密钥 Secret
accessToken	string	条件必填	访问令牌，通过获取访问令牌接口获取；传了 accessToken 则无需 appKey / appSecret
taxNumber	string	必填	企业纳税人识别号，指定本次操作的开票企业；必须是该密钥已关联的企业

编码列表

GET/tax-code/list

分页查询编码库，支持按上级编码与关键字过滤，返回 EasyAPI 编码库的分页结果。

参数	类型	必填	说明
appKey	string	条件必填	服务密钥 Key，与 appSecret 成对使用；传了 accessToken 时可不传
appSecret	string	条件必填	服务密钥 Secret
accessToken	string	条件必填	访问令牌，通过获取访问令牌接口获取；传了 accessToken 则无需 appKey / appSecret
taxNumber	string	必填	企业纳税人识别号，指定本次操作的开票企业；必须是该密钥已关联的企业
parentId	int	选填	上级编码 ID，不传查询顶级
q	string	选填	关键字（编码或名称）
page	int	选填	页码，从 0 开始，默认 0
size	int	选填	每页条数，默认 10

bash

curl "https://fapiao-api.easyapi.com/tax-code/list?appKey=你的appKey&appSecret=你的appSecret&taxNumber=91320211MA1WML8X6T&q=技术服务&page=0&size=10"

错误信息

message	说明
调用次数不足	商品名称匹配额度用完
参数不能为空	`nos` 为空