同步员工定期区间信息
接口描述
此接口用于同步员工定期区间的信息
接口权限
本接口需要集团权限
请求URI
/api/openapi/users/contactRoutes
请求方式
POST
请求体示例
{
"employeeId": "EMP-001",
"employeeName": "従業員001",
"detailRoute": "大手町(東京都):東京メトロ東西線:Down:茅場町:東京メトロ日比谷線:Down:日比谷",
"detailRouteNoDirection": "",
"displayRoute": "大手町(東京都)--東京メトロ東西線--茅場町--東京メトロ日比谷線--日比谷",
"oneMonthPrice": 6950,
"threeMonthPrice": 19810,
"sixMonthPrice": 37530,
"status": "1001"
}
请求体字段
字段名 | 类型 | 必填 | 主键 | 约束 | 说明 |
---|---|---|---|---|---|
employeeId | String | ○ | ○ | 最大长度 32 | 员工工号 |
employeeName | String | 最大长度 100 | 员工姓名 | ||
detailRoute | String | △ | 最大长度 999 | 路线详情 状态:1002时,该参数不使用 | |
detailRouteNoDirection | String | △ | 最大长度 999 | 路线详情(无方向) 路线详情为空时,该参数必填 状态:1002时,该参数不使用 | |
displayRoute | String | △ | 最大长度 999 | 路线展示 状态:1002时,该参数不使用 | |
oneMonthPrice | Long | 最大长度 10 | 1个月定期券 | ||
threeMonthPrice | Long | 最大长度 10 | 3个月定期券 | ||
sixMonthPrice | Long | 最大长度 10 | 6个月定期券 | ||
status | String | ○ | 状态 1001:追加 1002:删除 |
接口返回示例
成功
{
"message": "success",
"key": "xxx123456"
}
失败示例
{
"message": "缺少必填项:{0}",
"errorCode": "120003"
}
字段说明
字段名称 | 类型 | 说明 |
---|---|---|
message | String | 返回信息说明 |
key | String | 员工工号 |
errorCode | String | 返回错误编码 |
错误代码
errorCode | message | 说明 |
---|---|---|
120003 | 缺少必填项:{0} | |
SPD.5394.0008 | {0}不允许超过{1}字符 | |
SPD.5394.0006 | 定期区间key字符和定期区间key字符(无方向)不可都为空 | |
SPD.5394.0009 | {0}只能输入正整数且不能大于9,999,999,999 | |
SPD.5394.0010 | 无效的状态 | |
6047065 | 该员工已离职或工号不存在 |
← 更新员工TM状态 增量查询员工定期区间 →