M18 HCM Web Services

Version: 1.0 | Release Date: 30/6/2018

PRC Labour Law Compliance

Get Effective Social Security Information Details as at Current Date with Specified Social Security District and Insurance Identity

HTTP Request

GET http://[server]/jsf/rfws/insur/insur/getEffInsurInfo/{insurDistrict}/{insurIdentity}

Parameters

Name	Type	Description
insurDistrict	long(Path)	Required. Insurance District ID
insurIdentity	long(Path)	Required. ID of Insurance Code

Result (in JSON Array)

Name	Type	Description
size	int	Size of JsonArray in values
values	string	Data, depends on Table
name	string	Name. Empty
fields	string	Field Details

Sample request:

OkHttpClient client = new OkHttpClient();

long insurDistrict = 21;
long insurIdentity = 42;

String url = "http://" + server + "/jsf/rfws/insur/insur/getEffInsurInfo/21/42";

Request request = new Request.Builder()
  .url(url)
  .get()
  .addHeader("client_id", clientID)
  .addHeader("authorization", "Bearer " + token)
  .addHeader("cache-control", "no-cache")
  .build();

Response response = client.newCall(request).execute();

Sample response:

{
    "size": 7,
    "values": [
        {
            "id": 365,
            "iRev": 1,
            "hId": 67,
            "itemNo": "     1",
            "insurAcc": 7,
            "calcFactor": 1,
            "empPct": 2,
            "comPct": 3,
            "empAmt": 4,
            "comAmt": 5,
            "calcFactorUpLimit": 6,
            "calcFactorLowLimit": 7,
            "empTaxPct": 8,
            "comTaxPct": 9,
            "empTaxAmt": 10,
            "comTaxAmt": 11,
            "empTaxFactor": 12,
            "comTaxFactor": 13,
            "empTaxTotal": 14,
            "comTaxTotal": 15
        },
        {
            "id": 366,
            "iRev": 1,
            "hId": 67,
            "itemNo": "     2",
            "insurAcc": 3,
            "empPct": 0.5,
            "comPct": 1.5,
            "calcFactorUpLimit": 10000000
        },
        {
            "id": 367,
            "iRev": 1,
            "hId": 67,
            "itemNo": "     3",
            "insurAcc": 2,
            "empPct": 2,
            "comPct": 10,
            "calcFactorUpLimit": 10000000
        },
        {
            "id": 368,
            "iRev": 1,
            "hId": 67,
            "itemNo": "     4",
            "insurAcc": 5,
            "comPct": 0.8,
            "calcFactorUpLimit": 10000000
        },
        {
            "id": 369,
            "iRev": 1,
            "hId": 67,
            "itemNo": "     5",
            "insurAcc": 1,
            "empPct": 8,
            "comPct": 20,
            "calcFactorUpLimit": 10000000
        },
        {
            "id": 370,
            "iRev": 1,
            "hId": 67,
            "itemNo": "     6",
            "insurAcc": 6,
            "empAmt": 3,
            "calcFactorUpLimit": 10000000
        },
        {
            "id": 371,
            "iRev": 1,
            "hId": 67,
            "itemNo": "     7",
            "insurAcc": 4,
            "comPct": 0.3,
            "calcFactorUpLimit": 10000000
        }
    ],
    "name": "",
    "fields": [
        {
            "name": "id",
            "classType": 10,
            "fieldClassName": "Long",
            "fieldClass": "java.lang.Long"
        },
        {
            "name": "iRev",
            "classType": 10,
            "fieldClassName": "Integer",
            "fieldClass": "java.lang.Integer"
        },
        {
            "name": "hId",
            "classType": 10,
            "fieldClassName": "Long",
            "fieldClass": "java.lang.Long"
        },
        {
            "name": "itemNo",
            "classType": 0,
            "fieldClassName": "String",
            "fieldClass": "java.lang.String"
        },
        {
            "name": "insurAcc",
            "classType": 10,
            "fieldClassName": "Long",
            "fieldClass": "java.lang.Long"
        },
        {
            "name": "calcFactor",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "empPct",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "comPct",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "empAmt",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "comAmt",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "calcFactorUpLimit",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "calcFactorLowLimit",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "empTaxPct",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "comTaxPct",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "empTaxAmt",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "comTaxAmt",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "empTaxFactor",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "comTaxFactor",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "empTaxTotal",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "comTaxTotal",
            "classType": 10,
            "fieldClassName": "Double",
            "fieldClass": "java.lang.Double"
        },
        {
            "name": "remarks",
            "classType": 0,
            "fieldClassName": "String",
            "fieldClass": "java.lang.String"
        }
    ]
}