Jump to

• Request
• Response
• Examples

Get an Installment Schedule Specification by ID

get

/bcws/webresources/v1.0/installmentManagement/installmentScheduleSpec/{id}

Gets the installment schedule specifications with the specified ID.

Request

Path Parameters

• id(required): string
  The installment specification ID, for example: 0.0.0.1+-config-instalment_schedule_spec+123123

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/xml
• application/json

200 Response

The installment schedule specification information was retrieved successfully.

Body ()

Root Schema : schema

Type: object

Show Source

• createdAt(required): string
  The date when the installment schedule specification is created.
• descr(required): string
  The installment schedule specification description.
• expiresAt(required): string
  The date when the installment schedule specification expires.
• glid: integer (int32)
  The general ledger ID used for recording the installment charge.
• href(required): string
  The unique resource URL, used to get the object.
• id(required): string
  The installment schedule specification ID.
• maxIntervalDaysNEI: integer (int32)
  The maximum number of days between non-equal installments.
• maxNumNEI: integer (int32)
  The maximum number of non-equal installments.
• minAmount(required): number
  The minimum bill/charge amount to be considered for the installment conversion. Either the minimum percentage or the minimum amount must be included.
• minPercent(required): number
  The minimum bill/charge percentage to be considered for the installment conversion. Either the minimum percentage or the minimum amount must be included.
• modifiedAt(required): string
  The date when the installment schedule specification is modified.
• name(required): string
  The installment schedule specification name.
• qualifiers(required): array qualifiers
• startsAt(required): string
  The date when the installment schedule specification starts.

{
    "required":[
        "createdAt",
        "descr",
        "expiresAt",
        "href",
        "id",
        "minAmount",
        "minPercent",
        "modifiedAt",
        "name",
        "qualifiers",
        "startsAt"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"The installment schedule specification ID."
        },
        "name":{
            "type":"string",
            "description":"The installment schedule specification name."
        },
        "href":{
            "type":"string",
            "description":"The unique resource URL, used to get the object."
        },
        "descr":{
            "type":"string",
            "description":"The installment schedule specification description."
        },
        "createdAt":{
            "type":"string",
            "description":"The date when the installment schedule specification is created."
        },
        "startsAt":{
            "type":"string",
            "description":"The date when the installment schedule specification starts."
        },
        "modifiedAt":{
            "type":"string",
            "description":"The date when the installment schedule specification is modified."
        },
        "expiresAt":{
            "type":"string",
            "description":"The date when the installment schedule specification expires."
        },
        "glid":{
            "type":"integer",
            "description":"The general ledger ID used for recording the installment charge.",
            "format":"int32"
        },
        "minPercent":{
            "type":"number",
            "description":"The minimum bill/charge percentage to be considered for the installment conversion. Either the minimum percentage or the minimum amount must be included."
        },
        "minAmount":{
            "type":"number",
            "description":"The minimum bill/charge amount to be considered for the installment conversion. Either the minimum percentage or the minimum amount must be included."
        },
        "maxIntervalDaysNEI":{
            "type":"integer",
            "description":"The maximum number of days between non-equal installments.",
            "format":"int32"
        },
        "maxNumNEI":{
            "type":"integer",
            "description":"The maximum number of non-equal installments.",
            "format":"int32"
        },
        "qualifiers":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/Qualifier"
            }
        }
    },
    "xml":{
        "name":"installmentScheduleSpec"
    }
}

Nested Schema : qualifiers

Type: array

Show Source

• Array of: object Qualifier

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Qualifier"
    }
}

Nested Schema : Qualifier

Type: object

Show Source

• dataType: integer (int32)
  The data type of the value. Allowed values:

  • 1 (Integer)
  • 3 (Enumerated)
  • 5 (String)
  • 7 (POID)
  • 8 (Timestamp)
  • 14 (Decimal)
• key(required): string
  The name or the identifier from a storable class.
• operator: integer (int32)
  The operator for the qualifier. Allowed values:

  • 0 (Equals)
  • 1 (Less than)
  • 2 (Greater than)
  • 3 (Less than or equals)
  • 4 (Greater than or equals)
  • 5 (Not equal)
  • 6 (Contained in string)
  • 7 (Like)
• value(required): string
  The reference value to be evaluated.

{
    "required":[
        "key",
        "value"
    ],
    "type":"object",
    "properties":{
        "key":{
            "type":"string",
            "description":"The name or the identifier from a storable class."
        },
        "value":{
            "type":"string",
            "description":"The reference value to be evaluated."
        },
        "dataType":{
            "type":"integer",
            "description":"The data type of the value. Allowed values:<ul><li><b>1</b> (Integer)</li><li><b>3</b> (Enumerated)</li><li><b>5</b> (String)</li><li><b>7</b> (POID)</li><li><b>8</b> (Timestamp)</li><li><b>14</b> (Decimal)</li></ul>",
            "format":"int32"
        },
        "operator":{
            "type":"integer",
            "description":"The operator for the qualifier. Allowed values:<ul><li><b>0</b> (Equals)</li><li><b>1</b> (Less than)</li><li><b>2</b> (Greater than)</li><li><b>3</b> (Less than or equals)</li><li><b>4</b> (Greater than or equals)</li><li><b>5</b> (Not equal)</li><li><b>6</b> (Contained in string)</li><li><b>7</b> (Like)</li></ul>",
            "format":"int32"
        }
    }
}

500 Response

An error occurred. An exception has been raised.

Back to Top

Examples

This example shows how to get an installment schedule specification by submitting a GET request on the REST resource using cURL. For more information about cURL, see "Use cURL".

cURL Command

curl -X GET 'http://hostname:port/bcws/webresources/version/installmentManagement/installmentScheduleSpec/0.0.0.1+-config-installment-schedule_spec+3763164'

where:

• hostname is the URL for the Billing Care REST server.
• port is the port for the Billing Care REST server.
• version is the version of the API you're using, such as v1.0.

Example of Response Body

This example shows the contents of the response body in JSON format.

{
    "id": "0.0.0.1+-config-installment-schedule_spec+3763164",
    "name": "Create Installment Schedule Spec",
    "href": "http://hostname:port/bcws/webresources/v1.0/installmentManagement/installmentScheduleSpec/0.0.0.1+-config-installment-schedule_spec+3763164",
    "descr": "",
    "createdAt": "2021-11-20T07:33:36.000Z",
    "startsAt": "2021-11-21T00:00:00.000Z",
    "modifiedAt": "2021-11-20T07:33:36.000Z",
    "expiresAt": "2021-11-24T00:00:00.000Z",
    "glid": 109,
    "minPercent": 0,
    "minAmount": 200,
    "maxIntervalDaysNEI": 10,
    "maxNumNEI": 20,
    "qualifiers": [
        {
            "key": "/account.PIN_FLD_ACCOUNT_NO",
            "value": "123456",
            "dataType": "STR",
            "operator": "EQ"
        },
        {
            "key": "/profile.PIN_FLD_NAME",
            "value": "ABC",
            "dataType": "STR",
            "operator": "EQ"
        }
    ]
}

Back to Top