根据工号查询员工详情

说明

该接口用于批量根据员工工号查询员工详情信息。

接口限制

 1. 10次/秒；
 2. 一次最多支持100个。

接口地址

/api/openapi/employee/details

请求类型

POST

请求参数

参数说明

参数样例

{
  "employeeIds": [
    "test123"
  ],
  "detailedAccountInfo": true
}

响应参数

参数说明

RTRoute 说明

PlaceInfo 说明

地址具体信息请查看每刻地址库

IdInfo 说明

EnName 说明

Account 说明

参数样例

{
  "code": "ACK",
  "message": "",
  "data": [
    {
      "employeeId": "test123",
      "employeeName": "testName",
      "i18nName": {
        "zh": "名称",
        "en": "Name",
        "ja": "jaName",
        "zh-TW": "",
        "ko": "",
        "fr": "",
        "es": "",
        "pt": "",
        "vi": "",
        "th": "",
        "id": "",
        "ru": "",
        "hu": "",
        "et": ""
      },
      "employeeNickName": "花名",
      "email": "test@maycur.com",
      "phoneNo": "12345678911",
      "roleNames": [
        "财务管理员",
        "报表管理员"
      ],
      "departments": [
        {
          "businessCode": "部门编码111",
          "positionBizCode": "职务编码",
          "supervisorEmployeeId": "上级工号",
          "defaultDepartment": true
        }
      ],
      "residences": [
        {
          "placeCode": "domestic-ZH3",
          "includeChildPlace": false
        }
      ],
      "customObject": {},
      "status": "ENABLE",
      "hireDate": "2020-01-01",
      "defaultLegalEntityBizCode": "默认抬头编码",
      "classPositionBizCode": "p1",
      "idInfo": {
        "idType": "ID_CARD",
        "idNumber": "xxxxxxxxxx"
      },
      "enName": {
        "firstName": "111",
        "middleName": "222",
        "lastName": "3333"
      },
      "gender": "MAN",
      "accounts": [
        {
          "bankAcctName": "账户名",
          "bankAcctNumber": "账户号",
          "paymentType": "BANK",
          "accountType": "PERSONAL",
          "bankCountry": "CHINA",
          //国家名称
          "bankName": "开户银行",
          "bankLocation": "domestic-ZH3-ZH3_3",
          "bankBranchNo": "联行号",
          "bankBranchName": "分支行",
          "certificationTypeName": "证件类型编码",
          "identification": "证件号码",
          "defaultAccount": false,
          //是否是默认首款账号
          "acceptCcyDetail": [
            //限定首款币种可用
            "CNY"
          ],
          "remark": "备注",
          "abroadBankCodeEN": null,
          "ifsc": null,
          "abroadBankNumber": null,
          "bsb": null,
          "abroadBankBranchNo": null,
          "payeeDutyParagraph": null,
          "cbu": null,
          "businessStructureOfBeneficiaryCompany": null,
          "abroadBankCode": null,
          "abroadBankAddress": null,
          "abroadPayeeAddress": null,
          "edrpou": null,
          "bankCode": null,
          "bankId": null,
          "cuit": null,
          "abroadPayeeAccountType": null,
          "dniPassport": null,
          "iban": null,
          "customBranchFlag": null,
          "routingNumber": null,
          "branchTransitNumber": null,
          "abroadBankBizCode": null,
          "abroadPayeeType": null,
          "abroadBankBranchCode": null,
          "swiftCode": null,
          "paymentTypeBizCode": null,
          "paymentPurposeCode": null,
          "rnn": null,
          "cci": null,
          "bankIdentificationNumber": null,
          "dutyParagraph": null,
          "payeePhoneNumber": null
        }
      ]
    }
  ],
  "success": true
}

修改记录

2020-10-14 初始化
2020-11-06 接口查询逻辑修改
2020-11-10 添加controlProperties属性，非必须字段
2021-1-21 增加nameZh，nameEn 返回字段
2023-12-12 返回海外银行扩展字段
2023-12-26 返回账号的扩展字段
2025-12-16 增加预计离职日期字段
2026-07-10 增加 i18nName 字段