曹操出行开放平台

发票状态查询

查询发票申请是否审批通过开票、寄出

请求地址： /v2/common/queryInvoiceStatus

服务协议： HTTP/POST

Content-Type： application/x-www-form-urlencoded

请求参数：

参数名	类型	必选	描述
client_id	string	Y	申请的client_id
timestamp	long	Y	时间戳
sign	string	Y	参数签名
~~invoice_id~~	string	N	发票id(已经废弃)
invoice_no	string	Y	发票No

响应data参数：

参数名称	类型	必有	说明
~~invoiceId~~	int	Y	发票ID
invoiceNo	string	Y	开票成功时返回，发票No
amount	int	Y	发票金额，单位分
invoiceTime	string	Y	开票时间，时间戳格式
sendTime	string	Y	邮寄时间，时间戳格式
expressCompany	string	Y	快递公司
receiveName	string	Y	收件人姓名
receiveMobile	string	Y	收件人手机号
receiveAddress	string	Y	收件人地址，仅纸质发票返回
receiveEmail	string	Y	收件人邮箱，仅电子发票返回
applicationTime	string	Y	发票申请时间，时间戳格式
invoiceTitle	string	Y	发票抬头
taxNumber	string	Y	税号
invoiceType	string	Y	发票类型(0 电子票、1纸质票）
orderNo	string	Y	开票订单号
downloadUrl	string	Y	电子发票下载地址，仅电子发票返回
xmlDownloadUrl	string	Y	电子发票xml下载地址，仅电子发票返回
ofdDownloadUrl	string	Y	电子发票ofd下载地址，仅电子发票返回
makeOutStatus	string	Y	是否开票，INVOICE_MAKE_OUT_NO 未开票、INVOICE_MAKE_OUT_YES 已开票、INVOICE_MAKE_INVALID 发票作废、INVOICE_MAKE_OUT_INVALID 开票失败
expressStatus	string	Y	是否开票，SENT_OUT_NO 未寄出、SENT_OUT_YES 已寄出

结果示例：

  {
	"code": 200,
	"data": {
		"amount": 1563,
		"orderNo": 6962230448002000,
		"invoiceTime": 1591631737000,
		"makeOutStatus": "INVOICE_MAKE_OUT_YES",
		"downloadUrl": "http://fp.bwjf.cn/downInvoice/026/q2412412",
		"taxNumber": "900000609134343",
		"receiveEmail": "s222rra.j.yin@qq.com",
		"sendTime": 1591631671000,
		"costCity": "021",
		"receiveName": "阿里",
		"applicationTime": 1591631665000,
		"invoiceType": 2,
		"invoiceId": 4808807,
		"invoiceNo": "20200354250083783480212",
		"invoiceTitle": "普华",
		"expressStatus": "SENT_OUT_YES",
		"receiveMobile": "123456"
	},
	"success": true
}

按金额开票发票状态查询

根据流水号查询按金额开票的发票申请状态

请求地址： /v2/common/queryInvoiceResult

服务协议： HTTP/POST

Content-Type： application/x-www-form-urlencoded

请求参数：

参数名	类型	必选	描述
client_id	string	Y	申请的client_id
timestamp	long	Y	时间戳
sign	string	Y	参数签名
trade_no	string	Y	外部交易流水号

响应data参数：

参数名称	类型	必有	说明
tradeNo	string	Y	外部交易流水号
status	int	Y	发票状态：1处理中、99处理失败、100处理完成
amount	int	Y	发票申请总金额，单位：分
invoiceTitle	string	Y	发票抬头
invoiceContent	string	Y	发票内容
materialType	int	Y	发票材质类型
receiver	string	Y	接收人姓名
receiverPhone	string	Y	接收人电话
receiverAddr	string	Y	接收人地址
taxNumber	string	Y	税号
email	string	Y	邮箱
createTime	string	Y	开票申请时间，时间戳格式
remark	string	Y	备注
buyerRegisterAddr	string	Y	购买方注册地址
buyerPhone	string	Y	购买方电话
buyerBankName	string	Y	开户银行
buyerBankAccount	string	Y	银行账号
invoiceRecordDetailList	array	Y	发票记录详情列表

invoiceRecordDetailList 参数：

参数名称	类型	必有	说明
invoiceNo	string	Y	发票编号
amount	long	Y	开票金额，单位：分
costCity	string	Y	城市编号
invoiceTime	string	Y	开票时间，时间戳格式
invoiceType	int	Y	开票类型
invoiceId	long	Y	发票ID
invoiceTitle	string	Y	发票抬头
sendTime	string	Y	邮寄时间，时间戳格式
expressNo	string	Y	快递单号
expressCompany	string	Y	快递公司
invoiceStatus	int	Y	发票状态：1已开票、2未开票、3无效、4未支付完成、5申请中、6已作废、7作废中
expressStatus	int	Y	是否邮寄：1已寄出、2未寄出
expressStatusStr	string	Y	邮寄状态描述
downloadUrl	string	Y	下载地址
orderNo	long	Y	订单编号
makeOutStatus	string	Y	是否开票
taxNumber	string	Y	税号
receiveEmail	string	Y	接收邮箱
receiveName	string	Y	收件人姓名
applicationTime	string	Y	发票申请时间，时间戳格式
receiveMobile	string	Y	接收者电话
receiveAddress	string	Y	收件人地址
content	string	Y	发票内容

结果示例：

{
	"code": 200,
	"data": {
		"tradeNo": "20200608123456789",
		"status": 100,
		"amount": 50000,
		"invoiceTitle": "XX科技有限公司",
		"invoiceContent": "运输服务费",
		"materialType": 0,
		"receiver": "张三",
		"receiverPhone": "13800138000",
		"receiverAddr": "上海市浦东新区XX路XX号",
		"taxNumber": "91310000MA12345678",
		"email": "test@example.com",
		"createTime": 1591631665000,
		"remark": "",
		"buyerRegisterAddr": "上海市浦东新区XX路XX号",
		"buyerPhone": "021-12345678",
		"buyerBankName": "中国银行",
		"buyerBankAccount": "1234567890",
		"invoiceRecordDetailList": [
			{
				"invoiceNo": "20200354250083783480212",
				"amount": 50000,
				"costCity": "021",
				"invoiceTime": 1591631737000,
				"invoiceType": 0,
				"invoiceId": 4808807,
				"invoiceTitle": "XX科技有限公司",
				"sendTime": 1591631671000,
				"expressNo": "SF1234567890",
				"expressCompany": "顺丰",
				"invoiceStatus": 1,
				"expressStatus": 1,
				"expressStatusStr": "已寄出",
				"downloadUrl": "http://fp.bwjf.cn/downInvoice/026/q2412412",
				"orderNo": 6962230448002000,
				"makeOutStatus": "INVOICE_MAKE_OUT_YES",
				"taxNumber": "91310000MA12345678",
				"receiveEmail": "test@example.com",
				"receiveName": "张三",
				"applicationTime": 1591631665000,
				"receiveMobile": "13800138000",
				"receiveAddress": "上海市浦东新区XX路XX号",
				"content": "运输服务费"
			}
		]
	},
	"success": true
}