View User Information

This documentation will describe the View User Information (XMURINFO) endpoint. This endpoint is reponsible for viewing your user’s setup information.

See the Authentication documentation for information on how to obtain the authentication headers within the request.

Use cases #

• View user profile settings.
• Verify user assigned dealers or subdealers.

Supported attributes #

Example request #

curl --location "https://example.securemcloud.com/rest/rest.php?dataSource=methods&*view=xmsubmit" \
--header 'X-DICE-APPKEY: {{X-DICE-APPKEY}}' \
--header 'X-DICE-USERNAME: {{X-DICE-USERNAME}}' \
--header 'X-DICE-DATE: {{X-DICE-DATE}}' \
--header 'X-DICE-NONCE: {{X-DICE-NONCE}}' \
--header 'X-DICE-DIGEST: {{X-DICE-DIGEST}}' \
--header 'Accept: application/json' \
--form '*setMethod="XMURINFO"'

Example responses #

Please note, the length of the response will depend on any custom DICE modules installed on your system.

Unrestricted user #

{
    "USER_INFO": {
        "SYSTEM_DATE_FORMAT": {
            "FORMAT_DATETYPE": "A",
            "FORMAT_DELIMETER": "/",
            "FORMAT_2YEAR": "MM/DD/YY",
            "FORMAT_4YEAR": "MM/DD/YYYY"
        },
        "USER_BRANCHES": {
            "BRANCHES": [
                "006",
                "007",
            ]
        },
        "OPER_LEVEL": "05",
        "OPER_CODE": "OPR",
        "USER_LOGIN": "operator",
        "DEALER_OR_SUBDEALER": "N",
    },
}

Dealer user #

{
    "USER_INFO": {
        "SYSTEM_DATE_FORMAT": {
            "FORMAT_DATETYPE": "A",
            "FORMAT_DELIMETER": "/",
            "FORMAT_2YEAR": "MM/DD/YY",
            "FORMAT_4YEAR": "MM/DD/YYYY"
        },
        "DEALERS": {
            "DEALER": [
                "DLR01",
                "DLR02"
            ],
            "DEALER_AR": "AR0001"
        },
        "USER_BRANCHES": {
            "BRANCHES": [
                "006",
                "007",
            ]
        },
        "OPER_LEVEL": "05",
        "OPER_CODE": "OPR",
        "USER_LOGIN": "operator",
        "DEALER_OR_SUBDEALER": "D",
    }
}

Subdealer user #

{
    "USER_INFO": {
        "SYSTEM_DATE_FORMAT": {
            "FORMAT_DATETYPE": "A",
            "FORMAT_DELIMETER": "/",
            "FORMAT_2YEAR": "MM/DD/YY",
            "FORMAT_4YEAR": "MM/DD/YYYY"
        },
        "SUBDEALERS": {
            "SUBDEALER": [
                "SDLR01",
                "SDLR02"
            ]
        },
        "USER_BRANCHES": {
            "BRANCHES": [
                "006",
                "007",
            ]
        },
        "OPER_LEVEL": "05",
        "OPER_CODE": "OPR",
        "USER_LOGIN": "operator",
        "DEALER_OR_SUBDEALER": "S",
    }
}

Possible error messages #

Invalid method #

Verify you are specifying XMURINFO as the method.

{
    "ERROR_CODE": "999",
    "ERROR_DESCRIPTION": "INVALID%20METHOD%20METHOD",
    "PROGRAM_ERROR": "11",
    "PROGRAM_ERROR_DESCRIPTION": "Missing%20or%20Duplicate%20key",
    "ERROR_ON_LINE": "240",
    "ADDITIONAL_INFO": "%3CMETHOD_NAME%3EXMURINF%20%3C%2FMETHOD_NAME%3E"
}