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

qimen.alibaba.einvoice.core.apply (发票中台-间连模式发票申请)

发起发票申请

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
payer_email	String	可选	test@aa.com	最大长度：100	收票邮箱
invoice_items	InvoiceApplyItemsDTO []	可选		最大列表长度：999	发票明细
└ amount String 必须 105.00 交易金额（含税） └ quantity String 可选 1 数量 └ item_id String 可选 12345678 商品id └ tax_price String 可选 100.00 单价（含税） └ specification String 可选 I型型号 └ discount String 可选 0 优惠金额（含税） └ item_name String 必须小米充电宝商品名称/货物名称 └ biz_order_ext String 可选 2020-09-14 11:25:33 明细所关联订单的业务附加信息。酒店场景下传：入住时间~离店时间的时间区间。格式为：yyyy-MM-dd HH:mm:ss,yyyy-MM-dd HH:mm:ss └ tax_rate String 可选 0.05 税率 └ item_no String 可选 1010101010000000000 发票项目编号（或商品编号），简称为税编 └ unit String 可选个单位 └ zero_rate_flag Number 可选 3 0税率标识，只有税率为0的情况才传入该字段 └ biz_memo String 可选测试开票明细所关联的业务备注信息 └ biz_order_id String 可选 121343 明细所关联的业务平台订单ID
payer_logistics_info	PayerLogisticsInfoDTO	可选			购方收票物流信息
└ contact_name String 可选李四收件人姓名 └ contact_addr String 可选杭州市西湖区收件人地址 └ contact_mobile String 可选 13800987240 收件人电话
payer_phone	String	可选	13500728463	最大长度：20	购方电话，专票必填
promise_time	String	可选	2020-09-18 10:00:00	最大长度：20	预约取票时间。格式：yyyy-MM-dd HH:mm:ss
payer_bank_account_id	String	可选	62209132135321321	最大长度：25	购方银行账号，专票必填。
payer_memo	String	可选	测试	最大长度：200	购方开票备注。不会显示在票面
auto_create_invoice	Boolean	可选	true		当前申请单是否自动开票。当业务前台传入了该字段时，以前台传入的值为准。当前台未传值时，读取商户在后台维护的自动开票配置。 true: 申请单会自动转开票请求，调用税控进行开票。 false: 申请单数据会先落地，状态为申请中。不会发起开票请求。适用于商户需要人工审核之后，再确认开票的场景。
platform_code	String	必须	FZ	最大长度：16	业务平台code，阿里发票平台分配
invoice_kind	Number	必须	0	最大值：10 最大长度：2	开票发票类型可选值： 0: 电票 1：纸质普票 2：纸质专票 3:电子专票
business_type	Number	可选	0	最大长度：2	抬头类型。可选值： 0：个人 1：企业
apply_id	String	必须	1321	最大长度：32	发票申请id
invoice_type	String	可选	blue	最大长度：10	开票类型，可选值：blue/red
payer_register_no	String	可选	881321A88YW3324121	最大长度：20	购方方税务登记证号，由大写字母或数字组成，长度要求15~20位。开企业抬头时必填，专票必填。
receive_mobile	String	可选	13508672647	最大长度：20	收票电话
payer_name	String	必须	张三	最大长度：100	购方抬头
platform_user_id	String	必须	12023456	最大长度：32	业务平台商户id/店铺用户id
payer_address	String	可选	浙江省杭州市余杭区文一西路xxx号	最大长度：100	购方地址，专票必填。
payer_bank_name	String	可选	中国农业银行	最大长度：75	购方开户行名称,专票必填。
apply_amount	String	可选	100.00	最大长度：16	合计实付金额（申请开票的总金额，含税），格式为2位小数。开红票时传正数。需满足公式：开票总金额(invoiceAmount) = 各项明细的交易金额(amount)之和 - 各项明细的优惠金额(discount)之和
apply_end_time	String	可选	2020-10-01 10:00:00	最大长度：20	申请的自动超时结束时间，超时后申请单自动完结。格式：yyyy-MM-dd HH:mm:ss
payee_register_no	String	可选	QWERT1234567890987		销方税务登记证号，长度要求15~20位。传了此参数，则使用传入的销方税号进行开票。未传则自动选择商户入驻/设置的税号进行开票。
apply_mode	String	可选	normal		发票申请模式，可选值： pre_apply_url: URL预申请模式；适用于扫码开票（一单一码）的业务场景：业务前台提交开票金额等信息，请求阿里发票平台生成一个对应的发票申请页面URL。用户可在该页面中填写抬头等信息，然后提交正式的发票申请。 normal(默认为此模式): 正式提交用户的发票申请，商户根据此发票申请自动或审核开票。扫码开票生成代开URL场景下，必传，传固定值：pre_apply_url
platform_tid	String	可选	100011101		业务平台发票申请对应的主订单号。
device_id	String	可选	1		指定的开票税控设备ID; 传了此参数，则使用传入的税控设备进行开票。未传则自动选择商户设置的税控设备进行开票。

响应参数

名称	类型	示例值	描述
result_msg	String	成功	错误码对应的描述信息
success	String	true	是否成功
result	Struct	applying	返回信息
└ apply_status String applying 申请状态 └ apply_url String https://www.taobao.com/xxx 生成的发票申请页面URL, 用户可在该页面中填写抬头等信息，然后提交正式的发票申请。当apply_mode=create_apply_url 时必须返回。
result_code	String	0	失败时的错误码

请求示例

{"payer_email":"test@aa.com","invoice_items":[{"amount":"105.00","quantity":"1","item_id":"12345678","tax_price":"100.00","specification":"I型","discount":"0","item_name":"小米充电宝","tax_rate":"0.05","item_no":"1010101010000000000","unit":"个","biz_order_ext":"2020-09-14 11:25:33","zero_rate_flag":3,"biz_memo":"测试开票","biz_order_id":"121343"}],"apply_mode":"normal","platform_tid":"100011101","payer_phone":"13500728463","payer_bank_account_id":"62209132135321321","auto_create_invoice":true,"business_type":0,"apply_id":"1321","invoice_type":"blue","payer_register_no":"881321A88YW3324121","platform_user_id":"12023456","payer_address":"浙江省杭州市余杭区文一西路xxx号","payer_bank_name":"中国农业银行","receive_mobile":"13508672647","payee_register_no":"QWERT1234567890987","device_id":"1","apply_end_time":"2020-10-01 10:00:00","payer_logistics_info":{"contact_name":"李四","contact_addr":"杭州市西湖区","contact_mobile":"13800987240"},"promise_time":"2020-09-18 10:00:00","payer_memo":"测试","platform_code":"FZ","invoice_kind":0,"payer_name":"张三","apply_amount":"100.00"}

响应示例

{
    "result_msg":"成功",
    "success":"true",
    "result":{
        "apply_status":"applying",
        "apply_url":"https:\/\/www.taobao.com\/xxx"
    },
    "result_code":"0"
}

验签示例

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

错误码解释

错误码	错误描述	解决方案
isp.http-read-timeout
isp.http-connection-timeout

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

电子发票

qimen.alibaba.einvoice.core.apply (发票中台-间连模式发票申请)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ