Jump to

• Request
• Response
• Examples

Allocate a Payment to Bill Items

post

/bcws/webresources/v1.0/allocations/payment/{id}/items

Allocates a payment to one or more bill items.

Request

Path Parameters

• id(required): string
  The ID of the payment to allocate.

Supported Media Types

• application/xml
• application/json

Request Body - application/json ()

Root Schema : schema

Type: array

Show Source

• Array of: object billItem
  The bill item details.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/BillItem"
    }
}

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.
• transferInto: array transferInto
• transferOut: array transferOut
• type: string
  The bill item's type.
• writeoff: number
  The amount written off for the bill item.

{
    "required":[
        "amount",
        "id"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The bill item's name."
        },
        "type":{
            "type":"string",
            "description":"The bill item's type."
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "arBillinfoRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "arBillRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "billRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "serviceRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "billinfoRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "creationDate":{
            "type":"string",
            "description":"The date and time the bill item was created.",
            "format":"date-time"
        },
        "closedDate":{
            "type":"string",
            "description":"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.",
            "format":"date-time"
        },
        "currency":{
            "type":"integer",
            "description":"The currency for the bill item, copied from the currency of the associated account.",
            "format":"int32"
        },
        "deltaDue":{
            "type":"number",
            "description":"The delta amount due."
        },
        "disputed":{
            "type":"number",
            "description":"The total amount from disputes associated with the bill item."
        },
        "adjusted":{
            "type":"number",
            "description":"The total amount from debit and credit adjustments made to the bill item."
        },
        "due":{
            "type":"number",
            "description":"The amount due for the bill item."
        },
        "dueDate":{
            "type":"string",
            "description":"The date when the amount in the bill item is due.",
            "format":"date-time"
        },
        "itemNo":{
            "type":"string",
            "description":"The bill item's number."
        },
        "login":{
            "type":"string",
            "description":"The username associated with the bill item."
        },
        "received":{
            "type":"number",
            "description":"The amount of payments or credits applied to the bill item."
        },
        "transfered":{
            "type":"number",
            "description":"The amount transferred out of the bill item."
        },
        "writeoff":{
            "type":"number",
            "description":"The amount written off for the bill item."
        },
        "amount":{
            "type":"number",
            "description":"The amount of the bill item."
        },
        "discount":{
            "type":"number",
            "description":"The amount discounted for the bill item."
        },
        "billNo":{
            "type":"string",
            "description":"The bill number."
        },
        "billInfoId":{
            "type":"string",
            "description":"The ID of the /billinfo object."
        },
        "accountName":{
            "type":"string",
            "description":"The name of the account."
        },
        "firstName":{
            "type":"string",
            "description":"The first name of the account holder."
        },
        "lastName":{
            "type":"string",
            "description":"The last name of the account holder."
        },
        "serviceTypeName":{
            "type":"string",
            "description":"The name of the service type."
        },
        "accountNumber":{
            "type":"string",
            "description":"The account number associated with the bill item."
        },
        "aliasList":{
            "type":"array",
            "description":"The list of aliases in the bill item.",
            "items":{
                "$ref":"#/components/schemas/AliasList"
            }
        },
        "status":{
            "type":"string",
            "description":"The status of the bill item: active (<b>10100</b>), inactive (<b>10102</b>), or closed (<b>10103</b>)"
        },
        "transferInto":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/TransferInto"
            }
        },
        "transferOut":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/TransferOut"
            }
        }
    },
    "description":"The bill item details.",
    "xml":{
        "name":"billItem"
    }
}

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 : 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.

{
    "type":"array",
    "description":"The list of aliases in the bill item.",
    "items":{
        "$ref":"#/components/schemas/AliasList"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : transferInto

Type: array

Show Source

• Array of: object TransferInto

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/TransferInto"
    }
}

Nested Schema : transferOut

Type: array

Show Source

• Array of: object TransferOut

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/TransferOut"
    }
}

Nested Schema : AliasList

Type: object

The list of aliases associated with the service.

Show Source

• elem: integer (int32)
• name: string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "elem":{
            "type":"integer",
            "format":"int32",
            "xml":{
                "attribute":true
            }
        }
    },
    "description":"The list of aliases associated with the service."
}

Nested Schema : TransferInto

Type: object

Show Source

• creationDate: string (date-time)
  The creation date for the bill item from which the balance was transferred.
• due: number
  The due date for the bill item from which the balance was transferred.
• itemNo: string
  The bill item number for the bill item from which the balance was transferred.
• itemRef: object ResourceRef
• name(required): string
  The name of the bill item from which the balance was transferred.
• transfered: number
  The amount transferred from the source bill item.

{
    "required":[
        "name"
    ],
    "type":"object",
    "properties":{
        "itemNo":{
            "type":"string",
            "description":"The bill item number for the bill item from which the balance was transferred."
        },
        "name":{
            "type":"string",
            "description":"The name of the bill item from which the balance was transferred."
        },
        "due":{
            "type":"number",
            "description":"The due date for the bill item from which the balance was transferred."
        },
        "creationDate":{
            "type":"string",
            "description":"The creation date for the bill item from which the balance was transferred.",
            "format":"date-time"
        },
        "itemRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "transfered":{
            "type":"number",
            "description":"The amount transferred from the source bill item."
        }
    }
}

Nested Schema : TransferOut

Type: object

Show Source

• creationDate: string (date-time)
  The creation date for the bill item to which the balance was transferred.
• due: number
  The due date for the bill item to which the balance was transferred.
• itemNo: string
  The bill item number for the bill item to which the balance was transferred.
• itemRef: object ResourceRef
• name(required): string
  The name of the bill item to which the balance was transferred.
• transfered: number
  The amount transferred to the target bill item.

{
    "required":[
        "name"
    ],
    "type":"object",
    "properties":{
        "itemNo":{
            "type":"string",
            "description":"The bill item number for the bill item to which the balance was transferred."
        },
        "name":{
            "type":"string",
            "description":"The name of the bill item to which the balance was transferred."
        },
        "due":{
            "type":"number",
            "description":"The due date for the bill item to which the balance was transferred."
        },
        "creationDate":{
            "type":"string",
            "description":"The creation date for the bill item to which the balance was transferred.",
            "format":"date-time"
        },
        "itemRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "transfered":{
            "type":"number",
            "description":"The amount transferred to the target bill item."
        }
    }
}

Request Body - application/xml ()

Root Schema : schema

Type: array

Show Source

• Array of: object billItem
  The bill item details.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/BillItem"
    }
}

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.
• transferInto: array transferInto
• transferOut: array transferOut
• type: string
  The bill item's type.
• writeoff: number
  The amount written off for the bill item.

{
    "required":[
        "amount",
        "id"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The bill item's name."
        },
        "type":{
            "type":"string",
            "description":"The bill item's type."
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "arBillinfoRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "arBillRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "billRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "serviceRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "billinfoRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "creationDate":{
            "type":"string",
            "description":"The date and time the bill item was created.",
            "format":"date-time"
        },
        "closedDate":{
            "type":"string",
            "description":"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.",
            "format":"date-time"
        },
        "currency":{
            "type":"integer",
            "description":"The currency for the bill item, copied from the currency of the associated account.",
            "format":"int32"
        },
        "deltaDue":{
            "type":"number",
            "description":"The delta amount due."
        },
        "disputed":{
            "type":"number",
            "description":"The total amount from disputes associated with the bill item."
        },
        "adjusted":{
            "type":"number",
            "description":"The total amount from debit and credit adjustments made to the bill item."
        },
        "due":{
            "type":"number",
            "description":"The amount due for the bill item."
        },
        "dueDate":{
            "type":"string",
            "description":"The date when the amount in the bill item is due.",
            "format":"date-time"
        },
        "itemNo":{
            "type":"string",
            "description":"The bill item's number."
        },
        "login":{
            "type":"string",
            "description":"The username associated with the bill item."
        },
        "received":{
            "type":"number",
            "description":"The amount of payments or credits applied to the bill item."
        },
        "transfered":{
            "type":"number",
            "description":"The amount transferred out of the bill item."
        },
        "writeoff":{
            "type":"number",
            "description":"The amount written off for the bill item."
        },
        "amount":{
            "type":"number",
            "description":"The amount of the bill item."
        },
        "discount":{
            "type":"number",
            "description":"The amount discounted for the bill item."
        },
        "billNo":{
            "type":"string",
            "description":"The bill number."
        },
        "billInfoId":{
            "type":"string",
            "description":"The ID of the /billinfo object."
        },
        "accountName":{
            "type":"string",
            "description":"The name of the account."
        },
        "firstName":{
            "type":"string",
            "description":"The first name of the account holder."
        },
        "lastName":{
            "type":"string",
            "description":"The last name of the account holder."
        },
        "serviceTypeName":{
            "type":"string",
            "description":"The name of the service type."
        },
        "accountNumber":{
            "type":"string",
            "description":"The account number associated with the bill item."
        },
        "aliasList":{
            "type":"array",
            "description":"The list of aliases in the bill item.",
            "items":{
                "$ref":"#/components/schemas/AliasList"
            }
        },
        "status":{
            "type":"string",
            "description":"The status of the bill item: active (<b>10100</b>), inactive (<b>10102</b>), or closed (<b>10103</b>)"
        },
        "transferInto":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/TransferInto"
            }
        },
        "transferOut":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/TransferOut"
            }
        }
    },
    "description":"The bill item details.",
    "xml":{
        "name":"billItem"
    }
}

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 : 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.

{
    "type":"array",
    "description":"The list of aliases in the bill item.",
    "items":{
        "$ref":"#/components/schemas/AliasList"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : transferInto

Type: array

Show Source

• Array of: object TransferInto

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/TransferInto"
    }
}

Nested Schema : transferOut

Type: array

Show Source

• Array of: object TransferOut

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/TransferOut"
    }
}

Nested Schema : AliasList

Type: object

The list of aliases associated with the service.

Show Source

• elem: integer (int32)
• name: string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "elem":{
            "type":"integer",
            "format":"int32",
            "xml":{
                "attribute":true
            }
        }
    },
    "description":"The list of aliases associated with the service."
}

Nested Schema : TransferInto

Type: object

Show Source

• creationDate: string (date-time)
  The creation date for the bill item from which the balance was transferred.
• due: number
  The due date for the bill item from which the balance was transferred.
• itemNo: string
  The bill item number for the bill item from which the balance was transferred.
• itemRef: object ResourceRef
• name(required): string
  The name of the bill item from which the balance was transferred.
• transfered: number
  The amount transferred from the source bill item.

{
    "required":[
        "name"
    ],
    "type":"object",
    "properties":{
        "itemNo":{
            "type":"string",
            "description":"The bill item number for the bill item from which the balance was transferred."
        },
        "name":{
            "type":"string",
            "description":"The name of the bill item from which the balance was transferred."
        },
        "due":{
            "type":"number",
            "description":"The due date for the bill item from which the balance was transferred."
        },
        "creationDate":{
            "type":"string",
            "description":"The creation date for the bill item from which the balance was transferred.",
            "format":"date-time"
        },
        "itemRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "transfered":{
            "type":"number",
            "description":"The amount transferred from the source bill item."
        }
    }
}

Nested Schema : TransferOut

Type: object

Show Source

• creationDate: string (date-time)
  The creation date for the bill item to which the balance was transferred.
• due: number
  The due date for the bill item to which the balance was transferred.
• itemNo: string
  The bill item number for the bill item to which the balance was transferred.
• itemRef: object ResourceRef
• name(required): string
  The name of the bill item to which the balance was transferred.
• transfered: number
  The amount transferred to the target bill item.

{
    "required":[
        "name"
    ],
    "type":"object",
    "properties":{
        "itemNo":{
            "type":"string",
            "description":"The bill item number for the bill item to which the balance was transferred."
        },
        "name":{
            "type":"string",
            "description":"The name of the bill item to which the balance was transferred."
        },
        "due":{
            "type":"number",
            "description":"The due date for the bill item to which the balance was transferred."
        },
        "creationDate":{
            "type":"string",
            "description":"The creation date for the bill item to which the balance was transferred.",
            "format":"date-time"
        },
        "itemRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "transfered":{
            "type":"number",
            "description":"The amount transferred to the target bill item."
        }
    }
}

Back to Top

Response

201 Response

The payment was allocated successfully.

500 Response

An internal server error occurred.

Back to Top

Examples

This example shows how to allocate a payment to bill items 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/v1.0/allocations/payment/0.0.0.1+-item-payment+128048/items' -H 'content-type: application/json' -d @allocateToItems.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.
• allocateToItems.json is the JSON file that specifies the payment allocation to make.

Example of Request Body

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

[
  {
    "extension": null,
    "id": "0.0.0.1+-item-cycle_forward+169656",
    "name": "Cycle forward",
    "type": "/item/cycle_forward",
    "accountRef": {
      "id": "0.0.0.1+-account+81329",
      "uri": null
    },
    "arBillinfoRef": null,
    "arBillRef": {
      "id": "0.0.0.1+-bill+143952",
      "uri": null
    },
    "billRef": {
      "id": "0.0.0.1+-bill+143952",
      "uri": null
    },
    "serviceRef": {
      "id": "0.0.0.1+-service-ip+78705",
      "uri": null
    },
    "billinfoRef": null,
    "creationDate": null,
    "closedDate": null,
    "currency": null,
    "deltaDue": null,
    "disputed": 0,
    "adjusted": -0.25,
    "due": 9.7,
    "itemNo": "B1-591,3",
    "login": "34",
    "received": 0,
    "transfered": 0,
    "writeoff": 0,
    "amount": 1,
    "discount": null,
    "billNo": "B1-591",
    "billInfoId": "Bill Unit(1)",
    "firstName": "Marie",
    "lastName": "Fortin",
    "serviceTypeName": "ip",
    "accountNumber": "0.0.0.1-81329",
    "aliasList": [],
    "status": null
  }
]

Example of Response Body

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

Back to Top