Create an Installment Proposal
post
/bcws/webresources/v1.0/installmentManagement/installmentProposal
Creates an installment proposal.
Request
There are no request parameters for this operation.
Supported Media Types
- application/xml
- application/json
The installment proposal to create. The minimum required parameters are:
- customerRef
- specRef
- totalAmount
Root Schema : schema
Type:
Show Source
object
-
bills(required): array
bills
-
customerRef(required): string
The customer reference.
-
href(required): string
The unique resource URL, used for getting the object.
-
id(required): string
The installment proposal's ID. Proposals are not persisted in the system, so this field is always null.
-
installmentPeriod(required): string
The installment cycle. For future use. Allowed Values: ANNUAL, SEMI-ANNUAL, QUARTERLY, MONTHLY, WEEKLY, DAILY. Default Value: MONTHLY
-
installmentType(required): string
The installment type. Allowed Values: EQUAL INSTALLMENT, NON-EQUAL INSTALLMENT
-
specRef(required): string
The installment schedule specification reference.
-
totalAmount: object
Money
-
totalInstallments: integer
(int32)
The total number of installments.
-
validFor: object
TimePeriod
Nested Schema : Money
Type:
Show Source
object
-
amount(required): number
The amount of money.
-
currency: integer
(int32)
The currency for the money.
Nested Schema : InstallmentScheduleBills
Type:
Show Source
object
-
billId(required): string
The installment schedule bill ID.
The installment proposal to create. The minimum required parameters are:
- customerRef
- specRef
- totalAmount
Root Schema : schema
Type:
Show Source
object
-
bills(required): array
bills
-
customerRef(required): string
The customer reference.
-
href(required): string
The unique resource URL, used for getting the object.
-
id(required): string
The installment proposal's ID. Proposals are not persisted in the system, so this field is always null.
-
installmentPeriod(required): string
The installment cycle. For future use. Allowed Values: ANNUAL, SEMI-ANNUAL, QUARTERLY, MONTHLY, WEEKLY, DAILY. Default Value: MONTHLY
-
installmentType(required): string
The installment type. Allowed Values: EQUAL INSTALLMENT, NON-EQUAL INSTALLMENT
-
specRef(required): string
The installment schedule specification reference.
-
totalAmount: object
Money
-
totalInstallments: integer
(int32)
The total number of installments.
-
validFor: object
TimePeriod
Nested Schema : Money
Type:
Show Source
object
-
amount(required): number
The amount of money.
-
currency: integer
(int32)
The currency for the money.
Nested Schema : InstallmentScheduleBills
Type:
Show Source
object
-
billId(required): string
The installment schedule bill ID.
Response
Supported Media Types
- application/xml
- application/json
200 Response
The installment proposal was created successfully.
Root Schema : installmentSchedule
Type:
Show Source
object
-
billPreference: integer
(int32)
Indicates either to bill the installment amount immediately or to keep it open and include it with the customer's billing cycle. Allowed Values:
- 0 (Auto-align)
- 1 (Immediate)
-
billProfileRef(required): string
The customer bill unit reference.
-
bills(required): array
bills
-
channel(required): string
The source of the request, for example the name of the store or app. For future use.
-
chargeOfferRef(required): string
The charge offer reference. For future use.
-
code(required): string
Placeholder for the external code.
-
createdAt(required): string
The date of creation.
-
customerRef(required): string
The customer account reference.
-
descr(required): string
The installment schedule description.
-
expiresAt(required): string
The expiration date.
-
glid(required): string
The general ledger ID for the installment charge.
-
href(required): string
The unique resource URL, used for getting the object.
-
id(required): string
The installment schedule's ID.
-
installmentAmount: object
Money
-
installmentPeriod(required): string
The installment cycle. For future use. Allowed Values: ANNUAL, SEMI-ANNUAL, QUARTERLY, MONTHLY, WEEKLY, DAILY. Default Value: MONTHLY
-
installments(required): array
installments
-
installmentType(required): string
The installment type. Allowed Values: EQUAL INSTALLMENT, NON-EQUAL INSTALLMENT
-
lastInstallmentAt(required): string
The last installment date. For future use.
-
modifiedAt(required): string
The last updated date.
-
name(required): string
The installment schedule name.
-
nextInstallmentAt(required): string
The next installment date. For future use.
-
scheduleSpecRef(required): string
The installment schedule specification reference.
-
serviceRef(required): string
The service reference.
-
startsAt(required): string
The start date.
-
status: integer
(int32)
The installment schedule status. Allowed Values:
- 100 (Open)
- 101 (Charged)
- 102 (Paid)
- 103 (Broken)
- 104 (Canceled)
- 105 (Finished)
-
totalAmount: object
Money
-
totalDue: object
Money
-
totalInstallments: integer
(int32)
The total number of installments.
-
validFor: object
TimePeriod
Nested Schema : Money
Type:
Show Source
object
-
amount(required): number
The amount of money.
-
currency: integer
(int32)
The currency for the money.
Nested Schema : InstallmentScheduleBills
Type:
Show Source
object
-
billId(required): string
The installment schedule bill ID.
Nested Schema : Installment
Type:
Show Source
object
-
amount: object
Money
-
createdAt(required): string
TThe date of creation.
-
customerRef(required): string
The customer reference.
-
descr(required): string
The installment description.
-
dueDate(required): string
The date of installment collection/charge.
-
href(required): string
The unique resource URL, used for getting the object.
-
id(required): string
The installment's ID.
-
scheduleRef(required): string
The reference to the installment schedule.
-
status: integer
(int32)
The installment status. Allowed Values:
- 100 (Open)
- 101 (Charged)
- 102 (Paid)
- 103 (Broken)
- 104 (Canceled)
- 105 (Finished)
500 Response
An error occurred. An exception has been raised.
Examples
This example shows how to create an installment proposal by submitting a POST request on the REST resource using cURL. For more information about cURL, see "Use cURL".
cURL Command
curl -X POST 'http://hostname:port/bcws/webresources/version/installmentManagement/installmentProposal' -H 'content-type: application/json' -d @createInstallmentProposal.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.
- createInstallmentProposal.json is the JSON file that specifies the installment proposal to create.
Example of Request Body
This example shows the contents of the createInstallmentProposal.json file sent as the request body.
{
"totalAmount": {
"amount": "1000",
"currency": "INR"
},
"totalInstallments": "3",
"bills": [
{
"billId": "0.0.0.1+-item+133921"
}
],
"specRef": "0.0.0.1+-config-installment-schedule_spec+82484",
"customerRef": "0.0.0.1+-account+134849+0"
}
Example of Response Body
This example shows the contents of the response body in JSON format.
{
"validFor": {
"startDateTime": "2021-08-28T00:00:00.000Z",
"endDateTime": "2021-10-28T00:00:00.000Z"
},
"installmentPeriod": "MONTHLY",
"totalAmount": {
"amount": 1000,
"currency": "INR"
},
"totalInstallments": 3,
"customerRef": "0.0.0.1+-account+134849+0",
"bills": [
{
"billId": "0.0.0.1+-item+133921"
}
],
"glid": "4",
"scheduleSpecRef": "0.0.0.1+-config-installment-schedule_spec+82484",
"installments": [
{
"dueDate": "2021-08-28T00:00:00.000Z",
"amount": {
"amount": 333.33,
"currency": "INR"
}
},
{
"dueDate": "2021-09-28T00:00:00.000Z",
"amount": {
"amount": 333.33,
"currency": "INR"
}
},
{
"dueDate": "2021-10-28T00:00:00.000Z",
"amount": {
"amount": 333.33,
"currency": "INR"
}
}
]
}