文档中心 > API类目 > 电子发票

qimen.alibaba.einvoice.core.inv.create (直连开票提交开票申请)

阿里发票中台直连税控ISV请求开票，该接口同步返回开票请求的受理结果。待异步开票后，ISV再调用发票结果回传接口，回传开票结果。

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
serial_no	String	必须	TB1001_1331	最大长度：64	开票流水号/序列号，唯一标志一笔开票请求，由于阿里发票中台生成。幂等时需要返回幂等结果，不能报错
platform_code	String	必须	TB	最大长度：16	业务平台Code, 阿里发票平台分配
invoice_kind	Number	必须	1	最大长度：2	开票发票类型，可选值： 0: 电子普票 1：纸质普票 2：纸质专票 3：电子专票
invoice_type	String	必须	blue	最大长度：10	发票(开票)类型，可选值： blue: 蓝票 red: 红票
business_type	Number	必须	0	最大长度：2	抬头类型。可选值： 0：个人 1：企业
device_id	String	可选	100101	最大长度：64	指定的开票税控设备ID; 传了此参数，则使用传入的税控设备进行开票。
payer_name	String	必须	张三	最大长度：100	购方抬头
payer_register_no	String	可选	2015020123123	最大长度：20	购方方税务登记证号，由大写字母或数字组成，长度要求15~20位。开企业抬头时必填，专票必填。
payer_phone	String	可选	18234561212	最大长度：20	购方电话，专票必填。
payer_address	String	可选	浙江省杭州市余杭区文一西路xxx号	最大长度：100	购方地址，专票必填。
payer_bank_account_id	String	可选	123412341234	最大长度：25	购方银行账号，专票必填。
payer_bank_name	String	可选	招商银行	最大长度：100	购方开户行名称，专票必填。
payer_email	String	可选	mytest@xxx.com	最大长度：100	购方电子邮箱，需满足邮箱格式。格式要求：\\w+([-+.]\\w+)@\\w+([-.]\\w+)\\.\\w+([-.]\\w+)* 传了此参数，则需要在发票开具成功后，发邮件通知。
recieve_mobile	String	可选	13388889999	最大长度：20	购方手机号码，用于收票。格式要求为11位数字组成的手机号码。传了此参数，则需要在发票开具成功后，发短信通知
payee_register_no	String	必须	QWERTY1234567890	最大长度：20	销方税务登记证号
payee_name	String	必须	阿里测试企业	最大长度：80	销方名称
payee_phone	String	必须	16534214567	最大长度：20	销方电话
payee_address	String	必须	杭州市西溪路	最大长度：100	销方地址销方电话加地址不超出100字符
payee_bank_account_id	String	可选	12523123213412341234	最大长度：25	销方银行帐号
payee_bank_name	String	可选	招商银行	最大长度：100	销方开户行名称，开户行账号加名称不超出100字符
payee_operator	String	必须	小张	最大长度：16	开票人
payee_checker	String	可选	小林	最大长度：16	复核人
payee_receiver	String	可选	小张	最大长度：16	收款人
invoice_memo	String	可选	电子发票测试	最大长度：200	发票备注，会显示在票面
normal_invoice_code	String	可选	111100000000	最大长度：12	原发票代码(开红票时必须)
normal_invoice_no	String	可选	00004349	最大长度：8	原发票号码(开红票时必须)
red_notice_no	String	可选	12312312	最大长度：50	红字通知单号，专票冲红时需要
special_flag	String	可选	02	最大长度：2	特殊票种标识，可选值： “00”非特殊票种（默认值） “02”农产品收购 “06”抵扣通行费 “07”其它通行费 “08”成品油销售 “18”成品油专票负数发票
levy_type	String	可选	0	最大长度：2	征税方式，0普通征收，1减按征收，2差额征收
invoice_amount	String	必须	1170.00	最大长度：16	合计含税金额（开票金额），格式为2位小数。当开红票时，该字段为负数。
sum_price	String	必须	1000.00	最大长度：16	合计金额（不含税），格式为2位小数。当开红票时，该字段为负数。
sum_tax	String	必须	170.00	最大长度：16	合计税额，格式为2位小数。当开红票时，该字段为0或负数。
deduct_amount	String	可选	10	最大长度：10	扣除额
invoice_items	InvoiceItemDTO []	必须		最大列表长度：100	电子发票明细，最大100行
└ tax String 必须 130.00 税额，格式为2位小数 └ sum_price String 必须 1000.00 总价 (不含税)，格式为2位小数单位：元，精度2位小数 └ amount String 必须 1130.00 价税合计 (等于sumPrice和tax之和)，单位：元，格式为2位小数，精度2位小数 └ unit String 可选袋单位。折扣行不能传，非折扣行必传 └ specification String 可选 X100 规格型号 └ quantity String 可选 10 数量，最多6位小数。折扣行此参数不能传，非折扣行必传。存在则需>0 └ price String 可选 100.00 单价（不含税），格式为2位小数。最大支持6位小数，不足2位小数时需转化为2位小数格式。折扣行此参数不能传，非折扣行必传 └ tax_rate String 必须 0.13 税率，支持3位小数，如：0.00, 0.03, 0.13 └ item_no String 必须 1010101010000000000 发票项目编号（或商品编号） └ row_type Number 必须 0 发票行性质。0表示正常行，1表示折扣行，2表示被折扣行。比如充电器单价100元，折扣10元，则明细为2行，充电器行性质为2，折扣行性质为1。如果充电器没有折扣，则值应为0。 └ item_name String 必须小麦发票项目名称（或商品名称） └ zero_rate_flag String 可选 2 0税率标识，只有税率为0的情况才有值，0=出口零税率，1=免税，2=不征收，3=普通零税率
platform_tid	String	可选	100011101	最大长度：64	业务平台发票申请对应的订单号

响应参数

名称	类型	示例值	描述
result	Boolean	true	申请结果，true表示成功，false表示失败
result_code	String	0	失败时的错误码
result_msg	String	成功	失败时的错误描述信息
success	Boolean	true	是否成功

请求示例

{"deduct_amount":"10","payer_email":"mytest@xxx.com","invoice_items":[{"amount":"1130.00","unit":"袋","quantity":"10","row_type":0,"price":"100.00","zero_rate_flag":"2","specification":"X100","tax":"130.00","item_name":"小麦","tax_rate":"0.13","sum_price":"1000.00","item_no":"1010101010000000000"}],"payee_bank_name":"招商银行","platform_tid":"100011101","payer_phone":"18234561212","payee_receiver":"小张","payer_bank_account_id":"123412341234","recieve_mobile":"13388889999","normal_invoice_code":"111100000000","invoice_amount":"1170.00","payee_bank_account_id":"12523123213412341234","payee_operator":"小张","business_type":0,"invoice_type":"blue","payer_register_no":"2015020123123","levy_type":"0","payer_address":"浙江省杭州市余杭区文一西路xxx号","payer_bank_name":"招商银行","invoice_memo":"电子发票测试","normal_invoice_no":"00004349","device_id":"100101","payee_register_no":"QWERTY1234567890","payee_address":"杭州市西溪路","red_notice_no":"12312312","special_flag":"02","payee_phone":"16534214567","platform_code":"TB","invoice_kind":1,"sum_tax":"170.00","payee_name":"阿里测试企业","payer_name":"张三","payee_checker":"小林","serial_no":"TB1001_1331","sum_price":"1000.00"}

响应示例

{
    "result":true,
    "result_code":"0",
    "result_msg":"成功",
    "success":true
}

验签示例

{"result_msg":"Illegal request","success":"false","result_code":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

电子发票

qimen.alibaba.einvoice.core.inv.create (直连开票提交开票申请)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ