Jump to

• Request
• Response
• Examples

Update an Installment Schedule Specification

put

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

Updates the installment schedule specification 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

Supported Media Types

• application/xml
• application/json

Request Body - application/xml ()

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"
        }
    }
}

Request Body - application/json ()

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"
        }
    }
}

Back to Top

Response

200 Response

The installment schedule specification was updated successfully.

500 Response

An error occurred. An exception has been raised.

Back to Top

Examples

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

cURL Command

curl -X PUT 'http://hostname:port/bcws/webresources/version/installmentManagement/installmentScheduleSpec/0.0.0.1+-config-installment-schedule_spec+3763164' -H 'content-type: application/json' -d @updateInstallmentScheduleSpec.json

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.
• updateInstallmentScheduleSpec.json is the JSON file that specifies the details to update.

Example of Request Body

This example shows the contents of the updateInstallmentScheduleSpec.json file sent as the request body.

{
    "name": "Update Installment Schedule Spec",
    "glid": "108",
    "minPercent": "20",
    "minAmount": "",
    "descr": "",
    "maxIntervalDaysNEI": "20",
    "maxNumNEI": "30",
    "startsAt": "2021-11-21T00:00:00.000Z",
    "expiresAt": "2027-12-10T00:00:00.000Z",
    "qualifiers": [
        {
            "dataType": "STR",
            "key": "/account.PIN_FLD_ACCOUNT_NO",
            "operator": "EQ",
            "value": "09876"
        },
        {
            "dataType": "STR",
            "key": "/profile.PIN_FLD_NAME",
            "operator": "EQ",
            "value": "DEF"
        }
    ]
}

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+81961", 
	"href": "http://host:port/bcws/webresources/version/installmentManagement/installmentScheduleSpec/0.0.0.1+-config installment-schedule_spec+3763164" 
}

Back to Top