检查子商户开票功能状态

更新时间:2025.12.03

服务商通过此接口,查询受服务商电子发票能力邀请链接邀请的子商户的电子发票功能接入详情。若商户已完成授权开通,接口将返回商户在第三方开票模式和数电发票模式下的完整授权与接入状态。

接口说明

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

请求方式:【GET】/v3/new-tax-control-fapiao/merchant/{sub_mchid}/check-status

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

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

请求参数

Header  HTTP头参数

 Authorization  必填 string

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


 Accept  必填 string

请设置为application/json


path  路径参数

 sub_mchid  必填   string(32)

【子商户号】 微信支付分配的子商户号,具体请参考服务商模式开发必要参数说明

请求示例

curl
Java
Go

GET

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

应答参数
折叠全部参数

200 OK

 sub_mchid  必填   string(32)

【子商户号】 微信支付分配的子商户号


 third_mode  选填   object

【第三方开票模式】 第三方开票模式相关信息,商户开通第三方开票模式时返回

属性

 status  必填   string

【第三方/自建发票能力接入状态】 第三方/自建发票能力接入状态

可选取值

  • DISABLED:  未接入

  • ENABLED:  已接入


 digital_tax_mode  选填   object

【数电发票模式】 数电发票模式相关信息,商户开通数电发票模式时返回

属性

 status  必填   string

【接入状态】 数电发票接入状态

可选取值

  • APPROVAL_PENDING:  请等待当地税务机关审批

  • ACCESS_CONFIRMED_PENDING:  请商户法定代表人/财务负责人登陆电子税局或者国家税务总局乐企数字开放平台进行确认

  • ABILITY_CONFIRMED_PENDING:  请商户法定代表人/财务负责人登录电子税局进行能力授权确认

  • BILLING_PERSON_REGISTER_PENDING:  请商户法定代表人/财务负责人登陆电子税局进行开票员设置

  • BILLING_PERSON_CONFIRMED_PENDING:  请开票员登陆电子税局-乐企进行授权

  • SECURITY_SETTING_PENDING:  请商户法定代表人/财务负责人登陆电子税局进行设置开票安全验证有效期

  • APPLY_FAILED:  税局申请不通过,请查看接入失败原因

  • DISABLED:  未接入或商户解除授权,请重新发起能力邀请商户确认授权

  • ENABLED:  商户数电开票能力,税局接入完成

  • RESOURCE_EXPIRED:  商户使用的数电服务商资源过期,请联系数电服务商


 billing_person_info  选填   array[object]

【开票人信息】 开票人信息

属性

 id  选填   string(128)

【开票人ID】 用于唯一标识一个开票人的ID。申请开具数电发票时,需要传入开票人ID。当数电发票接入状态接入完成时,数电发票开票人ID一定存在


 name  选填   string(40)

【开票人姓名】 脱敏后的开票人姓名,格式为:除最后一个字外其它字用*填充的姓名+空格+身份证后四位。申请开具数电发票时,需要传入开票人姓名。当数电发票接入状态接入完成时,数电发票开票人姓名一定存在


 access_time  选填   string

【接入时间】 数电发票接入完成的时间,遵循RFC3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE


 expired_time  选填   string

【过期时间】 税局设置的安全校验过期时间,遵循RFC3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE


 access_fail_reason  选填   string(1024)

【接入失败原因】 商户接入数电发票失败时,接入失败的原因展示


 ability_info  选填   array[object]

【能力信息】 已申请的数电发票能力的详情信息

属性

 type  必填   string

【能力类型】 数电发票能力编码

可选取值

  • BASE_ABILITY:  基础开票能力(适合餐饮、酒店等)

  • REAL_ESTATE_ABILITY:  不动产租赁能力(适合停车场等)

  • REFINED_OIL_ABILITY:  成品油能力(适合石油石化等行业)


 status  必填   string

【能力授权状态】 数电发票能力授权状态

可选取值

  • AUTHORIZED:  数电开通能力已授权

  • AUTHORIZE_PENDING:  需要财务负责人或者法定代表人,登录电子税局系统,进行开票能力授权

  • DEAUTHORIZED:  商户已经解除与联用平台在税局系统的关联关系

  • AUTHORIZE_FAILED:  能力授权失败


 authorize_fail_reason  选填   string(1024)

【能力授权失败原因】 商户新增数电发票能力授权失败时,授权失败的原因展示

应答示例

200 OK

1{
2  "sub_mchid" : "1900000109",
3  "third_mode" : {
4    "status" : "ENABLED"
5  },
6  "digital_tax_mode" : {
7    "status" : "ENABLED",
8    "billing_person_info" : [
9      {
10        "id" : "187776276864872",
11        "name" : "**伟 0010"
12      }
13    ],
14    "access_time" : "2020-07-01T12:00:00+08:00",
15    "expired_time" : "2020-07-02T12:00:00+08:00",
16    "access_fail_reason" : "失败原因",
17    "ability_info" : [
18      {
19        "type" : "BASE_ABILITY",
20        "status" : "AUTHORIZED",
21        "authorize_fail_reason" : "失败原因"
22      }
23    ]
24  }
25}
26

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

400

INVALID_REQUEST

请求参数符合参数格式,但不符合业务规则

请使用正确的参数重新调用

403

NO_AUTH

商户无权限

请检查是否已经开通电子发票产品相关功能权限,并检查子商户是否接受了服务商的邀请

429

FREQUENCY_LIMITED

频率超限

请降低请求接口频率

 

元宝AI
反馈
目录
置顶