# 创建回款单


```
POST https://qw-openapi-tx.dustess.com/java-payback-srv/open-api/payback/v2/create/batch?accessToken=
```

**请求header**

| 字段         | 值               |
| ------------ | ---------------- |
| Content-Type | application/json |

**接口限制**：每分钟调用600次；

**请求参数**

| 参数名称                         | 类型       | 描述                                                                                                                                                | 是否必须  |
| -------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |-------|
| paybacks                         | `Object[]` | 回款单数据（单次最多50条）                                                                                                                          | true  |
| paybacks.paybackMethod           | `Int`      | 回款方式 (1：对公转账 2：微信收款3：支付宝4：银联聚合收款 5：其他 7:现金收款 8：POS机收款）                                                         | true  |
| paybacks.paybackAmount           | `String`   | 回款金额（单位：元，例如："128.31"）                                                                                                                | true  |
| paybacks.paybackDate             | `String`   | 回款日期（格式："2023-09-20"）                                                                                                                      | true  |
| paybacks.paybackName             | `String`   | 回款方式名称（回款方式为「其他」时，需要填入                                                                                                        | false |
| paybacks.subjectName             | `String`   | 主体名称                                                                                                                                            | false |
| paybacks.serialNo                | `String`   | 流水号                                                                                                                                              | false |
| paybacks.searchNo                | `String`   | 检索号                                                                                                                                              | false |
| paybacks.identificationCode      | `String`   | 不同回款方式字段含义不同，对公转账：付方账号；微信收款：微信支付单号；支付宝：交易号；银联聚合收款：商户订单号；现金收款/POS机收款/其他：回款识别码 | true  |
| paybacks.merchantOrderNo         | `String`   | 商户订单号                                                                                                                                          | false |
| paybacks.bankMerchantNo          | `String`   | 银商订单号                                                                                                                                          | false |
| paybacks.remitter                | `String`   | 打款人                                                                                                                                              | false |
| paybacks.remark                  | `String`   | 备注                                                                                                                                                | false |
| paybacks.claimantId              | `String`   | 认领人（员工ID，有关联对象时需要传）                                                                                                                | false |
| paybacks.belongDeptId              | `Int`   | 归属部门id                                                                                                                | false |
| paybacks.relateCompanyId         | `String`   | 关联企业ID（relateCompanyId、relateCustomerId、relateOrderInfo最多传其一）                                                                          | false |
| paybacks.relateCustomerId        | `String`   | 关联联系人ID（relateCompanyId、relateCustomerId、relateOrderInfo最多传其一）                                                                        | false |
| paybacks.relateOrderInfo         | `Object[]` | 关联订单（relateCompanyId、relateCustomerId、relateOrderInfo最多传其一）                                                                            | false |
| paybacks.relateOrderInfo.orderId | `String`   | 订单ID                                                                                                                                              | false |
| paybacks.relateOrderInfo.amount  | `String`   | 订单本次回款金额                                                                                                                                    | false |

**请求参数示例**
`json` - Request-Example:

```json

{
  "paybacks": [
    {
      "paybackMethod": 1,
      "identificationCode": "1234567",
      "serialNo": "88888888",
      "paybackAmount": "128.1",
      "paybackDate": "2023-09-08",
      "relateOrderInfo": [
        {
          "orderId": "87d649e1-13f6-440a-ab28-612b2f23b091",
          "amount": "128.1"
        }
      ],
      "claimantId": "561"
    }
  ]
}

```

**成功响应**

| 参数名称           | 类型       | 描述                   |
| ------------------ | ---------- | ---------------------- |
| code               | `Int`      | 状态码                 |
| msg                | `String`   | 状态信息               |
| data               | `Object`   | 响应数据               |
| data.success       | `Object[]` | 成功的数据             |
| data.success.index | `Int`      | 对应传入参数的数组下标 |
| data.success.id    | `String`   | 成功创建后的回款单ID   |
| data.fail          | `Object[]` | 失败的数据             |
| data.fail.index    | `Int`      | 对应传入参数的数组下标 |
| data.fail.code     | `Int`      | 失败错误码             |
| data.fail.msg      | `String`   | 失败错误信息           |
| traceId            | `String`   | 跟踪id                 |

**成功响应示例**

```json
{
  "code": 0,
  "data": {
    "fail": [
      {
        "code": 90001004,
        "index": 1,
        "msg": "无效的关联对象"
      }
    ],
    "success": [
      {
        "code": 0, 
        "id": "492363602803044352",
        "index": 0,
        "msg": ""
      }
    ]
  },
  "msg": "OK",
  "traceId": "5fefbbc6-bbde-988a-9226-4b590c8e707b"
}
```

**错误响应示例**

```json
 {
    "code": 500500,
    "data": {},
    "msg": "服务端错误：xxxx",
    "traceId": "5fefbbc6-bbde-988a-9226-4b590c8e707b"
}
```