发票状态查询
接口说明: 用于查询发票的状态信息。
接口提供方: 合作方
请求地址: https://{$domain}/partner/queryInvoice
服务协议: HTTPS/GET
请求参数:
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
channel | string | 是 | 分配的合作方的标识,每个合作方一个, 对应分配给合作方的client_id |
timestamp | long | 是 | 请求时间,Unix Timestamp单位毫秒 |
sign | string | 是 | 签名 |
requestId | string | 是 | 申请请求受理号 |
响应data参数:
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
result | int | 是 | 服务响应状态 |
message | string | 是 | 服务响应状态说明 |
data | array | 是 | 返回数据 |
data.invoiceId | long | 是 | 发票ID 最大15位 |
data.invoiceCode | string | 是 | 已开票或者已作废对应的发票代码 数电发票无发票代码可以传发票号码 |
data.invoiceNumber | string | 是 | 已开票或者已作废对应的发票号码 |
data.originInvoiceCode | string | 作废成功时必传 | 作废发票对应的原始发票代码 |
data.originInvoiceNumber | string | 作废成功时必传 | 作废发票对应的原始发票号码 |
data.status | int | 是 | 申请状态 1: 已开票 2: 已作废 3: 开票失败 4: 已申请 5: 已寄出 6: 已申请作废 |
data.expressNum | string | 纸质发票必传 | 快递单号 |
data.expressName | string | 纸质发票必传 | 快递公司 |
data.invoiceFile | string | 已开票状态时必传,作废中、已作废不需要传 | 电子发票文件经过base64(JDK8的 Base64.Encoder)编码处理的文件流 |
data.invoiceXml | string | 已开票状态时必传,作废中、已作废不需要传 | 数电发票xml文件地址 无法提供的可以不传 |
电票开票成功示例:
{
"result": 0,
"message": "SUCCESS",
"data": [{
"invoiceId": 1,
"invoiceCode": "发票代码1",
"invoiceNumber": "发票号码1",
"status": 1,
"invoiceFile": "base64编码的文件流"
}, {
"invoiceId": 2,
"invoiceCode": "发票代码2",
"invoiceNumber": "发票号码2",
"status": 1,
"invoiceFile": "base64编码的文件流"
}]
}
电票已申请作废(作废中)示例:
{
"result": 0,
"message": "SUCCESS",
"data": [{
"invoiceId": 1,
"status": 6
}, {
"invoiceId": 2,
"status": 6
}]
}
电票作废成功示例:
{
"result": 0,
"message": "SUCCESS",
"data": [{
"invoiceId": 1,
"invoiceCode": "作废发票代码1",
"invoiceNumber": "作废发票号码1",
"originInvoiceCode": "该作废发票对应的原始发票代码1",
"originInvoiceNumber": "该作废发票对应的原始发票号码1",
"status": 2
}, {
"invoiceId": 2,
"invoiceCode": "作废发票代码2",
"invoiceNumber": "作废发票号码2",
"originInvoiceCode": "该作废发票对应的原始发票代码2",
"originInvoiceNumber": "该作废发票对应的原始发票号码2",
"status": 2
}]
}