保存员工档案

开发中

POST

/api/anon/openapi/pub/employee/save

最后修改时间：2024-07-11 02:24:35

责任人：阳平安

用于保存员工信息，传入账号信息可通过此方法创建账号，已存在的账号信息不允许修改，通过此方法创建的账号默认不启用

请求参数

Body 参数application/json

employee

object (员工信息(保存))

员工信息

必需

员工基础信息

null

可选

organizationCode

null

组织机构编码

可选

number

null

编号

必需

name

null

姓名

必需

EnglishName

null

英文名

可选

previousName

null

曾用名

可选

gender

null

性别

必需

1.男；2.女

departmentID

null

所属科室id

可选

licenseNumber

null

执业证号

可选

certificationNumber

null

资格证号

可选

positionID

null

职位id

可选

字典：职位

appointmentAvailable

null

是否可预约

可选

status

null

状态

可选

roleNames

array[string]

角色名称列表

可选

用户所属角色，用于分配权限，只在存在用户时有效

departmentIDs

array[integer]

兼职科室id

可选

员工兼职科室id列表

organizationCodes

array[string]

兼职机构编码

可选

员工兼职机构编码列表

profile

object

员工档案

可选

员工档案信息

mobilePhone

string

移动电话

可选

contactPhoneNumber

string

联系电话

可选

identityCardNumber

string

身份证号码

可选

nationCode

string

民族编码

可选

字典：民族，01：汉族

birthDate

string

出生日期

可选

格式：yyyy-MM-dd

joinedDate

string

入职日期

可选

格式：yyyy-MM-dd

string

电子邮箱

可选

remarks

string

备注

可选

user

object

账号信息

可选

员工登录系统的账号，已有账号则传入无效

username

string

用户名

必需

loginPassword

string

登录密码

必需

businessPassword

string

业务密码

必需

expirationDate

string

密码有效期

已废弃

密码过期时间，格式：yyyy-MM-dd，暂时无效，有效时间固定服务器当前时间

示例

{
    "employee": {
        "gender": 1,
        "name": "接口测试",
        "number": "test001",
        "certificationNumber": null,
        "licenseNumber": null,
        "departmentID": 1,
        "id": null,
        "positionID": 1,
        "appointmentAvailable": null,
        "EnglishName": null,
        "status": null,
        "organizationCode": null,
        "previousName": null
    },
    "organizationCodes": ["DEV"],
    "departmentIDs": [1,2,3],
    "user": {
        "username": "interfaceTest001",
        "loginPassword": "interface001",
        "businessPassword": "interface001",
        "expirationDate": "9999-12-30"
    },
    "roleNames": ["收银员", "电网咨询师", "咨询师"],
    "profile": {
        "contactPhoneNumber": "18160587189",
        "nationCode": "01",
        "remarks": "备注, 接口传入",
        "mobilePhone": "18160587189",
        "birthDate": "1996-02-18",
        "joinedDate": "2008-05-06",
        "identityCardNumber": "421022200011125136",
        "email": "q.tkfd@qq.com"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/anon/openapi/pub/employee/save' \
--header 'Content-Type: application/json' \
--data-raw '{
    "employee": {
        "gender": 1,
        "name": "接口测试",
        "number": "test001",
        "certificationNumber": null,
        "licenseNumber": null,
        "departmentID": 1,
        "id": null,
        "positionID": 1,
        "appointmentAvailable": null,
        "EnglishName": null,
        "status": null,
        "organizationCode": null,
        "previousName": null
    },
    "organizationCodes": ["DEV"],
    "departmentIDs": [1,2,3],
    "user": {
        "username": "interfaceTest001",
        "loginPassword": "interface001",
        "businessPassword": "interface001",
        "expirationDate": "9999-12-30"
    },
    "roleNames": ["收银员", "电网咨询师", "咨询师"],
    "profile": {
        "contactPhoneNumber": "18160587189",
        "nationCode": "01",
        "remarks": "备注, 接口传入",
        "mobilePhone": "18160587189",
        "birthDate": "1996-02-18",
        "joinedDate": "2008-05-06",
        "identityCardNumber": "421022200011125136",
        "email": "q.tkfd@qq.com"
    }
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

根据岗位同步员工信息

同步合约单位