文档中心

# 发票开具

# 接口说明

使用高灯云开放平台开具发票时，需要先充值并购买相应的资源包（如单机版或者托管等），再绑定税盘，具体信息可查看“平台指引 (opens new window)”或联系相关业务人员或财税管家；

  1. 本接口支持开具增值税电子普票、增值税纸质普通发票、增值税电子专票、增值税专用发票、增值税卷式发票、区块链电子发票。
  2. 开具纸票时此接口只返回开具数据，纸票打印请查看【发票打印 (opens new window)】接口。
  3. 测试环境仅提供区块链电子发票开具，如需测试纸质发票开具或打印，可通过线上环境通过税盘开具。

# 地址

/tax-api/invoice/blue/v1

# 请求参数

参数名称 类型 必填 最大长度（字节） 描述 示例
seller_name string 否 100 销方名称（销方票面信息）：如果填入则根据填入信息填入票面，如果不填入，则默认读取商户平台销方企业名称填入 【名称不含有特殊符号：'<' '>' '转义符' '双引号' '逗号' 空格等特殊符号】 深圳高灯计算机科技有限公司
seller_taxpayer_num string 是 20 销方纳税人识别号（销方票面信息）：即统一社会信用代码（一般是15、17、18、20位长度位数字或大写字母，字母I、O、S、V、Z除外） 91469027MA5RH09M0R
seller_address string 否 100 销方地址（销方票面信息）：如果填入则根据填入信息填入票面，如果不填入，则默认读取商户平台销方企业地址填入。
注意：地址与电话加起来长度≤100【地址不含换行符、制表符等特殊字符】		 深圳市南山区粤海街道大冲商务中心B座27楼
seller_tel string 否 20 销方电话（销方票面信息）：如果填入则根据填入信息填入票面，如果不填入，则默认读取商户平台销方企业电话填入【电话支持分机号（使用英文括号），不含换行符、制表符等特殊字符】 0755-86888888(8088)
若无座机可输入手机号：18285160000
seller_bank_name string 否 100 销方银行名称（销方票面信息）：如果填入则根据填入信息填入票面，如果不填入，则默认读取商户平台销方企业银行名称填入。
注意：银行与帐号加起来长度≤100【银行不含换行符、制表符等特殊字符】		 中国工商银行深圳南山科苑分行
seller_bank_account string 否 100 销方银行账号（销方票面信息）：如果填入则根据填入信息填入票面，如果不填入，则默认读取商户平台销方企业银行账号填入【支持数字+字母+英文括号，不能有汉字、换行符等特殊符号，首位数字不能为0】 310066690018(CNY)310066690146(USD)
title_type int 是 1 抬头类型：1：个人、政府事业单位；2：企业 1
buyer_title string 是 100 购方名称【购方票面信息，名称不含有特殊符号：'<' '>' '转义符' '双引号' '逗号' 空格等特殊符号，注意：区块链发票购方名称至少2个汉字】 深圳高灯计算机科技有限公司
buyer_taxpayer_num string 否 20 购方纳税人识别号（购方票面信息）,若抬头类型为2时，必传;即统一社会信用代码（一般是15、17、18、20位长度位数字或大写字母，字母I、O、S、V、Z除外） 91469027MA5RH09M0R
buyer_address string 否 100 购方地址（购方票面信息）：同销方地址，若开具增值税专用发票时必传。
注意：地址与电话加起来长度≤100【地址不含换行符、制表符等特殊字符】		 深圳市南山区粤海街道大冲商务中心B座27楼
buyer_phone string 否 20 购方电话（购方票面信息）：同销方电话，若开具增值税专用发票时必传。 0755-86888888(8088)
若无座机可输入手机号：18285160000
buyer_bank_name string 否 100 购方银行名称（购方票面信息）：同销方银行名称，若开具增值税专用发票时必填。 中国工商银行
buyer_bank_account string 否 100 购方银行账号（购方票面信息）：同销方银行帐号，若开具增值税专用发票时必填 310066690018(CNY)310066690146(USD)
buyer_email string 否 100 收票人邮箱（发票推送）：如果填入平台将推送发票至收票方邮箱，如果不填入，则由开发者自行推送发票 yunpiaoer@wetax.com.cn
order_id string 是 64 商户订单号：开发者接入方业务订单唯一标识 gd_1904242006002627690
invoice_type_code string 否 3 开具发票类型：默认为026
004：增值税专用发票
007：增值税普通发票
025：增值税卷式发票
026：增值税电子普通发票
028：增值税电子专用发票
032：区块链电子发票		 026
callback_url string 是 500 发票结果回传地址：接收平台推送的开票结果消息地址，可参见【开票结果异步通知】 开发者服务器地址http://www.goldentec.com/callback
drawer string 否 16 开票人姓名（票面信息）：如果填入则根据填入信息填入票面，如果不填入，则默认读取商户平台销方企业默认开票人填入 高灯云
payee string 否 16 收款人姓名（票面信息）：如果填入则根据填入信息填入票面，如果不填入，则默认读取商户平台销方企业默认收款人填入 自由薪
checker string 否 16 复核人姓名（票面信息）：如果填入则根据填入信息填入票面，如果不填入，则默认读取商户平台销方企业默认复核人填入 云费控
terminal_code string 是 12 税盘号：
1、使用PC端云票儿助手客户端时必填[航信金税盘主盘传0，航信金税盘分盘传开票机号，如：1、2、3……等，百旺税控盘传12位盘号（前面的33-不用输入），税务Ukey传盘背后12位的盘号]
2、使用税盘托管时，航信金税盘和百旺税控盘均填入12位的盘号（前面的33-或44-不用输入）
3、使用区块链进行开票时传EPID
4、使用Ukey托管：12位Ukey设备编号		 661234567789
user_openid string 否 40 商家用户标识：用户在商户侧的唯一标识 user123456
special_invoice_kind string 否 2 特殊票种标识：
金税盘：空或00一般，02 石脑油、燃料油增值税专用发票，08成品油发票，9农产品收购，10 5%按1.5%减征，11差额征收开票，18机动车专用发票
税控盘：空或00一般，01农产品销售，02农产品收购，08成品油销售，12机动车专用发票
税务UKEY：空或00一般，01农产品销售，02农产品收购，08成品油销售，12机动车专用发票		 08
zsfs string 否 1 征收方式：开具差额征税发票时必填
2：差额征税
开具普通征税发票时可以为空		 2
deduction string 否 20 差额征税扣除额【【单位：元（精确到小数点后2位）】：当 zsfs 为 2 时，此项必填 66.66
amount_has_tax string 是 20 含税总金额【单位：元（精确到小数点后2位）】 66.66
tax_amount string 是 20 总税额【单位：元（精确到小数点后2位）】 66.66
amount_without_tax string 是 20 不含税总金额【单位：元（精确到小数点后2位）】 66.66
remark string 否 180 备注（票面信息）：
1、正常发票备注不超过180字节，如是差额征税或红字发票等，系统默认会填入备注信息，默认信息长度加用户填入长度不超过180字节；
2、差额征税默认信息长度最少18字节（即金额1.00）（例：差额征税：1.00）；
3、电子红字发票默认信息长度最少46字节（即发票代码12位，发票号码8位）（例：对应正式发票代码：012345678912、号码：01234567）
4、专用红字发票默认信息长度最少50字节（即信息表编号16位）（例：开具红字增值税专用发票信息表编号0123456789012345）
5、换行符请传"\n"，且最后一个字符不能是换行符		 行程详情：2019年10月1日 15：30 深圳-北京高速
store_no string 否 100 门店编码：通过登录商户服务平台门店端可查看门店编码(如有多门店，建议必传值，否则取默认门店），云南区块链商户若需开具冠名发票必填，非云南区块链商户不传 FFX001
template int 是 1 发票模板：云南区块链商户若需开具冠名发票必填对应的模板编号，非冠名发票或其他商户传“1”。
1、普通电子发票样。2、丽江 。3、石林。 4、新版自定义模板。		 1
info (json object) 否 云南区块链商户使用冠名票发票模板时必填
info.use_date string 否 8 入园日期,使用冠名票发票模板时必填 20200217
info.ticket_name string 否 50 票据名称，使用冠名模板时必填 石林风景区门票
items list 是 项目商品明细：
专普票明细不超过8行、清单不超过2000行
电子发票明细不超过100行
items.name string 是 50 商品名称 【名称不含有特殊符号：‘<’ ‘>’ ‘/’ ‘&’ 等特殊符号】 云票儿
items.tax_code string 是 40 税收商品编码：商品所属分类商品编码，详见[税收商品编码税率表] (opens new window)（仅供参考，具体以税局发布的分类编码为准） 3040201030000000000
items.tax_type string 否 50 税收商品类别：指商品在商品编码中的分类名称 餐饮服务
items.models string 否 36 商品规格（商品票面信息）：指商品规格型号，如果填入将显示在发票票面“规格型号”栏目 MWN82CH/A
items.unit string 否 14 商品单位（商品票面信息）：如果填入将显示在发票票面“单位”栏目 个
items.total_price string 是 20 商品不含税金额 = 商品含税金额 / (1+税率)【单位：元（精确到小数点后2位）】 66.66
items.total string 否 20 商品数量：精确到8位，传items.price时必填) 1
items.price string 否 20 商品不含税单价 = 商品不含税金额 / 数量【单位：元，精确到8位小数；传items.total时必填】 66.66
items.tax_rate string 是 6 商品税率：请参照[【税收商品编码税率表】中的税率或咨询财务【最多保留小数点后3位】 0.03
items.tax_amount string 是 20 商品税额 = 商品不含税金额 * 税率【单位：元（精确到小数点后2位）】 66.66
items.discount string 否 20 含税折扣总金额：金额必须是负数【单位：元（精确到小数点后2位）】 -66.66
items.preferential_policy_flag string 否 1 优惠政策标志：
0：不使用优惠政策
1：使用优惠政策
说明：
若商品为零税率，需在零税率标识（zero_tax_flag）填写相应零税率标识，并且在增值税特殊管理（vat_special_management）填写相应的优惠说明。		 0
items.zero_tax_flag string 否 1 零税率标识：
空：非零税率
1：免税、出口零税
2：不征税
3：普通零税率
（1、2时优惠政策标识应为1，空和3时优惠政策标识应为0，非空时填入时商品税率需为0%）		 空
items.vat_special_management string 否 50 增值税特殊管理：优惠政策标志为1时该字段必传，目前支持：
免税、按5%（3%、1.5%）简易征收、不征税等		 免税

# 响应参数

字段 类型 必须 备注
state string 是 开票状态
1：已提交(如果订单已提交开票请求并且没有开票成功，平台会根据策略进行重试开票，此时本状态表示重试开票已提交， 开票结果会通过异步通知，邮箱等方式返回， 也可以通过查询接口手动进行查询)
2：已开票成功 （表示已经成功开过票了，不能再进行重复开票）
order_sn string 是 高灯方商户订单号：开发者商户订单号对应的高灯方商户订单唯一标识
invoice_id string 是 发票标识： 高灯发票唯一识别号

# 请求示例

{
	"seller_name": "深圳高灯计算机科技有限公司",
	"seller_taxpayer_num": "91469027MA5RH09M0R",
	"seller_address": "深圳市南山区粤海街道大冲商务中心B座27楼",
	"seller_tel": "0755-86888888(8088)",
	"seller_bank_name": "中国工商银行深圳南山科苑分行",
	"seller_bank_account": "310066690018(CNY)310066690146(USD)",
	"title_type": 1,
	"buyer_title": "深圳高灯云科技有限公司",
	"buyer_taxpayer_num": "91440300MA5FNDGU8Y",
	"buyer_address": "广东深圳南山",
	"buyer_phone": "18800000000",
	"buyer_bank_name": "中国工商银行",
	"buyer_bank_account": "621281240200099900000",
	"buyer_email": "Calvin@gaopeng.com",
	"order_id":"test1923d456",
	"invoice_type_code":"026",
	"callback_url":"http://test.gc365.com/invoice-callback.php",
	"drawer": "高灯云",
	"payee": "自由薪",
	"checker": "云开票",
	"terminal_code":"0",
	"user_openid": "201708022e87777ggg74",
	"special_invoice_kind": "00",
	"zsfs": "",
	"deduction": "",
	"amount_has_tax":"95.08",
	"tax_amount":"8.64",
	"amount_without_tax":"86.44",
	"remark": "备注信息",
	"store_no":"FFX001",
	"template":1,
	"info":{
		"use_date":"20200102",
		"ticket_name":"XX景区"
		},
	"items": [{
		"name": "餐费",
		"tax_code": "3040201030000000000",
		"tax_type": "餐饮服务",
		"models": "",
		"unit": "kg",
		"total": "823.1",
		"price": "16.05504799",
		"total_price": "13214.91",
		"tax_rate": "0.09",
		"tax_amount": "1189.34",
		"discount": "0",
		"preferential_policy_flag": "0",
		"zero_tax_flag": "",
		"vat_special_management": ""
	}]
}

# 响应示例

{
    "code": 0,
    "message": "success",
    "data": {
        "state": 1,
        "order_sn": "6922356261447315817",
        "invoice_id": "6922356261447315817"
    }
}

← 下一篇：发票打印 →