> ## 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={"system"}
{
  "merchant_code": "226801000000865319122",
  "out_trade_no": "ea51203e1a0146d7954b39ac88aecaf7",
  "receipt_no": "202309120303723529"
}
```

## 响应参数

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

## 响应示例

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

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

## 代码示例

```java theme={"system"}
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);
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.