# 开具发票查询
# 接口说明
该接口作为异步通知接口补充，开发者可通过此接口查询订单开票信息（正常情况下平台将通过异步通知返回开票结果，如无特殊情况无需调用该接口）。
# 地址
/tax-api/invoice/query/v1
# 请求参数
| 参数名称 | 类型 | 必填 | 最大长度 | 描述 | 示例 |
|---|---|---|---|---|---|
| seller_taxpayer_num | string | 是 | 20 | 销方纳税人识别号（销方票面信息）：即统一社会信用代码（一般是15、17、18、20位长度位数字或大写字母，字母I、O、S、V、Z除外） | 91469027MA5RH09M0R |
| order_id | string | 否 | 64 | 商户订单号：开发者接入方业务订单唯一标识(开具蓝票开具时填入值)此字段与order_sn不能同时为空 | gd_1904242006002627690 |
| order_sn | string | 否 | 64 | 高灯方商户订单号：开发者商户订单号对应的高灯方商户订单唯一标识(开具蓝票时返回值)此字段与order_id不能同时为空 | 6590128277141372177 |
| is_red | uint8 | 否 | 1 | 发票种类：<br>0：蓝票<br>1：红票【该字段默认为0， 如果需要查询红票信息，本字段必须传1，否则可能查询不到需要的发票信息】<br> | 0 |
# 响应参数
| 字段 | 类型 | 必须 | 说明 |
|---|---|---|---|
| order_id | string | 是 | 商户订单号：开发者接入方业务订单唯一标识，此字段与order_sn不会同时为空 |
| order_sn | string | 是 | 高灯方商户订单号：开发者商户订单号对应的高灯方商户订单唯一标识，此字段与order_id不会同时为空 |
| status | string | 是 | 发票状态<br>0：无效状态<br>1：开票中<br>2：开票失败<br>3：开票成功<br>4：开票成功作废中<br>5：开票成功作废失败<br>6：开票成功作废成功 |
| message | string | 是 | 开票描述 |
| ticket_date | string | 是 | 开票日期 |
| ticket_sn | string | 是 | 发票号码 |
| ticket_code | string | 是 | 发票代码 |
| check_code | string | 是 | 检验码 |
| amount_with_tax | string | 是 | 含税金额(元) |
| amount_without_tax | string | 是 | 不含税金额(元) |
| tax_amount | string | 是 | 税额(元) |
| is_red_washed | string | 是 | 是否被红冲：0、未红冲，1、已红冲 |
| pdf_url | string | 是 | 版式文件地址 |
# 请求示例
{
"order_sn":"6561574963747404440",
"seller_taxpayer_num":"111112222233333"
}
# 响应示例
{
"code": 0,
"data": {
"order_sn": "6561574963747404440",
"status": 5,
"message": "SUCCESS",
"ticket_date": "2019-07-29",
"ticket_sn": "00253001",
"ticket_code": "845031909110",
"check_code": "ddf94",
"amount_with_tax": "103",
"amount_without_tax": "100",
"tax_amount": "3",
"is_red_washed": 0,
"pdf_url": "https://upload.yewifi.com/center/prod_make/20190729/invoice_845031909110_00253001_dbaf0828c92d4785dc38359cdb687fce.pdf"
},
"message": "success"
}