# 企业员工证件信息接入

# 1 新增或更新员工证件信息接口

# 接口说明

名称 描述
功能 企业通过该接口,增加或更新企业员工证件信息
HTTP方法 POST
请求方 第三方平台
响应方 美团企业版平台
url $API_HOST/staff/card/edit
method staff.card.edit

# 公共参数

详见:公共参数说明-公共请求参数

# 业务参数

名称 类型 是否必填 示例 说明
staffId Integer 30001 企业员工id
cardInfoVoList List<StaffCardInfoVO> 见StaffCardInfoVO字段说明 员工证件信息列表

StaffCardInfoVO字段说明

名称 类型 是否必填 示例 说明
cardType Integer 0 证件类型,0:身份证,1:护照,2:其它
cardName String 张三 证件姓名
cardNum String 360428195509211314 证件号码
birthday String 1989-09-03 出生年月日(pattern:yyyy-MM-dd)
sex Integer 1 性别,1:男,2:女

# 业务响应

名称 类型 是否非空 示例 说明
addOrUpdateResult Boolean true 新增或更新结果

# 示例结果

业务请求

{
  "method":"staff.card.edit",
  "ts":1512963578,
  "entId":1,
  "staffId":497095,
  "cardInfoVoList":[
    {
      "cardType":0,
      "cardName":"张三",
      "cardNum":"360428195509211314",
      "birthday":"1955-09-21",
      "sex":1
    },
    {
      "cardType":1,
      "cardName":"张三/ZHANG SAN",
      "cardNum":"360428195509211314",
      "birthday":"1955-09-21",
      "sex":1
    }
  ]
}

业务响应

{
    "msg": "",
    "data": {
        "addOrUpdateResult": true
    },
    "status": 0
}
上次更新: 4/22/2024, 4:15:08 PM