接入文档 /发票开具/开票模板

开票模板

为企业保存常用的开票参数模板（例如固定的购买方抬头与商品明细），每家企业最多 5 个模板，模板名称不能重复。模板内容 body 为任意 JSON 对象，由调用方自行约定并在开票时组装。

创建模板

POST/invoice/template

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

json

{
  "appKey": "你的appKey",
  "appSecret": "你的appSecret",
  "taxNumber": "91320211MA1WML8X6T",
  "name": "技术服务费模板",
  "body": {
    "category": "全电电子普通发票",
    "items": [
      { "name": "技术服务费", "no": "3040201010000000000", "taxRate": 0.06 }
    ]
  }
}

响应 content 为该企业全部模板：

json

{
  "code": 1,
  "message": "创建成功",
  "content": [
    { "name": "技术服务费模板", "body": { "category": "全电电子普通发票", "items": [] } }
  ]
}

message	说明
模板不能超过5个	已有 5 个模板
模板名称不能重复	`name` 已存在

删除模板

DELETE/invoice/template

请求体为 JSON。

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

json

{
  "code": 1,
  "message": "删除成功",
  "content": []
}

查询模板列表

GET/invoice/templates

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

json

{
  "code": 1,
  "message": "获取成功",
  "content": [
    { "name": "技术服务费模板", "body": { "category": "全电电子普通发票", "items": [] } }
  ]
}