员工信息批量同步

• 接口（建议后缀）： /employee/save
• Method-Type：POST
• 数据格式：Json
• 调用方：每刻
• 接口说明：每刻将通过供应商提供的此接口批量推送企业用户信息，每次传输 50 个员工。

请求参数

Employee

[info] 说明：
[1] 员工中文名于英文名之间必须会填一个，不会两个为空。
[2] 员工在每刻中可能没有手机号和邮箱。
[3] 企业出于隐私考虑,可能不会提供给每刻员工的这些信息,TMC若需要,自行在预订时获取。
[4] 角色的值，由第三方给出定义，企业只要在每刻配置匹配规则（按部门等等），同步员工的时候会带上这个角色。一般用来标记某些员工无需申请单即可预定。

Subsidiary

Department

InvoiceTitle

CostCenter

[info] 说明：
第三方如果需要对接员工成本中心，需要提前跟每刻沟通，才会放开让企业管理员进行配置，如不提前沟通，上线时将不具备传成本中心的能力

Approver

BusinessScope

OrderType

City

响应结构

EmployeeSyncResult

[info] 说明：
接下来所有涉及区分员工的接口，都使用第三方提供的 externalEmployeeCode 标识。

示例

[warning] 重要：
示例维护并非和文档字段维护一样频繁，如果遇到示例和文档不一致，请以文档为准

请求头:

{
  "tokenId": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJtYXljdXJfand0X2Rldl9pZCIsInN1YiI6IlBGMjAwNjIwMTI1NU5GTk8iLCJpYXQiOjE2MDQ2MzA5NjYsImF1ZCI6IlBMQVRGT1JNIiwiZXhwIjoxNjA0NjM0NTY2LCJwcm9kdWN0TGluZSI6IkRBVEFfSFVCIn0.AyNIwPtGUXxFMuHO8Bx-4XeXNyWYRcot40MfsL1swr4"
}

请求示例:

{
  "externalCorpCode": "0123456",
  "employeeList": [
    {
      "openId": "EMP2208171IIXXXXX",
      "employeeId": "0000001",
      "cnName": "张三",
      "mobile": "139xxxxxxxx",
      "email": "xxxxxx@qq.com",
      "role": "无需审批员工",
      "rank": "P10",
      "subsidiaryList": [
        {
          "subsidiaryCode": "SIxxxxxxxxxxxxxxx",
          "subsidiaryName": "天津歌剧营销有限公司",
          "departmentList": [
            {
              "departmentCode": "DHDI42803480284",
              "departmentName": "芭蕾编舞推广事业组",
              "departmentHeirCode": "DHDI12341433214.DHDI123132154234152.DHDI12342143245432.DHDI7890452797592.DHDI42803480284",
              "departmentHeirName": "天津歌剧有限公司/天津歌剧营销有限公司/芭蕾舞部/芭蕾编舞事业部/芭蕾编舞推广事业组",
              "isDefault": false
            }
          ],
          "invoiceTitleList": [
            {
              "invoiceTitleCode": "SIyyyyyyyyyyyyyyyy",
              "invoiceTitleName": "天津歌剧营销有限公司",
              "taxNo": "913112334234236867687686674423N",
              "isDefault": true
            }
          ],
          "isDefault": false
        },
        {
          "subsidiaryCode": "SIzzzzzzzzzzzzzzzzzzzzzzzz",
          "subsidiaryName": "天津戏剧营销有限公司",
          "departmentList": [
            {
              "departmentCode": "DHDI679873489",
              "departmentName": "戏剧编舞推广事业组",
              "departmentHeirCode": "DHDI123809182309805.DHDI123480328.DHDI280403280.DHDI4237985794.DHDI679873489",
              "departmentHeirName": "天津歌剧有限公司/天津戏剧营销有限公司/戏剧部/戏剧编舞事业部/戏剧编舞推广事业组",
              "isDefault": false
            }
          ],
          "isDefault": true
        }
      ],
      "approver": [
        {
          "externalEmployeeCode": "2187dcc57843987",
          "businessScope": "FLIGHT",
          "approverType": "CHANGE"
        },
        {
          "externalEmployeeCode": "2187dcc57843987",
          "businessScope": "FLIGHT",
          "approverType": "REFUND"
        },
        {
          "externalEmployeeCode": "57398792500",
          "businessScope": "HOTEL",
          "approverType": "REFUND"
        }
      ],
      "status": true,
      "sendNotification": false
    }
  ]
}

响应示例:

{
  "success": true,
  "errorMessage": null,
  "data": [
    {
      "openId": "EMP2208171IIXXXXX",
      "employeeName": "张三",
      "externalEmployeeCode": "员工在第三方的唯一标识",
      "errorMessage": null
    }
  ],
  "errorData": [
    {
      "openId": "18758233074",
      "employeeName": "这里是同步失败员工示例，请求的 Json 和成功员工一致，但第三方返回失败",
      "errorMessage": "xxxxxxxxxxxxx"
    }
  ]
}