Get Bill Items for a Bill
get
/bcws/webresources/v1.0/items/bill/{id}
Gets the bill items that are associated with the specified bill. You can optionally specify to retrieve only open, pending, closed, or all bill items for the bill.
Request
Path Parameters
-
id(required): string
The ID of the bill.
Query Parameters
-
type(required): string
The type of bill items to retrieve:
- open retrieves all open bill items.
- pending retrieves all pending bill items.
- closed retrieves all closed bill items.
- all retrieves all bill items. This is the default.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/xml
- application/json
200 Response
The bill items were returned successfully.
Nested Schema : billItem
Type:
object
The bill item details.
Show Source
-
accountName: string
The name of the account.
-
accountNumber: string
The account number associated with the bill item.
-
accountRef: object
ResourceRef
-
adjusted: number
The total amount from debit and credit adjustments made to the bill item.
-
aliasList: array
aliasList
The list of aliases in the bill item.
-
amount(required): number
The amount of the bill item.
-
arBillinfoRef: object
ResourceRef
-
arBillRef: object
ResourceRef
-
billInfoId: string
The ID of the /billinfo object.
-
billinfoRef: object
ResourceRef
-
billNo: string
The bill number.
-
billRef: object
ResourceRef
-
closedDate: string
(date-time)
The date and time the bill item was closed. If the bill item is reopened for an adjustment, this is reset until the bill item is closed again.
-
creationDate: string
(date-time)
The date and time the bill item was created.
-
currency: integer
(int32)
The currency for the bill item, copied from the currency of the associated account.
-
deltaDue: number
The delta amount due.
-
discount: number
The amount discounted for the bill item.
-
disputed: number
The total amount from disputes associated with the bill item.
-
due: number
The amount due for the bill item.
-
dueDate: string
(date-time)
The date when the amount in the bill item is due.
-
extension: object
extension
The extended attributes.
-
firstName: string
The first name of the account holder.
-
id(required): string
The ID.
-
itemNo: string
The bill item's number.
-
lastName: string
The last name of the account holder.
-
login: string
The username associated with the bill item.
-
name: string
The bill item's name.
-
received: number
The amount of payments or credits applied to the bill item.
-
serviceRef: object
ResourceRef
-
serviceTypeName: string
The name of the service type.
-
status: string
The status of the bill item: active (10100), inactive (10102), or closed (10103)
-
transfered: number
The amount transferred out of the bill item.
-
type: string
The bill item's type.
-
writeoff: number
The amount written off for the bill item.
Nested Schema : ResourceRef
Type:
Show Source
object
-
id(required): string
The ID.
-
uri: string
The Uniform Resource Identifier (URI) associated with the resource.
Nested Schema : aliasList
Type:
array
The list of aliases in the bill item.
Show Source
-
Array of:
object AliasList
The list of aliases associated with the service.
Nested Schema : extension
Type:
object
The extended attributes.
400 Response
The request isn't valid.
500 Response
An internal server error occurred.
Examples
This example shows how to get a bill's open bill items by submitting a GET request on the REST resource using cURL. For more information about cURL, see "Use cURL".
cURL Command
curl -X GET 'http://hostname:port/bcws/webresources/version/items/bill/0.0.0.1+-bill+211720?type=open'
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.
Example of Response Body
This example shows the contents of the response body in JSON format.
[
{
"extension": null,
"id": "0.0.0.1+-item-cycle_forward+215497",
"name": "Cycle forward",
"type": "/item/cycle_forward",
"accountRef": {
"id": "0.0.0.1+-account+57615",
"uri": null
},
"arBillinfoRef": null,
"arBillRef": {
"id": "0.0.0.1+-bill+211720",
"uri": null
},
"billRef": {
"id": "0.0.0.1+-bill+211720",
"uri": null
},
"serviceRef": {
"id": "0.0.0.1+-service-ip+166570",
"uri": null
},
"billinfoRef": null,
"creationDate": null,
"closedDate": null,
"currency": null,
"deltaDue": null,
"disputed": 0,
"adjusted": 0,
"due": 29.95,
"dueDate": 1610265600000,
"itemNo": "B1-646,3",
"login": "IP_Service",
"received": 0,
"transfered": 0,
"writeoff": 0,
"amount": null,
"discount": null,
"billNo": "B1-646",
"billInfoId": "Bill Unit(1)",
"accountName": null,
"firstName": null,
"lastName": null,
"serviceTypeName": "ip",
"accountNumber": "0.0.0.1-57615",
"aliasList": [],
"status": null
},
{
"extension": null,
"id": "0.0.0.1+-item-cycle_forward+216105",
"name": "Cycle forward",
"type": "/item/cycle_forward",
"accountRef": {
"id": "0.0.0.1+-account+57615",
"uri": null
},
"arBillinfoRef": null,
"arBillRef": {
"id": "0.0.0.1+-bill+211720",
"uri": null
},
"billRef": {
"id": "0.0.0.1+-bill+211720",
"uri": null
},
"serviceRef": {
"id": "0.0.0.1+-service-ip+156801",
"uri": null
},
"billinfoRef": null,
"creationDate": null,
"closedDate": null,
"currency": null,
"deltaDue": null,
"disputed": 0,
"adjusted": 0,
"due": 10,
"dueDate": 1610265600000,
"itemNo": "B1-646,6",
"login": "ip0",
"received": 0,
"transfered": 0,
"writeoff": 0,
"amount": null,
"discount": null,
"billNo": "B1-646",
"billInfoId": "Bill Unit(1)",
"accountName": null,
"firstName": null,
"lastName": null,
"serviceTypeName": "ip",
"accountNumber": "0.0.0.1-57615",
"aliasList": [],
"status": null
}
]