创建财政电子票据模板

最后一次编辑于 2025-07-09

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。

接口英文名:notaxinvoicecreatecard

财政局可以通过这个接口帮助执收单位创建一张财政电子票据模板。同一个财政局可以对应多个执收单位,同一个执收单位,使用同一个card_id,不同的执收单位,使用不同的card_id。

1. 调用方式

HTTPS 调用

POST https://api.weixin.qq.com/nontax/createbillcard?access_token=ACCESS_TOKEN

云调用

  • 本接口不支持云调用。

第三方调用

  • 本接口不支持第三方平台调用。

2. 请求参数

查询参数 Query String Parameters

参数名类型必填说明
access_tokenstring是接口调用凭证,可使用 access_token

请求体 Request Payload

参数名类型必填说明
base_infoobject是财政电子票据信息
payeestring是收款方(开票方)全称,显示在财政电子票据详情内

Body.base_info Object Payload

财政电子票据信息

参数名类型必填说明
logo_urlstring是财政局LOGO,请参考上传图片接口

3. 返回参数

返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
card_idstring票据card_id

4. 注意事项

本接口无特殊注意事项

5. 代码示例

请求示例

{
    "invoice_info" : {
        "payee" : "测试非税票据",
        "base_info" : {
            "logo_url": : "http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0"
        }
    }
}

返回示例

{
    "errcode": 0, 
    "errmsg": "ok", 
    "card_id": "pjZ8Yt9WoOePThU0NfUKz5-tBEWU"
}

6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。

错误码错误描述解决方案
40001invalid credential  access_token isinvalid or not latestaccess_token 无效或不为最新获取的 access_token,请开发者确认access_token的有效性

7. 适用范围

本接口在不同账号类型下的可调用情况:
公众号服务号
需申请 需申请
  • 需申请:表示该账号类型需提交此场景的申请并审核通过后方可调用。
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口。