> ## 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.

# 电子回单申请

## 功能说明

电子回单申请接口用于下载分账交易、提现交易以及入账的电子回单。调用此接口之前，需要确保相关的交易均已完成。

<Note>
  电子回单的使用流程：先调用本接口发起申请，每次传入的 `out_trade_no` 需要保证幂等；再调用电子回单查询接口获取下载地址，根据返回的下载地址下载对应的电子回单 PDF 文件。
</Note>

## 请求地址

`POST /electronic/receipt/apply`

## 请求参数

| 字段               | 类型         | 必填 | 说明                   |
| ---------------- | ---------- | -- | -------------------- |
| `out_trade_no`   | string(32) | 是  | 商户订单号，需要唯一，每次传入需保证幂等 |
| `third_trade_no` | string(64) | 是  | 网商业务流水号              |
| `merchant_code`  | string(32) | 是  | 商户号                  |

## 请求示例

```json theme={null}
{
  "merchant_code": "226801000000865319122",
  "out_trade_no": "ea51203e1a0146d7954b39ac88aecaf7",
  "third_trade_no": "202309120303127366"
}
```

## 响应参数

| 字段               | 类型     | 说明                 |
| ---------------- | ------ | ------------------ |
| `out_trade_no`   | string | 商户订单号              |
| `third_trade_no` | string | 网商流水号              |
| `merchant_code`  | string | 商户号                |
| `state`          | string | 状态；`pending` 表示处理中 |
| `receipt_no`     | string | 电子回单凭证号            |

## 响应示例

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

## 代码示例

```java theme={null}
XftMybankClient client = new DefaultXftMybankClient(
    "https://xhj-sit.91xft.cn", "111111111111", "xvnYAUWB00jEdIrkdrt5CtQQNB1x4Jhl");
XftElectronicReceiptApplyRequest request = new XftElectronicReceiptApplyRequest();
request.setOutTradeNo(StringUtils.getRandomStr());
request.setThirdTradeNo("202309120303127366");
request.setMerchantCode("226801000000865319122");
XftElectronicReceiptApplyResponse response = client.execute(request);
```