> ## Documentation Index
> Fetch the complete documentation index at: https://opendocs.xft.xin/llms.txt
> Use this file to discover all available pages before exploring further.

# 电子回单查询

## 功能说明

电子回单查询接口用于查询某笔电子回单申请的结果。查询成功后会返回电子回单 PDF 文件的下载地址，根据该地址下载对应的电子回单 PDF 文件。

## 请求地址

`POST /electronic/receipt/query`

## 请求参数

| 字段              | 类型         | 必填 | 说明                      |
| --------------- | ---------- | -- | ----------------------- |
| `out_trade_no`  | string(32) | 是  | 商户订单号，需要唯一              |
| `receipt_no`    | string(64) | 是  | 电子凭证编号，即电子回单申请接口返回的凭证编号 |
| `merchant_code` | string(32) | 是  | 商户号                     |

## 请求示例

```json theme={null}
{
  "merchant_code": "226801000000865319122",
  "out_trade_no": "ea51203e1a0146d7954b39ac88aecaf7",
  "receipt_no": "202309120303723529"
}
```

## 响应参数

| 字段                 | 类型     | 说明                       |
| ------------------ | ------ | ------------------------ |
| `pdf_download_url` | string | 电子回单 PDF 文件下载地址，有效期 5 分钟 |

## 响应示例

```json theme={null}
{
  "pdf_download_url": ""
}
```

<Note>
  `pdf_download_url` 的有效期为 5 分钟。如果下载链接过期，只需重新调用本查询接口获取新的下载地址，无需重新调用电子回单申请接口。
</Note>

## 代码示例

```java theme={null}
XftMybankClient client = new DefaultXftMybankClient(
    "https://xhj-sit.91xft.cn", "111111111111", "xvnYAUWB00jEdIrkdrt5CtQQNB1x4Jhl");
XftElectronicReceiptQueryRequest request = new XftElectronicReceiptQueryRequest();
request.setOutTradeNo("ea51203e1a0146d7954b39ac88aecaf7");
request.setReceiptNo("202309120303723529");
request.setMerchantCode("226801000000865319122");
XftElectronicReceiptQueryResponse response = client.execute(request);
```