# 每日签到

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

- 中间件定时任务每天凌晨，调用此接口进行签到，与后台同步密钥信息和状态信息。(因签到前还未获得mwMackey，故使用mwTmk签名)

#### **接口地址**

- `https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/signin`

#### **action**

- `signin`

**请求参数，中间件===>易百后台**

<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-t"><thead><tr><th style="width: 121px;">字段</th><th style="width: 55px;">类型</th><th style="width: 74px;">是否必填</th><th style="width: 107px;">字段意义</th><th style="width: 452px;">备注</th></tr></thead><tbody><tr><td style="width: 121px;">traceNo</td><td style="width: 55px;">String</td><td style="width: 74px;">是</td><td style="width: 107px;">请求流水号</td><td style="width: 452px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td style="width: 121px;">posModel</td><td style="width: 55px;">String</td><td style="width: 74px;">是</td><td style="width: 107px;">[MIS-POS](https://book.e-buy.com/link/104#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能")型号</td><td style="width: 452px;">如门店有用到易百机具即填写相应设备机型例如：G2，如门店未用易百机具即填写收银机型号</td></tr><tr><td style="width: 121px;">request8583</td><td style="width: 55px;">String</td><td style="width: 74px;">否</td><td style="width: 107px;">请求报文HEX</td><td style="width: 452px;">[MIS-POS](https://book.e-buy.com/link/104#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能")灌其他机构密钥，需要组包并填写该域</td></tr><tr><td style="width: 121px;">posSn</td><td style="width: 55px;">String</td><td style="width: 74px;">否</td><td style="width: 107px;">机器序列号</td><td style="width: 452px;">例如：G8703U12345</td></tr><tr><td style="width: 121px;">curCommuType</td><td style="width: 55px;">String</td><td style="width: 74px;">否</td><td style="width: 107px;">pos连网方式</td><td style="width: 452px;">GPRS，LAN，WIFI，CDMA</td></tr><tr><td style="width: 121px;">simccid</td><td style="width: 55px;">String</td><td style="width: 74px;">否</td><td style="width: 107px;">sim卡号</td><td style="width: 452px;">GPRS和CDMA的必传</td></tr><tr><td style="width: 121px;">netClientIP</td><td style="width: 55px;">String</td><td style="width: 74px;">否</td><td style="width: 107px;">pos本地IP</td><td style="width: 452px;">LAN必传</td></tr><tr><td style="width: 121px;">netGate</td><td style="width: 55px;">String</td><td style="width: 74px;">否</td><td style="width: 107px;">本地网关</td><td style="width: 452px;">LAN必传</td></tr></tbody></table>

#### **请求报文举例**

```
  {
    "traceNo": "99000009100010101732123",
    "posModel": "G2"
  }

```

**返回参数，易百后台===&gt;中间件**

<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-t-0"><thead><tr><th style="width: 124px;">字段</th><th style="width: 139px;">类型</th><th style="width: 48px;">是否必填</th><th style="width: 163px;">字段意义</th><th style="width: 335px;">备注</th></tr></thead><tbody><tr><td style="width: 124px;">traceNo</td><td style="width: 139px;">String</td><td style="width: 48px;">是</td><td style="width: 163px;">请求流水号</td><td style="width: 335px;">原样返回</td></tr><tr><td style="width: 124px;">transDate</td><td style="width: 139px;">String</td><td style="width: 48px;">是</td><td style="width: 163px;">交易时间</td><td style="width: 335px;">格式为：yyyyMMddHHmmss</td></tr><tr><td style="width: 124px;">returnCode</td><td style="width: 139px;">String</td><td style="width: 48px;">是</td><td style="width: 163px;">返回码</td><td style="width: 335px;">00表示交易成功，其他表示失败</td></tr><tr><td style="width: 124px;">returnDesc</td><td style="width: 139px;">String</td><td style="width: 48px;">是</td><td style="width: 163px;">返回信息</td><td style="width: 335px;">交易结果描述或错误原因</td></tr><tr><td style="width: 124px;">merchantName</td><td style="width: 139px;">String</td><td style="width: 48px;">是</td><td style="width: 163px;">商户门店名称</td><td style="width: 335px;"> </td></tr><tr><td style="width: 124px;">deviceNo</td><td style="width: 139px;">String</td><td style="width: 48px;">否</td><td style="width: 163px;">收银机编号</td><td style="width: 335px;"> </td></tr><tr><td style="width: 124px;">shopNo</td><td style="width: 139px;">String</td><td style="width: 48px;">否</td><td style="width: 163px;">门店编号</td><td style="width: 335px;"> </td></tr><tr><td style="width: 124px;">brand</td><td style="width: 139px;">String</td><td style="width: 48px;">是</td><td style="width: 163px;">品牌编号</td><td style="width: 335px;"> </td></tr><tr><td style="width: 124px;">defaultHeartbeat</td><td style="width: 139px;">Number</td><td style="width: 48px;">是</td><td style="width: 163px;">默认心跳间隔</td><td style="width: 335px;">单位：秒</td></tr><tr><td style="width: 124px;">publicKey</td><td style="width: 139px;">String</td><td style="width: 48px;">是</td><td style="width: 163px;">银联IC卡公钥</td><td style="width: 335px;">HEX格式，用于IC检验</td></tr><tr><td style="width: 124px;">response8583</td><td style="width: 139px;">String</td><td style="width: 48px;">否</td><td style="width: 163px;">返回报文HEX</td><td style="width: 335px;">[MIS-POS](https://book.e-buy.com/link/104#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能")灌其他机构密钥，后台透传该域</td></tr><tr><td style="width: 124px;">pinKey</td><td style="width: 139px;">String</td><td style="width: 48px;">是</td><td style="width: 163px;">易百POS PIN密钥</td><td style="width: 335px;">使用[tmk](https://book.e-buy.com/books/e-buy-B6z/page/2b449 "tmk")进行3DES加密，HEX格式，用于卡信息，密码加密，KEY过期时间为本次签到成功即前一次密钥过期</td></tr><tr><td style="width: 124px;">mwMacKey</td><td style="width: 139px;">String</td><td style="width: 48px;">是</td><td style="width: 163px;">中间件MAC密钥</td><td style="width: 335px;">使用[mwTmk](https://book.e-buy.com/books/e-buy-B6z/page/2b449 "mwTmk")进行3DES加密，HEX格式，用于中间件报文签名，KEY过期时间为本次签到成功即前一次密钥过期</td></tr><tr><td style="width: 124px;">webPospUrl</td><td style="width: 139px;">String</td><td style="width: 48px;">否</td><td style="width: 163px;">为终端下发请求WEB POSP的地址</td><td style="width: 335px;">用于要为终端变更新的请求地址</td></tr><tr><td style="width: 124px;">posUrl</td><td style="width: 139px;">String</td><td style="width: 48px;">否</td><td style="width: 163px;">[MIS-POS](https://book.e-buy.com/link/104#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能")的更新地址或目录</td><td style="width: 335px;">如果为空不需要更新，否则需要更新</td></tr><tr><td style="width: 124px;">mwUrl</td><td style="width: 139px;">String</td><td style="width: 48px;">否</td><td style="width: 163px;">中间件的更新地址或目录</td><td style="width: 335px;">如果为空不需要更新，否则需要更新</td></tr><tr><td style="width: 124px;">signBank</td><td style="width: 139px;">String</td><td style="width: 48px;">否</td><td style="width: 163px;">中间件通知[MIS-POS](https://book.e-buy.com/link/104#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能")作收单行签到</td><td style="width: 335px;">如果为空不需要签到，否则需要根据返回的值进行对应收单行的签到，可选值参考[收单机构标识](https://book.e-buy.com/books/e-buy-B6z/page/821fa)</td></tr><tr><td style="width: 124px;">headPictureList</td><td style="width: 139px;">List&lt;[headPicture](https://book.e-buy.com/books/e-buy-B6z/page/ec8ce "headPicture")&gt;</td><td style="width: 48px;">是</td><td style="width: 163px;">广告图片</td><td style="width: 335px;">用于显示在终端顶部</td></tr><tr><td style="width: 124px;">functionList</td><td style="width: 139px;">List&lt;[function](https://book.e-buy.com/books/e-buy-B6z/page/c058f "function")&gt;</td><td style="width: 48px;">是</td><td style="width: 163px;">终端功能菜单下发</td><td style="width: 335px;"> </td></tr><tr><td style="width: 124px;">nextHearbeat</td><td style="width: 139px;">Number</td><td style="width: 48px;">是</td><td style="width: 163px;">下次心跳间隔秒数</td><td style="width: 335px;">下次心跳间隔秒数</td></tr><tr><td style="width: 124px;">orgLogInInfos</td><td style="width: 139px;">List&lt;[orgLogInInfo](https://book.e-buy.com/books/e-buy-B6z/page/06905-nzm)&gt;</td><td style="width: 48px;">否</td><td style="width: 163px;">终端对应机构信息列表</td></tr></tbody></table>

#### **返回报文举例**

```
{
    "traceNo": "99000009100010101732123",
    "transDate": "20161231102201",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "merchantName": "哈根达斯张杨路店",
    "defaultHeartbeat": 60,
    "publicKey": "9F0605A0000003339F22010BDF05083230313631323331DF060101DF070101DF0281F8CF9FDF46B356378E9AF311B",
    "pinKey": "9D93D15D6A3913AB4151C456A80841EF",
    "mwMacKey": "94365019BBF9CEEAB0DF658E67754A70",
    "posUrl": "http://ebuyweb-posp-test.e-buychina.com/upgrade/pos/G2/20170214/",
    "mwUrl": "http://ebuyweb-posp-test.e-buychina.com/upgrade/mw/G2/20170214/",
    "signBank": "citicCashpay",
    "headPictureList": [
        {
            "displayPicUrl": "",
            "linkUrl": ""
        }
    ],
    "functionList": [
        {
            "iconUrl": "",
            "title": "",
            "action": "",
            "command": "",
            "childrenFunc": [
                {
                    "iconUrl": "",
                    "title": "",
                    "action": "",
                    "command": ""
                }
            ]
        }
    ]
}

```