开发者AppKey税盘绑定

接口说明

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

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

地址

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

请求参数

参数名称	类型	必填	描述	示例
taxpayer_id	string	是	开票方纳税人识别号(15~20位数字或者大写字母)	91469027MA5RH09M0R
product_type	string	是	开票产品类型 0：税盘托管（含税务ukey） 1：云票儿发票助手（PC客户端） 2：区块链发票（深圳、云南） 4：全电发票	0
service_type	string	否	开票服务类型 1：税控服务器托管 2：税控单机设备（云票儿发票助手） 3：深圳区块链发票 4：云南区块链发票 5：金税盘托管 9：全电发票助手版	1
remark	string	否	备注
terminal_code	string	是	税盘号 航信金税盘：主、分机号（如0、1...） 百旺税控盘：12位盘号（如591234567890） 税务UKEY：12位盘号（如667123456789） 区块链：传EPID 全电发票：传税号	0
terminal_type	int	是	税盘类型 1：航信金税盘 2：百旺税控盘 3：区块链 4：税务UKey 6：全电发票
terminal_no	string	否	金税盘正面玻璃窗12位税盘编号 terminal_type为“1、航信金税盘”时必传 全电发票：传税号	661234567890
region_code	string	是	地区行政区域编码（全电必填，定义见编码表）
terminal_ext_no	string	否	金税盘对应的分机号（如：0、1...） terminal_type为“1、航信金税盘”时必传，可登录开票软件查看	0
abilities	array	否
abilities.invoice_type_code	string	否	可开票种 004增值税专票 005机动车发票 006二手车发票 007增值税普票 025增值税卷票 026电子普票 028电子专票 032区块链发票 082全电普通发票 081：全电电子专票 082：全电电子普票 085：全电纸质专票 086：全电纸质普票 默认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"
}