开发者AppKey税盘绑定

接口说明

绑定税盘到开发者的AppKey、并扣除对应资源包。可通过重复绑定同一AppKey、开票产品、服务、税盘类型，税号，税盘号（分机号），以延长对应税盘有效期，比如绑定2次一年资源包则有效期延长为二年。

注意：AppKey需被商户授权后方可绑定，如未授权请先联系商户在“云票儿·商家平台”中授权。

地址

/tax-api/invoice/terminal-bind/v1

请求参数

参数名称	类型	必填	描述	示例
taxpayer_id	string	是	开票方纳税人识别号(15~20位数字或者大写字母)	91469027MA5RH09M0R
product_type	string	是	开票产品类型<br>0：税盘托管（含税务ukey） <br/>1：云票儿发票助手（PC客户端）<br/>2：区块链发票（深圳、云南）<br>4：全电发票	0
service_type	string	否	开票服务类型<br>1：税控服务器托管<br/>2：税控单机设备（云票儿发票助手）<br/>3：深圳区块链发票<br/>4：云南区块链发票<br/>5：金税盘托管<br>9：全电发票助手版	1
remark	string	否	备注
terminal_code	string	是	税盘号<br>航信金税盘：主、分机号（如0、1...）<br/>百旺税控盘：12位盘号（如591234567890）<br/>税务UKEY：12位盘号（如667123456789）<br>区块链：传EPID<br>全电发票：传税号	0
terminal_type	int	是	税盘类型 <br/>1：航信金税盘 <br/>2：百旺税控盘 <br/>3：区块链 <br/>4：税务UKey<br/>6：全电发票
terminal_no	string	否	金税盘正面玻璃窗12位税盘编号<br/>terminal_type为“1、航信金税盘”时必传<br/>全电发票：传税号	661234567890
region_code	string	是	地区行政区域编码（全电必填，定义见编码表）
terminal_ext_no	string	否	金税盘对应的分机号（如：0、1...）<br/>terminal_type为“1、航信金税盘”时必传，可登录开票软件查看	0
abilities	array	否
abilities.invoice_type_code	string	否	可开票种<br>004增值税专票<br/>005机动车发票<br/>006二手车发票<br/>007增值税普票<br/>025增值税卷票<br/>026电子普票<br/>028电子专票<br/>032区块链发票<br/>082全电普通发票<br/>081：全电电子专票<br>082：全电电子普票<br>085：全电纸质专票<br>086：全电纸质普票<br> 默认026,可传递多个(以数组元素传递)	[{026},{004}]
is_main_disk	boolean	否	是否主盘	True
bank_name	string	否	开户银行，与银行帐号总长度不超过100字符	XX银行
bank_account	string	否	银行账号，与开户银行总长度不超过100字符	6222123456888
address	string	否	销方地址，与销方电话总长度不超过100字符	深圳市南山区大冲商务中心
phone	string	否	销方电话，与销方地址总长度不超过100字符	0555-88888888

注意：
开票人、复核人、收款人信息在开票（蓝票）接口中传递即可。

响应参数

字段	类型	必须	备注
code	int	是	错误码
message	string	否	错误描述

请求示例

{
    "taxpayer_id": "92440300MA5K0*****",
    "product_type":"0",
    "terminal_code": "91700146****",
    "terminal_type":4,
    "abilities": [{
            "invoice_type_code": "026"
        },
        {
            "invoice_type_code": "004"
        }
    ]
}

响应示例

{
    "code": 0,
    "message": "success"
}