# 创建发票卡券模板

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

接口英文名：invoiceplatformcreatecard

通过本接口可以为创建一个商户的发票卡券模板，为该商户配置发票卡券模板上的自定义栏位。创建发票卡券模板生成的card_id将在创建发票卡券时被引用，故创建发票卡券模板是创建发票卡券的基础。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/card/invoice/platform/createcard?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用

# 第三方调用

本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：26
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String parameters`

参数名	类型	必填	说明
access_token	string	是	接口调用凭证，可使用 access_token、authorizer_access_token

# 请求体 `Request Payload`

参数名	类型	必填	说明
invoice_info	object	是	发票模板对象

# Body.invoice_info `Object Payload`

发票模板对象

参数名	类型	必填	说明
base_info	object	是	发票卡券模板基础信息
payee	string	是	收款方（开票方）全称，显示在发票详情内。故建议一个收款方对应一个发票卡券模板
type	string	是	发票类型

# Body.invoice_info.base_info `Object Payload`

发票卡券模板基础信息

参数名	类型	必填	说明
logo_url	string	是	发票商家 LOGO，请使用永久素材接口
title	string	是	收款方（显示在列表），上限为 9 个汉字，建议填入商户简称
custom_url_name	string	否	开票平台自定义入口名称，与 custom_url 字段共同使用，长度限制在 5 个汉字内
custom_url	string	否	开票平台自定义入口跳转外链的地址链接 , 发票外跳的链接会带有发票参数，用于标识是从哪张发票跳出的链接
custom_url_sub_title	string	否	显示在入口右侧的 tips ，长度限制在 6 个汉字内
promotion_url_name	string	否	营销场景的自定义入口
promotion_url	string	否	入口跳转外链的地址链接，发票外跳的链接会带有发票参数，用于标识是从那张发票跳出的链接
promotion_url_sub_title	string	否	显示在入口右侧的 tips ，长度限制在 6 个汉字内

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
errcode	string	错误码
errmsg	string	错误信息
card_id	string	当错误码为 0 时，返回发票卡券模板的编号，用于后续该商户发票生成后，作为必填参数在调用插卡接口时传入

# 4. 注意事项

本接口无特殊注意事项

# 5. 代码示例

请求示例

{
  "invoice_info": {
    "base_info": {
      "logo_url": "http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
      "title": "xx公司",
      "custom_url_name": "xyz",
      "custom_url": "xyz",
      "custom_url_sub_title": "xyz",
      "promotion_url_name": "puname",
      "promotion_url": "purl",
      "promotion_url_sub_title": "ptitle",
    },
    "type": " 广东省增值税普通发票 ",
    "payee": " 测试 - 收款方 ",
  }
}

返回示例

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

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码

错误码	错误描述	解决方案
40078	invalid card status	card_id 未授权。若开发者使用沙箱环境报此错误，主要因为未将调用接口的微信添加到测试把名单；若开发者使用正式环境报此错误，主要原因可能为：调用接口公众号未开通卡券权限，或创建 card_id 与插卡时间间隔过短。
72015	unauthorized create invoice	没有操作权限，请检查是否已开通相应权限。
72017	invalid invoice title	发票抬头不一致
72023	invoice has been lock by others	发票已被其他公众号锁定。一般为发票已进入后续报销流程，报销企业公众号/企业号/App锁定了发票。
72024	invoice status error	发票状态错误
72025	invoice token error	wx_invoice_token 无效
72028	invoice never set pay mch info	未设置微信支付商户信息
72029	invoice never set auth field	未设置授权字段
72030	invalid mchid	mchid 无效
72031	invalid params	参数错误。可能为请求中包括无效的参数名称或包含不通过后台校验的参数值
72035	biz reject insert	财政电子票据已经被拒绝领取。若 order_id 被用作参数调用过拒绝领取接口，再使用此 order_id 插卡机会报此错误
72036	invoice is busy	财政电子票据正在被修改状态，请稍后再试
72038	invoice order never auth	订单没有授权，可能是财政局的s_pappid 、执收单位 appid 、订单 order_id 不匹配
72039	invoice must be lock first	订单未被锁定
72040	invoice pdf error	Pdf 无效，请提供真实有效的 pdf
72042	billing_code and billing_no repeated	票据号码和票据代码重复
72043	billing_code or billing_no size error	票据号码和票据代码错误
72044	scan text out of time	发票抬头二维码超时

# 7. 适用范围

本接口在不同账号类型下的可调用情况：

公众号	服务号
需申请	需申请

需申请：表示该账号类型需提交此场景的申请并审核通过后方可调用
其他未明确声明的账号类型，如无特殊说明，均不可调用此接口；