企迈云-开放平台

API 2.0

API 2.0 > 7.3 会员基础信息 > 7.3.8 录入企业员工

7.3.8 录入企业员工

开启令牌和权限后可调用。签名方式请查看开发指南

场景描述：录入企业员工

零售餐饮

请求地址

请求方式	版本信息	请求地址
POST	V2	http://openapi.zvcms.com/api/v2

公共参数

参数	参数类型	是否必填	默认值	描述
OpenId	string	是		密钥Id
GrantCode	string	是		授权code
Token	string	是		签名，参考《数字签名sign》
Timestamp	string	是		当前时间戳
Nonce	string	是		随机正整数
Action	string	是	communal.user.add-tripartite-employee	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	描述
mobilePhone	string	是	手机号
realName	string	是	员工姓名
employeeId	string	否	员工编号,不填写，系统自动生成
positionId	string	否	职级id
departmentId	string	否	部门id
cityCode	string	否	城市编码
enterpriseId	string	是	企业id
benefitRequestList	array	否
├0	array	否
├benefitNum	int	是	权益数值
├benefitsType	int	是	权益类型 0：未知 1：优惠券：2：礼品卡 3：积分 4：经验值 5：订单折扣
├unitType	string	是	单位类型 :0: 个、1: 倍数、2: 百分比折扣
├benefitTemplateId	int	是	权益模板id benefitsType为1或2必填
├benefitTitle	int	是	权益标题 benefitsType为1或2必填
├couponType	int	是	优惠券类型 1、代金券 2、折扣券 3、商品券 4、买 A 赠 B 券 5、限制数量免单券 6、免运费/配送费券 7、免排队券 8、停车券 9,erp兑换券 benefitsType为1 必填
├priceContent	string	是	礼品卡面值或者优惠券优惠内容 benefitsType为1或2必填
isSendCoupon	string	是	是否发放优惠券 1 是 0 否

响应参数

参数	参数类型	描述
status	bool	成功或失败标识
code	int	成功或失败代码
message	string	描述
data	array	返回数据

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "communal.user.add-tripartite-employee",
    "Params": {
        "mobilePhone": "",
        "realName": "",
        "employeeId": "",
        "positionId": "",
        "departmentId": "",
        "cityCode": "",
        "enterpriseId": "",
        "benefitRequestList": [
            {
                "benefitNum": "",
                "benefitsType": "",
                "unitType": "",
                "benefitTemplateId": "",
                "benefitTitle": "",
                "couponType": "",
                "priceContent": ""
            }
        ],
        "isSendCoupon": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": ""
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式	版本信息	请求地址
POST	V2	http://openapi.zvcms.com/api/v2

公共参数

参数	参数类型	是否必填	默认值	描述
OpenId	string	是		密钥Id
GrantCode	string	是		授权code
Token	string	是		签名，参考《数字签名sign》
Timestamp	string	是		当前时间戳
Nonce	string	是		随机正整数
Action	string	是	communal.user.add-tripartite-employee	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	描述
mobilePhone	string	是	手机号
realName	string	是	员工姓名
employeeId	string	否	员工编号,不填写，系统自动生成
positionId	string	否	职级id
departmentId	string	否	部门id
cityCode	string	否	城市编码
enterpriseId	string	是	企业id
benefitRequestList	array	否
├0	array	否
├benefitNum	int	是	权益数值
├benefitsType	int	是	权益类型 0：未知 1：优惠券：2：礼品卡 3：积分 4：经验值 5：订单折扣
├unitType	string	是	单位类型 :0: 个、1: 倍数、2: 百分比折扣
├benefitTemplateId	int	是	权益模板id benefitsType为1或2必填
├benefitTitle	int	是	权益标题 benefitsType为1或2必填
├couponType	int	是	优惠券类型 1、代金券 2、折扣券 3、商品券 4、买 A 赠 B 券 5、限制数量免单券 6、免运费/配送费券 7、免排队券 8、停车券 9,erp兑换券 benefitsType为1 必填
├priceContent	string	是	礼品卡面值或者优惠券优惠内容 benefitsType为1或2必填
isSendCoupon	string	是	是否发放优惠券 1 是 0 否

响应参数

参数	参数类型	描述
status	bool	成功或失败标识
code	int	成功或失败代码
message	string	描述
data	array	返回数据

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "communal.user.add-tripartite-employee",
    "Params": {
        "mobilePhone": "",
        "realName": "",
        "employeeId": "",
        "positionId": "",
        "departmentId": "",
        "cityCode": "",
        "enterpriseId": "",
        "benefitRequestList": [
            {
                "benefitNum": "",
                "benefitsType": "",
                "unitType": "",
                "benefitTemplateId": "",
                "benefitTitle": "",
                "couponType": "",
                "priceContent": ""
            }
        ],
        "isSendCoupon": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": ""
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}