1. REST API Reference for Billing Care
  2. Tasks
  3. Collections

Modify an Account's Collections Action

put

/bcws/webresources/v1.0/collections/task/{id}

Modifies the specified collections action being taken against a customer. For example, you can change the action's status, the action's scheduled date, and the follow-on actions.

Request

Path Parameters
  • The ID of the collections action, such as 0.0.0.1+-collections_action-manual_action+3456789.
Supported Media Types
Request Body - application/xml ()
Root Schema : schema
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : Notes
Type: object
Show Source
Nested Schema : comments
Type: array
The list of comments associated with the note.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : Comments
Type: object
The list of comments associated with the note.
Show Source
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : Notes
Type: object
Show Source
Nested Schema : comments
Type: array
The list of comments associated with the note.
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : Comments
Type: object
The list of comments associated with the note.
Show Source
Back to Top

Response

Supported Media Types

200 Response

The collections action was returned successfully.
Body ()
Root Schema : resource
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : ResourceRef
Type: object
Show Source

500 Response

An internal server error occurred
Back to Top

Examples

This example shows how reschedule a collections action 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/collections/task/0.0.0.1+-collections_action-inactivate_billinfo+141642' -H 'content-type: application/json' -d @modifyCollectionsAction.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.
  • modifyCollectionsAction.json is the JSON file that specifies the details to update.

Example of Request Body

This example shows the contents of the modifyCollectionsAction.json file sent as the request body. Because a note ID is specified, the comment is added to an existing note. 

{
	"rescheduleDate": "2021-02-08T13:31:29.735Z",
	"rescheduleAction": true,
	"status": "0",
	"slipByDays": "1",
	"cancelFollowupActions": false,
	"actionFlag": "0",
	"notes": {
		"billUnitId": "0.0.0.1+-billinfo+128084",
		"accountId": "0.0.0.1+-account+130964",
		"domainId": 9,
		"type": 900,
		"subType": 901,
		"status": 101,
		"effectiveDate": "2021-02-08",
		"id": "0.0.0.1+-note+278620",
		"reasonId": "3"
		"comments": [
			{
				"comment": "Rescheduling action."
			}
		]
	}
}

Example of Response Body

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

{
	"extension": null,
	"reference": {
		"id": "0.0.0.1+-collections_action-inactivate_billinfo+141642",
		"uri": "http://hostname:port/bc/webresources/v1.0/collections/0.0.0.1+-collections_action-inactivate_billinfo+141642"
	}
}
Back to Top