# 同步单品发码（单个&批量发码与激活）

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

- 支持请码方一次单品请求调用,单品发码数量上限100

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

- 每次调用时必须有明确的渠道订单编号。
- commissionDate = -1时，所制码不具有支付功能（即码没有激活），如果需要激活该码的支付功能需要再次调用"码激活"接口。
- 同步单条发码时，saleChannelOrderId和saleChannelItemId可用同一值。
- returnCode = "00"时，说明订单进入制码流程。itemResultCode = "00"时，说明订单制码成。
- notifyType为券码发送到用户的形式，是否需要通知以券配置为开关

#### **action**

- `MakeCode`

**请求参数，CHANNEL===>[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")**

<table 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-s"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>saleChannelOrderId</td><td>String</td><td>是</td><td>渠道制码订单id</td><td>最长32位，当上送相同订单号时返回上一次成功信息，如果上一次请码失败，则本次会重新生成码</td></tr><tr><td>requestId</td><td>String</td><td>是</td><td>请求流水号</td><td>最长32位，用于标识唯一一笔交易</td></tr><tr><td>remark</td><td>JSONString</td><td>是</td><td>订单备注信息</td><td>最长200位，订单查询时原样返回</td></tr><tr><td>notifyType</td><td>Object&lt;[notifyType](https://book.e-buy.com/books/e-buy-40/page/26657 "notifyType")&gt;</td><td>否</td><td>制码通知类型</td><td> </td></tr><tr><td>item</td><td>Object&lt;[makeOrderItems](https://book.e-buy.com/books/e-buy-40/page/3ad7c "makeOrderItems")&gt;</td><td>是</td><td>制码明细</td><td>同步制码时，仅支持单产品单码</td></tr></tbody></table>

**请求报文举例**

```
{
    "saleChannelId": "102410058",
    "saleChannelOrderId": "20181024154201",
    "requestId": "20181024154201",
    "notifyType": {
            "mobilePhone": "13524161800"
    },
    "item": {
        "saleChannelItemId":"20181024154201",
        "commissionDate":"1",
        "validDays": 10,
        "ticketId": 1,
        "makeFundsChannel": {
            "channelBenefit": 0,
            "merchantBenefit": 500,
            "userRealAmount": 2500
        }
    }
}

```

**返回参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===&gt;CHANNEL**

<table 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"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>returnCode</td><td>String</td><td>是</td><td>请求返回码</td><td> </td></tr><tr><td>returnMsg</td><td>String</td><td>是</td><td>请求返回信息</td><td> </td></tr><tr><td>data</td><td>Object&lt;[makeCodeResponseData](https://book.e-buy.com/books/e-buy-40/page/faa9a "makeCodeResponseData")&gt;</td><td>否</td><td>码信息</td></tr></tbody></table>

**返回报文举例**

```
{
    "returnCode": "00",
    "returnMsg": "SUCCESS",
    "data": {
        "saleChannelOrderId": "20181120155110",
        "tradeNo": "c1eca7fbda51430cb5100ec0699a5b00",
        "createTime": "20181120155225",
        "isNotify": "1",
        "codeNum": 1,
        "items": [{
            "codeDetail": [{
                "codeURL": "http://qrcode.url.ag/make?0000001496A382FA4725D24FA27839FC1680D136CAFE515519B94B1D&type=QRCODE",
                "code": "10116574123700278846",
                "useTimes": 10,
                "status": "00",
                "statusDesc": "未使用"
            }],
            "validEnd": "20181201000000",
            "validStart": "20181121000000",
            "itemResultMsg": "SUCCESS",
            "itemResultCode": "00",
            "saleChannelItemId": "20181120155110",
            "ticketId": 9000000010,
            "ticketName":"星巴克30元代金券",
            "activityId":"1000000006",
            "activityName":"中信银行星巴克代金券活动"
        }],
        "createDate": "20181120"
    }
}
```

#### **券状态枚举**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-00-%E5%8F%AF%E4%BD%BF%E7%94%A8-01" style="width: 76.5432%; height: 152.708px;"><thead><tr style="height: 46.5625px;"><th style="width: 7.26994%; height: 46.5625px;">字段</th><th style="width: 44.7505%; height: 46.5625px;">字段意义</th><th style="width: 47.9816%; height: 46.5625px;">备注</th></tr></thead><tbody><tr style="height: 29.7917px;"><td style="width: 7.26994%; height: 29.7917px;">04</td><td style="width: 44.7505%; height: 29.7917px;">参数配置不正确</td><td style="width: 47.9816%; height: 29.7917px;">RequestId参数不能为空

appId参数不能为空

</td></tr><tr style="height: 29.7917px;"><td style="width: 7.26994%; height: 29.7917px;">50</td><td style="width: 44.7505%; height: 29.7917px;">活动产品信息不存在</td><td style="width: 47.9816%; height: 29.7917px;">  
</td></tr><tr style="height: 46.5625px;"><td style="width: 7.26994%; height: 46.5625px;">97</td><td style="width: 44.7505%; height: 46.5625px;">活动产品信息不存在</td><td style="width: 47.9816%; height: 46.5625px;">活动产品信息不存在  
或者其他配置信息错误</td></tr><tr><td style="width: 7.26994%;">06</td><td style="width: 44.7505%;">活动产品未经过测试</td><td style="width: 47.9816%;">  
</td></tr><tr><td style="width: 7.26994%;">50</td><td style="width: 44.7505%;">销售渠道信息不存在</td><td style="width: 47.9816%;">  
</td></tr><tr><td style="width: 7.26994%;">07</td><td style="width: 44.7505%;">销售渠道和活动产品权限不匹配</td><td style="width: 47.9816%;">  
</td></tr></tbody></table>