API REFERENCE

墨西哥社保就业记录查询接口

原始 PDF

以 18 位 CURP 查询 IMSS 社保就业信息,按雇主返回参保时间、工资基数和就业状态变动明细。

POST
拉美地区http://mxg.mnemodata.com/gateway/poy/mexImss
东南亚地区http://ph.mnemodata.com/gateway/poy/mexImss

输入参数列表

输入参数列表
参数名类型说明
memberCode必填String
商户号
接口平台开通的商户号
terminalCode必填String
终端号
接口平台开通的终端号
signData必填String
加密参数
对业务参数加密后的字符串;见对接示例

signData 加密参数

以下参数需在客户端按约定加密算法加密后,作为 signData 字段的值传入。

signData 加密参数
参数名类型说明
memberCode必填String
商户号
须与外层 memberCode 一致
terminalCode必填String
终端号
须与外层 terminalCode 一致
memberOrder必填String
商户订单号
最大 50 位且每次不能重复;该字段用于双方订单核实,需保存
subMemberDesc必填String
直接授权商户名称
需为与查询用户直接签订授权协议的公司主体的工商登记名称
curp必填String
墨西哥个人唯一识别码
18 位大写字母或数字,例如 AABM891025HMSBRG09

返回参数列表

返回参数列表
参数名类型说明
successboolean
请求成功标识
true:网关正常处理;false:鉴权、解密、参数校验等处理失败
errorCodeString
状态码
详见公共状态码;success 为 true 时原文称返回为空,成功示例中为 null
errorMsgString
状态描述
详见公共状态码;success 为 true 时原文称返回为空,成功示例中为 null
dataObject
交易结果
包含交易结果及业务详情;原文未说明 success=false 时的返回形式

data 字段说明

data 字段说明
参数名类型说明
codeString
交易结果编码
业务状态码,详见各接口 code 状态表
tradeNoString
交易订单号
系统生成的本次交易唯一流水号
descString
交易结果描述
对 code 的文字说明
feeString
收费标识
Y: 本次查询计费;N: 本次查询不计费
detailobject
筛查结果详情
筛查结果对象;原文未提供查无结果时的具体 JSON 形态

detail 筛查结果字段

detail 筛查结果字段
参数名类型说明
curpstring
墨西哥个人唯一识别码 CURP
标准长度 18 位
nssstring
墨西哥社会保障号 NSS
userNamestring
参保人全名
employerRecordsarray<object>
按雇主分组的参保记录
未查得时可能为空或不返回

detail.employerRecords[] 雇主参保记录

detail.employerRecords[] 雇主参保记录
参数名类型说明
employerRecords[].employerNamestring
雇主或公司完整名称
employerRecords[].employerRegistrationstring
雇主在 IMSS 的登记编号
employerRecords[].federalEntitystring
工作所在地对应的墨西哥联邦实体(州)
employerRecords[].dateRegistrationstring
最早入职日期
格式:DD/MM/YYYY
employerRecords[].dateDeRegistrationstring
最晚离职日期
通常为 DD/MM/YYYY;Vigente 表示当前仍在职
employerRecords[].baseSalaryContributiondecimal
最新社保缴费基数日工资
单位:墨西哥比索
employerRecords[].movementsarray<object>
参保及就业状态、缴费工资变动明细
该雇主下的变动记录

detail.employerRecords[].movements[] 就业状态变动明细

detail.employerRecords[].movements[] 就业状态变动明细
参数名类型说明
employerRecords[].movements[].typeMovementstring
变动类型
如 Alta(入职)、Reingreso(再入职)、Baja(离职)或调薪类型
employerRecords[].movements[].dateMovementstring
变动发生日期
格式:DD/MM/YYYY
employerRecords[].movements[].salaryBasedecimal
本次变动对应的社保缴费基数日工资
单位:墨西哥比索

code 验证状态表

code 验证状态表
code收费描述
0计费成功
1免费查无结果
999免费渠道异常