Integration Guide

6.2 Consumer Services - Oracle Banking Enterprise Limits and Collateral Management

This topic describes about the consumer services required for Oracle Banking Enterprise Limits and Collateral Management Implementation.

The below endpoints must be configured under Consumer Services in Oracle Banking Routing Hub:

NewUtilization
CreateBlock
QueryValidLimit

Figure 6-2 Consumer Services - Enterprise Limits and Collateral Management

Description of "Figure 6-2 Consumer Services - Enterprise Limits and Collateral Management"

NewUtilization

This API enables the user to utilize the blocked limits during disbursement, or release the utilized limits during settlement.

SERVICE-CONSUMER = “OBSCF_ELCM”

SERVICE-CONSUMER-SERVICE= “NewUtilization”

Request:

{
"serviceConsumerServiceName": "NewUtilization",
    "body": {
        "txnAdhocLimitAmount": 0,
        "lineSerial": 1,
        "userBranchCode": "004",
        "totalAvailableAmount": 12340455,
        "externalLineId": "0003801",
        "txnMainLimitAmount": 229,
        "totalUtilizeAmount": 112,
        "customerNumber": "000380",
        "appBranchCode": "004",
        "txnCcy": "USD",
        "transactionType": "Rel",
        "blockId": "",
        "businessDate": "2022-11-01",
        "earmarkBlockUpdate": "N",
        "requestId": "004011122PR04120_1",
        "totalAdhocBlockAmount": 0,
        "limitsType": "FINANCE",
        "actionCode": "DECREASE",
        "operation": "NewUtilization",
        "txnAmount": 116,
        "liabNo": "000380",
        "totalBlockAmount": 229
    },
    "serviceConsumerName": "OBSCF_ELCM"
}

Response:

{
    "headers": {},
    "body": {
        "data": {
            "referenceNo": "004011122PR04120_1",
            "warningCode": [
                {
                    "warningCode": "ST-SAVE-027",
                    "warningDesc": "Request Successfully Processed"
                }
            ],
            "errorCode": [],
            "currency": "USD",
            "status": "SUCCESS"
        },
        "messages": {
            "keyId": null,
            "status": "SUCCESS",
            "codes": [],
            "requestId": null,
            "httpStatusCode": "OK",
            "overrideAuthLevelsReqd": null
        }
    }
}

CreateBlock

This API enables the user to block or unblock the limits.

SERVICE-CONSUMER = “OBSCF_ELCM”

SERVICE-CONSUMER-SERVICE= “CreateBlock”

Request

{
    "serviceConsumerServiceName": "CreateBlock",
    "body": {
        "txnAdhocLimitAmount": 0,
        "lineSerial": 1,
        "userBranchCode": "004",
        "totalAvailableAmount": 12340455,
        "externalLineId": "0003801",
        "txnMainLimitAmount": 116,
        "totalUtilizeAmount": 112,
        "customerNumber": "000380",
        "appBranchCode": "004",
        "txnCcy": "USD",
        "transactionType": "Block",
        "businessDate": "2022-11-01",
        "earmarkBlockUpdate": "N",
        "requestId": "004011122PR04120_1",
        "totalAdhocBlockAmount": 0,
        "limitsType": "FINANCE",
        "action": "NEW",
        "operation": "CreateBlock",
        "txnAmount": 116,
        "effectiveDate": "2022-11-01",
        "liabNo": "000380",
        "totalBlockAmount": 345
    },
    "serviceConsumerName": "OBSCF_ELCM"
}

Response:

{
    "headers": {},
    "body": {
        "data": {
            "referenceNo": "004011122PR04120_1",
            "warningCode": [
                {
                    "warningCode": "ST-SAVE-002",
                    "warningDesc": "Record Successfully Saved and Authorized"
                }
            ],
            "blockAmount": "116",
            "errorCode": [],
            "currency": "USD",
            "status": "SUCCESS"
        },
        "messages": {
            "keyId": null,
            "status": "SUCCESS",
            "codes": [],
            "requestId": null,
            "httpStatusCode": "OK",
            "overrideAuthLevelsReqd": null
        }
    }
}

QueryValidLimit

This API enables the user to query the limit details.

SERVICE-CONSUMER = “OBSCF_ELCM”

SERVICE-CONSUMER-SERVICE= “QueryValidLimit”

Request:

{
"serviceConsumerServiceName" : "QueryValidLimit",
  "body" : {
    "branchCode" : "004",
    "customerId" : "000381",
    "operation" : "QueryValidLimit"
  },
  "serviceConsumerName" : "OBSCF_ELCM"
}

Response:

{
    "headers": {},
    "body": {
        "data": {
            "warningCode": [
                {
                    "warningCode": "ST-SAVE-025",
                    "warningDesc": "Record Successfully Retrieved"
                }
            ],
            "externalLineDetailDTO": [
                {
                    "availableAmount": "12340567",
                    "blockAmount": "0",
                    "effectiveLineAmount": "12340567",
                    "limitAmount": "12340567",
                    "externalLineId": "0003811",
                    "limitCcy": "USD",
                    "lineStartDate": "2021-10-19",
                    "lineExpiryDate": "",
                    "utilisationAmt": "0",
                    "reviewDate": "",
                    "unadvised": ""
                }
            ],
            "errorCode": [],
            "liabNo": "000381",
            "status": "SUCCESS"
        },
        "messages": {
            "keyId": null,
            "status": "SUCCESS",
            "codes": [],
            "requestId": null,
            "httpStatusCode": "OK",
            "overrideAuthLevelsReqd": null
        }
    }
}

Parent topic: Outbound API configuration in Oracle Banking Routing Hub