API文档版本切换
API接口历史版本
API历史版本主要查看已经不在做维护、更新的接口，通常均为全量查询接口，主要针对已经对接此接口客户查看。
API文档介绍（Intro）
API endpoint
正式环境:'https://api.mokahr.com/api-platform/hcm/oapi'
Moka Open API是程序化获取以及更新Moka中数据的唯一方式。你可以通过Moka API集成其他的服务，如eHR系统、OA系统等等。
Moka Open API的设计基于REST，使用标准的HTTP功能如HTTP方法、HTTP状态码以及HTTP basic
auth等，以便于支持HTTP的服务可以便捷接入。所有的接口数据都通过JSON格式传输（包括错误信息），并使用Unicode UTF-8进行编码。当有字段值为空的时候，返回的结果为null
，若字段为数组型且为空的时候，返回的结果为空数组[]。
为了提供更好的体验，Moka Open API在不断完善升级中。当更新中包含不向后兼容的接口时，我们会升级API版本，并保留旧的API正常运行。这意味着在接入Moka API时，你的代码需要能够处理一些如返回数据字段增加等向后兼容的变动。目前的API版本是v1.0。
API接口类型说明
针对接口中所涉及到的不同字段类型，对应的数据格式进行说明
API字段类型说明（Type）
字段类型TYPE示例
type = 4 的 whether类型示例
{
"labelList": [
{
"fieldName": "is_probation",
"label": "是否试用",
"type": 4
}
],
"list": [
{
"is_probation": "否"
}
]
}
type = 5 的select类型示例
{
"labelList": [
{
"fieldName": "highest_degree",
"label": "最高学位",
"type": 5
},
{
"fieldName": "household_type",
"label": "户籍类型",
"type": 5
}
],
"list": [
{
"highest_education": "研究生",
"highest_education_id": 2,
"household_type": "本地农业",
"household_type_id": 1
}
]
}
type = 6 的address类型示例
{
"labelList": [
{
"fieldName": "household_address",
"label": "户籍地址",
"type": 6
}
],
"list": [
{
"household_address": "2324",
"household_province_code": "",
"household_city_code": "",
"household_county_code": 2
}
]
}
type = 9 的certificate类型示例
{
"labelList": [
{
"fieldName": "id_no",
"label": "证件号码",
"type": 9
},
{
"fieldName": "id_no_id_type",
"label": "证件类型",
"type": 9
}
],
"list": [
{
"id_no": "hzzzz19",
"id_type": 2,
"id_no_id_type": "护照"
}
]
}
type = 13的duty类型示例
{
"labelList": [
{
"fieldName": "duty",
"label": "职务",
"type": 13
}
],
"list": [
{
"duty_id": 313,
"duty": "湖南BD"
}
]
}
type = 15的duty_level类型示例
{
"labelList": [
{
"fieldName": "duty_level",
"label": "职级",
"type": 15
}
],
"list": [
{
"duty_level": "P1",
"duty_level_id": 10
}
]
}
每个返回结果的字段都对应Moka系统中的一种数据类型type，具体的字段类型可以在接口返回数据的labelList查看，每种数据字段都有相应的数据处理方式，Moka Open API会根据数据字段的类型做特殊处理，type表示该字段在Moka Open API系统中的字段类型
| 值 | Moka字段类型 | 描述 |
|---|---|---|
| type = 1 | String | 表示字符串类型；无特殊处理 |
| type = 2 | Date类型 | 表示日期类型；无特殊处理 |
| type = 3 | number类型 | 表示数字类型；无特殊处理 |
| type = 4 | whether类型 | 表示"是否"类型；Moka Open API会将数据内容转为"是"、"否"2种字段中的一个 |
| type = 5 | select类型 | 表示枚举类型；Moka Open API会将数据内容转为枚举value中，并且同时额外返回一个字段："xxx_id"，表示该枚举的id编号 其中"xxx"表示内置字段或者是用户的自定义字段 |
| type = 6 | address类型 | 表示地址类型；Moka Open API会返回4个字段：a.地址详情"xxx"; b. 省邮编号"xxx _province_code"; c. 城市邮编号" xxx_city_code"; d. 区县邮编号" xxx_county_code"。 其中"xxx"表示type=6的内置字段或者是用户的自定义字段 |
| type = 7 | telephone类型 | 表示手机类；Moka Open API会额外返回1个字段：手机区号"xxx_county_code"，其中"xxx"表示type=7的内置字段或者是用户的自定义字段 注意：由于特殊原因，手机区号会返回"xxx_county_code"或者"xxx_country_code"，请客户做好兼容 |
| type = 8 | attachment类型 | 表示附件类型；无特殊处理 |
| type = 9 | certificate类型 | 表示证件类型；Moka Open API会返回3个字段：a.证件类型"xxx_id_type"; b. 证件类型的id编码"id_type"; c. 证件号码"xxx"。 其中"xxx"表示type=9的内置字段或者是用户的自定义字段 |
| type = 11 | text类型 | 表示文本类型；无特殊处理 |
| type = 12 | department类型 | 表示部门类型；无特殊处理 |
| type = 13 | duty类型 | 表示职务类型；Moka Open API会返回2个字段: a. 职务名称"xxx"; b.职务的id编号"xxx_id"。 其中"xxx"表示type=13的内置字段或者是用户的自定义字段 |
| type = 14 | position类型 | 表示职位类型；Moka Open API会返回2个字段: a. 职位名称"xxx"; b.职位的id编号"xxx_id"。 其中"xxx"表示type=14的内置字段或者是用户的自定义字段 |
| type = 15 | Duty_level类型 | 表示职级类型；Moka Open API会返回2个字段: a. 职级名称"xxx"; b.职级的id编号"xxx_id"。 其中"xxx"表示type=15的内置字段或者是用户的自定义字段 |
| type = 16 | Work_place类型 | 表示工作地点类型；Moka Open API会返回2个字段: a. 工作地点名称"xxx"; b.工作地点的id编号"xxx_id"。 其中"xxx"表示type=16的内置字段或者是用户的自定义字段 |
| type = 17 | person类型 | 表示人员类型；Moka Open API会返回2个字段: a. 工作地点名称"xxx"; b.工作地点的id编号"xxx_id"。 其中"xxx"表示type=17的内置字段或者是用户的自定义字段 |
| type = 19 | event类型 | 表示事件类型；无特殊处理 |
| type = 20 | event_reason类型 | 表示事件原因类型；无特殊处理 |
| type = 21 | Corporation类型 | 表示公司类型；Moka Open API会返回2个字段: a. 公司名称"xxx"; b.公司的id编号"xxx_id"。 其中"xxx"表示type=21的内置字段或者是用户的自定义字段 |
| type = 25 | recruit类型 | 表示招聘类型；无特殊处理 |
| type = 40 | bank类型 | 表示银行卡类型； |
API时间字段格式说明（Date）
当前版本API中时间类型的字段共有如下几种格式：
| 类型 | 格式 | 例子 | 例子的含义 |
|---|---|---|---|
| 精确到年的日期 | yyyy | 2018 | 例如毕业年份 |
| 精确到月的日期 | yyyy-MM | 2018-09 | 例如毕业时间 |
| 精确到天的日期 | yyyy-MM-dd | 2018-09-27 | 例如到岗日期 |
| 精确到时、分、秒的日期 | yyyy-MM-ddTHH:mm:ss.sssZ | 2018-09-27T02:00:00.000Z | 例如面试开始时间 |
| 精确到毫秒的时间戳 | 时间戳 | 1628131532000 | 例如员工创建时间 |
其中，YYYY-MM-DDTHH:mm: ss.sssZ的格式为ISO8601标准，具体含义可以参考这里
注意：由于历史原因，某些字段并没有严格按照以上规则设置格式。比如存在某些精确到天的日期也使用了yyyy-MM-ddTHH:mm:ss.sssZ的格式。因此开发者最好做到能同时识别这几种格式，并根据需要解析成需要的内容。
API空字段格式说明（null）
如果字段的值value为空，那么有以下3种情况中：
- 字段的key不会显示（无值）
字段的key可能不会显示，比如endDate由于值为空，不显示
{
"startDate":"2021-02-01" //endDate由于值为空，不显示
}
- 字段的value为null（无值）
字段的value可能为null，比如endDate由于值为空，显示null
{
"startDate":"2021-02-01",
"endDate": null
}
- 字段的value为空字符串（有值，但为空）
字段的value可能为null，比如endDate由于值为空，显示""
{
"startDate":"2021-02-01",
"endDate": ""
}
API开发前必读（Required）
API开发指南（Guide）
- Moka提供OpenAPI鉴权、签名、API总览、调用流程、实践及常见问题，可查阅 《Moka People用户帮助中心》 中的 文档&集成
对外接口设置说明
Moka People中用户可以基于不同的场景使用要求，创建不同的接口。基于"对外接口设置中"不同的数据源选择，会返回不同的数据。接口设置完成后，会生成对应的apiCode（接口编码），eg： - 如果数据源是 员工任职信息，那么将返回请求参数中userName关联角色的数据权限下的所有员工数据，除了"待入职"的员工 - 如果数据源是 职务信息，那么返回该租户下的所有职务数据
API鉴权认证（Basic Auth）
工具类示例代码
public class Base64 {
private static char[] Base64Code = {
'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J',
'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T',
'U', 'V', 'W', 'X', 'Y', 'Z', 'a', 'b', 'c', 'd',
'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n',
'o', 'p
', 'q
', 'r', 's', 't', 'u', 'v', 'w', 'x',
'y', 'z', '0', '1', '2', '3', '4', '5', '6', '7',
'8', '9', '+', '/'};
private static byte[] Base64Decode = {
-1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
-1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
-1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
-1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
-1, -1, -1, 62, -1, 63, -1, 63, 52, 53,
54, 55, 56, 57, 58, 59, 60, 61, -1, -1,
-1, 0, -1, -1, -1, 0, 1, 2, 3, 4,
5, 6, 7, 8, 9, 10, 11, 12, 13, 14,
15, 16, 17, 18, 19, 20, 21, 22, 23, 24,
25, -1, -1, -1, -1, -1, -1, 26, 27, 28,
29, 30, 31, 32, 33, 34, 35, 36, 37, 38,
39, 40, 41, 42, 43, 44, 45, 46, 47, 48,
49, 50, 51, -1, -1, -1, -1, -1};
public static String encode(byte[] b) {
int code = 0;
if (b == null)
return null;
StringBuffer sb = new StringBuffer((b.length - 1) / 3 << 6);
for (int i = 0; i < b.length; i++) {
code |= b[i] << 16 - i % 3 * 8 & 255 << 16 - i % 3 * 8;
if ((i % 3 != 2) && (i != b.length - 1))
continue;
sb.append(Base64Code[((code & 0xFC0000) >>> 18)]);
sb.append(Base64Code[((code & 0x3F000) >>> 12)]);
sb.append(Base64Code[((code & 0xFC0) >>> 6)]);
sb.append(Base64Code[(code & 0x3F)]);
code = 0;
}
if (b.length % 3 > 0)
sb.setCharAt(sb.length() - 1, '=');
if (b.length % 3 == 1)
sb.setCharAt(sb.length() - 2, '=');
return sb.toString();
}
public static byte[] decode(String code) {
if (code == null)
return null;
int len = code.length();
if (len % 4 != 0)
throw new IllegalArgumentException("Base64 String length must be 4*n");
if (code.length() == 0)
return new byte[0];
int pad = 0;
if (code.charAt(len - 1) == '=')
pad++;
if (code.charAt(len - 2) == '=')
pad++;
int retLen = len / 4 * 3 - pad;
byte[] ret = new byte[retLen];
for (int i = 0; i < len; i += 4) {
int j = i / 4 * 3;
char ch1 = code.charAt(i);
char ch2 = code.charAt(i + 1);
char ch3 = code.charAt(i + 2);
char ch4 = code.charAt(i + 3);
int tmp = Base64Decode[ch1] << 18 | Base64Decode[ch2] << 12 | Base64Decode[ch3] << 6 | Base64Decode[ch4];
ret[j] = (byte) ((tmp & 0xFF0000) >> 16);
if (i < len - 4) {
ret[(j + 1)] = (byte) ((tmp & 0xFF00) >> 8);
ret[(j + 2)] = (byte) (tmp & 0xFF);
} else {
if (j + 1 < retLen)
ret[(j + 1)] = (byte) ((tmp & 0xFF00) >> 8);
if (j + 2 < retLen)
ret[(j + 2)] = (byte) (tmp & 0xFF);
}
}
return ret;
}
}
import java.io.ByteArrayOutputStream;
import java.security.Key;
import java.security.KeyFactory;
import java.security.KeyPair;
import java.security.KeyPairGenerator;
import java.security.PrivateKey;
import java.security.PublicKey;
import java.security.Signature;
import java.security.interfaces.RSAPrivateKey;
import java.security.interfaces.RSAPublicKey;
import java.security.spec.PKCS8EncodedKeySpec;
import java.security.spec.X509EncodedKeySpec;
import java.util.HashMap;
import java.util.Map;
import javax.crypto.Cipher;
public class RSAUtils {
/**
* 加密算法RSA
*/
public static final String KEY_ALGORITHM = "RSA";
/**
* 签名算法
*/
public static final String SIGNATURE_ALGORITHM = "MD5withRSA";
/**
* 获取公钥的key
*/
private static final String PUBLIC_KEY = "RSAPublicKey";
/**
* 获取私钥的key
*/
private static final String PRIVATE_KEY = "RSAPrivateKey";
/**
* RSA最大加密明文大小
*/
private static final int MAX_ENCRYPT_BLOCK = 117;
/**
* RSA最大解密密文大小
*/
private static final int MAX_DECRYPT_BLOCK = 128;
/**
* <p>
* 用私钥对信息生成数字签名
* </p>
*
* @param data 已加密数据
* @param privateKey 私钥(BASE64编码)
*
* @return
* @throws Exception
*/
public static String sign(byte[] data, String privateKey) throws Exception {
byte[] keyBytes = Base64.decode(privateKey);
PKCS8EncodedKeySpec pkcs8KeySpec = new PKCS8EncodedKeySpec(keyBytes);
KeyFactory keyFactory = KeyFactory.getInstance(KEY_ALGORITHM);
PrivateKey privateK = keyFactory.generatePrivate(pkcs8KeySpec);
Signature signature = Signature.getInstance(SIGNATURE_ALGORITHM);
signature.initSign(privateK);
signature.update(data);
return Base64.encode(signature.sign());
}
/**
* <p>
* 校验数字签名
* </p>
*
* @param data 已加密数据
* @param publicKey 公钥(BASE64编码)
* @param sign 数字签名
*
* @return
* @throws Exception
*
*/
public static boolean verify(byte[] data, String publicKey, String sign)
throws Exception {
byte[] keyBytes = Base64.decode(publicKey);
X509EncodedKeySpec keySpec = new X509EncodedKeySpec(keyBytes);
KeyFactory keyFactory = KeyFactory.getInstance(KEY_ALGORITHM);
PublicKey publicK = keyFactory.generatePublic(keySpec);
Signature signature = Signature.getInstance(SIGNATURE_ALGORITHM);
signature.initVerify(publicK);
signature.update(data);
return signature.verify(Base64.decode(sign));
}
}
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.security.PrivateKey;
import java.security.Signature;
import java.security.SignatureException;
import java.security.interfaces.RSAPrivateKey;
import java.util.Map;
import java.net.URLEncoder;
import org.apache.commons.lang.StringEscapeUtils;
import org.bouncycastle.asn1.pkcs.PrivateKeyInfo;
import org.bouncycastle.openssl.PEMKeyPair;
import org.bouncycastle.openssl.PEMParser;
import org.bouncycastle.openssl.jcajce.JcaPEMKeyConverter;
import com.google.common.base.Charsets;
public class RSATester {
static String publicKey = "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCha6yx4FDC7bwq617P9H3VvNIJOZ9VG9PuNMq/Cckwjqnp7bEh8hmMqbv/1Lhgg62JTFTEp0or5TSj9Vz+WxYJqW2KUXTmIjJ9LAMw6X6IMeqfHt9yQyGbNe1Hx15qfZ0jDlbCgzn88xYZt2BI4NW1ul5r25sM2CYUgKUo/PNq+QIDAQAB";
static String privateKey = "MIICdgIBADANBgkqhkiG9w0BAQEFAASCAmAwggJcAgEAAoGBAKFrrLHgUMLtvCrrXs/0fdW80gk5n1Ub0+40yr8JyTCOqentsSHyGYypu//UuGCDrYlMVMSnSivlNKP1XP5bFgmpbYpRdOYiMn0sAzDpfogx6p8e33JDIZs17UfHXmp9nSMOVsKDOfzzFhm3YEjg1bW6XmvbmwzYJhSApSj882r5AgMBAAECgYAvDdQphdoE+IgBetsIg5yq0X/ocIOhq5r7tSfkyFV9chjVuBQKcShBeLj0um2EtN3BSB7ttFZKtWXC5aNWAfdKIHixb3e57fndgUMupAskl4moQLiTQaHtwmEd/vsQj6RhbIWah2T38RdnsoWwypPcQbS9E4883NS7b6ok4hGQAQJBAPvshB9g3MEAZ1u9Mo/4QJ4OFuYjxLGfAdO28w91EDGb9xvdrw5Bee7olMqYJV6XpYF3XVFjv3TAJJcBiYMVfpECQQCkCEnWnmqkrrccl67sQtcxeQ0DjKuAgK164kdsiKl7wDFLkkgGxevHgoU4gHugMmTWeie6gbH/P+Bqous2PinpAkAc7woxrGdOR2SXlcBD5shNHuMkZYFGwTNthHqgENreR8J20dw0L/L4LIBCUH0iQxqAJxxxp5oqp5LMQSHxCzvxAkBreXLHyCwfksovVcMq0fClXacFOFn2bFk+NpyNpE1H4/lohoPizDNcGUyoZKabo+kmDguRzACQOY4U0IJEnB5hAkEAugocLJLrsTF4Powxmuq3dip79z+ZQEvkP4qrmTlz1EIqg8350tBqD+cJsK5FxJ0oZD50P+0mpoww4Gse+V4M1g==";
public static void main(String[] args) throws Exception {
String s = "apiCode=00001&entCode=1&nonce=9999999×tamp=1565244098737&userName=361@qq.com";
System.err.println("私钥签名——公钥验证签名");
String sign = RSAUtils.sign(s.getBytes(), privateKey);
System.out.println("公钥:" + publicKey);
System.out.println("签名:\r" + URLEncoder.encode(sign, "UTF-8"));
boolean status = RSAUtils.verify(s.getBytes(), publicKey, sign);
System.out.println("验证结果:\r" + status);
}
}
java示例签名代码
import com.alibaba.fastjson.JSONObject;
import com.moka.hcm.common.util.verify.RSAUtils;
import lombok.extern.slf4j.Slf4j;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;
@Slf4j
public class SignExample {
public void sign(String apiCode, String entCode, Long timestamp, String userName, String nonce, String privateKey) {
Map<String, Object> params = new HashMap();
params.put("entCode", entCode);
params.put("apiCode", apiCode);
params.put("timestamp", timestamp);
params.put("userName", userName);
params.put("nonce", nonce);
List<String> list = new ArrayList<>(params.keySet());
list.sort((String o1, String o2) -> o1.compareTo(o2));
String sb = list.stream().map(e -> {
return e + "=" + params.get(e);
}).collect(Collectors.joining("&"));
String requiredSign = null;
try {
requiredSign = RSAUtils.sign(sb.getBytes(), privateKey);
} catch (Exception exception) {
log.error("加密生成sign异常", exception);
}
log.info("验签sign, entCode:{},privateKey:{}, requiredSign:{}", entCode, privateKey, requiredSign);
}
}
python示例签名代码
from Crypto.PublicKey import RSA
from Crypto.Signature import PKCS1_v1_5
from Crypto.Hash import MD5
import base64
def my_hash(data):
return MD5.new(data.encode('utf-8'))
def rsa_sign(data):
private_key_file = open('private.pem', 'r')
pri_key = RSA.importKey(private_key_file.read())
signer = PKCS1_v1_5.new(pri_key)
hash_obj = my_hash(data)
signature = base64.b64encode(signer.sign(hash_obj))
private_key_file.close()
return signature
def rsa_verify(signature, data):
public_key_file = open('public.pem', 'r')
pub_key = RSA.importKey(public_key_file.read())
hash_obj = my_hash(data)
verifier = PKCS1_v1_5.new(pub_key)
public_key_file.close()
return verifier.verify(hash_obj, base64.b64decode(signature))
if __name__ == '__main__':
test_data = "apiCode=0fe827b0ce0c2f1249642119bc3efcdb&entCode=0fe827b0ce0c2f1249642119bc3efcdb
&nonce=99999915×tamp=1632742060453&userName=qyzhg113@core.qyzhg.com"
print(rsa_sign(test_data).decode('utf-8'))
print(rsa_verify(rsa_sign(test_data), test_data))
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
示例：Basic Base64.encode(apiKey:) 冒号不可缺失 注意：如使用postman时 将apiKey作为Basic auth的username，password 不需要填写 |
请求参数 Query Param
| 要求 | 说明 | |
|---|---|---|
| timestamp | 请求中的时间戳与当前时间戳的时间范围不能超过3min | 比如用户请求的时间戳是9:00，如果当前时间是9:01，那么该请求的时间戳是合法的；如果当前时间是9:05，那么该请求的时间戳是非法的 |
| nonce | 随机数，长度不超过10位，字符和数字即可；用户请求的nonce，5min以内不能重复 | 比如用户在9:00发送的nonce=jl7sw，如果用户在9:05再次发送该nonce，那么该请求非法；如果用户在9:11再次发送该nonce，那么该请求合法。所以建议用户每次发送不同的nonce值 |
| sign | 见下文 |
API签名规则（Sign）
为了验证用户的请求合法性，使用RSA验签的方式对用户的请求参数sign进行验证
签名sign的生成方法：
第1步： 将请求Params参数中的所有不包含sign参数的数据，按照字典顺序对参数进行排序，生成url格式的字符串作为待签名数据。
示例1 (无username参数)：
apiCode=0001&entCode=1&nonce=999×tamp=1565244098737
示例2 (有username参数)：
apiCode=0001&entCode=1&nonce=999×tamp=1565244098737&userName=xiao@qq.com
第2步： 对上述字符串做md5WithRsa算法进行签名，得到sign。
第3步： 最后把sign放入url请求Params参数中即可
组织接口API
组织部门数据接口
接口说明：通过此接口，可以获取 Moka People 中部门数据（部门名称、部门编码、部门负责人、上级部门等）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/department/batchData?apiCode=88f86eba5d3ff183042b6e21f07a8fed&entCode=5c1b8165cedfaba1a83136c1fb3c1b45&nonce=zct0ygn1×tamp=1661404684195&sign=HHzzdkwB8sSzqQv6zaeMVX%2BpVK8jAHjFnsB2KVl5x0s%2BgCSD%2B2nN4GA8Qb96Ua%2BXHhtKgLM%2F8ZD1NBi3sa3F31vBK%2FKGmNGe26z7YIpvsA4kyNX%2BXP21M6synTarPjc1oY4HcS1JQXfhupwIWXLt%2FdJ6VdZv%2Fccrn3JpXtgxkEo%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '{
"pageSize": 200,
"pageNum": 1,
"nodeUidList":[],
"nodeCodeList":[],
"haveUsed":"1"
}'
操作成功，返回数据示例
{
"code":200,
"msg":"操作成功",
"data":{
"list":[
{
"effect_date":"2021-02-19T00:00:00",
"node_uid":103658,
"director":"摩小卡",
"dept_name":"Moka公司/Moka部门1/Moka部门2",
"dept_prop-DF_849951626054441ea7aad667cfa11f30":"自定义单行文本示例文案",
"dept_level":{
"name":"一级",
"id":"1"
},
"dept_hierarchy":{
"id":1,
"name":"一级"
},
"dept_prop-DF_0680803d73084843b1b68732c5721814":{
"dept_prop-DF_0680803d73084843b1b68732c5721814_id":1,
"dept_prop-DF_0680803d73084843b1b68732c5721814_value":"自定义单选选项1"
},
"dept_prop-DF_8ac03f428ac1457297c45b5ea0cc526c":"自定义多行文本事例文案",
"node_code":"NO.114545",
"tree_order":"5001",
"dept_sample_name":"Moka部门2",
"dept_type":1,
"superior_dept":{
"name":null,
"id":"null"
},
"have_used":1,
"status":0,
"director_id":103285
}
],
"total":1,
"size":1,
"labelList":[
{
"fieldName":"dept_name",
"label":"部门名称",
"type":1
},
{
"fieldName":"superior_dept",
"label":"上级部门",
"type":12
},
{
"fieldName":"effect_date",
"label":"生效日期",
"type":2
},
{
"fieldName":"relate_dept_code",
"label":"部门编号",
"type":1
},
{
"fieldName":"DF_849951626054441ea7aad667cfa11f30",
"label":"自定义单行文本",
"type":1,
"biz":"dept_prop"
},
{
"fieldName":"hrbp",
"label":"HRBP",
"type":17
},
{
"fieldName":"director",
"label":"负责人",
"type":17
},
{
"fieldName":"DF_0680803d73084843b1b68732c5721814",
"label":"自定义单选",
"type":5,
"biz":"dept_prop"
},
{
"fieldName":"DF_8ac03f428ac1457297c45b5ea0cc526c",
"label":"自定义多行文本",
"type":11,
"biz":"dept_prop"
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/department/batchData
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【批量-组织架构信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| nodeUidList | 否 | Array<Long> | 部门ID列表/数组，<=200条 部门ID数组与部门编码数组不可以同时传入，二者择一传入即可 |
| nodeCodeList | 否 | Array<String> | 部门编码列表/数组，<=200条 部门ID数组与部门编码数组不可以同时传入，二者择一传入即可 |
| haveUsed | 否 | int | 0：停用 1：启用 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 | |
| data.labelList | JsonArray | 业务数据内容的字段说明 | |
| data.size | int | 返回结果的业务数据条数 | |
| data.total | Long | 总条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| node_uid | Long | 部门ID | 唯一主键 |
| node_code | String | 部门编码 | 唯一部门编码 |
| dept_sample_name | String | 部门名称 | 部门名称 示例：开发一组 |
| dept_name | String | 部门全称 | 显示部门全路径 示例：Moka/开发部/开发一组 |
| effect_date | String | 部门生效时间 | yyyy-MM-dd’T’HH:mm:ss |
| dept_type | String | 部门类型 | 示例：1:公司 2:事业部 3:大区 4:部门 5:小组 |
| superior_dept | Json | 上级部门信息 | 根节点则为null 示例： "superior_dept": {"id":"177596","name":"测试部门1"} |
| dept_level | Json | 物理部门层级 | 系统自动生成 示例："dept_level":{"id":1,"name":"一级"} |
| dept_hierarchy | Json | 业务部门层级 | 系统界面编辑 示例："dept_hierarchy":{"id":1,"name":"一级"} |
| dept_director | Json | 部门负责人信息 | 示例："dept_director": {"dept_director_id":100,"dept_director_name":"张三","dept_director_emp_no":"No.233"} |
| dept_hrbp | Json | hrbp信息 | 示例："dept_hrbp": {"dept_hrbp_id":200,"dept_hrbp_name":"李四","dept_hrbp_emp_no":"No.223"} |
| tree_order | Long | 部门排序 | 表示同一层级下, 对应部门组织树的顺序，tree_order越小的，顺序越靠前。 比如同一层级，A部门(tree_order = 1001)，B部门(tree_order = 1002)，A部门在B部门前面 |
| have_used | Long | 是否启用 | 0:停用 1:启用 |
| DF_随机字符串 | String | 自定义字段 | 各个租户自己定义的额外字段（注意：需要根据 labelList 里的字段类型解析其中的数据） 用户自定义字段的 fieldname 包含所属分组前缀，即字段 key 值形式为「biz name」+「-」+「DF」+「随机字符串」 |
成本中心数据接口
接口说明：通过此接口，可以获取Moka People中，成本中心数据（成本中心名称、成本中心负责人、上级成本中心等）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/costCenterInfo?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '{
"employeeIdList":[],
"pageSize": 200,
"pageNum": 1
}'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": {
"pageNum": 1,
"pageSize": 200,
"size": 1,
"total": 1,
"list": [
{
"cost_center_prop-remark": "",
"cost_center_prop-superior_cost_center_code": "20210",
"cost_center_duty-cost_center_director": "摩小卡",
"cost_center_prop-cost_center_id": 832,
"cost_center_prop-cost_center_code": "20211",
"cost_center_prop-have_used": 1,
"cost_center_prop-effect_date": "2022-04-25",
"cost_center_prop-cost_center_level": "二级",
"cost_center_duty-effect_date": "2022-04-01",
"cost_center_prop-cost_center_name": "Moka事业部",
"cost_center_duty-cost_center_director_id": 244582,
"cost_center_prop-superior_cost_center_id": 830,
"cost_center_prop-superior_cost_center": "Moka公司"
}
],
"labelList": null
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/costCenterInfo
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【成本中心信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| costCenterIdList | 否 | Array<Long> | 成本中心ID列表/数组, 数组长度不超过200 |
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组，数组长度不超过200 |
| startTime | 否 | String | 成本中心的生效时间，格式yyyy-MM-dd |
| endTime | 否 | String | 成本中心的生效时间，格式yyyy-MM-dd，和startTime联合使用，时间范围不超过180天 |
| haveUsed | 否 | int | 是否启用 枚举值 0:停用1:启用 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 | |
| data.labelList | JsonArray | 业务数据内容的字段说明 | |
| data.pageSize | int | 分页大小 | |
| data.pageNum | int | 分页页码 | |
| data.size | int | 返回数据条数 | |
| data.total | Long | 总条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| cost_center_prop-remark | String | 成本中心备注信息 | |
| cost_center_prop-superior_cost_center_code | String | 上级成本中心编码 | |
| cost_center_duty-cost_center_director | String | 成本中心负责人姓名 | |
| cost_center_prop-cost_center_id | Long | 成本中心ID | |
| cost_center_prop-cost_center_code | String | 成本中心编码 | |
| cost_center_prop-have_used | int | 成本中心状态 | 可选值1：启用 0：停用 |
| cost_center_prop-effect_date | String | 成本中心生效日期 | |
| cost_center_prop-cost_center_level | String | 成本中心级别 | |
| cost_center_prop-cost_center_name | String | 成本中心名称 | |
| cost_center_duty-cost_center_director_id | Long | 成本中心负责人员工ID | |
| cost_center_prop-superior_cost_center_id | Long | 上级成本中心ID | |
| cost_center_prop-superior_cost_center | String | 上级成本中心名称 |
项目组数据接口
接口说明：通过此接口，可以获取Moka People中，项目组信息数据（项目组名称、项目组负责人、上级项目组等）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/get_project?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '{
"pageNum": 1,
"pageSize": 20,
"versionDate":"2025-01-01",
"projectNameList":["项目组1","项目组2","项目组3"],
"projectCodeList":["项目组code1","项目组code2","项目组code3"]
}'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": {
"pageNum": 1,
"pageSize": 20,
"total": 1,
"data": [
{
"id": 1,
"code": "项目组code1",
"name": "项目组1",
"level": {
"id": 1,
"name": "一级"
},
"haveUsedStatus": 1,
"parentProject": {
"projectId": 2,
"projectCode": "项目组code2",
"projectName": "项目组2"
},
"effectiveDate": {
"timestamp": 1706198400000,
"dateStr": "2024-01-26"
},
"director": {
"id": 22,
"realname": "项目组负责人",
"employeeNo": "000779"
},
"customFields": {
"DF_文本自定义字段": "字符串自定义字段值",
"DF_是非单选自定义字段": {
"id": 1,
"name": "是"
},
"DF_日期自定义字段": {
"timestamp": 1706198400000,
"dateStr": "2024-01-26"
},
"DF_职责自定义字段": {
"id": 2222,
"realname": "姓名",
"employeeNo": "000779"
}
}
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/get_project
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【项目组信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| projectIdList | 否 | List |
项目组ID列表/数组, 数组长度不超过200 |
| projectCodeList | 否 | List |
项目组编码列表/数组，数组长度不超过200 |
| projectNameList | 否 | List |
项目组名称列表/数组，数组长度不超过200 |
| versionDate | 否 | String | 项目组版本时间，格式yyyy-MM-dd，不传默认查当前最新版本 |
| haveUsed | 否 | int | 是否启用 枚举值 0:停用1:启用 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.data | JsonArray | 返回结果的业务数据内容 | |
| data.pageSize | int | 分页大小 | |
| data.pageNum | int | 分页页码 | |
| data.size | int | 返回数据条数 | |
| data.total | Long | 总条数 |
返回结果data.data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | Long | 项目组id | |
| code | String | 项目组编码 | |
| name | String | 项目组名称 | |
| level | Object | 项目组层级，结构可参考示例参数 | |
| haveUsedStatus | int | 成本中心状态 | 可选值1：启用 0：停用 |
| parentProject | Object | 上级项目组，结构可参考示例参数 | |
| effectiveDate | Object | 生效时间，结构可参考示例参数 | |
| director | Object | 项目组负责人，结构可参考示例参数 | |
| customFields | Map |
自定义字段值 |
查询IM部门数据接口
接口说明：通过此接口，可以获取对应IM（企业微信、钉钉、飞书）通讯录中，部门ID
请求成功示例
{
"code": 200,
"msg": "操作成功",
"data": [
{
"nodeUid": "144140",
"corpId": "wx3e4e44805",
"deptId": 1,
"type": 1
},
{
"nodeUid": "144145",
"corpId": "wx3e4e44805",
"deptId": 94,
"type": 1
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/im/data
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工关联信息】对应的接口编码 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| deptIdList | 否 | Array<Long> | 部门ID列表/数组,在moka系统中的唯一标识ID, 数组长度不超过200 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | JSONArray | 返回结果的数据内容 | |
| └nodeUid | Long | 部门在moka系统中的唯一标识ID, 数组长度不超过200， 注：对应request body中的deptId |
|
| └detpId | String | 第三方IM的部门ID | |
| └corpId | String | 第三方IM的CorpID | |
| └type | int | 部门ID类型 | 可选值1：企业微信2:钉钉3：飞书 |
新增成本中心接口
接口说明：通过该接口可变更成本中心数据（注意：回写的数据通过系统校验才能写入成功）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/create_costcenter?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"costcenterCreateParamList": [
{
"effectDate": "2020-06-12",
"values": [
{
"biz": "cost_center_prop",
"fieldName": "cost_center_code",
"value": "Ava"
},
{
"biz": "cost_center_prop",
"fieldName": "cost_center_name",
"value": "向晚意不适"
},
{
"biz": "cost_center_prop",
"fieldName": "superior_cost_center",
"value": "100"
},
{
"biz": "cost_center_duty",
"fieldName": "cost_center_director",
"value": "200"
}
]
}
]
}
'
请求成功返回结果
{
"code": 100001,
"msg": "操作失败",
"data": {
"messageList": [
{
"index": 0,
"id": 1000,
"errorItems": [
{
"code": 100,
"tip": "名称在 2022-01-01 已被其他成本中心使用",
"biz": "cost_center_prop",
"fieldName": "cost_center_name"
}
]
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/create_costcenter
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【新增成本中心接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| costcenterCreateParamList | 是 | Array | 新增成本中心内容 |
| └effectDate | 是 | Date | 变更成本中心的生效日期 格式yyyy-MM-dd |
| └values | 是 | Array | 成本中心字段变更内容 |
| └└biz | 是 | String | 成本中心字段biz |
| └└fieldName | 是 | String | 成本中心字段fieldName |
| └└value | 是 | String | 成本中心字段变更内容,上级成本中心、成本中心职责传id（转string） |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └messageList | Array | 返回结果的业务数据内容 | |
| └└index | int | 元素的下标，对应入参的顺序（从0开始） | |
| └└id | int | 新创建成功的记录 id | |
| └└errorItems | Array | 错误信息 | |
| └└└code | int | 错误code码 | |
| └└└tip | String | 错误提示信息 | |
| └└└biz | String | 成本中心字段biz | |
| └└└fieldName | String | 成本中心字段fieldName |
变更成本中心接口
接口说明：通过该接口可变更成本中心数据（注意：回写的数据通过系统校验才能写入成功）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/org/update_costcenter?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"costcenterUpdateParamList": [
{
"id" : 1000
"effectDate": "2020-06-12",
"values": [
{
"biz": "cost_center_prop",
"fieldName": "superior_cost_center",
"value": "200"
},
{
"biz": "cost_center_duty",
"fieldName": "cost_center_director",
"value": "300"
}
]
}
]
}
'
请求成功返回结果
{
"code": 100001,
"msg": "操作失败",
"data": {
"messageList": [
{
"index": 0,
"errorItems": [
{
"code": 100,
"tip": "名称在 2022-01-01 已被其他成本中心使用",
"biz": "cost_center_prop",
"fieldName": "cost_center_name"
}
]
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/update_costcenter
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【变更成本中心接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| costcenterUpdateParamList | 是 | Array | 新增成本中心内容 |
| └id | 是 | int | 变更的id |
| └effectDate | 是 | Date | 变更成本中心的生效日期 格式yyyy-MM-dd |
| └values | 是 | Array | 成本中心字段变更内容，需要变哪个传哪个 |
| └└biz | 是 | String | 成本中心字段biz |
| └└fieldName | 是 | String | 成本中心字段fieldName |
| └└value | 是 | String | 成本中心字段变更内容,上级成本中心、成本中心职责传id（转string），空字符串视为清空该字段 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └messageList | Array | 返回结果的业务数据内容 | |
| └└index | int | 元素的下标，对应入参的顺序（从0开始） | |
| └└id | int | 新创建成功的记录 id | |
| └└errorItems | Array | 错误信息 | |
| └└└code | int | 错误code码 | |
| └└└tip | String | 错误提示信息 | |
| └└└biz | String | 成本中心字段biz | |
| └└└fieldName | String | 成本中心字段fieldName |
变更成本中心状态接口
接口说明：通过该接口可变更成本中心状态（注意：回写的数据通过系统校验才能写入成功）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/org/update_costcenter_status?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"id" : 100,
"haveUsedStatus" : 0,
"effectDate" : "2020-06-12"
}
'
请求成功返回结果
{
"code": 100001,
"msg": "操作失败",
"data": {}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/update_costcenter_status
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【变更成本中心状态接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| id | 是 | Array | 新增成本中心内容 |
| haveUsedStatus | 是 | int | 变更类型 0停用 1启用 |
| effectDate | 是 | Date | 停用需要传 停用时间 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 |
新增项目组接口
接口说明：通过该接口可新增项目组数据（注意：新增的数据通过系统校验才能写入成功,入参内项目组数据不能包含上下级项目组数据）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/create_project?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"projectCreateParamList": [
{
"effectDate": "2024-01-30",
"name": "openapi添加节点3",
"code":"openapi1",
"director":{
"id":1
"employeeNo":"DMW000008"
},
"parentProject":{
"id":1
"code":"code0125"
}
},
{
"effectDate": "2024-01-30",
"name": "openapi添加节点4",
"code":"openapi2",
"director":{
"id":1
"employeeNo":"DMW000008"
},
"parentProject":{
"id":1
"code":"code0125"
}
}
]
}
'
请求成功返回结果
{
"code": 100001,
"msg": "操作失败",
"data": {
"messageList": [
{
"index": 0,
"id": 1000,
"errorItems": [
{
"code": 100,
"tip": "名称在 2022-01-01 已被其他项目组使用",
"biz": "project_prop",
"fieldName": "project_name"
}
]
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/create_project
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【新增项目组接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| projectCreateParamList | 是 | Array | 新增加项目组内容,数组长度不超过200 |
| └effectDate | 是 | String | 生效日期 格式yyyy-MM-dd |
| └name | 是 | String | 项目组名称 |
| └code | 否 | String | 编码 |
| └director | 否 | Object | 项目组负责人 |
| └└id | 否 | Long | 项目组负责人id,与employeeNo参数二选一 |
| └└employeeNo | 否 | String | 项目组负责人工号 |
| └parentProject | 否 | Object | 上级项目组 |
| └└id | 否 | Long | 上级项目组id,与code参数二选一 |
| └└code | 否 | String | 上级项目组编码 |
| └customFieldValues | 否 | Array | 自定义字段值 |
| └└biz | 是 | String | 项目组字段biz |
| └└fieldName | 是 | String | 项目组字段fieldName |
| └└value | 是 | String | 项目组字段变更内容,自定义职责传id（转string） |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └messageList | Array | 返回结果的业务数据内容 | |
| └└index | int | 元素的下标，对应入参的顺序（从0开始） | |
| └└id | int | 新创建成功的记录 id | |
| └└errorItems | Array | 错误信息 | |
| └└└code | int | 错误code码 | |
| └└└tip | String | 错误提示信息 | |
| └└└biz | String | 项目组字段biz | |
| └└└fieldName | String | 项目组字段fieldName |
更新项目组接口
接口说明：通过该接口可更新项目组数据（注意：更新的数据通过系统校验才能写入成功）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/update_project?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"projectUpdateParamList": [
{
"id": 1,
"effectDate": "2024-01-30",
"name": "openapi添加节点3",
"code":"openapi1",
"director":{
"id":1
"employeeNo":"DMW000008"
},
"parentProject":{
"id":1
"code":"code0125"
}
},
{
"id": 2,
"effectDate": "2024-01-30",
"name": "openapi添加节点4",
"code":"openapi2",
"director":{
"id":1
"employeeNo":"DMW000008"
},
"parentProject":{
"id":1
"code":"code0125"
}
}
]
}
'
请求成功返回结果
{
"code": 100001,
"msg": "操作失败",
"data": {
"messageList": [
{
"index": 0,
"id": 1000,
"errorItems": [
{
"code": 100,
"tip": "名称在 2022-01-01 已被其他项目组使用",
"biz": "project_prop",
"fieldName": "project_name"
}
]
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/update_project
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【变更项目组接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| projectUpdateParamList | 是 | Array | 需要变更的项目组内容,数组长度不超过200 |
| └id | 是 | Long | 项目组id |
| └effectDate | 是 | String | 生效日期 格式yyyy-MM-dd |
| └name | 是 | String | 项目组名称 |
| └code | 否 | String | 编码 |
| └director | 否 | Object | 项目组负责人 |
| └└id | 否 | Long | 项目组负责人id,与employeeNo参数二选一 |
| └└employeeNo | 否 | String | 项目组负责人工号 |
| └parentProject | 否 | Object | 上级项目组 |
| └└id | 否 | Long | 上级项目组id,与code参数二选一 |
| └└code | 否 | String | 上级项目组编码 |
| └customFieldValues | 否 | Array | 自定义字段值 |
| └└biz | 是 | String | 项目组字段biz |
| └└fieldName | 是 | String | 项目组字段fieldName |
| └└value | 是 | String | 项目组字段变更内容,自定义职责传id（转string） |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └messageList | Array | 返回结果的业务数据内容 | |
| └└index | int | 元素的下标，对应入参的顺序（从0开始） | |
| └└id | int | 新创建成功的记录 id | |
| └└errorItems | Array | 错误信息 | |
| └└└code | int | 错误code码 | |
| └└└tip | String | 错误提示信息 | |
| └└└biz | String | 项目组字段biz | |
| └└└fieldName | String | 项目组字段fieldName |
新增法人公司接口
接口说明：通过该接口可新增法人公司数据（注意：回写的数据通过系统校验才能写入成功）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/org/create_company?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"address": {
"globalType": "1",
"description": "888",
"geographicData": {
"provinceCode": "120000",
"cityCode": "120000",
"areaCode": "120105"
}
},
"manageAddress": {
"globalType": "1",
"description": "999",
"geographicData": {
"provinceCode": "140000",
"cityCode": "140500",
"areaCode": "140581"
}
},
"enName": "444",
"code": "111",
"nodeName": "222",
"shortName": "333",
"shortEnName": "555",
"legalName": "666",
"companyNature": 1,
"registrationDate": "2023-05-01",
"unifiedSocialCreditCode": "777",
"zipCode": "123456",
"description": "101010",
"others": [
{
"fieldName": "DF_f4bc975b626a4f0498902333a4d79f89",
"value": "2023-05-31"
},
{
"fieldName": "DF_fe9eb1ccc9d54c60a29b036703a096a5",
"value": 1
},
{
"fieldName": "DF_31f9aed0666a4e80be221934584a917c",
"value": "212121"
},
{
"fieldName": "DF_4a0dfc798ad843d892bfafaf24b152ec",
"value": 1
}
]
}
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": {
"nodeUid": 1000
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/create_company
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【新增法人公司接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 参数名称 | 是否必填 | 参数类型 | 参数描述 | 示例 | 备注 |
|---|---|---|---|---|---|
| code | 否 | string | 编码 | ||
| nodeName | 是 | string | 公司名称 | ||
| shortName | 否 | string | 公司简称 | ||
| enName | 否 | string | 公司英文名 | ||
| shortEnName | 否 | string | 公司英文简称 | ||
| legalName | 否 | string | 法人名称 | ||
| companyNature | 否 | int | 公司性质 | ||
| registrationDate | 否 | string | 注册日期 | yyyy-MM-dd格式 | |
| unifiedSocialCreditCode | 否 | string | 统一社会信用代码 | ||
| address | 否 | object | 注册地址 | ||
| └globalType | 否 | int | 国别类型 | 1 中国大陆 2 港澳台及海外 | |
| └description | 否 | string | 描述 | ||
| └geographicData | 否 | object | |||
| └└provinceCode | 否 | string | 中国大陆省份编码/港澳台及海外国家的编码 | 参见：https://people.mokahr.com/docs/api/view/v1.html#-158 | |
| └└cityCode | 否 | string | 城市编码 | 参见： https://people.mokahr.com/docs/api/view/v1.html#-159 | |
| └└areaCode | 否 | string | 地区编码 | ||
| manageAddress | |||||
| └globalType | 否 | int | 国别类型 | 1 中国大陆 2 港澳台及海外 | |
| └description | 否 | string | 描述 | ||
| └geographicData | 否 | object | |||
| └└provinceCode | 否 | string | 中国大陆省份编码/港澳台及海外国家的编码 | 参见：https://people.mokahr.com/docs/api/view/v1.html#-158 | |
| └└cityCode | 否 | string | 城市编码 | 参见：https://people.mokahr.com/docs/api/view/v1.html#-159 | |
| └└areaCode | 否 | string | 地区编码 | ||
| zipCode | 否 | string | 邮政编码 | ||
| description | 否 | string | 描述 | ||
| others | 否 | array | 自定义字段 | ||
| └fieldName | 否 | string | 字段名 | DF_xxx | |
| └value | 否 | string | 字段值 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | object |
变更法人公司接口
接口说明：通过该接口可变更法人公司数据（注意：回写的数据通过系统校验才能写入成功）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/org/update_company?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"nodeUid" : 100,
"address": {
"globalType": "1",
"description": "888",
"geographicData": {
"provinceCode": "120000",
"cityCode": "120000",
"areaCode": "120105"
}
},
"manageAddress": {
"globalType": "1",
"description": "999",
"geographicData": {
"provinceCode": "140000",
"cityCode": "140500",
"areaCode": "140581"
}
},
"enName": "444",
"code": "111",
"nodeName": "222",
"shortName": "333",
"shortEnName": "555",
"legalName": "666",
"companyNature": 1,
"registrationDate": "2023-05-01",
"unifiedSocialCreditCode": "777",
"zipCode": "123456",
"description": "101010",
"others": [
{
"fieldName": "DF_f4bc975b626a4f0498902333a4d79f89",
"value": "2023-05-31"
},
{
"fieldName": "DF_fe9eb1ccc9d54c60a29b036703a096a5",
"value": 1
},
{
"fieldName": "DF_31f9aed0666a4e80be221934584a917c",
"value": "212121"
},
{
"fieldName": "DF_4a0dfc798ad843d892bfafaf24b152ec",
"value": 1
}
]
}
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": { }
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/update_company
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【变更法人公司接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 参数名称 | 是否必填 | 参数类型 | 参数描述 | 示例 | 备注 |
|---|---|---|---|---|---|
| nodeUid | 是 | int | 法人公司id | ||
| code | 否 | string | 编码 | ||
| nodeName | 否 | string | 公司名称 | ||
| shortName | 否 | string | 公司简称 | ||
| enName | 否 | string | 公司英文名 | ||
| shortEnName | 否 | string | 公司英文简称 | ||
| legalName | 否 | string | 法人名称 | ||
| companyNature | 否 | int | 公司性质 | ||
| registrationDate | 否 | string | 注册日期 | yyyy-MM-dd格式 | |
| unifiedSocialCreditCode | 否 | string | 统一社会信用代码 | ||
| address | 否 | object | 注册地址 | ||
| └globalType | 否 | int | 国别类型 | 1 中国大陆 2 港澳台及海外 | |
| └description | 否 | string | 描述 | ||
| └geographicData | 否 | object | |||
| └└provinceCode | 否 | string | 中国大陆省份编码/港澳台及海外国家的编码 | 参见：https://people.mokahr.com/docs/api/view/v1.html#-158 | |
| └└cityCode | 否 | string | 城市编码 | 参见： https://people.mokahr.com/docs/api/view/v1.html#-159 | |
| └└areaCode | 否 | string | 地区编码 | ||
| manageAddress | |||||
| └globalType | 否 | int | 国别类型 | 1 中国大陆 2 港澳台及海外 | |
| └description | 否 | string | 描述 | ||
| └geographicData | 否 | object | |||
| └└provinceCode | 否 | string | 中国大陆省份编码/港澳台及海外国家的编码 | 参见：https://people.mokahr.com/docs/api/view/v1.html#-158 | |
| └└cityCode | 否 | string | 城市编码 | 参见：https://people.mokahr.com/docs/api/view/v1.html#-159 | |
| └└areaCode | 否 | string | 地区编码 | ||
| zipCode | 否 | string | 邮政编码 | ||
| description | 否 | string | 描述 | ||
| others | 否 | array | 自定义字段 | ||
| └fieldName | 否 | string | 字段名 | DF_xxx | |
| └value | 否 | string | 字段值 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | object |
变更法人公司状态接口
接口说明：通过该接口可变更法人公司状态（注意：回写的数据通过系统校验才能写入成功）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/org/update_company_status?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"id" : 980,
"haveUsedStatus" : 1
}
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": { }
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/update_company_status
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【变更法人公司状态接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 参数名称 | 是否必填 | 参数类型 | 参数描述 | 示例 | 备注 |
|---|---|---|---|---|---|
| id | 是 | int | 法人公司id | ||
| haveUsedStatus | 是 | int | 0 停用；1 启用 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | object |
获取法人公司接口
接口说明：通过该接口可获得法人公司的数据
请求示例
curl --location 'http://localhost:8007/oapi/v1/org/get_legal_company?entCode=80f853acec2a28d8e1adc01dc876e07e&apiCode=91fff5601dacdefdb2c30b8ae247a672×tamp=1683279462&nonce=1233321&sign=000000' \
--header 'Content-Type: application/json' \
--data '{
"legalCompanyNameList" : ["北聪明核桃教育科技有限公司西安分公司", "天津希瑞亚斯科技有限公司801","好未来集团(修改名字）"],
"haveUsed" : 1
}'
'
请求成功返回结果
{
"code": 0,
"msg": "成功",
"data": {
"hasMore": false,
"nextCursor": null,
"list": [
{
"id": 16186,
"code": "",
"nodeName": "北聪明核桃教育科技有限公司西安分公司",
"shortName": "123123",
"enName": "",
"shortEnName": "",
"legalName": "",
"companyNature": 0,
"registrationDate": "",
"unifiedSocialCreditCode": "",
"address": {
"globalType": "1",
"description": "",
"geographicData": {
"provinceCode": "",
"cityCode": "",
"areaCode": ""
}
},
"manageAddress": {
"globalType": "1",
"description": "",
"geographicData": {
"provinceCode": "",
"cityCode": "",
"areaCode": ""
}
},
"zipCode": "",
"description": "",
"haveUsedStatus": 1
},
{
"id": 48900,
"code": "",
"nodeName": "天津希瑞亚斯科技有限公司801",
"shortName": "moka",
"enName": "yingwen",
"shortEnName": "",
"legalName": "章三",
"companyNature": 0,
"registrationDate": "",
"unifiedSocialCreditCode": "",
"address": {
"globalType": null,
"description": "我们的大学",
"geographicData": {
"provinceCode": "130000",
"cityCode": "610700",
"areaCode": "610100"
}
},
"manageAddress": {
"globalType": null,
"description": "我们的大学1",
"geographicData": {
"provinceCode": "130000",
"cityCode": "610700",
"areaCode": "610100"
}
},
"zipCode": "202020",
"description": "",
"haveUsedStatus": 1
},
{
"id": 48924,
"code": "",
"nodeName": "好未来集团(修改名字）",
"shortName": "好未来",
"enName": "",
"shortEnName": "",
"legalName": "张邦鑫",
"companyNature": 0,
"registrationDate": "",
"unifiedSocialCreditCode": "",
"address": {
"globalType": null,
"description": "中关村",
"geographicData": {
"provinceCode": "150000",
"cityCode": "150300",
"areaCode": "150303"
}
},
"manageAddress": {
"globalType": null,
"description": "中关村",
"geographicData": {
"provinceCode": "110000",
"cityCode": "110000",
"areaCode": "110108"
}
},
"zipCode": "234343",
"description": "",
"haveUsedStatus": 1
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/get_legal_company
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【法人公司】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 参数名称 | 是否必填 | 参数类型 | 参数描述 | 示例 | 备注 |
|---|---|---|---|---|---|
| legalCompanyIdList | 否 | array | 法人公司 ID 集合，item 为每个要查询的法人公司 ID，long 类型 | [10001,20001,30001] | 1、不能超过 200 条 2、参数 legalCompanyIdList 与 legalCompanyNameList 只能传入一个 |
| legalCompanyNameList | 否 | array | 法人公司全称集合，item 为每个要查询的法人公司全称，String 类型 | ["北京希瑞亚斯","成都希瑞亚斯"] | 1、不能超过 200 条 2、参数 legalCompanyIDList 与 legalCompanyNameList 只能传入一个 |
| haveUsed | 否 | Integer | 是否启用 | 0：停用 1：启用 | |
| pageSize | 否 | Integer | 分页大小，如果不传默认 200 | 最大 200 | |
| nextCursor | 否 | Integer | 分页标记，第一次查询时不传，后续使用上一次查询时返回nextCursor |
注：legalCompanyIdList 和 legalCompanyNameList 都传空时会返回租户的全部法人公司数据
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | object | 返回结果的数据内容 | |
| data.hasMore | Boolean | 是否还有下一页 | |
| data.nextCursor | Integer | 分页标记（如果hasMore为true，则下次查询时传此nextCursor） | |
| data.list[] | Array | ||
| data.list[].id | Long | 法人公司 ID | |
| data.list[].code | String | 公司编码 | |
| data.list[].nodeName | String | 公司名称 | |
| data.list[].shortName | String | 公司简称 | |
| data.list[].enName | String | 公司英文名称 | |
| data.list[].shortEnName | String | 公司英文简称 | |
| data.list[].legalName | String | 公司法人 | |
| data.list[].companyNature | Integer | 公司性质 | 可选值：0：空 1：合资公司 2：全资公司 3：外资公司 |
| data.list[].registrationDate | String | 公司注册日期 | yyyy-MM-dd 格式 |
| data.list[].unifiedSocialCreditCode | String | 统一社会信用代码 | |
| data.list[].address | Object | 注册地址 | |
| └globalType | String | 国别类型 | 可选值：1：中国大陆 2：港澳台及海外 |
| └description | String | 详细地址 | |
| └geographicData | Object | 地理位置数据 | |
| └└provinceCode | String | 中国大陆省份编码/港澳台及海外国家的编码 | 参见：https://people.mokahr.com/docs/api/view/v1.html#-158 |
| └└cityCode | String | 城市编码 | 参见：https://people.mokahr.com/docs/api/view/v1.html#-159 |
| └└areaCode | String | 地区编码 | |
| data.list[].manageAddress | Object | 经营地址 | |
| └globalType | String | 国别类型 | 可选值：1：中国大陆 2：港澳台及海外 |
| └description | String | 详细地址 | |
| └geographicData | Object | 地理位置数据 | |
| └└provinceCode | String | 中国大陆省份编码/港澳台及海外国家的编码 | 参见：https://people.mokahr.com/docs/api/view/v1.html#-158 |
| └└cityCode | String | 城市编码 | 参见：https://people.mokahr.com/docs/api/view/v1.html#-159 |
| └└areaCode | String | 地区编码 | |
| data.list[].zipCode | String | 邮政编码 | |
| data.list[].description | String | 描述 | |
| data.haveUsedStatus | Integer | 状态 | 可选值：0 停用；1 启用 |
新增组织部门接口
接口说明：通过该接口可对组织部门数据进行新增
请求示例
curl --request POST \
--url 'http://localhost:8007/oapi/v1/org/department/batchCreate?entCode=0f2673af30d55d2e8b20298202ca326f&apiCode=27a136d77843c603720026bc4c1c6999×tamp=1241234&nonce=12&sign=12' \
--header 'content-type: application/json' \
--data '{
"data": [
{
"nodeCode": "",
"deptSampleName": "测试添加7",
"effectDate": "2024-04-06",
"deptType": "1",
"deptHierarchy": "2",
"deptDirector": {
"deptDirectorId": "75766620",
"deptDirectorEmpNo":"124123"
},
"deptHrbp": {
"deptHrbpId": "75766620",
"deptHrbpEmpNo": "34324583"
},
"treeOrder": "3",
"extendFields": [
{"fieldName":"DF_2c838bbf66a14f48b78a64858da4ddfc1",
"fieldValue":"103739",
"fieldEmployeeNo":"110"}
]
}
]
}'
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": [
{
"nodeUid": 124213423,
"nodeCode": "yc00000022",
"code": 200,
"msg": "写入成功"
},
{
"nodeUid": null,
"nodeCode": "yc00000021",
"code": 400,
"msg": "写入失败:新增部门失败"
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/department/batchCreate
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【法人公司】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 参数名称 | 是否必填 | 参数类型 | 参数描述 | 示例 | 备注 |
|---|---|---|---|---|---|
| data | 否 | array | 部门批量写入集合 | ||
| nodeUid | 否 | Long | 部门id，新增时可为空 | ||
| nodeCode | 必须 | string | 部门编码 | ||
| deptSampleName | 必须 | string | 部门名称 | ||
| effectDate | 必须 | string | 生效日期 | ||
| deptType | 否 | string | 部门类型 | ||
| superiorDept | 必须 | object | 上级部门 | ||
| superiorDept.superiorDeptCode | 必须 | string | 上级部门编码 | ||
| superiorDept.superiorDeptId | 必须 | Long | 上级部门id | ||
| deptHierarchy | 否 | string | 部门层级 | ||
| deptDirector | 否 | object | 部门负责人 | ||
| deptDirector.deptDirectorId | 否 | number | 部门负责人ID | ||
| deptDirector.deptDirectorEmpNo | 否 | string | 部门负责人工号 | ||
| deptHrbp | 否 | object | HRBP | ||
| deptHrbp.deptHrbpId | 否 | Long | HRBP ID | ||
| deptHrbp.deptHrbpEmpNo | 否 | string | HRBP工号 | ||
| treeOrder | 否 | Long | 同一层级下，对应部门组织树的顺序，值越小顺序越靠前 | ||
| extendFields | 否 | array | 额外自定义字段 | ||
| extendFields.fieldName | 必须 | string | 自定义字段名字(DF_随机字符串) | ||
| extendFields.fieldValue | 否 | string | 部门自定义字段的值，部门职责时为员工ID | ||
| extendFields.fieldEmployeeNo | 否 | string | 部门自定义字段的值，如果是部门职责的时候，为员工工号，否则为空即可 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | array | 返回结果的数据内容 | |
| data[].nodeUid | String | 部门id | |
| data[].nodeCode | String | 部门编码 | |
| data[].code | Integer | 200:成功 400:失败 | |
| data[].msg | String | 响应信息 |
修改组织部门接口
接口说明：通过该接口可对组织部门数据进行修改
请求示例
curl --request POST \
--url 'http://localhost:8007/oapi/v1/org/department/batchUpdate?entCode=0f2673af30d55d2e8b20298202ca326f&apiCode=27a136d77843c603720026bc4c1c6999×tamp=1241234&nonce=12&sign=12' \
--header 'content-type: application/json' \
--data '{
"data": [
{
"nodeCode": "",
"deptSampleName": "测试修改7",
"effectDate": "2024-04-06",
"deptType": "1",
"deptHierarchy": "2",
"deptDirector": {
"deptDirectorId": "75766620",
"deptDirectorEmpNo":"124123"
},
"deptHrbp": {
"deptHrbpId": "75766620",
"deptHrbpEmpNo": "34324583"
},
"treeOrder": "3",
"extendFields": [
{"fieldName":"DF_2c838bbf66a14f48b78a64858da4ddfc1",
"fieldValue":"103739",
"fieldEmployeeNo":"110"}
]
}
]
}'
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": [
{
"nodeUid": 124213423,
"nodeCode": "yc00000022",
"code": 200,
"msg": "写入成功"
},
{
"nodeUid": null,
"nodeCode": "yc00000021",
"code": 400,
"msg": "写入失败:修改部门失败"
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/department/batchUpdate
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【法人公司】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 参数名称 | 是否必填 | 参数类型 | 参数描述 | 示例 | 备注 |
|---|---|---|---|---|---|
| data | 否 | array | 部门批量写入集合 | ||
| nodeUid | 必须 | Long | 部门id，新增时可为空 | ||
| nodeCode | 必须 | string | 部门编码 | ||
| deptSampleName | 否 | string | 部门名称 | ||
| effectDate | 必须 | string | 生效日期 | ||
| deptType | 否 | string | 部门类型 | ||
| superiorDept | 否 | object | 上级部门 | ||
| superiorDept.superiorDeptCode | 非必须 | string | 上级部门编码 | ||
| superiorDept.superiorDeptId | 非必须 | Long | 上级部门id | ||
| deptHierarchy | 否 | string | 部门层级 | ||
| deptDirector | 否 | object | 部门负责人 | ||
| deptDirector.deptDirectorId | 否 | number | 部门负责人ID | ||
| deptDirector.deptDirectorEmpNo | 否 | string | 部门负责人工号 | ||
| deptHrbp | 否 | object | HRBP | ||
| deptHrbp.deptHrbpId | 否 | Long | HRBP ID | ||
| deptHrbp.deptHrbpEmpNo | 否 | string | HRBP工号 | ||
| treeOrder | 否 | Long | 同一层级下，对应部门组织树的顺序，值越小顺序越靠前 | ||
| extendFields | 否 | array | 额外自定义字段 | ||
| extendFields.fieldName | 必须 | string | 自定义字段名字(DF_随机字符串) | ||
| extendFields.fieldValue | 否 | string | 部门自定义字段的值，部门职责时为员工ID | ||
| extendFields.fieldEmployeeNo | 否 | string | 部门自定义字段的值，如果是部门职责的时候，为员工工号，否则为空即可 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | array | 返回结果的数据内容 | |
| data[].nodeUid | String | 部门id | |
| data[].nodeCode | String | 部门编码 | |
| data[].code | Integer | 200:成功 400:失败 | |
| data[].msg | String | 响应信息 |
变更组织部门状态接口
接口说明：通过该接口可对组织部门数据进行启停用状态变更
请求示例
curl --request POST \
--url 'http://localhost:8007/oapi/v1/org/department/batch/update/haveUsed?entCode=0f2673af30d55d2e8b20298202ca326f&apiCode=27a136d77843c603720026bc4c1c6999×tamp=1241234&nonce=12&sign=12' \
--header 'content-type: application/json' \
--header 'hcm-user: {"uid":103532}' \
--data '{
"data": [
{
"nodeUid": "239074",
"nodeCode": "yc000000001",
"effectDate": "2026-04-07",
"haveUsed": "1"
}
]
}'
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": [
{
"nodeUid": 124213423,
"nodeCode": "yc00000022",
"code": 200,
"msg": "写入成功"
},
{
"nodeUid": 124213424,
"nodeCode": "yc00000021",
"code": 400,
"msg": "写入失败:部门已经停用"
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/department/batch/update/haveUsed
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【法人公司】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 参数名称 | 是否必填 | 参数类型 | 参数描述 | 示例 | 备注 |
|---|---|---|---|---|---|
| data | 否 | array | 部门批量修改启停用状态写入集合 | ||
| nodeUid | 必须 | Long | 部门id | ||
| nodeCode | 必须 | string | 部门编码 | ||
| effectDate | 必须 | string | 生效日期 | ||
| haveUsed | 必须 | string | 启停用状 0-停用 1-启用 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | array | 返回结果的数据内容 | |
| data[].nodeUid | String | 部门id | |
| data[].nodeCode | String | 部门编码 | |
| data[].code | Integer | 200:成功 400:失败 | |
| data[].msg | String | 响应信息 |
获取编制信息接口
接口说明：通过该接口可查询租户的部门编制计划信息
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/org/hc/plan/query?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"headCountCycleDate":"2024-10-30",
"departmentList":[
{
"departmentId": 119674
},
{
"departmentNo": "NO.233643"
}
]
}
'
请求成功返回结果
{
"code": 0,
"msg": null,
"data": {
"headCountCycle": {
"periodId": 16069,
"periodName": "2024年第四季度(10月~12月)",
"startDate": "2024-10-01T00:00:00.000+0800",
"endDate": "2024-12-31T23:59:59.000+0800"
},
"headCountDetails": [
{
"departmentId": 119837,
"dutyId": 616,
"positionId": null,
"dutyLevelId": null,
"officeAddressId": null,
"employeeTypeId": null,
"headCountPlan": 1,
"headCountPpl": 8,
"headCountVacancy": -7,
"headCountProcessIn": 0,
"headCountProcessOut": 0,
"headCountLimitation": 1
},
{
"departmentId": 119837,
"dutyId": 1793,
"positionId": null,
"dutyLevelId": null,
"officeAddressId": null,
"employeeTypeId": null,
"headCountPlan": 1,
"headCountPpl": 2,
"headCountVacancy": -1,
"headCountProcessIn": 0,
"headCountProcessOut": 0,
"headCountLimitation": 0
},
{
"departmentId": 119837,
"dutyId": null,
"positionId": null,
"dutyLevelId": null,
"officeAddressId": null,
"employeeTypeId": null,
"headCountPlan": 30,
"headCountPpl": 28,
"headCountVacancy": 2,
"headCountProcessIn": 0,
"headCountProcessOut": 0,
"headCountLimitation": 1
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/org/hc/plan/query
请求频率：1次/秒/企业, 20次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【获取编制信息接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 备注 |
|---|---|---|---|
| headCountCycleDate | 是 | String | 编制周期日期(YYYY-MM-DD) |
| departmentList | 否 | Array | 需要查询的部门集合(不传查所有) |
| └departmentId | 否 | Long | 部门id |
| └departmentNo | 否 | String | 部门编码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Object | 返回数据 | |
| └headCountCycle | Object | 编制周期 | |
| └└periodId | Long | 周期id | |
| └└periodName | String | 周期名称 | |
| └└endDate | Date | 周期结束时间 | |
| └└startDate | Date | 周期开始时间 | |
| └headCountDetails | Array | 编制计划数据集合 | |
| └└departmentId | Long | 部门id | |
| └└dutyId | Long | 职务id | |
| └└positionId | Long | 职位ID | |
| └└dutyLevelId | Long | 职级ID | |
| └└officeAddressId | Long | 工作地点ID | |
| └└employeeTypeId | Long | 员工类型ID | |
| └└headCountPlan | Long | 计划编制数 | |
| └└headCountPpl | Long | 在职占编数 | |
| └└headCountVacancy | Long | 空缺编制数 | |
| └└headCountProcessIn | Long | 在途调入数 | |
| └└headCountProcessOut | Long | 在途调出数 | |
| └└headCountLimitation | Integer | 是否允许超编，1-允许，0-不允许 |
职位职务接口API
岗职位体系，基于业务管理模式的不同，提供两种管理模式：基于职务的管理、基于职位的管理 调用接口前，请先联系CSM（客户成功经理），确认您当前租户的管理模式（职位、职务）
职位信息数据接口
接口说明：通过此接口，可以获取Moka People中，职位数据（职位ID，职位名称，职位所属部门等）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/getPositionPageList??entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{"pageSize":100,"pageNum":1,"positionName":"职务名称"}'
操作成功，返回数据示例 （以职务数据为例）
{
"code": 0,
"msg": "成功",
"data": {
"pageNum": 1,
"pageSize": 100,
"total": 1,
"list": [
{
"id": 83406,
"positionName": "摩小卡负责人",
"namePinyin": "moxiaokafuzeren",
"nameInitials": "mxkfzr",
"departmentId": 153456,
"department": "PP",
"effectDate": "2022-06-30",
"status": 1,
"group": 3352,
"groupName": "PeoPle业务线",
"positionClass": null,
"positionClassName": null,
"subclass": null,
"subclassName": null,
"isKeyPosition": 2,
"positionDesc": "",
"superiorPositionId": null,
"superiorPosition": null,
"others": [
{
"attrId": 970196,
"moduleId": 10,
"modelId": 57426,
"modelTitle": "职位信息",
"biz": "position",
"fieldName": "DF_0b320abb610b46b0bcfefb026a5b2190",
"enabled": true,
"type": 1,
"sortNo": 10,
"ref": "",
"uniqueness": 0,
"attrValues": null,
"label": "职位等级",
"options": "",
"alphabet": "moka",
"value": ""
}
]
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/getPositionPageList
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【职位信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| idList | 否 | Array<Long> | 职位ID列表/数组 |
| positionName | 否 | String | 职位名称 |
| departmentIdList | 否 | Array<Long> | 所属部门id列表/数组 |
| status | 否 | int | 状态 枚举值 0:停用1:启用 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体：Response Body,JSON格式
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | Long | 职位ID | |
| positionName | String | 职位名称 | |
| namePinyin | String | 职位名称名字全拼 | |
| nameInitials | String | 职位名称名字首字母 | |
| departmentId | Long | 所属部门的id | |
| department | String | 部门名称 | |
| effectDate | String | 生效日期 | 格式 yyyy-MM-dd |
| status | int | 状态 | 可选值：1:启用 0:停用 |
| group | int | 职位族id | |
| groupName | String | 职位族名称 | |
| positionClass | Long | 职位类id | |
| positionClassName | String | 职位类名称 | |
| subclass | Long | 职位子类id | |
| subclassName | String | 职位类子名称 | |
| isKeyPosition | int | 是否是关键职位 | 可选值：1:是2:否 |
| positionDesc | String | 工作职责 | |
| superiorPositionId | Long | 上级职位id | |
| superiorPosition | String | 上级职位名称 | |
| others | Array |
自定义字段信息 | |
新增职位接口
接口说明：通过此接口，可以向Moka People新增职位数据，支持一次性添加多个职位，按照data数组内顺序添加，成功的落库并记录职位ID至返回记录中，失败的记录到返回记录中，部门支持部门编码或者部门ID识别，Id有值时按Id查询，否则使用编码
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchAddPosition?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{"data": [
{
"positionName": "API新增的职级11",
"isKeyPosition": false,
"superiorPositionId":99999,
"departmentId": 99999,
"effectDate": "2024-06-20",
"groupId": "61",
"extendFields": [
{
"fieldName": "DF_15730314902789999",
"value": "9991928"
}
]
},
{
"positionName": "API新增的职级21",
"isKeyPosition": false,
"departmentId": 9999,
"groupId": "9999",
"effectDate": "2010-06-20",
"extendFields": [
{
"fieldName": "DF_15730314902789999",
"value": "9991928"
}
]
}
]}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": {
"resultList": [
{
"positionId": null,
"positionName": "API新增的职级21",
"code": 400,
"msg": "effectDate生效日期不能早于所属部门成立日期"
},
{
"positionId": 99999,
"positionName": "API新增的职级11",
"code": 200,
"msg": "操作成功"
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchAddPosition
请求频率：5次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【新增职位接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 新增的职位列表/数组 |
| └positionName | 是 | String | 职位名称 |
| └superiorPositionId | 否 | Long | 上级职位ID |
| └effectDate | 是 | Date | 生效日期（yyyy-MM-dd） |
| └departmentId | 否 | Long | 部门ID，不能和部门编码同时为空 |
| └departmentCode | 否 | String | 部门编码，不能和部门ID同时为空 |
| └isKeyPosition | 是 | Boolean | 是否关键职位 |
| └positionDesc | 否 | String | 职位说明 |
| └groupId | 是 | Long | 职位族ID |
| └positionClassId | 否 | Long | 职位类ID |
| └subClassId | 否 | Long | 职位子类ID |
| └extendFields | 否 | Array | 其他自定义字段 |
| └└fieldName | 是 | String | 字段唯一name |
| └└value | 是 | String | 字段值 |
响应体：Response Body,JSON格式
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └resultList | Array | 新增职位的结果 | |
| └└positionId | Long | 职位ID | |
| └└positionName | String | 职位名称 | |
| └└code | Integer | 响应码 | |
| └└msg | String | 响应信息 |
变更职位接口
接口说明：通过此接口，可以向Moka People更新职位数据，支持一次性更改多个职位，职位ID为必填项，不支持更新已停用职位
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchUpdatePosition?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{"data": [
{
"positionId": 123456,
"positionName": "API新增的职级11",
"isKeyPosition": false,
"superiorPositionId":99999,
"departmentId": 99999,
"effectDate": "2024-06-20",
"groupId": "61",
"extendFields": [
{
"fieldName": "DF_15730314902789999",
"value": "9991928"
}
]
},
{
"positionId": 123457,
"positionName": "API新增的职级21",
"isKeyPosition": false,
"departmentId": 9999,
"groupId": "9999",
"effectDate": "2010-06-20",
"extendFields": [
{
"fieldName": "DF_15730314902789999",
"value": "9991928"
}
]
}
]}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": {
"resultList": [
{
"positionId": 123456,
"positionName": "API新增的职级11",
"code": 400,
"msg": "effectDate生效日期不能早于所属部门成立日期"
},
{
"positionId": 123457,
"positionName": "API新增的职级21",
"code": 200,
"msg": "操作成功"
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchUpdatePosition
请求频率：5次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【变更职位接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 变更的职位列表/数组 |
| └positionId | 是 | Long | 职位ID |
| └positionName | 是 | String | 职位名称 |
| └superiorPositionId | 否 | Long | 上级职位ID |
| └effectDate | 是 | Date | 生效日期（yyyy-MM-dd） |
| └departmentId | 否 | Long | 部门ID，不能和部门编码同时为空 |
| └departmentCode | 否 | String | 部门编码，不能和部门ID同时为空 |
| └isKeyPosition | 是 | Boolean | 是否关键职位 |
| └positionDesc | 否 | String | 职位说明 |
| └groupId | 是 | Long | 职位族ID |
| └positionClassId | 否 | Long | 职位类ID |
| └subClassId | 否 | Long | 职位子类ID |
| └extendFields | 否 | Array | 其他自定义字段 |
| └└fieldName | 是 | String | 字段唯一name |
| └└value | 是 | String | 字段值 |
响应体：Response Body,JSON格式
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └resultList | Array | 新增职位的结果 | |
| └└positionId | Long | 职位ID | |
| └└positionName | String | 职位名称 | |
| └└code | Integer | 响应码 | |
| └└msg | String | 响应信息 |
变更职位状态接口
接口说明：通过此接口，可以向Moka People更新职位状态，支持一次性更改多个职位，职位ID为必填项
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchUpdatePositionStatus?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{"data": [
{
"positionId": 123456,
"haveUsed": 1
},
{
"positionId": 123457,
"haveUsed": 0
}
]}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": {
"resultList": [
{
"positionId": 123456,
"code": 400,
"msg": "haveUsed职位存在在职员工无法停用"
},
{
"positionId": 123457,
"code": 200,
"msg": "操作成功"
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchUpdatePositionStatus
请求频率：5次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【变更职位状态接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 变更的职位列表/数组 |
| └positionId | 是 | Long | 职位ID |
| └haveUsed | 是 | Integer | 职位状态: 0-停用，1-启用 |
响应体：Response Body,JSON格式
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └resultList | Array | 新增职位的结果 | |
| └└positionId | Long | 职位ID | |
| └└code | Integer | 响应码 | |
| └└msg | String | 响应信息 |
职务信息数据接口
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/getDutyPageList??entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{"pageSize":100,"pageNum":1,"dutyName":"职务名称"}'
操作成功，返回数据示例
{
"code": 0,
"msg": "成功",
"data": {
"pageNum": 1,
"pageSize": 200,
"total": 3,
"list": [
{
"id": 22,
"dutyName": "Moka开发",
"namePinyin": "mokakaifa",
"nameInitials": "msk",
"isKeyPosition": 2,
"positionDesc": null,
"group": null,
"groupName": null,
"positionClass": null,
"positionClassName": null,
"subclass": null,
"subclassName": null,
"effectDate": null,
"status": 1,
"others": [
{
"attrId": 984380,
"moduleId": 4,
"modelId": 153,
"modelTitle": "职务信息",
"biz": "duty",
"fieldName": "DF_94ccbd0ebdc74adeb9f3fb0474b76433",
"enabled": false,
"type": 2,
"sortNo": 33,
"ref": "",
"uniqueness": 0,
"attrValues": null,
"label": "自定义字段",
"options": "",
"alphabet": "shengxiaoriqi",
"value": "测试自定义字段"
}
]
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/getDutyPageList
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【职务信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| idList | 否 | Array<Long> | 职务ID列表/数组 |
| dutyName | 否 | String | 职务名称 |
| status | 否 | int | 状态 枚举值 2:停用1:启用 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体：Response Body,JSON格式
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | Long | 职务ID | |
| dutyName | String | 职务名称 | |
| namePinyin | String | 职务名称名字全拼 | |
| nameInitials | String | 职务名称名字首字母 | |
| isKeyPosition | Long | 是否是关键职务 | 可选值：1:是2:否 |
| positionDesc | String | 工作职责 | |
| group | Long | 职位族id | |
| groupName | String | 职位族名称 | |
| positionClass | Long | 职位类id | |
| positionClassName | String | 职位类名称 | |
| subclass | Long | 职位子类id | |
| subclassName | String | 职位类子名称 | |
| effectDate | String | 生效日期，格式 yyyy-MM-dd | |
| status | int | 状态 | 枚举值2:停用1:启用 |
| others | Array |
自定义字段信息 |
新增职务接口
接口说明：通过此接口，可以向Moka People新增职务数据，支持一次性添加多个职务，按照data数组内顺序添加，成功的落库并记录职务ID至返回记录中，失败的记录到返回记录中，部门支持部门编码或者部门ID识别，Id有值时按Id查询，否则使用编码
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchAddDuty?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{"data": [
{
"dutyName": "API新增的职务12444",
"isKeyPosition": false,
"groupId": "414",
"extendFields": [
{
"fieldName": "DF_3590a81a94c348b38b1dcaf673e74d56",
"value": "9991928"
}
]
},{
"dutyName": "API新增的职务12124",
"isKeyPosition": false,
"groupId": "414",
"extendFields": [
{
"fieldName": "DF_3590a81a94c348b38b1dcaf673e74d56",
"value": "9991928"
}
]
}
]}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": {
"resultList": [
{
"dutyId": null,
"dutyName": "API新增的职务12444",
"code": 400,
"msg": "操作失败"
},
{
"dutyId": 99999,
"dutyName": "API新增的职务12124",
"code": 200,
"msg": "操作成功"
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchAddDuty
请求频率：5次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【新增职务接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 新增的职务列表/数组 |
| └dutyName | 是 | String | 职务名称 |
| └isKeyPosition | 是 | Boolean | 是否关键职位 |
| └positionDesc | 否 | String | 职务说明 |
| └groupId | 是 | Long | 职位族ID |
| └positionClassId | 否 | Long | 职位类ID |
| └subClassId | 否 | Long | 职位子类ID |
| └extendFields | 否 | Array | 其他自定义字段 |
| └└fieldName | 是 | String | 字段唯一name |
| └└value | 是 | String | 字段值 |
响应体：Response Body,JSON格式
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └resultList | Array | 新增职务的结果 | |
| └└dutyId | Long | 职务ID | |
| └└dutyName | String | 职务名称 | |
| └└code | Integer | 响应码 | |
| └└msg | String | 响应信息 |
变更职务接口
接口说明：通过此接口，可以向Moka People更新职务数据，支持一次性更改多个职务，职务ID为必填项，不支持更新已停用职务
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchUpdateDuty?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{"data": [
{
"dutyId": 123456,
"dutyName": "API新增的职务12444",
"isKeyPosition": false,
"groupId": "414",
"extendFields": [
{
"fieldName": "DF_3590a81a94c348b38b1dcaf673e74d56",
"value": "9991928"
}
]
},{
"dutyId": 123457,
"dutyName": "API新增的职务12124",
"isKeyPosition": false,
"groupId": "414",
"extendFields": [
{
"fieldName": "DF_3590a81a94c348b38b1dcaf673e74d56",
"value": "9991928"
}
]
}
]}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": {
"resultList": [
{
"dutyId": 123456,
"dutyName": "API新增的职务12444",
"code": 400,
"msg": "dutyId不存在"
},
{
"dutyId": 123457,
"dutyName": "API新增的职务12124",
"code": 200,
"msg": "操作成功"
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchUpdateDuty
请求频率：5次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【变更职务接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 变更的职位列表/数组 |
| └dutyId | 是 | Long | 职务ID |
| └dutyName | 是 | String | 职务名称 |
| └isKeyPosition | 是 | Boolean | 是否关键职位 |
| └positionDesc | 否 | String | 职务说明 |
| └groupId | 是 | Long | 职位族ID |
| └positionClassId | 否 | Long | 职位类ID |
| └subClassId | 否 | Long | 职位子类ID |
| └extendFields | 否 | Array | 其他自定义字段 |
| └└fieldName | 是 | String | 字段唯一name |
| └└value | 是 | String | 字段值 |
响应体：Response Body,JSON格式
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └resultList | Array | 新增职务的结果 | |
| └└dutyId | Long | 职务ID | |
| └└dutyName | String | 职务名称 | |
| └└code | Integer | 响应码 | |
| └└msg | String | 响应信息 |
变更职务状态接口
接口说明：通过此接口，可以向Moka People更新职务状态，支持一次性更改多个职务，职务ID为必填项
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchUpdateDutyStatus?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{"data": [
{
"dutyId": 123456,
"haveUsed": 1
},
{
"dutyId": 123457,
"haveUsed": 0
}
]}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": {
"resultList": [
{
"dutyId": 123456,
"code": 400,
"msg": "haveUsed职务存在在职员工无法停用"
},
{
"dutyId": 123457,
"code": 200,
"msg": "操作成功"
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/batchUpdateDutyStatus
请求频率：5次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【变更职务状态接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 变更的职位列表/数组 |
| └dutyId | 是 | Long | 职位ID |
| └haveUsed | 是 | Integer | 职位状态: 0-停用，1-启用 |
响应体：Response Body,JSON格式
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └resultList | Array | 新增职位的结果 | |
| └└dutyId | Long | 职务ID | |
| └└code | Integer | 响应码 | |
| └└msg | String | 响应信息 |
获取职级信息接口
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/getRankInfoList?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/org/getRankInfoList
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【获取职级信息接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| rankIdList | 否 | Array<Long> | 职级ID列表/数组 |
| rankNameList | 否 | Array<String> | 职级名称列表 |
| enabled | 否 | int | 是否启用0:停用<br>1:`启用 |
| pageSize | 是 | int | 分页大小，不超过200 |
| nextCursor | 是 | int | 页码 |
响应体：Response Body,JSON格式
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | Long | 职级ID | |
| rankName | String | 职级名称 | |
| grade | String | 类别名称 | |
| enabled | String | 是否启用 | 0:停用<br/>1:`启用 |
| remark | Long | 备注 | |
| rankOrder | String | 顺序 | |
| rankSequenceType | Long | 序列 | 10:专业职级 20:管理职 |
| rankCategoryInfo | String | 职级类别 |
RankCategoryDto
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| categoryId | Long | 类别ID | |
| categoryName | String | 类别名称 |
人事接口API
apiCode对应不同的数据类型，返回不同的数据
- 如果apiCode是 员工类型，那么返回该userName的角色数据权限下的所有员工数据，除了"待入职"的员工
- 如果apiCode是 职责类型，那么返回该租户下的所有职责信息
- 如果apiCode是 兼岗类型，那么返回该租户下的所有兼岗信息
- 如果apiCode是 合同类型，那么返回该租户下的所有合同信息
[读]获取系统对象和字段信息接口
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/personnel/v1/get_all_obj_fields?userName=您的邮箱地址&entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{
"objIdList":[9350],
"objNameList":["bank_card"],
"isHaveUsed": 1
}'
操作成功，返回数据示例
{
"code": 200,
"msg": "",
"data": [
{
"id": 9350,
"name": "银行卡",
"type": 2,
"isHaveUsed": 1,
"fieldList": [
{
"id": 63703,
"name": "bank_card",
"displayName": "工资卡",
"type": 40,
"haveUsed": 1,
"subField": true,
"subFieldList": [
{
"id": 63703,
"name": "bank_card",
"displayName": "银行卡号",
"type": 3,
"haveUsed": 1,
"subField": false,
"subFieldList": []
},
{
"id": 63703,
"name": "bank_card_type",
"displayName": "银行卡类型",
"type": 5,
"haveUsed": 1,
"subField": false,
"subFieldList": []
},
{
"id": 63703,
"name": "bank_card_bank",
"displayName": "开户行",
"type": 5,
"haveUsed": 1,
"subField": false,
"subFieldList": []
},
{
"id": 63703,
"name": "DF_b451d58bd51049cbaadea877e5fb6727",
"displayName": "hqz-银行-日期",
"type": 2,
"haveUsed": 1,
"subField": false,
"subFieldList": []
},
{
"id": 63703,
"name": "DF_4575b5f5cc094bfabc24e57ffb178cf8",
"displayName": "hqz-银行-数字",
"type": 3,
"haveUsed": 1,
"subField": false,
"subFieldList": []
},
{
"id": 63703,
"name": "DF_9c2a4804dfb840b2bac4b922b7ec9d4c",
"displayName": "hqz-银行-是非",
"type": 4,
"haveUsed": 1,
"subField": false,
"subFieldList": []
},
{
"id": 63703,
"name": "DF_e347b061154048399216f6a573124873",
"displayName": "hqz-银行-附件",
"type": 8,
"haveUsed": 1,
"subField": false,
"subFieldList": []
}
]
}
]
}
]
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/personnel/v1/get_all_obj_fields
请求频率：3次/秒/企业, 5次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| userName | 是 | String | 租户公司下的某个员工的邮箱； 注意: 推荐使用 超级管理员 权限 |
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工任职信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
objIdList和objNameList都不传就是返回全部
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| objIdList | 否 | Array<Long> | 数据最外层的id,即模型id |
| objNameList | 否 | Array<String> | 模型内字段名称 |
| isHaveUsed | 否 | int | 查询启用/停用数据(不传默认启用:1),查询停用传递0即可 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 |
返回结果data.list.fieldList说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.list.fieldList.id | Long | 字段id | attrId.可用于获取枚举时候传递 |
| data.list.fieldList.name | String | 字段英文名称 | 对应传递参数的objNameList中参数 |
| data.list.fieldList.displayName | String | 字段中文名称 | |
| data.list.fieldList.type | int | 字段类型 | 详细说明见https://people.mokahr.com/docs/api/view/v1.html#api-4 |
| data.list.fieldList.haveUsed | int | 启/停用 | 0:停用 1:启用 |
| data.list.fieldList.subField | boolean | 是否是组合字段 | true代表还有下级字段.false则表示无 |
| data.list.fieldList.subFieldList | Array | 下级字段 | subField为true的时候这个不为空 |
返回结果data.list.fieldList.subFieldList说明
同上
| |
[读]获取系统枚举类型字段的枚举值
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/personnel/v1/get_enum_values?userName=您的邮箱地址&entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{
"objList":[
{
"id":8232,
"attrId":58526,
"fieldName":"employee_type"
}
],
"isHaveUsed":1
}'
操作成功，返回数据示例
{
"code":200,
"msg":"",
"data":[
{
"id":8232,
"name":"任职信息",
"enumFieldList":[
{
"id":58526,
"name":"employee_type",
"displayName":"员工类型",
"subField":false,
"haveUsed":1,
"valueList":[
{
"id":63405,
"name":"实习生",
"haveUsed":1
},
{
"id":63406,
"name":"劳务派遣",
"haveUsed":1
},
{
"id":63407,
"name":"兼职",
"haveUsed":1
},
{
"id":63404,
"name":"正式",
"haveUsed":1
},
{
"id":254354,
"name":"自定义字段",
"haveUsed":1
}
]
}
]
}
]
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/personnel/v1/get_enum_values
请求频率：3次/秒/企业, 5次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| userName | 是 | String | 租户公司下的某个员工的邮箱； 注意: 推荐使用 超级管理员 权限 |
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工任职信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
如果objList为空.那么就返回所有的枚举.如果传入了id.那么就返回这个模型下的全部枚举.如果在加入attrId(字段id)或fieldName(字段英文名称)就只会返回对应精确的枚举值. id attrId fieldName的获取可以通过objList传递空获取
objList说明
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| objList.id | 否 | Long | 即模型id,可通过传递空的objList获取 |
| objList.attrId | 否 | Long | 字段id |
| objList.fieldName | 否 | String | 字段英文名称 |
| isHaveUsed | 否 | int | 0:停用 1:启用.默认只返回启用数据 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.list.id | Long | 模型id | objId对应传递参数中的id |
| data.list.name | String | 模型中文名称 | |
| data.list.enumFieldList | Array | 枚举详细数据数组 |
返回结果data.list.enumFieldList说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.list.enumFieldList.id | Long | 枚举(字段)id | 对应传递参数中的attrId |
| data.list.enumFieldList.name | String | 枚举(字段)英文名称 | 对应传递参数中的fieldName |
| data.list.enumFieldList.displayName | String | 枚举(字段)中文名称 | |
| data.list.enumFieldList.subField | boolean | 是否是组合字段 | |
| data.list.enumFieldList.haveUsed | int | 是否停用 | 0:停用 1:启用. |
| data.list.enumFieldList.valueList | Array | 枚举值详细数据数组 |
返回结果data.list.enumFieldList.valueList说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.list.enumFieldList.valueList.id | Long | 枚举值id | |
| data.list.enumFieldList.valueList.name | String | 枚举值中文名称 | |
| data.list.enumFieldList.valueList.haveUsed | int | 是否停用 | 0:停用 1:启用. |
员工任职数据接口
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/batch/data?userName=您的邮箱地址&entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{
"uuidList":[],
"pageSize": 200,
"pageNum": 1
}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": {
"labelList": null,
"pageSize": 1,
"pageNum": 1,
"total": 3,
"size": 1,
"list": [
{
"highest_degree_id": 1,
"country": "中国",
"mentor": "William001",
"job_create_time": "2022-04-20T15:40:44.000+0800",
"contact_phone": "8888",
"manage_duty_level_id": 10030,
"months_of_probation_id": 7,
"highest_education": "研究生",
"employee_no": "ae000344",
"highest_degree": "博士",
"leave_detail_reason": "",
"uuid": 148257,
"baseInfo_create_time": "2022-04-20T15:40:44.000+0800",
"path": "零零四/IM同步测试测试测试",
"office_address_id": 67,
"id_no": "235234534543534",
"duty_id": 201,
"realname_pinyin": "banbeiyuese",
"period_end_date": "2011-09-29",
"office_email": "1792442177@qq.com",
"household_address": "北京市北京市东城区xxx",
"employee_status": "在职",
"contact_address_county_code": "130304",
"profession": "软件工程",
"create_time": "2022-04-20T15:40:44.000+0800 (即将下线!!!)",
"create_time_tsp": 1666070560000,
"months_of_probation": "6个月",
"leave_info_leave_event_reason": "",
"address_county_code": "110101",
"telephone": "19968712234",
"contact_address_city_code": "130300",
"contact_address_province_code": "130000",
"native_place": "北京市北京",
"employee_type": "正式",
"nationality": "汉族",
"household_county_code": "110101",
"marital_status_id": 3,
"leave_handle_remark": "",
"employee_type_id": 1,
"report_leader": "William001",
"begin_work_time": "2021-10-07",
"adjust_begin_work_time": "2021-10-07",
"address_province_code": "110000",
"country_id": 1,
"employee_status_id": 1,
"end_probation_date": "2022-11-01",
"baseInfo_update_time": "2022-10-18T13:22:40.000+0800",
"birthday": "2016-10-21",
"household_province_code": "110000",
"gender": "女",
"political_status_id": 1,
"is_probation": "是",
"nationality_id": 1,
"social_relation_id": 1,
"id_no_id_type": "护照",
"social_relation": "父母",
"household_city_code": "110000",
"realname_initials": "bbys",
"manage_duty_level": "G-P1",
"update_time": "2022-04-20T15:40:44.000+0800 (即将下线!!!)",
"update_time_tsp": 1666070560000,
"political_status": "中共党员",
"duty_level": "P1",
"employeeAvatar": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/imgs/uploaded/headimgs/1e313121fd5957ccf3116c05982048b1.jpeg",
"id_type": 2,
"department": "IM同步测试测试测试",
"contact_address": "河北省秦皇岛市北戴河区8888",
"address_city_code": "110000",
"on_boarding_date": "2011-03-30",
"contact_name": "67676",
"address": "北京市北京市东城区xxx小区",
"is_handicap": "是",
"department_id": "30774",
"job_update_time": "2022-10-12T00:00:39.000+0800",
"highest_education_id": 2,
"gender_id": 2,
"household_type": "本地农业",
"leave_event_type": "",
"realname": "摩小卡",
"report_leader_id": 63238,
"graduate_school": "清华大学",
"mentor_id": 63238,
"marital_status": "离异",
"duty_level_id": 126,
"office_address": "保定",
"duty": "java",
"household_type_id": 1,
"bank_card":"34567890098765678",
"bank_card_bank_card_bank":"工商银行",
"bank_card_bank_card_type":"储蓄卡",
"bank_card_type":1,
"bank_card_bank":1,
"attachment_leaving_certificate": [
{
"id": 20048,
"name": "编制模板 - 2022-10-10T111901.205.xlsx",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/0e7915fd4435fa989a87bbf328add0c2.xlsx?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
},
{
"id": 20052,
"name": "3.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/88f80d80e6b075c022d81001e5e7e38b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
}
],
"personal_email": "me4idbjiv@test.qyzhg.com",
"id_card_back": [
{
"id": 20049,
"name": "1.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/88f80d80e6b075c022d81001e5e7e38b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
},
{
"id": 20055,
"name": "2.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/88f80d80e6b075c022d81001e5e7e38b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
}
],
"attachment_id": [
{
"id": 20042,
"name": "企业微信截图_16653152249863.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/8394eb785862918a5e76120656d7095d.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
},
{
"id": 20051,
"name": "1.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/88f80d80e6b075c022d81001e5e7e38b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
}
],
"attachment_profile": [
{
"id": 20043,
"name": "企业微信截图.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/e8ea79caa4c154ef42770ca532d63c2b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
},
{
"id": 20053,
"name": "4.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/88f80d80e6b075c022d81001e5e7e38b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
}
]
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/batch/data
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| userName | 是 | String | 租户公司下的某个员工的邮箱； 注意: 推荐使用 超级管理员 权限 |
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工任职信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| uuidList | 否 | Array<Long> | 员工ID列表/数组,长度不超过2000 |
| employeeNoList | 否 | Array<String> | 员工工号列表/数组，数组长度不超过2000 |
| officeEmailList | 否 | Array<String> | 员工公司邮箱列表/数组，数组长度不超过2000 |
| telephoneList | 否 | Array<String> | 员工手机号列表/数组，数组长度不超过2000 |
| startDate | 否 | String | 员工信息更新时间范围，格式yyyy-MM-dd HH:mm:ss |
| endDate | 否 | String | 员工信息更新时间范围，格式yyyy-MM-dd HH:mm:ss |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 | |
| data.size | int | 返回结果的业务数据条数 | |
| data.total | Long | 总条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| realName | String | 员工姓名 | |
| uuid | Long | 员工在People系统的唯一id | |
| employee_no | String | 员工工号 | 由HR在People中设置的 |
| realname_pinyin | String | 员工姓名全拼 | |
| realname_initials | String | 员工姓名全拼首字母 | |
| department | String | 员工所在的部门名称 | |
| └department_id | Long | 部门在People系统的唯一id | 此id与部门接口返回的node_uid一致 |
| report_leader | String | 直接上级 | |
| └report_leader_id | Long | 直接上级在People系统的唯一id | 此id与员工接口返回的uuid一致 |
| office_address | String | 工作地点 | |
| └office_address_id | Long | 工作地点在People系统的唯一id | 示例：1256 |
| employee_type | String | 员工类型 | 4种系统预置字段 "正式" "实习生" "劳务派遣" "兼职" |
| └employee_type_id | Long | 员工类型在People系统的唯一id | 枚举值：1：正式2：实习生3：劳务派遣4：兼岗 |
| employee_status | String | 员工状态 | 4种状态："在职" "离职" "试用" "待入职" |
| └employee_status_id | Long | 员工类型在People系统的唯一id | 1:在职 2:离职3:试用4:待入职 |
| duty | String | 职务 | 职务名称 |
| └duty_id | Long | 职务在People系统的唯一id | 此id与职务接口返回的id一致 |
| position | String | 职位 | 职位名称 |
| └position_id | Long | 职位在People系统的唯一id | 此id与职位接口返回的id一致 |
| duty_level | String | 职级 | 职级名称 |
| └duty_level_id | Long | 职级在People系统的唯一id | 此id与职级接口返回的id一致 |
| manage_duty_level | String | 管理职级 | |
| └manage_duty_level_id | Long | 管理职级id | |
| id_no | String | 证件号码 | |
| └id_no_id_type | String | 证件类型 | 与证件号码id_no是关联字段，两者同时出现 示例：身份证、护照、港澳来往内地通行证、台湾来往内地通行证、外国人永久居留证 |
| └id_type | String | 证件类型的枚举类 | 1：表示身份证2：表示护照3：港澳来往内地通行证4`：表示台湾来往内地通行证<br>5`：表示外国人永久居留证 |
| nickname | String | 花名 | |
| gender | String | 性别 | "女" or "男" |
| └gender_id | String | 性别id | 0：女1：男" |
| birthday | String | 出生日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| begin_work_time | String | 首次参加工作时间 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| adjust_begin_work_time | String | 调整后工龄起算日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| period_end_date | String | 试用截止日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| on_boarding_date | String | 入职日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| end_probation_date | String | 转正日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| leave_date | String | 离职日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| leave_event_type | String | 离职类型 | 主动离职、被动离职 |
| leave_detail_reason | String | 离职原因 | |
| leave_handle_remark | String | 离职办理备注 | |
| company_start_date | String | 司龄起算日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| employeeAvatar | String | 员工头像 | hr在花名册上传的员工头像（注意：不是用户上传的头像） |
| months_of_probation | String | 试用期月数 | |
| └months_of_probation_id | int | 试用期的id编号 | |
| personal_email | String | 个人邮箱 | |
| telephone | String | 个人电话的号码 | 在labelList里"type": 7，表示手机号类型 |
| └telephone_country_code | String | 个人电话的区号 | 如："+86" |
| office_email | String | 公司邮箱 | |
| address | String | 居住地址 | |
| contact_address | String | 联系人地址 | 例如：河北省秦皇岛市北戴河区8888 |
| └contact_address_province_code | String | 联系人地址省编码 | |
| └contact_address_city_code | String | 联系人地址市编码 | |
| └contact_address_county_code | String | 联系人地址区编码 | |
| native_place | String | 籍贯 | |
| └native_place_id | Long | 籍贯id | |
| nationality | String | 民族 | |
| └nationality_id | int | 民族id | |
| marital_status | String | 婚姻状况 | |
| └marital_status_id | int | 婚姻状况id | 1：表示已婚2：表示未婚3：表示离异4：表示丧偶 |
| country | String | 国籍 | |
| └country_id | int | 国籍id | 1：表示中国 |
| political_status | String | 政治面貌 | 例如：中共党员 |
| └political_status_id | int | 政治面貌id | 枚举值：1：中共党员2：中共预备党员3：共青团员4：民革党员5：民盟盟员6：民建会员7：民进会员8：农工党党员，9：致公党党员10：九三学社社员11：台盟盟员12：无党派人士13：群众 |
| highest_degree | String | 最高学位 | 在labelList里"type": 5，表示单选 |
| └highest_degree_id | int | 最高学位的id标识 | 可选值：1：表示博士2：表示研究生3：表示学士4：表示无学位 |
| household_address | String | 户籍地址 | |
| household_type | String | 户籍类型 | 在labelList里"type": 5，表示单选 |
| └household_type_id | String | 户籍类型的id标识 | 可选值：1：表示本地农业2：表示外地农业3：表示本地城镇4：表示外地城镇 |
| profession | String | 所学专业 | |
| highest_education | String | 最高学历 | |
| └highest_education_id | int | 最高学历的id标识 | 可选值：1：表示博士2：表示研究生3：表示本科4：表示大专5：中专6：表示高中7：表示初中8：表示小学9：表示无 |
| graduate_school | String | 毕业院校 | |
| contact_name | String | 联系人姓名 | |
| contact_phone | String | 联系人电话的号码 | |
| social_relation | String | 与员工关系 | 例如：父母 |
| └social_relation_id | int | 与员工关系id | 1：父母2：配偶3：子女4：朋友 |
| attachment_id | Array | 身份证人像面附件 | |
| └id | Long | 附件唯一标识 | |
| └name | String | 文件名称 | |
| └url | String | 文件地址 | 24小时过期 |
| attachment_bank_card | Array | 银行卡附件 | |
| └id | Long | 附件唯一标识 | |
| └name | String | 文件名称 | |
| └url | String | 文件地址 | 24小时过期 |
| attachment_leaving_certificate | Array | 前公司离职证明附件 | |
| └id | Long | 附件唯一标识 | |
| └name | String | 文件名称 | |
| └url | String | 文件地址 | 24小时过期 |
| attachment_profile | Array | 简历附件 | |
| └id | Long | 附件唯一标识 | |
| └name | String | 文件名称 | |
| └url | String | 文件地址 | 24小时过期 |
| id_card_back | Array | 身份证国徽面附件 | |
| └id | Long | 附件唯一标识 | |
| └name | String | 文件名称 | |
| └url | String | 文件地址 | 24小时过期 |
员工任职数据接口(权限)
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/batch/data?userName=您的邮箱地址&entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{
"uuidList":[],
"pageSize": 200,
"pageNum": 1
}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": {
"labelList": null,
"pageSize": 1,
"pageNum": 1,
"total": 3,
"size": 1,
"list": [
{
"highest_degree_id": 1,
"country": "中国",
"mentor": "William001",
"job_create_time": "2022-04-20T15:40:44.000+0800",
"contact_phone": "8888",
"manage_duty_level_id": 10030,
"months_of_probation_id": 7,
"highest_education": "研究生",
"employee_no": "ae000344",
"highest_degree": "博士",
"leave_detail_reason": "",
"uuid": 148257,
"baseInfo_create_time": "2022-04-20T15:40:44.000+0800",
"path": "零零四/IM同步测试测试测试",
"office_address_id": 67,
"id_no": "235234534543534",
"duty_id": 201,
"realname_pinyin": "banbeiyuese",
"period_end_date": "2011-09-29",
"office_email": "1792442177@qq.com",
"household_address": "北京市北京市东城区xxx",
"employee_status": "在职",
"contact_address_county_code": "130304",
"profession": "软件工程",
"create_time": "2022-04-20T15:40:44.000+0800 (即将下线!!!)",
"create_time_tsp": 1666070560000,
"months_of_probation": "6个月",
"leave_info_leave_event_reason": "",
"address_county_code": "110101",
"telephone": "19968712234",
"contact_address_city_code": "130300",
"contact_address_province_code": "130000",
"native_place": "北京市北京",
"employee_type": "正式",
"nationality": "汉族",
"household_county_code": "110101",
"marital_status_id": 3,
"leave_handle_remark": "",
"employee_type_id": 1,
"report_leader": "William001",
"begin_work_time": "2021-10-07",
"adjust_begin_work_time": "2021-10-07",
"address_province_code": "110000",
"country_id": 1,
"employee_status_id": 1,
"end_probation_date": "2022-11-01",
"baseInfo_update_time": "2022-10-18T13:22:40.000+0800",
"birthday": "2016-10-21",
"household_province_code": "110000",
"gender": "女",
"political_status_id": 1,
"is_probation": "是",
"nationality_id": 1,
"social_relation_id": 1,
"id_no_id_type": "护照",
"social_relation": "父母",
"household_city_code": "110000",
"realname_initials": "bbys",
"manage_duty_level": "G-P1",
"update_time": "2022-04-20T15:40:44.000+0800 (即将下线!!!)",
"update_time_tsp": 1666070560000,
"political_status": "中共党员",
"duty_level": "P1",
"employeeAvatar": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/imgs/uploaded/headimgs/1e313121fd5957ccf3116c05982048b1.jpeg",
"id_type": 2,
"department": "IM同步测试测试测试",
"contact_address": "河北省秦皇岛市北戴河区8888",
"address_city_code": "110000",
"on_boarding_date": "2011-03-30",
"contact_name": "67676",
"address": "北京市北京市东城区xxx小区",
"is_handicap": "是",
"department_id": "30774",
"job_update_time": "2022-10-12T00:00:39.000+0800",
"highest_education_id": 2,
"gender_id": 2,
"household_type": "本地农业",
"leave_event_type": "",
"realname": "摩小卡",
"report_leader_id": 63238,
"graduate_school": "清华大学",
"mentor_id": 63238,
"marital_status": "离异",
"duty_level_id": 126,
"office_address": "保定",
"duty": "java",
"household_type_id": 1,
"bank_card":"34567890098765678",
"bank_card_bank_card_bank":"工商银行",
"bank_card_bank_card_type":"储蓄卡",
"bank_card_type":1,
"bank_card_bank":1,
"attachment_leaving_certificate": [
{
"id": 20048,
"name": "编制模板 - 2022-10-10T111901.205.xlsx",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/0e7915fd4435fa989a87bbf328add0c2.xlsx?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
},
{
"id": 20052,
"name": "3.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/88f80d80e6b075c022d81001e5e7e38b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
}
],
"personal_email": "me4idbjiv@test.qyzhg.com",
"id_card_back": [
{
"id": 20049,
"name": "1.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/88f80d80e6b075c022d81001e5e7e38b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
},
{
"id": 20055,
"name": "2.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/88f80d80e6b075c022d81001e5e7e38b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
}
],
"attachment_id": [
{
"id": 20042,
"name": "企业微信截图_16653152249863.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/8394eb785862918a5e76120656d7095d.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
},
{
"id": 20051,
"name": "1.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/88f80d80e6b075c022d81001e5e7e38b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
}
],
"attachment_profile": [
{
"id": 20043,
"name": "企业微信截图.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/e8ea79caa4c154ef42770ca532d63c2b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
},
{
"id": 20053,
"name": "4.png",
"url": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/form/attachment/88f80d80e6b075c022d81001e5e7e38b.png?Expires=1666160105&OSSAccessKeyId=xxx&Signature=yyy"
}
]
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/batch/data
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| userName | 是 | String | 您所属租户下的某个员工的邮箱，注意： 1. 该员工必须拥有此apiCode应用中授权的角色。 2. 该员工账号权限中此角色的管理范围，决定了返回数据的范围，管理员可以在People的"设置"-"账号权限"-"账号管理"中配置返回的数据范围。 3. 推荐使用 超级管理员 权限。 4. 员工离职时账号权限会被收回 |
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工任职信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| uuidList | 否 | Array<Long> | 员工ID列表/数组,长度不超过2000 |
| employeeNoList | 否 | Array<String> | 员工工号列表/数组，数组长度不超过2000 |
| officeEmailList | 否 | Array<String> | 员工公司邮箱列表/数组，数组长度不超过2000 |
| telephoneList | 否 | Array<String> | 员工手机号列表/数组，数组长度不超过2000 |
| startDate | 否 | String | 员工信息更新时间范围，格式yyyy-MM-dd HH:mm:ss |
| endDate | 否 | String | 员工信息更新时间范围，格式yyyy-MM-dd HH:mm:ss |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 | |
| data.size | int | 返回结果的业务数据条数 | |
| data.total | Long | 总条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| realName | String | 员工姓名 | |
| uuid | Long | 员工在People系统的唯一id | |
| employee_no | String | 员工工号 | 由HR在People中设置的 |
| realname_pinyin | String | 员工姓名全拼 | |
| realname_initials | String | 员工姓名全拼首字母 | |
| department | String | 员工所在的部门名称 | |
| └department_id | Long | 部门在People系统的唯一id | 此id与部门接口返回的node_uid一致 |
| report_leader | String | 直接上级 | |
| └report_leader_id | Long | 直接上级在People系统的唯一id | 此id与员工接口返回的uuid一致 |
| office_address | String | 工作地点 | |
| └office_address_id | Long | 工作地点在People系统的唯一id | 示例：1256 |
| employee_type | String | 员工类型 | 4种系统预置字段 "正式" "实习生" "劳务派遣" "兼职" |
| └employee_type_id | Long | 员工类型在People系统的唯一id | 枚举值：1：正式2：实习生3：劳务派遣4：兼岗 |
| employee_status | String | 员工状态 | 4种状态："在职" "离职" "试用" "待入职" |
| └employee_status_id | Long | 员工类型在People系统的唯一id | 1:在职 2:离职3:试用4:待入职 |
| duty | String | 职务 | 职务名称 |
| └duty_id | Long | 职务在People系统的唯一id | 此id与职务接口返回的id一致 |
| position | String | 职位 | 职位名称 |
| └position_id | Long | 职位在People系统的唯一id | 此id与职位接口返回的id一致 |
| duty_level | String | 职级 | 职级名称 |
| └duty_level_id | Long | 职级在People系统的唯一id | 此id与职级接口返回的id一致 |
| manage_duty_level | String | 管理职级 | |
| └manage_duty_level_id | Long | 管理职级id | |
| id_no | String | 证件号码 | |
| └id_no_id_type | String | 证件类型 | 与证件号码id_no是关联字段，两者同时出现 示例：身份证、护照、港澳来往内地通行证、台湾来往内地通行证、外国人永久居留证 |
| └id_type | String | 证件类型的枚举类 | 1：表示身份证2：表示护照3：港澳来往内地通行证4`：表示台湾来往内地通行证<br>5`：表示外国人永久居留证 |
| nickname | String | 花名 | |
| gender | String | 性别 | "女" or "男" |
| └gender_id | String | 性别id | 0：女1：男" |
| birthday | String | 出生日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| begin_work_time | String | 首次参加工作时间 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| adjust_begin_work_time | String | 调整后工龄起算日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| period_end_date | String | 试用截止日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| on_boarding_date | String | 入职日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| end_probation_date | String | 转正日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| leave_date | String | 离职日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| leave_event_type | String | 离职类型 | 主动离职、被动离职 |
| leave_detail_reason | String | 离职原因 | |
| leave_handle_remark | String | 离职办理备注 | |
| company_start_date | String | 司龄起算日期 | 该字段有1种时间形式： 1."yyyy-MM-dd" |
| employeeAvatar | String | 员工头像 | hr在花名册上传的员工头像（注意：不是用户上传的头像） |
| months_of_probation | String | 试用期月数 | |
| └months_of_probation_id | int | 试用期的id编号 | |
| personal_email | String | 个人邮箱 | |
| telephone | String | 个人电话的号码 | 在labelList里"type": 7，表示手机号类型 |
| └telephone_country_code | String | 个人电话的区号 | 如："+86" |
| office_email | String | 公司邮箱 | |
| address | String | 居住地址 | |
| contact_address | String | 联系人地址 | 例如：河北省秦皇岛市北戴河区8888 |
| └contact_address_province_code | String | 联系人地址省编码 | |
| └contact_address_city_code | String | 联系人地址市编码 | |
| └contact_address_county_code | String | 联系人地址区编码 | |
| native_place | String | 籍贯 | |
| └native_place_id | Long | 籍贯id | |
| nationality | String | 民族 | |
| └nationality_id | int | 民族id | |
| marital_status | String | 婚姻状况 | |
| └marital_status_id | int | 婚姻状况id | 1：表示已婚2：表示未婚3：表示离异4：表示丧偶 |
| country | String | 国籍 | |
| └country_id | int | 国籍id | 1：表示中国 |
| political_status | String | 政治面貌 | 例如：中共党员 |
| └political_status_id | int | 政治面貌id | 枚举值：1：中共党员2：中共预备党员3：共青团员4：民革党员5：民盟盟员6：民建会员7：民进会员8：农工党党员，9：致公党党员10：九三学社社员11：台盟盟员12：无党派人士13：群众 |
| highest_degree | String | 最高学位 | 在labelList里"type": 5，表示单选 |
| └highest_degree_id | int | 最高学位的id标识 | 可选值：1：表示博士2：表示研究生3：表示学士4：表示无学位 |
| household_address | String | 户籍地址 | |
| household_type | String | 户籍类型 | 在labelList里"type": 5，表示单选 |
| └household_type_id | String | 户籍类型的id标识 | 可选值：1：表示本地农业2：表示外地农业3：表示本地城镇4：表示外地城镇 |
| profession | String | 所学专业 | |
| highest_education | String | 最高学历 | |
| └highest_education_id | int | 最高学历的id标识 | 可选值：1：表示博士2：表示研究生3：表示本科4：表示大专5：中专6：表示高中7：表示初中8：表示小学9：表示无 |
| graduate_school | String | 毕业院校 | |
| contact_name | String | 联系人姓名 | |
| contact_phone | String | 联系人电话的号码 | |
| social_relation | String | 与员工关系 | 例如：父母 |
| └social_relation_id | int | 与员工关系id | 1：父母2：配偶3：子女4：朋友 |
| attachment_id | Array | 身份证人像面附件 | |
| └id | Long | 附件唯一标识 | |
| └name | String | 文件名称 | |
| └url | String | 文件地址 | 24小时过期 |
| attachment_bank_card | Array | 银行卡附件 | |
| └id | Long | 附件唯一标识 | |
| └name | String | 文件名称 | |
| └url | String | 文件地址 | 24小时过期 |
| attachment_leaving_certificate | Array | 前公司离职证明附件 | |
| └id | Long | 附件唯一标识 | |
| └name | String | 文件名称 | |
| └url | String | 文件地址 | 24小时过期 |
| attachment_profile | Array | 简历附件 | |
| └id | Long | 附件唯一标识 | |
| └name | String | 文件名称 | |
| └url | String | 文件地址 | 24小时过期 |
| id_card_back | Array | 身份证国徽面附件 | |
| └id | Long | 附件唯一标识 | |
| └name | String | 文件名称 | |
| └url | String | 文件地址 | 24小时过期 |
员工合同数据接口
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/contract/getContractPageList?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '
{
"pageSize": 100,
"pageNum": 1,
"employeeIdList": [
1,
2
],
"employeeNoList": [
"TEST001",
"TEST002"
],
"contractNoList": [
"TEST001",
"TEST002"
]
}'
操作成功，返回数据示例
{
"code": 0,
"msg": "成功",
"data": {
"pageNum": 1,
"pageSize": 200,
"total": 15,
"list": [
{
"employeeId": 109314,
"batchQueryContractResList": [
{
"id": 46204,
"employeeId": 109314,
"corporation": {
"id": 959,
"name": "启茹集团",
"code": "0002"
},
"contractType": {
"id": 1,
"name": "劳动合同1"
},
"signTimes": {
"id": 3,
"name": "第3次"
},
"contractNo": "HT6366363111",
"contractStartDate": "2023-04-17",
"realityEndDate": null,
"estimateEndDate": "2023-07-16",
"signDate": null,
"contractLimit": {
"id": 3,
"name": "3个月"
},
"employeeNo": "000014",
"contractStatus": {
"id": 1,
"name": "未生效"
},
"jobInfoId": null,
"others": {
"DF_448c058382bf413d8572a7d1ce60e92e": "",
"DF_3d265a91d2814a3aae586d232736a008": ""
}
}
]
},
{
"employeeId": 75711248,
"batchQueryContractResList": [
{
"id": 147832,
"employeeId": 75711248,
"corporation": {
"id": 1543,
"name": "启动集团1",
"code": "0001"
},
"contractType": {
"id": 1,
"name": "劳动合同1"
},
"signTimes": {
"id": 1,
"name": "首次签约"
},
"contractNo": "2342345",
"contractStartDate": "2022-08-01",
"realityEndDate": null,
"estimateEndDate": "2022-08-31",
"signDate": null,
"contractLimit": {
"id": 1,
"name": "1个月"
},
"employeeNo": "c138079",
"contractStatus": {
"id": 2,
"name": "生效中"
},
"jobInfoId": null,
"others": {
"DF_448c058382bf413d8572a7d1ce60e92e": "",
"DF_3d265a91d2814a3aae586d232736a008": ""
}
}
]
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/contract/getContractPageList
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| userName | 是 | String | 租户公司下的某个员工的邮箱； 注意: 推荐使用 超级管理员权限 |
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工合同信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组 | |
| employeeNoList | 否 | Array<String> | 员工工号列表/数组 | |
| contractIdList | 否 | Array<Long> | 合同ID列表/数组 | |
| contractNoList | 否 | Array<String> | 合同编号列表/数组 | |
| contractStatus | 否 | int | 合同状态0:审批中1:未生效2:生效中3:已终止4:作废 默认查询状态1、2、3 |
|
| contractStartDateStart | 否 | String | 合同开始日期（开始） | 格式：(yyyy-MM-dd) 与contractStartDateEnd是一对 |
| contractStartDateEnd | 否 | String | 合同开始日期（结束） | 格式：(yyyy-MM-dd) |
| estimateEndDateStart | 否 | String | 预计终止日期（开始） | 格式：(yyyy-MM-dd) 与estimateEndDateEnd是一对 |
| estimateEndDateEnd | 否 | String | 预计终止日期（结束） | 格式：(yyyy-MM-dd) |
| realityEndDate | 否 | String | 实际终止日期 | 格式：(yyyy-MM-dd) |
| corporationIdList | 否 | Array<String> | 法人公司ID列表/数组 | |
| pageSize | 是 | int | 分页大小，不超过200 | |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| employeeId | Long | 合同签约员工的ID | |
| contractList | Array | 员工下的合同信息 | |
| └id | Long | People中合同的唯一标识ID | |
| └employeeId | String | 合同签约的员工的ID | |
| └corporation | Object | 法人公司 | |
| └id | Long | 法人公司所对应的id | |
| └name | String | 法人公司的name | |
| └code | String | 法人公司编码 | |
| └contractType | Object | 合同类型 | 1:劳动合同2:实习协议3:派遣协议4:兼职协议5:返聘协议6:培训协议7:保密协议 |
| └id | Long | 合同类型所对应的id | |
| └name | Long | 合同类型的name | |
| └signTimes | Object | 签订次数 | 枚举值：1:首次签约2:第2次3:第3次4:第4次 |
| └id | Long | 签订次数所对应的id | |
| └name | Long | 签订次数的name | |
| └contractNo | String | 合同编号 | |
| └contractStartDate | String | 合同开始日期 | yyyy-MM-dd格式 |
| └realityEndDate | String | 实际终止日期 | yyyy-MM-dd格式 |
| └estimateEndDate | String | 预计终止日期 | yyyy-MM-dd格式 |
| └signDate | String | 签订日期 | yyyy-MM-dd格式 |
| └contractLimit | Object | 合同期限 | 1:1个月2:2个月3:3个月4:6个月5:1年6:2年7:3年8:5年9:无固定期限 |
| └id | Long | 合同期限所对应的id | |
| └name | Long | 合同期限的name | |
| └employeeNo | String | 员工工号 | |
| └contractStatus | Object | 合同状态 | 合同状态0:审批中1:未生效2:生效中3:已终止4:作废 默认查询状态1、2、3 |
| └id | Long | 合同状态所对应的id | |
| └name | Long | 合同状态的name | |
| └jobInfoId | Long | 员工任职信息表中ID | |
| └others | Object | 自定义字段字段信息 | key为自定义字段的fieldName，value是自定义字段的value |
新增员工合同数据接口
接口说明：通过该接口可新增员工合同数据
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/contract/batchAddContract?entCode=933c37e1cc94d06f2d043d8170456e9f&apiCode=16f0f046748c7f3364f285748fdd7e31&userName=12123×tamp=121414&nonce=141412&sign=1214214' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data '{
"data": [
{
"employeeId": "75784279",
"corporationId": "238045",
"contractTypeId": "8",
"signTimesId": "1",
"contractNo": "",
"contractStartDate": "2024-09-22",
"realityEndDate": null,
"estimateEndDate": "2024-12-30",
"signDate": "2024-09-22",
"contractLimitId": "1",
"contractStatusId": "1",
"signType": "2",
"others": [
{
"field_name": "contact_attachment",
"field_value": [
{
"name": "2436种玉环在职履历表_2024-08-15 16时58分34秒.pdf",
"url": "http://xxx"
}
]
},
{
"field_name": "DF_a3ad2cc332994d47991e5ded2bd7b921",
"field_value": "收到放松放松1111"
},
{
"field_name": "DF_1b7bc0186b6b452794176e3ea6bf1100",
"field_value": [
{
"code": "120000",
"name": "天津市"
},
{
"code": "120000",
"name": "天津市"
},
{
"code": "120101",
"name": "和平区"
},
"收到放松放松1111 zheshi xinde"
]
},
{
"field_name": "DF_9e095ce26dcb4fc5957a4a7a99b4151c",
"field_value": [
{
"country_code": "+1",
"value": "42342424"
}
]
},
{
"field_name": "DF_2d059cf7ac2a49719e90a1bcab44aaf5",
"field_value": [
"山东发斯蒂芬\n水电费水电费\n水电费"
]
},
{
"field_name": "DF_7ae54b025c1d46afaf76a0f697397b08",
"field_value": "11121"
},
{
"field_name": "DF_5f61727c511a41e3a0f25311eafaf158",
"field_value": "2024-09-052222"
},
{
"field_name": "DF_c29d081fc9f0428f927b17666d71b6ee",
"field_value": {
"id": 1
}
},
{
"field_name": "DF_f031c6d89f98419bae788596952a415d",
"field_value": {
"id": 1
}
},
{
"field_name": "DF_89dae8185af94558a5fb225a510543d5",
"field_value": [
{
"name": "2436种玉环在职履历表_2024-08-19 16时51分47秒.pdf",
"url": "http://xxx"
}
]
}
]
}
]
}'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": {
"successList": [
{
"index": 0,
"contractId": 39223
},
{
"index": 2,
"contractId": 39224
}
],
"failedList": [
{
"index": 1,
"msg": "员工类型不存在"
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/contract/batchAddContract
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【新增员工合同数据接口】 |
| userName | 是 | String | 用户邮箱 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 合同信息列表，数组长度不超过200 |
| └employeeNo | 否 | String | 员工工号（工号和id保留其一即可） |
| └employeeId | 否 | String | 员工id（工号和id保留其一即可） |
| └corporationId | 是 | String | 法人公司id |
| └contractTypeId | 是 | String | 合同类型id |
| └signTimesId | 是 | String | 签订次数id |
| └contractNo | 否 | String | 合同编号 |
| └contractStartDate | 是 | String | 合同开始日期，格式为 yyyy-MM-dd，时区为 GMT+8 |
| └realityEndDate | 否 | String | 实际终止日期，格式为 yyyy-MM-dd，时区为 GMT+8 |
| └estimateEndDate | 否 | String | 预计终止日期，格式为 yyyy-MM-dd，时区为 GMT+8 |
| └signDate | 否 | String | 签订日期，格式为 yyyy-MM-dd，时区为 GMT+8 |
| └contractLimitId | 否 | String | 合同期限id |
| └contractStatusId | 是 | String | 合同状态id |
| └signType | 是 | String | 签订类型 |
| └others | 否 | Array | 非标准字段信息列表 |
| └└field_name | 否 | String | 自定义字段名 |
| └└field_value | 否 | Object | 自定义字段值 |
响应体 Response Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | Integer | 响应状态码，200 表示成功 |
| msg | 是 | String | 操作结果消息 |
| data | 是 | Object | 数据对象 |
| └successList | 否 | Array | 成功操作的列表 |
| └└index | 是 | Integer | 操作的索引值 |
| └└contractId | 是 | Long | 成功操作对应的合同ID |
| └failedList | 否 | Array | 失败操作的列表 |
| └└index | 是 | Integer | 失败操作的索引值 |
| └└msg | 是 | String | 失败原因说明 |
更新员工合同数据接口
接口说明：通过该接口可更新员工合同数据
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/contract/batchUpdateContract?entCode=933c37e1cc94d06f2d043d8170456e9f&apiCode=58d97100bba3bfb080c7b41655c85b4b&userName=12123×tamp=121414&nonce=141412&sign=1214214' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data '{
"data": [
{
"employeeId": "75785019",
"contractId": "154168",
"corporationId": "238045",
"contractTypeId": "8",
"signTimesId": "1",
"contractNo": "",
"contractStartDate": "2024-01-22",
"realityEndDate": null,
"estimateEndDate": "2024-12-30",
"signDate": "2024-01-22",
"contractLimitId": "1",
"contractStatusId": "1",
"signType": "1",
"others": [
{
"field_name": "contact_attachment",
"field_value": [
{
"name": "2436种玉环在职履历表_2024-08-15 16时58分34秒.pdf",
"url": "http://xxx"
}
]
},
{
"field_name": "DF_a3ad2cc332994d47991e5ded2bd7b921",
"field_value": "收到放松放松小龙虾3"
},
{
"field_name": "DF_1b7bc0186b6b452794176e3ea6bf1100",
"field_value": [
{
"code": "120000",
"name": "天津市"
},
{
"code": "120000",
"name": "天津市"
},
{
"code": "120101",
"name": "和平区"
},
"收到放松放松1111小龙虾3 update"
]
},
{
"field_name": "DF_9e095ce26dcb4fc5957a4a7a99b4151c",
"field_value": [
{
"country_code": "+1",
"value": "42342424"
}
]
},
{
"field_name": "DF_2d059cf7ac2a49719e90a1bcab44aaf5",
"field_value": [
"山东发斯蒂芬\n水电费水电费\n水电费小龙虾3 update"
]
},
{
"field_name": "DF_7ae54b025c1d46afaf76a0f697397b08",
"field_value": "11121"
},
{
"field_name": "DF_5f61727c511a41e3a0f25311eafaf158",
"field_value": "2024-09-05"
},
{
"field_name": "DF_c29d081fc9f0428f927b17666d71b6ee",
"field_value": {
"id": 1
}
},
{
"field_name": "DF_f031c6d89f98419bae788596952a415d",
"field_value": {
"id": 1
}
},
{
"field_name": "DF_89dae8185af94558a5fb225a510543d5",
"field_value": [
{
"name": "2436种玉环在职履历表_2024-08-19 16时51分47秒.pdf",
"url": "http://xxx"
}
]
}
]
}
]
}'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": {
"successList": [
{
"index": 0,
"contractId": 39223
},
{
"index": 2,
"contractId": 39224
}
],
"failedList": [
{
"index": 1,
"msg": "合同类型不存在"
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/contract/batchUpdateContract
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【更新员工合同数据接口】 |
| userName | 是 | String | 用户邮箱 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 合同信息列表，数组长度不超过200 |
| └employeeNo | 否 | String | 员工工号（工号和id保留其一即可） |
| └employeeId | 否 | String | 员工id（工号和id保留其一即可） |
| └contractId | 是 | String | 合同id |
| └corporationId | 是 | String | 法人公司id |
| └contractTypeId | 是 | String | 合同类型id |
| └signTimesId | 是 | String | 签订次数id |
| └contractNo | 否 | String | 合同编号 |
| └contractStartDate | 是 | String | 合同开始日期，格式为 yyyy-MM-dd，时区为 GMT+8 |
| └realityEndDate | 否 | String | 实际终止日期，格式为 yyyy-MM-dd，时区为 GMT+8 |
| └estimateEndDate | 否 | String | 预计终止日期，格式为 yyyy-MM-dd，时区为 GMT+8 |
| └signDate | 否 | String | 签订日期，格式为 yyyy-MM-dd，时区为 GMT+8 |
| └contractLimitId | 否 | String | 合同期限id |
| └contractStatusId | 是 | String | 合同状态id |
| └signType | 是 | String | 签订类型 |
| └others | 否 | Array | 非标准字段信息列表 |
| └└field_name | 否 | String | 自定义字段名 |
| └└field_value | 否 | Object | 自定义字段值 |
响应体 Response Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | Integer | 响应状态码，200 表示成功 |
| msg | 是 | String | 操作结果消息 |
| data | 是 | Object | 数据对象 |
| └successList | 否 | Array | 成功操作的列表 |
| └└index | 是 | Integer | 操作的索引值 |
| └└contractId | 是 | Long | 成功操作对应的合同ID |
| └failedList | 否 | Array | 失败操作的列表 |
| └└index | 是 | Integer | 失败操作的索引值 |
| └└msg | 是 | String | 失败原因说明 |
删除员工合同数据接口
接口说明：通过该接口可删除员工合同数据
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/contract/batchDeleteContract?entCode=933c37e1cc94d06f2d043d8170456e9f&apiCode=58d97100bba3bfb080c7b41655c85b4b&userName=12123×tamp=121414&nonce=141412&sign=1214214' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data '{
"data": [
{
"employeeId": "75785019",
"contractId": "154168"
}
]
}'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": {
"successList": [
{
"index": 0,
"contractId": 39223
},
{
"index": 2,
"contractId": 39224
}
],
"failedList": [
{
"index": 1,
"msg": "合同不存在"
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/contract/batchDeleteContract
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【删除员工合同数据接口】 |
| userName | 是 | String | 用户邮箱 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 合同信息列表，数组长度不超过200 |
| └employeeNo | 否 | String | 员工工号（工号和id保留其一即可） |
| └employeeId | 否 | String | 员工id（工号和id保留其一即可） |
| └contractId | 是 | String | 合同id |
响应体 Response Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | Integer | 响应状态码，200 表示成功 |
| msg | 是 | String | 操作结果消息 |
| data | 是 | Object | 数据对象 |
| └successList | 否 | Array | 成功操作的列表 |
| └└index | 是 | Integer | 操作的索引值 |
| └└contractId | 是 | Long | 成功操作对应的合同ID |
| └failedList | 否 | Array | 失败操作的列表 |
| └└index | 是 | Integer | 失败操作的索引值 |
| └└msg | 是 | String | 失败原因说明 |
员工异动数据接口
操作成功，返回数据示例
{
"code": 200,
"msg": "success",
"data": [
{
"path": "Moka实施团队/编外/HJ测试 L1/HJ测试 L2",
"effect_date": "2022-05-06",
"update_time": "2022-05-06T10:56:08.000+0800",
"event_type": "数据调整",
"department_id": "208198",
"event_reason": "部门调整",
"job_change_id": 1110763,
"id": 233137,
"department": {
"id": "208198",
"value": "编外/HJ测试 L1/HJ测试 L2"
},
"employee_type": {
"id": 1,
"value": "正式"
},
"duty_level": {
"id": 254,
"value": "P5"
},
"duty": {
"id": 610,
"value": "开发"
},
"report_leader": {
"id": 103352,
"value": "员工1"
},
"DF_7e2be2fe496d467eb4a5fe1638cc822c": {
"id": 2,
"value": "是"
}
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/batch/data
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| userName | 是 | String | 租户公司下的某个员工的邮箱； 注意: 推荐使用 超级管理员权限 |
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工异动信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| uuidList | 否 | Array<Long> | 员工ID列表/数组，长度不超过200 |
| startDate | 否 | String | 员工信息更新时间范围，格式yyyy-MM-dd startDate、endDate和ydStartDate和ydEndDate必须有一组不为空 且时间范围<=180天 |
| endDate | 否 | String | 员工信息更新时间范围，格式yyyy-MM-dd startDate、endDate和ydStartDate和ydEndDate必须有一组不为空 |
| ydStartDate | 否 | String | 员工异动信息生效开始时间，格式yyyy-MM-dd startDate、endDate和ydStartDate和ydEndDate必须有一组不为空 且时间范围<=180天 |
| ydEndDate | 否 | String | 员工异动信息生效结束时间，格式yyyy-MM-dd startDate、endDate和ydStartDate和ydEndDate必须有一组不为空 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Array | 返回结果的数据内容 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| path | String | 部门全路径 | |
| effect_date | String | 生效时间 | |
| update_time | String | 更新时间 | |
| event_type | String | 事件类型 | |
| department_id | String | 部门ID | |
| event_reason | String | 事件原因 | |
| id | Long | 员工ID 注：RequestBody 中 uuid |
|
| job_change_id | Long | 异动唯一主键ID | |
| department | Object | 部门 | |
| └id | String | ID | |
| └value | String | 部门名称 | |
| duty | Object | 职务 | |
| └id | String | 职务ID | |
| └value | String | 职务名称 | |
| duty_level | Object | 职级 | |
| └id | String | 职级ID | |
| └value | String | 职级名称 | |
| report_leader | Object | 直接上级 | |
| └id | String | 直接上级员工ID | |
| └value | String | 直接上级姓名 | |
| employee_type | Object | 员工类型 | |
| └id | String | 员工类型ID | |
| └value | String | 员工类型名称 |
新增员工异动数据接口
接口说明：通过该接口可新增员工异动数据
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/batchAddJobChange?entCode=933c37e1cc94d06f2d043d8170456e9f&apiCode=16f0f046748c7f3364f285748fdd7e31&userName=12123×tamp=121414&nonce=141412&sign=1214214' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data '{
"data": [
{
"employee_uid": 75784573,
"event_type": "调动",
"effect_date": 1728141976000,
"employee_type_id":1,
"department": {
"department_no": "NO.210679"
},
"duty_id":3047
}
]
}'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": [
{
"job_change_id": 1219312,
"employee_uid": 75784573,
"success": true,
"errorMessage": null
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/batchAddJobChange
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【新增异动记录接口】 |
| userName | 是 | String | 用户邮箱 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 异动信息列表，数组长度不超过200 |
| └employee_uid | 是 | Long | 员工Id |
| └effect_date | 是 | String | 异动生效日期 |
| └event_type | 是 | String | 事件类型 |
| └event_reason_id | 否 | Long | 事件原因 |
| └department | 否 | json | 部门 |
| └report_leader | 否 | json | 直接上级 |
| └dashed_report_leader | 否 | json | 虚线主管 |
| └mentor | 否 | json | 导师 |
| └position_id | 否 | Long | 职位Id |
| └duty_id | 否 | Long | 职务id |
| └duty_level_id | 否 | Long | 职级id |
| └manage_duty_level_id | 否 | Long | 管理职级id |
| └employee_type_id | 否 | Long | 员工类型id |
| └months_of_probation_id | 否 | Long | 试用期月数 |
| └office_address_id | 否 | Long | 工作地点Id |
| └leave_detail_reason | 否 | String | 离职详细原因 |
| └leave_handle_remark | 否 | String | 离职办理备注 |
| └leave_event_type | 否 | String | 离职事件类型 |
| └leave_event_reason_id | 否 | Long | 离职事件原因 |
| └extend_fields | 否 | json | 所有的自定义字段都在该字段中传入，字段类型同上面的预置字段类型的格式 |
响应体 Response Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | Integer | 响应状态码，200 表示成功 |
| msg | 是 | String | 操作结果消息 |
| data | 是 | Array | 数据对象 |
| └ job_change_id | 否 | Long | 异动Id |
| └ success | 否 | Boolean | true：操作成功；false：操作失败 |
| └ errorMessage | 否 | String | 失败原因 |
更新员工异动数据接口
接口说明：通过该接口可更新员工异动数据
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/batchUpdateJobChange?entCode=933c37e1cc94d06f2d043d8170456e9f&apiCode=58d97100bba3bfb080c7b41655c85b4b&userName=12123×tamp=121414&nonce=141412&sign=1214214' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data '{
"data": [
{
"job_change_id":1218916,
"employee_uid": 75784573,
"event_type": "调动",
"effect_date": 1728141976000,
"employee_type_id":1,
"department": {
"department_no": "NO.210679"
},
"duty_id":3047
}
]
}'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": [
{
"job_change_id": 1219312,
"employee_uid": 75784573,
"success": true,
"errorMessage": null
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/batchUpdateJobChange
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【更新异动记录接口】 |
| userName | 是 | String | 用户邮箱 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 异动信息列表，数组长度不超过200 |
| └job_change_id | 是 | Long | 异动Id |
| └employee_uid | 是 | Long | 员工Id |
| └effect_date | 是 | String | 异动生效日期 |
| └event_type | 是 | String | 事件类型 |
| └event_reason_id | 否 | Long | 事件原因 |
| └department | 否 | json | 部门 |
| └report_leader | 否 | json | 直接上级 |
| └dashed_report_leader | 否 | json | 虚线主管 |
| └mentor | 否 | json | 导师 |
| └position_id | 否 | Long | 职位Id |
| └duty_id | 否 | Long | 职务id |
| └duty_level_id | 否 | Long | 职级id |
| └manage_duty_level_id | 否 | Long | 管理职级id |
| └employee_type_id | 否 | Long | 员工类型id |
| └months_of_probation_id | 否 | Long | 试用期月数 |
| └office_address_id | 否 | Long | 工作地点Id |
| └leave_detail_reason | 否 | String | 离职详细原因 |
| └leave_handle_remark | 否 | String | 离职办理备注 |
| └leave_event_type | 否 | String | 离职事件类型 |
| └leave_event_reason_id | 否 | Long | 离职事件原因 |
| └extend_fields | 否 | json | 所有的自定义字段都在该字段中传入，字段类型同上面的预置字段类型的格式 |
响应体 Response Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | Integer | 响应状态码，200 表示成功 |
| msg | 是 | String | 操作结果消息 |
| data | 是 | Array | 数据对象 |
| └ job_change_id | 否 | Long | 异动Id |
| └ success | 否 | Boolean | true：操作成功；false：操作失败 |
| └ errorMessage | 否 | String | 失败原因 |
删除员工异动数据接口
接口说明：通过该接口可删除员工异动数据
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/batchDeleteJobChange?entCode=933c37e1cc94d06f2d043d8170456e9f&apiCode=58d97100bba3bfb080c7b41655c85b4b&userName=12123×tamp=121414&nonce=141412&sign=1214214' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data '{
"data": [
{
"job_change_id": 1218052
}
]
}'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": [
{
"job_change_id": 1218916,
"employee_uid": null,
"success": true,
"errorMessage": null
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/batchDeleteJobChange
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【删除异动记录接口】 |
| userName | 是 | String | 用户邮箱 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| data | 是 | Array | 异动信息列表，数组长度不超过200 |
| └job_change_id | 是 | String | 异动id |
响应体 Response Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | Integer | 响应状态码，200 表示成功 |
| msg | 是 | String | 操作结果消息 |
| data | 是 | Array | 数据对象 |
| └ job_change_id | 否 | Long | 异动Id |
| └ success | 否 | Boolean | true：操作成功；false：操作失败 |
| └ errorMessage | 否 | String | 失败原因 |
员工兼岗数据接口
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/batch_get_concurrentPost?entCode=aa0b52d6ecb16bb2ffc705e282480f88&apiCode=62f06e8e4bab9a20e790c3496169b18d×tamp=1&nonce=1&sign=1' \
--header 'Content-Type: application/json' \
--data-raw '{
"pageSize":30,
"nextCursor":2,
"employeeIdList":[28834,29486]
}'
操作成功，返回数据示例
{
"code": 0,
"msg": "成功",
"data": {
"hasMore": true,
"nextCursor": 3,
"list": [
{
"employeeId": 28834,
"employeeName": "摩小卡",
"employeeNo": "000001",
"concurrentMap": [
{
"concurrent_post-id": 17,
"concurrent_post-start_date": "2020-04-14",
"concurrent_post-post_status_id": 2,
"concurrent_post-department_id": "30764",
"concurrent_post-position": "运营",
"concurrent_post-DF_b0495ef3ce0c4020a8f1464ab3e7440c": "不",
"concurrent_post-office_address_id": 61,
"concurrent_post-report_leader": "",
"concurrent_post-duty_level": "M1-1",
"concurrent_post-remark": "",
"concurrent_post-reason": "",
"concurrent_post-position_id": 118,
"concurrent_post-DF_accba8531abb4567a480d914e5d92ff9": "本科",
"concurrent_post-post_status": "生效中",
"concurrent_post-department": "test/测试/变更生效日期大",
"concurrent_post-DF_accba8531abb4567a480d914e5d92ff9_id": 2,
"concurrent_post-office_address": "北京2(已停用)",
"concurrent_post-DF_b0495ef3ce0c4020a8f1464ab3e7440c_id": 2,
"concurrent_post-duty_level_id": 105,
"concurrent_post-duty": "Moka算法工程师",
"concurrent_post-duty_id": 40521,
"concurrent_post-end_date": ""
}
]
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/batch_get_concurrentPost
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工兼职信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组，长度不超过200 |
| pageSize | 是 | int | 分页大小，不超过200 |
| nextCursor | 是 | int | 下一页分页标识; 分页标记（如果hasMore为true，则下次查询时传此nextCursor） |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| └hasMore | boolean | 是否还有下一页; | 枚举值 true 或者false |
| └nextCursor | int | 下一页分页标识; 分页标记（如果hasMore为true，则下次查询时传此nextCursor） | 当 hasMore 为 true 时，会同时返回新的 nextCursor，否则不返回 nextCursor推荐使用唯一的业务排序因子，支持多维度排序因子拼接，保证最终结果唯一性，如时间戳。 |
| └list | list | ||
| └└employeeId | integer | 员工id | |
| └└employeeName | String | 员工姓名 | |
| └└employeeNo | String | 员工工号 | |
| └└concurrentMap | JsonArray | ||
| └└└concurrent_post-id | Int | 该条数据在系统中的唯一标识 | |
| └└└concurrent_post-start_date | String | 兼岗开始时间 | 示例："yyyy-MM-dd" |
| └└└concurrent_post-end_date | String | 兼岗结束时间 | 示例："yyyy-MM-dd" |
| └└└concurrent_post-position | String | 兼岗职位 | |
| └└└concurrent_post-position_id | int | 兼岗职位对应的系统id | |
| └└└concurrent_post-duty | String | 兼岗职务 | |
| └└└concurrent_post-duty_id | int | 兼岗职务对应的系统id | |
| └└└concurrent_post-report_leader | String | 兼岗主管 | |
| └└└concurrent_post-report_leader_id | int | 兼岗主管对应的系统id | |
| └└└concurrent_post-duty_level | String | 兼岗职级 | |
| └└└concurrent_post-duty_level_id | int | 兼岗职级对应的系统id | |
| └└└concurrent_post-department | String | 兼岗部门 | |
| └└└concurrent_post-department_id | int | 兼岗部门对应的系统id | |
| └└└concurrent_post-office_address | String | 兼岗工作地点 | |
| └└└concurrent_post-office_address_id | int | 兼岗工作地点对应的系统id | |
| └└└concurrent_post_remark | String | 备注 | |
| └└└concurrent_post_reason | String | 兼岗结束详细原因 | |
| └└└concurrent_post_post_status | String | 兼岗状态 1未开始 2生效中 3已结束 | |
| └└└concurrent_post_post_status_id | int | 兼岗状态对应的系统id |
员工成本中心数据接口
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_get_cost_center?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{
"employeeIdList": [106],
"costCenterIdList": [1,2],
"effectDate":"2022-09-01",
"pageSize": 100,
"nextCursor": 1
}'
操作成功，返回数据示例
{
"code": 0,
"msg": "成功",
"data": {
"hasMore": true,
"nextCursor": 2,
"list": [
{
"employeeId": 103294,
"employeeNo": "1121",
"realname": "摩小卡",
"officeEmail": "",
"employeeType": {
"id": 1,
"name": "正式"
},
"employeeStatus": {
"id": 1,
"name": "在职"
},
"telephone": {
"countryCode": "+86",
"value": "18233586376"
},
"costCenterList": [
{
"costCenterId": 598,
"costCenterCode": "",
"costCenterName": "Moka公司",
"haveUsed": 1,
"effectDate": "2022-09-24",
"effectStatus": 0
},
{
"costCenterId": 609,
"costCenterCode": "24353",
"costCenterName": "Moka部门",
"haveUsed": 1,
"effectDate": "2022-04-21",
"effectStatus": 0
}
]
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_get_cost_center
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【成本中心信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| costCenterIdList | 否 | Array<Long> | 成本中心ID列表/数组, 数组长度不超过200 | |
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组, 数组长度不超过200 | |
| effectDate | 否 | String | 生效时间 格式：yyyy-MM-dd（生效日期为空，请不要传""） | 生效日期如果不传则查出全部员工成本中心。如果传：则查询员工所属成本中心生效日期<=传入生效日期， 且距传入的生效日期最近的一条成本中心 |
| pageSize | 否 | int | 分页大小，如果不传默认200 | 最大200 |
| nextCursor | 否 | int | 分页标记，第一次查询时不传，后续使用上一次查询时返回nextCursor |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 | 以人为维度 |
| data.hasMore | boolean | 是否还有下一页 | |
| data.nextCursor | int | 下一页分页标识 | 分页标记（如果hasMore为true，则下次查询时传此nextCursor） |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| employeeId | Long | 员工ID | |
| employeeNo | String | 员工工号 | |
| realname | String | 员工工号 | |
| officeEmail | String | 公司邮箱 | |
| employeeType | Object | 员工类型 | 枚举值：1：正式2：实习生3：劳务派遣 4：兼岗 |
| └id | Long | 员工类型的主键id | |
| └name | String | 员工类型名称 | |
| employeeStatus | Object | 员工状态 | 枚举值1：在职 2：离职3：试用 4：待入职 |
| └id | Long | 员工状态的主键id | |
| └name | String | 员工状态名称 | |
| telephone | Object | 手机号 | |
| └countryCode | String | 手机号区号 | |
| └value | String | 手机号码 | |
| costCenterList | Array | 成本中心数组 | |
| └costCenterId | Long | 成本中心ID | |
| └costCenterCode | String | 成本中心编码 | |
| └costCenterName | String | 成本中心名称 | |
| └costAllocationRate | BigDecimal | 所属成本中心的分摊比例 | |
| └haveUsed | int | 是否使用 | 枚举值0:停用1:启用 |
| └effectDate | String | 生效日期 | 格式：yyyy-MM-dd |
| └effectStatus | int | 是否生效 | 仅在不传成本中心id和生效日期时返回1：生效中0：不生效 |
员工成本中心数据回写接口
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_get_cost_center?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Content-Type: application/json' \
--data '{
"empCostcenterList":[
{
"empID":75766183,
"costCenterID":71199,
"allocateRate":101,
"effectDate":"2023-09-27"
},
{
"empID":75766183,
"costCenterID":71199,
"allocateRate":101,
"effectDate":"2023-09-27"
}
]
}'
'
操作成功，返回数据示例
{
"code":200,
"msg":"success",
"data": {}
}
操作失败
{
"code":-1,
"msg":"fail",
"data": [
{
"errorMessage":"分摊比例之和需为100%",
"empID":75766183,
"costCenterID":71199,
"allocateRate":101,
"effectDate":"2023-09-27"
},
{
"errorMessage":"成本中心出现多次占比,请合并后再次提交",
"empID":75766183,
"costCenterID":71199,
"allocateRate":101,
"effectDate":"2023-09-27"
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_set_cost_center
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工所属成本中心回写接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| empCostcenterList | 是 | Array< | 员工所属成本中心列表/数组 , 数组长度不超过200 | |
| ---empID | 是 | Array<Long> | 员工ID列 | |
| ---costCenterID | 是 | Long | 成本中心Id | |
| ---allocateRate | 是 | int | 分摊比例 | |
| ---effectDate | 是 | String | 生效时间 格式：yyyy-MM-dd（生效日期不为空） |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 |
获取员工所属项目组数据
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_get_emp_project?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Content-Type: application/json' \
--data '{
"employeeIdList":
[
75766183,
75766184
],
"employeeNoList":
[
"000001",
"000002"
],
"projectIdList":
[
678,
679
],
"projectCodeList":
[
"code001",
"code001"
],
"startDate": "2024-01-01",
"endDate": "2024-04-01",
"pageNum": 1,
"pageSize": 30
}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": {
"pageNum": 1,
"pageSize": 30,
"total": 1,
"data": [
{
"employeeId": 75766183,
"employeeNo": "000024",
"realName": "测试",
"employeeType": {
"id": 1,
"name": "正式",
"sortNo": 1,
"isDelete": 1
},
"employeeStatus": {
"id": 1,
"name": "在职",
"sortNo": 1,
"isDelete": 0
},
"telephone": {
"countryCode": "+86",
"value": "1333333333"
},
"projectInfoList": [
{
"project": {
"projectId": 143,
"projectCode": "code0125",
"projectName": "20240125生效",
"projectFullPath": "20240125生效",
"effectDate": "2024-01-25",
"haveUsed": 1
},
"entryDate": {
"timestamp": 1706544000000,
"dateStr": "2024-01-30"
},
"leaveDate": null,
"status": {
"id": 2,
"name": "生效中",
"sortNo": 2,
"isDelete": 0
},
"customFields": {
"DF_17e90e7f42724b6885ed1e5aead74467": {
"timestamp": 1704902400000,
"dateStr": "2024-01-11"
},
"DF_a37e9a6ea12f4f65aea44d581419b971": "111"
},
"id": -1
},
{
"project": {
"projectId": 142,
"projectCode": "",
"projectName": "2024-01-25生效的项目组",
"projectFullPath": "2024-01-25生效的项目组",
"effectDate": "2024-01-24",
"haveUsed": 1
},
"entryDate": {
"timestamp": 1706198400000,
"dateStr": "2024-01-26"
},
"leaveDate": null,
"status": {
"id": 2,
"name": "生效中",
"sortNo": 2,
"isDelete": 0
},
"customFields": {
"DF_a37e9a6ea12f4f65aea44d581419b971": "123"
},
"id": -2
},
{
"project": {
"projectId": 206,
"projectCode": "",
"projectName": "222222",
"projectFullPath": "222222",
"effectDate": "2024-03-21",
"haveUsed": 1
},
"entryDate": {
"timestamp": 1710950400000,
"dateStr": "2024-03-21"
},
"leaveDate": {
"timestamp": 1711814400000,
"dateStr": "2024-03-31"
},
"status": {
"id": 3,
"name": "已结束",
"sortNo": 3,
"isDelete": 0
},
"customFields": {
"DF_文本自定义字段": "字符串自定义字段值",
"DF_是非单选自定义字段": {
"id": 1,
"name": "是"
},
"DF_日期自定义字段": {
"timestamp": 1706198400000,
"dateStr": "2024-01-26"
},
"DF_职责自定义字段": {
"id": 2222,
"realname": "姓名",
"employeeNo": "000779"
}
},
"id": -3
}
]
}
]
}
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_get_emp_project
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工所属项目组信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID，数组长度不超过200 | |
| employeeNoList | 否 | Array<String> | 员工工号，数组长度不超过200 | |
| projectIdList | 否 | Array<Long> | 项目组ID，数组长度不超过200 | |
| projectCodeList | 否 | Array<String> | 项目组编号，数组长度不超过200 | |
| startDate | 否 | Date | 进入项目组日期起始 格式：yyyy-MM-dd | |
| endDate | 否 | Date | 进入项目组日期截止 格式：yyyy-MM-dd | |
| pageNum | 是 | int | 页码 | |
| pageSize | 是 | int | 页面大小，最大不超过200 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.data | JsonArray | 返回结果的业务数据内容 | |
| data.pageSize | int | 分页大小 | |
| data.pageNum | int | 分页页码 | |
| data.size | int | 返回数据条数 | |
| data.total | Long | 总条数 |
返回结果data.data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| employeeId | Long | 员工ID | |
| employeeNo | String | 员工工号 | |
| realName | String | 员工姓名 | |
| employeeType | Object | 员工类型，结构可参考示例参数 | |
| employeeStatus | Object | 员工状态，结构可参考示例参数 | |
| projectInfoList | Array | 员工所属项目组，结构可参考示例参数 |
批量添加待入职员工
接口说明：通过该接口可批量添加待入职员工数据（注意：新增的数据通过系统校验才能写入成功，入参中不能有重复的个人电话、证件号码、个人邮箱）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/basic/ob/employee/batchCreate?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"data": [
{
"realName": "姓名",
"employeeNo": "工号"
"onBoardingPlan": 入职计划id,
"employeeTypeId": 员工类型id,
"dutyId": 1931,
"officeAddressId": 597,
"dutyLevelId": 10581,
"mangeDutyLevelId": 1559,
"periodEndDate": "2024-11-10T00:00:00",
"onBoardingDate": "2024-05-11T00:00:00",
"monthsOfProbationId": 1,
"telephoneCountryCode": "+区号",
"telephone": "电话号码",
"personalEmail": "xxx@qq.com",
"idNoIdType": 3,
"idNo": "证件号码",
"department": {
"departmentId": 部门id,
"departmentNo": "部门编码"
},
"reportLeader": {
"employeeId": 员工id,
"employeeNo": "员工工号"
},
"extendFields": [
{
"fieldName": "DF_地址字段",
"fieldValue": "东大街55号",
"fieldContactAddressProvinceCode": "110000",
"fieldContactAddressCityCode": "110000",
"fieldContactAddressCountyCode": "110101"
},
{
"fieldName": "DF_数字字段",
"fieldValue": "数字"
},
{
"fieldName": "DF_选项字段",
"fieldValue": "选项id"
},
{
"fieldName": "DF_文本字段",
"fieldValue": "文本"
},
{
"fieldName": "DF_附件字段",
"fieldValue": "{\"name\":\"文件名称\",\"url\":\"文件地址\"}"
},
{
"fieldName": "DF_附件字段",
"fieldValue": "[{\"name\":\"文件名称1\",\"url\":\"文件地址1\"},{\"name\":\"文件名称2\",\"url\":\"文件地址2\"}]"
},
{
"fieldName": "DF_人员字段",
"fieldValue": "人员id",
"fieldEmployeeNo": "人员工号"
}
]
}
]
}
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": {
"successList": [
{
"index": 0,
"onBoardingUid": 39223
}
],
"failedList": [
{
"index": 1,
"errorList": [
"错误提示"
]
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/basic/ob/employee/batchCreate
请求频率：1次/秒/企业, 20次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【批量新增待入职员工】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
文档上未标注的字段可通过extendFields进行传递
| 字段 | 必填 | 类型 | 备注 |
|---|---|---|---|
| data | 是 | Array | 需要批量创建的数据,数组长度不超过100 |
| └employeeNo | 否 | String | 工号 |
| └realName | 是 | String | 姓名 |
| └onBoardingPlan | 是 | Long | 入职计划id |
| └department | 是 | Object | 所属部门 |
| └└departmentId | 否 | Long | 部门id,与departmentNo参数二选一 |
| └└departmentNo | 否 | String | 部门编码 |
| └reportLeader | 否 | Object | 直接上级 |
| └└employeeId | 否 | Long | 员工id,与employeeNo参数二选一 |
| └└employeeNo | 否 | String | 员工编码 |
| └dutyLevelId | 否 | Long | 职级id |
| └mangeDutyLevelId | 否 | Long | 管理职级id |
| └employeeTypeId | 是 | Long | 员工类型id |
| └officeAddressId | 否 | Long | 工作地点id |
| └positionId | 否 | Long | 职位id,职位模式租户传值 |
| └dutyId | 否 | Long | 职务id,职务模式租户传值 |
| └onBoardingDate | 是 | Date | 入职时间 |
| └periodEndDate | 否 | Date | 试用期截止时间(不能早于入职时间) |
| └monthsOfProbationId | 否 | Long | 试用期月数id |
| └telephoneCountryCode | 是 | String | 个人电话区号 |
| └telephone | 是 | String | 个人电话 |
| └personalEmail | 是 | String | 个人邮箱 |
| └idNoIdType | 是 | Long | 证件类型id |
| └idNo | 是 | String | 证件号码 |
| └extendFields | 否 | Array | 其他自定义字段 |
| └└fieldName | 否 | String | 字段唯一name |
| └└fieldValue | 否 | String | 字段值(人员类型字段为员工ID，电话类型字段为电话号码，地址类型字段为详细地址，附件字段附件类型字段为json(包含name、url)) |
| └└fieldEmployeeNo | 否 | String | 人员类型的人员工号 |
| └└fieldTelephoneCountryCode | 否 | String | 电话类型的电话区号 |
| └└fieldContactAddressProvinceCode | 否 | String | 地址类型的省编码 |
| └└fieldContactAddressCityCode | 否 | String | 地址类型的市编码 |
| └└fieldContactAddressCountyCode | 否 | String | 地址类型的区编码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └successList | Array | 处理成功返回的集合 | |
| └└index | int | 元素的下标，对应入参的顺序 | |
| └└onBoardingUid | Long | 创建成功的待入职员工id | |
| └failedList | Array | 处理失败返回的集合 | |
| └└index | int | 元素的下标，对应入参的顺序 | |
| └└errorList | Array | 处理失败的异常提示 |
批量更新待入职员工
接口说明：通过该接口可批量更新待入职员工数据（注意：数据通过系统校验才能写入成功，入参中不能有重复的个人电话、证件号码、个人邮箱）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/basic/ob/employee/batchUpdate?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"data": [
{
"onBoardingUid": "需要更新的员工id",
"employeeNo": "需要更新的员工工号",
"realName": "哈哈",
"onBoardingPlan": 5234,
"employeeTypeId": 1,
"dutyId": 1931,
"officeAddressId": 597,
"dutyLevelId": 10581,
"mangeDutyLevelId": 1559,
"periodEndDate": "2024-11-10T00:00:00",
"onBoardingDate": "2024-05-11T00:00:00",
"monthsOfProbationId": 1,
"telephoneCountryCode": "+区号",
"telephone": "电话号码",
"personalEmail": "xxx@qq.com",
"idNoIdType": 3,
"idNo": "moka1239205",
"department": {
"departmentId": 119668,
"departmentNo": "部门编码"
},
"reportLeader": {
"employeeId": 75594383,
"employeeNo": "员工工号"
},
"extendFields": [
{
"fieldName": "DF_地址字段",
"fieldValue": "东大街55号",
"fieldContactAddressProvinceCode": "110000",
"fieldContactAddressCityCode": "110000",
"fieldContactAddressCountyCode": "110101"
},
{
"fieldName": "DF_数字字段",
"fieldValue": "数字"
},
{
"fieldName": "DF_选项字段",
"fieldValue": "选项id"
},
{
"fieldName": "DF_文本字段",
"fieldValue": "文本"
},
{
"fieldName": "DF_附件字段",
"fieldValue": "{\"name\":\"文件名称\",\"url\":\"文件地址\"}"
},
{
"fieldName": "DF_附件字段",
"fieldValue": "[{\"name\":\"文件名称1\",\"url\":\"文件地址1\"},{\"name\":\"文件名称2\",\"url\":\"文件地址2\"}]"
},
{
"fieldName": "DF_人员字段",
"fieldValue": "人员id",
"fieldEmployeeNo": "人员工号"
}
]
}
]
}
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": {
"successList": [
{
"index": 0,
"onBoardingUid": 39223
}
],
"failedList": [
{
"index": 1,
"errorList": [
"错误提示"
]
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/basic/ob/employee/batchUpdate
请求频率：1次/秒/企业, 20次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【批量更新待入职员工】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
文档上未标注的字段可通过extendFields进行传递
| 字段 | 必填 | 类型 | 备注 |
|---|---|---|---|
| data | 是 | Array | 需要批量更新的数据,数组长度不超过100 |
| └onBoardingUid | 否 | Long | 待入职员工id,与employeeNo二选一 |
| └employeeNo | 否 | String | 工号,onBoardingUid有值时更新工号 |
| └realName | 否 | String | 姓名 |
| └department | 否 | Object | 所属部门 |
| └└departmentId | 否 | Long | 部门id,与departmentNo参数二选一 |
| └└departmentNo | 否 | String | 部门编码 |
| └reportLeader | 否 | Object | 直接上级 |
| └└employeeId | 否 | Long | 员工id,与employeeNo参数二选一 |
| └└employeeNo | 否 | String | 员工编码 |
| └dutyLevelId | 否 | Long | 职级id |
| └mangeDutyLevelId | 否 | Long | 管理职级id |
| └employeeTypeId | 否 | Long | 员工类型id |
| └officeAddressId | 否 | Long | 工作地点id |
| └positionId | 否 | Long | 职位id,职位模式租户传值 |
| └dutyId | 否 | Long | 职务id,职务模式租户传值 |
| └onBoardingDate | 否 | Date | 入职时间 |
| └periodEndDate | 否 | Date | 试用期截止时间(不能早于入职时间) |
| └monthsOfProbationId | 否 | Long | 试用期月数id |
| └telephoneCountryCode | 否 | String | 个人电话区号 |
| └telephone | 否 | String | 个人电话 |
| └personalEmail | 否 | String | 个人邮箱 |
| └idNoIdType | 否 | Long | 证件类型id |
| └idNo | 否 | String | 证件号码 |
| └extendFields | 否 | Array | 其他自定义字段 |
| └└fieldName | 否 | String | 字段唯一name |
| └└fieldValue | 否 | String | 字段值(人员类型字段为员工ID，电话类型字段为电话号码，地址类型字段为详细地址，附件字段附件类型字段为json(包含name、url)) |
| └└fieldEmployeeNo | 否 | String | 人员类型的人员工号 |
| └└fieldTelephoneCountryCode | 否 | String | 电话类型的电话区号 |
| └└fieldContactAddressProvinceCode | 否 | String | 地址类型的省编码 |
| └└fieldContactAddressCityCode | 否 | String | 地址类型的市编码 |
| └└fieldContactAddressCountyCode | 否 | String | 地址类型的区编码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └successList | Array | 处理成功返回的集合 | |
| └└index | int | 元素的下标，对应入参的顺序 | |
| └└onBoardingUid | Long | 更新成功的待入职员工id | |
| └failedList | Array | 处理失败返回的集合 | |
| └└index | int | 元素的下标，对应入参的顺序 | |
| └└errorList | Array | 处理失败的异常提示 |
批量取消待入职员工
接口说明：通过该接口可批量取下待入职员工数据（注意：数据通过系统校验才能写入成功）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/basic/ob/employee/batchCancel?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"data": [
{
"onBoardingUid": 需要取消待入职的员工id,
"employeeNo": "需要取消待入职的员工工号",
"reason": "需要取消待入职"
}
]
}
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": {
"successList": [
{
"index": 0,
"onBoardingUid": 39223
}
],
"failedList": [
{
"index": 1,
"errorList": [
"错误提示"
]
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/basic/ob/employee/batchCancel
请求频率：1次/秒/企业, 20次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【批量取消待入职员工】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 备注 |
|---|---|---|---|
| data | 是 | Array | 需要批量取消的数据,数组长度不超过100 |
| └onBoardingUid | 否 | Long | 待入职员工id,与employeeNo二选一 |
| └employeeNo | 否 | String | 工号 |
| └reason | 是 | String | 取消原因，长度不超过200 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| └successList | Array | 处理成功返回的集合 | |
| └└index | int | 元素的下标，对应入参的顺序 | |
| └└onBoardingUid | Long | 处理成功的待入职员工id | |
| └failedList | Array | 处理失败返回的集合 | |
| └└index | int | 元素的下标，对应入参的顺序 | |
| └└errorList | Array | 处理失败的异常提示 |
写入待入职信息采集数据
接口说明：通过该接口可写入单个待入职员工的信息采集数据，已入职或者取消入职的员工无法写入，且新员工的信息采集需要包含写入的分组以及字段（注意：新增的数据通过系统校验才能写入成功）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/basic/ob/employee/collect/add?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"onBoardingUid": 待入职员工id,
"employeeNo": 待入职员工工号,
"dataList": [
{
"groupName": "实习经历",
"details": [
{
"fieldValues": [
{
"fieldName": "company_name",
"fieldValue": "实习公司1"
},
{
"fieldName": "department",
"fieldValue": "实习公司1的部门"
},
{
"fieldName": "position",
"fieldValue": "实习公司1的职位"
},
{
"fieldName": "report_leader",
"fieldValue": "实习公司1的上级"
},
{
"fieldName": "end_time",
"fieldValue": "2011-12-31"
}
]
},
{
"fieldValues": [
{
"fieldName": "company_name",
"fieldValue": "实习公司2"
},
{
"fieldName": "department",
"fieldValue": "实习公司2的部门"
},
{
"fieldName": "position",
"fieldValue": "实习公司2的职位"
},
{
"fieldName": "report_leader",
"fieldValue": "实习公司2的上级"
},
{
"fieldName": "start_time",
"fieldValue": "2012-09-01"
}
]
}
]
},
{
"groupName": "家庭成员",
"details": [
{
"fieldValues": [
{
"fieldName": "member_name",
"fieldValue": "成员1"
},
{
"fieldName": "member_relation",
"fieldValue": "选项的id(是非类型、单选类型的选项id)"
},
{
"fieldName": "member_telephone",
"fieldValue": "电话号码",
"fieldTelephoneCountryCode": "+86,电话区号"
},
{
"fieldName": "member_address",
"fieldValue": "xx地址",
"fieldContactAddressProvinceCode": "110000，省编码",
"fieldContactAddressCityCode": "110000，市编码",
"fieldContactAddressCountyCode": "110101，区编码"
}
]
}
]
},
{
"groupName": "工作经历",
"details": [
{
"fieldValues": [
{
"fieldName": "company_name",
"fieldValue": "工作公司1"
},
{
"fieldName": "department",
"fieldValue": "工作公司1的部门"
},
{
"fieldName": "position",
"fieldValue": "工作公司1的职位"
},
{
"fieldName": "report_leader",
"fieldValue": "工作公司1的上级"
},
{
"fieldName": "end_time",
"fieldValue": "2013-12-31"
},
{
"fieldName": "leave_reason",
"fieldValue": "离职原因"
},
{
"fieldName": "DF_99a592d517714f0cb83507ec2f573a4b",
"fieldValue": "{\"name\":\"附件字段.jpg\",\"url\":\"上传后的附件地址\"}"
},
{
"fieldName": "DF_be955809beab4c2dbff0e661b766bb4d",
"fieldValue": "电话号码",
"fieldTelephoneCountryCode": "+86"
},
{
"fieldName": "DF_006126fbdefb4fcc8013cbb30a4ee7a9",
"fieldValue": "xx地址",
"fieldContactAddressProvinceCode": "110000",
"fieldContactAddressCityCode": "110000",
"fieldContactAddressCountyCode": "110101"
},
{
"fieldName": "DF_44ac69fe1845465698667b767c31037f",
"fieldValue": "自定义字段根据字段类型传值"
},
{
"fieldName": "DF_610b0ece4d264c9c80cc53cb2914ff6a",
"fieldValue": "自定义字段根据字段类型传值"
},
{
"fieldName": "DF_9945629d75a944f19ac88a00e445b7ad",
"fieldValue": "自定义字段根据字段类型传值"
}
]
}
]
},
{
"groupName": "教育经历",
"details": [
{
"fieldValues": [
{
"fieldName": "study_school",
"fieldValue": "xx高中"
},
{
"fieldName": "study_profession",
"fieldValue": "理科"
},
{
"fieldName": "education",
"fieldValue": "6"
},
{
"fieldName": "start_time",
"fieldValue": "2008-09-01"
},
{
"fieldName": "end_time",
"fieldValue": "2011-07-01"
}
]
},
{
"fieldValues": [
{
"fieldName": "study_school",
"fieldValue": "xx大学"
},
{
"fieldName": "study_profession",
"fieldValue": "xx专业"
},
{
"fieldName": "education",
"fieldValue": "根据字段类型传值"
},
{
"fieldName": "degree",
"fieldValue": "根据字段类型传值"
},
{
"fieldName": "educational_method",
"fieldValue": "根据字段类型传值"
},
{
"fieldName": "start_time",
"fieldValue": "2011-09-01"
},
{
"fieldName": "end_time",
"fieldValue": "2015-07-01"
}
]
}
]
},
{
"groupName": "其他信息分组",
"details": [
{
"fieldValues": [
{
"fieldName": "DF_1dd3af6293944ceaa2acf607861fbd12",
"fieldValue": "自定义字段根据字段类型传值"
},
{
"fieldName": "DF_66437208088c4808a460e56d0cbb0af2",
"fieldValue": "自定义字段根据字段类型传值"
},
{
"fieldName": "DF_db6a5d433ab74745aa9654933e181428",
"fieldValue": "自定义字段根据字段类型传值"
},
{
"fieldName": "DF_8a0ce475c04b46b99a0748740bb87200",
"fieldValue": "自定义字段根据字段类型传值"
}
]
}
]
}
]
}
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": "待入职员工id"
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/basic/ob/employee/collect/add
请求频率：5次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【写入待入职员工信息采集数据】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 备注 |
|---|---|---|---|
| onBoardingUid | 否 | Long | 待入职员工id(与employeeNo不能同时为空) |
| employeeNo | 否 | String | 待入职员工工号(与onBoardingUid不能同时为空) |
| dataList | 是 | Array | 需要写入的分组数据集合 |
| └groupName | 是 | String | 分组名称(家庭、工作、实习、教育等) |
| └details | 是 | Array | 分组下详细数据 |
| └└fieldValues | 是 | Array | 数据字段值集合 |
| └└└field_name | 是 | String | 字段名称 |
| └└└field_value | 是 | String | 字段值,传空会过滤该字段,传值格式请参考示例参数 |
| └└└fieldTelephoneCountryCode | 否 | String | 电话类型字段时，电话区号 |
| └└└fieldContactAddressProvinceCode | 否 | String | 地址类型字段时，省编码 |
| └└└fieldContactAddressCityCode | 否 | String | 地址类型字段时，市编码 |
| └└└fieldContactAddressCountyCode | 否 | String | 地址类型字段时，区编码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Long | 传入的待入职员工id |
新增员工接口
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/addEmployees?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{
"data": [{
"employee_no": "GH202404231942",
"employeeAvatar": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/imgs/uploaded/headimgs/9fffaab4b7fbbe60a5fe0c138a720770.jpeg",
"nationality_id":2,
"realname": "20240423花名册添加员工06",
"begin_work_time": 1701328531000,
"company_start_date": 1635750931000,
"id_no": {
"id_type_value": 2,
"id_no": "HZ202404231942",
"id_type_id": 2,
"id_type_display": "护照"
},
"constellation_id": 9,
"birthday": 1618471652000,
"nickname": "奚仲",
"gender_id": 2,
"office_email": "202404231942@huan.com",
"personal_email": "202404231942@yuan.com",
"telephone": {
"country_code": "+7",
"value": "202404231942"
},
"address": {
"province": "120000",
"city": "120000",
"county": "120102",
"value": "锦江大酒店1"
},
"household_address": {
"province": "120000",
"city": "120000",
"county": "120102",
"value": "锦江大酒店1"
},
"office_phone": "202404231942",
"native_place": "吉林省吉林市",
"country_id": 3,
"political_status_id": 2,
"marital_status_id": 2,
"household_type_id": 2,
"highest_education_id": 1,
"highest_degree_id": 1,
"graduate_school": "清华大学",
"profession": "计算机科学与技术",
"contact_name": "李晓光",
"contact_address": {
"province": "120000",
"city": "120000",
"county": "120102",
"value": "锦江大酒店1"
},
"social_relation_id": 1,
"contact_phone": {
"country_code": "+1",
"value": "202404231942"
},
"work_station":"这是我的工位",
"bank_card": {
"bank_card": "202404231942202404231942",
"bank_card_type_id": "1",
"bank_card_bank_id": "储蓄卡",
"bank_card_branch": "天府新区支行"
},
"is_handicap_id": 1,
"event_type": "入职",
"event_reason_id": 147067,
"leave_event_reason_id": 1,
"duty_id": 1662,
"department": {
"department_id": "147716",
"department_no": "NO.215619"
},
"report_leader": {
"report_leader_id": 75782241
},
"dashed_report_leader": {
"dashed_report_leader_id": 75782241
},
"mentor": {
"mentor_id": 75782241
},
"duty_level_id": 10491,
"manage_duty_level_id":11838,
"employee_type_id": 3,
"months_of_probation_id": 2,
"office_address_id": 1483,
"on_boarding_date": 1572246931000,
"extend_fields": {
"DF_c938c8aae4fa4298ba55d85c3b8bdecf": "任职信息测试单行"
}
}]
}'
操作成功，返回数据示例
{
"code": 0,
"msg": "成功",
"data": {
"code": 200,
"msg": "操作成功",
"data": [
{
"employee_uid": 75783721,
"employee_no": null,
"success": true,
"errorMessage": null
}
]
}
}
操作失败
{
"code": 0,
"msg": "成功",
"data": {
"code": 200,
"msg": "操作成功",
"data": [
{
"employee_uid": 75783721,
"employee_no": "GH2024042319425",
"success": false,
"errorMessage": "工号已被其他人使用"
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/addEmployees
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【新增员工接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| data | 否 | Array | 员工数据 |
请求体data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| employee_no | String | 员工工号 | |
| realname | String | 员工姓名 | |
| employeeAvatar | String | 员工头像url | 示例：https://hcm-pro.oss-cn-beijing.aliyuncs.com/csm/attachment/upload/89ee815f657dac1a11403882b3e72795.jpeg |
| begin_work_time | Long | 首次参加工作时间 | 毫秒时间戳 |
| id_no | json | 证件号码 | 字段示例"id_no": {"id_type_value": 2,"id_no": "HZ2024042311942","id_type_id": 2,"id_type_display": "护照"} |
| constellation_id | Long | 星座 | 星座的选项Id，如白羊座则传1 |
| birthday | Long | 出生日期 | 毫秒时间戳 |
| nickname | String | 花名 | |
| gender_id | String | 性别 | 性别的选项Id，如男则传1 |
| —————— | 联系方式分组分割线 | ------------- | ------------------------------ |
| telephone | json | 个人电话 | "telephone": {"country_code": "+7","value": "2024014231942"} |
| office_phone | String | 办公电话 | |
| officeEmail | String | 公司邮箱 | |
| personal_email | String | 个人邮箱 | |
| address | json | 现居住地址 | "address": {"province": "120000","city": "120000","county": "120102","value": "锦江大酒店1"} |
| work_station | String | 工位 | |
| —————— | 个人概况分组分割线 | ------------- | ------------------------------ |
| nationality_id | Long | 民族 | 选项Id |
| native_place | String | 籍贯 | |
| country_id | String | 国籍 | 选项Id |
| political_status_id | String | 政治面貌 | 选项Id |
| marital_status_id | String | 婚姻状况 | 选项Id |
| household_type_id | String | 户籍类型 | |
| household_address | json | 户籍地址 | "household_address": { "province": "120000","city": "120000","county": "120102","value": "锦江大酒店1"} |
| highest_education_id | Long | 最高学历 | |
| highest_degree_id | Long | 最高学位 | |
| graduate_school | String | 毕业院校 | |
| profession | String | 所学专业 | |
| is_handicap_id | Long | 是否残障 | 选项Id |
| —————— | 紧急联系人分组分割线 | ------------- | ------------------------------ |
| contact_name | String | 联系人姓名 | |
| social_relation_id | String | 关系 | |
| contact_phone | json | 联系人电话 | "contact_phone": {"country_code": "+7","value": "2024014231942"} |
| contact_address | json | 联系人地址 | "contact_address": {"province": "120000","city": "120000","county": "120102","value": "锦江大酒店1"} |
| —————— | 附件分组分割线 | ------------- | ------------------------------ |
| attachment_id | json | 身份证人像面 | |
| id_card_back | json | 身份证国徽面 | |
| attachment_bank_card | json | 银行卡图片 | |
| attachment_profile | json | 简历 | |
| attachment_leaving_certificate | json | 前公司离职证明 | |
| —————— | 银行卡分组分割线 | ------------- | ------------------------------ |
| bank_card | json | 工资卡 | "bank_card": {"bank_card": "2024042319422012404231942","bank_card_type_id": "1","bank_card_bank_id": "储蓄卡","bank_card_branch": "天府新区支行"} |
| —————— | 任职信息分组分割线 | ------------- | ------------------------------ |
| event_type | String | 事件类型 | |
| event_reason_id | Long | 事件原因 | |
| department | json | 部门 | "department": {"department_id": "147716","department_no": "NO.215619"} 部门支持部门Id或部门编码，两者都有以Id为准 |
| report_leader | json | 直接上级 | "report_leader": {"report_leader_id": 75782241,"report_leader_no": “1915619"} 人员类型字段支持employeeId或员工工号，两者都有以Id为准 |
| dashed_report_leader | json | 虚线主管 | "dashed_report_leader": {"dashed_report_leader_id": 75782241,"dashed_report_leader_no": “1915619"} 人员类型字段支持employeeId或员工工号，两者都有以Id为准 |
| mentor | json | 导师 | "mentor": {"mentor_id": 75782241,"mentor_no": “1915619"} 人员类型字段支持employeeId或员工工号，两者都有以Id为准 |
| position_id | Long | 职位Id | 仅职位模式租户有该字段 |
| duty_id | Long | 职务id | 仅职务模式租户有该字段 |
| duty_level_id | Long | 职级id | |
| manage_duty_level_id | Long | 管理职级id | |
| employee_type_id | Long | 员工类型id | 选项Id |
| months_of_probation_id | Long | 试用期月数 | 选项Id |
| office_address_id | Long | 工作地点Id | 选项Id |
| on_boarding_date | Long | 入职日期 | 毫秒时间戳 |
| become_formal_effect_date | Long | 转正式员工日期 | 毫秒时间戳 |
| end_probation_date | Long | 转正日期 | 毫秒时间戳 |
| leave_date | Long | 离职日期 | 毫秒时间戳 |
| company_start_date | Long | 司龄起算日期 | 毫秒时间戳 |
| leave_detail_reason | String | 离职详细原因 | |
| leave_handle_remark | String | 离职办理备注 | |
| leave_event_type | String | 离职事件类型 | |
| leave_event_reason_id | Long | 离职事件原因 | 事件原因选项Id |
| —————— | 自定义字段 | ------------- | ------------------------------ |
| extend_fields | json | 所有的自定义字段都在该字段中传入，字段类型同上面的预置字段类型的格式 | 如果字段是选项或是非类型，key以_id结尾，如：DF_1bdba785217c42b984f39d77f5407058_id |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.employee_uid | Long | 返回结果的业务数据内容 | 以人为维度 |
| data.employee_no | String | 员工工号 | |
| data.success | Boolean | 是否成功 | true：操作成功 false：操作失败 |
| data.errorMessage | String | 失败原因 |
更新员工接口
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/updateEmployees?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{
"data": [{
"employee_uid": 75783721,
"employee_no": "GH202404231942",
"employeeAvatar": "https://hcm-staging.oss-cn-beijing.aliyuncs.com/imgs/uploaded/headimgs/9fffaab4b7fbbe60a5fe0c138a720770.jpeg",
"nationality_id":2,
"realname": "20240423花名册添加员工06",
"begin_work_time": 1701328531000,
"company_start_date": 1635750931000,
"id_no": {
"id_type_value": 2,
"id_no": "HZ202404231942",
"id_type_id": 2,
"id_type_display": "护照"
},
"constellation_id": 9,
"birthday": 1618471652000,
"nickname": "奚仲",
"gender_id": 2,
"office_email": "202404231942@huan.com",
"personal_email": "202404231942@yuan.com",
"telephone": {
"country_code": "+7",
"value": "202404231942"
},
"address": {
"province": "120000",
"city": "120000",
"county": "120102",
"value": "锦江大酒店1"
},
"household_address": {
"province": "120000",
"city": "120000",
"county": "120102",
"value": "锦江大酒店1"
},
"office_phone": "202404231942",
"native_place": "吉林省吉林市",
"country_id": 3,
"political_status_id": 2,
"marital_status_id": 2,
"household_type_id": 2,
"highest_education_id": 1,
"highest_degree_id": 1,
"graduate_school": "清华大学",
"profession": "计算机科学与技术",
"contact_name": "李晓光",
"contact_address": {
"province": "120000",
"city": "120000",
"county": "120102",
"value": "锦江大酒店1"
},
"social_relation_id": 1,
"contact_phone": {
"country_code": "+1",
"value": "202404231942"
},
"work_station":"这是我的工位",
"bank_card": {
"bank_card": "202404231942202404231942",
"bank_card_type_id": "1",
"bank_card_bank_id": "储蓄卡",
"bank_card_branch": "天府新区支行"
},
"is_handicap_id": 1,
"event_type": "入职",
"event_reason_id": 147067,
"leave_event_reason_id": 1,
"duty_id": 1662,
"department": {
"department_id": "147716",
"department_no": "NO.215619"
},
"report_leader": {
"report_leader_id": 75782241
},
"dashed_report_leader": {
"dashed_report_leader_id": 75782241
},
"mentor": {
"mentor_id": 75782241
},
"duty_level_id": 10491,
"manage_duty_level_id":11838,
"employee_type_id": 3,
"months_of_probation_id": 2,
"office_address_id": 1483,
"on_boarding_date": 1572246931000,
"extend_fields": {
"DF_c938c8aae4fa4298ba55d85c3b8bdecf": "任职信息测试单行"
}
}]
}'
操作成功，返回数据示例
{
"code": 0,
"msg": "成功",
"data": {
"code": 200,
"msg": "操作成功",
"data": [
{
"employee_uid": 75783721,
"employee_no": null,
"success": true,
"errorMessage": null
}
]
}
}
操作失败
{
"code": 0,
"msg": "成功",
"data": {
"code": 200,
"msg": "操作成功",
"data": [
{
"employee_uid": 75783721,
"employee_no": "GH2024042319425",
"success": false,
"errorMessage": "工号已被其他人使用"
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/updateEmployees
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【变更员工接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| data | 否 | Array | 员工数据列表 |
请求体data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| employee_uid | Long | 员工id | |
| employee_no | String | 员工工号 | |
| realname | String | 员工姓名 | |
| employeeAvatar | String | 员工头像url | 示例：https://hcm-pro.oss-cn-beijing.aliyuncs.com/csm/attachment/upload/89ee815f657dac1a11403882b3e72795.jpeg |
| begin_work_time | Long | 首次参加工作时间 | 毫秒时间戳 |
| id_no | json | 证件号码 | 字段示例"id_no": {"id_type_value": 2,"id_no": "HZ2024042311942","id_type_id": 2,"id_type_display": "护照"} |
| constellation_id | Long | 星座 | 星座的选项Id，如白羊座则传1 |
| birthday | Long | 出生日期 | 毫秒时间戳 |
| nickname | String | 花名 | |
| gender_id | String | 性别 | 性别的选项Id，如男则传1 |
| —————— | 联系方式分组分割线 | ------------- | ------------------------------ |
| telephone | json | 个人电话 | "telephone": {"country_code": "+7","value": "2024014231942"} |
| office_phone | String | 办公电话 | |
| office_email | String | 公司邮箱 | |
| personal_email | String | 个人邮箱 | |
| address | json | 现居住地址 | "address": {"province": "120000","city": "120000","county": "120102","value": "锦江大酒店1"} |
| work_station | String | 工位 | |
| —————— | 个人概况分组分割线 | ------------- | ------------------------------ |
| nationality_id | Long | 民族 | 选项Id |
| native_place | String | 籍贯 | |
| country_id | String | 国籍 | 选项Id |
| political_status_id | String | 政治面貌 | 选项Id |
| marital_status_id | String | 婚姻状况 | 选项Id |
| household_type_id | String | 户籍类型 | |
| household_address | json | 户籍地址 | "household_address": { "province": "120000","city": "120000","county": "120102","value": "锦江大酒店1"} |
| highest_education_id | Long | 最高学历 | |
| highest_degree_id | Long | 最高学位 | |
| graduate_school | String | 毕业院校 | |
| profession | String | 所学专业 | |
| is_handicap_id | Long | 是否残障 | 选项Id |
| —————— | 紧急联系人分组分割线 | ------------- | ------------------------------ |
| contact_name | String | 联系人姓名 | |
| social_relation_id | String | 关系 | |
| contact_phone | json | 联系人电话 | "contact_phone": {"country_code": "+7","value": "2024014231942"} |
| contact_address | json | 联系人地址 | "contact_address": {"province": "120000","city": "120000","county": "120102","value": "锦江大酒店1"} |
| —————— | 附件分组分割线 | ------------- | ------------------------------ |
| attachment_id | json | 身份证人像面 | |
| id_card_back | json | 身份证国徽面 | |
| attachment_bank_card | json | 银行卡图片 | |
| attachment_profile | json | 简历 | |
| attachment_leaving_certificate | json | 前公司离职证明 | |
| —————— | 银行卡分组分割线 | ------------- | ------------------------------ |
| bank_card | json | 工资卡 | "bank_card": {"bank_card": "2024042319422012404231942","bank_card_type_id": "1","bank_card_bank_id": "储蓄卡","bank_card_branch": "天府新区支行"} |
| —————— | 任职信息分组分割线 | ------------- | ------------------------------ |
| event_type | String | 事件类型 | |
| event_reason_id | Long | 事件原因 | |
| department | json | 部门 | "department": {"department_id": "147716","department_no": "NO.215619"} 部门支持部门Id或部门编码，两者都有以Id为准 |
| report_leader | json | 直接上级 | "report_leader": {"report_leader_id": 75782241,"report_leader_no": “1915619"} 人员类型字段支持employeeId或员工工号，两者都有以Id为准 |
| dashed_report_leader | json | 虚线主管 | "dashed_report_leader": {"dashed_report_leader_id": 75782241,"dashed_report_leader_no": “1915619"} 人员类型字段支持employeeId或员工工号，两者都有以Id为准 |
| mentor | json | 导师 | "mentor": {"mentor_id": 75782241,"mentor_no": “1915619"} 人员类型字段支持employeeId或员工工号，两者都有以Id为准 |
| position_id | Long | 职位Id | 仅职位模式租户有该字段 |
| duty_id | Long | 职务id | 仅职务模式租户有该字段 |
| duty_level_id | Long | 职级id | |
| manage_duty_level_id | Long | 管理职级id | |
| employee_type_id | Long | 员工类型id | 选项Id |
| months_of_probation_id | Long | 试用期月数 | 选项Id |
| office_address_id | Long | 工作地点Id | 选项Id |
| on_boarding_date | Long | 入职日期 | 毫秒时间戳 |
| become_formal_effect_date | Long | 转正式员工日期 | 毫秒时间戳 |
| end_probation_date | Long | 转正日期 | 毫秒时间戳 |
| leave_date | Long | 离职日期 | 毫秒时间戳 |
| company_start_date | Long | 司龄起算日期 | 毫秒时间戳 |
| leave_detail_reason | String | 离职详细原因 | |
| leave_handle_remark | String | 离职办理备注 | |
| leave_event_type | String | 离职事件类型 | |
| leave_event_reason_id | Long | 离职事件原因 | 事件原因选项Id |
| —————— | 自定义字段 | ------------- | ------------------------------ |
| extend_fields | json | 所有的自定义字段都在该字段中传入，字段类型同上面的预置字段类型的格式 | 如果字段是选项或是非类型，key以_id结尾，如：DF_1bdba785217c42b984f39d77f5407058_id |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.employee_uid | Long | 返回结果的业务数据内容 | 以人为维度 |
| data.employee_no | String | 员工工号 | |
| data.success | Boolean | 是否操作成功 | true：操作成功 false：操作失败，失败原因见errorMessage |
| data.errorMessage | String | 失败原因 |
离职员工接口
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/leaveEmployees?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{
"data": [{
"employee_uid": "75605208",
"employee_no": "000003",
"leave_date": 1680679652000,
"event_type": "被动离职",
"event_reason_id": 113527,
"leave_detail_reason": "被动离职的详细原因",
"leave_handle_remark": "被动离职的备注"
}]
}'
操作成功，返回数据示例
{
"code": 0,
"msg": "成功",
"data": {
"code": 200,
"msg": "操作成功",
"data": [
{
"employee_uid": 75783721,
"employee_no": null,
"success": true,
"errorMessage": null
}
]
}
}
操作失败
{
"code": 0,
"msg": "成功",
"data": {
"code": 200,
"msg": "操作成功",
"data": [
{
"employee_uid": 75783721,
"employee_no": "GH2024042319425",
"success": false,
"errorMessage": "员工已离职不能重复离职"
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/leaveEmployees
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【离职员工接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| data | 否 | Array | 员工数据列表 |
请求体data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| employee_uid | Long | 员工Id | |
| employee_no | String | 员工工号 | |
| leave_date | Long | 离职日期 | 毫秒时间戳 |
| leave_detail_reason | String | 离职详细原因 | |
| leave_handle_remark | String | 离职办理备注 | |
| event_type | String | 离职事件类型 | |
| event_reason_id | Long | 离职事件原因 | 事件原因选项Id |
| —————— | 自定义字段 | ------------- | ------------------------------ |
| extend_fields | json | 所有的自定义字段都在该字段中传入，字段类型同上面的预置字段类型的格式 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.employee_uid | Long | 返回结果的业务数据内容 | 以人为维度 |
| data.employee_no | String | 员工工号 | |
| data.success | Boolean | 是否操作成功 | true：操作成功 false：操作失败，失败原因见errorMessage |
| data.errorMessage | String | 失败原因 |
新增员工履历信息
接口说明：通过该接口可批量添加员工的履历数据（注意：新增的数据通过系统校验才能写入成功）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/addResumeAndExtend?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"data": [
{
"employee_uid": 75783795,
"groups": [
{
"group_name": "工作经历",
"detail": [
{
"detail_fields": [
{
"field_name": "position",
"field_value": "后端"
},
{
"field_name": "start_time",
"field_value": "2022-01-01"
},
{
"field_name": "company_name",
"field_value": "maka"
},
{
"field_name": "DF_006126fbdefb4fcc8013cbb30a4ee7a9",
"field_value": "回龙岛",
"field_contact_address_province_code": "110000",
"field_contact_address_city_code": "110000",
"field_contact_address_county_code": "110101"
},
{
"field_name": "DF_99a592d517714f0cb83507ec2f573a4b",
"field_value": "{\"name\":\"文件名称\",\"url\":\"https://hcm-staging.oss-cn-beijing.aliyuncs.com/imgs/uploaded/headimgs/0a9eeac34837138d6d20892790fe1764.jpeg\"}"
},
{
"field_name": "DF_be955809beab4c2dbff0e661b766bb4d",
"field_value": "18380431022",
"field_telephone_country_code": "+86"
}
]
}
]
},
{
"group_name": "教育经历",
"detail": [
{
"detail_fields": [
{
"field_name": "study_school",
"field_value": "清华大学"
},
{
"field_name": "education",
"field_value": "2"
},
{
"field_name": "start_time",
"field_value": "2012-09-01"
}
]
}
]
},
{
"group_name": "项目经历",
"detail": [
{
"detail_fields": [
{
"field_name": "DF_1dd3af6293944ceaa2acf607861fbd12",
"field_value": "项目名字"
},
{
"field_name": "DF_66437208088c4808a460e56d0cbb0af2",
"field_value": "2019-09-01"
}
]
}
]
}
]
}
]
}
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": [
{
"employee_uid": 75783795,
"employee_no": null,
"success": true,
"errorMessage": null
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/addResumeAndExtend
请求频率：5次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【新增员工履历信息接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 备注 |
|---|---|---|---|
| data | 是 | Array | 需要批量创建的数据,数组长度不超过100 |
| └employee_uid | 否 | Long | 员工id(与employee_no不能同时为空) |
| └employee_no | 否 | String | 员工工号(与employee_uid不能同时为空) |
| └groups | 是 | Array | 分组信息 |
| └└group_id | 否 | Long | 分组id,与group_name参数二选一 |
| └└group_name | 否 | String | 分组名称 |
| └└detail | 是 | Array | 详细数据 |
| └└└detail_fields | 是 | Array | 数据字段值 |
| └└└└field_name | 是 | String | 字段名称 |
| └└└└field_value | 是 | String | 字段值,传空会过滤该字段,传值格式请参考示例参数 |
| └└└└field_telephone_country_code | 否 | String | 电话类型字段时，电话区号 |
| └└└└field_contact_address_province_code | 否 | String | 地址类型字段时，省编码 |
| └└└└field_contact_address_city_code | 否 | String | 地址类型字段时，市编码 |
| └└└└field_contact_address_county_code | 否 | String | 地址类型字段时，区编码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Array | 返回结果的数据内容 | |
| └employee_uid | Long | 传入的员工id | |
| └employee_no | Long | 传入的员工工号 | |
| └success | Boolean | 成功标记 | |
| └errorMessage | String | 异常提示 |
更新员工履历信息
接口说明：通过该接口可批量更新员工的履历数据（注意：数据通过系统校验才能写入成功）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/updateResumeAndExtend?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"data": [
{
"employee_uid": 75783795,
"groups": [
{
"group_name": "工作经历",
"detail": [
{
"detail_id": 123345,
"detail_fields": [
{
"field_name": "position",
"field_value": "后端"
},
{
"field_name": "start_time",
"field_value": "2022-01-01"
},
{
"field_name": "company_name",
"field_value": "maka"
},
{
"field_name": "DF_006126fbdefb4fcc8013cbb30a4ee7a9",
"field_value": "回龙岛",
"field_contact_address_province_code": "110000",
"field_contact_address_city_code": "110000",
"field_contact_address_county_code": "110101"
},
{
"field_name": "DF_99a592d517714f0cb83507ec2f573a4b",
"field_value": "{\"name\":\"文件名称\",\"url\":\"https://hcm-staging.oss-cn-beijing.aliyuncs.com/imgs/uploaded/headimgs/0a9eeac34837138d6d20892790fe1764.jpeg\"}"
},
{
"field_name": "DF_be955809beab4c2dbff0e661b766bb4d",
"field_value": "18380431022",
"field_telephone_country_code": "+86"
}
]
}
]
},
{
"group_name": "教育经历",
"detail": [
{
"detail_id": 12345,
"detail_fields": [
{
"field_name": "study_school",
"field_value": "清华大学"
},
{
"field_name": "education",
"field_value": "2"
},
{
"field_name": "start_time",
"field_value": "2012-09-01"
}
]
}
]
},
{
"group_name": "项目经历",
"detail": [
{
"detail_id": 123456,
"detail_fields": [
{
"field_name": "DF_1dd3af6293944ceaa2acf607861fbd12",
"field_value": "项目名字"
},
{
"field_name": "DF_66437208088c4808a460e56d0cbb0af2",
"field_value": "2019-09-01"
}
]
}
]
}
]
}
]
}
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": [
{
"employee_uid": 75783795,
"employee_no": null,
"success": true,
"errorMessage": null
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/updateResumeAndExtend
请求频率：5次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【更新员工履历信息接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 备注 |
|---|---|---|---|
| data | 是 | Array | 需要批量创建的数据,数组长度不超过100 |
| └employee_uid | 否 | Long | 员工id(与employee_no不能同时为空) |
| └employee_no | 否 | String | 员工工号(与employee_uid不能同时为空) |
| └groups | 是 | Array | 分组信息 |
| └└group_id | 否 | Long | 分组id,与group_name参数二选一 |
| └└group_name | 否 | String | 分组名称 |
| └└detail | 是 | Array | 详细数据 |
| └└└detail_id | 是 | Long | 需要更新id(通过【个人履历数据接口】【查询自定义分组定义字段数据接口】获取) |
| └└└detail_fields | 是 | Array | 数据字段值 |
| └└└└field_name | 是 | String | 字段名称 |
| └└└└field_value | 是 | String | 字段值,传空会过滤该字段,传值格式请参考示例参数 |
| └└└└field_telephone_country_code | 否 | String | 电话类型字段时，电话区号 |
| └└└└field_contact_address_province_code | 否 | String | 地址类型字段时，省编码 |
| └└└└field_contact_address_city_code | 否 | String | 地址类型字段时，市编码 |
| └└└└field_contact_address_county_code | 否 | String | 地址类型字段时，区编码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Array | 返回结果的数据内容 | |
| └employee_uid | Long | 传入的员工id | |
| └employee_no | Long | 传入的员工工号 | |
| └success | Boolean | 成功标记 | |
| └errorMessage | String | 异常提示 |
删除员工履历信息
接口说明：通过该接口可批量删除员工的履历数据
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/delResumeAndExtend?entCode=5c1b8edfaba1a83136c1fb3c1b45&apiCode=49e7eff65bfca7c2a87db10dddd0dd30&nonce=d8ql1fj2×tamp=1661404558915&sign=FSWCPIzq2g9vcON%2BvmugN3amNpK94rCgT4tWjxbZYobmgNQf8YZfiJzYl2N4fq56apiHfMjtB9PQACkNkLE5yVxB0b6sppyEj%2Fu05qagFkqDlQeghGIvS2V%2BUevSx65SuSHNwx4VsvegRq4FKQrcv4pdlX0sqpTYgRQ9PEzvPSk%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '
{
"data": [
{
"employee_uid":75783795,
"deleteGroups":[
{
"group_name":"工作经历",
"detail_ids":[
12355,12349
]
},
{
"group_name":"教育经历",
"detail_ids":[
7437
]
}
]
},
{
"employee_no": "DMW000115",
"deleteGroups":[
{
"group_name":"工作经历",
"detail_ids":[
12357
]
},
{
"group_name":"教育经历",
"detail_ids":[
7438
]
}
]
}
]
}
'
请求成功返回结果
{
"code": 200,
"msg": "操作成功",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/delResumeAndExtend
请求频率：5次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【删除员工履历信息接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 备注 |
|---|---|---|---|
| data | 是 | Array | 需要批量创建的数据,数组长度不超过100 |
| └employee_uid | 否 | Long | 员工id(与employee_no不能同时为空) |
| └employee_no | 否 | String | 员工工号(与employee_uid不能同时为空) |
| └deleteGroups | 是 | Array | 分组信息 |
| └└group_id | 否 | Long | 分组id,与group_name参数二选一 |
| └└group_name | 否 | String | 分组名称 |
| └└detail_ids | 是 | Array | 需要删除的数据id集合,Long类型集合 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Object | 返回结果的数据内容 |
新增员工所属项目组接口
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_set_emp_project?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Content-Type: application/json' \
--data '{
"empProjectList": [
{
"employeeId": 100000,
"employeeNo": "employeeNoXX",
"projectId": 888,
"projectCode": "projectCodeXXX",
"entryProjectDate": "2024-01-01",
"leaveProjectDate": "2024-03-30",
"customFieldList": [
{
"biz": "project_info",
"fieldName": "DF_自定义字段",
"value": "xxx"
}
]
},
{
"employeeId": 100001,
"employeeNo": "employeeNoXXX",
"projectId": 888,
"projectCode": "projectCodeXXX",
"entryProjectDate": "2024-01-01",
"leaveProjectDate": "2024-03-30",
"customFieldList": [
{
"biz": "project_info",
"fieldName": "DF_自定义字段",
"value": "xxx"
}
]
}
]
}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": null
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_set_emp_project
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【新增员工所属项目组接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| empProjectList | 是 | Array<Object> | 员工所属项目组信息 | |
| └employeeId | 否 | Long | 员工ID，不能与员工工号同时为空 | |
| └employeeNo | 否 | String | 员工工号，不能与员工ID同时为空 | |
| └projectId | 否 | Long | 项目组ID，不能与项目组编号同时为空 | |
| └projectCode | 否 | String | 项目组编号，不能与项目组ID同时为空 | |
| └entryProjectDate | 是 | Date | 进入项目组日期，格式：yyyy-MM-dd | |
| └leaveProjectDate | 否 | Date | 离开项目组日期，格式：yyyy-MM-dd | |
| └customFieldList | 否 | Array<Object> | 自定义字段列表 | |
| └└biz | 是 | String | 项目组字段biz | |
| └└fieldName | 是 | String | 项目组自定义字段列表 | |
| └└value | 是 | Object | 项目组自定义字段值 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 |
更新员工所属项目组接口
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_update_emp_project?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Content-Type: application/json' \
--data '{
"empProjectList": [
{
"employeeProjectId": -1,
"employeeId": 100000,
"employeeNo": "employeeNoXX",
"projectId": 888,
"projectCode": "projectCodeXXX",
"entryProjectDate": "2024-01-01",
"leaveProjectDate": "2024-03-30",
"customFieldList": [
{
"biz": "project_info",
"fieldName": "DF_自定义字段",
"value": "xxx"
}
]
},
{
"employeeProjectId": -2,
"employeeId": 100001,
"employeeNo": "employeeNoXXX",
"projectId": 888,
"projectCode": "projectCodeXXX",
"entryProjectDate": "2024-01-01",
"leaveProjectDate": "2024-03-30",
"customFieldList": [
{
"biz": "project_info",
"fieldName": "DF_自定义字段",
"value": "xxx"
}
]
}
]
}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": null
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_update_emp_project
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【更新员工所属项目组】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| empProjectList | 是 | Array<Object> | 员工所属项目组信息(最大200条) | |
| └employeeProjectId | 是 | Long | 员工所属项目组数据ID | |
| └employeeId | 否 | Long | 员工ID，不能与员工工号同时为空 | |
| └employeeNo | 否 | String | 员工工号，不能与员工ID同时为空 | |
| └projectId | 否 | Long | 项目组ID，不能与项目组编号同时为空 | |
| └projectCode | 否 | String | 项目组编号，不能与项目组ID同时为空 | |
| └entryProjectDate | 否 | Date | 进入项目组日期，格式：yyyy-MM-dd | |
| └leaveProjectDate | 否 | Date | 离开项目组日期，格式：yyyy-MM-dd | |
| └customFieldList | 否 | Array<Object> | 自定义字段列表 | |
| └└biz | 是 | String | 项目组字段biz | |
| └└fieldName | 是 | String | 项目组自定义字段列表 | |
| └└value | 是 | Object | 项目组自定义字段值 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 |
删除员工所属项目组接口
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_delete_emp_project?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Content-Type: application/json' \
--data '{
"empProjectList": [
{
"employeeProjectId": 999
"employeeId": 100000,
"employeeNo": "employeeNoXX",
"projectId": 888,
"projectCode": "projectCodeXXX",
"entryProjectDate": "2024-01-01",
},
{
"employeeProjectId": 998
"employeeId": 100001,
"employeeNo": "employeeNoXXX",
"projectId": 888,
"projectCode": "projectCodeXXX",
"entryProjectDate": "2024-01-01",
}
]
}'
操作成功，返回数据示例
{
"code": 200,
"msg": "操作成功",
"data": null
}
操作失败
{
"code": "$(对应的错误码)",
"msg": "$(对应的错误信息)",
"data": null
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/user/batch_delete_emp_project
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【删除员工所属项目组】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| empProjectList | 是 | Array<Object> | 员工所属项目组信息 | |
| └employeeProjectId | 否 | Long | 员工所属项目组记录ID | |
| └employeeId | 否 | Long | 员工ID，不能与员工工号同时为空 | |
| └employeeNo | 否 | String | 员工工号，不能与员工ID同时为空 | |
| └projectId | 否 | Long | 项目组ID，不能与项目组编号同时为空 | |
| └projectCode | 否 | String | 项目组编号，不能与项目组ID同时为空 | |
| └entryProjectDate | 是 | Date | 进入项目组日期，格式：yyyy-MM-dd |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 |
查询IM员工数据接口
请求示例
curl --location --request GET 'https://api.mokahr.com/api-platform/hcm/oapi/v1/batch/data?userName=您的邮箱地址&entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64'\
--header 'Content-Type: application/json' \
--data-raw '{
"uuidList":[1, 2]
}'
返回结果示例
{
"code": 200,
"msg": "操作成功",
"data": {
"wecomUserId": [
{
"userid": "WangXiaoJian",
"corpid": "ww8e40d2db9340f79f",
"uuid": 1,
"deptId": "287",
"type": 1,
"cipherUserId": "DKAJFLS98437R9FDSJF"
},
{
"userid": "luna-794",
"corpid": "ww8e40d2db9340f79f",
"uuid": 2,
"deptId": "287",
"type": 1,
"cipherUserId": "DKAJFLS98437R9FDSJF"
}
]
}
}
用户可以通过传递员工uuid的数组，获取到满足入参员工uuid数组中的数据。
- 员工相关数据：提供员工的第三方系统的ID，比如企业微信、钉钉、飞书等，包含在职离职人员。
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/batch/data
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| userName | 是 | String | 租户公司下的某个员工的邮箱； 注意: 推荐使用 超级管理员权限 |
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工关联信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| uuidList | 否 | Array<String> | 员工ID列表/数组，长度不超过2000 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| wecomUserId | Array | 返回员工企业微信的userId信息 | 如果用户在主数据接口配置中，"数据内容"没有选择"企业微信userId"，那么不显示 |
| └userid | String | 员工的企业微信明文userId | |
| └cipherUserId | String | 员工的企业微信密文userId | |
| └corpid | String | 员工所属企业的微信corpId | |
| └uuid | Long | 员工在moka系统中的唯一标识id | |
| └deptId | String | 员工所属部门的企业微信deptId | |
| └type | int | 数据类型1：钉钉2：企业微信3：飞书 |
|
| dingdingUserId | Array | 返回员工钉钉的userId信息 | 如果用户在主数据接口配置中，"数据内容"没有选择"钉钉userId"，那么不显示 |
| └"同企业微信" | 略 |
待入职员工数据接口
请求示例
curl --location --request GET 'https://api.mokahr.com/api-platform/hcm/oapi/v1/roster/onboarding?entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64'\
--header 'Content-Type: application/json' \
--data-raw '{
"updateStartTime": "2021-09-01 00:00:00",
"updateEndTime": "2021-12-31 23:59:59"
}'
返回结果示例
{
"code": 200,
"msg": "操作成功",
"data": {
"pageNum": 1,
"pageSize": 1,
"size": 1,
"list": [
{
"gender": "女",
"contract_limit_id": 2,
"months_of_probation_id": 1,
"highest_education": "本科",
"contract_type_id": 1,
"contract_start_date": 1598889600000,
"path": "王测试根目录MMM/SE事业测试部/市场部/新媒体运营部",
"office_address_id": 51,
"update_time": "2021-07-09T14:20:25.000+0800",
"estimate_end_date": 1604102400000,
"duty_level": "M3",
"duty_id": 65,
"contract_limit": "2个月",
"id": 19,
"office_email": "123@123.com",
"department": " 新媒体运营部",
"on_boarding_date": 1598946523064,
"months_of_probation": "无",
"department_id": 29027,
"corporation": "北京希瑞雅思科技有限公司",
"telephone": "17621829477",
"highest_education_id": 3,
"gender_id": 2,
"realname": "摩小卡",
"report_leader_id": 807,
"contract_type": "劳动合同",
"employee_type": "正式",
"duty_level_id": 33,
"office_address": "北京总部",
"employee_type_id": 1,
"duty": "销售总监",
"report_leader": "王晓健",
"on_boarding_location": "beijing ",
"personal_email": "wanshizhen@kezaihui.com",
"status": 0
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/roster/onboarding
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工待入职信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过10位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒ms |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| telephoneList | 否 | Array<String> | 个人电话列表/数组，长度不超过50 |
| officeEmailList | 否 | Array<String> | 公司邮箱列表/数组，长度不超过50 |
| personalEmailList | 否 | Array<String> | 个人邮箱列表/数组，长度不超过50 |
| obIds | 否 | Array<Long> | 待入职id数组，长度不超过50，使用该参数时可不传入职时间或者更新时间 |
| updateStartTime | 否 | String | 更新时间查询开始时间, "yyyy-MM-dd HH:mm:ss"，时间不超过180天 |
| updateEndTime | 否 | String | 更新时间查询结束时间, "yyyy-MM-dd HH:mm:ss"，时间不超过180天 |
| onBoardingStartTime | 否 | String | 入职时间查询开始时间, "yyyy-MM-dd HH:mm:ss"，时间不超过180天 请求参数中，不使用obIds参数的情况下，入职时间、更新时间需要二选一或者都填 |
| onBoardingEndTime | 否 | String | 入职时间查询结束时间, "yyyy-MM-dd HH:mm:ss"，时间不超过180天 |
| pageSize | 否 | 分页大小， 不超过50 | |
| pageNum | 否 | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
| size | 是 | int | 返回结果的业务数据条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | Long | 唯一id | |
| employee_no | String | 工号 | |
| nickname | String | 花名 | |
| realname | String | 员工姓名 | |
| nickname_pinyin | String | 花名拼音 | |
| realname_pinyin | String | 员工姓名拼音 | |
| department | String | 员工所在的部门名称 | |
| └department_id | Long | 部门在People系统的唯一id | 此id与部门接口返回的id一致 |
| report_leader | String | 汇报上级 | |
| └report_leader_id | Long | 汇报上级在People系统的唯一id | 此id与员工接口返回的uuid一致 |
| office_address | String | 工作地点 | |
| └office_address_id | Long | 工作地点在People系统的唯一id | 目前不准确，不建议使用 |
| employee_type | String | 员工类型 | 4种系统预置字段正式实习生劳务派遣兼职 |
| └employee_type_id | Long | 员工类型在People系统的唯一id | 1：正式2：实习生3：劳务派遣4：兼岗 |
| duty | String | 职务 | 此id与职务接口返回的id一致 |
| └duty_id | Long | 职务在People系统的唯一id | |
| gender | String | 性别 | "女" or "男" |
| └gender_id | String | 性别id | 0："女"1："男" |
| on_boarding_date | Long | 入职日期 | 格式: 毫秒时间戳 |
| period_end_date | Long | 试用截止日期 | 格式: 毫秒时间戳 |
| birthday | Long | 出生日期 | 格式: 毫秒时间戳 |
| update_time | Long | 更新日期 | 格式: 毫秒时间戳 |
| months_of_probation | String | 试用期月数 | |
| └months_of_probation_id | int | 试用期的id编号 | |
| personal_email | String | 个人邮箱 | |
| telephone | String | 个人电话的号码 | 字段类型"type": 7，表示手机号类型 |
| └telephone_country_code | 暂缺 | ||
| highest_degree | String | 最高学位 | type=5 |
| └highest_degree_id | int | 最高学位的id标识 | 可选值：1：表示博士2：表示研究生3：表示学士4：表示无学 |
| id_no | String | 证件号码 | 示例：11010919931001111 |
| └id_no_id_type | String | 证件类型 | 示例："身份证" |
| highest_education | String | 最高学历 | |
| └highest_education_id | int | 最高学历的id标识 | 可选值：1：表示博士生2：表示研究生3：表示大学生4：表示高中生 |
| status | int | 状态 | 可选值：0：表示待入职1：表示已入职2：表示已取消 |
| bank_card | object | 银行卡 | 银行卡类型复合字段 |
| └fieldName | String | 字段名 | 字段名称 |
| └value | String | 银行卡值 | |
| └└bank_card | String | 银行卡号 | 银行卡号 |
| └└bank_card_branch | String | 支行 | 支行 |
| └└bank_card_bank_display | String | 开户行名称 | 开户行名称 |
| └└bank_card_type | String | 银行卡类型 | 银行卡类型 |
| └└bank_card_bank | String | 开户行ID | 开户行ID |
个人履历数据接口
返回结果示例
{
"code": 200,
"msg": "操作成功",
"data": {
"list": [
{
"employeeId": 243467,
"education": [
{
"educational_method": {
"educational_method_id": 1,
"educational_method_value": "全日制教育"
},
"start_time": "2015-04-09",
"study_profession": "软件工程",
"study_school": "北京邮电大学",
"education": {
"education_id": 3,
"education_value": "本科"
},
"end_time": "2019-07-01",
"degree": {
"degree_id": 3,
"degree_value": "学士"
},
"highest_level_edu": "1",
"id": 91602
}
],
"work": [
{
"DF_5168ec6f410c4c95a67be23a711894d5": "描述",
"end_time": "2022-04-30",
"DF_8e7276e189cf4cf1bd13ab3534ca9902": {
"DF_8e7276e189cf4cf1bd13ab3534ca9902_province_name": "北京市",
"DF_8e7276e189cf4cf1bd13ab3534ca9902_city_code": "110000",
"DF_8e7276e189cf4cf1bd13ab3534ca9902_city_name": "北京市",
"DF_8e7276e189cf4cf1bd13ab3534ca9902": "地址",
"DF_8e7276e189cf4cf1bd13ab3534ca9902_county_code": "110108",
"DF_8e7276e189cf4cf1bd13ab3534ca9902_province_code": "110000",
"DF_8e7276e189cf4cf1bd13ab3534ca9902_county_name": "海淀区"
},
"DF_f18f51d246464b8bbb5c97f04e7d12d6": {
"DF_f18f51d246464b8bbb5c97f04e7d12d6_id_type": "身份证",
"id_type": 1,
"DF_f18f51d246464b8bbb5c97f04e7d12d6": "230000000000000000"
},
"DF_c99c4b7c46cf4e7da9c16f2fdfcb40df": [
{
"attachment_url": "https://hcm-pro.oss-cn-beijing.aliyuncs.com/form/attachment/c6759f56d9677f3c42e7f4aaf0d12f87.pdf?Expires=1651139534&OSSAccessKeyId=xxx&Signature=yyy",
"attachment_name": "1.3.0.pdf"
}
],
"start_time": "2022-03-01",
"company_name": "公司名称",
"DF_43b7e7c732584b29adeddbbf9f7d8f8e": {
"DF_43b7e7c732584b29adeddbbf9f7d8f8e_country_code": "+86",
"DF_43b7e7c732584b29adeddbbf9f7d8f8e": "18200000000"
},
"id": 110584,
"position": "职位",
"leave_reason": "离职原因",
"report_leader": "上级",
"department": "Moka部门"
}
],
"exercitation": [
{
"start_time": "2020-04-01",
"company_name": "Moka实习公司名称",
"end_time": "2020-05-01",
"id": 8257,
"position": "实习职位",
"report_leader": "实习上级",
"department": "Moka实习部门"
}
],
"extend": null
}
],
"total": 1,
"size": 1,
"labelList": [
{
"fieldName": "company_name",
"label": "公司名称",
"type": 1
},
{
"fieldName": "department",
"label": "部门",
"type": 1
},
{
"fieldName": "position",
"label": "职位",
"type": 1
},
{
"fieldName": "start_time",
"label": "开始日期",
"type": 2
},
{
"fieldName": "end_time",
"label": "结束日期",
"type": 2
},
{
"fieldName": "leave_reason",
"label": "离职原因",
"type": 1
},
{
"fieldName": "report_leader",
"label": "直接上级",
"type": 1
},
{
"fieldName": "DF_f18f51d246464b8bbb5c97f04e7d12d6",
"label": "证件",
"type": 9
},
{
"fieldName": "DF_c99c4b7c46cf4e7da9c16f2fdfcb40df",
"label": "附件",
"type": 8
},
{
"fieldName": "DF_43b7e7c732584b29adeddbbf9f7d8f8e",
"label": "电话",
"type": 7
},
{
"fieldName": "DF_8e7276e189cf4cf1bd13ab3534ca9902",
"label": "地址",
"type": 6
},
{
"fieldName": "DF_5168ec6f410c4c95a67be23a711894d5",
"label": "描述",
"type": 11
},
{
"fieldName": "study_school",
"label": "学校",
"type": 1
},
{
"fieldName": "study_profession",
"label": "专业",
"type": 1
},
{
"fieldName": "start_time",
"label": "开始日期",
"type": 2
},
{
"fieldName": "end_time",
"label": "结束日期",
"type": 2
},
{
"fieldName": "education",
"label": "学历",
"type": 5
},
{
"fieldName": "degree",
"label": "学位",
"type": 5
},
{
"fieldName": "educational_method",
"label": "教育方式",
"type": 5
},
{
"fieldName": "highest_level_edu",
"label": "是否最高学历",
"type": 1
},
{
"fieldName": "company_name",
"label": "公司名称",
"type": 1
},
{
"fieldName": "department",
"label": "部门",
"type": 1
},
{
"fieldName": "position",
"label": "职位",
"type": 1
},
{
"fieldName": "start_time",
"label": "开始日期",
"type": 2
},
{
"fieldName": "end_time",
"label": "结束日期",
"type": 2
},
{
"fieldName": "report_leader",
"label": "直接上级",
"type": 1
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/roster/personal/resume
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工履历信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组，<=200条 员工ID数组与员工工号数组不可以同时传入，二者择一传入即可 |
| employeeNoList | 否 | Array<String> | 员工工号列表/数组，<=200条 员工ID数组与员工工号数组不可以同时传入，二者择一传入即可 |
| employeeStatus | 否 | int | 员工状态，不传默认为在职状态 1：在职 2：离职 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 | |
| data.labelList | JsonArray | 业务数据内容的字段说明 | |
| data.size | int | 返回结果的业务数据条数 | |
| data.total | Long | 总条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.list.employeeId | Long | 员工ID | |
| data.list.education | Array | 教育经历集合 | 如果当前员工没有该项数据则为null。 |
| data.list.work | Array | 工作经历集合 | 如果当前员工没有该项数据则为null。 |
| data.list.exercitation | Array | 实习经历集合 | 如果当前员工没有该项数据则为null。 |
| data.list.extend | Array | 自定义分组集合 | 当前自定义分组返回都为null |
数据内容data.list.education 说明：返回格式均为key:value格式（key为字段名称，value为对应的值）
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| study_school | String | 学校 | |
| study_profession | String | 专业 | |
| education | Object | 学历 | |
| └education_id | int | ID | |
| └education_value | String | 名称 | |
| educational_method | Object | 教育方式 | |
| └educational_method_id | int | ID | |
| └educational_method_value | String | 名称 | |
| degree | Object | 学位 | |
| └degree_id | int | ID | |
| └degree_value | String | 名称 | |
| highest_level_edu | String | 是否最高学历 | 是：1 否：0 |
| start_time | String | 开始时间 | |
| end_time | String | 结束时间 | |
| 用户自定义字段 (DF_XXX) | object | 根据labelList描述字段类型不同返回格式不同 |
数据内容data.list.work 说明：返回格式均为key:value格式（key为字段名称，value为对应的值）
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| company_name | String | 公司名称 | |
| department | String | 部门 | |
| position | String | 职位 | |
| report_leader | String | 直接上级 | |
| leave_reason | String | 离职原因 | |
| start_time | String | 开始时间 | |
| end_time | String | 结束时间 | |
| 用户自定义字段 (DF_XXX) | object | 根据labelList描述字段类型不同返回格式不同 |
数据内容data.list.exercitation 说明：返回格式均为key:value格式（key为字段名称，value为对应的值）
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| company_name | String | 公司名称 | |
| department | String | 部门 | |
| position | String | 职位 | |
| report_leader | String | 直接上级 | |
| start_time | String | 开始时间 | |
| end_time | String | 结束时间 | |
| 用户自定义字段 (DF_XXX) | object | 根据labelList描述字段类型不同返回格式不同 |
个人履历数据接口(权限)
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/roster/personal/resume?userName=您的邮箱地址&entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{
"uuidList":[],
"pageSize": 200,
"pageNum": 1
}'
结果示例
{
"code": 200,
"msg": "操作成功",
"data": {
"list": [
{
"employeeId": 243467,
"education": [
{
"educational_method": {
"educational_method_id": 1,
"educational_method_value": "全日制教育"
},
"start_time": "2015-04-09",
"study_profession": "软件工程",
"study_school": "北京邮电大学",
"education": {
"education_id": 3,
"education_value": "本科"
},
"end_time": "2019-07-01",
"degree": {
"degree_id": 3,
"degree_value": "学士"
},
"highest_level_edu": "1",
"id": 91602
}
],
"work": [
{
"DF_5168ec6f410c4c95a67be23a711894d5": "描述",
"end_time": "2022-04-30",
"DF_8e7276e189cf4cf1bd13ab3534ca9902": {
"DF_8e7276e189cf4cf1bd13ab3534ca9902_province_name": "北京市",
"DF_8e7276e189cf4cf1bd13ab3534ca9902_city_code": "110000",
"DF_8e7276e189cf4cf1bd13ab3534ca9902_city_name": "北京市",
"DF_8e7276e189cf4cf1bd13ab3534ca9902": "地址",
"DF_8e7276e189cf4cf1bd13ab3534ca9902_county_code": "110108",
"DF_8e7276e189cf4cf1bd13ab3534ca9902_province_code": "110000",
"DF_8e7276e189cf4cf1bd13ab3534ca9902_county_name": "海淀区"
},
"DF_f18f51d246464b8bbb5c97f04e7d12d6": {
"DF_f18f51d246464b8bbb5c97f04e7d12d6_id_type": "身份证",
"id_type": 1,
"DF_f18f51d246464b8bbb5c97f04e7d12d6": "230000000000000000"
},
"DF_c99c4b7c46cf4e7da9c16f2fdfcb40df": [
{
"attachment_url": "https://hcm-pro.oss-cn-beijing.aliyuncs.com/form/attachment/c6759f56d9677f3c42e7f4aaf0d12f87.pdf?Expires=1651139534&OSSAccessKeyId=xxx&Signature=yyy",
"attachment_name": "1.3.0.pdf"
}
],
"start_time": "2022-03-01",
"company_name": "公司名称",
"DF_43b7e7c732584b29adeddbbf9f7d8f8e": {
"DF_43b7e7c732584b29adeddbbf9f7d8f8e_country_code": "+86",
"DF_43b7e7c732584b29adeddbbf9f7d8f8e": "18200000000"
},
"id": 110584,
"position": "职位",
"leave_reason": "离职原因",
"report_leader": "上级",
"department": "Moka部门"
}
],
"exercitation": [
{
"start_time": "2020-04-01",
"company_name": "Moka实习公司名称",
"end_time": "2020-05-01",
"id": 8257,
"position": "实习职位",
"report_leader": "实习上级",
"department": "Moka实习部门"
}
],
"extend": null
}
],
"total": 1,
"size": 1,
"labelList": [
{
"fieldName": "company_name",
"label": "公司名称",
"type": 1
},
{
"fieldName": "department",
"label": "部门",
"type": 1
},
{
"fieldName": "position",
"label": "职位",
"type": 1
},
{
"fieldName": "start_time",
"label": "开始日期",
"type": 2
},
{
"fieldName": "end_time",
"label": "结束日期",
"type": 2
},
{
"fieldName": "leave_reason",
"label": "离职原因",
"type": 1
},
{
"fieldName": "report_leader",
"label": "直接上级",
"type": 1
},
{
"fieldName": "DF_f18f51d246464b8bbb5c97f04e7d12d6",
"label": "证件",
"type": 9
},
{
"fieldName": "DF_c99c4b7c46cf4e7da9c16f2fdfcb40df",
"label": "附件",
"type": 8
},
{
"fieldName": "DF_43b7e7c732584b29adeddbbf9f7d8f8e",
"label": "电话",
"type": 7
},
{
"fieldName": "DF_8e7276e189cf4cf1bd13ab3534ca9902",
"label": "地址",
"type": 6
},
{
"fieldName": "DF_5168ec6f410c4c95a67be23a711894d5",
"label": "描述",
"type": 11
},
{
"fieldName": "study_school",
"label": "学校",
"type": 1
},
{
"fieldName": "study_profession",
"label": "专业",
"type": 1
},
{
"fieldName": "start_time",
"label": "开始日期",
"type": 2
},
{
"fieldName": "end_time",
"label": "结束日期",
"type": 2
},
{
"fieldName": "education",
"label": "学历",
"type": 5
},
{
"fieldName": "degree",
"label": "学位",
"type": 5
},
{
"fieldName": "educational_method",
"label": "教育方式",
"type": 5
},
{
"fieldName": "highest_level_edu",
"label": "是否最高学历",
"type": 1
},
{
"fieldName": "company_name",
"label": "公司名称",
"type": 1
},
{
"fieldName": "department",
"label": "部门",
"type": 1
},
{
"fieldName": "position",
"label": "职位",
"type": 1
},
{
"fieldName": "start_time",
"label": "开始日期",
"type": 2
},
{
"fieldName": "end_time",
"label": "结束日期",
"type": 2
},
{
"fieldName": "report_leader",
"label": "直接上级",
"type": 1
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/roster/personal/resume
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| userName | 是 | String | 您所属租户下的某个员工的邮箱，注意： 1. 该员工必须拥有此apiCode应用中授权的角色。 2. 该员工账号权限中此角色的管理范围，决定了返回数据的范围，管理员可以在People的"设置"-"账号权限"-"账号管理"中配置返回的数据范围。 3. 推荐使用 超级管理员 权限。 4. 员工离职时账号权限会被收回 |
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工履历信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组，<=200条 员工ID数组与员工工号数组不可以同时传入，二者择一传入即可 |
| employeeNoList | 否 | Array<String> | 员工工号列表/数组，<=200条 员工ID数组与员工工号数组不可以同时传入，二者择一传入即可 |
| employeeStatus | 否 | int | 员工状态，不传默认为在职状态 1：在职 2：离职 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 | |
| data.labelList | JsonArray | 业务数据内容的字段说明 | |
| data.size | int | 返回结果的业务数据条数 | |
| data.total | Long | 总条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.list.employeeId | Long | 员工ID | |
| data.list.education | Array | 教育经历集合 | 如果当前员工没有该项数据则为null。 |
| data.list.work | Array | 工作经历集合 | 如果当前员工没有该项数据则为null。 |
| data.list.exercitation | Array | 实习经历集合 | 如果当前员工没有该项数据则为null。 |
| data.list.extend | Array | 自定义分组集合 | 当前自定义分组返回都为null |
数据内容data.list.education 说明：返回格式均为key:value格式（key为字段名称，value为对应的值）
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| study_school | String | 学校 | |
| study_profession | String | 专业 | |
| education | Object | 学历 | |
| └education_id | int | ID | |
| └education_value | String | 名称 | |
| educational_method | Object | 教育方式 | |
| └educational_method_id | int | ID | |
| └educational_method_value | String | 名称 | |
| degree | Object | 学位 | |
| └degree_id | int | ID | |
| └degree_value | String | 名称 | |
| highest_level_edu | String | 是否最高学历 | 是：1 否：0 |
| start_time | String | 开始时间 | |
| end_time | String | 结束时间 | |
| 用户自定义字段 (DF_XXX) | object | 根据labelList描述字段类型不同返回格式不同 |
数据内容data.list.work 说明：返回格式均为key:value格式（key为字段名称，value为对应的值）
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| company_name | String | 公司名称 | |
| department | String | 部门 | |
| position | String | 职位 | |
| report_leader | String | 直接上级 | |
| leave_reason | String | 离职原因 | |
| start_time | String | 开始时间 | |
| end_time | String | 结束时间 | |
| 用户自定义字段 (DF_XXX) | object | 根据labelList描述字段类型不同返回格式不同 |
数据内容data.list.exercitation 说明：返回格式均为key:value格式（key为字段名称，value为对应的值）
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| company_name | String | 公司名称 | |
| department | String | 部门 | |
| position | String | 职位 | |
| report_leader | String | 直接上级 | |
| start_time | String | 开始时间 | |
| end_time | String | 结束时间 | |
| 用户自定义字段 (DF_XXX) | object | 根据labelList描述字段类型不同返回格式不同 |
家庭成员数据接口
返回结果示例
{
"code": 200,
"msg": "操作成功",
"data": {
"list": [
{
"employeeId": 243467,
"family": [
{
"member_address": {
"member_address": "详细地址",
"member_address_city_code": "110000",
"member_address_county_code": "110108",
"member_address_province_name": "北京市",
"member_address_province_code": "110000",
"member_address_county_name": "海淀区",
"member_address_city_name": "北京市"
},
"member_id_no": {
"member_id_no_id_type": "身份证",
"member_id_no": "230000000000000000",
"id_type": 1
},
"id": 33291,
"member_birthday": "2022-04-20",
"member_name": "家庭成员姓名",
"member_relation": {
"member_relation_id": 1,
"member_relation_value": "父母"
},
"member_telephone": {
"member_telephone": "18200000000",
"member_telephone_country_code": "+86"
}
}
]
}
],
"total": 1,
"size": 1,
"labelList": [
{
"fieldName": "member_name",
"label": "成员姓名",
"type": 1
},
{
"fieldName": "member_relation",
"label": "与员工关系",
"type": 5
},
{
"fieldName": "member_telephone",
"label": "成员联系电话",
"type": 7
},
{
"fieldName": "member_address",
"label": "成员联系地址",
"type": 6
},
{
"fieldName": "member_id_no",
"label": "成员证件号码",
"type": 9
},
{
"fieldName": "member_birthday",
"label": "成员生日",
"type": 2
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/roster/family/personnel
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【家庭成员信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组，<=200条 员工ID数组与员工工号数组不可以同时传入，二者择一传入即可 |
| employeeNoList | 否 | Array<String> | 员工工号列表/数组，<=200条 员工ID数组与员工工号数组不可以同时传入，二者择一传入即可 |
| employeeStatus | 否 | int | 员工状态，不传默认为在职状态 1：在职 2：离职 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 | |
| data.labelList | JsonArray | 业务数据内容的字段说明 | |
| data.size | int | 返回结果的业务数据条数 | |
| data.total | Long | 总条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.list.employeeId | Long | 员工ID | |
| data.list.family | Array | 家庭成员集合 | 如果当前员工没有该项数据则为null。 |
数据内容data.list.family 说明：返回格式均为key:value格式（key为字段名称，value为对应的值）
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| member_name | String | 成员姓名 | |
| member_relation | Object | 与员工关系 | |
| └member_relation_id | int | ID | |
| └member_relation_value | String | 名称 | |
| member_telephone | Object | 成员联系电话 | |
| └member_telephone | String | 电话号 | |
| └member_telephone_country_code | String | 区号 | |
| member_address | Object | 成员联系地址 | |
| └member_address_province_code | String | 省邮政编码 | |
| └member_address_province_name | String | 省名称 | |
| └member_address_city_code | String | 市邮政编码 | |
| └member_address_city_name | String | 市名称 | |
| └member_address_county_code | String | 区邮政编码 | |
| └member_address_county_name | String | 区名称 | |
| └member_address | String | 详细地址 | |
| member_id_no | Object | 成员证件号码 | |
| └id_type | int | 证件类型 | |
| └member_id_no_id_type | String | 证件类型描述 | |
| └member_id_no | String | 证件编码 | |
| member_birthday | String | 成员生日 | |
| 用户自定义字段 (DF_XXX) | object | 根据labelList描述字段类型不同返回格式不同 |
员工基本信息回写接口（写入）
接口说明：通过此接口，可以回写员工个人信息 - 联系方式的数据记录
请求示例1：
{
"employeeWriteBasicInfoList": [
{
"employeeId": 75714361,
"oneOnOneChildObjectMap": {
"contact-office_phone": "110911",
"contact-telephone": {
"countryCode": "86",
"value": "18800000000"
},
"contact-office_email": "moka@email.com",
"contact-personal_email": "moka@email.com"
}
},
{
"employeeId": 75714357,
"oneOnOneChildObjectMap": {
"contact-office_phone": "110911",
"contact-telephone": {
"countryCode": "86",
"value": "18800000000"
},
"contact-office_email": "moka@email.com",
"contact-personal_email": "moka@email.com"
}
}
]
}
响应实例：写入成功
{
"code":0,
"msg":"成功",
"data":{
"success":false,
"writeErrorMsgList":[
]
}
}
响应实例：写入失败的提示
{
"code": 0,
"msg": "成功",
"data": {
"success": false,
"writeErrorMsgList": [
{
"index": 1,
"code": null,
"tip": null,
"baseFieldWriteErrorMsgList": [
{
"code": 600006,
"tip": "本次编辑个人邮箱(18818210001@xiaoemail.com)存在重复行",
"biz": "contact",
"fieldName": "personal_email",
"childFieldName": null
},
{
"code": 100002,
"tip": "个人邮箱与员工 接口测试1 重复",
"biz": "contact",
"fieldName": "personal_email",
"childFieldName": null
}
],
"multiFieldWriteErrorMsgList": [
]
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/writeEmployeeBasicInfo
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID；在Moka People系统"设置" - 对外设置"中显示 填写【员工个人信息回写接口】数据源的apiCode。 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeWriteParamList | 是 | Array | 长度<=10, 一次只能写入10个员工 |
| └employeeId | 是 | Long | 员工ID（在People系统的唯一主键） |
| └oneOnOneChildObjectMap | 是 | Map |
一对一信息 key为people系统的biz + "-"+FieldValue的name,String类型，包括有("contact"); value为FieldValueBo多行信息结构对象，见下表 |
FieldValueBo类型有以下几种，多行信息结构对象：
| 类型 | 描述 | 备注 |
|---|---|---|
| BankCardFieldValue | 银行卡类型，对应type=40 | 见下表的数据结构 |
| NumberFieldValueBo | 数字，对应type=3 | key为对应的字段，以key-拼接fieldName。如：baseInfo-DF_7d3e6882397643cf8fbcc939af6234fd； 见下表的数据结构 |
| String | 单行文本，对应type=1 | String类型 |
| List |
附件，对应type=8 | 注意是数组类型；见下表的数据结构 |
| AddressFieldValueBo | 地址，对应type=6 | 见下表的数据结构 |
| SelectFieldValueBo | 单选，对应type=5 | 见下表的数据结构 |
| TelephoneFieldValueBo | 电话，对应type=7 | 见下表的数据结构 |
| DateFieldValueBo | 日期，对应type=2 | 见下表的数据结构 |
| WhetherFieldValueBo | 是非，对应type=4 | 见下表的数据结构 |
CertificateFieldValue |
证件类型，对应type=9 | 见下表的数据结构 |
| String | 多行文本，对应type=11 |
NumberFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| valueLong | 是 | Long | Long类型的数值 | |
| valueStr | 是 | String | 字符串类型的数值 | |
| unit | 否 | String | 单位 |
AttachmentFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| id | 否 | Long | ID | |
| name | 是 | String | 附件名称 | |
| url | 是 | String | 地址 |
AddressFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| province | 是 | String | 省code码，例如：北京市：110000 | |
| provinceName | 是 | String | 省 | |
| city | 是 | String | 市code码 | |
| cityName | 是 | String | 市 | |
| county | 是 | String | 区code编码 | |
| countyName | 是 | String | 区 | |
| value | 是 | String | 详细地址 |
SelectFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| id | 是 | Long | 单选的值，如：1是男，2是女 | |
| name | 是 | String | 展示的名字，如："男"和"女"，分别对应id=1和2 | |
| sortNo | 否 | int | 排序序号，一般用于展示的顺序 | |
| isDelete | 否 | Byte | 删除状态，0：不可删除，1：未删除，2：已删除 |
TelephoneFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| countryCode | 是 | String | 地区编码 | |
| value | 是 | String | 电话号 |
DateFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| dateStr | 是 | String | 字符串格式，格式为："2022-03-15 12:53:08 |
WhetherFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| id | 是 | Long | 取值1,2 | |
| name | 是 | String | 取值"是"和"否"，分别对应id=1和2 | |
| isDelete | 否 | Byte | 删除状态，0：不可删除，1：未删除，2：已删除 |
响应体：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data.writeErrorMsgList | Array | 错误信息提示 | |
| data.WriteErrorMsgList.index | int | 索引 | |
| data.WriteErrorMsgList.tip | String | 错误提示信息 | |
| data.writeErrorMsgList.baseFieldWriteErrorMsgList.code | int | 错误码 | |
| data.writeErrorMsgList.baseFieldWriteErrorMsgList.tip | String | 错误提示信息 | |
| data.writeErrorMsgList.baseFieldWriteErrorMsgList.biz | String | biz字段名称 | 比如contact |
| data.writeErrorMsgList.baseFieldWriteErrorMsgList.fieldName | String | fieldName字段名称 | 比如personal_email |
新增员工项目组人力接口
接口说明：通过该接口可新增人员项目组人力数据
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/project/employee/detail/batchCreate?entCode=0f2673af30d55d2e8b20298202ca326f&apiCode=27a136d77843c603720026bc4c1c6999×tamp=1241234&nonce=12&sign=12' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '{
"empProjectList": [
{
"empId": 12345,
"empNumber": "text_001",
"projectId": "100123",
"projectCode": "00123TE",
"manpowerType": 1,
"manpowerDate": "2024-05-30",
"labourHour": "8"
},
{
"empId": 16781,
"empNumber": "text_003",
"projectId": "100123",
"projectCode": "00123TE",
"manpowerType": 2,
"manpowerDate": "2024-05-30",
"labourRatio": "31.1"
}
]
}'
请求成功返回结果
{
"code": 200,
"msg": "操作成功"
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/project/employee/detail/batchCreate
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【新增员工所属项目组人力详情接口 or 新增组织部门接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| empProjectList | 是 | List | 要写入的「员工所属项目组」数据集合 |
| empProjectList.empId | 是 | number | 员工ID |
| empProjectList.empNumber | 否 | string | 员工工号 |
| empProjectList.projectId | 是 | number | 项目组id |
| empProjectList.projectCode | 否 | string | 项目组编码 |
| empProjectList.manpowerType | 是 | number | 填报类型 1:工时（日）2:人力占比（月） |
| empProjectList.manpowerDate | 是 | string | 填报日期 |
| empProjectList.labourHour | 否 | string | 工时（日） |
| empProjectList.labourRatio | 否 | string | 人力占比（月） |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 |
删除员工项目组人力
接口说明：通过该接口可删除人员项目组人力
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v1/project/employee/detail/batchDelete?entCode=0f2673af30d55d2e8b20298202ca326f&apiCode=27a136d77843c603720026bc4c1c6999×tamp=1241234&nonce=12&sign=12' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data-raw '{
"empProjectList": [
{
"empId": 12345,
"empNumber": "text_001",
"projectId": "100123",
"projectCode": "00123TE",
"manpowerType": 1,
"manpowerDate": "2024-05-30"
},
{
"empId": 16781,
"empNumber": "text_003",
"projectId": "100123",
"projectCode": "00123TE",
"manpowerType": 2,
"manpowerDate": "2024-05-30"
}
]
}'
请求成功返回结果
{
"code": 200,
"msg": "操作成功"
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/project/employee/detail/batchDelete
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【变更组织部门状态接口 or 删除员工所属项目组人力详情接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| empProjectList | 是 | List | 要写入的「员工所属项目组」数据集合 |
| empProjectList.empId | 是 | number | 员工ID |
| empProjectList.empNumber | 否 | string | 员工工号 |
| empProjectList.projectId | 是 | number | 项目组id |
| empProjectList.projectCode | 否 | string | 项目组编码 |
| empProjectList.manpowerType | 是 | number | 填报类型 1:工时（日）2:人力占比（月） |
| empProjectList.manpowerDate | 是 | string | 填报日期 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 |
获取培训相关字段信息
接口说明：通过该接口可获取培训相关字段信息
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v1/training/employee/training/fields?entCode=933c37e1cc94d06f2d043d8170456e9f&apiCode=58d97100bba3bfb080c7b41655c85b4b×tamp=121414&nonce=141412&sign=1214214' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
请求成功返回结果
{
"code": 200,
"msg": "",
"data": {
"bizs": [
{
"biz": "", // 分组biz
"modelId": 0, // 分组id，字段分组的唯一标识
"title": "", // 分组名称，预制分组名称有(学习项目、线上课、考试、学习地图、项目培训班)
"fieldList": [ // 分组下的字段集合
{
"fieldName": "", // 字段唯一标识、DF_开头的是自定义字段
"label": "", // 字段名称
"type": 2, // 字段类型 1-单行文本、2-日期、3-数字、4-是非、5-选项、11-多行文本
"enabled": true, // 字段启用状态
"required": true, // 字段是否必填
"options": null // 如果是选项、是非类型的字段，选项值列表
},
{
"fieldName": "",
"label": "",
"type": 5,
"enabled": true,
"required": false,
"options": [
{
"id": 1,
"name": "选项1"
},
{
"id": 2,
"name": "选项2"
},
{
"id": 3,
"name": "选项3"
}
]
}
]
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/training/employee/training/fields
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工培训信息字段】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
无
响应体 Response Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| code | 否 | Integer | 响应状态码 |
| msg | 否 | String | 响应消息，默认值为空 |
| data | 否 | Object | 培训信息字段结果 |
| └bizs | 否 | Array | 培训信息的分组集合 |
| └└biz | 否 | String | 分组biz，字段分组的唯一标识 |
| └└modelId | 否 | Long | 分组ID |
| └└title | 否 | String | 分组名称，预制分组名称有(学习项目、线上课、考试、学习地图、项目培训班) |
| └└fieldList | 否 | Array | 分组下的字段集合 |
| └└└fieldName | 否 | String | 字段唯一标识，DF_开头的是自定义字段 |
| └└└label | 否 | String | 字段名称 |
| └└└type | 否 | Integer | 字段类型：1-单行文本、2-日期、3-数字、4-是非、5-选项、11-多行文本 |
| └└└enabled | 否 | Boolean | 字段启用状态 |
| └└└required | 否 | Boolean | 字段是否必填 |
| └└└options | 否 | Array | 如果是选项或是非类型的字段，选项值列表 |
| └└└└id | 否 | Integer | 选项ID |
| └└└└name | 否 | String | 选项名称 |
新增员工培训信息接口
接口说明：通过该接口可新增员工培训信息
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v1/training/employee/training/add?entCode=933c37e1cc94d06f2d043d8170456e9f&apiCode=58d97100bba3bfb080c7b41655c85b4b×tamp=121414&nonce=141412&sign=1214214' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data '{
"source": 1,
"trainingData": [
{
"employeeId": 75720061,
"bizValues": [
{
"biz": "training",
"modelId": 107234,
"dataList": [
{
"thirdBizId": 201,
"fieldValues": [
{
"fieldName": "learning_item_name",
"fieldValue": "恩格斯思想"
},
{
"fieldName": "first_learning_time",
"fieldValue": "2024-06-01"
},
{
"fieldName": "last_learning_time",
"fieldValue": "2024-07-29"
},
{
"fieldName": "learning_item_status",
"fieldValue": 1
},
{
"fieldName": "is_qualified",
"fieldValue": 2
},
{
"fieldName": "detail_link",
"fieldValue": ""
},
{
"fieldName": "project_feature",
"fieldValue": 1
},
{
"fieldName": "training_create_time",
"fieldValue": "2024-06-01 00:00:00"
},
{
"fieldName": "training_start_time",
"fieldValue": "2024-06-01 00:00:00"
},
{
"fieldName": "training_end_time",
"fieldValue": "2024-08-28 00:00:00"
},
{
"fieldName": "learning_rate",
"fieldValue": 50.67
},
{
"fieldName": "learning_duration",
"fieldValue": 23.4
}
]
}
]
},
{
"biz": "online_course",
"modelId": 120891,
"dataList": [
{
"thirdBizId": 201,
"fieldValues": [
{
"fieldName": "course_name",
"fieldValue": "思想品德"
},
{
"fieldName": "learning_type",
"fieldValue": 2
},
{
"fieldName": "training_start_time",
"fieldValue": "2024-07-11 12:00:00"
},
{
"fieldName": "training_end_time",
"fieldValue": "2024-07-19 13:00:00"
},
{
"fieldName": "learning_status",
"fieldValue": 1
},
{
"fieldName": "learning_rate",
"fieldValue": 30.55
}
]
}
]
},
{
"biz": "training_exam",
"modelId": 120892,
"dataList": [
{
"thirdBizId": 202,
"fieldValues": [
{
"fieldName": "exam_name",
"fieldValue": "期中"
},
{
"fieldName": "join_time",
"fieldValue": "2024-06-21 00:00:00"
},
{
"fieldName": "training_start_time",
"fieldValue": "2024-06-21 00:00:00"
},
{
"fieldName": "exam_status",
"fieldValue": 2
},
{
"fieldName": "last_hand_time",
"fieldValue": "2024-07-01 11:00:00"
},
{
"fieldName": "last_pass_time",
"fieldValue": "2024-07-01 11:00:00"
},
{
"fieldName": "exam_points",
"fieldValue": 90.67
},
{
"fieldName": "acquire_credit",
"fieldValue": 2.22
},
{
"fieldName": "acquire_credentials",
"fieldValue": 1
}
]
}
]
}
]
}
]
}'
请求成功返回结果
{
"code": 200,
"msg": ""
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/training/employee/training/add
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【添加员工培训信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| source | 是 | Integer | 来源: 酷学院传1、授课学堂传2 |
| trainingData | 是 | Array | 培训信息数据列表，数组长度不超过200 |
| └employeeId | 是 | Long | 员工id，不能为空 |
| └bizValues | 是 | Array | 员工培训信息分组列表 |
| └└biz | 是 | String | 分组唯一标记，不能为空 |
| └└modelId | 是 | Long | 分组id，不能为空 |
| └└dataList | 是 | Array | 分组明细数据列表，不能为空 |
| └└└thirdBizId | 是 | Long | 培训分组明细数据唯一id，不能为空 |
| └└└fieldValues | 是 | Array | 明细字段值集合，不能为空 |
| └└└└fieldName | 是 | String | 字段唯一标记，不能为空 |
| └└└└fieldValue | 是 | Object | 字段值，不能为空 |
响应体 Response Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| code | 否 | Integer | 响应状态码 200表示成功 |
| msg | 否 | String | 响应消息，默认值为空 |
更新员工培训信息
接口说明：通过该接口可更新员工培训信息
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v1/training/employee/training/update?entCode=933c37e1cc94d06f2d043d8170456e9f&apiCode=58d97100bba3bfb080c7b41655c85b4b×tamp=121414&nonce=141412&sign=1214214' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data '{
"source": 1,
"trainingData": [
{
"employeeId": 75720061,
"bizValues": [
{
"biz": "training",
"modelId": 107234,
"dataList": [
{
"thirdBizId": 201,
"fieldValues": [
{
"fieldName": "learning_item_name",
"fieldValue": "恩格斯的思想"
},
{
"fieldName": "first_learning_time",
"fieldValue": "2024-06-02"
},
{
"fieldName": "learning_rate",
"fieldValue": 52.33
},
{
"fieldName": "learning_duration",
"fieldValue": 23.43
}
]
}
]
}
]
}
]
}'
请求成功返回结果
{
"code": 200,
"msg": ""
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/training/employee/training/update
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【更新员工培训信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| source | 是 | Integer | 来源: 酷学院传1、授课学堂传2 |
| trainingData | 是 | Array | 培训信息数据列表，数组长度不超过200 |
| └employeeId | 是 | Long | 员工id，不能为空 |
| └bizValues | 是 | Array | 员工培训信息分组列表 |
| └└biz | 是 | String | 分组唯一标记，不能为空 |
| └└modelId | 是 | Long | 分组id，不能为空 |
| └└dataList | 是 | Array | 分组明细数据列表，不能为空 |
| └└└thirdBizId | 是 | Long | 培训分组明细数据唯一id，不能为空 |
| └└└fieldValues | 是 | Array | 明细字段值集合，不能为空 |
| └└└└fieldName | 是 | String | 字段唯一标记，不能为空 |
| └└└└fieldValue | 是 | Object | 字段值，不能为空 |
响应体 Response Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| code | 否 | Integer | 响应状态码 200表示成功 |
| msg | 否 | String | 响应消息，默认值为空 |
删除员工培训信息
接口说明：通过该接口可更新员工培训信息
请求示例
curl --location 'https://api.mokahr.com/api-platform/hcm/oapi/v1/training/employee/training/delete?entCode=933c37e1cc94d06f2d043d8170456e9f&apiCode=58d97100bba3bfb080c7b41655c85b4b×tamp=121414&nonce=141412&sign=1214214' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--data '{
"source": 1,
"trainingData": [
{
"employeeId": 75720061,
"bizValues": [
{
"biz": "training",
"modelId": 107234,
"dataList": [
{
"thirdBizId": 201
}
]
}
]
}
]
}'
请求成功返回结果
{
"code": 200,
"msg": ""
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/training/employee/training/delete
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【删除员工培训信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明 https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| source | 是 | Integer | 来源: 酷学院传1、授课学堂传2 |
| trainingData | 是 | Array | 培训信息数据列表，数组长度不超过200 |
| └employeeId | 是 | Long | 员工id，不能为空 |
| └bizValues | 是 | Array | 员工培训信息分组列表 |
| └└biz | 是 | String | 分组唯一标记，不能为空 |
| └└modelId | 是 | Long | 分组id，不能为空 |
| └└dataList | 是 | Array | 分组明细数据列表，不能为空 |
| └└└thirdBizId | 是 | Long | 培训分组明细数据唯一id，不能为空 |
响应体 Response Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| code | 否 | Integer | 响应状态码 200表示成功 |
| msg | 否 | String | 响应消息，默认值为空 |
假勤接口API
单人打卡接口（写入）
请求示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/clock/add?entCode=70c29b767f515f3c3149b6005c181d9f&apiCode=4105c3052510b8181344a1bd3f404176&nonce=1902×tamp=1650628596&sign=123' \
--header 'Authorization: Basic NzBjMjliNzY3ZjUxNWYzYzMxNDliNjAwNWMxODFkOWY6' \
--header 'Content-Type: application/json' \
--data-raw '{
{
"employeeUniqueIdentifier": "000515",
"checkTime": 1650585312,
"uniqueIdentifierType":2,
"locationMethod":"GPS打卡",
"address":"四川省成都市崇州市",
"longitude":"103.741883",
"latitude":"30.629290",
"outsideClock":true,
"attachment":"http://sample.png",
"deviceId":"sjs2624",
"description":"打卡示例"
}
}'
用户传递一个人的打卡信息，该人即可打卡成功
注意：
Step1.此接口不会覆盖打卡数据，如果时间重复了会过滤;
Step2.每个员工可传入多条打卡记录，系统考勤计算会自动处理
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/clock/add
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【单人打卡接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| employeeUniqueIdentifier | String | 是 | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | int | 是 | 枚举类型0:员工id1 :公司邮箱 2 :员工工号3 :钉钉userid 4 :飞书userid（user_id）5 :微信userid（明文） |
| checkTime | Long | 是 | 打卡时间，（注意：精确到秒） |
| locationMethod | String | 否 | 打卡方式 |
| address | String | 否 | 打卡地址 |
| longitude | String | 否 | 经度，（注意：使用火星坐标系GCJ02） |
| latitude | String | 否 | 纬度，（注意：使用火星坐标系GCJ02） |
| outsideClock | Boolean | 否 | 是否外勤 |
| attachment | String | 否 | 打卡照片url，可直接访问 |
| deviceId | String | 否 | 打卡设备号 |
| description | String | 否 | 备注 |
返回结果
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| code | Long | |
| msg | String | |
| data | object |
多人打卡接口（写入）
参数示例
curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/clock/batchAdd?entCode=70c29b767f515f3c3149b6005c181d9f&apiCode=4105c3052510b8181344a1bd3f404176&nonce=1902×tamp=1650628596&sign=123' \
--header 'Authorization: Basic 您的apiKey的Base64' \
--header 'Content-Type: application/json' \
--data-raw '{
[
{
"employeeUniqueIdentifier": "000515",
"checkTime": 1650585314,
"uniqueIdentifierType":2,
"locationMethod":"GPS打卡",
"address":"四川省成都市崇州市",
"longitude":"103.741883",
"latitude":"30.629290",
"outsideClock":true,
"attachment":"http://sample.png",
"deviceId":"sjs2624",
"description":"打卡示例"
},
{
"employeeUniqueIdentifier": "000515",
"checkTime": 1650585312,
"uniqueIdentifierType":2,
"locationMethod":"GPS打卡",
"address":"四川省成都市崇州市",
"longitude":"103.741883",
"latitude":"30.629290",
"outsideClock":true,
"attachment":"http://sample.png",
"deviceId":"sjs2624",
"description":"打卡示例"
}
]
}'
用户传递多人的打卡信息，多人即可打卡成功
注意：
Step1.此接口不会覆盖打卡数据，如果时间重复了会过滤;
Step2.每个员工可传入多条打卡记录，系统考勤计算会自动处理
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/clock/batchAdd
请求频率：1次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【多人打卡接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Array<Object> | 是 | 打卡员工列表/数组 对象限制<=200 | |
| └employeeUniqueIdentifier | String | 是 | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| └uniqueIdentifierType | int | 是 | 枚举类型0:员工id1 :公司邮箱 2 :员工工号3 :钉钉userid 4 :飞书userid（user_id）5 :微信userid（明文） |
| └checkTime | Long | 是 | 打卡时间，（注意：精确到秒） |
| └locationMethod | String | 否 | 打卡方式 |
| └address | String | 否 | 打卡地址 |
| └longitude | String | 否 | 经度，（注意：使用火星坐标系GCJ02） |
| └latitude | String | 否 | 纬度，（注意：使用火星坐标系GCJ02） |
| └outsideClock | Boolean | 否 | 是否外勤 |
| └attachment | String | 否 | 打卡照片url，可直接访问 |
| └deviceId | String | 否 | 打卡设备号 |
| └description | String | 否 | 备注 |
返回结果
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| code | Long | |
| msg | String | |
| data | object |
打卡信息数据接口
参数示例
{
"pageSize": 50,
"pageNum": 1
}
员工打卡信息查询接口，支持条件查询以及分页
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/absence/clock/search
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工打卡信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组 |
| startDate | 否 | String | 打卡时间的查询开始时间, "yyyy-MM-dd HH:mm:ss" |
| endDate | 否 | String | 打卡时间的查询结束时间, "yyyy-MM-dd HH:mm:ss" |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| pageNum | int | 当前页数 | |
| pageSize | int | 页大小 | |
| total | int | 总记录条数 | |
| list | Array<Json> | 见下面list |
返回结果data.list说明
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| employeeId | bigint(20) | 员工id |
| clockInTime | datetime | 打卡时间 |
| sourceId | varchar(45) | 打卡来源id |
| sourceType | tinyint(4) | 打卡来源 1: 导入2: 钉钉打卡3: 移动端打卡4: 补卡5: 接口同步6: 下班系统自动打卡7: 上班系统自动打卡8: 天敏考勤机9: 中控云考勤机10: 企业微信11: 飞书打卡12: 钉钉签到13: 管理员修正 |
| address | varchar(500) | 打卡地址 |
| locationMethod | varchar(45) | 定位方式，文本 e.g. 微信 |
| timeResult | varchar(45) | 打卡结果 |
| locationResult | varchar(45) | 定位结果 |
| isOutsideClock | tinyint(1) | 外勤打卡 0:否, 1:是 |
| clockType | varchar(45) | 打卡类型 |
| deviceId | varchar(45) | 打卡设备 |
考勤结果数据接口
接口说明：通过此接口，可以查询员工每日的考勤结果信息（迟到、早退、旷工等）
参数示例
{
"pageNum": 1,
"pageSize": 100,
"startDate": "2023-06-26",
"endDate": "2023-06-26",
"employeeIds": [
75767506
]
}
员工考勤信息查询接口，支持条件查询以及分页
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/absence/attendance/search
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工考勤结果】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIds | 是 | Array<Long> | 员工ID列表/数组 |
| startDate | 是 | String | 考勤日期查询开始日期, "yyyy-MM-dd" |
| endDate | 是 | String | 考勤日期查询结束日期, "yyyy-MM-dd" |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| pageNum | int | 当前页数 | |
| pageSize | int | 页大小 | |
| total | int | 总记录条数 | |
| list | Array<Json> | 见下面list |
返回结果data.list说明
| 字段 | 字段类型 | 描述 |
|---|---|---|
| employeeId | bigint(20) | 员工ID |
| realName | varchar(45) | 员工姓名 |
| employeeNo | varchar(100) | 员工工号 |
| clockInDate | date | 考勤日期 |
| dayType | tinyint(4) | 日历类型 1:工作日, 2:公休日, 3:节假日 |
| clockInTime | datetime | 签到时间 |
| clockOutTime | datetime | 签退时间 |
| isLeaveEarly | tinyint(4) | 是否早退 0:否, 1:是 |
| isAbsent | tinyint(4) | 是否旷工 0:否, 1:是 |
| isClockIn | tinyint(4) | 是否缺卡 0:否, 1:是 |
| isLate | tinyint(4) | 是否迟到 0:否, 1:是 |
| isNeedClock | tinyint(4) | 是否考勤 0:否, 1:是 |
| lateTime | int(11) | 迟到时长-分钟 |
| absentTime | decimal(4,2) | 旷工时长-小时 |
| absentDay | decimal(4,2) | 旷工时间-天 |
| leaveEarlyTime | int(11) | 早退时长-分钟 |
| ruleId | bigint(20) | 考勤规则ID |
| ruleName | varchar(100) | 考勤规则名称 |
| attendanceType | tinyint(4) | 考勤类型 1:固定班, 2:不打卡, 3:排班 |
| workingHoursInterval | varchar(20) | 工作时间区间, e.g. 09:00~18:00 |
| restTimeInterval | varchar(200) | 休息时间区间, e.g. 11:00~13:20;18:00~19:10 |
| workTime | int(11) | 打卡时长-分钟 |
| shiftId | bigint(20) | 班次ID |
| shiftName | varchar(255) | 班次名称 |
| abnormalTypeStatus | varchar(255) | 考勤异常类型状态id集合, e.g. 19025,4940,5941 |
| isLateStatus | bigint(20) | 迟到的考勤异常状态id |
| isLeaveEarlyStatus | bigint(20) | 早退的考勤异常状态id |
| isAbsentStatus | bigint(20) | 旷工的考勤异常状态id |
| isClockInStatus | bigint(20) | 缺卡的考勤异常状态id |
| freeWorkTimeShift | boolean | 当天是否是自由工时班次 |
| lackWorkTime | boolean | 是否日工时不足 |
| lackWorkTimeMinute | int(11) | 日工时不足分钟数 |
| lackWorkTimeStatus | bigint(20) | 日工时不足的考勤异常状态id |
加班信息数据接口
接口说明：通过此接口，可以查询员工加班记录信息（加班时间、加班类型等）
参数示例
{
"pageSize": 50,
"pageNum": 1
}
员工加班信息查询接口，支持条件查询以及分页
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/absence/work/overtime/search
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工加班信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组 |
| startTime | 否 | String | 加班时间查询开始时间, "yyyy-MM-dd" |
| endTime | 否 | String | 加班时间查询结束时间, "yyyy-MM-dd" |
| compensateType | 否 | int | 补偿方式1：加班费2：调休假 |
| overtimeType | 否 | int | 加班类型 可选值： 1：工作日加班2：公休日加班3：节假日加班 |
| flowStatus | 否 | Array |
审核状态 可选值： 1:审批中2：通过3：驳回4：撤回 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| pageNum | int | 当前页数 | |
| pageSize | int | 页大小 | |
| total | int | 总记录条数 | |
| list | Array<Json> | 见下面list |
返回结果data.list说明
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| employeeId | String | 员工ID |
| duration | int | 结算时长 |
| durationUnit | int | 单位 |
| status | int | 流程状态: 1审批中,2通过,3驳回,4撤回 |
| beginTime | datetime | 开始日期 |
| endTime | datetime | 结束日期 |
| beginPeriod | String | 开始时间 |
| endPeriod | String | 结束时间 |
| reason | String | 加班原因 |
| recallReason | String | 撤回原因 |
| overtimeType | int | 加班类型 1:工作日加班，2:公休日加班，3:节假日加班 |
| compensateType | int | 补偿方式 1:加班费, 2:调休假 |
| durationDay | int | 时长-天 |
| calculateType | int | 计算方式 1:按申请时长计算, 2:按打卡时长计算 |
| clockDuration | int | 实际打卡时长 |
| applyDuration | int | 申请时长 |
| flowInstanceId | String | 审批实例id |
出差信息数据接口
接口说明：通过此接口，可以查询员工出差记录信息（出差时间、出差城市等）
请求示例
curl --location --request GET 'https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/business/page/search?userName=您的邮箱地址&entCode=您的租户entCode&apiCode=您配置的open-apiCode×tamp=当前时间戳&nonce=任意随机值&sign=签名' \
--header 'Authorization: Basic 您的apiKey的Base64'\
--header 'Content-Type: application/json' \
--data-raw '{
"startDate":"2022-08-01",
"endDate":"2022-12-30",
"createStartTime":"2022-08-31 17:01:59",
"createEndTime":"2022-08-31 19:07:19",
"updateStartTime":null,
"updateEndTime":null,
"pageSize":100,
"pageNum":1,
"tripIds":[],
"uuidList":[],
"employeeNoList":[],
"telephoneList":[],
"officeEmailList":[]
}'
操作成功
{
"msg": "操作成功",
"code": 200,
"data": {
"pageNum": 1,
"pageSize": 100,
"total": 2,
"list": [
{
"tripId": "1014582238810996737",
"employeeId": 75695515,
"employeeName": "zpj",
"employeeNo": "PQT347",
"duration": 1.0,
"sourceId": 0,
"itineraries": [
{
"id": 19911,
"tripReason": "这同行人测试AAA",
"startDate": "2022-09-01 09:00:00",
"endDate": "2022-09-01 17:00:00",
"departureCity": "北京市",
"departureCityCode": "110000",
"destinationCity": "卡通贝拉",
"destinationCityCode": "AGO@卡通贝拉",
"tripCostDepartment": "103086",
"transportType": -1,
"type": 2,
"hotelReserved": true,
"associates": [
108893
],
"attrs": [],
"eventType": 2,
"operationTime": "2022-08-31 19:17:49",
"operator": 75695515
}
]
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/business/page/search
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供，或者由Moka系统""对外设置"中显示 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工出差信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| uuidList | 否 | Array<Long> | 员工ID列表/数组，长度不超过200 |
| employeeNoList | 否 | Array<String> | 员工工号列表/数组 |
| telephoneList | 否 | Array<String> | 手机号列表/数组 |
| officeEmailLest | 否 | Array<String> | 公司邮箱列表/数组 |
| tripIds | 否 | Array<String> | 推送接口的出差流程的数据唯一id |
| startDate | 是 | String | 查询开始日期, "yyyy-MM-dd"，时间不超过180天 |
| endDate | 是 | String | 查询结束日期,"yyyy-MM-dd"，时间不超过180天 |
| createStartTime | 否 | String | 查询创建开始日期, "yyyy-MM-dd HH:mm:ss"，时间不超过180天 |
| createEndTime | 否 | String | 查询创建结束日期,"yyyy-MM-dd HH:mm:ss"，时间不超过180天 |
| updateStartTime | 否 | String | 查询修改开始日期, "yyyy-MM-dd HH:mm:ss"，时间不超过180天 |
| updateEndTime | 否 | String | 查询修改结束日期,"yyyy-MM-dd HH:mm:ss"，时间不超过180天 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | Array | 返回结果的业务数据内容 | |
| data.total | Long | 总条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| tripId | Long | 出差记录的唯一标识 | 用于推送数据以后，客户反查 |
| employeeId | int | 出差人的员工ID | |
| employeeNo | String | 出差人的员工工号 | |
| employeeName | String | 出差人的员工姓名 | |
| duration | decimal | 出差时长，可以是0.5天 | |
| sourceIdString | String | 审批实例ID | |
| itineraries | Array | 具体的申请单内容 | |
| └id | int | 出差信息的一种标识 | |
| └tripReason | String | 出差事由 | |
| └startDate | String | 出差的开始时间 | 精确到天 |
| └endDate | String | 出差的结束时间 | 精确到天 |
| └departureCity | String | 出发城市的名称 | |
| └departureCityCode | String | 出发城市的系统编码 | |
| └destinationCity | String | 目的地城市的名称 | |
| └destinationCityCode | String | 目的地城市的系统编码 | |
| └tripCostDepartment | String | 成本部门 | |
| └transportType | int | 出差工具 可选值 1：飞机2：火车-1：未选择 |
|
| └type | int | 1：单程2：往返 |
|
| └hotelReserved | boolean | 是否预定酒店 枚举值： 0: 否1: 是Moka People系统中需要设置启用该字段 |
|
| └associates | Array<Long> | 同行人，数组格式 | |
| └attrs | Array | 租户在Moka People中自定义的字段 | |
| └eventType | int | 事件类型2：通过 4：已撤销 5：删除 |
|
| └operationTime | String | 出差申请单的操作时间 | |
| └operatior | Long | 出差申请单的操作人，员工ID |
出差信息添加接口（写入）
接口说明：通过此接口，可以新增员工出差记录信息（出差时间、出差地点等）。可写入最近半年的出差记录
请求实例：
{
"thirdPartApplyId":"thirdout87777test122",
"employeeUniqueIdentifier":75710833,
"uniqueIdentifierType":0,
"tripReason":"外部导入添加",
"startDate":1663651901000,
"endDate":1663651901000,
"departureCityName":"北京市",
"destinationCityName":"上海市",
"associates":[],
"recordForAssociates":0,
"others":"{\"DF_54300669024e41afab60f07fb560599e\": \"自定义\"}"
}
出差信息添加接口提供三种操作：新增/更新/撤销。限制添加半年前的出差记录
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/business/thirdPartTripAdd
请求频率：1次/秒/企业，60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【出差记录添加信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 类型 | 必填 | 备注 |
|---|---|---|---|
| thirdPartApplyId | String | 是 | 外部审批单唯一标识ID，最大32 |
| employeeUniqueIdentifier | String | 是 | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | int | 是 | 枚举类型0:员工id1 :公司邮箱 2 :员工工号3 :钉钉userid 4 :飞书userid（user_id）5 :微信userid（明文） |
| tripReason | String | 是 | 写入字节最长8000， 汉字：3字节，标点符号：2字节 |
| startDate | Long | 是 | 开始时间，时间戳(ms），如果设置了出差时间不允许重复，会校验多条记录时间是否重叠 |
| endDate | Long | 是 | 结束时间，时间戳(ms），如果设置了出差时间不允许重复，会校验多条记录时间是否重叠 |
| departureCityName | String | 是 | 出发城市 城市名称需要和Moka People的匹配，目前Moka People提供城市数据 |
| departureCountry | String | 否 | 出发国家，默认中国 |
| destinationCityName | String | 是 | 目标城市 城市名称需要和Moka People的匹配，目前Moka People提供城市数据 |
| destinationCountry | String | 否 | 目的国家，默认中国 |
| associates | Array | 否 | 同行人[id]，数组最长200 |
| └associate | String | 同行人唯一标识ID 传入标识需同uniqueIdentifierType指定一致 | |
| recordForAssociates | int | 否 | 是否为同行人创建出差记录 可选值： 0：否1：是默认： 0 |
| others | String | 否 | 自定义字段 json格式（自定义字段需要在Moka People侧先定义字段，传入格式与Moka People沟通） |
| startDateType | String | 否 | 行程开始时间类型，出差单位为天，非必填传枚举：AM/PM，用于匹配出差是上午还是下午；未填将以传入的时间戳12点之前为上午，12点之后为下午；出差单位为小时，该字段为必填，传字符串格式：HH:mm |
| endDateType | String | 否 | 行程结束时间类型，出差单位为天，非必填传枚举：AM/PM，用于匹配出差是上午还是下午；未填将以传入的时间戳12点之前为上午，12点之后为下午；出差单位为小时，该字段为必填，传字符串格式：HH:mm |
| flowStatus | Integer | 否 | 1:审批中 2:通过 3:已驳回 4:撤回； 默认:2 |
| hotelReserved | int | 否 | 是否预定酒店 枚举值： 0: 否1: 是Moka People系统中需要设置启用该字段 |
| transportType | String | 否 | 出差工具 可选值 飞机 火车 |
| costDepartmentInfo | object | 否 | 成本部门，四选择一 |
| └departmentIdType | int | 否 | 成本部门类型 可选值： 0：Moka People部门id1：钉钉部门id2：企业微信部门id3：飞书部门id |
| └departmentId | String | 否 | 部门唯一标识ID，由departmentIdType指定，需要对应 |
| tripType | int | 否 | 枚举值1: 单程2: 往返 |
响应体
响应实例：
{
"code": 0,
"msg": "成功",
"data": [
{
"tripId": 1012755350891266048,
"thirdPartApplyId": "thirdout87777test122"
}
]
}
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Array | 返回结果的数据内容 | |
| └tripId | Long | 记录的唯一标识 | |
| └thirdPartApplyId | String | 外部申请单id |
出差信息更新接口（写入）
接口说明：通过此接口，可以更新员工出差记录信息（出差时间、出差地点等）。可更新最近半年创建的出差记录
请求实例：
{
"thirdPartApplyId":"thirdout87777test122",
"employeeUniqueIdentifier":75710833,
"uniqueIdentifierType":0,
"tripReason":"外部导入添加",
"startDate":1663651901000,
"endDate":1663651901000,
"departureCityName":"北京市",
"destinationCityName":"上海市",
"associates":[],
"recordForAssociates":0,
"others":"{\"DF_54300669024e41afab60f07fb560599e\": \"自定义\"}"
}
出差信息添加接口提供三种操作：新增/更新/撤销，限制更新半年前创建的出差记录，后续迭代可能加入规则配置
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/business/thirdPartTripUpdate
请求频率：1次/秒/企业，60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【出差记录更新信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 类型 | 必填 | 备注 |
|---|---|---|---|
| thirdPartApplyId | String | 是 | 外部申请单id，最大32 |
| employeeUniqueIdentifier | String | 是 | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | int | 是 | 枚举类型0:员工id1 :公司邮箱 2 :员工工号3 :钉钉userid 4 :飞书userid（user_id）5 :微信userid（明文）） |
| tripReason | String | 否 | 最大8000 |
| startDate | Long | 是 | 开始时间，时间戳(ms），如果设置了出差时间不允许重复，会校验多条记录时间是否重叠 |
| endDate | Long | 是 | 结束时间，时间戳(ms），如果设置了出差时间不允许重复，会校验多条记录时间是否重叠 |
| flowStatus | Integer | 否 | 1:审批中 2:通过 3:已驳回 4:撤回； 默认:2 |
| departureCityName | String | 是 | 出发城市 城市名称需要和Moka People的匹配，目前Moka People提供城市数据 |
| departureCountry | String | 否 | 出发国家 默认中国 |
| destinationCityName | String | 是 | 目标城市 城市名称需要和Moka People的匹配，目前Moka People提供城市数据 |
| destinationCountry | String | 否 | 目的国家 默认中国 |
| associates | Array | 否 | 同行人[id]，最大200 |
| └associate | String | 同行人唯一标识ID | |
| recordForAssociates | int | 否 | 是否为同行人创建出差记录 可选值： 0：否1：是默认： 0 |
| others | String | 否 | 自定义字段 json格式（自定义字段需要在Moka People侧先定义字段，传入格式与Moka People沟通） |
| startDateType | String | 否 | 行程开始时间类型 枚举：AM/PM，用于匹配出差是上午还是下午；未填将以传入的时间戳12点之前为上午，12点之后为下午 |
| endDateType | String | 否 | 行程结束时间类型 枚举：AM/PM，用于匹配出差是上午还是下午；未填将以传入的时间戳12点之前为上午，12点之后为下午 |
| hotelReserved | int | 否 | 是否预定酒店 枚举值： 0: 否1: 是Moka People系统中需要设置启用该字段 |
| transportType | String | 否 | 出差工具 可选值 飞机 火车 |
| costDepartmentInfo | object | 否 | 成本部门，四选择一 |
| └departmentIdType | int | 否 | 成本部门类型 可选值： 0：Moka People部门id1：钉钉部门id2：企业微信部门id3：飞书部门id |
| └departmentId | String | 否 | 部门唯一标识ID，由departmentIdType指定，需要对应 |
| tripType | int | 否 | 1: 单程2: 往返 |
响应体
响应实例：
{
"code": 0,
"msg": "成功",
"data": null
}
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 |
出差信息撤回接口（写入）
接口说明：通过此接口，可以撤回员工出差记录信息。可撤回最近半年创建的出差记录 通过该接口会撤回对应的出差记录，相关出差记录状态将改为【撤销】状态
请求实例：
{
"thirdPartApplyId":"third777777"
}
出差信息添加接口提供三种操作：新增/更新/撤销。限制撤回半年前创建的出差记录，后续迭代可能加入规则配置。
通过该接口会撤回对应的出差记录，相关出差记录状态将改为【撤销】状态
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/business/thirdPartTripCancel
请求频率：1次/秒/企业，60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【出差记录撤回信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | String | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| thirdPartApplyId | String | 必须 | 外部申请单id |
响应体
响应实例：
{
"code": 0,
"msg": "成功",
"data": null
}
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 |
外出信息数据接口
接口说明：通过此接口，可以查询员工外出记录信息（外出时间、外出原因等）
参数示例
{
"pageSize": 50,
"pageNum": 1
}
员工外出信息查询接口，支持条件查询以及分页
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/absence/outting/search
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工外出信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组 |
| outtingId | 否 | Long | 外出记录唯一表示 |
| flowInstanceId | 否 | Long | 审批编号(通过审批创建的外出记录有审批编号) |
| startTime | 否 | String | 查询开始时间, 格式： yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| endTime | 否 | String | 查询结束时间, 格式： yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| flowStatus | 否 | Array |
审核状态 可选值： 1：审批中2：通过3：驳回4：撤回 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| pageNum | int | 当前页数 | |
| pageSize | int | 页大小 | |
| total | int | 总记录条数 | |
| list | JsonArray | 见下面list |
返回结果data.list说明
| 字段 | 类型 | 字段描述 |
|---|---|---|
| employeeId | bigint(20) | 员工ID |
| outtingId | bigint(20) | 外出记录ID |
| startTime | datetime | 外出开始时间，格式：yyyy-MM-dd HH:mm:ss |
| endTime | datetime | 外出结束时间，格式：yyyy-MM-dd HH:mm:ss |
| timeLength | decimal(11,2) | 外出时长，单位：分钟 |
| workTimeLength | decimal(7,2) | 工作时段外出时长，单位：小时 |
| flowStatus | tinyint(4) | 审核状态 可选值： 1：审批中2：通过3：驳回4：撤回 |
| reason | varchar(8000) | 外出原因 |
| workflowId | String | 审批实例ID |
外出信息添加接口（写入）
接口说明：第三方通过外出记录创建接口，创建外出记录回写数据
参数示例
{
"thirdPartApplyId": "thirdPartApplyId01",
"employeeUniqueIdentifier": 75710833,
"uniqueIdentifierType": 0,
"startDate": "2022-12-20",
"endDate": "2022-12-21",
"startTime": "11:00",
"endTime": "12:00",
"reason": "外出原因"
}
外出回写接口提供三种操作：新增/更新/撤销。限制更新和撤销添加半年前的外出记录
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/outting/syncThirdOutting
请求频率：1次/秒/企业，60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【外出记录添加接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | String | 是 | 外部审批单唯一标识ID，最大32 |
| employeeUniqueIdentifier | String | 是 | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | int | 是 | 枚举类型0:员工id1 :公司邮箱 2 :员工工号3 :钉钉userid 4 :飞书userid（user_id）5 :微信userid（明文） |
| startDate | String | 是 | 日期：yy-mm-dd，外出开始日期 |
| endDate | String | 是 | 日期：yy-mm-dd，外出结束日期 |
| startTime | String | 是 | 外出开始时间 HH:MM |
| endTime | String | 是 | 外出结束时间 HH:MM |
| flowStatus | Integer | 否 | 1:审批中 2:通过 3:已驳回 4:撤回； 默认:2 |
| reason | String | 是 | 外出原因，字符限制8000 |
响应示例
json { "code": 200, "msg": "操作成功", "data": "thirdPartApplyId01" }响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| thirdPartApplyId | String | 外部审批单唯一标识ID |
外出信息更新接口（写入）
接口说明：第三方通过外出记录创建接口，创建外出记录回写数据
参数示例
{
"thirdPartApplyId": "thirdPartApplyId01",
"employeeUniqueIdentifier": 75710833,
"uniqueIdentifierType": 0,
"startDate": "2022-12-20",
"endDate": "2022-12-21",
"startTime": "11:00",
"endTime": "12:00",
"reason": "外出原因"
}
外出回写接口提供三种操作：新增/更新/撤销。限制更新和撤销添加半年前的外出记录
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/outting/updateThirdOutting
请求频率：1次/秒/企业，60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【外出记录更新接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | String | 是 | 外部审批单唯一标识ID，最大32 |
| employeeUniqueIdentifier | String | 否 | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | int | 否 | 枚举类型0:员工id1 :公司邮箱 2 :员工工号3 :钉钉userid 4 :飞书userid（user_id）5 :微信userid（明文） |
| startDate | String | 是 | 日期：yy-mm-dd，外出开始日期 |
| endDate | String | 是 | 日期：yy-mm-dd，外出结束日期 |
| flowStatus | Integer | 否 | 1:审批中 2:通过 3:已驳回 4:撤回； 默认:2 |
| startTime | String | 是 | 外出开始时间 HH:MM |
| endTime | String | 是 | 外出结束时间 HH:MM |
| reason | String | 否 | 外出原因，字符限制8000 |
响应示例
json { "code": 200, "msg": "操作成功" }响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 |
外出信息撤回接口（写入）
接口说明：第三方通过外出记录创建接口，创建外出记录回写数据
参数示例
{
"thirdPartApplyId": "thirdPartApplyId01"
}
外出回写接口提供三种操作：新增/更新/撤销。限制更新和撤销添加半年前的外出记录
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/outting/revokeThirdOutting
请求频率：1次/秒/企业，60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【外出记录撤回接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | String | 是 | 外部审批单唯一标识ID，最大32 |
响应示例
json { "code": 200, "msg": "操作成功" }响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 |
请假信息数据接口
接口说明：通过此接口，可以查询员工请假记录信息（请假时间、请假原因等）
参数示例
{
"startDate":"2022-01-19",
"endDate":"2022-12-19",
"pageSize":200
}
员工请假记录查询接口，支持条件查询以及分页
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/attendance/leave/records
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工请假信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| id | 否 | Long | 请假记录实例id，对应主动推送中的dataId |
| employeeUniqueIdentifiers | 否 | Array | 员工唯一标识列表/数组，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | 否 | int | 枚举类型0：员工id1：公司邮箱 2：员工工号3：钉钉userid 4 :飞书userid（user_id）5 :微信userid（明文）） |
| startDate | 否 | String | 请假时间查询开始日期, 格式： yyyy-MM-dd |
| endDate | 否 | String | 请假时间查询结束日期, 格式： yyyy-MM-dd |
| flowStatus | 否 | Array |
审核状态：0：已删除 1：审批中2：通过3：驳回4：撤回 |
| workFlowId | 否 | Long | moka请假审批单id |
| createStartTime | 否 | Long | 记录创建时间-查询开始时间戳 精确到秒 |
| createEndTime | 否 | Long | 记录创建时间-查询结束时间戳 精确到秒 |
| updateStartTime | 否 | Long | 记录更新时间-查询开始时间戳 精确到秒 |
| updateEndTime | 否 | Long | 记录更新时间-查询结束时间戳 精确到秒 |
| nextCursor | 否 | int | 分页标记，后续使用上一次查询时返回nextCursor |
| pageSize | 是 | int | 每页大小，不超过200 |
响应实例：
{
"code": 200,
"msg": "成功",
"data": {
"nextCursor": 2,
"hasMore": true,
"listWorkFlowRecordApi": [
{
"id": 85449,
"employeeNo": null,
"employeeName": null,
"flowInstanceId": "16770025",
"duration": 1.0000,
"durationUnit": 2,
"status": 2,
"absName": "事假",
"employeeId": 75710685,
"beginDate": "2022-09-21",
"endDate": "2022-09-21",
"beginPeriod": "AM",
"endPeriod": "PM",
"reason": "Moka原因",
"createTime": 1663751587,
"updateTime": 1663751667
}
]
}
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| hasMore | boolean | 是否有更多数据,true标识还有 | |
| nextCursor | int | 下一页标识，当hasMore为true时，下次查询传此nextCursor | |
| listWorkFlowRecordApi | Array | 见下面list | |
| └id | Long | 记录实例id，对应主动推送中的dataId | |
| └employeeNo | String | 员工moka的编号(未查询到员工时返回null) | |
| └employeeName | String | 员工名字(未查询到员工时返回null) | |
| └flowInstanceId | String | 审批流程id-当通过审批创建时该字段有值 | |
| └duration | decimal(11,4) | 请假时长(结算时长) | |
| └durationUnit | int | 时间单位（1：小时，2：天，3：分钟） | |
| └status | int | 流程状态：1：审批中2：通过3：驳回4：撤回 |
|
| └absName | String | 假期类型名称 | |
| └employeeId | Long | 员工id | |
| └beginDate | String | 开始时间，格式：yyyy-MM-dd | |
| └endDate | String | 结束时间，格式：yyyy-MM-dd | |
| └beginPeriod | String | 开始时间段 如9:00/AM/PM，当假期类型有特殊限制该字段为空 | |
| └endPeriod | String | 结束时间段 如9:00/AM/PM，当假期类型有特殊限制该字段为空 | |
| └reason | String | 请假原因 最长8000 | |
| └createTime | Long | 创建时间 精确到秒 | |
| └updateTime | Long | 更新时间 精确到秒 |
班次信息数据接口
接口说明：通过根据参数信息分页查询班次列表
参数示例
{
"shiftIdList":[101],
"shiftName":"测试班次",
"nextCursor":"1",
"pageSize":"20",
"startDate":"2023-01-01",
"endDate":"2023-01-30"
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/shift/records
请求频率：3次/秒/企业，60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【班次信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| shiftIdList | Array | 否 | 班次id列表 |
| shiftName | String | 否 | 班次名称 |
| updateStartTime | String | 否 | 更新时间查询开始时间, "yyyy-MM-dd HH:mm:ss"，时间不超过180天 |
| updateEndTime | String | 否 | 更新时间查询结束时间, "yyyy-MM-dd HH:mm:ss"，时间不超过180天 |
| nextCursor | int | 否 | 分页标记，后续使用上一次查询时返回nextCursor |
| pageSize | int | 否 | 每页大小，不超过200 |
响应示例
{
"code": 200,
"msg": "成功",
"data": {
"nextCursor": 2,
"hasMore": false,
"shiftRecordApiList": [
{
"shiftName": "测试",
"shiftId": 768561,
"shiftLevel": 1,
"shiftType": 1,
"status": 1,
"shiftCommutingTimes": 1,
"createTime": "2022-12-20 10:36:25",
"updateTime": "2022-12-20 10:36:25",
"manageList": [
{
"employeeId": 129343,
"employeeNo": "123456789",
"employeeName": "test-105"
}
],
"workLength": 9.0000,
"calculateDay": "1天",
"halfDateType": 1,
"halfDate": "14:00",
"shiftTimesList": [
{
"noClockOut": 0,
"startDayType": 1,
"endDayType": 1,
"startTime": "09:00",
"endTime": "18:00",
"sectionType": 1
},
{
"noClockOut": 0,
"startDayType": 1,
"endDayType": 1,
"startTime": "07:00",
"endTime": "13:30",
"sectionType": 4
}
]
}
]
}
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| hasMore | boolean | 是否有更多数据,true标识还有 | |
| nextCursor | int | 下一页标识，当hasMore为true时，下次查询传此nextCursor | |
| shiftRecordApiList | Array | 见下面list | |
| └shiftId | Long | 班次id | |
| └shiftName | String | 班次名称 | |
| └shiftLevel | int | 班次类型 （1：公共班次；2：个人班次） | |
| └shiftType | int | 班次时限（1：长期；2：临时） | |
| └status | int | 启用状态（ 0：未启用；1：启用） | |
| └shiftCommutingTimes | int | 上下班次数 （1：一次上下班；2:多次上下班） | |
| └createTime | String | 创建时间（yyyy-MM-dd HH:mm:ss） | |
| └updateTime | String | 更新时间（yyyy-MM-dd HH:mm:ss） | |
| └manageList | Array | 管理员列表 | |
| └employeeId | Long | 员工id | |
| └employeeNo | String | 员工工号 | |
| └employeeName | String | 员工姓名 | |
| └workLength | BigDecimal | 工作时长 | |
| └calculateDay | String | 工作时长计天数 | |
| └shiftTimesList | Array | 半天类型 (1：当日；2：次日；3：前一日) | |
| └noClockOut | int | 是否免打卡 (1：是；2：否) | |
| └startDayType | int | 开始时间类型 ( 1:当日，2：次日；3：当日) | |
| └endDayType | int | 结束时间类型 ( 1:当日，2：次日；3：当日) | |
| └startTime | String | 开始时间点 HH:mm | |
| └endTime | String | 结束时间点 HH:mm | |
| └sectionType | int | 时间段类型（1:工作时间 2：休息时间 3：打卡时间范围 4 上班打卡时间范围 5 下班打卡时间范围） |
排班信息数据接口
接口说明：第三方通过根据参数信息查询排班列表
参数示例
{
"employeeUniqueIdentifiers": [
28812,
28820,
28900,
28922,
28923,
28924,
],
"uniqueIdentifierType": 0,
"startDate": "2022-12-01 00:00:00",
"endDate": "2022-12-01 00:00:00",
"nextCursor": 1,
"pageSize": 10
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/schedule/records
请求频率：3次/秒/企业，60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工排班信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeUniqueIdentifiers | 否 | Array | 员工唯一标识列表/数组，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | 否 | int | 枚举类型0：员工id1：公司邮箱 2：员工工号3：钉钉userid 4 :飞书userid（user_id）5 :微信userid（明文）） |
| startDate | 否 | String | 查询开始日期, 格式： yyyy-MM-dd |
| endDate | 否 | String | 查询结束日期, 格式： yyyy-MM-dd |
| nextCursor | 否 | int | 分页标记，后续使用上一次查询时返回nextCursor |
| pageSize | 是 | int | 每页大小，不超过200 |
响应示例
{
"code": 200,
"msg": "成功",
"data": {
"nextCursor": null,
"hasMore": false,
"scheduleRecordList": [
{
"shiftName": "半天请假设置8～17",
"shiftId": 76833,
"employeeId": 29051,
"employeeName": "花木兰",
"employeeNo": "000016",
"date": "2022-12-01"
},
{
"shiftName": null,
"shiftId": 0,
"employeeId": 29025,
"employeeName": "打卡007",
"employeeNo": "DK007",
"date": "2022-12-01"
}
],
"errorData": [
28900,
28922,
28923,
28924
]
}
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| hasMore | boolean | 是否有更多数据,true标识还有 | |
| nextCursor | int | 下一页标识，当hasMore为true时，下次查询传此nextCursor | |
| scheduleRecordList | Array | 员工排班列表，详情见下面list | |
| └shiftId | Long | 班次id | |
| └shiftName | String | 班次名称 | |
| └employeeId | Long | 员工id | |
| └employeeName | String | 员工姓名 | |
| └employeeNo | String | 员工工号 | |
| └date | String | 考勤日期(yyyy-MM-dd) | |
| errorData | Array | 未找到的员工标识列表，对应请求参数的employeeUniqueIdentifiers |
员工最新出勤日报数据接口
接口说明：第三方通过根据参数信息查询员工最新出勤日报
参数示例
{
"employeeIds": [
75765012,
75733433,
75653024,
75653026,
75653059
],
"startDate": "2023-7-01",
"endDate": "2023-7-31",
"pageNum": 1,
"pageSize": 50
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/statistics/daily/page
请求频率：3次/秒/企业，180次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工最新出勤日报接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIds | 是 | Array | 员工ID集合 |
| startDate | 是 | String | 查询开始日期, 格式： yyyy-MM-dd |
| endDate | 是 | String | 查询结束日期, 格式： yyyy-MM-dd |
| nextCursor | 是 | int | 分页标记，后续使用上一次查询时返回nextCursor |
| pageSize | 是 | int | 每页大小，不超过50 |
响应示例
{
"code": 200,
"msg": "成功",
"data":
{
"nextCursor": 2,
"hasMore": true,
"list":
[
{
"workEndTime_4": "",
"workEndTime_5": "",
"workEndTime_6": "",
"legalHolidayActualOverTimeRestHour": 0,
"workEndTime_1": "2023-07-02 23:50:00",
"shiftOutTime": "2023-07-02 23:50:00",
"workEndTime_2": "",
"halfDayTime": "2023-07-02 23:00:00",
"attendanceRuleName": "demo",
"workEndTime_3": "",
"overworkApprovingApplyHours": 0.0,
"overworkActualHours": 0.0,
"patchClockInTimes": 0,
"businessTripApprovingHour": 0.0,
"clockOutSource": "",
"clockOutTime_4": "",
"clockOutTime_5": "",
"outWorkApprovingHour": 0.0,
"clockOutTime_2": "",
"clockOutTime_3": "",
"clockOutTime_6": "",
"overTimeClockOutTime": "",
"freeWorkTimeShift": false,
"clockInSource": "",
"clockOutAddress_2": "",
"clockOutAddress_1": "",
"statisticRuleName": "月报规则名称",
"shiftWorkHour": 8.0,
"missClockInCount_1": 0,
"missClockIn_2": false,
"overTimeClockInTime": "",
"absentMinutes_1": 480,
"missClockInCount_2": 0,
"missClockIn_3": false,
"absentMinutes_2": 0,
"applyPayOverTimeHour": 0.0,
"absentMinutes_3": 0,
"missClockIn_1": false,
"absentMinutes_4": 0,
"missClockInCount_5": 0,
"clockOutAddress_6": "",
"missClockIn_6": false,
"absentMinutes_5": 0,
"missClockInCount_6": 0,
"clockOutAddress_5": "",
"absentMinutes_6": 0,
"clockOutAddress_4": "",
"missClockInCount_3": 0,
"missClockIn_4": false,
"clockOutAddress_3": "",
"missClockInCount_4": 0,
"missClockIn_5": false,
"leaveRuleName": "发假休假规则",
"overworkApplyHours": 0.0,
"overtimeRuleName": "加班规则",
"businessTripDays": 0.0,
"clockOutTime_1": "",
"workingHoursInterval": "15:50~23:50",
"leaveEndTime": null,
"shiftHalfDayTime": "2023-07-02 23:00:00",
"departureCity": "",
"specialAttendance": "",
"employeeId": 75602674,
"businessTripApprovingDay": 0.0,
"clockInSourceType_1": "",
"destinationCity": "",
"clockInSourceType_2": "",
"clockInSourceType_5": "",
"clockInSourceType_6": "",
"clockInSourceType_3": "",
"clockInSourceType_4": "",
"lackWorkTimeHours": 0.0,
"abnormalStatusTime_8135": 1,
"workHour_1": 0.0,
"workHour_2": 0,
"outTripHour": 0.0,
"workHour_3": 0,
"workHour_4": 0,
"outApplyEndTime": "",
"workHour_5": 0,
"workHour_6": 0,
"lateTime_5": 0,
"lateTime_4": 0,
"shiftWorkNum": 1,
"lateTime_6": 0,
"clockInOutside": false,
"lateTime_1": 0,
"outtingDurationDay": 0.0,
"lateTime_3": 0,
"lateTime_2": 0,
"dayType": "工作日",
"businessTripDurationDay": 0.0,
"businessTripDurationHour": 0.0,
"applyRestOverTimeHour": 0.0,
"lackWorkTimeMinutes": 0,
"standardWorkHour": 8.0,
"cId": 75602674,
"clockDate": "2023-07-02",
"absentTime": 8.0,
"clockInOutside_4": false,
"clockInOutside_3": false,
"clockInOutside_2": false,
"clockInOutside_1": false,
"clockInOutside_6": false,
"clockInOutside_5": false,
"clockInAddress": "",
"shouldAttendanceHours": 8.0,
"workDayActualOverTimeRestHour": 0.0,
"overTimeApprovingDay": 0.0,
"shouldWorkHours": 8.0,
"overTimeApplyBeginTime": "",
"shiftName": "班次名称",
"actualPayOverTimeHour": 0.0,
"actualRestOverTimeHour": 0.0,
"clockInMissTime": 0,
"leaveStartTime": null,
"overTimeApprovingHour": 0.0,
"clockOutAddress": "",
"businessTripLatestTime": "",
"patchClockOutTimes": 0,
"unionKey": "75602674_2023-07-02",
"clockOutSourceType_6": "",
"totalLeaveDay": 0,
"clockOutSourceType_3": "",
"clockOutSourceType_2": "",
"workTimeOutLength": 0.0,
"clockOutSourceType_5": "",
"clockOutSourceType_4": "",
"clockOutSourceType_1": "",
"outWorkTimeEndTime": "",
"attendanceMode": "正常考勤",
"workTime": 0,
"patchClockInTimes_6": 0,
"patchClockInTimes_5": 0,
"clockInTime": "",
"patchClockInTimes_4": 0,
"missClockOutCount_3": 0,
"clockInAddress_5": "",
"patchClockInTimes_3": 0,
"missClockOutCount_2": 0,
"outsideClock": false,
"clockInAddress_4": "",
"patchClockInTimes_2": 0,
"missClockOutCount_1": 1,
"clockInAddress_3": "",
"patchClockInTimes_1": 0,
"clockInAddress_2": "",
"clockInAddress_1": "",
"lateTime": 0,
"missClockOutCount_6": 0,
"missClockOutCount_5": 0,
"missClockOutCount_4": 0,
"clockInAddress_6": "",
"absentHour": 8.0,
"clockOutOutside_1": false,
"leaveEarlyTime": 0,
"clockOutOutside_5": false,
"absentDay": 1.0,
"clockOutOutside_4": false,
"clockOutOutside_3": false,
"clockOutOutside_2": false,
"clockOutOutside_6": false,
"clockOutTime": "",
"freezeStatus": 0,
"holidaysActualOverTimeRestHour": 0,
"workBeginTime_1": "2023-07-02 15:50:00",
"abnormalStatusMinute_8135": 8,
"workBeginTime_6": "",
"workBeginTime_2": "",
"missClockOut_6": false,
"workBeginTime_3": "",
"missClockOut_5": false,
"workBeginTime_4": "",
"missClockOut_4": false,
"workBeginTime_5": "",
"missClockOut_3": false,
"missClockOut_2": false,
"outWorkTimeBeginTime": "",
"missClockOut_1": true,
"totalLeaveHour": 0,
"overTimeApplyEndTime": "",
"shiftInTime": "2023-07-02 15:50:00",
"workHours": 0,
"clockInTime_3": "",
"clockInTime_4": "",
"clockOuMissTime": 0,
"clockInTime_5": "",
"clockInTime_6": "",
"clockInTime_1": "",
"clockInTime_2": "",
"lackWorkTimeNum": 0,
"attendanceStatus": "旷工",
"attendanceStatus_6": "",
"shiftId": 72276,
"attendanceStatus_4": "",
"absentTime_6": 0,
"attendanceStatus_5": "",
"absentTime_5": 0,
"leaveEarlyTime_6": 0,
"absentTime_4": 0,
"absentTime_3": 0,
"absentTime_2": 0,
"absentTime_1": 8.0,
"clockOutOutside": false,
"patchClockOutTimes_3": 0,
"patchClockOutTimes_4": 0,
"patchClockOutTimes_1": 0,
"patchClockOutTimes_2": 0,
"patchClockOutTimes_5": 0,
"leaveApprovingHour": 0.0,
"patchClockOutTimes_6": 0,
"leaveEarlyTime_1": 0,
"businessTripEarliestTime": "",
"attendanceStatus_2": "",
"outApplyBeginTime": "",
"leaveEarlyTime_5": 0,
"attendanceGroupType": "固定班制",
"attendanceStatus_3": "",
"leaveEarlyTime_4": 0,
"leaveEarlyTime_3": 0,
"attendanceStatus_1": "旷工",
"leaveApprovingDay": 0.0,
"leaveEarlyTime_2": 0
}
]
}
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| hasMore | boolean | 是否有更多数据,true标识还有 | |
| nextCursor | int | 下一页标识，当hasMore为true时，下次查询传此nextCursor | |
| list | Array | 数据集合，详情见下面list | |
| └lateTime | int | 迟到分钟数 | |
| └leaveEarlyTime | int | 早退分钟数 | |
| └absentDay | int | 旷工天数 | |
| └clockInMissTime | int | 上班缺卡次数 | |
| └clockOuMissTime | int | 下班缺卡次数 | |
| └absentHour | int | 旷工小时数 | |
| └patchClockInTimes | int | 上班补卡次数 | |
| └patchClockOutTimes | int | 下班补卡次数 | |
| └applyPayOverTimeHour | int | 申请结算加班费小时数 | |
| └applyRestOverTimeHour | int | 申请结算调休假小时数 | |
| └actualPayOverTimeHour | int | 实际结算加班费小时数 | |
| └actualRestOverTimeHour | int | 实际结算调休假小时数 | |
| └workDayActualOverTimeRestHour | int | 工作日实际结算调休假小时数 | |
| └legalHolidayActualOverTimeRestHour | int | 公休日实际结算调休假小时数 | |
| └holidaysActualOverTimeRestHour | int | 节假日实际结算调休假小时数 | |
| └businessTripDurationDay | int | 出差天数 | |
| └businessTripDurationHour | int | 出差小时数 | |
| └outtingDurationDay | int | 外出时长（天） | |
| └outTripHour | int | 外出时长（小时） | |
| └workTimeOutLength | int | 工作时间外出时长 | |
| └clockDate | String | 考勤日期 | |
| └dayType | String | 日历类型 | |
| └attendanceMode | String | 考勤方式 | |
| └attendanceRuleName | String | 考勤组名称 | |
| └statisticRuleName | String | 统计规则名称 | |
| └leaveRuleName | String | 休假规则名称 | |
| └shiftWorkNum | int | 班次上下班次数 | |
| └shiftHalfDayTime | String | 班次半天结束时间 | |
| └shouldAttendanceHours | int | 实际应出勤小时数 | |
| └workHour | int | 第1次工作时长 | |
| └workBeginTime | String | 第1次工作上班时间 | |
| └workEndTime | String | 第1次工作下班时间 | |
| └clockInTime | String | 第1次上班打卡时间 | |
| └clockOutTime | String | 第1次下班打卡时间 | |
| └missClockInCount | int | 第1次工作上班缺卡次数 | |
| └missClockOutCount | int | 第1次工作下班缺卡次数 | |
| └absentMinutes | int | 第1次工作旷工分钟数 | |
| └absentTime | int | 第1次工作旷工小时数 | |
| └clockInSourceType | String | 第1次上班打卡来源 | |
| └clockOutSourceType | String | 第1次下班打卡来源 | |
| └clockInAddress | String | 第1次上班打卡办公地点 | |
| └clockOutAddress | String | 第1次下班打卡办公地点 | |
| └clockInOutside | String | 第1次上班是否外勤打卡 | |
| └clockOutOutside | String | 第1次下班是否外勤打卡 | |
| └missClockIn | String | 第1次上班是否缺卡 | |
| └missClockOut | String | 第1次下班是否缺卡 | |
| └attendanceStatus | String | 第1次考勤状态 | |
| └leaveStartTime | String | 请假开始时间 | |
| └leaveEndTime | String | 请假结束时间 | |
| └lackWorkTimeMinutes | int | 日工时不足分钟数 | |
| └lackWorkTimeHours | int | 日工时不足小时数 | |
| └lackWorkTimeNum | int | 日工时不足次数 | |
| └standardWorkHour | int | 标准工时 | |
| └attendanceGroupType | String | 考勤组类型 | |
| └shiftName | String | 班次名称 | |
| └shiftInTime | String | 班次上班时间 | |
| └shiftOutTime | String | 班次下班时间 | |
| └shiftWorkHour | int | 班次工作时长 | |
| └workTime | int | 实出勤分钟数 | |
| └workHours | int | 实出勤小时数 | |
| └totalLeaveDay | int | 请假天数 | |
| └totalLeaveHour | int | 请假小时数 | |
| └workingHoursInterval | String | 班次工作时间 | |
| └freezeStatus | String | 封存状态 | |
| └specialAttendance | String | 特殊考勤 | |
| └leaveApprovingDay | int | 审批中请假天数 | |
| └leaveApprovingHour | int | 审批中请假小时数 | |
| └businessTripApprovingDay | int | 审批中出差天数 | |
| └businessTripApprovingHour | int | 审批中出差小时数 | |
| └outWorkApprovingHour | int | 审批中工作时间外出小时数 | |
| └overTimeApprovingDay | int | 审批中加班天数 | |
| └overTimeApprovingHour | int | 审批中实际加班小时数 | |
| └clockInSource | String | 上班打卡来源 | |
| └clockOutSource | String | 下班打卡来源 | |
| └outsideClock | String | 当天是否外勤 | |
| └overtimeRuleName | String | 加班规则名称 | |
| └overworkActualHours | int | 实际加班小时数 | |
| └overworkApplyHours | int | 申请加班小时数 | |
| └overworkApprovingApplyHours | int | 审批中申请加班小时数 | |
| └overTimeClockInTime | String | 加班结算开始打卡时间 | |
| └overTimeClockOutTime | String | 加班结算结束打卡时间 | |
| └overTimeApplyBeginTime | String | 加班申请开始时间 | |
| └overTimeApplyEndTime | String | 加班申请结束时间 | |
| └businessTripEarliestTime | String | 出差开始时间 | |
| └businessTripLatestTime | String | 出差结束时间 | |
| └departureCity | String | 出差出发城市 | |
| └destinationCity | String | 出差目的城市 | |
| └outApplyBeginTime | String | 外出申请开始时间 | |
| └outApplyEndTime | String | 外出申请结束时间 | |
| └outWorkTimeBeginTime | String | 工作时间外出开始时间 | |
| └outWorkTimeEndTime | String | 工作时间外出结束时间 |
注意：
1.自定义字段存在租户间的差异，不在接口文档中展示，数据会在接口中返回
2.如果配置了多段的出勤规则，会在字段上面增加下划线返回，比如：比如有一天有3段工作时间则：（第1次工作时长）"workHour_1": 4.0, （第2次工作时长）"workHour_2": 5.0,（第3次工作时长）"workHour_3": 6.0,
员工最新出勤月报数据接口
接口说明：第三方通过根据参数信息查询员工最新出勤月报
参数示例
{
"employeeIds": [
75765012,
75733433,
75653024,
75653026,
75653059,
75702540,
75764883,
75764963,
75764964,
75766248,
75766306,
75766307,
75766308,
75776541,
75602674
],
"year": 2023,
"month": 7,
"pageNum": 1,
"pageSize": 20
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/statistics/report/month/page
请求频率：3次/秒/企业，180次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工最新出勤月报接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIds | 是 | Array | 员工ID集合 |
| year | 是 | int | 查询的年 |
| month | 是 | int | 查询的月 |
| nextCursor | 是 | int | 分页标记，后续使用上一次查询时返回nextCursor |
| pageSize | 是 | int | 每页大小，不超过50 |
响应示例
json { "code": 200, "msg": "成功", "data": { "nextCursor": 2, "hasMore": true, "list": [ { "id": 257974282, "createTime": "2023-07-29", "updateTime": "2023-07-29", "version": 0, "buId": 1093, "entId": 1107, "year": 2023, "month": 7, "employeeId": 75765012, "employeeName": "", "employeeNo": "", "jobInfoId": 407832, "onBoardingDate": "2020-04-06", "endProbationDate": "1970-01-01", "leaveDate": "1970-01-01", "annualLeaveEnjoyed": "0", "annualLeaveClearing": "0", "overtimeLeaveEnjoyed": "0", "calendarWorkday": 21, "calendarPublicHoliday": 10, "calendarHoliday": 0, "onTheJobWorkdayNum": 21, "onTheJobHolidayNum": 0, "status": 1, "workdayAfterEndProbationDate": 0, "holidayAfterEndProbationDate": 0, "actualAttendanceDays": "4", "requiredAttendanceDays": "21", "businessTripTimes": 0, "businessTripDays": "0", "outTripTimes": 0, "outTripHour": "0", "workdayOvertimeDurationHour": "3", "legalHolidayOvertimeDurationHour": "1", "holidayOvertimeDurationHour": "0", "payWorkdayOvertimeDurationHour": "0", "payLegalHolidayOvertimeDurationHour": "0", "payHolidayOvertimeDurationHour": "0", "lateCount": 0, "leaveEarlyCount": 0, "absentCount": 17, "clockCount": 1, "leaveEarlyTime": 0, "lateTime": 0, "absentHour": "136", "absentDay": "16", "workTime": 1080, "patchClockCount": 4, "patchClockInTimes": 2, "patchClockOutTimes": 2, "workHours": "18", "withoutShiftDays": 0, "workdayOvertimeApplyDurationHour": "6", "legalHolidayOvertimeApplyDurationHour": "1", "holidayOvertimeApplyDurationHour": "0", "payWorkdayOvertimeApplyDurationHour": "0", "payLegalHolidayOvertimeApplyDurationHour": "0", "payHolidayOvertimeApplyDurationHour": "0", "confirmStatus": 0, "confirmTime": "1970-01-01", "confirmSendStatus": 1, "readConfirmTime": "1970-01-01", "workTimeOutLength": "0", "holidayHasShiftDays": 0, "afterOnboardHolidayHasShiftDays": 0, "applyOutHours": "0", "applyOutInWorkHours": "0", "clockInMissClockCount": 1, "clockOutMissClockCount": 0, "scheduleTopLimit": "0", "scheduleBottomLimit": "0", "workerDayWorkHours": "18", "nonWorkerDayWorkHours": "0", "shouldWorkHours": "168", "avgActualWorkHours": "0.8571", "freezeStatus": 0, "freezeTime": null, "absentTime": "136", "overTimes": 8, "leaveTimes": 0, "totalLeaveDays": "0", "workDayTotalLeaveDays": "0", "reportConfigId": 3624, "workdayCompensatoryLeaveHour": "3", "legalHolidayCompensatoryLeaveHour": "1", "holidayCompensatoryLeaveHour": "0", "attendanceRulePublicId": 1100425604353753089, "attendanceRuleId": 1100425604353753088, "attendanceRuleChangeDate": "", "lackWorkTimeMinutes": 0, "lackWorkTimeHours": "0", "lackWorkTimeNum": 0, "compensatoryLeaveHour": "4", "payOvertimeDurationHour": "0", "onTheJobShiftDays": 0, "holidayBalanceId_hour19797": "35", "holidayBalanceId_19797": "4.375", "abnormalStatusTime_8134": "2", "abnormalStatusMinute_8134": "0", "abnormalStatusTime_8135": "16", "abnormalStatusMinute_8135": "128" } ] } }
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| hasMore | boolean | 是否有更多数据,true标识还有 | |
| nextCursor | int | 下一页标识，当hasMore为true时，下次查询传此nextCursor | |
| list | Array | 数据集合，详情见下面list | |
| └payLegalHolidayOvertimeApplyDurationHour | String | 公休日加班申请小时数 | |
| └year | int | 年份 | |
| └month | int | 月份 | |
| └reportConfigId | String | 月报配置ID | |
| └readConfirmTime | String | 阅读考勤确认时间 | |
| └legalHolidayOvertimeDurationHour | decimal | 公休日实际加班小时数 | |
| └shouldWorkHours | String | 班次总工时数 | |
| └employeeNo | String | 员工编号 | |
| └applyOutInWorkHours | String | 申请外出时长 | |
| └patchClockInTimes | int | 补卡次数 | |
| └withoutShiftDays | int | 未排班天数 | |
| └workDayTotalLeaveDays | String | 工作日请假总天数 | |
| └onBoardingDate | String | 入职日期 | |
| └confirmStatus | int | 确认状态 | |
| └nonWorkerDayWorkHours | String | 当月非工作日实出勤小时数 | |
| └id | String | 月报记录ID | |
| └holidayHasShiftDays | int | 在职节假日排班天数 | |
| └confirmTime | String | 月报确认时间 | |
| └totalLeaveDays | String | 请假天数 | |
| └holidayCompensatoryLeaveHour | String | 节假日实际结算调休假小时数 | |
| └version | int | 版本 | |
| └businessTripTimes | int | 出差次数 | |
| └clockOutMissClockCount | int | 下班缺卡次数 | |
| └payLegalHolidayOvertimeDurationHour | int | 公休日实际结算加班费小时数 | |
| └status | String | 是否生效标识，0禁用 1启用 | |
| └patchClockOutTimes | int | 下班补卡次数 | |
| └afterOnboardHolidayHasShiftDays | int | 转正后节假日排班天数 | |
| └avgActualWorkHours | int | 当月平均工时小时数 | |
| └calendarWorkday | int | 日历工作日天数 | |
| └payWorkdayOvertimeApplyDurationHour | String | 工作日结算加班费申请小时数 | |
| └patchClockCount | int | 补卡次数 | |
| └freezeTime | String | 封存时间 | |
| └absentCount | int | 旷工次数 | |
| └actualAttendanceDays | int | 在职实出勤天数 | |
| └businessTripDays | int | 出差天数 | |
| └workerDayWorkHours | String | 当月工作日实出勤小时数 | |
| └workTimeOutLength | int | 工作时间外出时长 | |
| └leaveTimes | int | 请假次数 | |
| └payOvertimeDurationHour | String | 实际结算加班费小时数 | |
| └scheduleTopLimit | String | 排班工时预警上限 | |
| └holidayBalanceId_hour | String | 假期余额小时数，后面需要增加假期类型ID ，比如：holidayBalanceId_hour1080 | |
| └updateTime | String | 更新时间 | |
| └employeeId | Long | 员工ID | |
| └jobInfoId | String | 任职记录ID | |
| └workdayAfterEndProbationDate | int | 转正后工作日天数 | |
| └workTime | String | 总工时 | |
| └legalHolidayOvertimeApplyDurationHour | String | 公休日加班申请小时数 | |
| └createTime | String | 创建时间 | |
| └lateTime | int | 总迟到分钟数 | |
| └overTimes | int | 加班次数 | |
| └lackWorkTimeHours | String | 日工时不足小时数 | |
| └applyOutHours | String | 申请外出时长 | |
| └absentHour | String | 旷工小时数 | |
| └workdayCompensatoryLeaveHour | String | 工作日实际结算调休假小时数 | |
| └holidayOvertimeDurationHour | int | 节假日实际加班小时数 | |
| └leaveEarlyTime | int | 总早退分钟数 | |
| └holidayAfterEndProbationDate | int | 转正后节假日天数 | |
| └abnormalStatusTime | int | 考勤异常状态次数; 后面需要加异常状态ID；比如：abnormalStatusTime_8135 | |
| └outTripHour | String | 外出时长小时 | |
| └absentDay | int | 旷工天数 | |
| └calendarHoliday | int | 日历节假日天数 | |
| └holidayOvertimeApplyDurationHour | String | 公休日加班申请小时数 | |
| └legalHolidayCompensatoryLeaveHour | String | 公休日实际结算调休假小时数 | |
| └freezeStatus | int | 封存状态 | |
| └onTheJobHolidayNum | int | 在职节假日天数 | |
| └outTripTimes | int | 外出次数 | |
| └annualLeaveClearing | String | 年假离职清算 | |
| └employeeName | String | 员工姓名 | |
| └abnormalStatusMinute | String | 考勤异常状态分钟数，后面需要加异常状态ID；比如：abnormalStatusMinute_8134 | |
| └clockInMissClockCount | int | 上班缺卡次数 | |
| └payWorkdayOvertimeDurationHour | int | 工作日实际结算加班费小时数 | |
| └annualLeaveEnjoyed | String | 年假离职应享受 | |
| └compensatoryLeaveHour | String | 实际结算调休假小时数 | |
| └endProbationDate | String | 试用期转正日期 | |
| └payHolidayOvertimeApplyDurationHour | String | 节假日结算加班费小时数 | |
| └attendanceRuleId | String | 考勤规则ID | |
| └scheduleBottomLimit | String | 排班工时预警下限 | |
| └payHolidayOvertimeDurationHour | int | 节假日实际结算加班费小时数 | |
| └workHours | int | 实出勤小时数 | |
| └workdayOvertimeApplyDurationHour | String | 工作日结算加班费申请小时数 | |
| └lateCount | int | 总迟到次数 | |
| └holidayBalanceId_19797 | String | 假期余额，后面加假期类型ID；比如：holidayBalanceId_19797 | |
| └clockCount | int | 总缺卡次数 | |
| └attendanceRuleChangeDate | String | 考勤组变更日期，指账期开始日到核算时日期区间内，用户考勤组与核算日期考勤组public_id不同的最早日期 | |
| └onTheJobWorkdayNum | int | 在职工作日天数 | |
| └leaveEarlyCount | int | 总早退次数 | |
| └workdayOvertimeDurationHour | int | 工作日实际加班小时数 | |
| └requiredAttendanceDays | String | 应出勤天数 | |
| └lackWorkTimeMinutes | int | 日工时不足分钟数 | |
| └lackWorkTimeNum | String-int | 日工时不足次数 | |
| └absentTime | int | 旷工次数 | |
| └overtimeLeaveEnjoyed | String | 离职清算加班调休应享受天数 | |
| └calendarPublicHoliday | int | 日历公休日天数 | |
| └leaveDate | String | 离职日期 | |
| └confirmSendStatus | int | 考勤确认发送状态: 1.未发送 2.已发送 | |
| └attendanceRulePublicId | String | 考勤组规则public_id |
注意：
1.自定义字段存在租户间的差异，不在接口文档中展示，数据会在接口中返回
请假写入接口（写入）
接口说明：第三方通过外部审批单唯一标识ID添加请假记录
假期类型含特殊规则配置，写入请假时赋默认配置值
请假时间范围按多胞胎设置时，取单胞胎第一项配置
参数示例
{
"uniqueIdentifierType":0,
"employeeUniqueIdentifier":"75766632",
"thirdPartApplyId":"202405271210",
"absName":"半年-固定值",
"startDate":"2024-04-25",
"endDate":"2024-04-25",
"startTime":"AM",
"endTime":"PM",
"flowStatus":1,
"reason":"ZJ测试202405271210请假"
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/attendance/leave/add
请求频率：20次/秒/企业，1000次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【请假写入接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | 是 | String | 外部审批单唯一标识ID，最大32 |
| employeeUniqueIdentifier | 是 | String | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | 是 | int | 枚举类型0:员工id1 :公司邮箱2 :员工工号3 :钉钉userid4 :飞书userid（user_id）5 :企业微信userid（明文） |
| absName | 是 | String | 请假类型，需与系统内设置的请假类型名称一致 |
| startDate | 是 | String | 请假开始日期，yyyy-mm-dd |
| endDate | 是 | String | 请假结束日期，yyyy-mm-dd |
| startTime | 是 | String | 请假开始时间，如09:00/AM/PM |
| endTime | 是 | String | 请假结束时间，如18:00/AM/PM |
| duration | 否 | BigDecimal | 请假时长；如果写入请假时长，则以写入的数据为准；不写入请假时长则根据休假规则进行计算 |
| unit | 否 | Int | 请假单位，天或小时 1:天 2:小时, 说明：日报数据统计时会统计到【请假时长归属日期】，建议拆分为每天的数据进行写入，即单位为天时≤1，单位为小时时≤24 |
| leaveDate | 否 | String | 请假时长归属日期，yyyy-mm-dd，用于统计请假时长统计使用，若为空则默认为请假开始日期 |
| flowStatus | 是 | Int | 流程状态：1：审批中2：通过3：撤回4：驳回 |
| reason | 是 | String | 请假原因，最长8000 |
| allowOverspend | 否 | Int | 是否允许超支，若允许超支时不会校验假期的可用余额是否足够。默认为0 1：是 2：否 |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": null
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|
请假更新接口（写入）
接口说明：第三方通过外部审批单唯一标识ID更新请假记录
考勤组或考勤组关联休假规则变更，审批状态更改，按新考勤组或新休假规则插入请假记录
休假规则中假期类型配置变更，审批状态更改，按最新假期类型配置插入请假记录
参数示例
{
"uniqueIdentifierType":0,
"employeeUniqueIdentifier":"75766632",
"thirdPartApplyId":"202405271210",
"absName":"半年-固定值",
"startDate":"2024-04-25",
"endDate":"2024-04-25",
"startTime":"AM",
"endTime":"PM",
"flowStatus":2,
"reason":"ZJ测试202405271210请假"
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/attendance/leave/update
请求频率：20次/秒/企业，1000次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【请假更新接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | 是 | String | 外部审批单唯一标识ID，最大32 |
| employeeUniqueIdentifier | 是 | String | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | 是 | int | 枚举类型0:员工id1 :公司邮箱2 :员工工号3 :钉钉userid4 :飞书userid（user_id）5 :企业微信userid（明文） |
| absName | 是 | String | 请假类型，需与系统内设置的请假类型名称一致 |
| startDate | 是 | String | 请假开始日期，yyyy-mm-dd |
| endDate | 是 | String | 请假结束日期，yyyy-mm-dd |
| startTime | 是 | String | 请假开始时间，如09:00/AM/PM |
| endTime | 是 | String | 请假结束时间，如18:00/AM/PM |
| duration | 否 | BigDecimal | 请假时长；如果写入请假时长，则以写入的数据为准；不写入请假时长则根据休假规则进行计算 |
| unit | 否 | Int | 请假单位，天或小时 1:天 2:小时, 说明：日报数据统计时会统计到【请假时长归属日期】，建议拆分为每天的数据进行写入，即单位为天时≤1，单位为小时时≤24 |
| leaveDate | 否 | String | 请假时长归属日期，yyyy-mm-dd，用于统计请假时长统计使用，若为空则默认为请假开始日期 |
| flowStatus | 是 | Int | 流程状态：1：审批中2：通过3：撤回4：驳回 |
| reason | 是 | String | 请假原因，最长8000 |
| allowOverspend | 否 | Int | 是否允许超支，若允许超支时不会校验假期的可用余额是否足够。默认为0 1：是 2：否 |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": null
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|
请假撤回接口（写入）
接口说明：第三方通过外部审批单唯一标识ID撤回请假记录
参数示例
{
"thirdPartApplyId":"202405271210"
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/attendance/leave/recall
请求频率：20次/秒/企业，1000次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【请假撤回接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | 是 | String | 外部审批单唯一标识ID，最大32 |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": null
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|
假期账户余额查询
接口说明：第三方通过员工id列表与指定假期类型查询员工假期账户余额
参数示例
{
"employeeIdList": ["75766632"],
"absName":"年假",
"pageSize": 200,
"pageNum": 1,
"unitId": 1
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/account/search
请求频率：20次/秒/企业，1000次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【假期账户余额查询接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 外部审批单唯一标识ID，最大32 |
| absName | 否 | String | 假期类型 |
| unitId | 是 | int | 1.天 2.小时 |
| pageSize | 是 | int | 分页大小，不超过50 |
| pageNum | 是 | int | 页码 |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": [
{
"accounts": [
],
"absName": "pp",
"errEmployee": [
75766632
]
},
{
"accounts": [
],
"absName": "每年1月1号-随工龄司龄-不折算周年后累加值",
"errEmployee": [
75766632
]
},
{
"accounts": [
],
"absName": "自动化测试假期类型-限制最大请假时长-限制余额",
"errEmployee": [
75766632
]
},
{
"accounts": [
{
"employeeId": 75766632,
"employeeName": "邹冀",
"employeeNo": "002940",
"absName": "ht-育儿假",
"availableBalance": "1.12",
"preYearAvailableBalance": "0",
"curYearAvailableBalance": "1.12",
"unitText": "天"
}
],
"absName": "ht-育儿假",
"errEmployee": [
]
},
{
"accounts": [
],
"absName": "自然年-随工龄司龄-一次性",
"errEmployee": [
75766632
]
},
{
"accounts": [
],
"absName": "每年1月1号-随工龄司龄-不折算周年后-最高值",
"errEmployee": [
75766632
]
},
{
"accounts": [
],
"absName": "auto平平假期1655706103.8166223",
"errEmployee": [
75766632
]
}
]
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| accounts | Array | 员工账户列表 | |
| accounts.employeeId | Long | 员工id | |
| accounts.employeeName | String | 员工姓名 | |
| accounts.employeeNo | String | 员工工号 | |
| accounts.absName | String | 假期类型 | |
| accounts.availableBalance | String | 可用余额 | |
| accounts.preYearAvailableBalance | String | 往年结余；在今年1月1日之前生效，且已经释放给员工额度，扣除使用的额度后，剩余可用的额度；示例：去年一共生效了5天假期，员工使用了1天，过期了1天，在今天查看时员工往年结余可用3天 | |
| accounts.curYearAvailableBalance | String | 今年剩余；在当前自然年生效，已经释放给员工额度，扣除使用的额度后，剩余可用的额度；示例：今年1.1日发放了5天假期，仅生效了2天，员工使用了1天，在今天查看时员工当年剩余为1天 | |
| accounts.unitText | String | 单位（天、小时），与请求的单位一致 | |
| absName | String | 假期类型名称 | |
| errEmployee | Array<Long> | 未查询到的员工列表 |
发假记录写入接口
接口说明：通过此接口，可以新增员工发假记录信息（假期类型、生效日期等），可写入最近半年的发假记录。
参数示例
{
"uniqueIdentifierType":0,
"employeeUniqueIdentifier":"75782906",
"thirdPartApplyId":"202409261144",
"absName":"年假",
"amount":0.5000,
"unit":1,
"workHours":8.0,
"effectDate":"2024-09-10",
"expiredDate":"2024-10-10",
"reason":"测试202409261142发假"
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/account/add
请求频率：5次/秒/企业，300次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【发假记录写入接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | 是 | String | 外部审批单唯一标识ID，最大32 |
| employeeUniqueIdentifier | 是 | String | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | 是 | int | 枚举类型0:员工id1 :公司邮箱2 :员工工号3 :钉钉userid4 :飞书userid（user_id）5 :企业微信userid（明文） |
| absName | 是 | String | 假期类型，需与系统内设置的假期类型名称一致 |
| amount | 是 | decimal | 发假数量，需＞0，最大支持4位小数，超出则舍去 |
| unit | 是 | int | 发假单位，天或小时1:天2 :小时 |
| workHours | 否 | decimal | 标准工时，用于换算小时与天时使用，为空时默认为1天=8小时 |
| effectDate | 是 | String | 生效日期，yyyy-mm-dd |
| expiredDate | 否 | String | 失效日期，yyyy-mm-dd，为空时代表不失效 |
| reason | 是 | String | 发假说明，最长8000 |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": null
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | null |
发假记录更新接口
接口说明：通过此接口，可以更新员工发假记录信息（假期类型、生效日期等），可更新最近半年的发假记录。
参数示例
{
"uniqueIdentifierType":0,
"employeeUniqueIdentifier":"75782906",
"thirdPartApplyId":"202409261144",
"amount":0.5000,
"expiredDate":"2024-10-10",
"reason":"测试202409261142发假"
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/account/update
请求频率：5次/秒/企业，300次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【发假记录更新接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | 是 | String | 外部审批单唯一标识ID，最大32 |
| employeeUniqueIdentifier | 是 | String | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | 是 | int | 枚举类型0:员工id1 :公司邮箱2 :员工工号3 :钉钉userid4 :飞书userid（user_id）5 :企业微信userid（明文） |
| amount | 是 | decimal | 发假数量，需＞0，最大支持4位小数，超出则舍去 |
| expiredDate | 是 | String | 失效日期，yyyy-mm-dd，为空时代表不失效 |
| reason | 是 | String | 发假说明，最长8000 |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": null
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | null |
发假记录撤回接口
接口说明：通过此接口，可以撤回员工发假记录信息（假期类型、生效日期等），可撤回最近半年的发假记录。
参数示例
{
"thirdPartApplyId":"202409261144"
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/account/revoke
请求频率：5次/秒/企业，300次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【发假记录撤回接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | 是 | String | 外部审批单唯一标识ID，最大32 |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": null
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | null |
加班写入接口（写入）
接口说明：第三方通过外部审批单唯一标识ID添加加班记录
参数示例
{
"thirdPartApplyId": "202409141453",
"employeeUniqueIdentifier": "75784110",
"uniqueIdentifierType": 0,
"compensation": "调休假",
"startDate": "2024-08-14",
"startTime": "18:00",
"endTime": "18:40",
"settleDuration": 40,
"reason": "完整加班流程-添加了结算时长",
"flowStatus": 2,
"unit": 3
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/overtime/thirdOvertimeAdd
请求频率：20次/秒/企业，500次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工加班记录写入】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | 是 | String | 外部审批单唯一标识ID，最大32 |
| employeeUniqueIdentifier | 是 | String | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | 是 | int | 枚举类型0:员工id1 :公司邮箱2 :员工工号3 :钉钉userid4 :飞书userid（user_id）5 :企业微信userid（明文） |
| unit | 是 | int | 加班单位 1：天2：小时3：分钟 |
| startDate | 是 | String | 加班开始日期，yyyy-mm-dd |
| startTime | 是 | String | 加班开始时间，如09:00/AM/PM |
| endTime | 是 | String | 加班结束时间，如18:00/AM/PM |
| flowStatus | 是 | Int | 流程状态：1：审批中2：通过3：驳回4：撤回 |
| compensation | 是 | String | 补偿方式：调休假、加班费、不补偿 |
| settleDuration | 否 | String | 加班结算时长 ： 需为数字，如果写入结算时长，则以写入的数据为准；不写入结算时长则根据加班规则进行计算 |
| reason | 是 | String | 加班原因，最长8000 |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": {
"thirdPartApplyId": "202409141453"
}
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| thirdPartApplyId | String | 外部申请单id |
加班更新接口（写入）
接口说明：第三方通过外部审批单唯一标识ID更新加班记录
参数示例
{
"thirdPartApplyId": "202409141453",
"employeeUniqueIdentifier": "75784110",
"uniqueIdentifierType": 0,
"compensation": "调休假",
"startDate": "2024-08-14",
"startTime": "18:00",
"endTime": "18:40",
"settleDuration": 40,
"reason": "完整加班流程-添加了结算时长",
"flowStatus": 2,
"unit": 3
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/overtime/thirdOvertimeUpdate
请求频率：20次/秒/企业，500次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工加班记录更新】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | 是 | String | 外部审批单唯一标识ID，最大32 |
| employeeUniqueIdentifier | 是 | String | 员工的唯一标识，由uniqueIdentifierType指定，目前支持六种，六选一 |
| uniqueIdentifierType | 是 | int | 枚举类型0:员工id1 :公司邮箱2 :员工工号3 :钉钉userid4 :飞书userid（user_id）5 :企业微信userid（明文） |
| unit | 是 | int | 加班单位 1：天2：小时3：分钟 |
| startDate | 是 | String | 加班开始日期，yyyy-mm-dd |
| startTime | 是 | String | 加班开始时间，如09:00/AM/PM |
| endTime | 是 | String | 加班结束时间，如18:00/AM/PM |
| flowStatus | 是 | Int | 流程状态：1：审批中2：通过3：驳回4：撤回 |
| compensation | 是 | String | 补偿方式：调休假、加班费、不补偿 |
| settleDuration | 否 | String | 加班结算时长 ： 需为数字，如果写入结算时长，则以写入的数据为准；不写入结算时长则根据加班规则进行计算 |
| reason | 是 | String | 加班原因，最长8000 |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": {
"thirdPartApplyId": "202409141453"
}
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| thirdPartApplyId | String | 外部申请单id |
加班撤回接口（写入）
接口说明：第三方通过外部审批单唯一标识ID撤回加班记录
参数示例
{
"thirdPartApplyId": "202409141453"
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/overtime/thirdOvertimeRecall
请求频率：20次/秒/企业，500次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工加班记录撤回】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明， https://people.mokahr.com/docs/api/view/v1.html#api-sign |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| thirdPartApplyId | 是 | String | 外部审批单唯一标识ID，最大32 |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": {
"thirdPartApplyId": "202409141453"
}
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| thirdPartApplyId | String | 外部申请单id |
薪酬接口API
如需获取员工薪酬相关数据（薪资标准、工资结果、社保缴纳基数等），在此目录下查找相关接口
员工薪资档案数据接口
接口说明：通过此接口，可以查询员工薪资档案中相关信息（起薪日期、薪资标准、年度总收入等）
返回结果示例
{
"code": 200,
"msg": "操作成功",
"data": {
"total": 1,
"size": 1,
"list": [
{
"employeeId": 161457,
"projectDetailList": [
{
"regularSalary": 9000,
"probation": false,
"probateSalary": 9000,
"projectName": "月工资"
}
],
"salaryArchivesList": [
{
"effect_date": "2021-07-01 00:00:00",
"DF_935cdf511ea74fc7a58861054bb846a2": "134",
"tax_option": {
"tax_option_id": 1,
"tax_option_value": "居民"
},
"event_reason": {
"event_reason_id": 874,
"event_reason_value": "入职定薪",
"event_reason_name": null
},
"total_salary": "108000",
"remark": "",
"department": [
{
"id": 163631,
"value": null,
"name": null
}
],
"start_date": "2021-07-01 00:00:00",
"salary_plan": {
"salary_plan_id": 1633677553036830,
"salary_plan_name": null,
"salary_plan_value": "薪资计划"
}
}
]
}
],
"labelList": [
{
"fieldName": "effect_date",
"label": "薪资生效日期",
"type": 2
},
{
"fieldName": "start_date",
"label": "起薪日期",
"type": 2
},
{
"fieldName": "end_date",
"label": "最后发薪日",
"type": 2
},
{
"fieldName": "tax_option",
"label": "缴税类型",
"type": 5
},
{
"fieldName": "DF_2c401475a9554ea4abad03e8a2b3436d",
"label": "离职缺勤天数",
"type": 3
},
{
"fieldName": "department",
"label": "发薪组织",
"type": 60
},
{
"fieldName": "salary_plan",
"label": "薪资计划",
"type": 26
},
{
"fieldName": "event_reason",
"label": "薪资异动原因",
"type": 27
},
{
"fieldName": "total_salary",
"label": "年度总收入",
"type": 3
},
{
"fieldName": "remark",
"label": "备注",
"type": 11
},
{
"fieldName": "DF_935cdf511ea74fc7a58861054bb846a2",
"label": "参保基数",
"type": 3
},
{
"fieldName": "DF_0a97c2ad349d4b59b22ca8f321e0fae5",
"label": "自定义字段-薪资档案",
"type": 3
},
{
"fieldName": "DF_ffadd54514d346dd855251b69cedd521",
"label": "话补（薪资）",
"type": 1
},
{
"fieldName": "DF_2dffeac38bb941328cb529033dc8ab34",
"label": "车补（薪资）",
"type": 1
},
{
"fieldName": "DF_8fb63e7d4a6148eab8d3737ccd69a33c",
"label": "交通补贴（薪资）",
"type": 1
},
{
"fieldName": "DF_d09f641e99ad42a5b9773d2ff7585276",
"label": "薪酬类型",
"type": 5
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/archives
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪资档案】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组，<=200条 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 | |
| data.labelList | JsonArray | 业务数据内容的字段说明 | |
| data.size | int | 返回结果的业务数据条数 | |
| data.total | Long | 总条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.list.employeeId | Long | 员工ID | |
| data.list.projectDetailList | Array | 薪资标准项目信息。员工的薪酬结构，eg：基本工资、岗位工资等 | |
| data.list.salaryArchivesList | Array | 预置字段与自定义字段的数据 |
数据内容：返回格式均为key:value格式（key为字段名称，value为对应的值）
data.list.projectDetailList字段说明：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| projectName | String | 项目名称 | eg：基本工资、岗位工资 |
| probation | Boolean | 是否有试用期标准 枚举值 true:是false：否 |
|
| probateSalary | int | 试用期薪资标准 | |
| regularSalary | int | 转正后薪资标准 |
data.list.salaryArchivesList字段说明：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| effect_date | String | 薪资生效日期 | |
| end_date | String | 最后发薪日 | |
| tax_option | Object | 缴税类型 | |
| └tax_option_id | int | 类型标识id | |
| └tax_option_value | String | 类型描述 | |
| event_reason | Object | 薪资异动原因 | |
| └event_reason_id | int | 异动标识id | |
| └event_reason_value | String | 异动原因 | |
| └event_reason_name | String | 异动名称 | |
| department | Object | 发薪组织 | |
| └id | int | 发薪组织id | |
| └value | String | 组织全路径 | |
| └name | String | 组织名称 | |
| start_date | String | 起薪日期 | |
| salary_plan | Object | 薪资计划 | |
| └salary_plan_id | int | 薪资计划id | |
| └salary_plan_name | String | 薪资计划名称 | |
| └salary_plan_value | String | 薪资计划值 | |
| remark | String | 备注 | |
| total_salary | String | 年度总收入 | |
| … | … | 其他自定义字段 |
员工薪资档案创建接口
接口说明：通过此接口，可以创建员工薪资档案中相关信息（起薪日期、薪资标准等） 薪资档案总共分为以下四种类型： - 入职定薪 - 转正调薪 - 异动调薪 - 停薪 注意：最多只能一次批量创建20条数据
返回结果示例
{
"code": 200,
"msg": "",
"data": {
"successList": [
{
"salaryArchiveInfoChangeId": 12869219,
"index": 0,
"msg": ""
}
],
"failedList": [
{
"salaryArchiveInfoChangeId": null,
"index": 0,
"msg": "DF_31f3daf86d3b47f188955dd1d84c944c:是否字段格式不正确，请输入数字1代表是，数字2代表否 "
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/archives/batchCreate
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪资档案】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| operatorId | 否 | long | 操作人ID（如果不传，默认随机取一个超管） |
| archiveInfoChanges | 是 | Array | 档案信息变更列表，包含员工薪资等信息，长度为1 |
| archiveInfoChanges.employeeId | 是 | long | 员工ID |
| archiveInfoChanges.effectDate | 是 | String | 生效日期 |
| archiveInfoChanges.salaryPlanId | 是 | long | 薪资计划ID |
| archiveInfoChanges.startDate | 是 | String | 开始日期 |
| archiveInfoChanges.endDate | 是 | String | 结束日期 |
| archiveInfoChanges.salaryStatus | 是 | long | 薪资状态 1 发薪 2 停薪 |
| archiveInfoChanges.eventType | 是 | long | 事件类型 枚举【1 入职定薪，2 转正调薪，3 异动调薪，4 停薪】 |
| archiveInfoChanges.eventReason | 是 | String | 事件原因，在系统薪酬设置内可配置 |
| archiveInfoChanges.severancePackages | 否 | float | 离职补偿金（停薪时必填） |
| archiveInfoChanges.salaryProjectList | 是 | Array | 薪资项目列表，包含试用期和转正薪资 |
| archiveInfoChanges.salaryProjectList.salaryProjectId | 是 | long | 薪资项目ID |
| archiveInfoChanges.salaryProjectList.probateSalary | 是 | long | 试用期薪资 |
| archiveInfoChanges.salaryProjectList.regularSalary | 是 | int | 转正后薪资 |
| archiveInfoChanges.taxOptionId | 是 | long | 纳税选项ID |
| archiveInfoChanges.salaryOrgId | 是 | String | 薪资组织ID |
| archiveInfoChanges.remark | 否 | String | 备注 |
| archiveInfoChanges.extendFields | 否 | Array | 扩展字段列表 |
| archiveInfoChanges.extendFields.fieldName | 是 | String | 扩展字段名称 |
| archiveInfoChanges.extendFields.fieldValue | 是 | String | 扩展字段值 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | int | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.successList | JsonArray | 成功列表 | |
| data.failedList | JsonArray | 失败列表 |
返回结果data.successList说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.successList.salaryArchiveInfoChangeId | int | 薪资档案信息变更ID | |
| data.successList.index | int | 索引值 | |
| data.successList.msg | String | 消息 |
返回结果data.failedList说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.failedList.salaryArchiveInfoChangeId | null或int | 薪资档案信息变更ID（失败时可能为null） | |
| data.failedList.index | int | 索引值 | |
| data.failedList.msg | String | 失败消息 |
员工薪资档案更新接口
接口说明：通过此接口，可以更新员工薪资档案中相关信息 注意：薪资档案的事件类型不可被更新 注意：最多只能一次批量更新20条数据
返回结果示例
{
"code": 200,
"msg": "",
"data": {
"successList": [
{
"salaryArchiveInfoChangeId": 12869219,
"index": 0,
"msg": ""
}
],
"failedList": [
{
"salaryArchiveInfoChangeId": null,
"index": 0,
"msg": "DF_31f3daf86d3b47f188955dd1d84c944c:是否字段格式不正确，请输入【是】或【否】;DF_bd49be15e4304306967f01afbbc2d821:下拉选项字段不存在;"
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/archives/batchUpdate
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪资档案】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| operatorId | 否 | long | 操作人ID（如果不传，默认随机取一个超管） |
| archiveInfoChanges | 是 | Array | 档案信息变更列表，包含员工薪资等信息，长度为1 |
| archiveInfoChanges.id | 是 | long | 档案信息变更ID |
| archiveInfoChanges.employeeId | 是 | long | 员工ID |
| archiveInfoChanges.effectDate | 是 | String | 生效日期 |
| archiveInfoChanges.salaryPlanId | 是 | long | 薪资计划ID |
| archiveInfoChanges.endDate | 否 | String | 结束日期 |
| archiveInfoChanges.salaryStatus | 是 | int | 薪资状态 |
| archiveInfoChanges.eventReason | 是 | String | 事件原因 |
| archiveInfoChanges.salaryOrgId | 是 | long | 发薪组织ID |
| archiveInfoChanges.severancePackages | 否 | float | 离职补偿金（停薪时必填） |
| archiveInfoChanges.salaryProjectList | 是 | Array | 薪资项目列表，包含试用期和转正薪资 |
| archiveInfoChanges.salaryProjectList.salaryProjectId | 是 | int | 薪资项目ID |
| archiveInfoChanges.salaryProjectList.probateSalary | 是 | int | 试用期薪资 |
| archiveInfoChanges.salaryProjectList.regularSalary | 是 | int | 转正后薪资 |
| archiveInfoChanges.taxOptionId | 是 | int | 纳税选项ID |
| archiveInfoChanges.remark | 否 | String | 备注 |
| archiveInfoChanges.extendFields | 否 | Array | 扩展字段列表 |
| archiveInfoChanges.extendFields.fieldName | 是 | String | 扩展字段名称 |
| archiveInfoChanges.extendFields.fieldValue | 是 | 多种类型（如int、String等） | 扩展字段值 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | int | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.successList | JsonArray | 成功列表 | |
| data.failedList | JsonArray | 失败列表 |
返回结果data.successList说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.successList.salaryArchiveInfoChangeId | int | 薪资档案信息变更ID | |
| data.successList.index | int | 索引值 | |
| data.successList.msg | String | 消息 |
返回结果data.failedList说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.failedList.salaryArchiveInfoChangeId | int | 薪资档案信息变更ID | |
| data.failedList.index | int | 索引值 | |
| data.failedList.msg | String | 失败消息 |
员工薪资档案删除接口
接口说明：通过此接口，可以删除员工薪资档案中相关信息 注意：为了一定程度避免误删除，员工id和薪资档案id必须匹配，否则将会校验失败，不允许删除 注意：最多只能一次批量删除20条数据
返回结果示例
{
"code": 200,
"msg": "",
"data": {
"successList": [
{
"salaryArchiveInfoChangeId": 128420,
"index": 0,
"msg": ""
}
],
"failedList": [
{
"salaryArchiveInfoChangeId": 2,
"index": 1,
"msg": "薪资档案不存在"
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/archives/batchDelete
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪资档案】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| operatorId | 否 | long | 操作人ID（如果不传，默认随机取一个超管） |
| archiveInfoChanges | 是 | Array | 档案信息变更列表，包含员工ID和薪资档案信息变更ID |
| archiveInfoChanges.employeeId | 是 | int | 员工ID |
| archiveInfoChanges.salaryArchiveInfoChangeId | 是 | int | 薪资档案信息变更ID |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | int | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.successList | JsonArray | 成功列表 | |
| data.failedList | JsonArray | 失败列表 |
返回结果data.successList说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.successList.salaryArchiveInfoChangeId | int | 薪资档案信息变更ID | |
| data.successList.index | int | 索引值 | |
| data.successList.msg | String | 消息 |
返回结果data.failedList说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.failedList.salaryArchiveInfoChangeId | int | 薪资档案信息变更ID | |
| data.failedList.index | int | 索引值 | |
| data.failedList.msg | String | 失败消息 |
工资核算活动创建接口
接口说明：通过此接口，可以创建薪酬核算活动
返回结果示例
{
"code": 200,
"msg": "",
"data": {
"recordId": 1731327279560643,
"msg": "操作成功"
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/calculate/record/create
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪资档案】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| operatorId | 否 | long | 操作人ID（如果不传，默认随机取一个超管） |
| baseId | 是 | int | 核算规则id |
| calcName | 是 | String | 活动名称 |
| salaryOrgIds | 否 | Array | 薪资组织ID列表（如果核算规则为创建活动时选择，则必填） |
| importUser | 是 | boolean | 是否导入用户（目前openApi暂不支持，请传false） |
| salaryYearAndMonth | 是 | String | 薪资年月 |
| year | 是 | String | 年份 格式yyyy 如2024 |
| quarter | 是 | String | 季度 |
| startDate | 是 | String | 开始日期 |
| endDate | 是 | String | 结束日期 |
| taxBelong | 是 | String | 纳税所属期 |
| ruleIdList | 是 | Array |
列表展示项目字段id（核算规则详情中的calculateRule.rule.fieldId) |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | int | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.recordId | int | 记录ID | |
| data.msg | String | 消息（操作成功） |
工资核算活动删除接口
接口说明：通过此接口，可以删除薪酬核算活动
返回结果示例
{
"code": 200,
"msg": "",
"data": {
"recordId": 1731327279560643,
"success": true,
"msg": "操作成功"
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/calculate/record/delete
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪资档案】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| operatorId | 否 | long | 操作人ID（如果不传，默认随机取一个超管） |
| recordId | 是 | long | 核算活动id |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | int | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.recordId | int | 记录ID | |
| data.success | bool | 是否成功 | |
| data.msg | String | 错误信息 |
工资核算活动归档接口
接口说明：通过此接口，可以归档薪酬核算活动
返回结果示例
{
"code": 200,
"msg": "",
"data": {
"recordId": 1731327279560643,
"msg": "操作成功"
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/calculate/record/archive
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪资档案】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| operatorId | 否 | long | 操作人ID（如果不传，默认随机取一个超管） |
| recordId | 是 | long | 核算活动id |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | int | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.recordId | int | 记录ID | |
| data.success | bool | 是否成功 | |
| data.msg | String | 错误信息 |
查询核算规则列表
接口说明：通过此接口，可以查询当前租户下的所有核算规则
返回结果示例
{
"code": 200,
"msg": "",
"data": {
"rules": [
{
"baseId": 1731121305473743,
"cycle": "月度(当月1号到月底)",
"effectDate": "2024-11-09",
"name": "1111",
"range": "核算时选择",
"rangeType": 2
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/calculate/rule/listAll
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | int | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.rules | JsonArray | 规则列表 |
返回结果data.rules说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.rules.baseId | long | 核算规则id | |
| data.rules.cycle | String | 周期（如月度） | |
| data.rules.effectDate | String | 生效日期 | |
| data.rules.name | String | 名称 | |
| data.rules.range | String | 范围（核算时选择） | |
| data.rules.rangeType | int | 范围类型 1 核算时选择 2 使用核算规则范围 |
查询核算规则详情
接口说明：通过此接口，可以查询核算规则详情
返回结果示例
{
"code": 200,
"msg": "",
"data": {
"baseSetting": {
"name": "15环境验证新增",
"hrList": [
{
"id": 104079,
"name": "安安实习生",
"haveUsed": null
}
],
"cycle": 1,
"cycleDetail": 1,
"range": 1,
"rangeDtoList": [
224440
],
"rangeNameDtoList": [
{
"id": 224440,
"name": "32123",
"haveUsed": null
}
],
"additionList": [],
"effectiveDateStr": "2024-09-26",
"absentResult": 1,
"month": 1,
"rangeNameStatusDtoList": [],
"automaticCalculateTax": 1,
"specialAdditionalDeductionsDownType": 1
},
"calculateRule": {
"rules": [
{
"groupId": 1046,
"groupName": "employee_info",
"groupLabel": "13213员工信息",
"fieldId": 138238,
"fieldName": "PY_8900c1409c33487b87e94ebe94b95d4a",
"fieldLabel": "社保缴纳地",
"fieldValueType": 1,
"systemPrefabricated": false,
"editable": true,
"paymentType": 3,
"taxType": 1,
"calculateWay": 1,
"shouldDeductFromPayable": false,
"calculateWayId": 0,
"calculateFormula": "job#DF_5eb90793c57e418188cb94cf546ec9c5",
"ruleType": 1,
"baseDays": 1,
"baseDayId": 0,
"workingDays": 1,
"workingDayId": 0,
"changeRuleType": 1,
"autoReverse": 0,
"roundingMode": 3,
"scale": 0,
"actualScale": 0,
"sort": null,
"existsPreFormulaOption": true,
"preSettingField": true,
"calculateFormulaSnapshot": "任职信息.社保缴纳地",
"automaticCalculateTax": false,
"remarks": ""
}
]
}
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/calculate/rule/detail
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| baseRuleId | 是 | int | 核算规则id（即列表返回的baseId) |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | int | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.baseSetting | Json | 基础设置信息 | |
| data.calculateRule | Json | 计算规则信息 |
返回结果data.baseSetting说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.baseSetting.name | String | 名称 | |
| data.baseSetting.hrList | JsonArray | 适用HR | |
| data.baseSetting.cycle | int | 核算频率 1：月度；2： 年度；3：半年度；4：季度； 5：不定期 | |
| data.baseSetting.cycleDetail | int | 计薪周期 核算频率为月度生效 | |
| data.baseSetting.range | int | 算薪范围 1：指定部门 ；2：核算时选择 | |
| data.baseSetting.rangeDtoList | JsonArray |
范围数据传输对象列表（数字） | |
| data.baseSetting.rangeNameDtoList | JsonArray | 范围名称数据传输对象列表，包含ID、名称和使用情况（可为null） | |
| data.baseSetting.additionList | JsonArray | 附加条件列表 | |
| data.baseSetting.effectiveDateStr | String | 生效日期字符串 | |
| data.baseSetting.absentResult | int | 关联考勤结果 1：当月考勤；2：上月考勤；3：与计薪周期一致 | |
| data.baseSetting.month | int | 月份（数字表示） | |
| data.baseSetting.rangeNameStatusDtoList | JsonArray | 范围名称状态数据传输对象列表（空） | |
| data.baseSetting.automaticCalculateTax | int | 是否自动计算税（数字表示）1 是 0 否 | |
| data.baseSetting.specialAdditionalDeductionsDownType | int | 专项附加扣除数据下载时机 1：每次核算时下载税局最新数据，2：员工在核算活动内首次核算时下载税局数据，支持手动更新 |
返回结果data.calculateRule说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.calculateRule.rules | JsonArray | 规则列表 |
返回结果data.calculateRule.rules说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.calculateRule.rules.groupId | long | 组ID | |
| data.calculateRule.rules.groupName | String | 组名称 | |
| data.calculateRule.rules.groupLabel | String | 组标签 | |
| data.calculateRule.rules.fieldId | long | 字段ID | |
| data.calculateRule.rules.fieldName | String | 字段名称 | |
| data.calculateRule.rules.fieldLabel | String | 字段标签 | |
| data.calculateRule.rules.fieldValueType | long | 字段值类型 | |
| data.calculateRule.rules.systemPrefabricated | boolean | 是否系统预制 | |
| data.calculateRule.rules.editable | boolean | 是否可编辑 | |
| data.calculateRule.rules.paymentType | int | 收支类型 1：收入；2：支出；3其它 | |
| data.calculateRule.rules.taxType | int | 税收类型 1：税前；2税后 | |
| data.calculateRule.rules.calculateWay | int | 计算方式 1：预置公式；2：自定义公式；3：薪酬核算时录入 | |
| data.calculateRule.rules.shouldDeductFromPayable | boolean | 应发中扣除 0：不扣除；1:扣除 | |
| data.calculateRule.rules.calculateWayId | int | 计算方式ID | |
| data.calculateRule.rules.calculateFormula | String | 计算公式 | |
| data.calculateRule.rules.ruleType | int | 规则类型 | |
| data.calculateRule.rules.baseDays | int | 基本天数 | |
| data.calculateRule.rules.baseDayId | int | 基本天ID | |
| data.calculateRule.rules.workingDays | int | 在职天数 1出勤月报.在职工作日天数+出勤月报.在职法定节假日天数 2薪酬核算时选择 | |
| data.calculateRule.rules.workingDayId | int | 工作日ID | |
| data.calculateRule.rules.changeRuleType | int | 调薪时计算规则 1按调薪后计算 2按照调薪前后薪资标准基于天数计算 | |
| data.calculateRule.rules.autoReverse | int | 计算结果超出整月标准时, 按反算逻辑处理 0否 1是 | |
| data.calculateRule.rules.roundingMode | int | 取整规则 1：向上；2：向下；3：四舍五入 | |
| data.calculateRule.rules.scale | int | 字段设置中小数点位数 | |
| data.calculateRule.rules.actualScale | int | 实际保存的小数点位数 | |
| data.calculateRule.rules.sort | null或int等类型 | 排序（可为null） | |
| data.calculateRule.rules.existsPreFormulaOption | boolean | 是否存在前置公式选项 | |
| data.calculateRule.rules.preSettingField | boolean | 是否是预设字段 | |
| data.calculateRule.rules.calculateFormulaSnapshot | String | 计算公式快照 | |
| data.calculateRule.rules.automaticCalculateTax | boolean | 是否自动计算税 | |
| data.calculateRule.rules.remarks | String | 备注 |
工资核算结果数据接口
接口说明：通过此接口，可以查询员工的工资结果相关信息（应发工资、实发工资、个税等）
返回结果示例
{
"code": 200,
"msg": "操作成功",
"data": {
"total": 214,
"size": 1,
"list": [
{
"employeeId": 108837,
"employeeName": "测试工作履历",
"employeeNo": "Ka8223424209874134043",
"recordData": null,
"salaryAccountList": [
{
"total_company_social_security_provident_fund": "0",
"accumulated_housing_rent": "0",
"cumulative_child_education": "0",
"company_work_injury_insurance": "0",
"company_work_injury_insurance_pay": "0",
"company_medical_insurance": "0",
"total_company_insurance": "0",
"company_medical_insurance_repayment": "0",
"company_maternity_insurance_repayment": "0",
"corporate_unemployment_insurance": "0",
"company_pension_insurance": "0",
"company_pension_insurance_payment": "0",
"total_company_insurance_including_repayment": "0",
"company_maternity_insurance": "0"
}
]
}
],
"labelList": [
{
"fieldName": "company_pension_insurance",
"label": "公司养老保险",
"type": 3
},
{
"fieldName": "company_maternity_insurance",
"label": "公司生育保险",
"type": 3
},
{
"fieldName": "total_company_insurance",
"label": "公司保险合计",
"type": 3
},
{
"fieldName": "company_medical_insurance",
"label": "公司医疗保险",
"type": 3
},
{
"fieldName": "company_work_injury_insurance_pay",
"label": "公司工伤保险补缴",
"type": 3
},
{
"fieldName": "total_company_social_security_provident_fund",
"label": "公司社保公积金合计",
"type": 3
},
{
"fieldName": "cumulative_child_education",
"label": "累计子女教育",
"type": 3
},
{
"fieldName": "company_maternity_insurance_repayment",
"label": "公司生育保险补缴",
"type": 3
},
{
"fieldName": "company_pension_insurance_payment",
"label": "公司养老保险补缴",
"type": 3
},
{
"fieldName": "corporate_unemployment_insurance",
"label": "公司失业保险",
"type": 3
},
{
"fieldName": "company_work_injury_insurance",
"label": "公司工伤保险",
"type": 3
},
{
"fieldName": "company_medical_insurance_repayment",
"label": "公司医疗保险补缴",
"type": 3
},
{
"fieldName": "total_company_insurance_including_repayment",
"label": "公司保险合计(含补缴)",
"type": 3
},
{
"fieldName": "accumulated_housing_rent",
"label": "累计住房租金",
"type": 3
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/account
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【工资核算结果】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组，<=200条 |
| salaryYearAndMonth | 是 | String | 发薪时间,传入格式为：YYYY-MM |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 | |
| data.labelList | JsonArray | 业务数据内容的字段说明 | |
| data.size | int | 返回结果的业务数据条数 | |
| data.total | Long | 总条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.list.employeeId | Long | 员工ID | |
| data.list.employeeName | Long | 员工名称 | |
| data.list.employeeNo | Long | 员工工号 | |
| data.list.recordData | Long | 所属核算活动 | |
| data.list.salaryAccountList | Array | 预置字段与自定义字段的数据 |
数据内容：返回格式均为key:value格式（key为字段名称，value为对应的值）
data.list.recordData字段说明：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| recordId | Long | 活动id | |
| recordName | String | 活动名称 | |
| sendSalaryRange | String | 薪资范围 | |
| sendSalaryRangeTips | String | 薪资范围提示 | |
| taxBeLong | String | 个税所属期 | |
| calcSalaryRange | String集合 | 计算薪资范围 | |
| calcCount | int | 计薪人数 | |
| creator | String | 创建者 | |
| createTime | Date | 创建时间 yyyy-MM-dd HH:mm:ss |
data.list.salaryAccountList字段说明：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| telephone | String | 个人电话 | |
| birthday | String | 出生日期 | |
| gender | String | 性别 | |
| country | String | 国籍 | |
| id_type | String | 证件类型 | |
| tax_option | String | 缴税类型 | |
| corporation | String | 法人公司 | |
| realname | String | 姓名 | |
| employee_no | String | 工号 | |
| id_no | String | 证件号码 | |
| end_probation_date | String | 转正日期 | |
| department | String | 部门 | |
| on_boarding_date | String | 入职日期 | |
| leave_date | String | 离职日期 | |
| end_date | String | 最后发薪日 | |
| basic_wage | String | 基本工资 | |
| communication_subsidy | String | 通讯补贴 | |
| computer_subsidy | String | 电脑补贴 | |
| performance_bonus | String | 绩效奖金 | |
| days_absent_from_work | String | 旷工天数 | |
| length_of_sick_leave | String | 病假天数 | |
| leave_duration | String | 事假天数 | |
| annual_leave_resignation_days | String | 年假离职清算天数 | |
| absenteeism_deduction | String | 旷工扣款 | |
| sick_leave_deduction | String | 病假扣款 | |
| leave_deduction | String | 事假扣款 | |
| total_attendance_deduction | String | 考勤扣款合计 | |
| personal_pension_insurance | String | 个人养老保险 | |
| personal_medical_insurance | String | 个人医疗保险 | |
| individual_unemployment_insurance | String | 个人失业保险 | |
| total_personal_insurance | String | 个人保险合计 | |
| personal_endowment_insurance_payment | String | 个人养老保险补缴 | |
| personal_medical_insurance_repayment | String | 个人医疗保险补缴 | |
| individual_unemployment_insurance_payment | String | 个人失业保险补缴 | |
| total_personal_insurance_payment | String | 个人保险补缴合计 | |
| total_personal_insurance_including_repayment | String | 个人保险合计(含补缴) | |
| personal_provident_fund | String | 个人公积金 | |
| total_personal_social_security_provident_fund | String | 个人社保公积金合计 | |
| company_pension_insurance | String | 公司养老保险 | |
| company_medical_insurance | String | 公司医疗保险 | |
| corporate_unemployment_insurance | String | 公司失业保险 | |
| company_work_injury_insurance | String | 公司工伤保险 | |
| company_maternity_insurance | String | 公司生育保险 | |
| total_company_insurance | String | 公司保险合计 | |
| company_pension_insurance_payment | String | 公司养老保险补缴 | |
| company_medical_insurance_repayment | String | 公司医疗保险补缴 | |
| company_unemployment_insurance_payment | String | 公司失业保险补缴 | |
| company_work_injury_insurance_pay | String | 公司工伤保险补缴 | |
| company_maternity_insurance_repayment | String | 公司生育保险补缴 | |
| total_company_insurance_including_repayment | String | 公司保险合计(含补缴) | |
| company_provident_fund | String | 公司公积金 | |
| total_company_social_security_provident_fund | String | 公司社保公积金合计 | |
| total_company_insurance_repayment | String | 公司保险补缴合计 | |
| cumulative_child_education | String | 累计子女教育 | |
| accumulated_housing_rent | String | 累计住房租金 | |
| accumulated_housing_loan_interest | String | 累计住房贷款利息 | |
| cumulative_support_for_the_elderly | String | 累计赡养老人 | |
| cumulative_continuing_education | String | 累计继续教育 | |
| cumulative_child_care_fee | String | 累计婴幼儿照护费 | |
| cumulative_income_as_of_last_month | String | 累计收入额(截至上月) | |
| cumulative_deductions_as_of_last_month | String | 累计减除费用(截至上月) | |
| cumulative_special_deductions_as_of_last_month | String | 累计专项扣除(截至上月) | |
| cumulative_prepaid_tax_as_of_last_month | String | 累计已预缴税额(截至上月) | |
| quick_deduction | String | 速算扣除数 | |
| tax_rate | String | 税率 | |
| cumulative_income | String | 累计收入额 | |
| cumulative_deductions | String | 累计减除费用 | |
| cumulative_special_deduction | String | 累计专项扣除 | |
| cumulative_special_additional_deduction | String | 累计专项附加扣除 | |
| cumulative_taxable_income | String | 累计应纳税所得额 | |
| tax_payable_as_of_this_month | String | 应预缴税额(截至本月) | |
| actual_prepaid_tax_this_month | String | 实际预缴税额(本月) | |
| year_end_bonus_should_be_given | String | 年终奖应发 | |
| year_end_bonus_tax | String | 年终奖金个税 | |
| year_end_bonus | String | 年终奖实发 | |
| salary_start_date | String | 计薪开始日期 | |
| salary_end_date | String | 计薪结束日期 | |
| overtime | String | 加班费 | |
| resignation_compensation | String | 离职补偿金额 | |
| payable | String | 应发工资 | |
| disability_payment | String | 残障金 | |
| commercial_insurance | String | 商业保险金 | |
| paid_wages | String | 实发工资 | |
| service_charge | String | 服务费 | |
| total_labor_cost | String | 人力成本合计 | |
| tax_period | String | 个税所属期 | |
| payroll_organization | String | 发薪组织 | |
| … | … | 其他自定义字段 |
员工参保档案数据接口
接口说明：通过此接口，可以查询员工的社保、公积金相关参缴信息（社保基数、起缴月份等）
返回结果示例
{
"code": 200,
"msg": "操作成功",
"data": {
"total": 21,
"size": 1,
"list": [
{
"employeeId": 128140,
"eventReason": "调出",
"fundBaseList": [
{
"companyAmount": "12",
"lowerLimitForPersonalBase": "12.00",
"welfareProgramName": "住房公积金",
"upperLimitForCompanyBase": "12.00",
"personAmount": "12",
"welfareProgramId": "1636354064506265",
"lowerLimitForCompanyBase": "12.00",
"upperLimitForPersonalBase": "12.00"
}
],
"fundFieldInfoList": [
{
"fund_mode": {
"fund_mode_id": 1,
"fund_mode_value": "自缴"
},
"fund_scheme": {
"fund_scheme_id": 1642575078053633,
"fund_scheme_value": "1641900111890799",
"fund_scheme_name": "Moka方案"
},
"fund_begin_date": "2021-01",
"fund_social_address": {
"fund_social_address_id": 1641895126212145,
"fund_social_address_value": "河北省"
},
"fund_base": "1000",
"fund_need_pay": "否",
"fund_number": "",
"fund_status": {
"fund_status_value": "停缴",
"fund_status_id": 3
},
"fund_start_date": "2022-01",
"fund_end_date": "2022-01",
"fund_reduce_type": "停缴"
}
],
"insuranceBaseList": [
{
"companyAmount": "12",
"lowerLimitForPersonalBase": "12.00",
"welfareProgramName": "养老保险",
"upperLimitForCompanyBase": "12.00",
"personAmount": "12",
"welfareProgramId": "1636456534991326",
"lowerLimitForCompanyBase": "12.00",
"upperLimitForPersonalBase": "12.00"
},
{
"companyAmount": "12",
"lowerLimitForPersonalBase": "60.00",
"welfareProgramName": "医疗保险",
"upperLimitForCompanyBase": "12.00",
"personAmount": "60",
"welfareProgramId": "1636456534992754",
"lowerLimitForCompanyBase": "12.00",
"upperLimitForPersonalBase": "60.00"
}
],
"insuranceFieldInfoList": [
{
"insurance_begin_date": "2021-01",
"insurance_type": {
"insurance_type_value": "新参保",
"insurance_type_id": 1
},
"insurance_mode": {
"insurance_mode_value": "自缴",
"insurance_mode_id": 1
},
"insurance_social_address": {
"insurance_social_address_id": 1641895126264391,
"insurance_social_address_value": "北京市-朝阳区"
},
"insurance_end_date": "2021-12",
"insurance_need_pay": "否",
"insurance_scheme": {
"insurance_scheme_value": "1641888724218801",
"insurance_scheme_id": 1642574944262126,
"insurance_scheme_name": "北京市2022"
},
"insurance_start_date": "2021-12",
"insurance_status": {
"insurance_status_id": 4,
"insurance_status_value": "调出"
}
}
]
}
],
"labelList": [
{
"fieldName": "fund_need_pay",
"label": "是否缴存公积金",
"type": 4
},
{
"fieldName": "fund_mode",
"label": "公积金缴交方式",
"type": 5
},
{
"fieldName": "fund_social_address",
"label": "公积金缴纳地",
"type": 41
},
{
"fieldName": "fund_scheme",
"label": "公积金方案",
"type": 26
},
{
"fieldName": "fund_end_date",
"label": "公积金停止月份",
"type": 2
},
{
"fieldName": "fund_start_date",
"label": "公积金生效月份",
"type": 2
},
{
"fieldName": "fund_number",
"label": "个人公积金账号",
"type": 1
},
{
"fieldName": "fund_base",
"label": "公积金基数",
"type": 3
},
{
"fieldName": "fund_status",
"label": "公积金状态",
"type": 5
},
{
"fieldName": "fund_begin_date",
"label": "公积金起缴月份",
"type": 2
},
{
"fieldName": "insurance_social_address",
"label": "社保缴纳地",
"type": 41
},
{
"fieldName": "insurance_mode",
"label": "社保缴交方式",
"type": 5
},
{
"fieldName": "DF_49505680195a4b5b9fba5e3e40cf84ec",
"label": "社保-社保数字社保数字社保数字社保数字社保数字",
"type": 3
},
{
"fieldName": "insurance_scheme",
"label": "社保方案",
"type": 26
},
{
"fieldName": "insurance_start_date",
"label": "社保生效月份",
"type": 2
},
{
"fieldName": "insurance_begin_date",
"label": "社保起缴月份",
"type": 2
},
{
"fieldName": "insurance_end_date",
"label": "社保停止月份",
"type": 2
},
{
"fieldName": "insurance_status",
"label": "社保状态",
"type": 5
},
{
"fieldName": "DF_055a4b3e6a4648a4839607b1881098d4",
"label": "社保-社保日期",
"type": 2
},
{
"fieldName": "insurance_type",
"label": "参保类型",
"type": 5
},
{
"fieldName": "insurance_need_pay",
"label": "是否缴纳社保",
"type": 4
},
{
"fieldName": "fund_reduce_type",
"label": "公积金减员类型",
"type": 1
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/social
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工参保档案】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组，<=200条 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.list | JsonArray | 返回结果的业务数据内容 | |
| data.labelList | JsonArray | 业务数据内容的字段说明 | |
| data.size | int | 返回结果的业务数据条数 | |
| data.total | Long | 总条数 |
返回结果data.list说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| data.list.employeeId | Long | 员工ID | |
| data.list.eventReason | String | 变动原因 | |
| data.list.fundBaseList | Array | 公积金项目列表 | |
| data.list.fundFieldInfoList | Array | 公积金预置字段与自定义字段的数据 | |
| data.list.insuranceBaseList | Array | 社保项目列表 | |
| data.list.insuranceFieldInfoList | Array | 社保项目列表预置字段与自定义字段的数据 |
数据内容：返回格式均为key:value格式（key为字段名称，value为对应的值）
data.list.fundBaseList 字段说明：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| welfareProgramId | String | 项目Id | |
| welfareProgramName | String | 项目名称 | |
| companyAmount | String | 公司基数 | |
| lowerLimitForCompanyBase | String | 公司下限 | |
| upperLimitForCompanyBase | String | 公司上限 | |
| personAmount | String | 个人基数 | |
| lowerLimitForPersonalBase | String | 个人下限 | |
| upperLimitForPersonalBase | String | 个人上限 |
data.list.fundFieldInfoList 字段说明：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| fund_need_pay | 是否缴存公积金 | ||
| fund_mode | 公积金缴交方式 | ||
| fund_social_address | 公积金缴存地 | ||
| fund_scheme | 公积金方案 | ||
| fund_base | 公积金基数 | ||
| fund_number | 个人公积金账号 | ||
| fund_begin_date | 公积金起缴月份 | ||
| fund_start_date | 公积金生效月份 | ||
| fund_end_date | 公积金停止月份 | ||
| fund_status | 公积金状态 | ||
| fund_reduce_type | 公积金减员类型 | ||
| new_fund_address | 新公积金缴存地 | ||
| … | … | 其他自定义字段 |
data.list.insuranceBaseList 字段说明：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| welfareProgramId | String | 险种id | |
| welfareProgramName | String | 险种 | |
| companyAmount | String | 公司基数 | |
| lowerLimitForCompanyBase | String | 公司下限 | |
| upperLimitForCompanyBase | String | 公司上限 | |
| personAmount | String | 个人基数 | |
| lowerLimitForPersonalBase | String | 个人下限 | |
| upperLimitForPersonalBase | String | 个人上限 |
data.list.insuranceFieldInfoList 字段说明：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| insurance_need_pay | 是否缴纳社保 | ||
| insurance_type | 参保类型 | ||
| insurance_mode | 社保缴交方式 | ||
| insurance_social_address | 社保缴纳地 | ||
| insurance_scheme | 社保方案 | ||
| insurance_base | 社保基数 | ||
| insurance_number | 个人社保账号 | ||
| insurance_begin_date | 社保起缴月份 | ||
| insurance_start_date | 社保生效月份 | ||
| insurance_end_date | 社保停止月份 | ||
| insurance_status | 社保状态 | ||
| insurance_reduce_type | 社保减员类型 | ||
| new_insurance_address | 新社保缴纳地 | ||
| … | … | 其他自定义字段 |
员工薪酬核算活动查询接口
接口说明：通过此接口，可以查询员工所属的薪酬活动
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/salary/calculate/list_salary_calculate
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪酬核算活动查询】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 否 | Array<Long> | 员工ID列表/数组，<=200条 |
| recordId | 否 | Long | 薪酬核算活动id |
| recordStatus | 否 | String | 核算活动状态 PROCESSING：处理中 ，ARCHIVED：已归档 DELETED：已删除 |
| salaryYearAndMonth | 否 | String | 发薪所属年月 格式 yyyy-MM |
| pageSize | 是 | int | 分页大小，不超过200 |
| nextCursor | 是 | int | 游标（页码），大于1 |
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| hasMore | boolean | 是否有更多数据,true标识还有 | |
| nextCursor | int | 下一页标识，当hasMore为true时，下次查询传此nextCursor | |
| list | Array | 见下面list | |
| └recordId | Long | 薪酬核算活动id | |
| └recordName | String | 薪酬核算活动名称 | |
| └recordStatus | String | 核算活动状态 PROCESSING：处理中 ，ARCHIVED：已归档 DELETED：已删除 | |
| └taxBelong | String | 个税所属期 | |
| └calcSalaryRange | List |
算薪范围 | |
| └sendSalaryRange | String | 发薪所属年月 | |
| └employeeIdList | String | 核算活动中包含的请求参数中的员工list | |
| └startDate | Long | 开始日期，格式：yyyy-MM-dd | |
| └endDate | String | 结束日期，格式：yyyy-MM-dd |
结果示例：
{
"code": 200,
"msg": "成功",
"data": {
"nextCursor": null,
"hasMore": false,
"list": [
{
"recordId": 1698733230770537,
"recordName": "hxh_2023年10月",
"recordStatus": "PROCESSING",
"taxBelong": "2023-10",
"calcSalaryRange": [
"29号生效"
],
"sendSalaryRange": "2023-10",
"employeeIdList": null,
"startDate": "2023-09-05",
"endDate": "2023-10-04"
}
]
}
}
员工薪酬核算活动写接口
接口说明：通过此接口，可以写入员工所属的薪酬活动，注意：仅支持计算方式为薪酬核算时录入的项目，且当核算活动创建工资单后无法写入
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/salary/calculate/write_calculate_record
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪酬核算活动】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| salaryRecordList | 是 | Array | 见下面list，单条不能超过1000条 |
| └recordId | 是 | Long | 薪酬核算活动id |
| └employeeId | 是 | Long | 员工id不能为空 |
| └salaryRecordMap | 是 | Map |
需要写入的字段，该字段需要在moka页面查找需要写入的字段，注意只能写入【核算时录入】的字段，非【核算时录入】字段写入时会被忽略，不会报错。格式校验出错时，会在错误列表errors返回 |
请求示例：
{
"salaryRecordList": [
{
"recordId": 1697628651578313,
"employeeId": 75767250,
"salaryRecordMap": {
"performance_bonus": "666eee"
}
},
{
"recordId": 1695709976328199,
"employeeId": 75767250,
"salaryRecordMap": {
"performance_bonus": "999"
}
},
{
"recordId": 1696996369995128,
"employeeId": 75767250,
"salaryRecordMap": {
"performance_bonus": "666eee"
}
}
]
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| writeSuccess | boolean | 字段格式校验是否通过，不通过时返回errors | |
| errors | Array | 对应字段错误的具体信息，见下面list | |
| └recordId | Long | 薪酬核算活动id | |
| └employeeId | Long | 员工id | |
| └msg | String | 错误信息详情 |
结果示例：
{
"code": 200,
"msg": "操作成功",
"data": {
"writeSuccess": false,
"errors": [
{
"employeeId": 75767250,
"recordId": 1696996369995128,
"msg": "performance_bonus:格式错误（需要为数字格式）;\n"
},
{
"employeeId": null,
"recordId": 1697628651578313,
"msg": "数据不存在"
}
]
}
}
获取发薪组织
接口说明：支持指定发薪组织查询，不传入发薪组织Id时，返回当前租户所有启用中的发薪组织
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/query/organization/payroll
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪酬核算活动】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| salaryOrgId | 否 | Long | 如果没填写，会返回全部的发薪组织 |
请求示例：
{"salaryOrgId":"147880"}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | JsonArray | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| salaryOrgId | String | 发薪组织ID | |
| salaryOrgName | String | 发薪组织名称 | |
| effectDate | String | 生效日期 | |
| salaryOrgDirector | Json | 发薪组织负责人 | |
| salaryOrgDirector.salaryOrgDirectorId | String | 发薪组织负责人员工id | |
| salaryOrgDirector.salaryOrgDirectorNo | String | 发薪组织负责人员工工号 | |
| remark | String | 备注 |
结果示例：
{
"code": 200,
"msg": "操作成功",
"data": [
{
"salaryOrgId": "147880",
"salaryOrgName": "默认发薪组织",
"effectDate": "2023-02-26 00:00:00",
"salaryOrgDirector": {
"salaryOrgDirectorId": "103726",
"salaryOrgDirectorNo": "20230402"
},
"remark": "备注"
}
]
}
获取薪资计划详情
接口说明：支持指定薪资计划查询，不传入薪资计划Id时，返回当前租户所有启用中的薪资计划
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/query/plan/detail
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪酬核算活动】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| salaryPlanId | 否 | Long | 如果没填写，会返回全部的薪资计划 |
请求示例：
{"salaryPlanId":"1660201627358772"}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | JsonArray | 见下面data |
返回结果data说明
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| salaryPlanId | String | 薪资计划ID | |
| salaryPlanName | String | 薪资计划名称 | |
| salaryProjectList | Array | 薪资标准项目 | |
| salaryProjectList.salaryProjectId | String | 薪资标准项目ID | |
| salaryProjectList.salaryProjectName | String | 薪资标准项目名称 | |
| salaryProjectList.salaryProjectType | String | 薪资标准项目定薪方式 | 1：手动定薪 2：固定标准 3：薪资等级表 |
| salaryProjectList.salaryProjectValue | Integer | 固定标准值，单位元 | |
| salaryProjectList.probation | Boolean | 是否有试用期标准枚举值 true:是 false：否 |
结果示例：
{
"code": 200,
"msg": "操作成功",
"data": [
{
"salaryPlanId": "1722500843759954",
"salaryPlanName": "添加薪资计划",
"salaryProjectList": [
{
"salaryProjectId": "154",
"salaryProjectName": "基本薪资",
"salaryProjectType": "1",
"salaryProjectValue": "0.00",
"probation": true
},
{
"salaryProjectId": "157",
"salaryProjectName": "绩效基数",
"salaryProjectType": "1",
"salaryProjectValue": "0.00",
"probation": false
},
{
"salaryProjectId": "156",
"salaryProjectName": "保底提成",
"salaryProjectType": "1",
"salaryProjectValue": "0.00",
"probation": false
},
{
"salaryProjectId": "942",
"salaryProjectName": "Test-等级薪资123123",
"salaryProjectType": "1",
"salaryProjectValue": "0.00",
"probation": false
},
{
"salaryProjectId": "2043",
"salaryProjectName": "项目B1",
"salaryProjectType": "1",
"salaryProjectValue": "0.00",
"probation": true
},
{
"salaryProjectId": "264",
"salaryProjectName": "项目a2",
"salaryProjectType": "1",
"salaryProjectValue": "0.00",
"probation": true
}
]
}
]
}
更新待入职员工薪资档案
接口说明：一次支持一个员工的薪资档案更新，落地时无数据则创建，有数据则更新 薪资异动默认为入职定薪
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v1/salary/save/offer/salary/info
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工薪酬核算活动】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| onBoardingUid | 否 | Long | 待入职员工id,与employeeNo二选一 |
| employeeNo | 否 | String | 工号,与onBoardingUid二选一 |
| startDate | 是 | String | 起薪日期 |
| salaryPlanId | 否 | String | 薪资计划Id |
| salaryProjectList | 否 | Array | 薪资标准项目 |
| salaryProjectList.salaryProjectId | 是 | String | 薪资标准项目ID |
| salaryProjectList.probation | 是 | Boolean | 是否有试用期标准枚举值 true:是 false：否 |
| salaryProjectList.probateSalary | 是 | String | 试用期薪资标准 |
| salaryProjectList.regularSalary | 是 | Integer | 转正后薪资标准 |
| taxOptionId | 是 | String | 缴税类型 |
| salaryOrgId | 是 | String | 发薪组织Id |
| remark | 否 | String | 备注 |
| extendFields | 否 | Array | 其他自定义字段 |
| extendFields.fieldName | 是 | String | 字段唯一name |
| extendFields.fieldValue | 是 | String | 字段值 |
请求示例：
{
"onBoardingUid": "",
"employeeNo": "QA000056",
"startDate": "2024-07-28",
"salaryPlanId": "1675850152757812",
"salaryProjectList": [
{
"salaryProjectId": "154",
"probation":true,
"probateSalary": "8888",
"regularSalary": "888"
},
{
"salaryProjectId": "157",
"probation":false,
"probateSalary": "8888",
"regularSalary": "7777"
}
],
"taxOptionId": "1",
"salaryOrgId": "239438",
"remark": "yc添加的备注",
"extendFields": [
{"fieldName":"DF_ef92c1771b424c448ba7142c28322004",
"fieldValue":"2024-07-12"},
{"fieldName":"DF_33087e9a01034ff280eed0f287e94115",
"fieldValue":"2222这是单行文本"},
{"fieldName":"DF_38a9d4071f374277bebb200e67476761",
"fieldValue":"222这是多多多多行文本"},
{"fieldName":"DF_560995c47ced43c4ac38d467be7600b7",
"fieldValue":"131411"},
{"fieldName":"DF_31f3daf86d3b47f188955dd1d84c944c",
"fieldValue":"2"}
]
}
响应体 Response Body
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 |
结果示例：
{
"code": 200,
"msg": "操作成功"
}
绩效接口API
绩效结果方案查询接口
接口说明：查询租户下所有启用的绩效结果方案
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/allEnableResultPlan
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID；在Moka People系统"设置" - 对外设置"中显示 填写【绩效结果方案查询接口】数据源的apiCode |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体：Request Body, JSON格式
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
返回结果
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| code | Long | 返回结果的状态码 |
| msg | String | 返回结果的状态信息 |
| data | obj | 返回结果的数据 |
返回结果data说明
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| resultPlanList | List | 绩效结果方案列表 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| bizType | integer | 业务类型 |
| resultPlanId | integer | 绩效结果方案id |
| resultPlanName | string | 绩效结果方案名称 |
| type | integer | 绩效结果方案类型：1:单个绩效结果，2：多个绩效结果 |
| enabled | integer | 启用状态：1-启用，0-停用 |
| resultTypeList | object [] | 结果类型列表 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| resultPlanDetailId | integer | 绩效结果方案明细id |
| resultTypeId | integer | 结果类别id |
| resultTypeName | string | 结果类别名称 |
| enabledResultGeneralRating | integer | 是否启用评级：1-启用，0-停用 |
| resultGeneralRatingAlias | string | 绩效总评级别名 |
| finalResultGeneralRatingAlias | string | 绩效结果总评级别名 |
| enabledResultGeneralScore | integer | 是否启用评分：1-启用，0-停用 |
| resultGeneralScoreAlias | string | 绩效总评分别名 |
| finalResultGeneralScoreAlias | string | 绩效结果总评分别名 |
绩效等级规则查询接口
接口说明：查询租户下所有启用的绩效等级规则
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/allEnableOverallRatingRule
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID；在Moka People系统"设置" - 对外设置"中显示 填写【绩效等级规则查询接口】数据源的apiCode |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体：Request Body, JSON格式
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
返回结果
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| code | Long | 返回结果的状态码 |
| msg | String | 返回结果的状态信息 |
| data | obj | 返回结果的数据 |
返回结果data说明
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| overallRatingList | List | 绩效等级列表 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| overallRatingId | string | 绩效等级id |
| name | string | 绩效等级名称 |
| description | string | 说明 |
| type | integer | 计算方式，1-自动计算 2-手动填写 |
| enabled | integer | 启用状态：0-停用，1-启用 |
| overallRatingRanges | object [] | 启用的绩效等级范围 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| overallRatingRangeId | integer | 绩效等级范围id |
| name | string | 名称 |
| description | string | 说明 |
| minScore | number | 最小值 |
| maxScore | number | 最大值 |
| enabled | integer | 启用状态：0-停用，1-启用 |
| scopeType | integer | 区间类型：1-介于含边界值，2-介于仅含最大值，3-介于仅含最小值 |
| color | string | 颜色 |
| sort | integer | 排序 |
| rank | integer | 等级排名，0-未设置，1-优，2-良，3-差 |
绩效活动查询接口
接口说明：查询绩效活动详情（包含维度信息、环节信息以及被评估人）
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/allActivityDetail
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID；在Moka People系统"设置" - 对外设置"中显示 填写【绩效活动查询接口】数据源的apiCode |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体：Request Body, JSON格式
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| activityId | String | 否 | 活动id |
| activityStatus | String | 是 | (1, "待启动"), (2, "评估中"), (3, "已归档"), (4, "已删除"); |
| periodSectionType | Integer | 否 | YEAR(1, "年度"), HALF_YEAR(2, "半年度"), QUARTER(3, "季度"), DOUBLE_MONTH(4, "双月度"), MONTH(5, "月度"), CUSTOM(6, "自定义"); |
| periodStart | Date | 否 | 评估周期开始时间(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") |
| periodEnd | Date | 否 | 评估周期结束时间(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") |
| pageSize | Integer | 否 | 分页大小，如果不传默认200 |
| nextCursor | Integer | 否 | 分页标记，第一次查询时不传，后续使用上一次查询时返回nextCursor |
返回结果
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| code | Long | 返回结果的状态码 |
| msg | String | 返回结果的状态信息 |
| data | obj | 返回结果的数据 |
| data.list | List | 返回结果的业务数据内容 |
| data.hasMore | boolean | 是否还有下一页 |
| data.nextCursor | Integer | 下一页分页标识 |
返回结果data说明
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| activityDetailList | List | 活动详情列表 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| activityId | String | 活动id |
| activityName | String | 活动名称 |
| activityDescription | String | 活动备注 |
| activityStatus | String | (1, "待启动"), (2, "评估中"), (3, "已归档"); |
| periodSectionType | Integer | YEAR(1, "年度"), HALF_YEAR(2, "半年度"), QUARTER(3, "季度"), DOUBLE_MONTH(4, "双月度"), MONTH(5, "月度"), CUSTOM(6, "自定义") |
| periodStart | Date | 评估周期开始时间(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") |
| periodEnd | Date | 评估周期结束时间(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") |
| activityGroupList | List | 评估组列表 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| evaluationGroupId | String | 评估组id |
| evaluationGroupName | String | 评估组名称 |
| stepList | List | 评估组下所有环节信息 |
| sectionList | List | 评估组下所有维度信息 |
| examineeList | List | 评估组下所有被评估人信息 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| stepId | String | 环节id |
| stepName | String | 环节名称 |
| stepStatus | Integer | 环节状态 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| sectionId | String | 维度id |
| sectionName | String | 维度名称 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| examineeId | String | 被评估人id |
员工绩效结果查询接口
接口说明：查询绩效活动下员工的绩效结果
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/examinee/result
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID；在Moka People系统"设置" - 对外设置"中显示 填写【员工绩效结果查询接口】数据源的apiCode |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体：Request Body, JSON格式
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| activityId | String | 是 | 活动id |
| employeeIdList | List |
否 | 被评估人id列表 |
| pageSize | Integer | 否 | 分页大小，如果不传默认200 |
| nextCursor | Integer | 否 | 分页标记，第一次查询时不传，后续使用上一次查询时返回nextCursor |
返回结果
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| code | Long | |
| msg | String | |
| data | obj | |
| data.list | JsonArray | 返回结果的业务数据内容 |
| data.hasMore | boolean | 是否还有下一页 |
| data.nextCursor | Integer | 下一页分页标识 |
返回结果dataLIst说明
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| activityId | String | 活动id |
| resultPlanId | integer | 绩效结果方案id |
| employeeId | String | 员工ID |
| overallRatingComment | String | 整体评语 |
| overallRatingResultList | List | 员工绩效结果 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| resultTypeId | String | 结果类型ID |
| resultTypeName | String | 方案名称 |
| score | String | 评分 |
| rating | String | 评级项id |
| ratingName | String | 评级项名称 如：S,A,B |
| ratingInfo | String | 评级说明 |
| color | String | 颜色 |
员工目标详情查询接口
接口说明：查询绩效活动中员工的目标详情
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/examinee/target
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID；在Moka People系统"设置" - 对外设置"中显示 填写【员工目标详情查询接口】数据源的apiCode |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体：Request Body, JSON格式
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| activityId | String | 是 | 活动id |
| employeeIdList | List |
否 | 被评估人id列表 |
| evaluationGroupId | String | 否 | 评估组id |
| evaluationGroupName | String | 否 | 评估组名称 |
| sectionId | String | 否 | 维度id |
| sectionName | String | 否 | 维度名称 |
| pageSize | Integer | 否 | 分页大小，如果不传默认200 |
| nextCursor | Integer | 否 | 分页标记，第一次查询时不传，后续使用上一次查询时返回nextCursor |
返回结果
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| code | Long | |
| msg | String | |
| data | obj | |
| data.list | JsonArray | 返回结果的业务数据内容 |
| data.hasMore | boolean | 是否还有下一页 |
| data.nextCursor | Integer | 下一页分页标识 |
返回结果dataLIst说明
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| activityId | String | 活动id |
| employeeId | String | 被评估人id |
| evaluationGroupId | String | 评估组id |
| sectionList | List | 维度列表 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| sectionId | String | 纬度id |
| sectionType | Integer | 维度类型：1-自定义，2-价值观，3-指标评估，4-结果确认，5-面谈, 6-okr , 7-绩效结果 |
| sectionName | String | 维度名称 |
| sectionDescription | String | 维度描述 |
| sectionWeightType | Integer | 维度权重类型：1-无权重，2-固定权重，3-指标权重之和 |
| sectionWeightNum | BigDecimal | 维度权重 |
| targetList | List | 指标列表 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| targetId | String | 指标id |
| targetSourceId | String | 指标库指标id |
| targetName | String | 指标名称 |
| targetDesc | String | 指标描述 |
| weight | BigDecimal | 指标权重 |
| targetTypeId | String | 指标类型id |
| childTargetList | List | 子指标集合-仅okr类型维度有 |
| targetFieldResultList | List | 指标字段集合 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| fieldName | String | 字段标识 |
| label | String | 标签 |
| type | Byte | 字段类型 |
| unit | String | 单位 |
| enabledOptionList | List | 启用的选项列表 |
| disabledOptionList | List | 停用的选项列表 |
| value | List | 字段下面的具体值,如果是多选,直接存储json |
| alias | String | 别名 |
| sort | Integer | 排序 |
| targetTypeFieldId | String | 指标类型字段id |
目标字段查询接口
接口说明：查询绩效活动中员工不同维度下目标字段详情
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/activity/targetField
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID；在Moka People系统"设置" - 对外设置"中显示 填写【目标字段查询接口】数据源的apiCode |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体：Request Body, JSON格式
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| activityId | String | 是 | 活动id |
| evaluationGroupId | String | 否 | 评估组id |
| evaluationGroupName | String | 否 | 评估组名称 |
| sectionId | String | 否 | 维度id |
| sectionName | String | 否 | 维度名称 |
返回结果
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| code | Long | |
| msg | String | |
| data | obj |
返回结果data说明
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| evaluationGroupList | List | 评估组列表 |
| activityId | String | 活动id |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| evaluationGroupId | String | 评估组ID |
| evaluationGroupName | String | 评估组名称 |
| sectionList | List | 维度列表 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| sectionId | String | 维度ID |
| sectionName | String | 维度名称 |
| targetList | List | 指标列表 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| targetId | String | 指标id |
| targetSourceId | String | 指标库指标id |
| targetName | String | 指标名称 |
| targetDesc | String | 指标描述 |
| weight | BigDecimal | 指标权重 |
| targetTypeId | String | 指标类型id |
| childTargetList | List | 子指标集合-仅okr类型维度有 |
| targetFieldResultList | List | 指标字段集合 |
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| fieldName | String | 字段标识 |
| label | String | 标签 |
| type | Byte | 字段类型 |
| unit | String | 单位 |
| enabledOptionList | List | 启用的选项列表 |
| disabledOptionList | List | 停用的选项列表 |
| value | List | 字段下面的具体值,如果是多选,直接存储json |
| alias | String | 别名 |
| sort | Integer | 排序 |
| targetTypeFieldId | String | 指标类型字段id |
员工绩效结果回写接口
接口说明:回写员工绩效结果
接口示例：
POST https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/adjust/examinee/result
Content-Type: application/json
{
"activityId": 202837732325777408,
"examineeId": 103134,
"remark": "调整一下绩效结果",
"overallComments": "做的很棒，继续加油",
"overallRatingList": [
{
"resultTypeId": 121279006855217152,
"overallRatingRangeId": 146225454268891141,
"overallRatingScore": 1
},
{
"resultTypeId": 121279091710181376,
"overallRatingRangeId": 139020784987754501,
"overallRatingScore": 1
},
{
"resultTypeId": 121279131312799744,
"overallRatingRangeId": 136496467343953928,
"overallRatingScore": 1
},
{
"resultTypeId": 121279177370451968,
"overallRatingRangeId": 73004511868735492,
"overallRatingScore": 1
}
],
"entId": 275,
"buId": 276
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/adjust/examinee/result
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID；在Moka People系统"设置" - 对外设置"中显示 填写【员工绩效结果回写接口】数据源的apiCode |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体：Request Body, JSON格式
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| activityId | String | 是 | 活动id |
| examineeId | String | 是 | 被评估人 |
| remark | String | 否 | 调整原因 |
| overallComments | String | 否 | 整体评语 |
| overallRatingList | List | 是 | 绩效结果列表 |
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| resultTypeId | String | 是 | 结果类型id |
| overallRatingRangeId | String | 是 | 评级id |
| overallRatingScore | String | 是 | 评分 |
返回结果
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| code | Long | 返回结果的状态码 |
| msg | String | 返回结果的状态信息 |
| data | obj | 返回结果的数据内容 |
员工目标详情添加接口
接口说明：添加活动中某个员工的员工目标
接口示例：
POST https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/add/examinee/target
hcm-user: {"uid": 151147}
Content-Type: application/json
{
"activityId": 202837732325777408,
"examineeId": 103134,
"sectionList":[{
"sectionId": 198394011583614976,
"targetList": [
{
"targetTypeId": "58042136840212480",
"weight": null,
"targetFieldResultList": [
{
"fieldName": "target_name",
"value": [
"完成情况+2"
]
},
{
"fieldName": "DF_3c3ae21602a343ed8d6463488234b1b4",
"value": [
],
},
{
"fieldName": "target_desc",
"value": [
"双月工作成果111+2"
],
},
{
"fieldName": "evaluation_criterion",
"value": [
"事业部策略目标和科学运营：可量化部分可设置的基线目标，绩效的分=实际值/基线值+2"
],
},
{
"fieldName": "completion_desc",
"value": [],
}
],
}
]}],
"entId": 275,
"buId": 276
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/add/examinee/target
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID；在Moka People系统"设置" - 对外设置"中显示 填写【员工目标详情添加接口】数据源的apiCode |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体：Request Body, JSON格式
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| activityId | String | 是 | 活动id |
| examineeId | String | 是 | 被评估人 |
| sectionList | List | 是 | 维度列表 |
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| sectionId | String | 是 | 维度id |
| targetList | List | 是 | 指标列表 |
| 字段 | 字段类型 | 必填 | 字段描述 |
|---|---|---|---|
| weight | BigDecimal | 否 | 指标权重 |
| targetSourceId | String | 否 | 指标库指标id |
| targetTypeId | String | 是 | 指标类型id |
| childTargetList | List | 否 | 子指标集合-仅okr类型维度有 |
| targetFieldResultList | List | 是 | 指标字段集合 |
| 字段 | 字段类型 | 必填 | 字段描述 |
|---|---|---|---|
| fieldName | String | 是 | 字段标识 |
| value | List | 是 | 字段下面的具体值,如果是多选,直接存储json |
返回结果
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| code | Long | 返回结果的状态码 |
| msg | String | 返回结果的状态信息 |
| data | obj | 返回结果的数据内容 |
员工目标详情更新接口
接口说明：更新活动中某个员工的员工目标
接口示例：
POST https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/update/examinee/target
hcm-user: {"uid": 151147}
Content-Type: application/json
{
"activityId":202837732325777408,
"examineeId":103134,
"targetList":[
{
"targetId":"221288720590766080",
"targetTypeId":"58042136840212480",
"weight":null,
"targetFieldResultList":[
{
"fieldName":"target_name",
"value":[
"完成情况+2"
]
},
{
"fieldName":"DF_3c3ae21602a343ed8d6463488234b1b4",
"value":[
]
},
{
"fieldName":"target_desc",
"value":[
"双月工作成果111+2"
]
},
{
"fieldName":"evaluation_criterion",
"value":[
"事业部策略目标和科学运营：可量化部分可设置的基线目标，绩效的分=实际值/基线值+2"
]
}
]
}
],
"entId":275,
"buId":276
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/perf/update/examinee/target
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID；在Moka People系统"设置" - 对外设置"中显示 填写【员工目标详情更新接口】数据源的apiCode |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体：Request Body, JSON格式
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| activityId | String | 是 | 活动id |
| examineeId | String | 是 | 被评估人 |
| targetList | List | 是 | 指标列表 |
| 字段 | 字段类型 | 必填 | 字段描述 |
|---|---|---|---|
| weight | BigDecimal | 否 | 指标权重 |
| targetId | String | 否（更新非指标库指标时必填） | 指标id |
| targetSourceId | String | 否 | 指标库指标id |
| targetTypeId | String | 否 | 指标类型id |
| childTargetList | List | 否 | 子指标集合-仅okr类型维度有 |
| targetFieldResultList | List | 是 | 指标字段集合 |
| 字段 | 字段类型 | 必填 | 字段描述 |
|---|---|---|---|
| fieldName | String | 是 | 字段标识 |
| value | List | 是 | 字段下面的具体值,如果是多选,直接存储json |
返回结果
| 字段 | 字段类型 | 字段描述 |
|---|---|---|
| code | Long | 返回结果的状态码 |
| msg | String | 返回结果的状态信息 |
| data | obj | 返回结果的数据内容 |
自定义分组接口API
Moka People提供了针对员工自定义分组字段的回写接口； 该自定义分组字段特指员工信息设置中【其他信息】下，添加的自定义分组，以及对应分组下字段 本接口是根据【自定义分组的数据结构】来新增或更新，员工对应分组下的信息。 每个自定义分组，可以视为一个模版，会有对应的模版ID和模版名称
自定义分组回写有以下几个步骤：
- 查询自定义分组相关字段定义情况：了解自定义分组的数据结构
- 查询员工自定义分组数据：查询员工当前自定义分组中已有的数据
- 新增或者修改员工自定义分组字段值
查询自定义分组定义字段接口
接口说明：通过此接口，可以查询自定义分组的数据结构（eg：培训信息分组，包含字段：课程名称、开始日期、结束日期、学习成绩）
请求示例：
{
"biz": [
"extend"
],
"needValue": false
}
响应实例
{
"code": 0,
"msg": "成功",
"data": [
{
"modelId": 14811,
"modelTitle": "添加分组",
"biz": "extend",
"fieldName": "DF_70b801d2b9ca49ebb1a4a0598627d741",
"enabled": true,
"type": 1,
"attrValues": null,
"label": "单行文本",
"options": ""
},
{
"modelId": 14811,
"modelTitle": "添加分组",
"biz": "extend",
"fieldName": "DF_33da00306da64022a36fac99fc43d589",
"enabled": true,
"type": 11,
"attrValues": null,
"label": "自定义分组多行文本",
"options": ""
},
{
"modelId": 14811,
"modelTitle": "添加分组",
"biz": "extend",
"fieldName": "DF_444a723672624c8082ffb3f5b70dd108",
"enabled": true,
"type": 2,
"attrValues": null,
"label": "自定义分组日期",
"options": ""
},
{
"modelId": 14811,
"modelTitle": "添加分组",
"biz": "extend",
"fieldName": "DF_1d9a733d27d24e4eaaac0c2b4c01c235",
"enabled": true,
"type": 4,
"attrValues": null,
"label": "自定义分组是否",
"options": ""
},
{
"modelId": 14811,
"modelTitle": "添加分组",
"biz": "extend",
"fieldName": "DF_c3d1423f37ef4518a5af15ab379b4317",
"enabled": true,
"type": 7,
"attrValues": null,
"label": "自定义分组电话",
"options": "[{\"label\":\"区号\",\"name\":\"country_code\",\"value\":[],\"ref\":\"phone_code\"}]"
},
{
"modelId": 14811,
"modelTitle": "添加分组",
"biz": "extend",
"fieldName": "DF_caae1890a6174591b1bb7ab6bc5ccebb",
"enabled": true,
"type": 5,
"attrValues": null,
"label": "自定义分组单选",
"options": ""
},
{
"modelId": 14811,
"modelTitle": "添加分组",
"biz": "extend",
"fieldName": "DF_607d4fd24e354b9089d835a9cc86bcc4",
"enabled": true,
"type": 9,
"attrValues": null,
"label": "自定义分组证件",
"options": "[{\"label\":\"证件类型\",\"name\":\"id_type\",\"value\":[],\"ref\":\"id_type\"}]"
},
{
"modelId": 14812,
"modelTitle": "1",
"biz": "extend",
"fieldName": "DF_0889753200f842839a55e8f02b0e8f18",
"enabled": true,
"type": 1,
"attrValues": null,
"label": "13",
"options": ""
},
{
"modelId": 23171,
"modelTitle": "2",
"biz": "extend",
"fieldName": "DF_7d3e6882397643cf8fbcc939af6234fd",
"enabled": true,
"type": 1,
"attrValues": null,
"label": "1",
"options": ""
}
]
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/getEmployeeModelAttrList
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【查询员工自定义分组字段定义】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| biz | 是 | Array<String> | 业务类型编码列表/数组 （填：extend，代表自定义分组） |
| needValue | 否 | Boolean | 是否返回attrValues字段 |
自定义分组字段定义响应
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Array | 返回结果的数据内容 | |
| data[].modelId | Long | 自定义分组，模版ID | |
| data[].modelTitle | String | 自定义分组，模版名称 | |
| data[].biz | String | 业务标识 | |
| data[].fieldName | String | 字段名称(英文) | |
| data[].enabled | Boolean | 字段是否停用 可选值： true:启用 false:停用 |
|
| data[].type | byte | 字段类型 可选值： 1：单行文本2：日期3：数字4：是非5：单选6：地址7：电话8：附件11：多行文本 |
|
| data[].attrValues | Array | 字段类型为单选时，属性值列表 | |
| data[].attrValues[].enabled | Boolean | 是否启用 可选值： true：启用 false：停用 |
|
| data[].attrValues[].enumId | int | 枚举id | |
| data[].attrValues[].enumValue | String | 枚举值 | |
| data[].label | String | 显示标签。对字段类型进行说明 | |
| data[].options | String | 可选字段。当字段为组合字段时，展示对应的数据结构。eg：证件类型的自定义字段（可选字段包含：证件类型、证件号码、证件开始日期、截止日期等） |
查询自定义分组定义字段数据接口
接口说明：通过此接口，可以查询员工当前，在自定义分组中已有的数据记录（eg：培训经历、奖惩经历、项目经历等）
请求示例
{
"employeeIdList": [
"254590"
],
"returnFieldList": [
{
"biz": "extend",
"fieldName": "DF_0889753200f842839a55e8f02b0e8f18"
}
],
"pageSize": 100,
"pageNum": 1
}
响应实例：
{
"code": 0,
"msg": "成功",
"data": {
"pageNum": 1,
"pageSize": 100,
"total": 1,
"list": [
{
"employeeId": 254590,
"compoundInfos": {
"extend": [
{
"id": 466814,
"numberMap": {},
"stringMap": {
"extend-DF_0889753200f842839a55e8f02b0e8f18": "1-单行文本值1-更新",
"model_id": "14812"
},
"attachmentMap": {},
"addressMap": {},
"idNameMap": {},
"telephoneMap": {},
"dateMap": {},
"whetherMap": {},
"textMap": {}
}
]
}
}
]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/getEmployeeExtendInfos
请求频率：3次/秒/企业, 60次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【查询员工自定义分组字段定义】。 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| employeeIdList | 是 | Array<Long> | 员工ID列表/数组 |
| returnFieldList | 是 | Array<Object> | 返回字段 |
| └biz | 是 | String | 业务类型 |
| └fieldName | 是 | String | 字段名称 |
| enabled | 否 | Boolean | 启用状态（默认：不传就是所有的） 可选值： true：启用 false：停用 |
| pageSize | 是 | int | 分页大小，不超过200 |
| pageNum | 是 | int | 页码 |
自定义分组字段定义响应
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data | Json | 返回结果的数据内容 | |
| data.pageNum | int | 页数 | |
| data.pageSize | int | 每页大小 | |
| data.total | int | 总条数 | |
| data.list | Array | 数据 | |
| data.list[].employeeId | Long | 员工id | |
| data.list[].compoundInfos | Map<String,CompoundResultBo> | 一对多信息 key-为biz | 这里key为extend,value为相关的分组字段和值 |
CompoundResultBo，多行信息结构对象：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | Long | ID | 每个员工自定义分组下的数据记录ID |
| numberMap | Map<String, NumberFieldValueBo> | 数字，对应type=3 | |
| stringMap | Map<String, String> | 单行文本，对应type=1 | 会返回model_id，表示所属分组model |
| attachmentMap | Map<String, List<AttachmentFieldValueBo>> | 附件，对应type=8 | |
| addressMap | Map<String, AddressFieldValueBo> | 地址，对应type=6 | |
| idNameMap | Map<String, SelectFieldValueBo> | 单选，对应type=5 | |
| telephoneMap | Map<String, TelephoneFieldValueBo> | 电话，对应type=7 | |
| dateMap | Map<String, DateFieldValueBo> | 日期，对应type=2 | |
| whetherMap | Map<String, WhetherFieldValueBo> | 是非，对应type=4 | |
| textMap | Map<String, String> | 多行文本，对应type=11 |
NumberFieldValueBo：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| valueLong | Long | Long类型的数值 | |
| valueStr | String | 字符串类型的数值 | |
| unit | String | 单位 |
AttachmentFieldValueBo：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | Long | ID | |
| name | String | 附件名称 | |
| url | String | 地址 |
AddressFieldValueBo：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| province | String | 省code码，例如：北京市：110000 | |
| provinceName | String | 省 | |
| city | String | 市code码 | |
| cityName | String | 市 | |
| county | String | 区code编码 | |
| countyName | String | 区 | |
| value | String | 详细地址 |
SelectFieldValueBo：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | Long | 单选的值 可选值： 1：男2：女 |
|
| name | String | 展示的名字，如："男"和"女"，分别对应id=1和2 | |
| sortNo | int | 排序序号，一般用于展示的顺序 | |
| isDelete | Byte | 删除状态 可选值： 0：不可删除1：未删除2：已删除 |
TelephoneFieldValueBo：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| countryCode | String | 地区编码 | |
| value | String | 电话号 |
DateFieldValueBo：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| dateStr | String | 字符串格式，格式为："2022-03-15 12:53:08 |
WhetherFieldValueBo：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | Long | 取值1,2 | |
| name | String | 取值"是"和"否"，分别对应id=1和2 | |
| isDelete | Byte | 删除状态 可选值： 0：不可删除1：未删除2：已删除 |
员工自定义分组数据回写接口（写入）
接口说明：通过此接口，可以回写员工自定义分组中的数据记录（eg：培训经历、奖惩经历、项目经历等）
请求示例1：
{
"rosterListQuerySingleResultList": [
{
"employeeId": 254590,
"compoundInfos": {
"extend": [
{
"stringMap": {
"extend-DF_7d3e6882397643cf8fbcc939af6234fd": "1-单行文本值1-新",
"extend-modelId": "23171"
}
},
{
"id": 466814,
"stringMap": {
"extend-DF_0889753200f842839a55e8f02b0e8f18": "1-单行文本值1-更新",
"extend-modelId": "14812"
}
}
]
}
}
]
}
请求示例2
{
"rosterListQuerySingleResultList": [
{
"employeeId": 75700798,
"compoundInfos": {
"extend": [
{
"id": 150787,
//指定了id代表为更新
"stringMap": {
"extend-DF_bdd0151404834931a379940d82c7ee3c": "1-单行文本值1-更新",
"extend-DF_6763eb429bb24ad49695c55b817cbb64": "1-单行文本字段值2-更新",
"extend-modelId": "57473"
}
},
// 没指定id代表新增
{
"stringMap": {
"extend-DF_bdd0151404834931a379940d82c7ee3c": "新增新增",
"extend-DF_6763eb429bb24ad49695c55b817cbb64": "新增新增2",
"extend-modelId": "57473"
}
},
{
"id": 150864,
"numberMap": {
"extend-DF_328886e393ff44be85fa3467843595c6": {
"valueStr": "666",
"valueLong": 666,
"unit": ""
}
},
"stringMap": {
"model_id": "58236"
},
"attachmentMap": {
"extend-DF_b38f3584041f49699359bd20860e4461": [
{
"id": null,
"name": "PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png",
"url": "www.url"
}
]
},
"addressMap": {
"extend-DF_09296e244b5c462fad6de7a0e0e58189": {
"province": "110000",
"provinceName": "北京市",
"city": "110000",
"cityName": "北京市",
"county": "110101",
"countyName": "东城区",
"value": "无"
}
},
"telephoneMap": {
"extend-DF_4dd595b7aeec4ef39bbc855973784ec9": {
"countryCode": "+86",
"value": "17761230832"
}
},
"dateMap": {
"extend-DF_d56031f63cf742e8ab7b84681bbcfd99": {
"dateStr": "2022-07-11"
}
},
"whetherMap": {
"extend-DF_1cf807b6326847e5969dccd37ee07337": {
"id": 1,
"name": "是"
}
}
}
]
}
}
]
}
响应实例：
{
"code": 0,
"msg": "成功",
"data": {
"success": false,
"writeErrorMsgList": [
{
"index": 0,
"bizAttrKey": "extend-DF_9c323lkj43h5kj4h5j4kh6k54jh",
"code": 600048,
"tip": "字段值未传"
}
],
"employeeWritePrimaryKeyResultList": [{
"employeeId": 75710974,
"compoundPrimaryKeyMap": {
"extend": [150925]
}
}, {
"employeeId": 75711430,
"compoundPrimaryKeyMap": {
"extend": [150926]
}
}]
}
}
基本信息
请求地址：https://api.mokahr.com/api-platform/hcm/oapi/v2/core/rosters/writeEmployeeExtendInfos
请求频率：2次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【员工自定义分组信息回写接口】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| rosterListQuerySingleResultList | 是 | Array<Object> | |
| └employeeId | 是 | Long | 员工的id |
| └compoundInfos | 是 | Map<String, List<CompoundResultBo>> | 一对多信息 key为extend，value是多行信息结构对象，见下表 |
CompoundResultBo，多行信息结构对象：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| id | 否 | Long | ID | 不填，则在对应的自定义分组下，新增一条数据记录 |
| numberMap | 否 | Map<String, NumberFieldValueBo> | 数字，对应type=3 | key为对应的字段，以extend-拼接fieldName。如：extend-DF_7d3e6882397643cf8fbcc939af6234fd |
| stringMap | 是 | Map<String, String> | 单行文本，对应type=1 | 分组模板model_id必须通过StringMap填入，字段信息key同上 |
| attachmentMap | 否 | Map<String, List<AttachmentFieldValueBo>> | 附件，对应type=8 | |
| addressMap | 否 | Map<String, AddressFieldValueBo> | 地址，对应type=6 | |
| idNameMap | 否 | Map<String, SelectFieldValueBo> | 单选，对应type=5 | |
| telephoneMap | 否 | Map<String, TelephoneFieldValueBo> | 电话，对应type=7 | |
| dateMap | 否 | Map<String, DateFieldValueBo> | 日期，对应type=2 | |
| whetherMap | 否 | Map<String, WhetherFieldValueBo> | 是非，对应type=4 | |
| textMap | 否 | Map<String, String> | 多行文本，对应type=11 |
NumberFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| valueLong | 是 | Long | Long类型的数值 | |
| valueStr | 是 | String | 字符串类型的数值 | |
| unit | 否 | String | 单位 |
AttachmentFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| id | 否 | Long | ID | |
| name | 是 | String | 附件名称 | |
| url | 是 | String | 地址 |
AddressFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| province | 是 | String | 省code码，例如：北京市：110000 | |
| provinceName | 是 | String | 省 | |
| city | 是 | String | 市code码 | |
| cityName | 是 | String | 市 | |
| county | 是 | String | 区code编码 | |
| countyName | 是 | String | 区 | |
| value | 是 | String | 详细地址 |
SelectFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| id | 是 | Long | 可选值：1：男2：女 |
|
| name | 是 | String | 展示的名字，如："男"和"女"，分别对应id=1和2 | |
| sortNo | 否 | int | 排序序号，一般用于展示的顺序 | |
| isDelete | 否 | int | 删除状态 可选值： 0：不可删除1：未删除2：已删除 |
TelephoneFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| countryCode | 是 | String | 地区编码 | |
| value | 是 | String | 电话号 |
DateFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| dateStr | 是 | String | 字符串格式，格式为："2022-03-15 12:53:08 |
WhetherFieldValueBo：
| 字段 | 必填 | 类型 | 描述 | 备注 |
|---|---|---|---|---|
| id | 是 | Long | 取值1,2 | |
| name | 是 | String | 取值"是"和"否"，分别对应id=1和2 | |
| isDelete | 否 | int | 删除状态 可选值： 0：不可删除1：未删除2：已删除 |
响应体：
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 返回结果的状态码 | |
| msg | String | 返回结果的状态信息 | |
| data.writeErrorMsgList | Array | 错误信息提示 | |
| data.WriteErrorMsgList.index | int | 索引 | |
| data.WriteErrorMsgList.bizAttrkey | String | 属性key | |
| data.WriteErrorMsgList.code | int | 错误码 | |
| data.WriteErrorMsgList.tip | String | 错误提示信息 | |
| data.employeeWritePrimaryKeyResultList | Array | 返回主键id | |
| data.employeeWritePrimaryKeyResultList. employeeId |
String | 员工ID | |
| data.employeeWritePrimaryKeyResultList. compoundPrimaryKeyMap |
object | 记录主键集合 | |
| data.employeeWritePrimaryKeyResultList. compoundPrimaryKeyMap.extend |
Array | 记录主键ID |
BI报表API
Moka People提供了针对BI报表结果数据的查询接口，查询接口只需要传入报表ID，就可以返回和报表浏览一致的数据
查询报表结果数据接口
接口说明：通过此接口，可以查询指定报表ID对应的报表数据结果
请求示例：
{
"reportId": 83475647
}
响应实例
{
"code": 200,
"data": {
"headers": [{
"dataIndex": "c_1",
"title": "性别",
"type": "HEADER"
}, {
"dataIndex": "c_2",
"title": "民族",
"type": "HEADER"
}],
"rows": [{
"c_1": "男性",
"c_2": "汉族"
}],
"size": 1
},
"msg": "成功"
}
基本信息
请求地址： https://api.mokahr.com/api-platform/hcm/oapi/v1/report/getReportData
请求频率：3次/秒/企业, 30次/分钟/企业
请求方式：POST
请求头 Header
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | Basic |
略，"鉴权验证说明"部分已经明确说明 |
请求参数 Query Param
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| entCode | 是 | String | 租户的唯一ID；由CSM(客户成功经理)提供 |
| apiCode | 是 | String | 租户配置的api应用对应的唯一ID 是Moka People系统"设置" - "对外接口设置"的【接口编码】字段，数据源=【批量-组织架构信息】 |
| nonce | 是 | String | 每次请求的随机字符串，由客户自己随机生成；长度不超过8位，由数字和不区分大小写的英文字母构成 |
| timestamp | 是 | Long | 时间戳；精确到毫秒 |
| sign | 是 | String | 在"验签说明"里有详细说明，https://people.mokahr.com/docs/api/view/v1.html#-6 |
请求体 Request Body
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| reportId | 是 | int | 报表ID |
BI报表API响应体
| 字段 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | int | 返回码：非1000000代表错误 | |
| msg | String | 报错信息 | |
| data | Object | 返回结果的数据内容 | |
| data.headers | Object | 表头 | |
| data.headers.dataIndex | int | 表头和结果数据映射关系 | |
| data.headers.title | String | 表头名称 | |
| data.headers.type | String | 表头类型，只可能为HEADER 或者 DATA | |
| data.headers.children | Object | 元素类型同data.headers（代表多级表头） | |
| data.rows | Array | 结果数据 | |
| data.rows.c_$ | String | 结果数据索引 key:value形式 |
主动推送API（Webhooks）
Webhooks是当某种事件发生时，触发Moka主动推送数据的一种方式。当这些事件发生时，我们会发送一个HTTP POST请求到你设置的webhook endpoint URL。请求的body中会包含JSON格式的相关数据。由于webhook并不是访问Moka的API endpoint，所以并不需要API Key来进行HTTP basic auth的验证。
重试机制
应用收到HTTP POST、GET请求后，需要在1秒内以HTTP 200状态码响应该请求。否则开放平台认为本次推送失败，并以 15s、5m、1h、6h 的间隔重新推送事件，最多重试4次； 推送消息的URL会统一增加requestUniqueKey的唯一推送流水号参数，重试的requestUniqueKey不会更新。
如何使用webhooks
请在Moka People中的"对外接口设置"中配置Webhook服务，并添加一个公网可以访问的HTTPS的URL，作为接收webhook请求的地址。
设置推送接口，以员工任职信息为例
在"对外设置"中添加推送接口
设置成功
人事 - 新增待入职员工通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&obId=38732&modifyType=30&sourceType=1&pwd=1
接口说明：如需及时获取到新增待入职员工的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工待入职信息】，监控信息类型选择【新增】
业务场景范围：
- 使用【入职】-【待入职】-【添加待入职】功能新增待入职员工，且审批通过后
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 30 | 当通知为"新增待入职员工"时，恒为30 |
| modifyType | int | 是 | 1 | 当通知为"新增待入职员工"时，恒为1 |
| obId | Long | 是 | 待入职员工的id | 可以通过"待入职员工数据接口"的接口，获取待入职员工的详细数据 |
| ts | Long | 是 | Moka people推送的时间 |
人事 - 变更待入职员工通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&obId=38732&modifyType=3&sourceType=30&pwd=1
接口说明：如需及时获取到变更待入职员工的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工待入职信息】，监控信息类型选择【变更】
业务场景范围：
- 主动推送变更待入职员工事件，触发时机为变更待入职员工信息，入职信息编辑、入职日期编辑、入职任务填写完成、信息采集完成
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 30 | 当通知为"变更待入职员工"时，恒为30 |
| modifyType | int | 是 | 3 | 当通知为"变更待入职员工"时，恒为3 |
| obId | Long | 是 | 待入职员工的id | 可以通过"待入职员工数据接口"的接口，获取待入职员工的详细数据 |
| ts | Long | 是 | Moka people推送的时间 |
人事 - 取消待入职员工通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&obId=38732&modifyType=2&sourceType=30&pwd=1
接口说明：如需及时获取到取消待入职员工的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工待入职信息】，监控信息类型选择【取消】
业务场景范围：
- 主动推送变更待入职员工事件，触发时机为页面操作取消入职或者ATS操作取消入职以及接口操作取消入职
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 30 | 当通知为"取消待入职员工"时，恒为30 |
| modifyType | int | 是 | 2 | 当通知为"取消待入职员工"时，恒为2 |
| obId | Long | 是 | 待入职员工的id | 可以通过"待入职员工数据接口"的接口，获取待入职员工的详细数据 |
| ts | Long | 是 | Moka people推送的时间 |
人事 - 员工入职通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&employeeId=3873&modifyType=1&sourceType=1&pwd=1
接口说明：如需及时获取到员工入职的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工任职信息】，监控信息类型选择【入职】
业务场景范围：
- HR人员点击【确认入职】，会触发此事件
- HR使用【导入平台】- 【花名册导入】 - 【创建新员工】，会触发此事件
- HR使用【员工花名册】 - 【添加员工】，会触发此事件
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 1 | 当通知为"员工 - 确认入职通知"时，恒为1 |
| modifyType | int | 是 | 1 | 当通知为"员工 - 确认入职通知"时，恒为1 |
| employeeId | Long | 是 | 入职员工的uuid | 可以通过"查询员工"的接口，获取入职员工的详细数据 |
| ts | Long | 是 | Moka people推送的时间 |
人事 - 员工信息变更通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&employeeId=3873&modifyType=3&sourceType=1&pwd=1
接口说明：如需及时获取到员工信息变更情况的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工任职信息】，监控信息类型选择【信息变更】
业务场景范围：
- 员工在移动端自行修改个人信息，会触发此事件
- HR在【员工花名册】修改员工信息或者【批量修改】，会触发此事件
- HR在【员工花名册】发起【异动】or【转正】or【实习转正】or【离职】审批，会触发此事件
- HR使用【导入平台】- 【花名册导入】 - 【更新已有新员工】，会触发此事件
- HR使用【导入平台】- 【异动记录导入】，会触发此事件
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 1 | 当通知为"员工 - 信息变更通知"时，恒为1 |
| modifyType | int | 是 | 3 | 当通知为"员工 - 信息变更通知"时，恒为3 |
| employeeId | Long | 是 | 员工的uuid | 可以通过"查询员工"的接口，获取员工的详细数据 |
| ts | Long | 是 | Moka people推送的时间 |
人事 - 员工转正通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&dataId=3873&modifyType=4&sourceType=1&pwd=1
接口说明：如需及时获取到员工转正的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工任职信息】，监控信息类型选择【转正】
业务场景范围：
- 【转正审批】通过
- 不支持HR使用【导入平台】-【转正记录导入】的事件触发
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在People中配置的应用中对应的pwd，客户可以校验第三方厂商推送的合法性 |
| sourceType | int | 是 | 1 | 当通知为"员工 - 转正通知"时，恒为1 |
| modifyType | int | 是 | 4 | 当通知为"员工 - 转正通知"时，恒为4 |
| dataId | Long | 是 | 入职员工的uuid | 可以通过"查询员工"的接口，获取详细入职员工的数据。 注意：这里的字段是dataId |
| ts | Long | 是 | people推送的时间 |
人事 - 员工离职通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&employeeId=3873&modifyType=2&sourceType=1&pwd=1
接口说明：如需及时获取到员工离职的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工任职信息】，监控信息类型选择【离职】
业务场景范围：
- 员工在移动端发起离职审批，审批同意后
- 如果离职日期，在审批通过的当天以前，触发此事件
- 如果离职日期，在审批通过的当天or当天以后，会在离职日期+1天的凌晨，触发此事件
- HR在PC端发起某个员工的离职审批，审批同意后
- 如果离职日期，在审批通过的当天以前，触发此事件
- 如果离职日期，在审批通过的当天or当天以后，会在离职日期+1天的凌晨，触发此事件
- HR在【离职管理】为某个员工办理【离职办理】时，审批同意后
- 如果离职日期，在审批通过的当天以前，触发此事件
- 如果离职日期，在审批通过的当天or当天以后，会在离职日期+1天的凌晨，触发此事件
- HR在PC端修改了某个员工的离职日期，
- 如果离职日期，在修改的当天以前，触发此事件
- 如果离职日期，在修改的当天or当天以后，会在离职日期+1天的凌晨，触发此事件
- HR使用【导入平台】- 【花名册导入】 - 【更新已有新员工】，并且指定离职日期
- 如果离职日期，在导入成功的当天以前，触发此事件
- 如果离职日期，在导入成功的当天or当天以后，会在离职日期+1天的凌晨，触发此事件
- HR使用【导入平台】- 【异动记录导入】，并且【事件类型】字段为【离职类型】，并且指定生效日期（对于【离职异动】的生效日期，就是离职日期）
- 如果离职日期，在导入成功的当天以前，触发此事件
- 如果离职日期，在导入成功的当天or当天以后，会在离职日期+1天的凌晨，触发此事件
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 1 | 当通知为"员工 - 离职通知"时，恒为1 |
| modifyType | int | 是 | 2 | 当通知为"员工 - 离职通知"时，恒为2 |
| employeeId | Long | 是 | 离职员工的id | 可以通过"查询员工"的接口，获取员工的详细数据 |
人事 - 员工离职办理通过通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&employeeId=3873&modifyType=22&sourceType=1&pwd=1
接口说明：如需及时获取到员工离职审批流程的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工任职信息】，监控信息类型选择【离职办理通过】
业务场景范围：
主动推送离职办理通过事件，触发时机为发起离职办理流程的最后一个节点通过，整个办理流程状态变为「已通过」时，触发此事件
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密钥 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 1 | 当通知为"员工 - 离职办理通过通知"时，恒为1 |
| modifyType | int | 是 | 22 | 当通知为"员工 - 离职办理通过通知"时，恒为22 |
| employeeId | Long | 是 | 离职办理通过的流程中的离职员工ID | 可以通过"员工任职数据接口"的接口，获取员工的详细数据 |
人事 - 员工离职审批通过通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&employeeId=3873&modifyType=21&sourceType=1&pwd=1
接口说明：如需及时获取到员工离职审批流程的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工任职信息】，监控信息类型选择【离职审批通过】
业务场景范围：
主动推送离职审批通过事件，触发时机为发起离职审批流程的最后一个审批节点通过，整个审批流程状态变为「已通过」时，触发此事件
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密钥 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 1 | 当通知为"员工 - 离职审批通过通知"时，恒为1 |
| modifyType | int | 是 | 21 | 当通知为"员工 - 离职审批通过通知"时，恒为21 |
| employeeId | Long | 是 | 离职审批通过流程中的离职员工 id | 可以通过"员工任职数据接口"的接口，获取员工的详细数据 |
人事 - 员工兼岗信息变更通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&modifyType=2&employeeId=2870&sourceType=2&pwd=123
接口说明：如需及时获取到员工兼岗信息变更的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【兼岗信息】，监控信息类型选择【信息变更】
业务场景范围：
- 【添加兼岗】、【结束兼岗】审批通过
- 不支持HR使用【导入平台】-【兼岗管理导入】的事件触发
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 6 | 当通知类型为"兼岗"时，恒等于 6 |
| modifyType | int | 是 | 3 | 当通知事件为"信息变更"时，恒等于 3 |
| employeeId | String | 是 | 变更兼岗的员工id |
人事 - 家庭成员变更通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&dataId=3873&modifyType=9&sourceType=34&pwd=1
接口说明：如需及时获取到员工家庭成员变更的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【家庭成员信息】，监控信息类型选择【信息变更】
业务场景范围：
- 触发场景
员工花名册-个人信息-家庭成员信息【编辑】，触发此事件 移动端-个人信息修改-家庭成员信息【审批通过】，触发此事件
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 34 | |
| modifyType | int | 是 | 9 | |
| dataId | Long | 是 | 员工的employeeId | 可以通过"家庭成员"的接口，获取详细的数据。 注意：这里的字段是dataId |
| ts | Long | 是 | Moka People推送的时间 |
人事 - 合同信息变更通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&contractId=3873&employeeId=267339&modifyType=8&sourceType=7&pwd=1
接口说明：如需及时获取到员工合同信息变更的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工合同信息】，监控信息类型选择【信息变更】
业务场景范围：
- 触发场景
合同管理-员工合同信息变更【新签、续签、换签】，触发此事件
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 7 | |
| modifyType | int | 是 | 8 | |
| employeeId | Long | 是 | 员工的employeeId | 可以通过"员工合同数据接口"的接口，获取详细的数据 |
| contractId | Long | 是 | 员工合同主键ID | 可以通过"员工合同数据接口"的接口，获取详细的数据 |
| ts | Long | 是 | Moka People推送的时间 |
组织 - 新增部门通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&modifyType=1&nodeUid=2870&sourceType=2&pwd=123
接口说明：如需及时获取到部门新增的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【组织架构信息】，监控信息类型选择【新增】
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 2 | 当通知类型为"组织"时，恒等于 2 |
| modifyType | int | 是 | 1 | 当通知事件为"组织 - 新增"时，恒等于 1 |
| nodeUid | String | 是 | 新增部门的id |
组织 - 编辑部门通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&modifyType=3&nodeUid=2870&sourceType=2&pwd=123
接口说明：如需及时获取到部门变更的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【组织架构信息】，监控信息类型选择【编辑】
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 2 | 当通知类型为"组织"时，恒等于 2 |
| modifyType | int | 是 | 3 | 当通知事件为"组织 - 编辑"时，恒等于 3 |
| nodeUid | String | 是 | 变更部门的id |
组织 - 停用部门通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&modifyType=2&nodeUid=2870&sourceType=2&pwd=123
接口说明：如需及时获取到部门停用的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【组织架构信息】，监控信息类型选择【停用】
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 2 | 当通知类型为"组织"时，恒等于 2 |
| modifyType | int | 是 | 2 | 当通知事件为"组织 - 停用"时，恒等于 2 |
| nodeUid | String | 是 | 变更组织的id |
职务/职位 - 新增职务/职位通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&modifyType=1&dutyId=2870&sourceType=3&pwd=123
客户在Moka People中的设置模式，如果是职务模式，推送的是职务；如果是职位模式，推送的是职位；
接口说明：如需及时获取到职务/职位新增的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【职务信息/职位信息】，监控信息类型选择【新增】
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口ID | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 3、4 | 当通知类型为"职务信息"时，恒等于 3; 当通知类型为"职位信息"时，恒等于 4; |
| modifyType | int | 是 | 1 | 当通知事件为"新增"时，恒等于 1; |
| dutyId 或者positionId | String | 是 | 新增职务 or 职位，对应的职务id or 职位id | 当通知类型为"职务信息"时，dutyId; 当通知类型为"职位信息"时，positionId; |
职务/职位 - 停用职务/职位通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&modifyType=2&dutyId=2870&sourceType=3&pwd=123
客户在Moka People中的设置模式，如果是职务模式，推送的是职务；如果是职位模式，推送的是职位；
接口说明：如需及时获取到职务/职位停用的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【职务信息/职位信息】，监控信息类型选择【停用】
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 3、4 | 当通知类型为"职务信息"时，恒等于 3; 当通知类型为"职位信息"时，恒等于 4; |
| modifyType | int | 是 | 2 | 当通知事件为"停用"时，恒等于 3; |
| dutyId 或者positionId | String | 是 | 停用职务 or 职位，对应的职务id or 职位id | 当通知类型为"职务信息"时，dutyId; 当通知类型为"职位信息"时，positionId; |
职务/职位 - 编辑职务/职位通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&modifyType=3&dutyId=2870&sourceType=3&pwd=123
客户在Moka People中的设置模式，如果是职务模式，推送的是职务；如果是职位模式，推送的是职位；
接口说明：如需及时获取到职务/职位变更的事件推送，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【职务信息/职位信息】，监控信息类型选择【编辑】
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 3、4 | 当通知类型为"职务信息"时，恒等于 3; 当通知类型为"职位信息"时，恒等于 4; |
| modifyType | int | 是 | 3 | 当通知事件为"编辑"时，恒等于 3; |
| dutyId 或者positionId | String | 是 | 编辑职务 or 职位，对应的职务id or 职位id | 当通知类型为"职务信息"时，dutyId; 当通知类型为"职位信息"时，positionId; |
待办和消息 - 消息通知
标准消息为（文本）类型:
{
"userId": "userId1,userId2,userId3", //用户
"msgType": "text", //消息类型:文本
"msgId": "12312312787853", //消息ID
"createTime": "1635769030", //消息创建时间
"elements": {
"title": "title", //消息标题
"content": "文本内容"//消息内容
}
}
标准消息为图片类型
{
"userId": "userId1,userId2,userId3", //用户
"msgType": "image", //消息类型:图片
"msgId": "12312312787853", //消息ID
"createTime": "1635769030", //消息创建时间
"elements": {
"title": "title", //消息标题
"content": "普通文本标签", //图片ID或者URL
"description": "描述信息" //图片或者音频的描述信息
}
}
标准消息为（card）类型
{
"userId": "userId1,userId2,userId3", //用户
"msgType": "card", //消息类型:card
"msgId": "12312312787853", //消息ID
"createTime": "1635769030", //消息创建时间
"elements": {
"title": "title",
"content": "普通文本标签", //消息内容
"buttonList": [
{
"text": "查看详情1",
"key": "button_key_1",
"url": "http://*******"
},
{
"text": "查看详情2",
"key": "button_key_2",
"url": "http://*******"
}
]
}
}
标准消息为（markdown）类型
{
"userId": "userId1,userId2,userId3", //用户
"msgType": "markdown", //消息类型、markdown
"msgId": "12312312787853", //消息ID
"createTime": "1635769030", //消息创建时间
"elements": {
"title": "title",
"content": "普通文本标签", //具体消息内容
"href": {
"url": "https://www.******.com",
"pcUrl": "https://www.******.com"
}
}
}
接口说明：如需及时获取到Moka People系统中的消息通知，可以使用此接口。 Open API 可以主动将Moka People系统中的消息通知推送给客户。需要在Moka People的"对外接口设置中"设置监听【消息通知】，并配置客户自身的Http 回调地址。
基本信息
请求地址：回调接口，由第三方提供
请求方式：POST
请求头 Header：无
请求体 RequestBody JSON格式
消息内容
| 字段 | 必须 | 类型 | 描述 |
|---|---|---|---|
| userId | 是 | String | 多个接收人时 userId用英文","隔开 |
| msgType | 是 | String | 消息类型：text,image,card,markdown |
| msgId | 否 | String | 消息ID |
| createTime | 否 | Long | 消息创建时间戳 |
| elements | 是 | Object | 消息体 |
| └title | 是 | String | 标题内容 |
| └content | 是 | String | 消息内容，当图片、音频时为音频ID |
| └description | 否 | String | 消息的描述信息，或者是图片、音频的描述信息 |
| └buttonList | 否 | Array<Object> | button内容 |
| └href | 否 | String | href字段样例：差异化跳转：仅在需要PC、移动端跳转不同链接时使用 |
属性href说明
| 字段 | 必须 | 类型 | 取值 | 说明 |
|---|---|---|---|---|
| url | 是 | String | 超链接 | 默认跳转链接 |
| pc_url | 是 | String | 超链接 | PC端跳转链接 |
待办和消息 - 待办通知
接口说明：如需及时获取到Moka People系统中的待办通知，可以使用此接口。 Open API 可以主动将Moka People系统中的消息通知推送给客户。需要在Moka People的"对外接口设置中"设置监听【待办通知】，并配置客户自身的Http 回调地址。
基本信息
请求地址：回调接口，由第三方提供
请求方式：POST
请求头 Header：无
请求体 RequestBody JSON格式
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| flowTaskInsId | Long | 是 | 待办ID | |
| taskType | Long | 是 | 待办类型 | 0：用于同步流程实例的发起节点1：审批节点2：抄送节点7：任务节点/其他8：试用期任务待办9：绩效任务待办 |
| editType | Long | 是 | 操作类型 | 1：新增2：修改3：删除4：继承父模板的属性 |
| taskStatus | Long | 是 | 待办状态 | 可选值：1：未完成;2：已完成;3：取消; |
| title | String | 否 | 待办标题 | |
| content | String | 否 | 待办内容 | |
| taskEmployeeId | Long | 是 | 接收人的员工id | |
| createTime | date | 否 | 待办创建时间 | |
| processInitiator | Long | 否 | 发起人员工id | |
| flowDefId | Long | 否 | 流程模板ID | |
| flowDefName | String | 否 | 流程模板名称 | |
| flowInstanceId | Long | 否 | 流程实例ID（唯一值） | |
| url | String | 否 | 待办对应的url | editType为删除的时候不会构建URL |
假勤 - 创建/撤销出差审批单通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&dataId=3873&modifyType=2&sourceType=25&pwd=1
接口说明：如需及时将出差数据（新增、撤销）推送给客户，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工出差信息】，监控信息类型选择【新增/撤销】
业务场景范围：
- 触发场景
员工自助-出差申请【审批通过】，触发新增事件
出差申请【撤回、撤销】，触发撤销时间
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 25 | |
| modifyType | int | 是 | 类型 | 2：审批通过4：撤销 |
| dataId | String | 是 | 出差流程id | 结合"员工出差信息接口"使用 |
| ts | Long | 是 | Moka People推送的时间 |
假勤 - 创建/撤销外出审批单通知
推送实例：
{
"reason": "123123123阿萨德权威的期待",
"endTime": 1654095600000,
"outtingId": 9854,
"startTime": 1654012800000,
"employeeId": 145871,
"flowStatus": 2,
"timeLength": 1380,
"flowInstanceId": null,
"workTimeLength": 9
}
接口说明：如需及时将外出数据（新增、撤销）推送给客户，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【员工外出信息】，监控信息类型选择【新增/撤销】
业务场景范围
- 新增事件的触发场景：
员工自助-外出申请【审批通过】；
HR端-假勤管理-外出记录-添加外出记录 - 撤销事件的触发场景：
员工自助-外出申请【撤回、撤销】
HR端-假勤管理-外出记录-撤销外出记录
基本信息
请求地址：回调接口，由第三方提供
请求方式：POST
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| outtingId | Long | 是 | 外出记录唯一标识ID | |
| flowInstanceId | Long | 否 | 审批编号 | 审批创建的外出记录含有审批编号 |
| employeeId | Long | 是 | 员工编号 | |
| flowStatus | int | 否 | 审核状态 可选值： 1：审批中2：通过3：驳回4：撤回 |
业务操作：2：新增4：撤回时 |
| reason | String | 否 | 外出原因 | 最大长度8000 |
| timeLength | Decimal | 否 | 外出时长 | 保留两位小数 |
| workTimeLength | Decimal | 否 | 工作时段外出时长 | 保留两位小数 |
| startTime | Long | 是 | 外出开始时间 | |
| endTime | Long | 是 | 外出结束时间 |
假勤 - 创建/撤销请假审批单通知
推送实例：
https://您的公网回调地址?apiCode=5e1b5c96cf02eda0c2747608600b3bcb&pwd=123456789&sourceType=39&modifyType=4&dataId=489786&employeeId=3875&ts=1666320833443
Open API 主动将Moka系统中的变更数据推送给客户，客户可以在Moka的"对外接口设置"设置监听变更的数据源，选择实时推送接口方式，员工请假信息监控信息类型 -新增/撤销，
业务场景范围
- 触发场景 员工自助-请假申请提交-【审批通过】后，触发此事件
审批【撤销】，触发此事件 - 触发场景 people端，假勤-请假记录-添加请假记录，触发此事件 people端，假勤-请假记录-撤销，触发此事件
基本信息
请求地址：回调接口，由第三方提供
请求方式：GET
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在People中配置的应用中对应的apiCode |
| pwd | String | 否 | 密码 | 在People中配置的应用中对应的pwd，客户可以校验第三方厂商推送的合法性 |
| sourceType | int | 是 | 39 | 数据源类型，接入方无需关注 |
| modifyType | int | 是 | 2/4 | 枚举值：2：审批通过 4：撤销 |
| dataId | Long | 是 | 请假数据id | 结合"请假信息数据接口"使用 |
| employeeId | Long | 是 | 员工id | |
| ts | Long | 是 | people推送的时间 |
假勤 - 创建/撤销加班审批单通知
推送实例：
https://您的公网回调地址?apiCode=5e1b5c96cf02eda0c2747608600b3bcb&pwd=123456789&sourceType=42&modifyType=4&dataId=489786&employeeId=3875&ts=1666320833443
Open API 主动将Moka系统中的变更数据推送给客户，客户可以在Moka的"对外接口设置"设置监听变更的数据源，选择实时推送接口方式，员工加班信息监控信息类型 -新增/撤销，
业务场景范围
- 触发场景 员工自助-加班申请提交-【审批通过】后，触发此事件
审批【撤销】，触发此事件 - 触发场景 people端，假勤-加班记录-添加加班记录，触发此事件 people端，假勤-加班记录-撤销，触发此事件
基本信息
请求地址：回调接口，由第三方提供
请求方式：POST
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在People中配置的应用中对应的apiCode |
| pwd | String | 否 | 密码 | 在People中配置的应用中对应的pwd，客户可以校验第三方厂商推送的合法性 |
| sourceType | int | 是 | 42 | 数据源类型，接入方无需关注 |
| modifyType | int | 是 | 1/2/3/4 | 枚举值：1：审批发起 2：审批通过 3：驳回 4：撤销 |
| workflowId | String | 是 | 加班审批编号 | 结合"加班信息数据接口"使用 |
| employeeId | Long | 是 | 员工id | |
| ts | Long | 是 | people推送的时间 |
假勤 - 班次变更通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&dataId=3873&modifyType=2&sourceType=25&pwd=1
接口说明：如需及时将班次（新增、变更、启用、停用）推送给客户，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【班次信息】，监控信息类型选择【新增/变更/启用/停用】
业务场景范围：
- 触发场景
新增班次
变更班次
启用班次
停用班次
基本信息
请求地址：回调接口，由第三方提供
请求方式：POST
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在People中配置的应用中对应的apiCode |
| pwd | String | 否 | 密码 | 在People中配置的应用中对应的pwd，客户可以校验第三方厂商推送的合法性 |
| shiftId | Long | 是 | 班次ID | 班次唯一标识 |
| optType | int | 是 | 操作类型 | 操作类型 （1. 新增、2：修改、3启用、4停用） |
| ts | Long | 是 | Moka People推送的时间 |
假勤 - 排班变更通知
推送示例
https://您的公网回调地址?apiCode=9db2672b8fb19d&dataId=3873&modifyType=2&sourceType=25&pwd=1
接口说明：如需及时将员工排班信息变更推送给客户，请使用此接口。可以在Moka People的"对外接口设置中"数据源选择【排班信息】
业务场景范围：
- 员工班次变更、换班、排班导入
基本信息
请求地址：回调接口，由第三方提供
请求方式：POST
请求头 Header：无
消息内容
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口编码 | 在People中配置的应用中对应的apiCode |
| pwd | String | 否 | 密码 | 在People中配置的应用中对应的pwd，客户可以校验第三方厂商推送的合法性 |
| employeeId | Long | 是 | 员工ID | 在People中员工唯一标识 |
| startDate | String | 是 | 变更开始时间 | YYYY-MM-DD |
| endDate | String | 是 | 变更结束时间 | YYYY-MM-DD |
| ts | Long | 是 | Moka People推送的时间 | 时间戳 |
绩效- 活动状态变更通知
基本信息
请求地址：回调接口，由第三方提供
请求方式：POST
请求头：无
请求参数
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| activityId | Long | 是 | 活动唯一标识 | |
| activityStatus | Integer | 否 | 活动状态 | READ_TO_START(1, "待启动"), ING(2, "评估中"), FILED(3, "已归档"), DELETED(4, "已删除"); |
绩效- 活动环节状态变更通知
基本信息
请求地址：回调接口，由第三方提供
请求方式：POST
请求头：无
请求参数
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| activityId | Long | 是 | 活动唯一标识 | |
| evaluationGroupId | Long | 是 | 评估组id | |
| stepId | Long | 是 | 环节id | |
| stepStatus | Integer | 否 | 环节状态 | 环节状态 0:未开始 1:进行中 |
绩效- 活动被评估人变更通知
基本信息
请求地址：回调接口，由第三方提供
请求方式：POST
请求头：无
请求参数
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| activityId | Long | 是 | 活动唯一标识 | |
| changeType | Integer | 是 | 变更类型 | ADD(1, "新增"), /** * 删除 */ DELETE(2, "删除"); |
| examineeList | Long | 是 | 变更的被评估人id |
附录：组织人事通知的枚举类
参数说明
| 字段 | 类型 | 是否必填 | 含义 | 备注 |
|---|---|---|---|---|
| apiCode | String | 是 | 接口ID | 在Moka People 对外接口设置中，所创建接口对应的接口编码 |
| pwd | String | 否 | 密码 | 在Moka People 对外接口设置中配置的密钥，客户可以校验数据的合法性 |
| sourceType | int | 是 | 枚举值：1：员工任职信息2：组织架构3：职务信息4：职位信息5：入职状态6：兼岗信息 |
|
| modifyType | int | 是 | source=11：入职（确认入职）2：离职3：信息变更source=2 1：新增2：停用3：编辑source=3 1：新增2：停用3：编辑source=4 1：新增2：停用3：编辑source=5 1：已入职（弃用）2：放弃入职source=6 3：信息变更 |
枚举支持 |
| employeeId | Long | 是 | 用户id | sourceType=1、5、6有效 |
| obId | Long | 是 | 入职id | sourceType=5有效 |
| nodeUid | String | 是 | 组织id | sourceType=2有效 |
| positionId | Long | 是 | 职位id | sourceType=4，modifyType=2、3且对职位模式租户有效 |
| dutyId | Long | 是 | 职务id | sourceType=3，modifyType=2、3且对职务模式租户有效 |
API内置码表（List）
全局错误码
| HTTP状态码 | 错误码 | 说明 | 排查方案 |
|---|---|---|---|
| 200 | 0/200 | 接口业务错误码返回：0/200，请求成功 | |
| 400 | 100002 | 入参错误 | 请检查参数以下项是否准确 |
| 401 | 100001 | 没有进入系统权限 | 请检查授权码是否准确 |
| 403 | 100005 | 没有进入访问模块权限 | 请检查是否有该模块的权限 |
| 404 | 100000 | 请求地址错误 | 检查请求地址是否正确 |
| 405 | 100000 | 接口请求方式错误 | 请求方式是否正确 |
| 500 | -1 | error（系统错误） | 系统内部错误，联系技术支持 |
| 600 | 600 | 请求频率过快，请稍后再试 | 请检查调用方法，请求过快 |
国家码表
| 编码 | 名称 | 拼音全称 | 拼音缩写 |
|---|---|---|---|
| 1 | 中国 | zhongguo | zg |
| 2 | 安哥拉 | angela | agl |
| 3 | 阿富汗 | afuhan | afh |
| 4 | 阿尔巴尼亚 | aerbaniya | aebny |
| 5 | 阿尔及利亚 | aerjiliya | aejly |
| 6 | 安道尔共和国 | andaoergongheguo | adeghg |
| 7 | 安圭拉岛 | anguiladao | agld |
| 8 | 安提瓜和巴布达 | antiguahebabuda | atghbbd |
| 9 | 阿根廷 | agenting | agt |
| 10 | 亚美尼亚 | yameiniya | ymny |
| 11 | 阿森松 | asensong | ass |
| 12 | 澳大利亚 | aodaliya | adly |
| 13 | 奥地利 | aodili | adl |
| 14 | 阿塞拜疆 | asaibaijiang | asbj |
| 15 | 巴哈马 | bahama | bhm |
| 16 | 巴林 | balin | bl |
| 17 | 孟加拉国 | mengjialaguo | mjlg |
| 18 | 巴巴多斯 | babaduosi | bbds |
| 19 | 白俄罗斯 | baieluosi | bels |
| 20 | 比利时 | bilishi | bls |
| 21 | 伯利兹 | bolizi | blz |
| 22 | 贝宁 | beining | bn |
| 23 | 百慕大群岛 | baimudaqundao | bmdqd |
| 24 | 玻利维亚 | boliweiya | blwy |
| 25 | 博茨瓦纳 | bociwana | bcwn |
| 26 | 巴西 | baxi | bx |
| 27 | 文莱 | wenlai | wl |
| 28 | 保加利亚 | baojialiya | bjly |
| 29 | 布基纳法索 | bujinafasuo | bjnfs |
| 30 | 缅甸 | miandian | md |
| 31 | 布隆迪 | buLongdi | bld |
| 32 | 喀麦隆 | kamaiLong | kml |
| 33 | 加拿大 | jianada | jnd |
| 34 | 开曼群岛 | kaimanqundao | kmqd |
| 35 | 中非共和国 | zhongfeigongheguo | zfghg |
| 36 | 乍得 | zhade | zd |
| 37 | 智利 | zhili | zl |
| 38 | 哥伦比亚 | gelunbiya | glby |
| 39 | 刚果 | gangguo | gg |
| 40 | 库克群岛 | kukequndao | kkqd |
| 41 | 哥斯达黎加 | gesidalijia | gsdlj |
| 42 | 古巴 | guba | gb |
| 43 | 塞浦路斯 | saipulusi | spls |
| 44 | 捷克 | jieke | jk |
| 45 | 丹麦 | danmai | dm |
| 46 | 吉布提 | jibuti | jbt |
| 47 | 多米尼加共和国 | duominijiagongheguo | dmnjghg |
| 48 | 厄瓜多尔 | eguaduoer | egde |
| 49 | 埃及 | aiji | aj |
| 50 | 萨尔瓦多 | saerwaduo | sewd |
| 51 | 爱沙尼亚 | aishaniya | asny |
| 52 | 埃塞俄比亚 | aisaiebiya | aseby |
| 53 | 斐济 | feiji | fj |
| 54 | 芬兰 | fenlan | fl |
| 55 | 法国 | faguo | fg |
| 56 | 法属圭亚那 | fashuguiyanei | fsgyn |
| 57 | 法属玻利尼西亚 | fashubolinixiya | fsblnxy |
| 58 | 加蓬 | jiapeng | jp |
| 59 | 冈比亚 | gangbiya | gby |
| 60 | 格鲁吉亚 | gelujiya | gljy |
| 61 | 德国 | deguo | dg |
| 62 | 加纳 | jiana | jn |
| 63 | 直布罗陀 | zhibuluotuo | zblt |
| 64 | 希腊 | xila | xl |
| 65 | 格林纳达 | gelinnada | glnd |
| 66 | 关岛 | guandao | gd |
| 67 | 危地马拉 | weidimala | wdml |
| 68 | 几内亚 | jineiya | jny |
| 69 | 圭亚那 | guiyanei | gyn |
| 70 | 海地 | haidi | hd |
| 71 | 洪都拉斯 | hongdoulasi | hdls |
| 73 | 匈牙利 | xiongyali | xyl |
| 74 | 冰岛 | bingdao | bd |
| 75 | 印度 | yindu | yd |
| 76 | 印度尼西亚 | yindunixiya | ydnxy |
| 77 | 伊朗 | yilang | yl |
| 78 | 伊拉克 | yilake | ylk |
| 79 | 爱尔兰 | aierlan | ael |
| 80 | 以色列 | yiselie | ysl |
| 81 | 意大利 | yidali | ydl |
| 82 | 科特迪瓦 | ketediwa | ktdw |
| 83 | 牙买加 | yamaijia | ymj |
| 84 | 日本 | riben | rb |
| 85 | 约旦 | yuedan | yd |
| 86 | 柬埔寨 | jianpuzhai | jpz |
| 87 | 哈萨克斯坦 | hasakesitan | hskst |
| 88 | 肯尼亚 | kenniya | kny |
| 89 | 韩国 | hanguo | hg |
| 90 | 科威特 | keweite | kwt |
| 91 | 吉尔吉斯坦 | jierjisitan | jejst |
| 92 | 老挝 | laowo | lw |
| 93 | 拉脱维亚 | latuoweiya | ltwy |
| 94 | 黎巴嫩 | libanen | lbn |
| 95 | 莱索托 | laisuotuo | lst |
| 96 | 利比里亚 | libiliya | lbly |
| 97 | 利比亚 | libiya | lby |
| 98 | 列支敦士登 | liezhidunshideng | lzdsd |
| 99 | 立陶宛 | litaowan | ltw |
| 100 | 卢森堡 | lusenbao | lsb |
| 102 | 马达加斯加 | madajiasijia | mdjsj |
| 103 | 马拉维 | malawei | mlw |
| 104 | 马来西亚 | malaixiya | mlxy |
| 105 | 马尔代夫 | maerdaifu | medf |
| 106 | 马里 | mali | ml |
| 107 | 马耳他 | maerta | met |
| 108 | 马里亚那群岛 | maliyaneiqundao | mlynqd |
| 109 | 马提尼克 | matinike | mtnk |
| 110 | 毛里求斯 | maoliqiusi | mlqs |
| 111 | 墨西哥 | moxige | mxg |
| 112 | 摩尔多瓦 | moerduowa | medw |
| 113 | 摩纳哥 | monage | mng |
| 114 | 蒙古 | menggu | mg |
| 115 | 蒙特塞拉特岛 | mengtesailatedao | mtsltd |
| 116 | 摩洛哥 | moluoge | mlg |
| 117 | 莫桑比克 | mosangbike | msbk |
| 118 | 纳米比亚 | namibiya | nmby |
| 119 | 瑙鲁 | naolu | nl |
| 120 | 尼泊尔 | niboer | nbe |
| 121 | 荷属安的列斯 | heshuandeliesi | hsadls |
| 122 | 荷兰 | helan | hl |
| 123 | 新西兰 | xinxilan | xxl |
| 124 | 尼加拉瓜 | nijialagua | njlg |
| 125 | 尼日尔 | nirier | nre |
| 126 | 尼日利亚 | niriliya | nrly |
| 127 | 朝鲜 | chaoxian | cx |
| 128 | 挪威 | nuowei | nw |
| 129 | 阿曼 | aman | am |
| 130 | 巴基斯坦 | bajisitan | bjst |
| 131 | 巴拿马 | banama | bnm |
| 132 | 巴布亚新几内亚 | babuyaxinjineiya | bbyxjny |
| 133 | 巴拉圭 | balagui | blg |
| 134 | 秘鲁 | bilu | bl |
| 135 | 菲律宾 | feilvbin | f |
| 136 | 波兰 | bolan | bl |
| 137 | 葡萄牙 | putaoya | pty |
| 138 | 波多黎各 | boduolige | bdlg |
| 139 | 卡塔尔 | kataer | kte |
| 140 | 留尼旺 | liuniwang | lnw |
| 141 | 罗马尼亚 | luomaniya | lmny |
| 142 | 俄罗斯 | eluosi | els |
| 143 | 圣卢西亚 | shengluxiya | slxy |
| 144 | 圣文森特岛 | shengwensentedao | swstd |
| 145 | 东萨摩亚(美) | dongsamoya(mei) | dsmy() |
| 146 | 西萨摩亚 | xisamoya | xsmy |
| 147 | 圣马力诺 | shengmalinuo | smln |
| 148 | 圣多美和普林西比 | shengduomeihepulinxibi | sdmhplxb |
| 149 | 沙特阿拉伯 | shatealabo | stalb |
| 150 | 塞内加尔 | saineijiaer | snje |
| 151 | 塞舌尔 | saisheer | sse |
| 152 | 塞拉利昂 | sailaliang | slla |
| 153 | 新加坡 | xinjiapo | xjp |
| 154 | 斯洛伐克 | siluofake | slfk |
| 155 | 斯洛文尼亚 | siluowenniya | slwny |
| 156 | 所罗门群岛 | suoluomenqundao | slmqd |
| 157 | 索马里 | suomali | sml |
| 158 | 南非 | nanfei | nf |
| 159 | 西班牙 | xibanya | xby |
| 160 | 斯里兰卡 | sililanka | sllk |
| 162 | 圣文森特 | shengwensente | swst |
| 163 | 苏丹 | sudan | sd |
| 164 | 苏里南 | sulinan | sln |
| 165 | 斯威士兰 | siweishilan | swsl |
| 166 | 瑞典 | ruidian | rd |
| 167 | 瑞士 | ruishi | rs |
| 168 | 叙利亚 | xuliya | xly |
| 170 | 塔吉克斯坦 | tajikesitan | tjkst |
| 171 | 坦桑尼亚 | tansangniya | tsny |
| 172 | 泰国 | taiguo | tg |
| 173 | 多哥 | duoge | dg |
| 174 | 汤加 | tangjia | tj |
| 175 | 特立尼达和多巴哥 | telinidaheduobage | tlndhdbg |
| 176 | 突尼斯 | tunisi | tns |
| 177 | 土耳其 | tuerqi | teq |
| 178 | 土库曼斯坦 | tukumansitan | tkmst |
| 179 | 乌干达 | wuganda | wgd |
| 180 | 乌克兰 | wukelan | wkl |
| 181 | 阿拉伯联合酋长国 | alabolianheqiuzhangguo | alblhqzg |
| 182 | 英国 | yingguo | yg |
| 183 | 美国 | meiguo | mg |
| 184 | 乌拉圭 | wulagui | wlg |
| 185 | 乌兹别克斯坦 | wuzibiekesitan | wzbkst |
| 186 | 委内瑞拉 | weineiruila | wnrl |
| 187 | 越南 | yuenan | yn |
| 188 | 也门 | yemen | ym |
| 189 | 南斯拉夫 | nansilafu | nslf |
| 190 | 津巴布韦 | jinbabuwei | jbbw |
| 191 | 扎伊尔 | zhayier | zye |
| 192 | 赞比亚 | zanbiya | zby |
| 193 | 中国香港 | zhongguoxianggang | zgxg |
| 194 | 中国澳门 | zhongguoaomen | zgam |
| 195 | 中国台湾 | zhongguotaiwan | zgtw |
省份码表
| 编码 | 名称 | 拼音全称 | 拼音缩写 |
|---|---|---|---|
| 110000 | 北京市 | beijingshi | bj |
| 120000 | 天津市 | tianjinshi | tj |
| 130000 | 河北省 | hebeisheng | hb |
| 140000 | 山西省 | shanxisheng | sx |
| 150000 | 内蒙古自治区 | neimengguzizhiqu | nmgzz |
| 210000 | 辽宁省 | liaoningsheng | ln |
| 220000 | 吉林省 | jilinsheng | jl |
| 230000 | 黑龙江省 | heiLongjiangsheng | hlj |
| 310000 | 上海市 | shanghaishi | sh |
| 320000 | 江苏省 | jiangsusheng | js |
| 330000 | 浙江省 | zhejiangsheng | zj |
| 340000 | 安徽省 | anhuisheng | ah |
| 350000 | 福建省 | fujiansheng | fj |
| 360000 | 江西省 | jiangxisheng | jx |
| 370000 | 山东省 | shandongsheng | sd |
| 410000 | 河南省 | henansheng | hn |
| 420000 | 湖北省 | hubeisheng | hb |
| 430000 | 湖南省 | hunansheng | hn |
| 440000 | 广东省 | guangdongsheng | gd |
| 450000 | 广西壮族自治区 | guangxizhuangzuzizhiqu | gxzzzz |
| 460000 | 海南省 | hainansheng | hn |
| 500000 | 重庆市 | chongqingshi | cqs |
| 510000 | 四川省 | sichuansheng | sc |
| 520000 | 贵州省 | guizhousheng | gz |
| 530000 | 云南省 | yunnansheng | yn |
| 540000 | 西藏自治区 | xizangzizhiqu | xzzz |
| 610000 | 陕西省 | shanxisheng | sx |
| 620000 | 甘肃省 | gansusheng | gss |
| 630000 | 青海省 | qinghaisheng | qh |
| 640000 | 宁夏回族自治区 | ningxiahuizuzizhiqu | nxhzzz |
| 650000 | 新疆维吾尔自治区 | xinjiangweiwuerzizhiqu | xjwwezz |
| 710000 | 台湾省 | taiwansheng | ts |
| 810000 | 香港特别行政区 | xianggangtebiexingzhengqu | xgtbxzq |
| 820000 | 澳门特别行政区 | aomentebiexingzhengqu | amtbxzq |
| ALB | 阿尔巴尼亚 | aerbaniya | aebny |
| DZA | 阿尔及利亚 | aerjiliya | aejly |
| AFG | 阿富汗 | afuhan | afh |
| ARG | 阿根廷 | agenting | agt |
| ARE | 阿拉伯联合酋长国 | alabolianheqiuzhangguo | alblhqzg |
| ABW | 阿鲁巴 | aluba | alb |
| OMN | 阿曼 | aman | am |
| AZE | 阿塞拜疆 | asaibaijiang | asbj |
| ASC | 阿森松岛 | asensongdao | assd |
| EGY | 埃及 | aiji | aj |
| ETH | 埃塞俄比亚 | aisaiebiya | aseby |
| IRL | 爱尔兰 | aierlan | ael |
| EST | 爱沙尼亚 | aishaniya | asny |
| AND | 安道尔 | andaoer | ade |
| AGO | 安哥拉 | angela | agl |
| AIA | 安圭拉 | anguila | agl |
| ATG | 安提瓜岛和巴布达 | antiguadaohebabuda | atgdhbbd |
| AUS | 澳大利亚 | aodaliya | adly |
| AUT | 奥地利 | aodili | adl |
| ALA | 奥兰群岛 | aolanqundao | alqd |
| BRB | 巴巴多斯岛 | babaduosidao | bbdsd |
| PNG | 巴布亚新几内亚 | babuyaxinjineiya | bbyxjny |
| BHS | 巴哈马 | bahama | bhm |
| PAK | 巴基斯坦 | bajisitan | bjst |
| PRY | 巴拉圭 | balagui | blg |
| PSE | 巴勒斯坦 | balesitan | blst |
| BHR | 巴林 | balin | bl |
| PAN | 巴拿马 | banama | bnm |
| BRA | 巴西 | baxi | bx |
| BLR | 白俄罗斯 | baieluosi | bels |
| BMU | 百慕大 | baimuda | bmd |
| BGR | 保加利亚 | baojialiya | bjly |
| MNP | 北马里亚纳群岛 | beimaliyanaqundao | bmlynqd |
| BEN | 贝宁 | beining | bn |
| BEL | 比利时 | bilishi | bls |
| ISL | 冰岛 | bingdao | bd |
| PRI | 波多黎各 | boduolige | bdlg |
| POL | 波兰 | bolan | bl |
| BOL | 玻利维亚 | boliweiya | blwy |
| BIH | 波斯尼亚和黑塞哥维那 | bosiniyaheheisaigeweinei | bsnyhhsgwn |
| BWA | 博茨瓦纳 | bociwana | bcwn |
| BLZ | 伯利兹 | bolizi | blz |
| BTN | 不丹 | budan | bd |
| BFA | 布基纳法索 | bujinafasuo | bjnfs |
| BDI | 布隆迪 | buLongdi | bld |
| BVT | 布韦岛 | buweidao | bwd |
| PRK | 朝鲜 | chaoxian | cx |
| DNK | 丹麦 | danmai | dm |
| DEU | 德国 | deguo | dg |
| TLS | 东帝汶 | dongdiwen | ddw |
| TGO | 多哥 | duoge | dg |
| DMA | 多米尼加 | duominijia | dmnj |
| DOM | 多米尼加共和国 | duominijiagongheguo | dmnjghg |
| RUS | 俄罗斯 | eluosi | els |
| ECU | 厄瓜多尔 | eguaduoer | egde |
| ERI | 厄立特里亚 | eliteliya | eltly |
| FRA | 法国 | faguo | fg |
| FRO | 法罗群岛 | faluoqundao | flqd |
| PYF | 法属波利尼西亚 | fashubolinixiya | fsblnxy |
| GUF | 法属圭亚那 | fashuguiyanei | fsgyn |
| ATF | 法属南部领地 | fashunanbulingdi | fsnbld |
| VAT | 梵蒂冈 | fandigang | fdg |
| PHL | 菲律宾 | feilvbin | flb |
| FJI | 斐济 | feiji | fj |
| FIN | 芬兰 | fenlan | fl |
| CPV | 佛得角 | fodejiao | fdj |
| FLK | 弗兰克群岛 | fulankequndao | flkqd |
| GMB | 冈比亚 | gangbiya | gby |
| COG | 刚果 | gangguo | gg |
| COD | 刚果民主共和国 | gangguominzhugongheguo | ggmzghg |
| COL | 哥伦比亚 | gelunbiya | glby |
| CRI | 哥斯达黎加 | gesidalijia | gsdlj |
| GGY | 格恩西岛 | geenxidao | gexd |
| GRD | 格林纳达 | gelinnada | glnd |
| GRL | 格陵兰 | gelinglan | gll |
| CUB | 古巴 | guba | gb |
| GLP | 瓜德罗普 | guadeluopu | gdlp |
| GUM | 关岛 | guandao | gd |
| GUY | 圭亚那 | guiyanei | gyn |
| KAZ | 哈萨克斯坦 | hasakesitan | hskst |
| HTI | 海地 | haidi | hd |
| KOR | 韩国 | hanguo | hg |
| NLD | 荷兰 | helan | hl |
| ANT | 荷属安地列斯 | heshuandiliesi | hsadls |
| HMD | 赫德和麦克唐纳群岛 | hedehemaiketangnaqundao | hdhmktnqd |
| HND | 洪都拉斯 | hongdoulasi | hdls |
| KIR | 基里巴斯 | jilibasi | jlbs |
| DJI | 吉布提 | jibuti | jbt |
| KGZ | 吉尔吉斯斯坦 | jierjisisitan | jejsst |
| GIN | 几内亚 | jineiya | jny |
| GNB | 几内亚比绍 | jineiyabishao | jnybs |
| CAN | 加拿大 | jianada | jnd |
| GHA | 加纳 | jiana | jn |
| GAB | 加蓬 | jiapeng | jp |
| KHM | 柬埔寨 | jianpuzhai | jpz |
| CZE | 捷克共和国 | jiekegongheguo | jkghg |
| ZWE | 津巴布韦 | jinbabuwei | jbbw |
| CMR | 喀麦隆 | kamaiLong | kml |
| QAT | 卡塔尔 | kataer | kte |
| CYM | 开曼群岛 | kaimanqundao | kmqd |
| CCK | 科科斯群岛 | kekesiqundao | kksqd |
| COM | 科摩罗 | kemoluo | kml |
| CIV | 科特迪瓦 | ketediwa | ktdw |
| KWT | 科威特 | keweite | kwt |
| HRV | 克罗地亚 | keluodiya | kldy |
| KEN | 肯尼亚 | kenniya | kny |
| COK | 库克群岛 | kukequndao | kkqd |
| LVA | 拉脱维亚 | latuoweiya | ltwy |
| LSO | 莱索托 | laisuotuo | lst |
| LAO | 老挝 | laowo | lw |
| LBN | 黎巴嫩 | libanen | lbn |
| LBR | 利比里亚 | libiliya | lbly |
| LBY | 利比亚 | libiya | lby |
| LTU | 立陶宛 | litaowan | ltw |
| LIE | 列支敦士登 | liezhidunshideng | lzdsd |
| REU | 留尼旺岛 | liuniwangdao | lnwd |
| LUX | 卢森堡 | lusenbao | lsb |
| RWA | 卢旺达 | luwangda | lwd |
| ROU | 罗马尼亚 | luomaniya | lmny |
| MDG | 马达加斯加 | madajiasijia | mdjsj |
| MDV | 马尔代夫 | maerdaifu | medf |
| MLT | 马耳他 | maerta | met |
| MWI | 马拉维 | malawei | mlw |
| MYS | 马来西亚 | malaixiya | mlxy |
| MLI | 马里 | mali | ml |
| MKD | 马其顿 | maqidun | mqd |
| MHL | 马绍尔群岛 | mashaoerqundao | mseqd |
| MTQ | 马提尼克 | matinike | mtnk |
| MYT | 马约特岛 | mayuetedao | mytd |
| IMN | 曼岛 | mandao | md |
| MUS | 毛里求斯 | maoliqiusi | mlqs |
| MRT | 毛里塔尼亚 | maolitaniya | mltny |
| USA | 美国 | meiguo | mg |
| ASM | 美属萨摩亚 | meishusamoya | mssmy |
| UMI | 美属外岛 | meishuwaidao | mswd |
| MNG | 蒙古 | menggu | mg |
| MSR | 蒙特塞拉特 | mengtesailate | mtslt |
| BGD | 孟加拉 | mengjiala | mjl |
| FSM | 密克罗尼西亚 | mikeluonixiya | mklnxy |
| PER | 秘鲁 | bilu | bl |
| MMR | 缅甸 | miandian | md |
| MDA | 摩尔多瓦 | moerduowa | medw |
| MAR | 摩洛哥 | moluoge | mlg |
| MCO | 摩纳哥 | monage | mng |
| MOZ | 莫桑比克 | mosangbike | msbk |
| MEX | 墨西哥 | moxige | mxg |
| NAM | 纳米比亚 | namibiya | nmby |
| ZAF | 南非 | nanfei | nf |
| ATA | 南极洲 | nanjizhou | njz |
| SGS | 南乔治亚和南桑德威奇群岛 | nanqiaozhiyahenansangdeweiqiqundao | nqzyhnsdwqqd |
| NRU | 瑙鲁 | naolu | nl |
| NPL | 尼泊尔 | niboer | nbe |
| NIC | 尼加拉瓜 | nijialagua | njlg |
| NER | 尼日尔 | nirier | nre |
| NGA | 尼日利亚 | niriliya | nrly |
| NIU | 纽埃 | niuai | na |
| NOR | 挪威 | nuowei | nw |
| NFK | 诺福克 | nuofuke | nfk |
| PLW | 帕劳群岛 | palaoqundao | plqd |
| PCN | 皮特凯恩 | pitekaien | ptke |
| PRT | 葡萄牙 | putaoya | pty |
| GEO | 乔治亚 | qiaozhiya | qzy |
| JPN | 日本 | riben | rb |
| SWE | 瑞典 | ruidian | rd |
| CHE | 瑞士 | ruishi | rs |
| SLV | 萨尔瓦多 | saerwaduo | sewd |
| WSM | 萨摩亚 | samoya | smy |
| SCG | 塞尔维亚,黑山 | saierweiya,heishan | sewy, |
| SLE | 塞拉利昂 | sailaliang | slla |
| SEN | 塞内加尔 | saineijiaer | snje |
| CYP | 塞浦路斯 | saipulusi | spls |
| SYC | 塞舌尔 | saisheer | sse |
| SAU | 沙特阿拉伯 | shatealabo | stalb |
| CXR | 圣诞岛 | shengdandao | sdd |
| STP | 圣多美和普林西比 | shengduomeihepulinxibi | sdmhplxb |
| SHN | 圣赫勒拿 | shenghelena | shln |
| KNA | 圣基茨和尼维斯 | shengjiciheniweisi | sjchnws |
| LCA | 圣卢西亚 | shengluxiya | slxy |
| SMR | 圣马力诺 | shengmalinuo | smln |
| SPM | 圣皮埃尔和米克隆群岛 | shengpiaierhemikeLongqundao | spaehmklqd |
| VCT | 圣文森特和格林纳丁斯 | shengwensentehegelinnadingsi | swsthglnds |
| LKA | 斯里兰卡 | sililanka | sllk |
| SVK | 斯洛伐克 | siluofake | slfk |
| SVN | 斯洛文尼亚 | siluowenniya | slwny |
| SJM | 斯瓦尔巴和扬马廷 | siwaerbaheyangmating | swebhymt |
| SWZ | 斯威士兰 | siweishilan | swsl |
| SDN | 苏丹 | sudan | sd |
| SUR | 苏里南 | sulinan | sln |
| SLB | 所罗门群岛 | suoluomenqundao | slmqd |
| SOM | 索马里 | suomali | sml |
| TJK | 塔吉克斯坦 | tajikesitan | tjkst |
| THA | 泰国 | taiguo | tg |
| TZA | 坦桑尼亚 | tansangniya | tsny |
| TON | 汤加 | tangjia | tj |
| TCA | 特克斯和凯克特斯群岛 | tekesihekaiketesiqundao | tkshkktsqd |
| TAA | 特里斯坦达昆哈 | telisitandakunha | tlstdkh |
| TTO | 特立尼达和多巴哥 | telinidaheduobage | tlndhdbg |
| TUN | 突尼斯 | tunisi | tns |
| TUV | 图瓦卢 | tuwalu | twl |
| TUR | 土耳其 | tuerqi | teq |
| TKM | 土库曼斯坦 | tukumansitan | tkmst |
| TKL | 托克劳 | tuokelao | tkl |
| WLF | 瓦利斯和福图纳 | walisihefutuna | wlshftn |
| VUT | 瓦努阿图 | wanuatu | wnat |
| GTM | 危地马拉 | weidimala | wdml |
| VIR | 维尔京群岛，美属 | weierjingqundao，meishu | wejqd， |
| VGB | 维尔京群岛，英属 | weierjingqundao，yingshu | wejqd， |
| VEN | 委内瑞拉 | weineiruila | wnrl |
| BRN | 文莱 | wenlai | wl |
| UGA | 乌干达 | wuganda | wgd |
| UKR | 乌克兰 | wukelan | wkl |
| URY | 乌拉圭 | wulagui | wlg |
| UZB | 乌兹别克斯坦 | wuzibiekesitan | wzbkst |
| ESP | 西班牙 | xibanya | xby |
| GRC | 希腊 | xila | xl |
| SGP | 新加坡 | xinjiapo | xjp |
| NCL | 新喀里多尼亚 | xinkaliduoniya | xkldny |
| NZL | 新西兰 | xinxilan | xxl |
| HUN | 匈牙利 | xiongyali | xyl |
| SYR | 叙利亚 | xuliya | xly |
| JAM | 牙买加 | yamaijia | ymj |
| ARM | 亚美尼亚 | yameiniya | ymny |
| YEM | 也门 | yemen | ym |
| IRQ | 伊拉克 | yilake | ylk |
| IRN | 伊朗 | yilang | yl |
| ISR | 以色列 | yiselie | ysl |
| ITA | 意大利 | yidali | ydl |
| IND | 印度 | yindu | yd |
| IDN | 印度尼西亚 | yindunixiya | ydnxy |
| GBR | 英国 | yingguo | yg |
| IOT | 英属印度洋领地 | yingshuyinduyanglingdi | ysydyld |
| JOR | 约旦 | yuedan | yd |
| VNM | 越南 | yuenan | yn |
| ZMB | 赞比亚 | zanbiya | zby |
| JEY | 泽西岛 | zexidao | zxd |
| TCD | 乍得 | zhade | zd |
| GIB | 直布罗陀 | zhibuluotuo | zblt |
| CHL | 智利 | zhili | zl |
| CAF | 中非共和国 | zhongfeigongheguo | zfghg |
城市码表
| 编码 | 名称 | 省份编码 | 拼音全称 | 拼音缩写 |
|---|---|---|---|---|
| 110000 | 北京市 | 110000 | beijingshi | bj |
| 120000 | 天津市 | 120000 | tianjinshi | tj |
| 130100 | 石家庄市 | 130000 | shijiazhuangshi | sjz |
| 130200 | 唐山市 | 130000 | tangshanshi | ts |
| 130300 | 秦皇岛市 | 130000 | qinhuangdaoshi | qhds |
| 130400 | 邯郸市 | 130000 | handanshi | hds |
| 130500 | 邢台市 | 130000 | xingtaishi | xt |
| 130600 | 保定市 | 130000 | baodingshi | bd |
| 130700 | 张家口市 | 130000 | zhangjiakoushi | zjk |
| 130800 | 承德市 | 130000 | chengdeshi | cd |
| 130900 | 沧州市 | 130000 | cangzhoushi | cz |
| 131000 | 廊坊市 | 130000 | langfangshi | lf |
| 131100 | 衡水市 | 130000 | hengshuishi | hs |
| 140100 | 太原市 | 140000 | taiyuanshi | ty |
| 140200 | 大同市 | 140000 | datongshi | dt |
| 140300 | 阳泉市 | 140000 | yangquanshi | yqs |
| 140400 | 长治市 | 140000 | zhangzhishi | zz |
| 140500 | 晋城市 | 140000 | jinchengshi | jc |
| 140600 | 朔州市 | 140000 | shuozhoushi | sz |
| 140700 | 晋中市 | 140000 | jinzhongshi | jz |
| 140800 | 运城市 | 140000 | yunchengshi | yc |
| 140900 | 忻州市 | 140000 | xinzhoushi | xz |
| 141000 | 临汾市 | 140000 | linfenshi | lfs |
| 141100 | 吕梁市 | 140000 | lvliangshi | ll |
| 150100 | 呼和浩特市 | 150000 | huhehaoteshi | hhht |
| 150200 | 包头市 | 150000 | baotoushi | bt |
| 150300 | 乌海市 | 150000 | wuhaishi | wh |
| 150400 | 赤峰市 | 150000 | chifengshi | cfs |
| 150500 | 通辽市 | 150000 | tongliaoshi | tls |
| 150600 | 鄂尔多斯市 | 150000 | eerduosishi | eedss |
| 150700 | 呼伦贝尔市 | 150000 | hulunbeiershi | hlbes |
| 150800 | 巴彦淖尔市 | 150000 | bayannaoershi | bynes |
| 150900 | 乌兰察布市 | 150000 | wulanchabushi | wlcb |
| 152200 | 兴安盟 | 150000 | xinganmeng | xam |
| 152500 | 锡林郭勒盟 | 150000 | xilinguolemeng | xlgl |
| 152900 | 阿拉善盟 | 150000 | alashanmeng | als |
| 210100 | 沈阳市 | 210000 | shenyangshi | sys |
| 210200 | 大连市 | 210000 | dalianshi | dl |
| 210300 | 鞍山市 | 210000 | anshanshi | as |
| 210400 | 抚顺市 | 210000 | fushunshi | fs |
| 210500 | 本溪市 | 210000 | benxishi | bxs |
| 210600 | 丹东市 | 210000 | dandongshi | dd |
| 210700 | 锦州市 | 210000 | jinzhoushi | jz |
| 210800 | 营口市 | 210000 | yingkoushi | yk |
| 210900 | 阜新市 | 210000 | fuxinshi | fx |
| 211000 | 辽阳市 | 210000 | liaoyangshi | lys |
| 211100 | 盘锦市 | 210000 | panjinshi | pj |
| 211200 | 铁岭市 | 210000 | tielingshi | tls |
| 211300 | 朝阳市 | 210000 | zhaoyangshi | zy |
| 211400 | 葫芦岛市 | 210000 | huludaoshi | hlds |
| 220100 | 长春市 | 220000 | changchunshi | cc |
| 220200 | 吉林市 | 220000 | jilinshi | jl |
| 220300 | 四平市 | 220000 | sipingshi | sp |
| 220400 | 辽源市 | 220000 | liaoyuanshi | lys |
| 220500 | 通化市 | 220000 | tonghuashi | th |
| 220600 | 白山市 | 220000 | baishanshi | bs |
| 220700 | 松原市 | 220000 | songyuanshi | sy |
| 220800 | 白城市 | 220000 | baichengshi | bc |
| 222400 | 延边朝鲜族自治州 | 220000 | yanbianchaoxianzuzizhizhou | ybcxzzz |
| 230100 | 哈尔滨市 | 230000 | haerbinshi | hebs |
| 230200 | 齐齐哈尔市 | 230000 | qiqihaershi | qqhes |
| 230300 | 鸡西市 | 230000 | jixishi | jx |
| 230400 | 鹤岗市 | 230000 | hegangshi | hg |
| 230500 | 双鸭山市 | 230000 | shuangyashanshi | sys |
| 230600 | 大庆市 | 230000 | daqingshi | dqs |
| 230700 | 伊春市 | 230000 | yichunshi | yc |
| 230800 | 佳木斯市 | 230000 | jiamusishi | jmss |
| 230900 | 七台河市 | 230000 | qitaiheshi | qth |
| 231000 | 牡丹江市 | 230000 | mudanjiangshi | mdj |
| 231100 | 黑河市 | 230000 | heiheshi | hh |
| 231200 | 绥化市 | 230000 | suihuashi | sh |
| 232700 | 大兴安岭地区 | 230000 | daxinganlingdiqu | dxald |
| 310000 | 上海市 | 310000 | shanghaishi | sh |
| 320100 | 南京市 | 320000 | nanjingshi | nj |
| 320200 | 无锡市 | 320000 | wuxishi | wxs |
| 320300 | 徐州市 | 320000 | xuzhoushi | xz |
| 320400 | 常州市 | 320000 | changzhoushi | cz |
| 320500 | 苏州市 | 320000 | suzhoushi | sz |
| 320600 | 南通市 | 320000 | nantongshi | nt |
| 320700 | 连云港市 | 320000 | lianyungangshi | lygs |
| 320800 | 淮安市 | 320000 | huaianshi | ha |
| 320900 | 盐城市 | 320000 | yanchengshi | yc |
| 321000 | 扬州市 | 320000 | yangzhoushi | yz |
| 321100 | 镇江市 | 320000 | zhenjiangshi | zj |
| 321200 | 泰州市 | 320000 | taizhoushi | tz |
| 321300 | 宿迁市 | 320000 | suqianshi | sq |
| 330100 | 杭州市 | 330000 | hangzhoushi | hz |
| 330200 | 宁波市 | 330000 | ningboshi | nb |
| 330300 | 温州市 | 330000 | wenzhoushi | wz |
| 330400 | 嘉兴市 | 330000 | jiaxingshi | jxs |
| 330500 | 湖州市 | 330000 | huzhoushi | hz |
| 330600 | 绍兴市 | 330000 | shaoxingshi | sx |
| 330700 | 金华市 | 330000 | jinhuashi | jh |
| 330800 | 衢州市 | 330000 | quzhoushi | qz |
| 330900 | 舟山市 | 330000 | zhoushanshi | zs |
| 331000 | 台州市 | 330000 | taizhoushi | tzs |
| 331100 | 丽水市 | 330000 | lishuishi | lss |
| 340100 | 合肥市 | 340000 | hefeishi | hfs |
| 340200 | 芜湖市 | 340000 | wuhushi | wh |
| 340300 | 蚌埠市 | 340000 | bengbushi | bbs |
| 340400 | 淮南市 | 340000 | huainanshi | hn |
| 340500 | 马鞍山市 | 340000 | maanshanshi | mas |
| 340600 | 淮北市 | 340000 | huaibeishi | hb |
| 340700 | 铜陵市 | 340000 | tonglingshi | tl |
| 340800 | 安庆市 | 340000 | anqingshi | aqs |
| 341000 | 黄山市 | 340000 | huangshanshi | hs |
| 341100 | 滁州市 | 340000 | chuzhoushi | cz |
| 341200 | 阜阳市 | 340000 | fuyangshi | fys |
| 341300 | 宿州市 | 340000 | suzhoushi | sz |
| 341500 | 六安市 | 340000 | luanshi | las |
| 341600 | 亳州市 | 340000 | bozhoushi | bz |
| 341700 | 池州市 | 340000 | chizhoushi | cz |
| 341800 | 宣城市 | 340000 | xuanchengshi | xc |
| 350100 | 福州市 | 350000 | fuzhoushi | fz |
| 350200 | 厦门市 | 350000 | xiamenshi | xms |
| 350300 | 莆田市 | 350000 | putianshi | pt |
| 350400 | 三明市 | 350000 | sanmingshi | sm |
| 350500 | 泉州市 | 350000 | quanzhoushi | qz |
| 350600 | 漳州市 | 350000 | zhangzhoushi | zz |
| 350700 | 南平市 | 350000 | nanpingshi | np |
| 350800 | 龙岩市 | 350000 | Longyanshi | ly |
| 350900 | 宁德市 | 350000 | ningdeshi | nd |
| 360100 | 南昌市 | 360000 | nanchangshi | nc |
| 360200 | 景德镇市 | 360000 | jingdezhenshi | jdzs |
| 360300 | 萍乡市 | 360000 | pingxiangshi | px |
| 360400 | 九江市 | 360000 | jiujiangshi | jj |
| 360500 | 新余市 | 360000 | xinyushi | xy |
| 360600 | 鹰潭市 | 360000 | yingtanshi | yts |
| 360700 | 赣州市 | 360000 | ganzhoushi | gz |
| 360800 | 吉安市 | 360000 | jianshi | ja |
| 360900 | 宜春市 | 360000 | yichunshi | yc |
| 361000 | 抚州市 | 360000 | fuzhoushi | fz |
| 361100 | 上饶市 | 360000 | shangraoshi | srs |
| 370100 | 济南市 | 370000 | jinanshi | jns |
| 370200 | 青岛市 | 370000 | qingdaoshi | qds |
| 370300 | 淄博市 | 370000 | ziboshi | zb |
| 370400 | 枣庄市 | 370000 | zaozhuangshi | zz |
| 370500 | 东营市 | 370000 | dongyingshi | dy |
| 370600 | 烟台市 | 370000 | yantaishi | yt |
| 370700 | 潍坊市 | 370000 | weifangshi | wf |
| 370800 | 济宁市 | 370000 | jiningshi | jns |
| 370900 | 泰安市 | 370000 | taianshi | ta |
| 371000 | 威海市 | 370000 | weihaishi | wh |
| 371100 | 日照市 | 370000 | rizhaoshi | rz |
| 371200 | 莱芜市 | 370000 | laiwushi | lws |
| 371300 | 临沂市 | 370000 | linyishi | lys |
| 371400 | 德州市 | 370000 | dezhoushi | dz |
| 371500 | 聊城市 | 370000 | liaochengshi | lc |
| 371800 | 胶州市 | 370000 | jiaozhoushi | jzs |
| 331200 | 余姚市 | 330000 | yuyaoshi | yys |
| 331300 | 永康市 | 330000 | yongkangshi | yks |
| 371600 | 滨州市 | 370000 | binzhoushi | bz |
| 371700 | 菏泽市 | 370000 | hezeshi | hzs |
| 410100 | 郑州市 | 410000 | zhengzhoushi | zz |
| 410200 | 开封市 | 410000 | kaifengshi | kf |
| 410300 | 洛阳市 | 410000 | luoyangshi | lys |
| 410400 | 平顶山市 | 410000 | pingdingshanshi | pds |
| 410500 | 安阳市 | 410000 | anyangshi | ays |
| 410600 | 鹤壁市 | 410000 | hebishi | hbs |
| 410700 | 新乡市 | 410000 | xinxiangshi | xx |
| 410800 | 焦作市 | 410000 | jiaozuoshi | jz |
| 410900 | 濮阳市 | 410000 | puyangshi | pys |
| 411000 | 许昌市 | 410000 | xuchangshi | xc |
| 411100 | 漯河市 | 410000 | taheshi | ths |
| 411200 | 三门峡市 | 410000 | sanmenxiashi | smxs |
| 411300 | 南阳市 | 410000 | nanyangshi | nys |
| 411400 | 商丘市 | 410000 | shangqiushi | sqs |
| 411500 | 信阳市 | 410000 | xinyangshi | xys |
| 411600 | 周口市 | 410000 | zhoukoushi | zk |
| 411700 | 驻马店市 | 410000 | zhumadianshi | zmd |
| 420100 | 武汉市 | 420000 | wuhanshi | wh |
| 420200 | 黄石市 | 420000 | huangshishi | hs |
| 420300 | 十堰市 | 420000 | shiyanshi | sy |
| 420500 | 宜昌市 | 420000 | yichangshi | yc |
| 420600 | 襄阳市 | 420000 | xiangyangshi | xys |
| 420700 | 鄂州市 | 420000 | ezhoushi | ez |
| 420800 | 荆门市 | 420000 | jingmenshi | jm |
| 420900 | 孝感市 | 420000 | xiaoganshi | xg |
| 421000 | 荆州市 | 420000 | jingzhoushi | jz |
| 421100 | 黄冈市 | 420000 | huanggangshi | hgs |
| 421200 | 咸宁市 | 420000 | xianningshi | xn |
| 421300 | 随州市 | 420000 | suizhoushi | sz |
| 422800 | 恩施土家族苗族自治州 | 420000 | enshitujiazumiaozuzizhizhou | estjzmzzz |
| 430100 | 长沙市 | 430000 | zhangshashi | zs |
| 430200 | 株洲市 | 430000 | zhuzhoushi | zz |
| 430300 | 湘潭市 | 430000 | xiangtanshi | xts |
| 430400 | 衡阳市 | 430000 | hengyangshi | hys |
| 430500 | 邵阳市 | 430000 | shaoyangshi | sys |
| 430600 | 岳阳市 | 430000 | yueyangshi | yys |
| 430700 | 常德市 | 430000 | changdeshi | cd |
| 430800 | 张家界市 | 430000 | zhangjiajieshi | zjjs |
| 430900 | 益阳市 | 430000 | yiyangshi | yys |
| 431000 | 郴州市 | 430000 | chenzhoushi | cz |
| 431100 | 永州市 | 430000 | yongzhoushi | yz |
| 431200 | 怀化市 | 430000 | huaihuashi | hh |
| 431300 | 娄底市 | 430000 | loudishi | ld |
| 433100 | 湘西土家族苗族自治州 | 430000 | xiangxitujiazumiaozuzizhizhou | xxtjzmzzz |
| 440100 | 广州市 | 440000 | guangzhoushi | gz |
| 440200 | 韶关市 | 440000 | shaoguanshi | sg |
| 440300 | 深圳市 | 440000 | shenzhenshi | szs |
| 440400 | 珠海市 | 440000 | zhuhaishi | zh |
| 440500 | 汕头市 | 440000 | shantoushi | st |
| 440600 | 佛山市 | 440000 | foshanshi | fs |
| 440700 | 江门市 | 440000 | jiangmenshi | jm |
| 440800 | 湛江市 | 440000 | zhanjiangshi | zj |
| 440900 | 茂名市 | 440000 | maomingshi | mm |
| 441200 | 肇庆市 | 440000 | zhaoqingshi | zqs |
| 441300 | 惠州市 | 440000 | huizhoushi | hz |
| 441400 | 梅州市 | 440000 | meizhoushi | mz |
| 441500 | 汕尾市 | 440000 | shanweishi | sw |
| 441600 | 河源市 | 440000 | heyuanshi | hys |
| 441700 | 阳江市 | 440000 | yangjiangshi | yj |
| 441800 | 清远市 | 440000 | qingyuanshi | qy |
| 441900 | 东莞市 | 440000 | dongguanshi | dgs |
| 442000 | 中山市 | 440000 | zhongshanshi | zs |
| 445100 | 潮州市 | 440000 | chaozhoushi | cz |
| 445200 | 揭阳市 | 440000 | jieyangshi | jys |
| 445300 | 云浮市 | 440000 | yunfushi | yf |
| 450100 | 南宁市 | 450000 | nanningshi | nn |
| 450200 | 柳州市 | 450000 | liuzhoushi | lz |
| 450300 | 桂林市 | 450000 | guilinshi | gl |
| 450400 | 梧州市 | 450000 | wuzhoushi | wz |
| 450500 | 北海市 | 450000 | beihaishi | bh |
| 450600 | 防城港市 | 450000 | fangchenggangshi | fcgs |
| 450700 | 钦州市 | 450000 | qinzhoushi | qz |
| 450800 | 贵港市 | 450000 | guigangshi | ggs |
| 450900 | 玉林市 | 450000 | yulinshi | yl |
| 451000 | 百色市 | 450000 | baiseshi | bs |
| 451100 | 贺州市 | 450000 | hezhoushi | hz |
| 451200 | 河池市 | 450000 | hechishi | hcs |
| 451300 | 来宾市 | 450000 | laibinshi | lbs |
| 451400 | 崇左市 | 450000 | chongzuoshi | cz |
| 460100 | 海口市 | 460000 | haikoushi | hk |
| 460200 | 三亚市 | 460000 | sanyashi | sy |
| 460300 | 三沙市 | 460000 | sanshashi | ss |
| 460400 | 儋州市 | 460000 | danzhoushi | dz |
| 500000 | 重庆市 | 500000 | chongqingshi | cqs |
| 510100 | 成都市 | 510000 | chengdushi | cd |
| 510300 | 自贡市 | 510000 | zigongshi | zg |
| 510400 | 攀枝花市 | 510000 | panzhihuashi | pzh |
| 510500 | 泸州市 | 510000 | luzhoushi | lz |
| 510600 | 德阳市 | 510000 | deyangshi | dys |
| 510700 | 绵阳市 | 510000 | mianyangshi | mys |
| 510800 | 广元市 | 510000 | guangyuanshi | gys |
| 510900 | 遂宁市 | 510000 | suiningshi | sn |
| 511000 | 内江市 | 510000 | neijiangshi | nj |
| 511100 | 乐山市 | 510000 | leshanshi | l |
| 511300 | 南充市 | 510000 | nanchongshi | nc |
| 511400 | 眉山市 | 510000 | meishanshi | ms |
| 511500 | 宜宾市 | 510000 | yibinshi | ybs |
| 511600 | 广安市 | 510000 | guanganshi | ga |
| 511700 | 达州市 | 510000 | dazhoushi | dz |
| 511800 | 雅安市 | 510000 | yaanshi | ya |
| 511900 | 巴中市 | 510000 | bazhongshi | bz |
| 512000 | 资阳市 | 510000 | ziyangshi | zys |
| 513200 | 阿坝藏族羌族自治州 | 510000 | abazangzuqiangzuzizhizhou | abzzqzzz |
| 513300 | 甘孜藏族自治州 | 510000 | ganzizangzuzizhizhou | gzzzzz |
| 513400 | 凉山彝族自治州 | 510000 | liangshanyizuzizhizhou | lsyzzz |
| 520100 | 贵阳市 | 520000 | guiyangshi | gys |
| 520200 | 六盘水市 | 520000 | liupanshuishi | lps |
| 520300 | 遵义市 | 520000 | zunyishi | zy |
| 520400 | 安顺市 | 520000 | anshunshi | as |
| 520500 | 毕节市 | 520000 | bijieshi | bj |
| 520600 | 铜仁市 | 520000 | tongrenshi | trs |
| 522300 | 黔西南布依族苗族自治州 | 520000 | qianxinanbuyizumiaozuzizhizhou | qxnbyzmzzz |
| 522600 | 黔东南苗族侗族自治州 | 520000 | qiandongnanmiaozudongzuzizhizhou | qdnmzdzzz |
| 522700 | 黔南布依族苗族自治州 | 520000 | qiannanbuyizumiaozuzizhizhou | qnbyzmzzz |
| 530100 | 昆明市 | 530000 | kunmingshi | km |
| 530300 | 曲靖市 | 530000 | qujingshi | qjs |
| 530400 | 玉溪市 | 530000 | yuxishi | yxs |
| 530500 | 保山市 | 530000 | baoshanshi | bs |
| 530600 | 昭通市 | 530000 | zhaotongshi | zt |
| 530700 | 丽江市 | 530000 | lijiangshi | lj |
| 530800 | 普洱市 | 530000 | puershi | pes |
| 530900 | 临沧市 | 530000 | lincangshi | lcs |
| 532300 | 楚雄彝族自治州 | 530000 | chuxiongyizuzizhizhou | cxyzzz |
| 532500 | 红河哈尼族彝族自治州 | 530000 | honghehanizuyizuzizhizhou | hhhnzyzzz |
| 532600 | 文山壮族苗族自治州 | 530000 | wenshanzhuangzumiaozuzizhizhou | wszzmzzz |
| 532800 | 西双版纳傣族自治州 | 530000 | xishuangbannadaizuzizhizhou | xsbndzzz |
| 532900 | 大理白族自治州 | 530000 | dalibaizuzizhizhou | dlbzzz |
| 533100 | 德宏傣族景颇族自治州 | 530000 | dehongdaizujingpozuzizhizhou | dhdzjpzzz |
| 533300 | 怒江傈僳族自治州 | 530000 | nujianglisuzuzizhizhou | njlszzz |
| 533400 | 迪庆藏族自治州 | 530000 | diqingzangzuzizhizhou | dqzzzz |
| 540100 | 拉萨市 | 540000 | lasashi | lss |
| 540200 | 日喀则市 | 540000 | rikazeshi | rkzs |
| 540300 | 昌都市 | 540000 | changdushi | cds |
| 540400 | 林芝市 | 540000 | linzhishi | lzs |
| 540500 | 山南市 | 540000 | shannanshi | sn |
| 540600 | 那曲市 | 540000 | neiqushi | nq |
| 542500 | 阿里地区 | 540000 | alidiqu | ald |
| 610100 | 西安市 | 610000 | xianshi | xa |
| 610200 | 铜川市 | 610000 | tongchuanshi | tc |
| 610300 | 宝鸡市 | 610000 | baojishi | bj |
| 610400 | 咸阳市 | 610000 | xianyangshi | xys |
| 610500 | 渭南市 | 610000 | weinanshi | wn |
| 610600 | 延安市 | 610000 | yananshi | ya |
| 610700 | 汉中市 | 610000 | hanzhongshi | hz |
| 610800 | 榆林市 | 610000 | yulinshi | yl |
| 610900 | 安康市 | 610000 | ankangshi | aks |
| 611000 | 商洛市 | 610000 | shangluoshi | sls |
| 620100 | 兰州市 | 620000 | lanzhoushi | lz |
| 620200 | 嘉峪关市 | 620000 | jiayuguanshi | jyg |
| 620300 | 金昌市 | 620000 | jinchangshi | jc |
| 620400 | 白银市 | 620000 | baiyinshi | by |
| 620500 | 天水市 | 620000 | tianshuishi | ts |
| 620600 | 武威市 | 620000 | wuweishi | ww |
| 620700 | 张掖市 | 620000 | zhangyeshi | zy |
| 620800 | 平凉市 | 620000 | pingliangshi | pl |
| 620900 | 酒泉市 | 620000 | jiuquanshi | jqs |
| 621000 | 庆阳市 | 620000 | qingyangshi | qys |
| 621100 | 定西市 | 620000 | dingxishi | dx |
| 621200 | 陇南市 | 620000 | Longnanshi | ln |
| 622900 | 临夏回族自治州 | 620000 | linxiahuizuzizhizhou | lxhzzz |
| 623000 | 甘南藏族自治州 | 620000 | gannanzangzuzizhizhou | gnzzzz |
| 630100 | 西宁市 | 630000 | xiningshi | xn |
| 630200 | 海东市 | 630000 | haidongshi | hd |
| 632200 | 海北藏族自治州 | 630000 | haibeizangzuzizhizhou | hbzzzz |
| 632300 | 黄南藏族自治州 | 630000 | huangnanzangzuzizhizhou | hnzzzz |
| 632500 | 海南藏族自治州 | 630000 | hainanzangzuzizhizhou | hnzzzz |
| 632600 | 果洛藏族自治州 | 630000 | guoluozangzuzizhizhou | glzzzz |
| 632700 | 玉树藏族自治州 | 630000 | yushuzangzuzizhizhou | yszzzz |
| 632800 | 海西蒙古族藏族自治州 | 630000 | haiximengguzuzangzuzizhizhou | hxmgzzzzz |
| 640100 | 银川市 | 640000 | yinchuanshi | yc |
| 640200 | 石嘴山市 | 640000 | shizuishanshi | szs |
| 640300 | 吴忠市 | 640000 | wuzhongshi | wz |
| 640400 | 固原市 | 640000 | guyuanshi | gy |
| 640500 | 中卫市 | 640000 | zhongweishi | zws |
| 650100 | 乌鲁木齐市 | 650000 | wulumuqishi | wlmq |
| 650200 | 克拉玛依市 | 650000 | kelamayishi | klmy |
| 650400 | 吐鲁番市 | 650000 | tulufanshi | tlf |
| 650500 | 哈密市 | 650000 | hamishi | hm |
| 652300 | 昌吉回族自治州 | 650000 | changjihuizuzizhizhou | cjhzzz |
| 652700 | 博尔塔拉蒙古自治州 | 650000 | boertalamengguzizhizhou | betlmgzz |
| 652800 | 巴音郭楞蒙古自治州 | 650000 | bayinguolengmengguzizhizhou | byglmgzz |
| 652900 | 阿克苏地区 | 650000 | akesudiqu | aksd |
| 653000 | 克孜勒苏柯尔克孜自治州 | 650000 | kezilesukeerkezizizhizhou | kzlskekzzz |
| 653100 | 喀什地区 | 650000 | kashidiqu | ksd |
| 653200 | 和田地区 | 650000 | hetiandiqu | htd |
| 654000 | 伊犁哈萨克自治州 | 650000 | yilihasakezizhizhou | ylhskzz |
| 654200 | 塔城地区 | 650000 | tachengdiqu | tcd |
| 654300 | 阿勒泰地区 | 650000 | aletaidiqu | altd |
| 710100 | 台北市 | 710000 | taibeishi | tb |
| 710200 | 新北市 | 710000 | xinbeishi | xb |
| 710300 | 桃园市 | 710000 | taoyuanshi | tys |
| 710400 | 台中市 | 710000 | taizhongshi | tz |
| 710500 | 台南市 | 710000 | tainanshi | tn |
| 710600 | 高雄市 | 710000 | gaoxiongshi | gx |
| 710700 | 基隆市 | 710000 | jiLongshi | jl |
| 710800 | 新竹市 | 710000 | xinzhushi | xz |
| 710900 | 嘉义市 | 710000 | jiayishi | jy |
| 810000 | 香港特别行政区 | 810000 | xianggangtebiexingzhengqu | xgtbxzq |
| 820000 | 澳门特别行政区 | 820000 | aomentebiexingzhengqu | amtbxzq |
地区码表
| 地区编码 | 地区名称 | 城市编码 |
|---|---|---|
| 110101 | 东城区 | 110000 |
| 110102 | 西城区 | 110000 |
| 110105 | 朝阳区 | 110000 |
| 110106 | 丰台区 | 110000 |
| 110107 | 石景山区 | 110000 |
| 110108 | 海淀区 | 110000 |
| 110109 | 门头沟区 | 110000 |
| 110111 | 房山区 | 110000 |
| 110112 | 通州区 | 110000 |
| 110113 | 顺义区 | 110000 |
| 110114 | 昌平区 | 110000 |
| 110115 | 大兴区 | 110000 |
| 110116 | 怀柔区 | 110000 |
| 110117 | 平谷区 | 110000 |
| 110118 | 密云区 | 110000 |
| 110119 | 延庆区 | 110000 |
| 120101 | 和平区 | 120000 |
| 120102 | 河东区 | 120000 |
| 120103 | 河西区 | 120000 |
| 120104 | 南开区 | 120000 |
| 120105 | 河北区 | 120000 |
| 120106 | 红桥区 | 120000 |
| 120110 | 东丽区 | 120000 |
| 120111 | 西青区 | 120000 |
| 120112 | 津南区 | 120000 |
| 120113 | 北辰区 | 120000 |
| 120114 | 武清区 | 120000 |
| 120115 | 宝坻区 | 120000 |
| 120116 | 滨海新区 | 120000 |
| 120117 | 宁河区 | 120000 |
| 120118 | 静海区 | 120000 |
| 120119 | 蓟州区 | 120000 |
| 130102 | 长安区 | 130100 |
| 130104 | 桥西区 | 130100 |
| 130105 | 新华区 | 130100 |
| 130107 | 井陉矿区 | 130100 |
| 130108 | 裕华区 | 130100 |
| 130109 | 藁城区 | 130100 |
| 130110 | 鹿泉区 | 130100 |
| 130111 | 栾城区 | 130100 |
| 130121 | 井陉县 | 130100 |
| 130123 | 正定县 | 130100 |
| 130125 | 行唐县 | 130100 |
| 130126 | 灵寿县 | 130100 |
| 130127 | 高邑县 | 130100 |
| 130128 | 深泽县 | 130100 |
| 130129 | 赞皇县 | 130100 |
| 130130 | 无极县 | 130100 |
| 130131 | 平山县 | 130100 |
| 130132 | 元氏县 | 130100 |
| 130133 | 赵县 | 130100 |
| 130181 | 辛集市 | 130100 |
| 130183 | 晋州市 | 130100 |
| 130184 | 新乐市 | 130100 |
| 130202 | 路南区 | 130200 |
| 130203 | 路北区 | 130200 |
| 130204 | 古冶区 | 130200 |
| 130205 | 开平区 | 130200 |
| 130207 | 丰南区 | 130200 |
| 130208 | 丰润区 | 130200 |
| 130209 | 曹妃甸区 | 130200 |
| 130223 | 滦县 | 130200 |
| 130224 | 滦南县 | 130200 |
| 130225 | 乐亭县 | 130200 |
| 130227 | 迁西县 | 130200 |
| 130229 | 玉田县 | 130200 |
| 130281 | 遵化市 | 130200 |
| 130283 | 迁安市 | 130200 |
| 130302 | 海港区 | 130300 |
| 130303 | 山海关区 | 130300 |
| 130304 | 北戴河区 | 130300 |
| 130306 | 抚宁区 | 130300 |
| 130321 | 青龙满族自治县 | 130300 |
| 130322 | 昌黎县 | 130300 |
| 130324 | 卢龙县 | 130300 |
| 130402 | 邯山区 | 130400 |
| 130403 | 丛台区 | 130400 |
| 130404 | 复兴区 | 130400 |
| 130406 | 峰峰矿区 | 130400 |
| 130407 | 肥乡区 | 130400 |
| 130408 | 永年区 | 130400 |
| 130423 | 临漳县 | 130400 |
| 130424 | 成安县 | 130400 |
| 130425 | 大名县 | 130400 |
| 130426 | 涉县 | 130400 |
| 130427 | 磁县 | 130400 |
| 130430 | 邱县 | 130400 |
| 130431 | 鸡泽县 | 130400 |
| 130432 | 广平县 | 130400 |
| 130433 | 馆陶县 | 130400 |
| 130434 | 魏县 | 130400 |
| 130435 | 曲周县 | 130400 |
| 130481 | 武安市 | 130400 |
| 130502 | 襄都区 | 130500 |
| 130503 | 信都区 | 130500 |
| 130521 | 邢台县 | 130500 |
| 130522 | 临城县 | 130500 |
| 130523 | 内丘县 | 130500 |
| 130524 | 柏乡县 | 130500 |
| 130525 | 隆尧县 | 130500 |
| 130526 | 任泽区 | 130500 |
| 130527 | 南和区 | 130500 |
| 130528 | 宁晋县 | 130500 |
| 130529 | 巨鹿县 | 130500 |
| 130530 | 新河县 | 130500 |
| 130531 | 广宗县 | 130500 |
| 130532 | 平乡县 | 130500 |
| 130533 | 威县 | 130500 |
| 130534 | 清河县 | 130500 |
| 130535 | 临西县 | 130500 |
| 130581 | 南宫市 | 130500 |
| 130582 | 沙河市 | 130500 |
| 130602 | 竞秀区 | 130600 |
| 130606 | 莲池区 | 130600 |
| 130607 | 满城区 | 130600 |
| 130608 | 清苑区 | 130600 |
| 130609 | 徐水区 | 130600 |
| 130623 | 涞水县 | 130600 |
| 130624 | 阜平县 | 130600 |
| 130626 | 定兴县 | 130600 |
| 130627 | 唐县 | 130600 |
| 130628 | 高阳县 | 130600 |
| 130629 | 容城县 | 130600 |
| 130630 | 涞源县 | 130600 |
| 130631 | 望都县 | 130600 |
| 130632 | 安新县 | 130600 |
| 130633 | 易县 | 130600 |
| 130634 | 曲阳县 | 130600 |
| 130635 | 蠡县 | 130600 |
| 130636 | 顺平县 | 130600 |
| 130637 | 博野县 | 130600 |
| 130638 | 雄县 | 130600 |
| 130681 | 涿州市 | 130600 |
| 130682 | 定州市 | 130600 |
| 130683 | 安国市 | 130600 |
| 130684 | 高碑店市 | 130600 |
| 130702 | 桥东区 | 130700 |
| 130703 | 桥西区 | 130700 |
| 130705 | 宣化区 | 130700 |
| 130706 | 下花园区 | 130700 |
| 130708 | 万全区 | 130700 |
| 130709 | 崇礼区 | 130700 |
| 130722 | 张北县 | 130700 |
| 130723 | 康保县 | 130700 |
| 130724 | 沽源县 | 130700 |
| 130725 | 尚义县 | 130700 |
| 130726 | 蔚县 | 130700 |
| 130727 | 阳原县 | 130700 |
| 130728 | 怀安县 | 130700 |
| 130730 | 怀来县 | 130700 |
| 130731 | 涿鹿县 | 130700 |
| 130732 | 赤城县 | 130700 |
| 130802 | 双桥区 | 130800 |
| 130803 | 双滦区 | 130800 |
| 130804 | 鹰手营子矿区 | 130800 |
| 130821 | 承德县 | 130800 |
| 130822 | 兴隆县 | 130800 |
| 130824 | 滦平县 | 130800 |
| 130825 | 隆化县 | 130800 |
| 130826 | 丰宁满族自治县 | 130800 |
| 130827 | 宽城满族自治县 | 130800 |
| 130828 | 围场满族蒙古族自治县 | 130800 |
| 130881 | 平泉市 | 130800 |
| 130902 | 新华区 | 130900 |
| 130903 | 运河区 | 130900 |
| 130921 | 沧县 | 130900 |
| 130922 | 青县 | 130900 |
| 130923 | 东光县 | 130900 |
| 130924 | 海兴县 | 130900 |
| 130925 | 盐山县 | 130900 |
| 130926 | 肃宁县 | 130900 |
| 130927 | 南皮县 | 130900 |
| 130928 | 吴桥县 | 130900 |
| 130929 | 献县 | 130900 |
| 130930 | 孟村回族自治县 | 130900 |
| 130981 | 泊头市 | 130900 |
| 130982 | 任丘市 | 130900 |
| 130983 | 黄骅市 | 130900 |
| 130984 | 河间市 | 130900 |
| 131002 | 安次区 | 131000 |
| 131003 | 广阳区 | 131000 |
| 131022 | 固安县 | 131000 |
| 131023 | 永清县 | 131000 |
| 131024 | 香河县 | 131000 |
| 131025 | 大城县 | 131000 |
| 131026 | 文安县 | 131000 |
| 131028 | 大厂回族自治县 | 131000 |
| 131081 | 霸州市 | 131000 |
| 131082 | 三河市 | 131000 |
| 131102 | 桃城区 | 131100 |
| 131103 | 冀州区 | 131100 |
| 131121 | 枣强县 | 131100 |
| 131122 | 武邑县 | 131100 |
| 131123 | 武强县 | 131100 |
| 131124 | 饶阳县 | 131100 |
| 131125 | 安平县 | 131100 |
| 131126 | 故城县 | 131100 |
| 131127 | 景县 | 131100 |
| 131128 | 阜城县 | 131100 |
| 131182 | 深州市 | 131100 |
| 140105 | 小店区 | 140100 |
| 140106 | 迎泽区 | 140100 |
| 140107 | 杏花岭区 | 140100 |
| 140108 | 尖草坪区 | 140100 |
| 140109 | 万柏林区 | 140100 |
| 140110 | 晋源区 | 140100 |
| 140121 | 清徐县 | 140100 |
| 140122 | 阳曲县 | 140100 |
| 140123 | 娄烦县 | 140100 |
| 140181 | 古交市 | 140100 |
| 140202 | 平城区 | 140200 |
| 140203 | 矿区 | 140200 |
| 140211 | 南郊区 | 140200 |
| 140212 | 新荣区 | 140200 |
| 140221 | 阳高县 | 140200 |
| 140222 | 天镇县 | 140200 |
| 140223 | 广灵县 | 140200 |
| 140224 | 灵丘县 | 140200 |
| 140225 | 浑源县 | 140200 |
| 140226 | 左云县 | 140200 |
| 140227 | 云州区 | 140200 |
| 140302 | 城区 | 140300 |
| 140303 | 矿区 | 140300 |
| 140311 | 郊区 | 140300 |
| 140321 | 平定县 | 140300 |
| 140322 | 盂县 | 140300 |
| 140402 | 城区 | 140400 |
| 140411 | 郊区 | 140400 |
| 140421 | 上党区 | 140400 |
| 140423 | 襄垣县 | 140400 |
| 140424 | 屯留区 | 140400 |
| 140425 | 平顺县 | 140400 |
| 140426 | 黎城县 | 140400 |
| 140427 | 壶关县 | 140400 |
| 140428 | 长子县 | 140400 |
| 140429 | 武乡县 | 140400 |
| 140430 | 沁县 | 140400 |
| 140431 | 沁源县 | 140400 |
| 140481 | 潞城区 | 140400 |
| 140502 | 城区 | 140500 |
| 140521 | 沁水县 | 140500 |
| 140522 | 阳城县 | 140500 |
| 140524 | 陵川县 | 140500 |
| 140525 | 泽州县 | 140500 |
| 140581 | 高平市 | 140500 |
| 140602 | 朔城区 | 140600 |
| 140603 | 平鲁区 | 140600 |
| 140621 | 山阴县 | 140600 |
| 140622 | 应县 | 140600 |
| 140623 | 右玉县 | 140600 |
| 140624 | 怀仁市 | 140600 |
| 140702 | 榆次区 | 140700 |
| 140721 | 榆社县 | 140700 |
| 140722 | 左权县 | 140700 |
| 140723 | 和顺县 | 140700 |
| 140724 | 昔阳县 | 140700 |
| 140725 | 寿阳县 | 140700 |
| 140726 | 太谷区 | 140700 |
| 140727 | 祁县 | 140700 |
| 140728 | 平遥县 | 140700 |
| 140729 | 灵石县 | 140700 |
| 140781 | 介休市 | 140700 |
| 140802 | 盐湖区 | 140800 |
| 140821 | 临猗县 | 140800 |
| 140822 | 万荣县 | 140800 |
| 140823 | 闻喜县 | 140800 |
| 140824 | 稷山县 | 140800 |
| 140825 | 新绛县 | 140800 |
| 140826 | 绛县 | 140800 |
| 140827 | 垣曲县 | 140800 |
| 140828 | 夏县 | 140800 |
| 140829 | 平陆县 | 140800 |
| 140830 | 芮城县 | 140800 |
| 140881 | 永济市 | 140800 |
| 140882 | 河津市 | 140800 |
| 140902 | 忻府区 | 140900 |
| 140921 | 定襄县 | 140900 |
| 140922 | 五台县 | 140900 |
| 140923 | 代县 | 140900 |
| 140924 | 繁峙县 | 140900 |
| 140925 | 宁武县 | 140900 |
| 140926 | 静乐县 | 140900 |
| 140927 | 神池县 | 140900 |
| 140928 | 五寨县 | 140900 |
| 140929 | 岢岚县 | 140900 |
| 140930 | 河曲县 | 140900 |
| 140931 | 保德县 | 140900 |
| 140932 | 偏关县 | 140900 |
| 140981 | 原平市 | 140900 |
| 141002 | 尧都区 | 141000 |
| 141021 | 曲沃县 | 141000 |
| 141022 | 翼城县 | 141000 |
| 141023 | 襄汾县 | 141000 |
| 141024 | 洪洞县 | 141000 |
| 141025 | 古县 | 141000 |
| 141026 | 安泽县 | 141000 |
| 141027 | 浮山县 | 141000 |
| 141028 | 吉县 | 141000 |
| 141029 | 乡宁县 | 141000 |
| 141030 | 大宁县 | 141000 |
| 141031 | 隰县 | 141000 |
| 141032 | 永和县 | 141000 |
| 141033 | 蒲县 | 141000 |
| 141034 | 汾西县 | 141000 |
| 141081 | 侯马市 | 141000 |
| 141082 | 霍州市 | 141000 |
| 141102 | 离石区 | 141100 |
| 141121 | 文水县 | 141100 |
| 141122 | 交城县 | 141100 |
| 141123 | 兴县 | 141100 |
| 141124 | 临县 | 141100 |
| 141125 | 柳林县 | 141100 |
| 141126 | 石楼县 | 141100 |
| 141127 | 岚县 | 141100 |
| 141128 | 方山县 | 141100 |
| 141129 | 中阳县 | 141100 |
| 141130 | 交口县 | 141100 |
| 141181 | 孝义市 | 141100 |
| 141182 | 汾阳市 | 141100 |
| 150102 | 新城区 | 150100 |
| 150103 | 回民区 | 150100 |
| 150104 | 玉泉区 | 150100 |
| 150105 | 赛罕区 | 150100 |
| 150121 | 土默特左旗 | 150100 |
| 150122 | 托克托县 | 150100 |
| 150123 | 和林格尔县 | 150100 |
| 150124 | 清水河县 | 150100 |
| 150125 | 武川县 | 150100 |
| 150202 | 东河区 | 150200 |
| 150203 | 昆都仑区 | 150200 |
| 150204 | 青山区 | 150200 |
| 150205 | 石拐区 | 150200 |
| 150206 | 白云鄂博矿区 | 150200 |
| 150207 | 九原区 | 150200 |
| 150221 | 土默特右旗 | 150200 |
| 150222 | 固阳县 | 150200 |
| 150223 | 达尔罕茂明安联合旗 | 150200 |
| 150302 | 海勃湾区 | 150300 |
| 150303 | 海南区 | 150300 |
| 150304 | 乌达区 | 150300 |
| 150402 | 红山区 | 150400 |
| 150403 | 元宝山区 | 150400 |
| 150404 | 松山区 | 150400 |
| 150421 | 阿鲁科尔沁旗 | 150400 |
| 150422 | 巴林左旗 | 150400 |
| 150423 | 巴林右旗 | 150400 |
| 150424 | 林西县 | 150400 |
| 150425 | 克什克腾旗 | 150400 |
| 150426 | 翁牛特旗 | 150400 |
| 150428 | 喀喇沁旗 | 150400 |
| 150429 | 宁城县 | 150400 |
| 150430 | 敖汉旗 | 150400 |
| 150502 | 科尔沁区 | 150500 |
| 150521 | 科尔沁左翼中旗 | 150500 |
| 150522 | 科尔沁左翼后旗 | 150500 |
| 150523 | 开鲁县 | 150500 |
| 150524 | 库伦旗 | 150500 |
| 150525 | 奈曼旗 | 150500 |
| 150526 | 扎鲁特旗 | 150500 |
| 150581 | 霍林郭勒市 | 150500 |
| 150602 | 东胜区 | 150600 |
| 150603 | 康巴什区 | 150600 |
| 150621 | 达拉特旗 | 150600 |
| 150622 | 准格尔旗 | 150600 |
| 150623 | 鄂托克前旗 | 150600 |
| 150624 | 鄂托克旗 | 150600 |
| 150625 | 杭锦旗 | 150600 |
| 150626 | 乌审旗 | 150600 |
| 150627 | 伊金霍洛旗 | 150600 |
| 150702 | 海拉尔区 | 150700 |
| 150703 | 扎赉诺尔区 | 150700 |
| 150721 | 阿荣旗 | 150700 |
| 150722 | 莫力达瓦达斡尔族自治旗 | 150700 |
| 150723 | 鄂伦春自治旗 | 150700 |
| 150724 | 鄂温克族自治旗 | 150700 |
| 150725 | 陈巴尔虎旗 | 150700 |
| 150726 | 新巴尔虎左旗 | 150700 |
| 150727 | 新巴尔虎右旗 | 150700 |
| 150781 | 满洲里市 | 150700 |
| 150782 | 牙克石市 | 150700 |
| 150783 | 扎兰屯市 | 150700 |
| 150784 | 额尔古纳市 | 150700 |
| 150785 | 根河市 | 150700 |
| 150802 | 临河区 | 150800 |
| 150821 | 五原县 | 150800 |
| 150822 | 磴口县 | 150800 |
| 150823 | 乌拉特前旗 | 150800 |
| 150824 | 乌拉特中旗 | 150800 |
| 150825 | 乌拉特后旗 | 150800 |
| 150826 | 杭锦后旗 | 150800 |
| 150902 | 集宁区 | 150900 |
| 150921 | 卓资县 | 150900 |
| 150922 | 化德县 | 150900 |
| 150923 | 商都县 | 150900 |
| 150924 | 兴和县 | 150900 |
| 150925 | 凉城县 | 150900 |
| 150926 | 察哈尔右翼前旗 | 150900 |
| 150927 | 察哈尔右翼中旗 | 150900 |
| 150928 | 察哈尔右翼后旗 | 150900 |
| 150929 | 四子王旗 | 150900 |
| 150981 | 丰镇市 | 150900 |
| 152201 | 乌兰浩特市 | 152200 |
| 152202 | 阿尔山市 | 152200 |
| 152221 | 科尔沁右翼前旗 | 152200 |
| 152222 | 科尔沁右翼中旗 | 152200 |
| 152223 | 扎赉特旗 | 152200 |
| 152224 | 突泉县 | 152200 |
| 152501 | 二连浩特市 | 152500 |
| 152502 | 锡林浩特市 | 152500 |
| 152522 | 阿巴嘎旗 | 152500 |
| 152523 | 苏尼特左旗 | 152500 |
| 152524 | 苏尼特右旗 | 152500 |
| 152525 | 东乌珠穆沁旗 | 152500 |
| 152526 | 西乌珠穆沁旗 | 152500 |
| 152527 | 太仆寺旗 | 152500 |
| 152528 | 镶黄旗 | 152500 |
| 152529 | 正镶白旗 | 152500 |
| 152530 | 正蓝旗 | 152500 |
| 152531 | 多伦县 | 152500 |
| 152921 | 阿拉善左旗 | 152900 |
| 152922 | 阿拉善右旗 | 152900 |
| 152923 | 额济纳旗 | 152900 |
| 210102 | 和平区 | 210100 |
| 210103 | 沈河区 | 210100 |
| 210104 | 大东区 | 210100 |
| 210105 | 皇姑区 | 210100 |
| 210106 | 铁西区 | 210100 |
| 210111 | 苏家屯区 | 210100 |
| 210112 | 浑南区 | 210100 |
| 210113 | 沈北新区 | 210100 |
| 210114 | 于洪区 | 210100 |
| 210115 | 辽中区 | 210100 |
| 210123 | 康平县 | 210100 |
| 210124 | 法库县 | 210100 |
| 210181 | 新民市 | 210100 |
| 210202 | 中山区 | 210200 |
| 210203 | 西岗区 | 210200 |
| 210204 | 沙河口区 | 210200 |
| 210211 | 甘井子区 | 210200 |
| 210212 | 旅顺口区 | 210200 |
| 210213 | 金州区 | 210200 |
| 210214 | 普兰店区 | 210200 |
| 210224 | 长海县 | 210200 |
| 210281 | 瓦房店市 | 210200 |
| 210283 | 庄河市 | 210200 |
| 210302 | 铁东区 | 210300 |
| 210303 | 铁西区 | 210300 |
| 210304 | 立山区 | 210300 |
| 210311 | 千山区 | 210300 |
| 210321 | 台安县 | 210300 |
| 210323 | 岫岩满族自治县 | 210300 |
| 210381 | 海城市 | 210300 |
| 210402 | 新抚区 | 210400 |
| 210403 | 东洲区 | 210400 |
| 210404 | 望花区 | 210400 |
| 210411 | 顺城区 | 210400 |
| 210421 | 抚顺县 | 210400 |
| 210422 | 新宾满族自治县 | 210400 |
| 210423 | 清原满族自治县 | 210400 |
| 210502 | 平山区 | 210500 |
| 210503 | 溪湖区 | 210500 |
| 210504 | 明山区 | 210500 |
| 210505 | 南芬区 | 210500 |
| 210521 | 本溪满族自治县 | 210500 |
| 210522 | 桓仁满族自治县 | 210500 |
| 210602 | 元宝区 | 210600 |
| 210603 | 振兴区 | 210600 |
| 210604 | 振安区 | 210600 |
| 210624 | 宽甸满族自治县 | 210600 |
| 210681 | 东港市 | 210600 |
| 210682 | 凤城市 | 210600 |
| 210702 | 古塔区 | 210700 |
| 210703 | 凌河区 | 210700 |
| 210711 | 太和区 | 210700 |
| 210726 | 黑山县 | 210700 |
| 210727 | 义县 | 210700 |
| 210781 | 凌海市 | 210700 |
| 210782 | 北镇市 | 210700 |
| 210802 | 站前区 | 210800 |
| 210803 | 西市区 | 210800 |
| 210804 | 鲅鱼圈区 | 210800 |
| 210811 | 老边区 | 210800 |
| 210881 | 盖州市 | 210800 |
| 210882 | 大石桥市 | 210800 |
| 210902 | 海州区 | 210900 |
| 210903 | 新邱区 | 210900 |
| 210904 | 太平区 | 210900 |
| 210905 | 清河门区 | 210900 |
| 210911 | 细河区 | 210900 |
| 210921 | 阜新蒙古族自治县 | 210900 |
| 210922 | 彰武县 | 210900 |
| 211002 | 白塔区 | 211000 |
| 211003 | 文圣区 | 211000 |
| 211004 | 宏伟区 | 211000 |
| 211005 | 弓长岭区 | 211000 |
| 211011 | 太子河区 | 211000 |
| 211021 | 辽阳县 | 211000 |
| 211081 | 灯塔市 | 211000 |
| 211102 | 双台子区 | 211100 |
| 211103 | 兴隆台区 | 211100 |
| 211104 | 大洼区 | 211100 |
| 211122 | 盘山县 | 211100 |
| 211202 | 银州区 | 211200 |
| 211204 | 清河区 | 211200 |
| 211221 | 铁岭县 | 211200 |
| 211223 | 西丰县 | 211200 |
| 211224 | 昌图县 | 211200 |
| 211281 | 调兵山市 | 211200 |
| 211282 | 开原市 | 211200 |
| 211302 | 双塔区 | 211300 |
| 211303 | 龙城区 | 211300 |
| 211321 | 朝阳县 | 211300 |
| 211322 | 建平县 | 211300 |
| 211324 | 喀喇沁左翼蒙古族自治县 | 211300 |
| 211381 | 北票市 | 211300 |
| 211382 | 凌源市 | 211300 |
| 211402 | 连山区 | 211400 |
| 211403 | 龙港区 | 211400 |
| 211404 | 南票区 | 211400 |
| 211421 | 绥中县 | 211400 |
| 211422 | 建昌县 | 211400 |
| 211481 | 兴城市 | 211400 |
| 220102 | 南关区 | 220100 |
| 220103 | 宽城区 | 220100 |
| 220104 | 朝阳区 | 220100 |
| 220105 | 二道区 | 220100 |
| 220106 | 绿园区 | 220100 |
| 220112 | 双阳区 | 220100 |
| 220113 | 九台区 | 220100 |
| 220122 | 农安县 | 220100 |
| 220182 | 榆树市 | 220100 |
| 220183 | 德惠市 | 220100 |
| 220202 | 昌邑区 | 220200 |
| 220203 | 龙潭区 | 220200 |
| 220204 | 船营区 | 220200 |
| 220211 | 丰满区 | 220200 |
| 220221 | 永吉县 | 220200 |
| 220281 | 蛟河市 | 220200 |
| 220282 | 桦甸市 | 220200 |
| 220283 | 舒兰市 | 220200 |
| 220284 | 磐石市 | 220200 |
| 220302 | 铁西区 | 220300 |
| 220303 | 铁东区 | 220300 |
| 220322 | 梨树县 | 220300 |
| 220323 | 伊通满族自治县 | 220300 |
| 220381 | 公主岭市 | 220300 |
| 220382 | 双辽市 | 220300 |
| 220402 | 龙山区 | 220400 |
| 220403 | 西安区 | 220400 |
| 220421 | 东丰县 | 220400 |
| 220422 | 东辽县 | 220400 |
| 220502 | 东昌区 | 220500 |
| 220503 | 二道江区 | 220500 |
| 220521 | 通化县 | 220500 |
| 220523 | 辉南县 | 220500 |
| 220524 | 柳河县 | 220500 |
| 220581 | 梅河口市 | 220500 |
| 220582 | 集安市 | 220500 |
| 220602 | 浑江区 | 220600 |
| 220605 | 江源区 | 220600 |
| 220621 | 抚松县 | 220600 |
| 220622 | 靖宇县 | 220600 |
| 220623 | 长白朝鲜族自治县 | 220600 |
| 220681 | 临江市 | 220600 |
| 220702 | 宁江区 | 220700 |
| 220721 | 前郭尔罗斯蒙古族自治县 | 220700 |
| 220722 | 长岭县 | 220700 |
| 220723 | 乾安县 | 220700 |
| 220781 | 扶余市 | 220700 |
| 220802 | 洮北区 | 220800 |
| 220821 | 镇赉县 | 220800 |
| 220822 | 通榆县 | 220800 |
| 220881 | 洮南市 | 220800 |
| 220882 | 大安市 | 220800 |
| 222401 | 延吉市 | 222400 |
| 222402 | 图们市 | 222400 |
| 222403 | 敦化市 | 222400 |
| 222404 | 珲春市 | 222400 |
| 222405 | 龙井市 | 222400 |
| 222406 | 和龙市 | 222400 |
| 222424 | 汪清县 | 222400 |
| 222426 | 安图县 | 222400 |
| 230102 | 道里区 | 230100 |
| 230103 | 南岗区 | 230100 |
| 230104 | 道外区 | 230100 |
| 230108 | 平房区 | 230100 |
| 230109 | 松北区 | 230100 |
| 230110 | 香坊区 | 230100 |
| 230111 | 呼兰区 | 230100 |
| 230112 | 阿城区 | 230100 |
| 230113 | 双城区 | 230100 |
| 230123 | 依兰县 | 230100 |
| 230124 | 方正县 | 230100 |
| 230125 | 宾县 | 230100 |
| 230126 | 巴彦县 | 230100 |
| 230127 | 木兰县 | 230100 |
| 230128 | 通河县 | 230100 |
| 230129 | 延寿县 | 230100 |
| 230183 | 尚志市 | 230100 |
| 230184 | 五常市 | 230100 |
| 230202 | 龙沙区 | 230200 |
| 230203 | 建华区 | 230200 |
| 230204 | 铁锋区 | 230200 |
| 230205 | 昂昂溪区 | 230200 |
| 230206 | 富拉尔基区 | 230200 |
| 230207 | 碾子山区 | 230200 |
| 230208 | 梅里斯达斡尔族区 | 230200 |
| 230221 | 龙江县 | 230200 |
| 230223 | 依安县 | 230200 |
| 230224 | 泰来县 | 230200 |
| 230225 | 甘南县 | 230200 |
| 230227 | 富裕县 | 230200 |
| 230229 | 克山县 | 230200 |
| 230230 | 克东县 | 230200 |
| 230231 | 拜泉县 | 230200 |
| 230281 | 讷河市 | 230200 |
| 230302 | 鸡冠区 | 230300 |
| 230303 | 恒山区 | 230300 |
| 230304 | 滴道区 | 230300 |
| 230305 | 梨树区 | 230300 |
| 230306 | 城子河区 | 230300 |
| 230307 | 麻山区 | 230300 |
| 230321 | 鸡东县 | 230300 |
| 230381 | 虎林市 | 230300 |
| 230382 | 密山市 | 230300 |
| 230402 | 向阳区 | 230400 |
| 230403 | 工农区 | 230400 |
| 230404 | 南山区 | 230400 |
| 230405 | 兴安区 | 230400 |
| 230406 | 东山区 | 230400 |
| 230407 | 兴山区 | 230400 |
| 230421 | 萝北县 | 230400 |
| 230422 | 绥滨县 | 230400 |
| 230502 | 尖山区 | 230500 |
| 230503 | 岭东区 | 230500 |
| 230505 | 四方台区 | 230500 |
| 230506 | 宝山区 | 230500 |
| 230521 | 集贤县 | 230500 |
| 230522 | 友谊县 | 230500 |
| 230523 | 宝清县 | 230500 |
| 230524 | 饶河县 | 230500 |
| 230602 | 萨尔图区 | 230600 |
| 230603 | 龙凤区 | 230600 |
| 230604 | 让胡路区 | 230600 |
| 230605 | 红岗区 | 230600 |
| 230606 | 大同区 | 230600 |
| 230621 | 肇州县 | 230600 |
| 230622 | 肇源县 | 230600 |
| 230623 | 林甸县 | 230600 |
| 230624 | 杜尔伯特蒙古族自治县 | 230600 |
| 230702 | 伊春区 | 230700 |
| 230703 | 南岔县 | 230700 |
| 230704 | 友好区 | 230700 |
| 230705 | 西林区 | 230700 |
| 230706 | 翠峦区 | 230700 |
| 230707 | 新青区 | 230700 |
| 230708 | 美溪区 | 230700 |
| 230709 | 金山屯区 | 230700 |
| 230710 | 五营区 | 230700 |
| 230711 | 乌马河区 | 230700 |
| 230712 | 汤旺河区 | 230700 |
| 230713 | 带岭区 | 230700 |
| 230714 | 乌伊岭区 | 230700 |
| 230715 | 红星区 | 230700 |
| 230716 | 上甘岭区 | 230700 |
| 230722 | 嘉荫县 | 230700 |
| 230781 | 铁力市 | 230700 |
| 230803 | 向阳区 | 230800 |
| 230804 | 前进区 | 230800 |
| 230805 | 东风区 | 230800 |
| 230811 | 郊区 | 230800 |
| 230822 | 桦南县 | 230800 |
| 230826 | 桦川县 | 230800 |
| 230828 | 汤原县 | 230800 |
| 230881 | 同江市 | 230800 |
| 230882 | 富锦市 | 230800 |
| 230883 | 抚远市 | 230800 |
| 230902 | 新兴区 | 230900 |
| 230903 | 桃山区 | 230900 |
| 230904 | 茄子河区 | 230900 |
| 230921 | 勃利县 | 230900 |
| 231002 | 东安区 | 231000 |
| 231003 | 阳明区 | 231000 |
| 231004 | 爱民区 | 231000 |
| 231005 | 西安区 | 231000 |
| 231025 | 林口县 | 231000 |
| 231081 | 绥芬河市 | 231000 |
| 231083 | 海林市 | 231000 |
| 231084 | 宁安市 | 231000 |
| 231085 | 穆棱市 | 231000 |
| 231086 | 东宁市 | 231000 |
| 231102 | 爱辉区 | 231100 |
| 231121 | 嫩江市 | 231100 |
| 231123 | 逊克县 | 231100 |
| 231124 | 孙吴县 | 231100 |
| 231181 | 北安市 | 231100 |
| 231182 | 五大连池市 | 231100 |
| 231202 | 北林区 | 231200 |
| 231221 | 望奎县 | 231200 |
| 231222 | 兰西县 | 231200 |
| 231223 | 青冈县 | 231200 |
| 231224 | 庆安县 | 231200 |
| 231225 | 明水县 | 231200 |
| 231226 | 绥棱县 | 231200 |
| 231281 | 安达市 | 231200 |
| 231282 | 肇东市 | 231200 |
| 231283 | 海伦市 | 231200 |
| 232721 | 呼玛县 | 232700 |
| 232722 | 塔河县 | 232700 |
| 232723 | 漠河市 | 232700 |
| 310101 | 黄浦区 | 310000 |
| 310104 | 徐汇区 | 310000 |
| 310105 | 长宁区 | 310000 |
| 310106 | 静安区 | 310000 |
| 310107 | 普陀区 | 310000 |
| 310109 | 虹口区 | 310000 |
| 310110 | 杨浦区 | 310000 |
| 310112 | 闵行区 | 310000 |
| 310113 | 宝山区 | 310000 |
| 310114 | 嘉定区 | 310000 |
| 310115 | 浦东新区 | 310000 |
| 310116 | 金山区 | 310000 |
| 310117 | 松江区 | 310000 |
| 310118 | 青浦区 | 310000 |
| 310120 | 奉贤区 | 310000 |
| 310151 | 崇明区 | 310000 |
| 320102 | 玄武区 | 320100 |
| 320104 | 秦淮区 | 320100 |
| 320105 | 建邺区 | 320100 |
| 320106 | 鼓楼区 | 320100 |
| 320111 | 浦口区 | 320100 |
| 320113 | 栖霞区 | 320100 |
| 320114 | 雨花台区 | 320100 |
| 320115 | 江宁区 | 320100 |
| 320116 | 六合区 | 320100 |
| 320117 | 溧水区 | 320100 |
| 320118 | 高淳区 | 320100 |
| 320205 | 锡山区 | 320200 |
| 320206 | 惠山区 | 320200 |
| 320211 | 滨湖区 | 320200 |
| 320213 | 梁溪区 | 320200 |
| 320214 | 新吴区 | 320200 |
| 320281 | 江阴市 | 320200 |
| 320282 | 宜兴市 | 320200 |
| 320302 | 鼓楼区 | 320300 |
| 320303 | 云龙区 | 320300 |
| 320305 | 贾汪区 | 320300 |
| 320311 | 泉山区 | 320300 |
| 320312 | 铜山区 | 320300 |
| 320321 | 丰县 | 320300 |
| 320322 | 沛县 | 320300 |
| 320324 | 睢宁县 | 320300 |
| 320381 | 新沂市 | 320300 |
| 320382 | 邳州市 | 320300 |
| 320402 | 天宁区 | 320400 |
| 320404 | 钟楼区 | 320400 |
| 320411 | 新北区 | 320400 |
| 320412 | 武进区 | 320400 |
| 320413 | 金坛区 | 320400 |
| 320481 | 溧阳市 | 320400 |
| 320505 | 虎丘区 | 320500 |
| 320506 | 吴中区 | 320500 |
| 320507 | 相城区 | 320500 |
| 320508 | 姑苏区 | 320500 |
| 320509 | 吴江区 | 320500 |
| 320581 | 常熟市 | 320500 |
| 320582 | 张家港市 | 320500 |
| 320583 | 昆山市 | 320500 |
| 320585 | 太仓市 | 320500 |
| 320602 | 崇川区 | 320600 |
| 320611 | 港闸区 | 320600 |
| 320612 | 通州区 | 320600 |
| 320621 | 海安市 | 320600 |
| 320623 | 如东县 | 320600 |
| 320681 | 启东市 | 320600 |
| 320682 | 如皋市 | 320600 |
| 320684 | 海门市 | 320600 |
| 320703 | 连云区 | 320700 |
| 320706 | 海州区 | 320700 |
| 320707 | 赣榆区 | 320700 |
| 320722 | 东海县 | 320700 |
| 320723 | 灌云县 | 320700 |
| 320724 | 灌南县 | 320700 |
| 320803 | 淮安区 | 320800 |
| 320804 | 淮阴区 | 320800 |
| 320812 | 清江浦区 | 320800 |
| 320813 | 洪泽区 | 320800 |
| 320826 | 涟水县 | 320800 |
| 320830 | 盱眙县 | 320800 |
| 320831 | 金湖县 | 320800 |
| 320902 | 亭湖区 | 320900 |
| 320903 | 盐都区 | 320900 |
| 320904 | 大丰区 | 320900 |
| 320921 | 响水县 | 320900 |
| 320922 | 滨海县 | 320900 |
| 320923 | 阜宁县 | 320900 |
| 320924 | 射阳县 | 320900 |
| 320925 | 建湖县 | 320900 |
| 320981 | 东台市 | 320900 |
| 321002 | 广陵区 | 321000 |
| 321003 | 邗江区 | 321000 |
| 321012 | 江都区 | 321000 |
| 321023 | 宝应县 | 321000 |
| 321081 | 仪征市 | 321000 |
| 321084 | 高邮市 | 321000 |
| 321102 | 京口区 | 321100 |
| 321111 | 润州区 | 321100 |
| 321112 | 丹徒区 | 321100 |
| 321181 | 丹阳市 | 321100 |
| 321182 | 扬中市 | 321100 |
| 321183 | 句容市 | 321100 |
| 321202 | 海陵区 | 321200 |
| 321203 | 高港区 | 321200 |
| 321204 | 姜堰区 | 321200 |
| 321281 | 兴化市 | 321200 |
| 321282 | 靖江市 | 321200 |
| 321283 | 泰兴市 | 321200 |
| 321302 | 宿城区 | 321300 |
| 321311 | 宿豫区 | 321300 |
| 321322 | 沭阳县 | 321300 |
| 321323 | 泗阳县 | 321300 |
| 321324 | 泗洪县 | 321300 |
| 330102 | 上城区 | 330100 |
| 330103 | 下城区 | 330100 |
| 330104 | 江干区 | 330100 |
| 330105 | 拱墅区 | 330100 |
| 330106 | 西湖区 | 330100 |
| 330108 | 滨江区 | 330100 |
| 330109 | 萧山区 | 330100 |
| 330110 | 余杭区 | 330100 |
| 330111 | 富阳区 | 330100 |
| 330112 | 临安区 | 330100 |
| 330122 | 桐庐县 | 330100 |
| 330127 | 淳安县 | 330100 |
| 330182 | 建德市 | 330100 |
| 330203 | 海曙区 | 330200 |
| 330205 | 江北区 | 330200 |
| 330206 | 北仑区 | 330200 |
| 330211 | 镇海区 | 330200 |
| 330212 | 鄞州区 | 330200 |
| 330213 | 奉化区 | 330200 |
| 330225 | 象山县 | 330200 |
| 330226 | 宁海县 | 330200 |
| 330281 | 余姚市 | 330200 |
| 330282 | 慈溪市 | 330200 |
| 330302 | 鹿城区 | 330300 |
| 330303 | 龙湾区 | 330300 |
| 330304 | 瓯海区 | 330300 |
| 330305 | 洞头区 | 330300 |
| 330324 | 永嘉县 | 330300 |
| 330326 | 平阳县 | 330300 |
| 330327 | 苍南县 | 330300 |
| 330328 | 文成县 | 330300 |
| 330329 | 泰顺县 | 330300 |
| 330381 | 瑞安市 | 330300 |
| 330382 | 乐清市 | 330300 |
| 330402 | 南湖区 | 330400 |
| 330411 | 秀洲区 | 330400 |
| 330421 | 嘉善县 | 330400 |
| 330424 | 海盐县 | 330400 |
| 330481 | 海宁市 | 330400 |
| 330482 | 平湖市 | 330400 |
| 330483 | 桐乡市 | 330400 |
| 330502 | 吴兴区 | 330500 |
| 330503 | 南浔区 | 330500 |
| 330521 | 德清县 | 330500 |
| 330522 | 长兴县 | 330500 |
| 330523 | 安吉县 | 330500 |
| 330602 | 越城区 | 330600 |
| 330603 | 柯桥区 | 330600 |
| 330604 | 上虞区 | 330600 |
| 330624 | 新昌县 | 330600 |
| 330681 | 诸暨市 | 330600 |
| 330683 | 嵊州市 | 330600 |
| 330702 | 婺城区 | 330700 |
| 330703 | 金东区 | 330700 |
| 330723 | 武义县 | 330700 |
| 330726 | 浦江县 | 330700 |
| 330727 | 磐安县 | 330700 |
| 330781 | 兰溪市 | 330700 |
| 330782 | 义乌市 | 330700 |
| 330783 | 东阳市 | 330700 |
| 330784 | 永康市 | 330700 |
| 330802 | 柯城区 | 330800 |
| 330803 | 衢江区 | 330800 |
| 330822 | 常山县 | 330800 |
| 330824 | 开化县 | 330800 |
| 330825 | 龙游县 | 330800 |
| 330881 | 江山市 | 330800 |
| 330902 | 定海区 | 330900 |
| 330903 | 普陀区 | 330900 |
| 330921 | 岱山县 | 330900 |
| 330922 | 嵊泗县 | 330900 |
| 331002 | 椒江区 | 331000 |
| 331003 | 黄岩区 | 331000 |
| 331004 | 路桥区 | 331000 |
| 331022 | 三门县 | 331000 |
| 331023 | 天台县 | 331000 |
| 331024 | 仙居县 | 331000 |
| 331081 | 温岭市 | 331000 |
| 331082 | 临海市 | 331000 |
| 331083 | 玉环市 | 331000 |
| 331102 | 莲都区 | 331100 |
| 331121 | 青田县 | 331100 |
| 331122 | 缙云县 | 331100 |
| 331123 | 遂昌县 | 331100 |
| 331124 | 松阳县 | 331100 |
| 331125 | 云和县 | 331100 |
| 331126 | 庆元县 | 331100 |
| 331127 | 景宁畲族自治县 | 331100 |
| 331181 | 龙泉市 | 331100 |
| 340102 | 瑶海区 | 340100 |
| 340103 | 庐阳区 | 340100 |
| 340104 | 蜀山区 | 340100 |
| 340111 | 包河区 | 340100 |
| 340121 | 长丰县 | 340100 |
| 340122 | 肥东县 | 340100 |
| 340123 | 肥西县 | 340100 |
| 340124 | 庐江县 | 340100 |
| 340181 | 巢湖市 | 340100 |
| 340202 | 镜湖区 | 340200 |
| 340203 | 弋江区 | 340200 |
| 340207 | 鸠江区 | 340200 |
| 340208 | 三山区 | 340200 |
| 340221 | 芜湖县 | 340200 |
| 340222 | 繁昌县 | 340200 |
| 340223 | 南陵县 | 340200 |
| 340225 | 无为市 | 340200 |
| 340302 | 龙子湖区 | 340300 |
| 340303 | 蚌山区 | 340300 |
| 340304 | 禹会区 | 340300 |
| 340311 | 淮上区 | 340300 |
| 340321 | 怀远县 | 340300 |
| 340322 | 五河县 | 340300 |
| 340323 | 固镇县 | 340300 |
| 340402 | 大通区 | 340400 |
| 340403 | 田家庵区 | 340400 |
| 340404 | 谢家集区 | 340400 |
| 340405 | 八公山区 | 340400 |
| 340406 | 潘集区 | 340400 |
| 340421 | 凤台县 | 340400 |
| 340422 | 寿县 | 340400 |
| 340503 | 花山区 | 340500 |
| 340504 | 雨山区 | 340500 |
| 340506 | 博望区 | 340500 |
| 340521 | 当涂县 | 340500 |
| 340522 | 含山县 | 340500 |
| 340523 | 和县 | 340500 |
| 340602 | 杜集区 | 340600 |
| 340603 | 相山区 | 340600 |
| 340604 | 烈山区 | 340600 |
| 340621 | 濉溪县 | 340600 |
| 340705 | 铜官区 | 340700 |
| 340706 | 义安区 | 340700 |
| 340711 | 郊区 | 340700 |
| 340722 | 枞阳县 | 340700 |
| 340802 | 迎江区 | 340800 |
| 340803 | 大观区 | 340800 |
| 340811 | 宜秀区 | 340800 |
| 340822 | 怀宁县 | 340800 |
| 340824 | 潜山市 | 340800 |
| 340825 | 太湖县 | 340800 |
| 340826 | 宿松县 | 340800 |
| 340827 | 望江县 | 340800 |
| 340828 | 岳西县 | 340800 |
| 340881 | 桐城市 | 340800 |
| 341002 | 屯溪区 | 341000 |
| 341003 | 黄山区 | 341000 |
| 341004 | 徽州区 | 341000 |
| 341021 | 歙县 | 341000 |
| 341022 | 休宁县 | 341000 |
| 341023 | 黟县 | 341000 |
| 341024 | 祁门县 | 341000 |
| 341102 | 琅琊区 | 341100 |
| 341103 | 南谯区 | 341100 |
| 341122 | 来安县 | 341100 |
| 341124 | 全椒县 | 341100 |
| 341125 | 定远县 | 341100 |
| 341126 | 凤阳县 | 341100 |
| 341181 | 天长市 | 341100 |
| 341182 | 明光市 | 341100 |
| 341202 | 颍州区 | 341200 |
| 341203 | 颍东区 | 341200 |
| 341204 | 颍泉区 | 341200 |
| 341221 | 临泉县 | 341200 |
| 341222 | 太和县 | 341200 |
| 341225 | 阜南县 | 341200 |
| 341226 | 颍上县 | 341200 |
| 341282 | 界首市 | 341200 |
| 341302 | 埇桥区 | 341300 |
| 341321 | 砀山县 | 341300 |
| 341322 | 萧县 | 341300 |
| 341323 | 灵璧县 | 341300 |
| 341324 | 泗县 | 341300 |
| 341502 | 金安区 | 341500 |
| 341503 | 裕安区 | 341500 |
| 341504 | 叶集区 | 341500 |
| 341522 | 霍邱县 | 341500 |
| 341523 | 舒城县 | 341500 |
| 341524 | 金寨县 | 341500 |
| 341525 | 霍山县 | 341500 |
| 341602 | 谯城区 | 341600 |
| 341621 | 涡阳县 | 341600 |
| 341622 | 蒙城县 | 341600 |
| 341623 | 利辛县 | 341600 |
| 341702 | 贵池区 | 341700 |
| 341721 | 东至县 | 341700 |
| 341722 | 石台县 | 341700 |
| 341723 | 青阳县 | 341700 |
| 341802 | 宣州区 | 341800 |
| 341821 | 郎溪县 | 341800 |
| 341822 | 广德市 | 341800 |
| 341823 | 泾县 | 341800 |
| 341824 | 绩溪县 | 341800 |
| 341825 | 旌德县 | 341800 |
| 341881 | 宁国市 | 341800 |
| 350102 | 鼓楼区 | 350100 |
| 350103 | 台江区 | 350100 |
| 350104 | 仓山区 | 350100 |
| 350105 | 马尾区 | 350100 |
| 350111 | 晋安区 | 350100 |
| 350112 | 长乐区 | 350100 |
| 350121 | 闽侯县 | 350100 |
| 350122 | 连江县 | 350100 |
| 350123 | 罗源县 | 350100 |
| 350124 | 闽清县 | 350100 |
| 350125 | 永泰县 | 350100 |
| 350128 | 平潭县 | 350100 |
| 350181 | 福清市 | 350100 |
| 350203 | 思明区 | 350200 |
| 350205 | 海沧区 | 350200 |
| 350206 | 湖里区 | 350200 |
| 350211 | 集美区 | 350200 |
| 350212 | 同安区 | 350200 |
| 350213 | 翔安区 | 350200 |
| 350302 | 城厢区 | 350300 |
| 350303 | 涵江区 | 350300 |
| 350304 | 荔城区 | 350300 |
| 350305 | 秀屿区 | 350300 |
| 350322 | 仙游县 | 350300 |
| 350402 | 梅列区 | 350400 |
| 350403 | 三元区 | 350400 |
| 350421 | 明溪县 | 350400 |
| 350423 | 清流县 | 350400 |
| 350424 | 宁化县 | 350400 |
| 350425 | 大田县 | 350400 |
| 350426 | 尤溪县 | 350400 |
| 350427 | 沙县 | 350400 |
| 350428 | 将乐县 | 350400 |
| 350429 | 泰宁县 | 350400 |
| 350430 | 建宁县 | 350400 |
| 350481 | 永安市 | 350400 |
| 350502 | 鲤城区 | 350500 |
| 350503 | 丰泽区 | 350500 |
| 350504 | 洛江区 | 350500 |
| 350505 | 泉港区 | 350500 |
| 350521 | 惠安县 | 350500 |
| 350524 | 安溪县 | 350500 |
| 350525 | 永春县 | 350500 |
| 350526 | 德化县 | 350500 |
| 350527 | 金门县 | 350500 |
| 350581 | 石狮市 | 350500 |
| 350582 | 晋江市 | 350500 |
| 350583 | 南安市 | 350500 |
| 350602 | 芗城区 | 350600 |
| 350603 | 龙文区 | 350600 |
| 350622 | 云霄县 | 350600 |
| 350623 | 漳浦县 | 350600 |
| 350624 | 诏安县 | 350600 |
| 350625 | 长泰县 | 350600 |
| 350626 | 东山县 | 350600 |
| 350627 | 南靖县 | 350600 |
| 350628 | 平和县 | 350600 |
| 350629 | 华安县 | 350600 |
| 350681 | 龙海市 | 350600 |
| 350702 | 延平区 | 350700 |
| 350703 | 建阳区 | 350700 |
| 350721 | 顺昌县 | 350700 |
| 350722 | 浦城县 | 350700 |
| 350723 | 光泽县 | 350700 |
| 350724 | 松溪县 | 350700 |
| 350725 | 政和县 | 350700 |
| 350781 | 邵武市 | 350700 |
| 350782 | 武夷山市 | 350700 |
| 350783 | 建瓯市 | 350700 |
| 350802 | 新罗区 | 350800 |
| 350803 | 永定区 | 350800 |
| 350821 | 长汀县 | 350800 |
| 350823 | 上杭县 | 350800 |
| 350824 | 武平县 | 350800 |
| 350825 | 连城县 | 350800 |
| 350881 | 漳平市 | 350800 |
| 350902 | 蕉城区 | 350900 |
| 350921 | 霞浦县 | 350900 |
| 350922 | 古田县 | 350900 |
| 350923 | 屏南县 | 350900 |
| 350924 | 寿宁县 | 350900 |
| 350925 | 周宁县 | 350900 |
| 350926 | 柘荣县 | 350900 |
| 350981 | 福安市 | 350900 |
| 350982 | 福鼎市 | 350900 |
| 360102 | 东湖区 | 360100 |
| 360103 | 西湖区 | 360100 |
| 360104 | 青云谱区 | 360100 |
| 360105 | 湾里区 | 360100 |
| 360111 | 青山湖区 | 360100 |
| 360112 | 新建区 | 360100 |
| 360121 | 南昌县 | 360100 |
| 360123 | 安义县 | 360100 |
| 360124 | 进贤县 | 360100 |
| 360202 | 昌江区 | 360200 |
| 360203 | 珠山区 | 360200 |
| 360222 | 浮梁县 | 360200 |
| 360281 | 乐平市 | 360200 |
| 360302 | 安源区 | 360300 |
| 360313 | 湘东区 | 360300 |
| 360321 | 莲花县 | 360300 |
| 360322 | 上栗县 | 360300 |
| 360323 | 芦溪县 | 360300 |
| 360402 | 濂溪区 | 360400 |
| 360403 | 浔阳区 | 360400 |
| 360404 | 柴桑区 | 360400 |
| 360423 | 武宁县 | 360400 |
| 360424 | 修水县 | 360400 |
| 360425 | 永修县 | 360400 |
| 360426 | 德安县 | 360400 |
| 360428 | 都昌县 | 360400 |
| 360429 | 湖口县 | 360400 |
| 360430 | 彭泽县 | 360400 |
| 360481 | 瑞昌市 | 360400 |
| 360482 | 共青城市 | 360400 |
| 360483 | 庐山市 | 360400 |
| 360502 | 渝水区 | 360500 |
| 360521 | 分宜县 | 360500 |
| 360602 | 月湖区 | 360600 |
| 360622 | 余江区 | 360600 |
| 360681 | 贵溪市 | 360600 |
| 360702 | 章贡区 | 360700 |
| 360703 | 南康区 | 360700 |
| 360704 | 赣县区 | 360700 |
| 360722 | 信丰县 | 360700 |
| 360723 | 大余县 | 360700 |
| 360724 | 上犹县 | 360700 |
| 360725 | 崇义县 | 360700 |
| 360726 | 安远县 | 360700 |
| 360727 | 龙南市 | 360700 |
| 360728 | 定南县 | 360700 |
| 360729 | 全南县 | 360700 |
| 360730 | 宁都县 | 360700 |
| 360731 | 于都县 | 360700 |
| 360732 | 兴国县 | 360700 |
| 360733 | 会昌县 | 360700 |
| 360734 | 寻乌县 | 360700 |
| 360735 | 石城县 | 360700 |
| 360781 | 瑞金市 | 360700 |
| 360802 | 吉州区 | 360800 |
| 360803 | 青原区 | 360800 |
| 360821 | 吉安县 | 360800 |
| 360822 | 吉水县 | 360800 |
| 360823 | 峡江县 | 360800 |
| 360824 | 新干县 | 360800 |
| 360825 | 永丰县 | 360800 |
| 360826 | 泰和县 | 360800 |
| 360827 | 遂川县 | 360800 |
| 360828 | 万安县 | 360800 |
| 360829 | 安福县 | 360800 |
| 360830 | 永新县 | 360800 |
| 360881 | 井冈山市 | 360800 |
| 360902 | 袁州区 | 360900 |
| 360921 | 奉新县 | 360900 |
| 360922 | 万载县 | 360900 |
| 360923 | 上高县 | 360900 |
| 360924 | 宜丰县 | 360900 |
| 360925 | 靖安县 | 360900 |
| 360926 | 铜鼓县 | 360900 |
| 360981 | 丰城市 | 360900 |
| 360982 | 樟树市 | 360900 |
| 360983 | 高安市 | 360900 |
| 361002 | 临川区 | 361000 |
| 361003 | 东乡区 | 361000 |
| 361021 | 南城县 | 361000 |
| 361022 | 黎川县 | 361000 |
| 361023 | 南丰县 | 361000 |
| 361024 | 崇仁县 | 361000 |
| 361025 | 乐安县 | 361000 |
| 361026 | 宜黄县 | 361000 |
| 361027 | 金溪县 | 361000 |
| 361028 | 资溪县 | 361000 |
| 361030 | 广昌县 | 361000 |
| 361102 | 信州区 | 361100 |
| 361103 | 广丰区 | 361100 |
| 361121 | 广信区 | 361100 |
| 361123 | 玉山县 | 361100 |
| 361124 | 铅山县 | 361100 |
| 361125 | 横峰县 | 361100 |
| 361126 | 弋阳县 | 361100 |
| 361127 | 余干县 | 361100 |
| 361128 | 鄱阳县 | 361100 |
| 361129 | 万年县 | 361100 |
| 361130 | 婺源县 | 361100 |
| 361181 | 德兴市 | 361100 |
| 370102 | 历下区 | 370100 |
| 370103 | 市中区 | 370100 |
| 370104 | 槐荫区 | 370100 |
| 370105 | 天桥区 | 370100 |
| 370112 | 历城区 | 370100 |
| 370113 | 长清区 | 370100 |
| 370114 | 章丘区 | 370100 |
| 370124 | 平阴县 | 370100 |
| 370125 | 济阳区 | 370100 |
| 370126 | 商河县 | 370100 |
| 370202 | 市南区 | 370200 |
| 370203 | 市北区 | 370200 |
| 370211 | 黄岛区 | 370200 |
| 370212 | 崂山区 | 370200 |
| 370213 | 李沧区 | 370200 |
| 370214 | 城阳区 | 370200 |
| 370215 | 即墨区 | 370200 |
| 370281 | 胶州市 | 370200 |
| 370283 | 平度市 | 370200 |
| 370285 | 莱西市 | 370200 |
| 370302 | 淄川区 | 370300 |
| 370303 | 张店区 | 370300 |
| 370304 | 博山区 | 370300 |
| 370305 | 临淄区 | 370300 |
| 370306 | 周村区 | 370300 |
| 370321 | 桓台县 | 370300 |
| 370322 | 高青县 | 370300 |
| 370323 | 沂源县 | 370300 |
| 370402 | 市中区 | 370400 |
| 370403 | 薛城区 | 370400 |
| 370404 | 峄城区 | 370400 |
| 370405 | 台儿庄区 | 370400 |
| 370406 | 山亭区 | 370400 |
| 370481 | 滕州市 | 370400 |
| 370502 | 东营区 | 370500 |
| 370503 | 河口区 | 370500 |
| 370505 | 垦利区 | 370500 |
| 370522 | 利津县 | 370500 |
| 370523 | 广饶县 | 370500 |
| 370602 | 芝罘区 | 370600 |
| 370611 | 福山区 | 370600 |
| 370612 | 牟平区 | 370600 |
| 370613 | 莱山区 | 370600 |
| 370614 | 蓬莱区 | 370600 |
| 370681 | 龙口市 | 370600 |
| 370682 | 莱阳市 | 370600 |
| 370683 | 莱州市 | 370600 |
| 370685 | 招远市 | 370600 |
| 370686 | 栖霞市 | 370600 |
| 370687 | 海阳市 | 370600 |
| 370702 | 潍城区 | 370700 |
| 370703 | 寒亭区 | 370700 |
| 370704 | 坊子区 | 370700 |
| 370705 | 奎文区 | 370700 |
| 370724 | 临朐县 | 370700 |
| 370725 | 昌乐县 | 370700 |
| 370781 | 青州市 | 370700 |
| 370782 | 诸城市 | 370700 |
| 370783 | 寿光市 | 370700 |
| 370784 | 安丘市 | 370700 |
| 370785 | 高密市 | 370700 |
| 370786 | 昌邑市 | 370700 |
| 370811 | 任城区 | 370800 |
| 370812 | 兖州区 | 370800 |
| 370826 | 微山县 | 370800 |
| 370827 | 鱼台县 | 370800 |
| 370828 | 金乡县 | 370800 |
| 370829 | 嘉祥县 | 370800 |
| 370830 | 汶上县 | 370800 |
| 370831 | 泗水县 | 370800 |
| 370832 | 梁山县 | 370800 |
| 370881 | 曲阜市 | 370800 |
| 370883 | 邹城市 | 370800 |
| 370902 | 泰山区 | 370900 |
| 370911 | 岱岳区 | 370900 |
| 370921 | 宁阳县 | 370900 |
| 370923 | 东平县 | 370900 |
| 370982 | 新泰市 | 370900 |
| 370983 | 肥城市 | 370900 |
| 371002 | 环翠区 | 371000 |
| 371003 | 文登区 | 371000 |
| 371082 | 荣成市 | 371000 |
| 371083 | 乳山市 | 371000 |
| 371102 | 东港区 | 371100 |
| 371103 | 岚山区 | 371100 |
| 371121 | 五莲县 | 371100 |
| 371122 | 莒县 | 371100 |
| 371202 | 莱城区 | 371200 |
| 371203 | 钢城区 | 371200 |
| 371302 | 兰山区 | 371300 |
| 371311 | 罗庄区 | 371300 |
| 371312 | 河东区 | 371300 |
| 371321 | 沂南县 | 371300 |
| 371322 | 郯城县 | 371300 |
| 371323 | 沂水县 | 371300 |
| 371324 | 兰陵县 | 371300 |
| 371325 | 费县 | 371300 |
| 371326 | 平邑县 | 371300 |
| 371327 | 莒南县 | 371300 |
| 371328 | 蒙阴县 | 371300 |
| 371329 | 临沭县 | 371300 |
| 371402 | 德城区 | 371400 |
| 371403 | 陵城区 | 371400 |
| 371422 | 宁津县 | 371400 |
| 371423 | 庆云县 | 371400 |
| 371424 | 临邑县 | 371400 |
| 371425 | 齐河县 | 371400 |
| 371426 | 平原县 | 371400 |
| 371427 | 夏津县 | 371400 |
| 371428 | 武城县 | 371400 |
| 371481 | 乐陵市 | 371400 |
| 371482 | 禹城市 | 371400 |
| 371502 | 东昌府区 | 371500 |
| 371521 | 阳谷县 | 371500 |
| 371522 | 莘县 | 371500 |
| 371523 | 茌平区 | 371500 |
| 371524 | 东阿县 | 371500 |
| 371525 | 冠县 | 371500 |
| 371526 | 高唐县 | 371500 |
| 371581 | 临清市 | 371500 |
| 371602 | 滨城区 | 371600 |
| 371603 | 沾化区 | 371600 |
| 371621 | 惠民县 | 371600 |
| 371622 | 阳信县 | 371600 |
| 371623 | 无棣县 | 371600 |
| 371625 | 博兴县 | 371600 |
| 371626 | 邹平市 | 371600 |
| 371702 | 牡丹区 | 371700 |
| 371703 | 定陶区 | 371700 |
| 371721 | 曹县 | 371700 |
| 371722 | 单县 | 371700 |
| 371723 | 成武县 | 371700 |
| 371724 | 巨野县 | 371700 |
| 371725 | 郓城县 | 371700 |
| 371726 | 鄄城县 | 371700 |
| 371728 | 东明县 | 371700 |
| 410102 | 中原区 | 410100 |
| 410103 | 二七区 | 410100 |
| 410104 | 管城回族区 | 410100 |
| 410105 | 金水区 | 410100 |
| 410106 | 上街区 | 410100 |
| 410108 | 惠济区 | 410100 |
| 410122 | 中牟县 | 410100 |
| 410181 | 巩义市 | 410100 |
| 410182 | 荥阳市 | 410100 |
| 410183 | 新密市 | 410100 |
| 410184 | 新郑市 | 410100 |
| 410185 | 登封市 | 410100 |
| 410202 | 龙亭区 | 410200 |
| 410203 | 顺河回族区 | 410200 |
| 410204 | 鼓楼区 | 410200 |
| 410205 | 禹王台区 | 410200 |
| 410212 | 祥符区 | 410200 |
| 410221 | 杞县 | 410200 |
| 410222 | 通许县 | 410200 |
| 410223 | 尉氏县 | 410200 |
| 410225 | 兰考县 | 410200 |
| 410302 | 老城区 | 410300 |
| 410303 | 西工区 | 410300 |
| 410304 | 瀍河回族区 | 410300 |
| 410305 | 涧西区 | 410300 |
| 410306 | 吉利区 | 410300 |
| 410311 | 洛龙区 | 410300 |
| 410322 | 孟津县 | 410300 |
| 410323 | 新安县 | 410300 |
| 410324 | 栾川县 | 410300 |
| 410325 | 嵩县 | 410300 |
| 410326 | 汝阳县 | 410300 |
| 410327 | 宜阳县 | 410300 |
| 410328 | 洛宁县 | 410300 |
| 410329 | 伊川县 | 410300 |
| 410381 | 偃师市 | 410300 |
| 410402 | 新华区 | 410400 |
| 410403 | 卫东区 | 410400 |
| 410404 | 石龙区 | 410400 |
| 410411 | 湛河区 | 410400 |
| 410421 | 宝丰县 | 410400 |
| 410422 | 叶县 | 410400 |
| 410423 | 鲁山县 | 410400 |
| 410425 | 郏县 | 410400 |
| 410481 | 舞钢市 | 410400 |
| 410482 | 汝州市 | 410400 |
| 410502 | 文峰区 | 410500 |
| 410503 | 北关区 | 410500 |
| 410505 | 殷都区 | 410500 |
| 410506 | 龙安区 | 410500 |
| 410522 | 安阳县 | 410500 |
| 410523 | 汤阴县 | 410500 |
| 410526 | 滑县 | 410500 |
| 410527 | 内黄县 | 410500 |
| 410581 | 林州市 | 410500 |
| 410602 | 鹤山区 | 410600 |
| 410603 | 山城区 | 410600 |
| 410611 | 淇滨区 | 410600 |
| 410621 | 浚县 | 410600 |
| 410622 | 淇县 | 410600 |
| 410702 | 红旗区 | 410700 |
| 410703 | 卫滨区 | 410700 |
| 410704 | 凤泉区 | 410700 |
| 410711 | 牧野区 | 410700 |
| 410721 | 新乡县 | 410700 |
| 410724 | 获嘉县 | 410700 |
| 410725 | 原阳县 | 410700 |
| 410726 | 延津县 | 410700 |
| 410727 | 封丘县 | 410700 |
| 410728 | 长垣市 | 410700 |
| 410781 | 卫辉市 | 410700 |
| 410782 | 辉县市 | 410700 |
| 410802 | 解放区 | 410800 |
| 410803 | 中站区 | 410800 |
| 410804 | 马村区 | 410800 |
| 410811 | 山阳区 | 410800 |
| 410821 | 修武县 | 410800 |
| 410822 | 博爱县 | 410800 |
| 410823 | 武陟县 | 410800 |
| 410825 | 温县 | 410800 |
| 410882 | 沁阳市 | 410800 |
| 410883 | 孟州市 | 410800 |
| 410902 | 华龙区 | 410900 |
| 410922 | 清丰县 | 410900 |
| 410923 | 南乐县 | 410900 |
| 410926 | 范县 | 410900 |
| 410927 | 台前县 | 410900 |
| 410928 | 濮阳县 | 410900 |
| 411002 | 魏都区 | 411000 |
| 411003 | 建安区 | 411000 |
| 411024 | 鄢陵县 | 411000 |
| 411025 | 襄城县 | 411000 |
| 411081 | 禹州市 | 411000 |
| 411082 | 长葛市 | 411000 |
| 411102 | 源汇区 | 411100 |
| 411103 | 郾城区 | 411100 |
| 411104 | 召陵区 | 411100 |
| 411121 | 舞阳县 | 411100 |
| 411122 | 临颍县 | 411100 |
| 411202 | 湖滨区 | 411200 |
| 411203 | 陕州区 | 411200 |
| 411221 | 渑池县 | 411200 |
| 411224 | 卢氏县 | 411200 |
| 411281 | 义马市 | 411200 |
| 411282 | 灵宝市 | 411200 |
| 411302 | 宛城区 | 411300 |
| 411303 | 卧龙区 | 411300 |
| 411321 | 南召县 | 411300 |
| 411322 | 方城县 | 411300 |
| 411323 | 西峡县 | 411300 |
| 411324 | 镇平县 | 411300 |
| 411325 | 内乡县 | 411300 |
| 411326 | 淅川县 | 411300 |
| 411327 | 社旗县 | 411300 |
| 411328 | 唐河县 | 411300 |
| 411329 | 新野县 | 411300 |
| 411330 | 桐柏县 | 411300 |
| 411381 | 邓州市 | 411300 |
| 411402 | 梁园区 | 411400 |
| 411403 | 睢阳区 | 411400 |
| 411421 | 民权县 | 411400 |
| 411422 | 睢县 | 411400 |
| 411423 | 宁陵县 | 411400 |
| 411424 | 柘城县 | 411400 |
| 411425 | 虞城县 | 411400 |
| 411426 | 夏邑县 | 411400 |
| 411481 | 永城市 | 411400 |
| 411502 | 浉河区 | 411500 |
| 411503 | 平桥区 | 411500 |
| 411521 | 罗山县 | 411500 |
| 411522 | 光山县 | 411500 |
| 411523 | 新县 | 411500 |
| 411524 | 商城县 | 411500 |
| 411525 | 固始县 | 411500 |
| 411526 | 潢川县 | 411500 |
| 411527 | 淮滨县 | 411500 |
| 411528 | 息县 | 411500 |
| 411602 | 川汇区 | 411600 |
| 411621 | 扶沟县 | 411600 |
| 411622 | 西华县 | 411600 |
| 411623 | 商水县 | 411600 |
| 411624 | 沈丘县 | 411600 |
| 411625 | 郸城县 | 411600 |
| 411626 | 淮阳区 | 411600 |
| 411627 | 太康县 | 411600 |
| 411628 | 鹿邑县 | 411600 |
| 411681 | 项城市 | 411600 |
| 411702 | 驿城区 | 411700 |
| 411721 | 西平县 | 411700 |
| 411722 | 上蔡县 | 411700 |
| 411723 | 平舆县 | 411700 |
| 411724 | 正阳县 | 411700 |
| 411725 | 确山县 | 411700 |
| 411726 | 泌阳县 | 411700 |
| 411727 | 汝南县 | 411700 |
| 411728 | 遂平县 | 411700 |
| 411729 | 新蔡县 | 411700 |
| 420102 | 江岸区 | 420100 |
| 420103 | 江汉区 | 420100 |
| 420104 | 硚口区 | 420100 |
| 420105 | 汉阳区 | 420100 |
| 420106 | 武昌区 | 420100 |
| 420107 | 青山区 | 420100 |
| 420111 | 洪山区 | 420100 |
| 420112 | 东西湖区 | 420100 |
| 420113 | 汉南区 | 420100 |
| 420114 | 蔡甸区 | 420100 |
| 420115 | 江夏区 | 420100 |
| 420116 | 黄陂区 | 420100 |
| 420117 | 新洲区 | 420100 |
| 420202 | 黄石港区 | 420200 |
| 420203 | 西塞山区 | 420200 |
| 420204 | 下陆区 | 420200 |
| 420205 | 铁山区 | 420200 |
| 420222 | 阳新县 | 420200 |
| 420281 | 大冶市 | 420200 |
| 420302 | 茅箭区 | 420300 |
| 420303 | 张湾区 | 420300 |
| 420304 | 郧阳区 | 420300 |
| 420322 | 郧西县 | 420300 |
| 420323 | 竹山县 | 420300 |
| 420324 | 竹溪县 | 420300 |
| 420325 | 房县 | 420300 |
| 420381 | 丹江口市 | 420300 |
| 420502 | 西陵区 | 420500 |
| 420503 | 伍家岗区 | 420500 |
| 420504 | 点军区 | 420500 |
| 420505 | 猇亭区 | 420500 |
| 420506 | 夷陵区 | 420500 |
| 420525 | 远安县 | 420500 |
| 420526 | 兴山县 | 420500 |
| 420527 | 秭归县 | 420500 |
| 420528 | 长阳土家族自治县 | 420500 |
| 420529 | 五峰土家族自治县 | 420500 |
| 420581 | 宜都市 | 420500 |
| 420582 | 当阳市 | 420500 |
| 420583 | 枝江市 | 420500 |
| 420602 | 襄城区 | 420600 |
| 420606 | 樊城区 | 420600 |
| 420607 | 襄州区 | 420600 |
| 420624 | 南漳县 | 420600 |
| 420625 | 谷城县 | 420600 |
| 420626 | 保康县 | 420600 |
| 420682 | 老河口市 | 420600 |
| 420683 | 枣阳市 | 420600 |
| 420684 | 宜城市 | 420600 |
| 420702 | 梁子湖区 | 420700 |
| 420703 | 华容区 | 420700 |
| 420704 | 鄂城区 | 420700 |
| 420802 | 东宝区 | 420800 |
| 420804 | 掇刀区 | 420800 |
| 420821 | 京山市 | 420800 |
| 420822 | 沙洋县 | 420800 |
| 420881 | 钟祥市 | 420800 |
| 420902 | 孝南区 | 420900 |
| 420921 | 孝昌县 | 420900 |
| 420922 | 大悟县 | 420900 |
| 420923 | 云梦县 | 420900 |
| 420981 | 应城市 | 420900 |
| 420982 | 安陆市 | 420900 |
| 420984 | 汉川市 | 420900 |
| 421002 | 沙市区 | 421000 |
| 421003 | 荆州区 | 421000 |
| 421022 | 公安县 | 421000 |
| 421023 | 监利县 | 421000 |
| 421024 | 江陵县 | 421000 |
| 421081 | 石首市 | 421000 |
| 421083 | 洪湖市 | 421000 |
| 421087 | 松滋市 | 421000 |
| 421102 | 黄州区 | 421100 |
| 421121 | 团风县 | 421100 |
| 421122 | 红安县 | 421100 |
| 421123 | 罗田县 | 421100 |
| 421124 | 英山县 | 421100 |
| 421125 | 浠水县 | 421100 |
| 421126 | 蕲春县 | 421100 |
| 421127 | 黄梅县 | 421100 |
| 421181 | 麻城市 | 421100 |
| 421182 | 武穴市 | 421100 |
| 421202 | 咸安区 | 421200 |
| 421221 | 嘉鱼县 | 421200 |
| 421222 | 通城县 | 421200 |
| 421223 | 崇阳县 | 421200 |
| 421224 | 通山县 | 421200 |
| 421281 | 赤壁市 | 421200 |
| 421303 | 曾都区 | 421300 |
| 421321 | 随县 | 421300 |
| 421381 | 广水市 | 421300 |
| 422801 | 恩施市 | 422800 |
| 422802 | 利川市 | 422800 |
| 422822 | 建始县 | 422800 |
| 422823 | 巴东县 | 422800 |
| 422825 | 宣恩县 | 422800 |
| 422826 | 咸丰县 | 422800 |
| 422827 | 来凤县 | 422800 |
| 422828 | 鹤峰县 | 422800 |
| 430102 | 芙蓉区 | 430100 |
| 430103 | 天心区 | 430100 |
| 430104 | 岳麓区 | 430100 |
| 430105 | 开福区 | 430100 |
| 430111 | 雨花区 | 430100 |
| 430112 | 望城区 | 430100 |
| 430121 | 长沙县 | 430100 |
| 430181 | 浏阳市 | 430100 |
| 430182 | 宁乡市 | 430100 |
| 430202 | 荷塘区 | 430200 |
| 430203 | 芦淞区 | 430200 |
| 430204 | 石峰区 | 430200 |
| 430211 | 天元区 | 430200 |
| 430221 | 渌口区 | 430200 |
| 430223 | 攸县 | 430200 |
| 430224 | 茶陵县 | 430200 |
| 430225 | 炎陵县 | 430200 |
| 430281 | 醴陵市 | 430200 |
| 430302 | 雨湖区 | 430300 |
| 430304 | 岳塘区 | 430300 |
| 430321 | 湘潭县 | 430300 |
| 430381 | 湘乡市 | 430300 |
| 430382 | 韶山市 | 430300 |
| 430405 | 珠晖区 | 430400 |
| 430406 | 雁峰区 | 430400 |
| 430407 | 石鼓区 | 430400 |
| 430408 | 蒸湘区 | 430400 |
| 430412 | 南岳区 | 430400 |
| 430421 | 衡阳县 | 430400 |
| 430422 | 衡南县 | 430400 |
| 430423 | 衡山县 | 430400 |
| 430424 | 衡东县 | 430400 |
| 430426 | 祁东县 | 430400 |
| 430481 | 耒阳市 | 430400 |
| 430482 | 常宁市 | 430400 |
| 430502 | 双清区 | 430500 |
| 430503 | 大祥区 | 430500 |
| 430511 | 北塔区 | 430500 |
| 430521 | 邵东市 | 430500 |
| 430522 | 新邵县 | 430500 |
| 430523 | 邵阳县 | 430500 |
| 430524 | 隆回县 | 430500 |
| 430525 | 洞口县 | 430500 |
| 430527 | 绥宁县 | 430500 |
| 430528 | 新宁县 | 430500 |
| 430529 | 城步苗族自治县 | 430500 |
| 430581 | 武冈市 | 430500 |
| 430602 | 岳阳楼区 | 430600 |
| 430603 | 云溪区 | 430600 |
| 430611 | 君山区 | 430600 |
| 430621 | 岳阳县 | 430600 |
| 430623 | 华容县 | 430600 |
| 430624 | 湘阴县 | 430600 |
| 430626 | 平江县 | 430600 |
| 430681 | 汨罗市 | 430600 |
| 430682 | 临湘市 | 430600 |
| 430702 | 武陵区 | 430700 |
| 430703 | 鼎城区 | 430700 |
| 430721 | 安乡县 | 430700 |
| 430722 | 汉寿县 | 430700 |
| 430723 | 澧县 | 430700 |
| 430724 | 临澧县 | 430700 |
| 430725 | 桃源县 | 430700 |
| 430726 | 石门县 | 430700 |
| 430781 | 津市市 | 430700 |
| 430802 | 永定区 | 430800 |
| 430811 | 武陵源区 | 430800 |
| 430821 | 慈利县 | 430800 |
| 430822 | 桑植县 | 430800 |
| 430902 | 资阳区 | 430900 |
| 430903 | 赫山区 | 430900 |
| 430921 | 南县 | 430900 |
| 430922 | 桃江县 | 430900 |
| 430923 | 安化县 | 430900 |
| 430981 | 沅江市 | 430900 |
| 431002 | 北湖区 | 431000 |
| 431003 | 苏仙区 | 431000 |
| 431021 | 桂阳县 | 431000 |
| 431022 | 宜章县 | 431000 |
| 431023 | 永兴县 | 431000 |
| 431024 | 嘉禾县 | 431000 |
| 431025 | 临武县 | 431000 |
| 431026 | 汝城县 | 431000 |
| 431027 | 桂东县 | 431000 |
| 431028 | 安仁县 | 431000 |
| 431081 | 资兴市 | 431000 |
| 431102 | 零陵区 | 431100 |
| 431103 | 冷水滩区 | 431100 |
| 431121 | 祁阳县 | 431100 |
| 431122 | 东安县 | 431100 |
| 431123 | 双牌县 | 431100 |
| 431124 | 道县 | 431100 |
| 431125 | 江永县 | 431100 |
| 431126 | 宁远县 | 431100 |
| 431127 | 蓝山县 | 431100 |
| 431128 | 新田县 | 431100 |
| 431129 | 江华瑶族自治县 | 431100 |
| 431202 | 鹤城区 | 431200 |
| 431221 | 中方县 | 431200 |
| 431222 | 沅陵县 | 431200 |
| 431223 | 辰溪县 | 431200 |
| 431224 | 溆浦县 | 431200 |
| 431225 | 会同县 | 431200 |
| 431226 | 麻阳苗族自治县 | 431200 |
| 431227 | 新晃侗族自治县 | 431200 |
| 431228 | 芷江侗族自治县 | 431200 |
| 431229 | 靖州苗族侗族自治县 | 431200 |
| 431230 | 通道侗族自治县 | 431200 |
| 431281 | 洪江市 | 431200 |
| 431302 | 娄星区 | 431300 |
| 431321 | 双峰县 | 431300 |
| 431322 | 新化县 | 431300 |
| 431381 | 冷水江市 | 431300 |
| 431382 | 涟源市 | 431300 |
| 433101 | 吉首市 | 433100 |
| 433122 | 泸溪县 | 433100 |
| 433123 | 凤凰县 | 433100 |
| 433124 | 花垣县 | 433100 |
| 433125 | 保靖县 | 433100 |
| 433126 | 古丈县 | 433100 |
| 433127 | 永顺县 | 433100 |
| 433130 | 龙山县 | 433100 |
| 440103 | 荔湾区 | 440100 |
| 440104 | 越秀区 | 440100 |
| 440105 | 海珠区 | 440100 |
| 440106 | 天河区 | 440100 |
| 440111 | 白云区 | 440100 |
| 440112 | 黄埔区 | 440100 |
| 440113 | 番禺区 | 440100 |
| 440114 | 花都区 | 440100 |
| 440115 | 南沙区 | 440100 |
| 440117 | 从化区 | 440100 |
| 440118 | 增城区 | 440100 |
| 440203 | 武江区 | 440200 |
| 440204 | 浈江区 | 440200 |
| 440205 | 曲江区 | 440200 |
| 440222 | 始兴县 | 440200 |
| 440224 | 仁化县 | 440200 |
| 440229 | 翁源县 | 440200 |
| 440232 | 乳源瑶族自治县 | 440200 |
| 440233 | 新丰县 | 440200 |
| 440281 | 乐昌市 | 440200 |
| 440282 | 南雄市 | 440200 |
| 440303 | 罗湖区 | 440300 |
| 440304 | 福田区 | 440300 |
| 440305 | 南山区 | 440300 |
| 440306 | 宝安区 | 440300 |
| 440307 | 龙岗区 | 440300 |
| 440308 | 盐田区 | 440300 |
| 440309 | 龙华区 | 440300 |
| 440310 | 坪山区 | 440300 |
| 440402 | 香洲区 | 440400 |
| 440403 | 斗门区 | 440400 |
| 440404 | 金湾区 | 440400 |
| 440507 | 龙湖区 | 440500 |
| 440511 | 金平区 | 440500 |
| 440512 | 濠江区 | 440500 |
| 440513 | 潮阳区 | 440500 |
| 440514 | 潮南区 | 440500 |
| 440515 | 澄海区 | 440500 |
| 440523 | 南澳县 | 440500 |
| 440604 | 禅城区 | 440600 |
| 440605 | 南海区 | 440600 |
| 440606 | 顺德区 | 440600 |
| 440607 | 三水区 | 440600 |
| 440608 | 高明区 | 440600 |
| 440703 | 蓬江区 | 440700 |
| 440704 | 江海区 | 440700 |
| 440705 | 新会区 | 440700 |
| 440781 | 台山市 | 440700 |
| 440783 | 开平市 | 440700 |
| 440784 | 鹤山市 | 440700 |
| 440785 | 恩平市 | 440700 |
| 440802 | 赤坎区 | 440800 |
| 440803 | 霞山区 | 440800 |
| 440804 | 坡头区 | 440800 |
| 440811 | 麻章区 | 440800 |
| 440823 | 遂溪县 | 440800 |
| 440825 | 徐闻县 | 440800 |
| 440881 | 廉江市 | 440800 |
| 440882 | 雷州市 | 440800 |
| 440883 | 吴川市 | 440800 |
| 440902 | 茂南区 | 440900 |
| 440904 | 电白区 | 440900 |
| 440981 | 高州市 | 440900 |
| 440982 | 化州市 | 440900 |
| 440983 | 信宜市 | 440900 |
| 441202 | 端州区 | 441200 |
| 441203 | 鼎湖区 | 441200 |
| 441204 | 高要区 | 441200 |
| 441223 | 广宁县 | 441200 |
| 441224 | 怀集县 | 441200 |
| 441225 | 封开县 | 441200 |
| 441226 | 德庆县 | 441200 |
| 441284 | 四会市 | 441200 |
| 441302 | 惠城区 | 441300 |
| 441303 | 惠阳区 | 441300 |
| 441322 | 博罗县 | 441300 |
| 441323 | 惠东县 | 441300 |
| 441324 | 龙门县 | 441300 |
| 441402 | 梅江区 | 441400 |
| 441403 | 梅县区 | 441400 |
| 441422 | 大埔县 | 441400 |
| 441423 | 丰顺县 | 441400 |
| 441424 | 五华县 | 441400 |
| 441426 | 平远县 | 441400 |
| 441427 | 蕉岭县 | 441400 |
| 441481 | 兴宁市 | 441400 |
| 441502 | 城区 | 441500 |
| 441521 | 海丰县 | 441500 |
| 441523 | 陆河县 | 441500 |
| 441581 | 陆丰市 | 441500 |
| 441602 | 源城区 | 441600 |
| 441621 | 紫金县 | 441600 |
| 441622 | 龙川县 | 441600 |
| 441623 | 连平县 | 441600 |
| 441624 | 和平县 | 441600 |
| 441625 | 东源县 | 441600 |
| 441702 | 江城区 | 441700 |
| 441704 | 阳东区 | 441700 |
| 441721 | 阳西县 | 441700 |
| 441781 | 阳春市 | 441700 |
| 441802 | 清城区 | 441800 |
| 441803 | 清新区 | 441800 |
| 441821 | 佛冈县 | 441800 |
| 441823 | 阳山县 | 441800 |
| 441825 | 连山壮族瑶族自治县 | 441800 |
| 441826 | 连南瑶族自治县 | 441800 |
| 441881 | 英德市 | 441800 |
| 441882 | 连州市 | 441800 |
| 445102 | 湘桥区 | 445100 |
| 445103 | 潮安区 | 445100 |
| 445122 | 饶平县 | 445100 |
| 445202 | 榕城区 | 445200 |
| 445203 | 揭东区 | 445200 |
| 445222 | 揭西县 | 445200 |
| 445224 | 惠来县 | 445200 |
| 445281 | 普宁市 | 445200 |
| 445302 | 云城区 | 445300 |
| 445303 | 云安区 | 445300 |
| 445321 | 新兴县 | 445300 |
| 445322 | 郁南县 | 445300 |
| 445381 | 罗定市 | 445300 |
| 450102 | 兴宁区 | 450100 |
| 450103 | 青秀区 | 450100 |
| 450105 | 江南区 | 450100 |
| 450107 | 西乡塘区 | 450100 |
| 450108 | 良庆区 | 450100 |
| 450109 | 邕宁区 | 450100 |
| 450110 | 武鸣区 | 450100 |
| 450123 | 隆安县 | 450100 |
| 450124 | 马山县 | 450100 |
| 450125 | 上林县 | 450100 |
| 450126 | 宾阳县 | 450100 |
| 450127 | 横县 | 450100 |
| 450202 | 城中区 | 450200 |
| 450203 | 鱼峰区 | 450200 |
| 450204 | 柳南区 | 450200 |
| 450205 | 柳北区 | 450200 |
| 450206 | 柳江区 | 450200 |
| 450222 | 柳城县 | 450200 |
| 450223 | 鹿寨县 | 450200 |
| 450224 | 融安县 | 450200 |
| 450225 | 融水苗族自治县 | 450200 |
| 450226 | 三江侗族自治县 | 450200 |
| 450302 | 秀峰区 | 450300 |
| 450303 | 叠彩区 | 450300 |
| 450304 | 象山区 | 450300 |
| 450305 | 七星区 | 450300 |
| 450311 | 雁山区 | 450300 |
| 450312 | 临桂区 | 450300 |
| 450321 | 阳朔县 | 450300 |
| 450323 | 灵川县 | 450300 |
| 450324 | 全州县 | 450300 |
| 450325 | 兴安县 | 450300 |
| 450326 | 永福县 | 450300 |
| 450327 | 灌阳县 | 450300 |
| 450328 | 龙胜各族自治县 | 450300 |
| 450329 | 资源县 | 450300 |
| 450330 | 平乐县 | 450300 |
| 450331 | 荔浦市 | 450300 |
| 450332 | 恭城瑶族自治县 | 450300 |
| 450403 | 万秀区 | 450400 |
| 450405 | 长洲区 | 450400 |
| 450406 | 龙圩区 | 450400 |
| 450421 | 苍梧县 | 450400 |
| 450422 | 藤县 | 450400 |
| 450423 | 蒙山县 | 450400 |
| 450481 | 岑溪市 | 450400 |
| 450502 | 海城区 | 450500 |
| 450503 | 银海区 | 450500 |
| 450512 | 铁山港区 | 450500 |
| 450521 | 合浦县 | 450500 |
| 450602 | 港口区 | 450600 |
| 450603 | 防城区 | 450600 |
| 450621 | 上思县 | 450600 |
| 450681 | 东兴市 | 450600 |
| 450702 | 钦南区 | 450700 |
| 450703 | 钦北区 | 450700 |
| 450721 | 灵山县 | 450700 |
| 450722 | 浦北县 | 450700 |
| 450802 | 港北区 | 450800 |
| 450803 | 港南区 | 450800 |
| 450804 | 覃塘区 | 450800 |
| 450821 | 平南县 | 450800 |
| 450881 | 桂平市 | 450800 |
| 450902 | 玉州区 | 450900 |
| 450903 | 福绵区 | 450900 |
| 450921 | 容县 | 450900 |
| 450922 | 陆川县 | 450900 |
| 450923 | 博白县 | 450900 |
| 450924 | 兴业县 | 450900 |
| 450981 | 北流市 | 450900 |
| 451002 | 右江区 | 451000 |
| 451021 | 田阳区 | 451000 |
| 451022 | 田东县 | 451000 |
| 451023 | 平果市 | 451000 |
| 451024 | 德保县 | 451000 |
| 451026 | 那坡县 | 451000 |
| 451027 | 凌云县 | 451000 |
| 451028 | 乐业县 | 451000 |
| 451029 | 田林县 | 451000 |
| 451030 | 西林县 | 451000 |
| 451031 | 隆林各族自治县 | 451000 |
| 451081 | 靖西市 | 451000 |
| 451102 | 八步区 | 451100 |
| 451103 | 平桂区 | 451100 |
| 451121 | 昭平县 | 451100 |
| 451122 | 钟山县 | 451100 |
| 451123 | 富川瑶族自治县 | 451100 |
| 451202 | 金城江区 | 451200 |
| 451203 | 宜州区 | 451200 |
| 451221 | 南丹县 | 451200 |
| 451222 | 天峨县 | 451200 |
| 451223 | 凤山县 | 451200 |
| 451224 | 东兰县 | 451200 |
| 451225 | 罗城仫佬族自治县 | 451200 |
| 451226 | 环江毛南族自治县 | 451200 |
| 451227 | 巴马瑶族自治县 | 451200 |
| 451228 | 都安瑶族自治县 | 451200 |
| 451229 | 大化瑶族自治县 | 451200 |
| 451302 | 兴宾区 | 451300 |
| 451321 | 忻城县 | 451300 |
| 451322 | 象州县 | 451300 |
| 451323 | 武宣县 | 451300 |
| 451324 | 金秀瑶族自治县 | 451300 |
| 451381 | 合山市 | 451300 |
| 451402 | 江州区 | 451400 |
| 451421 | 扶绥县 | 451400 |
| 451422 | 宁明县 | 451400 |
| 451423 | 龙州县 | 451400 |
| 451424 | 大新县 | 451400 |
| 451425 | 天等县 | 451400 |
| 451481 | 凭祥市 | 451400 |
| 460105 | 秀英区 | 460100 |
| 460106 | 龙华区 | 460100 |
| 460107 | 琼山区 | 460100 |
| 460108 | 美兰区 | 460100 |
| 460202 | 海棠区 | 460200 |
| 460203 | 吉阳区 | 460200 |
| 460204 | 天涯区 | 460200 |
| 460205 | 崖州区 | 460200 |
| 460321 | 西沙群岛 | 460300 |
| 460322 | 南沙群岛 | 460300 |
| 460323 | 中沙群岛 | 460300 |
| 460324 | 永乐群岛 | 460300 |
| 500101 | 万州区 | 500000 |
| 500102 | 涪陵区 | 500000 |
| 500103 | 渝中区 | 500000 |
| 500104 | 大渡口区 | 500000 |
| 500105 | 江北区 | 500000 |
| 500106 | 沙坪坝区 | 500000 |
| 500107 | 九龙坡区 | 500000 |
| 500108 | 南岸区 | 500000 |
| 500109 | 北碚区 | 500000 |
| 500110 | 綦江区 | 500000 |
| 500111 | 大足区 | 500000 |
| 500112 | 渝北区 | 500000 |
| 500113 | 巴南区 | 500000 |
| 500114 | 黔江区 | 500000 |
| 500115 | 长寿区 | 500000 |
| 500116 | 江津区 | 500000 |
| 500117 | 合川区 | 500000 |
| 500118 | 永川区 | 500000 |
| 500119 | 南川区 | 500000 |
| 500120 | 璧山区 | 500000 |
| 500151 | 铜梁区 | 500000 |
| 500152 | 潼南区 | 500000 |
| 500153 | 荣昌区 | 500000 |
| 500154 | 开州区 | 500000 |
| 500155 | 梁平区 | 500000 |
| 500156 | 武隆区 | 500000 |
| 500229 | 城口县 | 500000 |
| 500230 | 丰都县 | 500000 |
| 500231 | 垫江县 | 500000 |
| 500233 | 忠县 | 500000 |
| 500235 | 云阳县 | 500000 |
| 500236 | 奉节县 | 500000 |
| 500237 | 巫山县 | 500000 |
| 500238 | 巫溪县 | 500000 |
| 500240 | 石柱土家族自治县 | 500000 |
| 500241 | 秀山土家族苗族自治县 | 500000 |
| 500242 | 酉阳土家族苗族自治县 | 500000 |
| 500243 | 彭水苗族土家族自治县 | 500000 |
| 510104 | 锦江区 | 510100 |
| 510105 | 青羊区 | 510100 |
| 510106 | 金牛区 | 510100 |
| 510107 | 武侯区 | 510100 |
| 510108 | 成华区 | 510100 |
| 510112 | 龙泉驿区 | 510100 |
| 510113 | 青白江区 | 510100 |
| 510114 | 新都区 | 510100 |
| 510115 | 温江区 | 510100 |
| 510116 | 双流区 | 510100 |
| 510117 | 郫都区 | 510100 |
| 510121 | 金堂县 | 510100 |
| 510129 | 大邑县 | 510100 |
| 510131 | 蒲江县 | 510100 |
| 510132 | 新津区 | 510100 |
| 510181 | 都江堰市 | 510100 |
| 510182 | 彭州市 | 510100 |
| 510183 | 邛崃市 | 510100 |
| 510184 | 崇州市 | 510100 |
| 510185 | 简阳市 | 510100 |
| 510302 | 自流井区 | 510300 |
| 510303 | 贡井区 | 510300 |
| 510304 | 大安区 | 510300 |
| 510311 | 沿滩区 | 510300 |
| 510321 | 荣县 | 510300 |
| 510322 | 富顺县 | 510300 |
| 510402 | 东区 | 510400 |
| 510403 | 西区 | 510400 |
| 510411 | 仁和区 | 510400 |
| 510421 | 米易县 | 510400 |
| 510422 | 盐边县 | 510400 |
| 510502 | 江阳区 | 510500 |
| 510503 | 纳溪区 | 510500 |
| 510504 | 龙马潭区 | 510500 |
| 510521 | 泸县 | 510500 |
| 510522 | 合江县 | 510500 |
| 510524 | 叙永县 | 510500 |
| 510525 | 古蔺县 | 510500 |
| 510603 | 旌阳区 | 510600 |
| 510604 | 罗江区 | 510600 |
| 510623 | 中江县 | 510600 |
| 510681 | 广汉市 | 510600 |
| 510682 | 什邡市 | 510600 |
| 510683 | 绵竹市 | 510600 |
| 510703 | 涪城区 | 510700 |
| 510704 | 游仙区 | 510700 |
| 510705 | 安州区 | 510700 |
| 510722 | 三台县 | 510700 |
| 510723 | 盐亭县 | 510700 |
| 510725 | 梓潼县 | 510700 |
| 510726 | 北川羌族自治县 | 510700 |
| 510727 | 平武县 | 510700 |
| 510781 | 江油市 | 510700 |
| 510802 | 利州区 | 510800 |
| 510811 | 昭化区 | 510800 |
| 510812 | 朝天区 | 510800 |
| 510821 | 旺苍县 | 510800 |
| 510822 | 青川县 | 510800 |
| 510823 | 剑阁县 | 510800 |
| 510824 | 苍溪县 | 510800 |
| 510903 | 船山区 | 510900 |
| 510904 | 安居区 | 510900 |
| 510921 | 蓬溪县 | 510900 |
| 510922 | 射洪市 | 510900 |
| 510923 | 大英县 | 510900 |
| 511002 | 市中区 | 511000 |
| 511011 | 东兴区 | 511000 |
| 511024 | 威远县 | 511000 |
| 511025 | 资中县 | 511000 |
| 511083 | 隆昌市 | 511000 |
| 511102 | 市中区 | 511100 |
| 511111 | 沙湾区 | 511100 |
| 511112 | 五通桥区 | 511100 |
| 511113 | 金口河区 | 511100 |
| 511123 | 犍为县 | 511100 |
| 511124 | 井研县 | 511100 |
| 511126 | 夹江县 | 511100 |
| 511129 | 沐川县 | 511100 |
| 511132 | 峨边彝族自治县 | 511100 |
| 511133 | 马边彝族自治县 | 511100 |
| 511181 | 峨眉山市 | 511100 |
| 511302 | 顺庆区 | 511300 |
| 511303 | 高坪区 | 511300 |
| 511304 | 嘉陵区 | 511300 |
| 511321 | 南部县 | 511300 |
| 511322 | 营山县 | 511300 |
| 511323 | 蓬安县 | 511300 |
| 511324 | 仪陇县 | 511300 |
| 511325 | 西充县 | 511300 |
| 511381 | 阆中市 | 511300 |
| 511402 | 东坡区 | 511400 |
| 511403 | 彭山区 | 511400 |
| 511421 | 仁寿县 | 511400 |
| 511423 | 洪雅县 | 511400 |
| 511424 | 丹棱县 | 511400 |
| 511425 | 青神县 | 511400 |
| 511502 | 翠屏区 | 511500 |
| 511503 | 南溪区 | 511500 |
| 511521 | 叙州区 | 511500 |
| 511523 | 江安县 | 511500 |
| 511524 | 长宁县 | 511500 |
| 511525 | 高县 | 511500 |
| 511526 | 珙县 | 511500 |
| 511527 | 筠连县 | 511500 |
| 511528 | 兴文县 | 511500 |
| 511529 | 屏山县 | 511500 |
| 511602 | 广安区 | 511600 |
| 511603 | 前锋区 | 511600 |
| 511621 | 岳池县 | 511600 |
| 511622 | 武胜县 | 511600 |
| 511623 | 邻水县 | 511600 |
| 511681 | 华蓥市 | 511600 |
| 511702 | 通川区 | 511700 |
| 511703 | 达川区 | 511700 |
| 511722 | 宣汉县 | 511700 |
| 511723 | 开江县 | 511700 |
| 511724 | 大竹县 | 511700 |
| 511725 | 渠县 | 511700 |
| 511781 | 万源市 | 511700 |
| 511802 | 雨城区 | 511800 |
| 511803 | 名山区 | 511800 |
| 511822 | 荥经县 | 511800 |
| 511823 | 汉源县 | 511800 |
| 511824 | 石棉县 | 511800 |
| 511825 | 天全县 | 511800 |
| 511826 | 芦山县 | 511800 |
| 511827 | 宝兴县 | 511800 |
| 511902 | 巴州区 | 511900 |
| 511903 | 恩阳区 | 511900 |
| 511921 | 通江县 | 511900 |
| 511922 | 南江县 | 511900 |
| 511923 | 平昌县 | 511900 |
| 512002 | 雁江区 | 512000 |
| 512021 | 安岳县 | 512000 |
| 512022 | 乐至县 | 512000 |
| 513201 | 马尔康市 | 513200 |
| 513221 | 汶川县 | 513200 |
| 513222 | 理县 | 513200 |
| 513223 | 茂县 | 513200 |
| 513224 | 松潘县 | 513200 |
| 513225 | 九寨沟县 | 513200 |
| 513226 | 金川县 | 513200 |
| 513227 | 小金县 | 513200 |
| 513228 | 黑水县 | 513200 |
| 513230 | 壤塘县 | 513200 |
| 513231 | 阿坝县 | 513200 |
| 513232 | 若尔盖县 | 513200 |
| 513233 | 红原县 | 513200 |
| 513301 | 康定市 | 513300 |
| 513322 | 泸定县 | 513300 |
| 513323 | 丹巴县 | 513300 |
| 513324 | 九龙县 | 513300 |
| 513325 | 雅江县 | 513300 |
| 513326 | 道孚县 | 513300 |
| 513327 | 炉霍县 | 513300 |
| 513328 | 甘孜县 | 513300 |
| 513329 | 新龙县 | 513300 |
| 513330 | 德格县 | 513300 |
| 513331 | 白玉县 | 513300 |
| 513332 | 石渠县 | 513300 |
| 513333 | 色达县 | 513300 |
| 513334 | 理塘县 | 513300 |
| 513335 | 巴塘县 | 513300 |
| 513336 | 乡城县 | 513300 |
| 513337 | 稻城县 | 513300 |
| 513338 | 得荣县 | 513300 |
| 513401 | 西昌市 | 513400 |
| 513422 | 木里藏族自治县 | 513400 |
| 513423 | 盐源县 | 513400 |
| 513424 | 德昌县 | 513400 |
| 513425 | 会理县 | 513400 |
| 513426 | 会东县 | 513400 |
| 513427 | 宁南县 | 513400 |
| 513428 | 普格县 | 513400 |
| 513429 | 布拖县 | 513400 |
| 513430 | 金阳县 | 513400 |
| 513431 | 昭觉县 | 513400 |
| 513432 | 喜德县 | 513400 |
| 513433 | 冕宁县 | 513400 |
| 513434 | 越西县 | 513400 |
| 513435 | 甘洛县 | 513400 |
| 513436 | 美姑县 | 513400 |
| 513437 | 雷波县 | 513400 |
| 520102 | 南明区 | 520100 |
| 520103 | 云岩区 | 520100 |
| 520111 | 花溪区 | 520100 |
| 520112 | 乌当区 | 520100 |
| 520113 | 白云区 | 520100 |
| 520115 | 观山湖区 | 520100 |
| 520121 | 开阳县 | 520100 |
| 520122 | 息烽县 | 520100 |
| 520123 | 修文县 | 520100 |
| 520181 | 清镇市 | 520100 |
| 520201 | 钟山区 | 520200 |
| 520203 | 六枝特区 | 520200 |
| 520221 | 水城县 | 520200 |
| 520281 | 盘州市 | 520200 |
| 520302 | 红花岗区 | 520300 |
| 520303 | 汇川区 | 520300 |
| 520304 | 播州区 | 520300 |
| 520322 | 桐梓县 | 520300 |
| 520323 | 绥阳县 | 520300 |
| 520324 | 正安县 | 520300 |
| 520325 | 道真仡佬族苗族自治县 | 520300 |
| 520326 | 务川仡佬族苗族自治县 | 520300 |
| 520327 | 凤冈县 | 520300 |
| 520328 | 湄潭县 | 520300 |
| 520329 | 余庆县 | 520300 |
| 520330 | 习水县 | 520300 |
| 520381 | 赤水市 | 520300 |
| 520382 | 仁怀市 | 520300 |
| 520402 | 西秀区 | 520400 |
| 520403 | 平坝区 | 520400 |
| 520422 | 普定县 | 520400 |
| 520423 | 镇宁布依族苗族自治县 | 520400 |
| 520424 | 关岭布依族苗族自治县 | 520400 |
| 520425 | 紫云苗族布依族自治县 | 520400 |
| 520502 | 七星关区 | 520500 |
| 520521 | 大方县 | 520500 |
| 520522 | 黔西县 | 520500 |
| 520523 | 金沙县 | 520500 |
| 520524 | 织金县 | 520500 |
| 520525 | 纳雍县 | 520500 |
| 520526 | 威宁彝族回族苗族自治县 | 520500 |
| 520527 | 赫章县 | 520500 |
| 520602 | 碧江区 | 520600 |
| 520603 | 万山区 | 520600 |
| 520621 | 江口县 | 520600 |
| 520622 | 玉屏侗族自治县 | 520600 |
| 520623 | 石阡县 | 520600 |
| 520624 | 思南县 | 520600 |
| 520625 | 印江土家族苗族自治县 | 520600 |
| 520626 | 德江县 | 520600 |
| 520627 | 沿河土家族自治县 | 520600 |
| 520628 | 松桃苗族自治县 | 520600 |
| 522301 | 兴义市 | 522300 |
| 522322 | 兴仁市 | 522300 |
| 522323 | 普安县 | 522300 |
| 522324 | 晴隆县 | 522300 |
| 522325 | 贞丰县 | 522300 |
| 522326 | 望谟县 | 522300 |
| 522327 | 册亨县 | 522300 |
| 522328 | 安龙县 | 522300 |
| 522601 | 凯里市 | 522600 |
| 522622 | 黄平县 | 522600 |
| 522623 | 施秉县 | 522600 |
| 522624 | 三穗县 | 522600 |
| 522625 | 镇远县 | 522600 |
| 522626 | 岑巩县 | 522600 |
| 522627 | 天柱县 | 522600 |
| 522628 | 锦屏县 | 522600 |
| 522629 | 剑河县 | 522600 |
| 522630 | 台江县 | 522600 |
| 522631 | 黎平县 | 522600 |
| 522632 | 榕江县 | 522600 |
| 522633 | 从江县 | 522600 |
| 522634 | 雷山县 | 522600 |
| 522635 | 麻江县 | 522600 |
| 522636 | 丹寨县 | 522600 |
| 522701 | 都匀市 | 522700 |
| 522702 | 福泉市 | 522700 |
| 522722 | 荔波县 | 522700 |
| 522723 | 贵定县 | 522700 |
| 522725 | 瓮安县 | 522700 |
| 522726 | 独山县 | 522700 |
| 522727 | 平塘县 | 522700 |
| 522728 | 罗甸县 | 522700 |
| 522729 | 长顺县 | 522700 |
| 522730 | 龙里县 | 522700 |
| 522731 | 惠水县 | 522700 |
| 522732 | 三都水族自治县 | 522700 |
| 530102 | 五华区 | 530100 |
| 530103 | 盘龙区 | 530100 |
| 530111 | 官渡区 | 530100 |
| 530112 | 西山区 | 530100 |
| 530113 | 东川区 | 530100 |
| 530114 | 呈贡区 | 530100 |
| 530115 | 晋宁区 | 530100 |
| 530124 | 富民县 | 530100 |
| 530125 | 宜良县 | 530100 |
| 530126 | 石林彝族自治县 | 530100 |
| 530127 | 嵩明县 | 530100 |
| 530128 | 禄劝彝族苗族自治县 | 530100 |
| 530129 | 寻甸回族彝族自治县 | 530100 |
| 530181 | 安宁市 | 530100 |
| 530302 | 麒麟区 | 530300 |
| 530303 | 沾益区 | 530300 |
| 530321 | 马龙区 | 530300 |
| 530322 | 陆良县 | 530300 |
| 530323 | 师宗县 | 530300 |
| 530324 | 罗平县 | 530300 |
| 530325 | 富源县 | 530300 |
| 530326 | 会泽县 | 530300 |
| 530381 | 宣威市 | 530300 |
| 530402 | 红塔区 | 530400 |
| 530403 | 江川区 | 530400 |
| 530422 | 澄江市 | 530400 |
| 530423 | 通海县 | 530400 |
| 530424 | 华宁县 | 530400 |
| 530425 | 易门县 | 530400 |
| 530426 | 峨山彝族自治县 | 530400 |
| 530427 | 新平彝族傣族自治县 | 530400 |
| 530428 | 元江哈尼族彝族傣族自治县 | 530400 |
| 530502 | 隆阳区 | 530500 |
| 530521 | 施甸县 | 530500 |
| 530523 | 龙陵县 | 530500 |
| 530524 | 昌宁县 | 530500 |
| 530581 | 腾冲市 | 530500 |
| 530602 | 昭阳区 | 530600 |
| 530621 | 鲁甸县 | 530600 |
| 530622 | 巧家县 | 530600 |
| 530623 | 盐津县 | 530600 |
| 530624 | 大关县 | 530600 |
| 530625 | 永善县 | 530600 |
| 530626 | 绥江县 | 530600 |
| 530627 | 镇雄县 | 530600 |
| 530628 | 彝良县 | 530600 |
| 530629 | 威信县 | 530600 |
| 530630 | 水富市 | 530600 |
| 530702 | 古城区 | 530700 |
| 530721 | 玉龙纳西族自治县 | 530700 |
| 530722 | 永胜县 | 530700 |
| 530723 | 华坪县 | 530700 |
| 530724 | 宁蒗彝族自治县 | 530700 |
| 530802 | 思茅区 | 530800 |
| 530821 | 宁洱哈尼族彝族自治县 | 530800 |
| 530822 | 墨江哈尼族自治县 | 530800 |
| 530823 | 景东彝族自治县 | 530800 |
| 530824 | 景谷傣族彝族自治县 | 530800 |
| 530825 | 镇沅彝族哈尼族拉祜族自治县 | 530800 |
| 530826 | 江城哈尼族彝族自治县 | 530800 |
| 530827 | 孟连傣族拉祜族佤族自治县 | 530800 |
| 530828 | 澜沧拉祜族自治县 | 530800 |
| 530829 | 西盟佤族自治县 | 530800 |
| 530902 | 临翔区 | 530900 |
| 530921 | 凤庆县 | 530900 |
| 530922 | 云县 | 530900 |
| 530923 | 永德县 | 530900 |
| 530924 | 镇康县 | 530900 |
| 530925 | 双江拉祜族佤族布朗族傣族自治县 | 530900 |
| 530926 | 耿马傣族佤族自治县 | 530900 |
| 530927 | 沧源佤族自治县 | 530900 |
| 532301 | 楚雄市 | 532300 |
| 532322 | 双柏县 | 532300 |
| 532323 | 牟定县 | 532300 |
| 532324 | 南华县 | 532300 |
| 532325 | 姚安县 | 532300 |
| 532326 | 大姚县 | 532300 |
| 532327 | 永仁县 | 532300 |
| 532328 | 元谋县 | 532300 |
| 532329 | 武定县 | 532300 |
| 532331 | 禄丰县 | 532300 |
| 532501 | 个旧市 | 532500 |
| 532502 | 开远市 | 532500 |
| 532503 | 蒙自市 | 532500 |
| 532504 | 弥勒市 | 532500 |
| 532523 | 屏边苗族自治县 | 532500 |
| 532524 | 建水县 | 532500 |
| 532525 | 石屏县 | 532500 |
| 532527 | 泸西县 | 532500 |
| 532528 | 元阳县 | 532500 |
| 532529 | 红河县 | 532500 |
| 532530 | 金平苗族瑶族傣族自治县 | 532500 |
| 532531 | 绿春县 | 532500 |
| 532532 | 河口瑶族自治县 | 532500 |
| 532601 | 文山市 | 532600 |
| 532622 | 砚山县 | 532600 |
| 532623 | 西畴县 | 532600 |
| 532624 | 麻栗坡县 | 532600 |
| 532625 | 马关县 | 532600 |
| 532626 | 丘北县 | 532600 |
| 532627 | 广南县 | 532600 |
| 532628 | 富宁县 | 532600 |
| 532801 | 景洪市 | 532800 |
| 532822 | 勐海县 | 532800 |
| 532823 | 勐腊县 | 532800 |
| 532901 | 大理市 | 532900 |
| 532922 | 漾濞彝族自治县 | 532900 |
| 532923 | 祥云县 | 532900 |
| 532924 | 宾川县 | 532900 |
| 532925 | 弥渡县 | 532900 |
| 532926 | 南涧彝族自治县 | 532900 |
| 532927 | 巍山彝族回族自治县 | 532900 |
| 532928 | 永平县 | 532900 |
| 532929 | 云龙县 | 532900 |
| 532930 | 洱源县 | 532900 |
| 532931 | 剑川县 | 532900 |
| 532932 | 鹤庆县 | 532900 |
| 533102 | 瑞丽市 | 533100 |
| 533103 | 芒市 | 533100 |
| 533122 | 梁河县 | 533100 |
| 533123 | 盈江县 | 533100 |
| 533124 | 陇川县 | 533100 |
| 533301 | 泸水市 | 533300 |
| 533323 | 福贡县 | 533300 |
| 533324 | 贡山独龙族怒族自治县 | 533300 |
| 533325 | 兰坪白族普米族自治县 | 533300 |
| 533401 | 香格里拉市 | 533400 |
| 533422 | 德钦县 | 533400 |
| 533423 | 维西傈僳族自治县 | 533400 |
| 540102 | 城关区 | 540100 |
| 540103 | 堆龙德庆区 | 540100 |
| 540104 | 达孜区 | 540100 |
| 540121 | 林周县 | 540100 |
| 540122 | 当雄县 | 540100 |
| 540123 | 尼木县 | 540100 |
| 540124 | 曲水县 | 540100 |
| 540127 | 墨竹工卡县 | 540100 |
| 540202 | 桑珠孜区 | 540200 |
| 540221 | 南木林县 | 540200 |
| 540222 | 江孜县 | 540200 |
| 540223 | 定日县 | 540200 |
| 540224 | 萨迦县 | 540200 |
| 540225 | 拉孜县 | 540200 |
| 540226 | 昂仁县 | 540200 |
| 540227 | 谢通门县 | 540200 |
| 540228 | 白朗县 | 540200 |
| 540229 | 仁布县 | 540200 |
| 540230 | 康马县 | 540200 |
| 540231 | 定结县 | 540200 |
| 540232 | 仲巴县 | 540200 |
| 540233 | 亚东县 | 540200 |
| 540234 | 吉隆县 | 540200 |
| 540235 | 聂拉木县 | 540200 |
| 540236 | 萨嘎县 | 540200 |
| 540237 | 岗巴县 | 540200 |
| 540302 | 卡若区 | 540300 |
| 540321 | 江达县 | 540300 |
| 540322 | 贡觉县 | 540300 |
| 540323 | 类乌齐县 | 540300 |
| 540324 | 丁青县 | 540300 |
| 540325 | 察雅县 | 540300 |
| 540326 | 八宿县 | 540300 |
| 540327 | 左贡县 | 540300 |
| 540328 | 芒康县 | 540300 |
| 540329 | 洛隆县 | 540300 |
| 540330 | 边坝县 | 540300 |
| 540402 | 巴宜区 | 540400 |
| 540421 | 工布江达县 | 540400 |
| 540422 | 米林县 | 540400 |
| 540423 | 墨脱县 | 540400 |
| 540424 | 波密县 | 540400 |
| 540425 | 察隅县 | 540400 |
| 540426 | 朗县 | 540400 |
| 540502 | 乃东区 | 540500 |
| 540521 | 扎囊县 | 540500 |
| 540522 | 贡嘎县 | 540500 |
| 540523 | 桑日县 | 540500 |
| 540524 | 琼结县 | 540500 |
| 540525 | 曲松县 | 540500 |
| 540526 | 措美县 | 540500 |
| 540527 | 洛扎县 | 540500 |
| 540528 | 加查县 | 540500 |
| 540529 | 隆子县 | 540500 |
| 540530 | 错那县 | 540500 |
| 540531 | 浪卡子县 | 540500 |
| 540602 | 色尼区 | 540600 |
| 540621 | 嘉黎县 | 540600 |
| 540622 | 比如县 | 540600 |
| 540623 | 聂荣县 | 540600 |
| 540624 | 安多县 | 540600 |
| 540625 | 申扎县 | 540600 |
| 540626 | 索县 | 540600 |
| 540627 | 班戈县 | 540600 |
| 540628 | 巴青县 | 540600 |
| 540629 | 尼玛县 | 540600 |
| 540630 | 双湖县 | 540600 |
| 542521 | 普兰县 | 542500 |
| 542522 | 札达县 | 542500 |
| 542523 | 噶尔县 | 542500 |
| 542524 | 日土县 | 542500 |
| 542525 | 革吉县 | 542500 |
| 542526 | 改则县 | 542500 |
| 542527 | 措勤县 | 542500 |
| 610102 | 新城区 | 610100 |
| 610103 | 碑林区 | 610100 |
| 610104 | 莲湖区 | 610100 |
| 610111 | 灞桥区 | 610100 |
| 610112 | 未央区 | 610100 |
| 610113 | 雁塔区 | 610100 |
| 610114 | 阎良区 | 610100 |
| 610115 | 临潼区 | 610100 |
| 610116 | 长安区 | 610100 |
| 610117 | 高陵区 | 610100 |
| 610118 | 鄠邑区 | 610100 |
| 610122 | 蓝田县 | 610100 |
| 610124 | 周至县 | 610100 |
| 610202 | 王益区 | 610200 |
| 610203 | 印台区 | 610200 |
| 610204 | 耀州区 | 610200 |
| 610222 | 宜君县 | 610200 |
| 610302 | 渭滨区 | 610300 |
| 610303 | 金台区 | 610300 |
| 610304 | 陈仓区 | 610300 |
| 610322 | 凤翔县 | 610300 |
| 610323 | 岐山县 | 610300 |
| 610324 | 扶风县 | 610300 |
| 610326 | 眉县 | 610300 |
| 610327 | 陇县 | 610300 |
| 610328 | 千阳县 | 610300 |
| 610329 | 麟游县 | 610300 |
| 610330 | 凤县 | 610300 |
| 610331 | 太白县 | 610300 |
| 610402 | 秦都区 | 610400 |
| 610403 | 杨陵区 | 610400 |
| 610404 | 渭城区 | 610400 |
| 610422 | 三原县 | 610400 |
| 610423 | 泾阳县 | 610400 |
| 610424 | 乾县 | 610400 |
| 610425 | 礼泉县 | 610400 |
| 610426 | 永寿县 | 610400 |
| 610428 | 长武县 | 610400 |
| 610429 | 旬邑县 | 610400 |
| 610430 | 淳化县 | 610400 |
| 610431 | 武功县 | 610400 |
| 610481 | 兴平市 | 610400 |
| 610482 | 彬州市 | 610400 |
| 610502 | 临渭区 | 610500 |
| 610503 | 华州区 | 610500 |
| 610522 | 潼关县 | 610500 |
| 610523 | 大荔县 | 610500 |
| 610524 | 合阳县 | 610500 |
| 610525 | 澄城县 | 610500 |
| 610526 | 蒲城县 | 610500 |
| 610527 | 白水县 | 610500 |
| 610528 | 富平县 | 610500 |
| 610581 | 韩城市 | 610500 |
| 610582 | 华阴市 | 610500 |
| 610602 | 宝塔区 | 610600 |
| 610603 | 安塞区 | 610600 |
| 610621 | 延长县 | 610600 |
| 610622 | 延川县 | 610600 |
| 610623 | 子长市 | 610600 |
| 610625 | 志丹县 | 610600 |
| 610626 | 吴起县 | 610600 |
| 610627 | 甘泉县 | 610600 |
| 610628 | 富县 | 610600 |
| 610629 | 洛川县 | 610600 |
| 610630 | 宜川县 | 610600 |
| 610631 | 黄龙县 | 610600 |
| 610632 | 黄陵县 | 610600 |
| 610702 | 汉台区 | 610700 |
| 610703 | 南郑区 | 610700 |
| 610722 | 城固县 | 610700 |
| 610723 | 洋县 | 610700 |
| 610724 | 西乡县 | 610700 |
| 610725 | 勉县 | 610700 |
| 610726 | 宁强县 | 610700 |
| 610727 | 略阳县 | 610700 |
| 610728 | 镇巴县 | 610700 |
| 610729 | 留坝县 | 610700 |
| 610730 | 佛坪县 | 610700 |
| 610802 | 榆阳区 | 610800 |
| 610803 | 横山区 | 610800 |
| 610822 | 府谷县 | 610800 |
| 610824 | 靖边县 | 610800 |
| 610825 | 定边县 | 610800 |
| 610826 | 绥德县 | 610800 |
| 610827 | 米脂县 | 610800 |
| 610828 | 佳县 | 610800 |
| 610829 | 吴堡县 | 610800 |
| 610830 | 清涧县 | 610800 |
| 610831 | 子洲县 | 610800 |
| 610881 | 神木市 | 610800 |
| 610902 | 汉滨区 | 610900 |
| 610921 | 汉阴县 | 610900 |
| 610922 | 石泉县 | 610900 |
| 610923 | 宁陕县 | 610900 |
| 610924 | 紫阳县 | 610900 |
| 610925 | 岚皋县 | 610900 |
| 610926 | 平利县 | 610900 |
| 610927 | 镇坪县 | 610900 |
| 610928 | 旬阳县 | 610900 |
| 610929 | 白河县 | 610900 |
| 611002 | 商州区 | 611000 |
| 611021 | 洛南县 | 611000 |
| 611022 | 丹凤县 | 611000 |
| 611023 | 商南县 | 611000 |
| 611024 | 山阳县 | 611000 |
| 611025 | 镇安县 | 611000 |
| 611026 | 柞水县 | 611000 |
| 620102 | 城关区 | 620100 |
| 620103 | 七里河区 | 620100 |
| 620104 | 西固区 | 620100 |
| 620105 | 安宁区 | 620100 |
| 620111 | 红古区 | 620100 |
| 620121 | 永登县 | 620100 |
| 620122 | 皋兰县 | 620100 |
| 620123 | 榆中县 | 620100 |
| 620302 | 金川区 | 620300 |
| 620321 | 永昌县 | 620300 |
| 620402 | 白银区 | 620400 |
| 620403 | 平川区 | 620400 |
| 620421 | 靖远县 | 620400 |
| 620422 | 会宁县 | 620400 |
| 620423 | 景泰县 | 620400 |
| 620502 | 秦州区 | 620500 |
| 620503 | 麦积区 | 620500 |
| 620521 | 清水县 | 620500 |
| 620522 | 秦安县 | 620500 |
| 620523 | 甘谷县 | 620500 |
| 620524 | 武山县 | 620500 |
| 620525 | 张家川回族自治县 | 620500 |
| 620602 | 凉州区 | 620600 |
| 620621 | 民勤县 | 620600 |
| 620622 | 古浪县 | 620600 |
| 620623 | 天祝藏族自治县 | 620600 |
| 620702 | 甘州区 | 620700 |
| 620721 | 肃南裕固族自治县 | 620700 |
| 620722 | 民乐县 | 620700 |
| 620723 | 临泽县 | 620700 |
| 620724 | 高台县 | 620700 |
| 620725 | 山丹县 | 620700 |
| 620802 | 崆峒区 | 620800 |
| 620821 | 泾川县 | 620800 |
| 620822 | 灵台县 | 620800 |
| 620823 | 崇信县 | 620800 |
| 620824 | 华亭市 | 620800 |
| 620825 | 庄浪县 | 620800 |
| 620826 | 静宁县 | 620800 |
| 620902 | 肃州区 | 620900 |
| 620921 | 金塔县 | 620900 |
| 620922 | 瓜州县 | 620900 |
| 620923 | 肃北蒙古族自治县 | 620900 |
| 620924 | 阿克塞哈萨克族自治县 | 620900 |
| 620981 | 玉门市 | 620900 |
| 620982 | 敦煌市 | 620900 |
| 621002 | 西峰区 | 621000 |
| 621021 | 庆城县 | 621000 |
| 621022 | 环县 | 621000 |
| 621023 | 华池县 | 621000 |
| 621024 | 合水县 | 621000 |
| 621025 | 正宁县 | 621000 |
| 621026 | 宁县 | 621000 |
| 621027 | 镇原县 | 621000 |
| 621102 | 安定区 | 621100 |
| 621121 | 通渭县 | 621100 |
| 621122 | 陇西县 | 621100 |
| 621123 | 渭源县 | 621100 |
| 621124 | 临洮县 | 621100 |
| 621125 | 漳县 | 621100 |
| 621126 | 岷县 | 621100 |
| 621202 | 武都区 | 621200 |
| 621221 | 成县 | 621200 |
| 621222 | 文县 | 621200 |
| 621223 | 宕昌县 | 621200 |
| 621224 | 康县 | 621200 |
| 621225 | 西和县 | 621200 |
| 621226 | 礼县 | 621200 |
| 621227 | 徽县 | 621200 |
| 621228 | 两当县 | 621200 |
| 622901 | 临夏市 | 622900 |
| 622921 | 临夏县 | 622900 |
| 622922 | 康乐县 | 622900 |
| 622923 | 永靖县 | 622900 |
| 622924 | 广河县 | 622900 |
| 622925 | 和政县 | 622900 |
| 622926 | 东乡族自治县 | 622900 |
| 622927 | 积石山保安族东乡族撒拉族自治县 | 622900 |
| 623001 | 合作市 | 623000 |
| 623021 | 临潭县 | 623000 |
| 623022 | 卓尼县 | 623000 |
| 623023 | 舟曲县 | 623000 |
| 623024 | 迭部县 | 623000 |
| 623025 | 玛曲县 | 623000 |
| 623026 | 碌曲县 | 623000 |
| 623027 | 夏河县 | 623000 |
| 630102 | 城东区 | 630100 |
| 630103 | 城中区 | 630100 |
| 630104 | 城西区 | 630100 |
| 630105 | 城北区 | 630100 |
| 630121 | 大通回族土族自治县 | 630100 |
| 630122 | 湟中区 | 630100 |
| 630123 | 湟源县 | 630100 |
| 630202 | 乐都区 | 630200 |
| 630203 | 平安区 | 630200 |
| 630222 | 民和回族土族自治县 | 630200 |
| 630223 | 互助土族自治县 | 630200 |
| 630224 | 化隆回族自治县 | 630200 |
| 630225 | 循化撒拉族自治县 | 630200 |
| 632221 | 门源回族自治县 | 632200 |
| 632222 | 祁连县 | 632200 |
| 632223 | 海晏县 | 632200 |
| 632224 | 刚察县 | 632200 |
| 632321 | 同仁县 | 632300 |
| 632322 | 尖扎县 | 632300 |
| 632323 | 泽库县 | 632300 |
| 632324 | 河南蒙古族自治县 | 632300 |
| 632521 | 共和县 | 632500 |
| 632522 | 同德县 | 632500 |
| 632523 | 贵德县 | 632500 |
| 632524 | 兴海县 | 632500 |
| 632525 | 贵南县 | 632500 |
| 632621 | 玛沁县 | 632600 |
| 632622 | 班玛县 | 632600 |
| 632623 | 甘德县 | 632600 |
| 632624 | 达日县 | 632600 |
| 632625 | 久治县 | 632600 |
| 632626 | 玛多县 | 632600 |
| 632701 | 玉树市 | 632700 |
| 632722 | 杂多县 | 632700 |
| 632723 | 称多县 | 632700 |
| 632724 | 治多县 | 632700 |
| 632725 | 囊谦县 | 632700 |
| 632726 | 曲麻莱县 | 632700 |
| 632801 | 格尔木市 | 632800 |
| 632802 | 德令哈市 | 632800 |
| 632821 | 乌兰县 | 632800 |
| 632822 | 都兰县 | 632800 |
| 632823 | 天峻县 | 632800 |
| 640104 | 兴庆区 | 640100 |
| 640105 | 西夏区 | 640100 |
| 640106 | 金凤区 | 640100 |
| 640121 | 永宁县 | 640100 |
| 640122 | 贺兰县 | 640100 |
| 640181 | 灵武市 | 640100 |
| 640202 | 大武口区 | 640200 |
| 640205 | 惠农区 | 640200 |
| 640221 | 平罗县 | 640200 |
| 640302 | 利通区 | 640300 |
| 640303 | 红寺堡区 | 640300 |
| 640323 | 盐池县 | 640300 |
| 640324 | 同心县 | 640300 |
| 640381 | 青铜峡市 | 640300 |
| 640402 | 原州区 | 640400 |
| 640422 | 西吉县 | 640400 |
| 640423 | 隆德县 | 640400 |
| 640424 | 泾源县 | 640400 |
| 640425 | 彭阳县 | 640400 |
| 640502 | 沙坡头区 | 640500 |
| 640521 | 中宁县 | 640500 |
| 640522 | 海原县 | 640500 |
| 650102 | 天山区 | 650100 |
| 650103 | 沙依巴克区 | 650100 |
| 650104 | 新市区 | 650100 |
| 650105 | 水磨沟区 | 650100 |
| 650106 | 头屯河区 | 650100 |
| 650107 | 达坂城区 | 650100 |
| 650109 | 米东区 | 650100 |
| 650121 | 乌鲁木齐县 | 650100 |
| 650202 | 独山子区 | 650200 |
| 650203 | 克拉玛依区 | 650200 |
| 650204 | 白碱滩区 | 650200 |
| 650205 | 乌尔禾区 | 650200 |
| 650402 | 高昌区 | 650400 |
| 650421 | 鄯善县 | 650400 |
| 650422 | 托克逊县 | 650400 |
| 650502 | 伊州区 | 650500 |
| 650521 | 巴里坤哈萨克自治县 | 650500 |
| 650522 | 伊吾县 | 650500 |
| 652301 | 昌吉市 | 652300 |
| 652302 | 阜康市 | 652300 |
| 652323 | 呼图壁县 | 652300 |
| 652324 | 玛纳斯县 | 652300 |
| 652325 | 奇台县 | 652300 |
| 652327 | 吉木萨尔县 | 652300 |
| 652328 | 木垒哈萨克自治县 | 652300 |
| 652701 | 博乐市 | 652700 |
| 652702 | 阿拉山口市 | 652700 |
| 652722 | 精河县 | 652700 |
| 652723 | 温泉县 | 652700 |
| 652801 | 库尔勒市 | 652800 |
| 652822 | 轮台县 | 652800 |
| 652823 | 尉犁县 | 652800 |
| 652824 | 若羌县 | 652800 |
| 652825 | 且末县 | 652800 |
| 652826 | 焉耆回族自治县 | 652800 |
| 652827 | 和静县 | 652800 |
| 652828 | 和硕县 | 652800 |
| 652829 | 博湖县 | 652800 |
| 652901 | 阿克苏市 | 652900 |
| 652922 | 温宿县 | 652900 |
| 652923 | 库车市 | 652900 |
| 652924 | 沙雅县 | 652900 |
| 652925 | 新和县 | 652900 |
| 652926 | 拜城县 | 652900 |
| 652927 | 乌什县 | 652900 |
| 652928 | 阿瓦提县 | 652900 |
| 652929 | 柯坪县 | 652900 |
| 653001 | 阿图什市 | 653000 |
| 653022 | 阿克陶县 | 653000 |
| 653023 | 阿合奇县 | 653000 |
| 653024 | 乌恰县 | 653000 |
| 653101 | 喀什市 | 653100 |
| 653121 | 疏附县 | 653100 |
| 653122 | 疏勒县 | 653100 |
| 653123 | 英吉沙县 | 653100 |
| 653124 | 泽普县 | 653100 |
| 653125 | 莎车县 | 653100 |
| 653126 | 叶城县 | 653100 |
| 653127 | 麦盖提县 | 653100 |
| 653128 | 岳普湖县 | 653100 |
| 653129 | 伽师县 | 653100 |
| 653130 | 巴楚县 | 653100 |
| 653131 | 塔什库尔干塔吉克自治县 | 653100 |
| 653201 | 和田市 | 653200 |
| 653221 | 和田县 | 653200 |
| 653222 | 墨玉县 | 653200 |
| 653223 | 皮山县 | 653200 |
| 653224 | 洛浦县 | 653200 |
| 653225 | 策勒县 | 653200 |
| 653226 | 于田县 | 653200 |
| 653227 | 民丰县 | 653200 |
| 654002 | 伊宁市 | 654000 |
| 654003 | 奎屯市 | 654000 |
| 654004 | 霍尔果斯市 | 654000 |
| 654021 | 伊宁县 | 654000 |
| 654022 | 察布查尔锡伯自治县 | 654000 |
| 654023 | 霍城县 | 654000 |
| 654024 | 巩留县 | 654000 |
| 654025 | 新源县 | 654000 |
| 654026 | 昭苏县 | 654000 |
| 654027 | 特克斯县 | 654000 |
| 654028 | 尼勒克县 | 654000 |
| 654201 | 塔城市 | 654200 |
| 654202 | 乌苏市 | 654200 |
| 654221 | 额敏县 | 654200 |
| 654223 | 沙湾县 | 654200 |
| 654224 | 托里县 | 654200 |
| 654225 | 裕民县 | 654200 |
| 654226 | 和布克赛尔蒙古自治县 | 654200 |
| 654301 | 阿勒泰市 | 654300 |
| 654321 | 布尔津县 | 654300 |
| 654322 | 富蕴县 | 654300 |
| 654323 | 福海县 | 654300 |
| 654324 | 哈巴河县 | 654300 |
| 654325 | 青河县 | 654300 |
| 654326 | 吉木乃县 | 654300 |
| 710101 | 中正区 | 710100 |
| 710102 | 大同区 | 710100 |
| 710103 | 中山区 | 710100 |
| 710104 | 万华区 | 710100 |
| 710105 | 信义区 | 710100 |
| 710106 | 松山区 | 710100 |
| 710107 | 大安区 | 710100 |
| 710108 | 南港区 | 710100 |
| 710109 | 北投区 | 710100 |
| 710110 | 内湖区 | 710100 |
| 710111 | 士林区 | 710100 |
| 710112 | 文山区 | 710100 |
| 710201 | 板桥区 | 710200 |
| 710202 | 土城区 | 710200 |
| 710203 | 新庄区 | 710200 |
| 710204 | 新店区 | 710200 |
| 710205 | 深坑区 | 710200 |
| 710206 | 石碇区 | 710200 |
| 710207 | 坪林区 | 710200 |
| 710208 | 乌来区 | 710200 |
| 710209 | 五股区 | 710200 |
| 710210 | 八里区 | 710200 |
| 710211 | 林口区 | 710200 |
| 710212 | 淡水区 | 710200 |
| 710213 | 中和区 | 710200 |
| 710214 | 永和区 | 710200 |
| 710215 | 三重区 | 710200 |
| 710216 | 芦洲区 | 710200 |
| 710217 | 泰山区 | 710200 |
| 710218 | 树林区 | 710200 |
| 710219 | 莺歌区 | 710200 |
| 710220 | 三峡区 | 710200 |
| 710221 | 汐止区 | 710200 |
| 710222 | 金山区 | 710200 |
| 710223 | 万里区 | 710200 |
| 710224 | 三芝区 | 710200 |
| 710225 | 石门区 | 710200 |
| 710226 | 瑞芳区 | 710200 |
| 710227 | 贡寮区 | 710200 |
| 710228 | 双溪区 | 710200 |
| 710229 | 平溪区 | 710200 |
| 710301 | 桃园区 | 710300 |
| 710302 | 中坜区 | 710300 |
| 710303 | 平镇区 | 710300 |
| 710304 | 八德区 | 710300 |
| 710305 | 杨梅区 | 710300 |
| 710306 | 芦竹区 | 710300 |
| 710307 | 大溪区 | 710300 |
| 710308 | 龙潭区 | 710300 |
| 710309 | 龟山区 | 710300 |
| 710310 | 大园区 | 710300 |
| 710311 | 观音区 | 710300 |
| 710312 | 新屋区 | 710300 |
| 710313 | 复兴区 | 710300 |
| 710401 | 中区 | 710400 |
| 710402 | 东区 | 710400 |
| 710403 | 西区 | 710400 |
| 710404 | 南区 | 710400 |
| 710405 | 北区 | 710400 |
| 710406 | 西屯区 | 710400 |
| 710407 | 南屯区 | 710400 |
| 710408 | 北屯区 | 710400 |
| 710409 | 丰原区 | 710400 |
| 710410 | 大里区 | 710400 |
| 710411 | 太平区 | 710400 |
| 710412 | 东势区 | 710400 |
| 710413 | 大甲区 | 710400 |
| 710414 | 清水区 | 710400 |
| 710415 | 沙鹿区 | 710400 |
| 710416 | 梧栖区 | 710400 |
| 710417 | 后里区 | 710400 |
| 710418 | 神冈区 | 710400 |
| 710419 | 潭子区 | 710400 |
| 710420 | 大雅区 | 710400 |
| 710421 | 新小区 | 710400 |
| 710422 | 石冈区 | 710400 |
| 710423 | 外埔区 | 710400 |
| 710424 | 大安区 | 710400 |
| 710425 | 乌日区 | 710400 |
| 710426 | 大肚区 | 710400 |
| 710427 | 龙井区 | 710400 |
| 710428 | 雾峰区 | 710400 |
| 710429 | 和平区 | 710400 |
| 710501 | 中西区 | 710500 |
| 710502 | 东区 | 710500 |
| 710503 | 南区 | 710500 |
| 710504 | 北区 | 710500 |
| 710505 | 安平区 | 710500 |
| 710506 | 安南区 | 710500 |
| 710507 | 永康区 | 710500 |
| 710508 | 归仁区 | 710500 |
| 710509 | 新化区 | 710500 |
| 710510 | 左镇区 | 710500 |
| 710511 | 玉井区 | 710500 |
| 710512 | 楠西区 | 710500 |
| 710513 | 南化区 | 710500 |
| 710514 | 仁德区 | 710500 |
| 710515 | 关庙区 | 710500 |
| 710516 | 龙崎区 | 710500 |
| 710517 | 官田区 | 710500 |
| 710518 | 麻豆区 | 710500 |
| 710519 | 佳里区 | 710500 |
| 710520 | 西港区 | 710500 |
| 710521 | 七股区 | 710500 |
| 710522 | 将军区 | 710500 |
| 710523 | 学甲区 | 710500 |
| 710524 | 北门区 | 710500 |
| 710525 | 新营区 | 710500 |
| 710526 | 后壁区 | 710500 |
| 710527 | 白河区 | 710500 |
| 710528 | 东山区 | 710500 |
| 710529 | 六甲区 | 710500 |
| 710530 | 下营区 | 710500 |
| 710531 | 柳营区 | 710500 |
| 710532 | 盐水区 | 710500 |
| 710533 | 善化区 | 710500 |
| 710534 | 大内区 | 710500 |
| 710535 | 山上区 | 710500 |
| 710536 | 新市区 | 710500 |
| 710537 | 安定区 | 710500 |
| 710601 | 楠梓区 | 710600 |
| 710602 | 左营区 | 710600 |
| 710603 | 鼓山区 | 710600 |
| 710604 | 三民区 | 710600 |
| 710605 | 盐埕区 | 710600 |
| 710606 | 前金区 | 710600 |
| 710607 | 新兴区 | 710600 |
| 710608 | 苓雅区 | 710600 |
| 710609 | 前镇区 | 710600 |
| 710610 | 旗津区 | 710600 |
| 710611 | 小港区 | 710600 |
| 710612 | 凤山区 | 710600 |
| 710613 | 大寮区 | 710600 |
| 710614 | 鸟松区 | 710600 |
| 710615 | 林园区 | 710600 |
| 710616 | 仁武区 | 710600 |
| 710617 | 大树区 | 710600 |
| 710618 | 大社区 | 710600 |
| 710619 | 冈山区 | 710600 |
| 710620 | 路竹区 | 710600 |
| 710621 | 桥头区 | 710600 |
| 710622 | 梓官区 | 710600 |
| 710623 | 弥陀区 | 710600 |
| 710624 | 永安区 | 710600 |
| 710625 | 燕巢区 | 710600 |
| 710626 | 阿莲区 | 710600 |
| 710627 | 茄萣区 | 710600 |
| 710628 | 湖内区 | 710600 |
| 710629 | 旗山区 | 710600 |
| 710630 | 美浓区 | 710600 |
| 710631 | 内门区 | 710600 |
| 710632 | 杉林区 | 710600 |
| 710633 | 甲仙区 | 710600 |
| 710634 | 六龟区 | 710600 |
| 710635 | 茂林区 | 710600 |
| 710636 | 桃源区 | 710600 |
| 710637 | 那玛夏区 | 710600 |
| 710701 | 中正区 | 710700 |
| 710702 | 七堵区 | 710700 |
| 710703 | 暖暖区 | 710700 |
| 710704 | 仁爱区 | 710700 |
| 710705 | 中山区 | 710700 |
| 710706 | 安乐区 | 710700 |
| 710707 | 信义区 | 710700 |
| 710801 | 东区 | 710800 |
| 710802 | 北区 | 710800 |
| 710803 | 香山区 | 710800 |
| 710901 | 东区 | 710900 |
| 710902 | 西区 | 710900 |
| 810101 | 中西区 | 810000 |
| 810102 | 湾仔区 | 810000 |
| 810103 | 东区 | 810000 |
| 810104 | 南区 | 810000 |
| 810105 | 油尖旺区 | 810000 |
| 810106 | 深水埗区 | 810000 |
| 810107 | 九龙城区 | 810000 |
| 810108 | 黄大仙区 | 810000 |
| 810109 | 观塘区 | 810000 |
| 810110 | 北区 | 810000 |
| 810111 | 大埔区 | 810000 |
| 810112 | 沙田区 | 810000 |
| 810113 | 西贡区 | 810000 |
| 810114 | 荃湾区 | 810000 |
| 810115 | 屯门区 | 810000 |
| 810116 | 元朗区 | 810000 |
| 810117 | 葵青区 | 810000 |
| 810118 | 离岛区 | 810000 |
| 820101 | 花地玛堂区 | 820000 |
| 820102 | 圣安多尼堂区 | 820000 |
| 820103 | 大堂区 | 820000 |
| 820104 | 望德堂区 | 820000 |
| 820105 | 风顺堂区 | 820000 |
| 820106 | 嘉模堂区 | 820000 |
| 820107 | 圣方济各堂区 | 820000 |
| 820108 | 路氹城 | 820000 |
| 820109 | 澳门新城 | 820000 |
| 441901 | 莞城区 | 441900 |
| 441902 | 南城区 | 441900 |
| 441903 | 东城区 | 441900 |
| 441904 | 万江区 | 441900 |
| 441905 | 石碣镇 | 441900 |
| 441906 | 石龙镇 | 441900 |
| 441907 | 茶山镇 | 441900 |
| 441908 | 石排镇 | 441900 |
| 441909 | 企石镇 | 441900 |
| 441910 | 横沥镇 | 441900 |
| 441911 | 桥头镇 | 441900 |
| 441912 | 谢岗镇 | 441900 |
| 441913 | 东坑镇 | 441900 |
| 441914 | 常平镇 | 441900 |
| 441915 | 寮步镇 | 441900 |
| 441916 | 大朗镇 | 441900 |
| 441917 | 麻涌镇 | 441900 |
| 441918 | 中堂镇 | 441900 |
| 441919 | 高埗镇 | 441900 |
| 441920 | 樟木头镇 | 441900 |
| 441921 | 大岭山镇 | 441900 |
| 441922 | 望牛墩镇 | 441900 |
| 441923 | 黄江镇 | 441900 |
| 441924 | 洪梅镇 | 441900 |
| 441925 | 清溪镇 | 441900 |
| 441926 | 沙田镇 | 441900 |
| 441927 | 道滘镇 | 441900 |
| 441928 | 塘厦镇 | 441900 |
| 441929 | 虎门镇 | 441900 |
| 441930 | 厚街镇 | 441900 |
| 441931 | 凤岗镇 | 441900 |
| 441932 | 长安镇 | 441900 |
| 441933 | 松山湖高新区 | 441900 |
| 442001 | 石岐区 | 442000 |
| 442002 | 东区 | 442000 |
| 442003 | 西区 | 442000 |
| 442004 | 南区 | 442000 |
| 442005 | 五桂山区 | 442000 |
| 442006 | 火炬开发区 | 442000 |
| 442007 | 黄圃镇 | 442000 |
| 442008 | 南头镇 | 442000 |
| 442009 | 东凤镇 | 442000 |
| 442010 | 阜沙镇 | 442000 |
| 442011 | 小榄镇 | 442000 |
| 442012 | 东升镇 | 442000 |
| 442013 | 古镇镇 | 442000 |
| 442014 | 横栏镇 | 442000 |
| 442015 | 三角镇 | 442000 |
| 442016 | 民众镇 | 442000 |
| 442017 | 南朗镇 | 442000 |
| 442018 | 港口镇 | 442000 |
| 442019 | 大涌镇 | 442000 |
| 442020 | 沙溪镇 | 442000 |
| 442021 | 三乡镇 | 442000 |
| 442022 | 板芙镇 | 442000 |
| 442023 | 神湾镇 | 442000 |
| 442024 | 坦洲镇 | 442000 |
| 422902 | 园林街道 | 422901 |
| 422903 | 广华街道 | 422901 |
| 422904 | 杨市街道 | 422901 |
| 422905 | 周矶街道 | 422901 |
| 422906 | 泰丰街道 | 422901 |
| 422907 | 高场街道 | 422901 |
| 422908 | 熊口镇 | 422901 |
| 422909 | 竹根滩镇 | 422901 |
| 422910 | 老新镇 | 422901 |
| 422911 | 王场镇 | 422901 |
| 422912 | 渔洋镇 | 422901 |
| 422913 | 龙湾镇 | 422901 |
| 422914 | 浩口镇 | 422901 |
| 422915 | 积玉口镇 | 422901 |
| 422916 | 张金镇 | 422901 |
| 422917 | 白鹭湖管理区 | 422901 |
| 422918 | 总口管理区 | 422901 |
| 422919 | 熊口农场管理区 | 422901 |
| 422920 | 运粮湖管理区 | 422901 |
| 422921 | 后湖管理区 | 422901 |
| 422922 | 周矶管理区 | 422901 |
| 460501 | 乐东黎族自治区 | 460500 |
| 460601 | 昌江黎族自治区 | 460600 |
| 421401 | 干河街道 | 421400 |
| 421402 | 龙华山街道 | 421400 |
| 421403 | 沙嘴街道 | 421400 |
| 421404 | 郑场镇 | 421400 |
| 421405 | 毛嘴镇 | 421400 |
| 421406 | 剅河镇 | 421400 |
| 421407 | 三伏潭镇 | 421400 |
| 421408 | 胡场镇 | 421400 |
| 421409 | 长埫口镇 | 421400 |
| 421410 | 西流河镇 | 421400 |
| 421411 | 彭场镇 | 421400 |
| 421412 | 沙湖镇 | 421400 |
| 421413 | 杨林尾镇 | 421400 |
| 421414 | 张沟镇 | 421400 |
| 421415 | 郭河镇 | 421400 |
| 421416 | 沔城回族镇 | 421400 |
| 421417 | 通海口镇 | 421400 |
| 421418 | 陈场镇 | 421400 |
| 421419 | 仙桃工业园区 | 421400 |
| 421420 | 九合垸原种场 | 421400 |
| 421421 | 沙湖原种场 | 421400 |
| 421422 | 五湖渔场 | 421400 |
| 421423 | 赵西垸林场 | 421400 |
| 421424 | 畜禽良种场 | 421400 |
| 421425 | 排湖风景区 | 421400 |
| 422923 | 高石碑镇 | 422901 |
| 422924 | 江汉石油管理局 | 422901 |
| 422925 | 潜江经济开发区 | 422901 |
| 421501 | 松柏镇 | 421500 |
| 421502 | 阳日镇 | 421500 |
| 421504 | 木鱼镇 | 421500 |
| 421505 | 红坪镇 | 421500 |
| 421506 | 新华镇 | 421500 |
| 421507 | 九湖镇 | 421500 |
| 421508 | 宋洛乡 | 421500 |
| 421509 | 下谷坪土家族乡 | 421500 |
| 421601 | 竟陵街道 | 421600 |
| 421602 | 侨乡街道 | 421600 |
| 421603 | 杨林街道 | 421600 |
| 421604 | 多宝镇 | 421600 |
| 421605 | 拖市镇 | 421600 |
| 421606 | 张港镇 | 421600 |
| 421607 | 蒋场镇 | 421600 |
| 421608 | 汪场镇 | 421600 |
| 421609 | 渔薪镇 | 421600 |
| 421610 | 黄潭镇 | 421600 |
| 421611 | 岳口镇 | 421600 |
| 421612 | 横林镇 | 421600 |
| 421613 | 彭市镇 | 421600 |
| 421614 | 麻洋镇 | 421600 |
| 421615 | 多祥镇 | 421600 |
| 421616 | 干驿镇 | 421600 |
| 421617 | 马湾镇 | 421600 |
| 421618 | 卢市镇 | 421600 |
| 421619 | 小板镇 | 421600 |
| 421620 | 九真镇 | 421600 |
| 421621 | 皂市镇 | 421600 |
| 421622 | 胡市镇 | 421600 |
| 421623 | 石河镇 | 421600 |
| 421624 | 佛子山镇 | 421600 |
| 421625 | 净潭乡 | 421600 |
| 421626 | 蒋湖农场 | 421600 |
| 421627 | 白茅湖农场 | 421600 |
| 460701 | 通什镇 | 460700 |
| 460702 | 水满乡 | 460700 |
| 460703 | 南圣镇 | 460700 |
| 460704 | 毛阳镇 | 460700 |
| 460705 | 毛道乡 | 460700 |
| 460706 | 番阳镇 | 460700 |
| 460707 | 畅好乡 | 460700 |
| 460801 | 重兴镇 | 460800 |
| 460802 | 翁田镇 | 460800 |
| 460803 | 文教镇 | 460800 |
| 460804 | 文城镇 | 460800 |
| 460805 | 潭牛镇 | 460800 |
| 460806 | 铺前镇 | 460800 |
| 460807 | 蓬莱镇 | 460800 |
| 460808 | 龙楼镇 | 460800 |
| 460809 | 锦山镇 | 460800 |
| 460810 | 会文镇 | 460800 |
| 460811 | 公坡镇 | 460800 |
| 460812 | 冯坡镇 | 460800 |
| 460813 | 东路镇 | 460800 |
| 460814 | 东郊镇 | 460800 |
| 460815 | 东阁镇 | 460800 |
| 460816 | 昌洒镇 | 460800 |
| 460817 | 抱罗镇 | 460800 |
| 460901 | 长丰镇 | 460900 |
| 460902 | 兴隆华侨农场 | 460900 |
| 460903 | 万城镇 | 460900 |
| 460904 | 山根镇 | 460900 |
| 460905 | 三更罗镇 | 460900 |
| 460906 | 南桥镇 | 460900 |
| 460907 | 龙滚镇 | 460900 |
| 460908 | 礼纪镇 | 460900 |
| 460909 | 后安镇 | 460900 |
| 460910 | 和乐镇 | 460900 |
| 460911 | 东澳镇 | 460900 |
| 460912 | 地方国营六连林场 | 460900 |
| 460913 | 大茂镇 | 460900 |
| 460914 | 北大镇 | 460900 |
| 461001 | 新兴镇 | 461000 |
| 461002 | 西昌镇 | 461000 |
| 461003 | 乌坡镇 | 461000 |
| 461004 | 屯城镇 | 461000 |
| 461005 | 坡心镇 | 461000 |
| 461006 | 南吕镇 | 461000 |
| 461007 | 南坤镇 | 461000 |
| 461008 | 枫木镇 | 461000 |
| 461101 | 中平镇 | 461100 |
| 461102 | 长征镇 | 461100 |
| 461103 | 营根镇 | 461100 |
| 461104 | 湾岭镇 | 461100 |
| 461105 | 什运乡 | 461100 |
| 461106 | 上安乡 | 461100 |
| 461107 | 黎母山镇 | 461100 |
| 461108 | 红毛镇 | 461100 |
| 461109 | 和平镇 | 461100 |
| 461110 | 海南省黎母山林场 | 461100 |
| 461111 | 吊罗山乡 | 461100 |
| 461201 | 中原镇 | 461200 |
| 461202 | 长坡镇 | 461200 |
| 461203 | 阳江镇 | 461200 |
| 461204 | 万泉镇 | 461200 |
| 461205 | 潭门镇 | 461200 |
| 461206 | 塔洋镇 | 461200 |
| 461207 | 石壁镇 | 461200 |
| 461208 | 龙江镇 | 461200 |
| 461209 | 嘉积镇 | 461200 |
| 461210 | 会山镇 | 461200 |
| 461211 | 大路镇 | 461200 |
| 461212 | 博鳌镇 | 461200 |
| 461213 | 彬村山华侨农场 | 461200 |
| 461301 | 英州镇 | 461300 |
| 461302 | 椰林镇 | 461300 |
| 461303 | 新村镇 | 461300 |
| 461304 | 文罗镇 | 461300 |
| 461305 | 提蒙乡 | 461300 |
| 461306 | 三才镇 | 461300 |
| 461307 | 群英乡 | 461300 |
| 461308 | 隆广镇 | 461300 |
| 461309 | 黎安镇 | 461300 |
| 461310 | 国营吊罗山林业公司 | 461300 |
| 461311 | 光坡镇 | 461300 |
| 461312 | 本号镇 | 461300 |
| 461401 | 新盈镇 | 461400 |
| 461402 | 调楼镇 | 461400 |
| 461403 | 南宝镇 | 461400 |
| 461404 | 临城镇 | 461400 |
| 461405 | 皇桐镇 | 461400 |
| 461406 | 和舍镇 | 461400 |
| 461407 | 国营加来农场 | 461400 |
| 461408 | 多文镇 | 461400 |
| 461409 | 东英镇 | 461400 |
| 461410 | 博厚镇 | 461400 |
| 461411 | 波莲镇 | 461400 |
| 460502 | 志仲镇 | 460500 |
| 460503 | 莺歌海镇 | 460500 |
| 460504 | 万冲镇 | 460500 |
| 460505 | 千家镇 | 460500 |
| 460506 | 利国镇 | 460500 |
| 460507 | 九所镇 | 460500 |
| 460508 | 尖峰镇 | 460500 |
| 460509 | 黄流镇 | 460500 |
| 460510 | 国营莺歌海盐场 | 460500 |
| 460511 | 国营尖峰岭林业公司 | 460500 |
| 460512 | 佛罗镇 | 460500 |
| 460513 | 大安镇 | 460500 |
| 460514 | 抱由镇 | 460500 |
| 461501 | 新龙镇 | 461500 |
| 461502 | 天安乡 | 461500 |
| 461503 | 四更镇 | 461500 |
| 461504 | 三家镇 | 461500 |
| 461505 | 江边乡 | 461500 |
| 461506 | 感城镇 | 461500 |
| 461507 | 东河镇 | 461500 |
| 461508 | 东方华侨农场 | 461500 |
| 461509 | 大田镇 | 461500 |
| 461510 | 板桥镇 | 461500 |
| 461511 | 八所镇 | 461500 |
| 461601 | 新竹镇 | 461600 |
| 461602 | 龙门镇 | 461600 |
| 461603 | 龙湖镇 | 461600 |
| 461604 | 龙河镇 | 461600 |
| 461605 | 岭口镇 | 461600 |
| 461606 | 雷鸣镇 | 461600 |
| 461607 | 黄竹镇 | 461600 |
| 461608 | 翰林镇 | 461600 |
| 461609 | 富文镇 | 461600 |
| 461610 | 定城镇 | 461600 |
| 461701 | 中兴镇 | 461700 |
| 461702 | 永发镇 | 461700 |
| 461703 | 文儒镇 | 461700 |
| 461704 | 瑞溪镇 | 461700 |
| 461705 | 仁兴镇 | 461700 |
| 461706 | 桥头镇 | 461700 |
| 461707 | 老城镇 | 461700 |
| 461708 | 金江镇 | 461700 |
| 461709 | 加乐镇 | 461700 |
| 461710 | 国营金安农场 | 461700 |
| 461711 | 福山镇 | 461700 |
| 461712 | 大丰镇 | 461700 |
| 460602 | 乌烈镇 | 460600 |
| 460603 | 王下乡 | 460600 |
| 460604 | 石碌镇 | 460600 |
| 460605 | 十月田镇 | 460600 |
| 460606 | 七叉镇 | 460600 |
| 460607 | 海尾镇 | 460600 |
| 460608 | 国营霸王岭林场 | 460600 |
| 460609 | 昌化镇 | 460600 |
| 460610 | 叉河镇 | 460600 |
| 461801 | 新政镇 | 461800 |
| 461802 | 响水镇 | 461800 |
| 461803 | 县直辖村级区划 | 461800 |
| 461804 | 什玲镇 | 461800 |
| 461805 | 三道镇 | 461800 |
| 461806 | 南林乡 | 461800 |
| 461807 | 毛感乡 | 461800 |
| 461808 | 六弓乡 | 461800 |
| 461809 | 加茂镇 | 461800 |
| 461810 | 保城镇 | 461800 |
| 461901 | 元门乡 | 461900 |
| 461902 | 牙叉镇 | 461900 |
| 461903 | 细水乡 | 461900 |
| 461904 | 荣邦乡 | 461900 |
| 461905 | 青松乡 | 461900 |
| 461906 | 七坊镇 | 461900 |
| 461907 | 南开乡 | 461900 |
| 461908 | 金波乡 | 461900 |
| 461909 | 阜龙乡 | 461900 |
| 461910 | 打安镇 | 461900 |
| 461911 | 邦溪镇 | 461900 |
| 411901 | 轵城镇 | 411900 |
| 411902 | 玉泉街道 | 411900 |
| 411903 | 下冶镇 | 411900 |
| 411904 | 五龙口镇 | 411900 |
| 411905 | 王屋镇 | 411900 |
| 411906 | 天坛街道 | 411900 |
| 411907 | 思礼镇 | 411900 |
| 411908 | 邵原镇 | 411900 |
| 411909 | 沁园街道 | 411900 |
| 411910 | 坡头镇 | 411900 |
| 411911 | 梨林镇 | 411900 |
| 411912 | 克井镇 | 411900 |
| 411913 | 济水街道 | 411900 |
| 411914 | 大峪镇 | 411900 |
| 411915 | 承留镇 | 411900 |
| 411916 | 北海街道 | 411900 |
| 421628 | 候口街道 | 421600 |
| 421629 | 沉湖管委会 | 421600 |
| 422926 | 浩口原种场 | 422901 |
| 654401 | 五家渠经济技术开区 | 654400 |
| 654402 | 梧桐镇 | 654400 |
| 654403 | 人民路街道 | 654400 |
| 654404 | 青湖路街道 | 654400 |
| 654405 | 军垦路街道 | 654400 |
| 654406 | 蔡家湖镇 | 654400 |
| 654407 | 兵团一零一团 | 654400 |
| 654501 | 永兴镇 | 654500 |
| 654502 | 永安坝街道 | 654500 |
| 654503 | 兴安镇 | 654500 |
| 654504 | 夏河镇 | 654500 |
| 654505 | 前海镇 | 654500 |
| 654506 | 前海街道 | 654500 |
| 654507 | 龙口镇 | 654500 |
| 654508 | 锦绣街道 | 654500 |
| 654509 | 嘉和镇 | 654500 |
| 654510 | 河东镇 | 654500 |
| 654511 | 草湖镇 | 654500 |
| 654512 | 兵团五十一团 | 654500 |
| 654513 | 兵团五十三团 | 654500 |
| 654514 | 兵团图木舒克市喀拉拜勒镇 | 654500 |
| 654515 | 兵团四十四团 | 654500 |
| 654516 | 兵团四十九团 | 654500 |
| 654601 | 天湖镇 | 654600 |
| 654602 | 双丰镇 | 654600 |
| 654603 | 南屯镇 | 654600 |
| 654604 | 米兰镇 | 654600 |
| 654605 | 开泽镇 | 654600 |
| 654606 | 金山镇 | 654600 |
| 654607 | 河畔镇 | 654600 |
| 654608 | 高桥镇 | 654600 |
| 654609 | 博古其镇 | 654600 |
| 654701 | 双桥镇 | 654700 |
| 654702 | 双乐镇 | 654700 |
| 654703 | 双河市核心区 | 654700 |
| 654704 | 石峪镇 | 654700 |
| 654705 | 博河镇 | 654700 |
| 654706 | 兵团八十九团 | 654700 |
| 654801 | 新城街道 | 654800 |
| 654802 | 向阳街道 | 654800 |
| 654803 | 石河子镇 | 654800 |
| 654804 | 老街街道 | 654800 |
| 654805 | 红山街道 | 654800 |
| 654806 | 东城街道 | 654800 |
| 654807 | 兵团一五二团 | 654800 |
| 654808 | 北泉镇 | 654800 |
| 654901 | 玉泉镇 | 654900 |
| 654902 | 老兵镇 | 654900 |
| 654903 | 昆玉市核心区 | 654900 |
| 654904 | 昆泉镇 | 654900 |
| 654905 | 昆牧镇 | 654900 |
| 654906 | 兵团二二四团 | 654900 |
| 654907 | 北京皮墨工业园区 | 654900 |
| 655001 | 长丰镇 | 655000 |
| 655002 | 榆树庄镇 | 655000 |
| 655003 | 苇湖镇 | 655000 |
| 655004 | 可克达拉市核心区 | 655000 |
| 655005 | 兵团六十七团 | 655000 |
| 655006 | 兵团六十六团 | 655000 |
| 655101 | 胡杨河市核心区 | 655100 |
| 655102 | 兵团一三零团 | 655100 |
| 655103 | 兵团一二五团 | 655100 |
| 655104 | 兵团一二九团 | 655100 |
| 655105 | 兵团一二八团 | 655100 |
| 655201 | 双渠镇 | 655200 |
| 655202 | 海川镇 | 655200 |
| 655203 | 丰庆镇 | 655200 |
| 655204 | 北屯市核心区 | 655200 |
| 655301 | 永宁镇 | 655300 |
| 655302 | 幸福镇 | 655300 |
| 655303 | 幸福路街道 | 655300 |
| 655304 | 新井子镇 | 655300 |
| 655305 | 西工业园区 | 655300 |
| 655306 | 托喀依乡 | 655300 |
| 655307 | 双城镇 | 655300 |
| 655308 | 沙河镇 | 655300 |
| 655309 | 青松路街道 | 655300 |
| 655310 | 金银川镇 | 655300 |
| 655311 | 金银川路街道 | 655300 |
| 655312 | 金杨镇 | 655300 |
| 655313 | 花桥镇 | 655300 |
| 655314 | 工业园区 | 655300 |
| 655315 | 甘泉镇 | 655300 |
| 655316 | 兵团十团 | 655300 |
| 655317 | 兵团十六团 | 655300 |
| 655318 | 兵团十二团 | 655300 |
| 655319 | 兵团七团 | 655300 |
| 655320 | 兵团九团 | 655300 |
| 655321 | 兵团八团 | 655300 |
| 330383 | 温州经济技术开发区 | 330300 |
| 330384 | 龙港市 | 330300 |
| 652830 | 库尔勒经济技术开发区 | 652800 |
| 540128 | 西藏文化旅游创意园区 | 540100 |
| 540129 | 拉萨经济技术开发区 | 540100 |
| 540130 | 格尔木藏青工业园区 | 540100 |
| 540131 | 达孜工业园区 | 540100 |
| 511084 | 内江经济开发区 | 511000 |
| 511782 | 达州经济开发区 | 511700 |
| 511924 | 巴中经济开发区 | 511900 |
| 140482 | 山西长治高新技术产业园区 | 140400 |
| 140982 | 五台山风景名胜区 | 140900 |
| 140182 | 山西转型综合改革示范区 | 140100 |
| 140625 | 山西朔州经济开发区 | 140600 |
| 140228 | 山西大同经济开发区 | 140200 |
| 370688 | 烟台经济技术开发区 | 370600 |
| 370689 | 烟台高新技术产业开发区 | 370600 |
| 370787 | 潍坊滨海经济技术开发区 | 370700 |
| 371084 | 威海临港经济技术开发区 | 371000 |
| 371085 | 威海经济技术开发区 | 371000 |
| 371086 | 威海火炬高技术产业开发区 | 371000 |
| 371123 | 日照经济技术开发区 | 371100 |
| 370286 | 青岛高新技术产业开发区 | 370200 |
| 371330 | 临沂高新技术产业开发区 | 371300 |
| 370884 | 济宁高新技术产业开发区 | 370800 |
| 370127 | 济南高新技术产业开发区 | 370100 |
| 370128 | 钢城区 | 370100 |
| 371729 | 菏泽经济技术开发区 | 371700 |
| 371730 | 菏泽高新技术开发区 | 371700 |
| 370524 | 东营经济技术开发区 | 370500 |
| 370525 | 东营港经济开发区 | 370500 |
| 371483 | 德州运河经济开发区 | 371400 |
| 371484 | 德州经济技术开发区 | 371400 |
| 632824 | 茫崖市 | 632800 |
| 632825 | 大柴旦行政委员会 | 632800 |
| 152532 | 乌拉盖管委会 | 152500 |
| 150582 | 通辽经济技术开发区 | 150500 |
| 150126 | 呼和浩特经济技术开发区 | 150100 |
| 150224 | 包头稀土高新技术产业开发区 | 150200 |
| 152924 | 内蒙古阿拉善经济开发区 | 152900 |
| 360125 | 红谷滩区 | 360100 |
| 321184 | 镇江新区 | 321100 |
| 321085 | 扬州经济技术开发区 | 321000 |
| 320982 | 盐城经济技术开发区 | 320900 |
| 320383 | 徐州经济技术开发区 | 320300 |
| 321325 | 宿迁经济技术开发区 | 321300 |
| 321284 | 泰州医药高新技术产业开发区 | 321200 |
| 320586 | 苏州工业园区 | 320500 |
| 320685 | 南通经济技术开发区 | 320600 |
| 320725 | 连云港经济技术开发区 | 320700 |
| 320726 | 连云港高新技术产业开发区 | 320700 |
| 320832 | 淮安经济技术开发区 | 320800 |
| 220184 | 长春汽车经济技术开发区 | 220100 |
| 220185 | 长春净月高新技术产业开发区 | 220100 |
| 220186 | 长春经济技术开发区 | 220100 |
| 220187 | 长春高新技术产业开发区 | 220100 |
| 220782 | 吉林松原经济开发区 | 220700 |
| 220285 | 吉林中国新加坡食品区 | 220200 |
| 220286 | 吉林经济开发区 | 220200 |
| 220287 | 吉林高新技术产业开发区 | 220200 |
| 220883 | 吉林白城经济开发区 | 220800 |
| 430282 | 云龙示范区 | 430200 |
| 430683 | 岳阳市屈原管理区 | 430600 |
| 431130 | 永州市金洞管理区 | 431100 |
| 431131 | 永州市回龙圩管理区 | 431100 |
| 431132 | 永州经济技术开发区 | 431100 |
| 430982 | 益阳市大通湖管理区 | 430900 |
| 430983 | 湖南益阳高新技术产业园区 | 430900 |
| 430383 | 湘潭昭山示范区 | 430300 |
| 430384 | 湘潭九华示范区 | 430300 |
| 430385 | 湖南湘潭高新技术产业园区 | 430300 |
| 431282 | 怀化市洪江管理区 | 431200 |
| 430483 | 湖南衡阳松木经济开发区 | 430400 |
| 430484 | 湖南衡阳高新技术产业园区 | 430400 |
| 430485 | 衡阳综合保税区 | 430400 |
| 430782 | 常德市西洞庭管理区 | 430700 |
| 421088 | 荆州经济技术开发区 | 421000 |
| 421183 | 龙感湖管理区 | 421100 |
| 231087 | 牡丹江经济技术开发区 | 231000 |
| 232724 | 新林区 | 232700 |
| 232725 | 松岭区 | 232700 |
| 232726 | 加格达奇区 | 232700 |
| 232727 | 呼中区 | 232700 |
| 230625 | 大庆高新技术产业开发区 | 230600 |
| 411730 | 河南驻马店经济开发区 | 411700 |
| 411682 | 河南周口经济开发区 | 411600 |
| 410186 | 郑州经济技术开发区 | 410100 |
| 410187 | 郑州航空港经济综合实验区 | 410100 |
| 410188 | 郑州高新技术产业开发区 | 410100 |
| 411083 | 许昌经济技术开发区 | 411000 |
| 411529 | 信阳高新技术产业开发区 | 411500 |
| 410783 | 新乡市平原城乡一体化示范区 | 410700 |
| 410784 | 新乡经济技术开发区 | 410700 |
| 410785 | 新乡高新技术产业开发区 | 410700 |
| 411482 | 豫东综合物流产业聚集区 | 411400 |
| 411483 | 河南商丘经济开发区 | 411400 |
| 411283 | 河南三门峡经济开发区 | 411200 |
| 410929 | 濮阳经济技术开发区 | 410900 |
| 410930 | 河南濮阳工业园区 | 410900 |
| 410483 | 平顶山市城乡一体化示范区 | 410400 |
| 410484 | 平顶山高新技术产业开发区 | 410400 |
| 411382 | 南阳市城乡一体化示范区 | 411300 |
| 411383 | 南阳高新技术产业开发区 | 411300 |
| 411123 | 漯河经济技术开发区 | 411100 |
| 410382 | 洛阳高新技术产业开发区 | 410300 |
| 410884 | 焦作城乡一体化示范区 | 410800 |
| 410623 | 鹤壁经济技术开发区 | 410600 |
| 410582 | 安阳高新技术产业开发区 | 410500 |
| 130733 | 张家口市塞北管理区 | 130700 |
| 130734 | 张家口市察北管理区 | 130700 |
| 130735 | 张家口经济开发区 | 130700 |
| 130583 | 河北邢台经济开发区 | 130500 |
| 130284 | 唐山市汉沽管理区 | 130200 |
| 130285 | 唐山高新技术产业开发区 | 130200 |
| 130286 | 河北唐山芦台经济开发区 | 130200 |
| 130287 | 河北唐山海港经济开发区 | 130200 |
| 130185 | 石家庄循环化工园区 | 130100 |
| 130186 | 石家庄高新技术产业开发区 | 130100 |
| 130325 | 秦皇岛市经济技术开发区 | 130300 |
| 130326 | 北戴河新区 | 130300 |
| 131083 | 廊坊经济技术开发区 | 131000 |
| 131183 | 衡水滨湖新区 | 131100 |
| 131184 | 河北衡水高新技术产业开发区 | 131100 |
| 130482 | 邯郸经济技术开发区 | 130400 |
| 130483 | 邯郸冀南新区 | 130400 |
| 130882 | 承德高新技术产业开发区 | 130800 |
| 130985 | 河北沧州经济开发区 | 130900 |
| 130986 | 沧州高新技术产业开发区 | 130900 |
| 130987 | 沧州渤海新区 | 130900 |
| 130685 | 保定高新技术产业开发区 | 130600 |
| 130686 | 保定白沟新城 | 130600 |
| 440311 | 光明区 | 440300 |
| 620124 | 兰州新区 | 620100 |
| 620201 | 峪泉镇 | 620200 |
| 620202 | 雄关街道 | 620200 |
| 620203 | 新城镇 | 620200 |
| 620204 | 文殊镇 | 620200 |
| 620205 | 钢城街道 | 620200 |
| 341882 | 宣城市经济开发区 | 341800 |
| 341325 | 宿州马鞍山现代产业园区 | 341300 |
| 341326 | 宿州经济技术开发区 | 341300 |
| 340226 | 芜湖经济技术开发区 | 340200 |
| 340227 | 安徽芜湖长江大桥经济开发区 | 340200 |
| 340182 | 合肥新站高新技术产业开发区 | 340100 |
| 340183 | 合肥经济技术开发区 | 340100 |
| 340184 | 合肥高新技术产业开发区 | 340100 |
| 341283 | 阜阳经济技术开发区 | 341200 |
| 341284 | 阜阳合肥现代产业园区 | 341200 |
| 341183 | 苏滁现代产业园 | 341100 |
| 341184 | 滁州经济技术开发区 | 341100 |
| 340324 | 蚌埠市经济开发区 | 340300 |
| 340325 | 蚌埠市高新技术开发区 | 340300 |
| 340882 | 安徽安庆经济开发区 | 340800 |
| 441934 | 东莞生态园 | 441900 |
| 441935 | 东莞港 | 441900 |
| 460401 | 白马井镇 | 460400 |
| 460402 | 海头镇 | 460400 |
| 460403 | 新州镇 | 460400 |
| 460404 | 木棠镇 | 460400 |
| 460405 | 东成镇 | 460400 |
| 460406 | 中和镇 | 460400 |
| 460407 | 大成镇 | 460400 |
| 460408 | 峨蔓镇 | 460400 |
| 460409 | 雅星镇 | 460400 |
| 460410 | 南丰镇 | 460400 |
| 460411 | 光村镇 | 460400 |
| 460412 | 洋浦经济开发区 | 460400 |
| 460413 | 那大镇 | 460400 |
| 460414 | 王五镇 | 460400 |
| 460415 | 和庆镇 | 460400 |
| 460416 | 兰洋镇 | 460400 |
| 460417 | 排浦镇 | 460400 |
| 460418 | 华南热作学院 | 460400 |
| 510186 | 天府新区 | 510100 |
| 330192 | 钱塘区 | 330100 |
| 330193 | 临平区 | 330100 |
| 411801 | 济水街道 | 411800 |
| 411802 | 沁园街道 | 411800 |
| 411803 | 北海街道 | 411800 |
| 411804 | 天坛街道 | 411800 |
| 411805 | 玉泉街道 | 411800 |
| 411806 | 克井镇 | 411800 |
| 411807 | 五龙口镇 | 411800 |
| 411808 | 梨林镇 | 411800 |
| 411809 | 轵城镇 | 411800 |
| 411810 | 承留镇 | 411800 |
| 411811 | 坡头镇 | 411800 |
| 411812 | 大峪镇 | 411800 |
| 411813 | 邵原镇 | 411800 |
| 411814 | 思礼镇 | 411800 |
| 411815 | 王屋镇 | 411800 |
| 411816 | 下冶镇 | 411800 |