# 异步第三方制码

#### **接口用途**

- 用于异步第三方制码的请求参数，发送到whale-gateway数据格式

#### **接口说明**

- 这里规定了标准的请求报文格式，发送到whale-gateway模块，然后具体对于不同码商的报文格式需要gateway转换

#### **action**

- **MakeCode**

**请求参数，whale===>whale-gateway**

<table border="1" class="align-center" id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-c" style="width: 100%; border-collapse: collapse; border-style: double; height: 464px;"><tbody><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">字段</td><td style="width: 161.8px; height: 29px;">类型</td><td style="width: 161.8px; height: 29px;">是否必填</td><td style="width: 161.8px; height: 29px;">字段意义</td><td style="width: 161.8px; height: 29px;">备注</td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">channelId</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">渠道Id</td><td style="width: 161.8px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">channelTicketId</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">渠道批次Id</td><td style="width: 161.8px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">codeValidEnd</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">券码有效期结束时间</td><td style="width: 161.8px; height: 29px;">格式为yyyyMMdd235959</td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">codeValidStart</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">券码有效期开始时间</td><td style="width: 161.8px; height: 29px;">格式为yyyyMMdd000000</td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">faceValue</td><td style="width: 161.8px; height: 29px;">Double</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">券面值</td><td style="width: 161.8px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">netValue</td><td style="width: 161.8px; height: 29px;">Double</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">净值</td><td style="width: 161.8px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">orderId</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">订单Id</td><td style="width: 161.8px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">requestId</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">请求流水号</td><td style="width: 161.8px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">saleChannelOrderId</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">外部订单编号</td><td style="width: 161.8px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">totalCount</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">制码数量</td><td style="width: 161.8px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">transDate</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">交易日期</td><td style="width: 161.8px; height: 29px;">格式为

yyyyMMdd

</td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">transTime</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">交易时间</td><td style="width: 161.8px; height: 29px;">格式为

yyyyMMddHHmmss

</td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">useTimes</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">可核销次数</td><td style="width: 161.8px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">whaleTicketId</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">whale券Id</td><td style="width: 161.8px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 161.8px; height: 29px;">saleChannelItemId</td><td style="width: 161.8px; height: 29px;">String</td><td style="width: 161.8px; height: 29px;">是</td><td style="width: 161.8px; height: 29px;">子订单号</td><td style="width: 161.8px; height: 29px;"> </td></tr></tbody></table>

**请求报文举例**

```JSON
{
  "channelId": "136",
  "faceValue": -1,
  "makeFundsChannel": {
    "benefitAmount": 0,
    "channelBenefit": 0,
    "discountAmount": 0,
    "merchantBenefit": 0,
    "merchantCustomBenefit": -1,
    "merchantCustomRealAmount": -1,
    "merchantRealAmount": 10,
    "totalAmount": 100,
    "userRealAmount": 80
  },
  "netValue": -1,
  "orderId": "d84c1302a5e84774813bc9f1b7aaea8a",
  "orderRemark": "testtttt",
  "requestId": "d84c1302a5e84774813bc9f1b7aaea8a",
  "saleChannelOrderId": "d84c1302a5e84774813bc9f1b7aaea8a",
  "totalCount": "1",
  "transDate": "20220506",
  "transTime": "20220506215213",
  "useTimes": "12",
  "whaleTicketId": "162"
}
```

**返回参数，whale-gateway===&gt;whale**

<table border="1" id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-r" style="border-collapse: collapse; width: 100%; height: 145px;"><tbody><tr style="height: 29px;"><td style="width: 20%; height: 29px;">字段</td><td style="width: 20%; height: 29px;">类型</td><td style="width: 20%; height: 29px;">是否必填</td><td style="width: 20%; height: 29px;">字段意义</td><td style="width: 20%; height: 29px;">备注</td></tr><tr style="height: 29px;"><td style="width: 20%; height: 29px;">returnCode</td><td style="width: 20%; height: 29px;">String</td><td style="width: 20%; height: 29px;">是</td><td style="width: 20%; height: 29px;">请求返回码</td><td style="width: 20%; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 20%; height: 29px;">returnMsg</td><td style="width: 20%; height: 29px;">String</td><td style="width: 20%; height: 29px;">是</td><td style="width: 20%; height: 29px;">请求返回信息</td><td style="width: 20%; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 20%; height: 29px;">sendChannelOrderId</td><td style="width: 20%; height: 29px;">String</td><td style="width: 20%; height: 29px;">否</td><td style="width: 20%; height: 29px;">订单号</td><td style="width: 20%; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 20%; height: 29px;">thirdCodeFamilySet</td><td style="width: 20%; height: 29px;">List&lt;[CodeFamilyInfoBO](https://book.e-buy.com/books/e-buy-40/page/a5bfc)&gt;</td><td style="width: 20%; height: 29px;"> </td><td style="width: 20%; height: 29px;"> </td><td style="width: 20%; height: 29px;"> </td></tr></tbody></table>

**返回报文举例**

```JSON
{
	"returnCode": "00",
    "returnMsg": "SUCCESS",
    "sendChannelOrderId": "",
    "thirdCodeFamilySet": []
}
```