Update a Customer Deposit

patch

/bcws/webresources/v1.0/depositManagement/customerDeposit/{id}

Updates the specified customer deposit.

Request

Path Parameters
Supported Media Types
Request Body - application/xml ()
Root Schema : schema
Type: object
Show Source
Nested Schema : CustomerDeposit
Type: object
Show Source
Nested Schema : payments
Type: array
Show Source
Nested Schema : Money
Type: object
Show Source
Nested Schema : transactions
Type: array
Show Source
Nested Schema : TimePeriod
Type: object
Show Source
Nested Schema : DepositValidityRule
Type: object
Show Source
Nested Schema : CustomerDepositTransactions
Type: object
Show Source
Nested Schema : DepositPayment
Type: object
Show Source
Nested Schema : Discriminator: @class
Type: object
Show Source
Nested Schema : ResourceRef
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
Nested Schema : CustomerDeposit
Type: object
Show Source
Nested Schema : payments
Type: array
Show Source
Nested Schema : Money
Type: object
Show Source
Nested Schema : transactions
Type: array
Show Source
Nested Schema : TimePeriod
Type: object
Show Source
Nested Schema : DepositValidityRule
Type: object
Show Source
Nested Schema : CustomerDepositTransactions
Type: object
Show Source
Nested Schema : DepositPayment
Type: object
Show Source
Nested Schema : Discriminator: @class
Type: object
Show Source
Nested Schema : ResourceRef
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Back to Top

Response

201 Response

The customer deposit order was updated successfully, and the ID of the updated deposit was returned.

500 Response

An error occurred. An exception has been raised.
Back to Top

Examples

This example shows how to update a deposit 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/depositManagement/customerDeposit/0.0.0.1+-purchased_deposit+2552521' -H 'content-type: application/json' -d @updateDeposit.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.
  • updateDeposit.json is the JSON file that specifies the details to update.

Example of Request Body

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

{
    "customerDeposit": {
        "customerRef": "0.0.0.1+-account+2205426",
        "billProfileRef": "0.0.0.1+-billinfo+2206194",
        "depositSpecRef": "0.0.0.1+-deposit_specification+2207626",
        "serviceRef": "0.0.0.1+-service-telco-gsm+2203914",
		"validityRule": {
            "endOffsetPeriodUnit": "DAYS",
            "endOffsetPeriodValue": "10"
        },
        "totalAmount": {
            "amount": "123",
            "currency": "EUR"
        },
        "releaseType": "PREPAYMENT"
       
    },
    "payments": [
        {
            "paymentAmount": {
                "amount": 99.95,
                "currency": "EUR"
            },
            "notes": "HELO",
            "glCode": "101",
            "paymentMethodType": "CASH",
            "paymentRef": "0.0.0.1+-payment+1563385",
            "status": "PENDING"
        }
    ]
}

Example of Response Body

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

{
    "id": " 0.0.0.1+-purchased_deposit+2654172 ",
    "href": "http://hostname:port/bcws/webresources/version/depositManagement/customerDeposit/0.0.0.1+-purchased_deposit+2654172"
}
Back to Top