REST API Reference for Billing Care

Update a Collections Group

put

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

Updates the collections group that matches the specified ID.

You can optionally do this:

Replace the existing set of members
Change the name of the collections group
Change the parent bill unit

Request

Path Parameters

id(required): string

The ID of the collections group to update.

Supported Media Types

application/xml
application/json

Root Schema : schema

Type: object

Show Source

extension: object extension

The extended attributes.
members: array members

The list of members in the collections sharing group.
name: string

The name of the collections sharing group.
newParentBillUnitRef: object ResourceRef
notes: object Notes
parentBillUnitDue: number

The amount owed by the collections sharing group owner.
parentBillUnitRef: object ResourceRef

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "parentBillUnitRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "newParentBillUnitRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "name":{
            "type":"string",
            "description":"The name of the collections sharing group."
        },
        "parentBillUnitDue":{
            "type":"number",
            "description":"The amount owed by the collections sharing group owner."
        },
        "notes":{
            "$ref":"#/components/schemas/Notes"
        },
        "members":{
            "type":"array",
            "description":"The list of members in the collections sharing group.",
            "items":{
                "$ref":"#/components/schemas/Members"
            }
        }
    },
    "xml":{
        "name":"collectionsGroup"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : members

Type: array

The list of members in the collections sharing group.

Show Source

Array of: object Members

The list of members in the sharing group.

{
    "type":"array",
    "description":"The list of members in the collections sharing group.",
    "items":{
        "$ref":"#/components/schemas/Members"
    }
}

Nested Schema : ResourceRef

Type: object

Show Source

id(required): string

The ID.
uri: string

The Uniform Resource Identifier (URI) associated with the resource.

{
    "required":[
        "id"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "uri":{
            "type":"string",
            "description":"The Uniform Resource Identifier (URI) associated with the resource."
        }
    }
}

Nested Schema : Notes

Type: object

Show Source

accountId(required): string

The ID of the account associated with the note.
amount: number

The amount associated with the note. It can be a payment amount, adjustment amount, or so on.
billId: string

The ID of the bill associated with the note.
billUnitId: string

The ID of the bill unit associated with the note.
closedDate: string (date-time)

The date and time the note was resolved.
comments: array comments

The list of comments associated with the note.
count: integer (int32)

The number of comments associated with the note.
domainId: integer (int32)

The domain ID associated with the note.
effectiveDate: string (date-time)

The date and time the comment was posted.
eventId: string

The ID of the event associated with the note.
extension: object extension

The extended attributes.
header: string

The header associated with the note.
id: string

The ID.
itemId: string

The ID of the item associated with the note.
reasonId: integer (int32)

The reason ID associated with the note. Possible values are stored in /config/reason_code_scope objects. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the reasons.locale file.
serviceId: string

The service ID associated with the note.
status: number

The note's status: not set (100), resolved (101), or unresolved (102). The default value is 102.
subType: integer (int32)

The note's subtype. Possible values are stored in the /config/note_type object. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the note.locale file.
type: integer (int32)

The note's type. Possible values are stored in the /config/note_type object. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the note.locale file.

{
    "required":[
        "accountId"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "accountId":{
            "type":"string",
            "description":"The ID of the account associated with the note."
        },
        "amount":{
            "type":"number",
            "description":"The amount associated with the note. It can be a payment amount, adjustment amount, or so on."
        },
        "billUnitId":{
            "type":"string",
            "description":"The ID of the bill unit associated with the note."
        },
        "billId":{
            "type":"string",
            "description":"The ID of the bill associated with the note."
        },
        "closedDate":{
            "type":"string",
            "description":"The date and time the note was resolved.",
            "format":"date-time"
        },
        "count":{
            "type":"integer",
            "description":"The number of comments associated with the note.",
            "format":"int32"
        },
        "effectiveDate":{
            "type":"string",
            "description":"The date and time the comment was posted.",
            "format":"date-time"
        },
        "eventId":{
            "type":"string",
            "description":"The ID of the event associated with the note."
        },
        "header":{
            "type":"string",
            "description":"The header associated with the note."
        },
        "itemId":{
            "type":"string",
            "description":"The ID of the item associated with the note."
        },
        "subType":{
            "type":"integer",
            "description":"The note's subtype. Possible values are stored in the <b>/config/note_type</b> object. See <a href=\"http://docs.oracle.com/pls/topic/lookup?ctx=brm120&id=GUID-D733989B-5B0E-4643-B70A-77B62A73314D\">Localizing and Customizing Strings</a> in <i>BRM Developer's Guide</i> for information about how to customize these values using the <b>note.</b><i>locale</i> file.",
            "format":"int32"
        },
        "type":{
            "type":"integer",
            "description":"The note's type. Possible values are stored in the <b>/config/note_type</b> object. See <a href=\"http://docs.oracle.com/pls/topic/lookup?ctx=brm120&id=GUID-D733989B-5B0E-4643-B70A-77B62A73314D\">Localizing and Customizing Strings</a> in <i>BRM Developer's Guide</i> for information about how to customize these values using the <b>note.</b><i>locale</i> file.",
            "format":"int32"
        },
        "domainId":{
            "type":"integer",
            "description":"The domain ID associated with the note.",
            "format":"int32"
        },
        "reasonId":{
            "type":"integer",
            "description":"The reason ID associated with the note. Possible values are stored in <b>/config/reason_code_scope</b> objects. See <a href=\"http://docs.oracle.com/pls/topic/lookup?ctx=brm120&id=GUID-D733989B-5B0E-4643-B70A-77B62A73314D\">Localizing and Customizing Strings</a> in <i>BRM Developer's Guide</i> for information about how to customize these values using the <b>reasons.</b><i>locale</i> file.",
            "format":"int32"
        },
        "serviceId":{
            "type":"string",
            "description":"The service ID associated with the note."
        },
        "status":{
            "type":"number",
            "description":"The note's status: not set (<b>100</b>), resolved (<b>101</b>), or unresolved (<b>102</b>). The default value is <b>102</b>."
        },
        "comments":{
            "type":"array",
            "description":"The list of comments associated with the note.",
            "items":{
                "$ref":"#/components/schemas/Comments"
            }
        }
    }
}

Nested Schema : Members

Type: object

The list of members in the sharing group.

Show Source

index: integer (int32)

The position of the service in the index. For example, the first item in a list would have an index value of 1.
markAsDelete: boolean

Whether the service referenced is being deleted (true) or added (false) to the sharing group.
serviceRef: object ResourceRef

{
    "type":"object",
    "properties":{
        "serviceRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "markAsDelete":{
            "type":"boolean",
            "description":"Whether the service referenced is being deleted (<b>true</b>) or added (<b>false</b>) to the sharing group."
        },
        "index":{
            "type":"integer",
            "description":"The position of the service in the index. For example, the first item in a list would have an <b>index</b> value of <b>1</b>.",
            "format":"int32"
        }
    },
    "description":"The list of members in the sharing group."
}

Nested Schema : comments

Type: array

The list of comments associated with the note.

Show Source

Array of: object Comments

The list of comments associated with the note.

{
    "type":"array",
    "description":"The list of comments associated with the note.",
    "items":{
        "$ref":"#/components/schemas/Comments"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : Comments

Type: object

The list of comments associated with the note.

Show Source

comment(required): string

The comment.
csrAccountId: string

The CSR's account ID.
csrFirstName: string

The CSR's first name.
csrLastName: string

The CSR's last name.
csrLoginId: string

The login ID associated with the CSR.
entryDate: string (date-time)

The date and time the comment was entered by the CSR.
externalUser: string

The external user.
trackingId: string

The tracking ID.

{
    "required":[
        "comment"
    ],
    "type":"object",
    "properties":{
        "csrLoginId":{
            "type":"string",
            "description":"The login ID associated with the CSR."
        },
        "csrFirstName":{
            "type":"string",
            "description":"The CSR's first name."
        },
        "csrLastName":{
            "type":"string",
            "description":"The CSR's last name."
        },
        "csrAccountId":{
            "type":"string",
            "description":"The CSR's account ID."
        },
        "externalUser":{
            "type":"string",
            "description":"The external user."
        },
        "comment":{
            "type":"string",
            "description":"The comment."
        },
        "trackingId":{
            "type":"string",
            "description":"The tracking ID."
        },
        "entryDate":{
            "type":"string",
            "description":"The date and time the comment was entered by the CSR.",
            "format":"date-time"
        }
    },
    "description":"The list of comments associated with the note."
}

Root Schema : schema

Type: object

Show Source

extension: object extension

The extended attributes.
members: array members

The list of members in the collections sharing group.
name: string

The name of the collections sharing group.
newParentBillUnitRef: object ResourceRef
notes: object Notes
parentBillUnitDue: number

The amount owed by the collections sharing group owner.
parentBillUnitRef: object ResourceRef

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "parentBillUnitRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "newParentBillUnitRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "name":{
            "type":"string",
            "description":"The name of the collections sharing group."
        },
        "parentBillUnitDue":{
            "type":"number",
            "description":"The amount owed by the collections sharing group owner."
        },
        "notes":{
            "$ref":"#/components/schemas/Notes"
        },
        "members":{
            "type":"array",
            "description":"The list of members in the collections sharing group.",
            "items":{
                "$ref":"#/components/schemas/Members"
            }
        }
    },
    "xml":{
        "name":"collectionsGroup"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : members

Type: array

The list of members in the collections sharing group.

Show Source

Array of: object Members

The list of members in the sharing group.

{
    "type":"array",
    "description":"The list of members in the collections sharing group.",
    "items":{
        "$ref":"#/components/schemas/Members"
    }
}

Nested Schema : ResourceRef

Type: object

Show Source

id(required): string

The ID.
uri: string

The Uniform Resource Identifier (URI) associated with the resource.

{
    "required":[
        "id"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "uri":{
            "type":"string",
            "description":"The Uniform Resource Identifier (URI) associated with the resource."
        }
    }
}

Nested Schema : Notes

Type: object

Show Source

accountId(required): string

The ID of the account associated with the note.
amount: number

The amount associated with the note. It can be a payment amount, adjustment amount, or so on.
billId: string

The ID of the bill associated with the note.
billUnitId: string

The ID of the bill unit associated with the note.
closedDate: string (date-time)

The date and time the note was resolved.
comments: array comments

The list of comments associated with the note.
count: integer (int32)

The number of comments associated with the note.
domainId: integer (int32)

The domain ID associated with the note.
effectiveDate: string (date-time)

The date and time the comment was posted.
eventId: string

The ID of the event associated with the note.
extension: object extension

The extended attributes.
header: string

The header associated with the note.
id: string

The ID.
itemId: string

The ID of the item associated with the note.
reasonId: integer (int32)

The reason ID associated with the note. Possible values are stored in /config/reason_code_scope objects. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the reasons.locale file.
serviceId: string

The service ID associated with the note.
status: number

The note's status: not set (100), resolved (101), or unresolved (102). The default value is 102.
subType: integer (int32)

The note's subtype. Possible values are stored in the /config/note_type object. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the note.locale file.
type: integer (int32)

The note's type. Possible values are stored in the /config/note_type object. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the note.locale file.

{
    "required":[
        "accountId"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "accountId":{
            "type":"string",
            "description":"The ID of the account associated with the note."
        },
        "amount":{
            "type":"number",
            "description":"The amount associated with the note. It can be a payment amount, adjustment amount, or so on."
        },
        "billUnitId":{
            "type":"string",
            "description":"The ID of the bill unit associated with the note."
        },
        "billId":{
            "type":"string",
            "description":"The ID of the bill associated with the note."
        },
        "closedDate":{
            "type":"string",
            "description":"The date and time the note was resolved.",
            "format":"date-time"
        },
        "count":{
            "type":"integer",
            "description":"The number of comments associated with the note.",
            "format":"int32"
        },
        "effectiveDate":{
            "type":"string",
            "description":"The date and time the comment was posted.",
            "format":"date-time"
        },
        "eventId":{
            "type":"string",
            "description":"The ID of the event associated with the note."
        },
        "header":{
            "type":"string",
            "description":"The header associated with the note."
        },
        "itemId":{
            "type":"string",
            "description":"The ID of the item associated with the note."
        },
        "subType":{
            "type":"integer",
            "description":"The note's subtype. Possible values are stored in the <b>/config/note_type</b> object. See <a href=\"http://docs.oracle.com/pls/topic/lookup?ctx=brm120&id=GUID-D733989B-5B0E-4643-B70A-77B62A73314D\">Localizing and Customizing Strings</a> in <i>BRM Developer's Guide</i> for information about how to customize these values using the <b>note.</b><i>locale</i> file.",
            "format":"int32"
        },
        "type":{
            "type":"integer",
            "description":"The note's type. Possible values are stored in the <b>/config/note_type</b> object. See <a href=\"http://docs.oracle.com/pls/topic/lookup?ctx=brm120&id=GUID-D733989B-5B0E-4643-B70A-77B62A73314D\">Localizing and Customizing Strings</a> in <i>BRM Developer's Guide</i> for information about how to customize these values using the <b>note.</b><i>locale</i> file.",
            "format":"int32"
        },
        "domainId":{
            "type":"integer",
            "description":"The domain ID associated with the note.",
            "format":"int32"
        },
        "reasonId":{
            "type":"integer",
            "description":"The reason ID associated with the note. Possible values are stored in <b>/config/reason_code_scope</b> objects. See <a href=\"http://docs.oracle.com/pls/topic/lookup?ctx=brm120&id=GUID-D733989B-5B0E-4643-B70A-77B62A73314D\">Localizing and Customizing Strings</a> in <i>BRM Developer's Guide</i> for information about how to customize these values using the <b>reasons.</b><i>locale</i> file.",
            "format":"int32"
        },
        "serviceId":{
            "type":"string",
            "description":"The service ID associated with the note."
        },
        "status":{
            "type":"number",
            "description":"The note's status: not set (<b>100</b>), resolved (<b>101</b>), or unresolved (<b>102</b>). The default value is <b>102</b>."
        },
        "comments":{
            "type":"array",
            "description":"The list of comments associated with the note.",
            "items":{
                "$ref":"#/components/schemas/Comments"
            }
        }
    }
}

Nested Schema : Members

Type: object

The list of members in the sharing group.

Show Source

index: integer (int32)

The position of the service in the index. For example, the first item in a list would have an index value of 1.
markAsDelete: boolean

Whether the service referenced is being deleted (true) or added (false) to the sharing group.
serviceRef: object ResourceRef

{
    "type":"object",
    "properties":{
        "serviceRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "markAsDelete":{
            "type":"boolean",
            "description":"Whether the service referenced is being deleted (<b>true</b>) or added (<b>false</b>) to the sharing group."
        },
        "index":{
            "type":"integer",
            "description":"The position of the service in the index. For example, the first item in a list would have an <b>index</b> value of <b>1</b>.",
            "format":"int32"
        }
    },
    "description":"The list of members in the sharing group."
}

Nested Schema : comments

Type: array

The list of comments associated with the note.

Show Source

Array of: object Comments

The list of comments associated with the note.

{
    "type":"array",
    "description":"The list of comments associated with the note.",
    "items":{
        "$ref":"#/components/schemas/Comments"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : Comments

Type: object

The list of comments associated with the note.

Show Source

comment(required): string

The comment.
csrAccountId: string

The CSR's account ID.
csrFirstName: string

The CSR's first name.
csrLastName: string

The CSR's last name.
csrLoginId: string

The login ID associated with the CSR.
entryDate: string (date-time)

The date and time the comment was entered by the CSR.
externalUser: string

The external user.
trackingId: string

The tracking ID.

{
    "required":[
        "comment"
    ],
    "type":"object",
    "properties":{
        "csrLoginId":{
            "type":"string",
            "description":"The login ID associated with the CSR."
        },
        "csrFirstName":{
            "type":"string",
            "description":"The CSR's first name."
        },
        "csrLastName":{
            "type":"string",
            "description":"The CSR's last name."
        },
        "csrAccountId":{
            "type":"string",
            "description":"The CSR's account ID."
        },
        "externalUser":{
            "type":"string",
            "description":"The external user."
        },
        "comment":{
            "type":"string",
            "description":"The comment."
        },
        "trackingId":{
            "type":"string",
            "description":"The tracking ID."
        },
        "entryDate":{
            "type":"string",
            "description":"The date and time the comment was entered by the CSR.",
            "format":"date-time"
        }
    },
    "description":"The list of comments associated with the note."
}

Response

200 Response

The collections group was updated successfully.

500 Response

An internal server error occurred.

Examples

This example shows how to update a collections group name 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/group/0.0.0.1+-group-collections_targets+168355' -H 'content-type: application/json' -d @updateCollectionsGroup.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.
updateCollectionsGroup.json is the JSON file that specifies the details to update.

Example of Request Body

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

{
   "parentBillUnitRef": {
      "id": "0.0.0.1+-billinfo+139726",
      "uri": null
   },	
   "name": "Collections Group 3a"
}

Example of Response Body

If successful, the response code 200 is returned with no response body.