获取商户可开具的商品和服务税收分类编码对照表

更新时间：2024.10.25

查询商户在微信支付商户平台中配置的电子发票税收分类编码对照表。

接口说明

支持商户：【普通服务商】

请求方式：【GET】/v3/new-tax-control-fapiao/merchant/tax-codes

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

query 查询参数

sub_mchid 　选填 string(32)

【子商户号】微信支付分配的子商户号，服务商模式下必传

offset 　必填 integer

【本次查询的起始位置】本次查询的起始位置

limit 　必填 integer

【本次查询的最大数量】本次查询的最大数量

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/new-tax-control-fapiao/merchant/tax-codes?sub_mchid=1900000109&offset=0&limit=5 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数
折叠全部参数

200 OK

offset 　必填 integer

【本次查询的起始位置】本次查询的起始位置

limit 　必填 integer

【本次查询的最大数量】本次查询的最大数量

links 　选填 object

【相关链接】相关链接

属性

next 　选填 string(1024)

【下一页链接】使用同样的limit进行下一页查询时的请求链接。如果已经到最后时，为空

prev 　选填 string(1024)

【上一页链接】使用同样的limit进行上一页查询时的请求链接。如果是第一页，为空

self 　选填 string(1024)

【当前链接】当前的请求链接

data 　选填 array[object]

【本次查询到的数据】本次查询到的商品及税收分类编码对照表

属性

goods_name 　必填 string(128)

【由商户自定义的货物或应税劳务、服务名称】由商户自定义的货物或应税劳务、服务名称

goods_id 　必填 integer

【企业侧维护的货物或应税劳务、服务编码】企业侧维护的货物或应税劳务、服务编码。若使用在电子发票商户平台配置的商品类型进行开票时，需要传该编号

goods_category 　必填 string(128)

【税局侧规定的货物或应税劳务、服务分类名称】税局侧规定的货物或应税劳务、服务分类名称

tax_code 　必填 string(32)

【税局侧规定的货物或应税劳务、服务税收分类编码】税局侧规定的货物或应税劳务、服务税收分类编码

tax_rate 　必填 integer

【税率】税率，单位为万分之一，如1300代表13%

tax_prefer_mark 　必填 string

【税收优惠政策标识】税收优惠政策标识

可选取值：

NO_FAVORABLE: 无优惠

OUTSIDE_VAT: 不征税

VAT_EXEMPT: 免税

NORMAL_ZERO_RATED: 普通零税率

EXPORT_ZERO_RATED: 出口零税率

total_count 　必填 integer

【总记录数】总记录数

应答示例

200 OK

1{
2  "offset" : 0,
3  "limit" : 5,
4  "links" : {
5    "next" : "/v3/new-tax-control-fapiao/xxx?offset=2&limit=5",
6    "prev" : "/v3/new-tax-control-fapiao/xxx?offset=0&limit=5",
7    "self" : "/v3/new-tax-control-fapiao/xxx?offset=1&limit=5"
8  },
9  "data" : [
10    {
11      "goods_name" : "example_goods_name",
12      "goods_id" : 1,
13      "goods_category" : "出租汽车客运服务",
14      "tax_code" : "3010101020203000000",
15      "tax_rate" : 1300,
16      "tax_prefer_mark" : "NO_FAVORABLE"
17    }
18  ],
19  "total_count" : 20
20}
21

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	请使用正确的参数重新调用
401	SIGN_ERROR	签名错误或签名信息不完整	请检查签名参数和方法是否都符合签名算法要求
403	NO_AUTH	商户无权限	请检查是否已经开通电子发票产品相关功能权限，若是服务商模式，还需确认子商户是否接受了服务商的邀请
429	FREQUENCY_LIMITED	频率超限	请降低请求接口频率

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服