Create a Disputed Balance
post
/disputeBalance
Creates a disputed balance.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
The disputed balance to create.
Root Schema : Dispute Balance Create Oracle
Type:
object
Title:
Dispute Balance Create Oracle
A disputed balance, used in DisputeBalance create requests.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
actionType: string
Title:
Action Type
Allowed Values:[ "BillDispute", "EventDispute", "ItemDispute" ]
The type of balance being disputed. -
amount(required): object
object
Quantity
Title:
Quantity
The quantity of an object. -
bieId(required): array
array
bieId
The bill, item, or event IDs associated with the dispute.
-
description: string
Title:
Dispute Description
The dispute's description. -
partyAccount: object
object
Party Account Ref
Title:
Party Account Ref
A reference to a party account. -
reason: string
Title:
Dispute Reason
The reason for the dispute. -
taxTreatment: string
Title:
Tax Treatment
Allowed Values:[ "TaxIncluded", "TaxExcluded", "TaxOnly" ]
The status of taxes on the dispute.
Nested Schema : Quantity
Type:
object
Title:
Quantity
The quantity of an object.
Show Source
-
amount: number
(float)
Title:
Amount
Default Value:1
A numeric value. -
units: string
Title:
Units
A unit. For example, MB or minutes.
Nested Schema : bieId
Type:
array
The bill, item, or event IDs associated with the dispute.
Show Source
-
Array of:
object BIEField Oracle
Title:
BIEField Oracle
A bill, item, or event, extended for BRM REST Services Manager
Nested Schema : Party Account Ref
Type:
object
Title:
Party Account Ref
A reference to a party account.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType: string
Title:
Referred Type
The object's type in the target system, if baseType and type need further disambiguation. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
description: string
Title:
Description
The party account's description. -
href: string
Title:
Href
The party account's href. -
id(required): string
Title:
Account ID
The party account's ID. -
name: string
Title:
Name
The party account's name. -
status: string
Title:
Status
The overall status of the account. For example, due, paid, or in arrears.
Nested Schema : BIEField Oracle
Type:
object
Title:
BIEField Oracle
A bill, item, or event, extended for BRM REST Services Manager
Show Source
-
href: string
Title:
Href
The bill, item, or event href. -
id(required): string
Title:
ID
The bill, item, or event ID.
Response
Supported Media Types
- application/json;charset=utf-8
201 Response
Created
Root Schema : Dispute Balance Oracle
Type:
object
Title:
Dispute Balance Oracle
A disputed balance, extended for BRM REST Services Manager.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
actionType: string
Title:
Action Type
Allowed Values:[ "BillDispute", "ItemDispute", "EventDispute" ]
The type of balance being disputed. -
amount: object
object
Quantity
Title:
Quantity
The quantity of an object. -
bill(required): object
object
Bill Ref
Title:
Bill Ref
A reference to a bill. -
billEvent: array
array
billEvent
Events associated with the dispute.
-
billingCycleSpecification(required): object
object
Billing Cycle Specification Ref Oracle
Title:
Billing Cycle Specification Ref Oracle
A reference to a billing cycle specification, extended for BRM REST Services Manager. -
billItem: array
array
billItem
The bill items associated with the dispute.
-
confirmationDate: string
(date-time)
Title:
Confirmation Date
The date the dispute was confirmed. -
description: string
Title:
Dispute Description
The dispute's description. -
discount: string
Title:
Discount
A discount associated with the dispute. -
disputeNo: string
Title:
Dispute Number
The dispute number to displayed on a bill. -
href(required): string
Title:
Href
The disputed balance's href. -
id(required): string
Title:
Dispute ID
The disputed balance's ID. -
partyAccount: object
object
Party Account Ref
Title:
Party Account Ref
A reference to a party account. -
reason: string
Title:
Dispute Reason
The reason for the dispute. -
requestedDate: string
(date-time)
Title:
Requested Date
The date the request was made. -
settlementId: string
Title:
Settlement ID
The ID of the settlement associated with the dispute. -
status: string
Title:
Status
Allowed Values:[ "Settled", "Open" ]
The dispute's status. -
taxAmount: object
object
Quantity
Title:
Quantity
The quantity of an object. -
taxTreatment: string
Title:
Tax Treatment
Allowed Values:[ "TaxIncluded", "TaxExcluded", "TaxOnly" ]
The status of taxes on the dispute.
Nested Schema : Quantity
Type:
object
Title:
Quantity
The quantity of an object.
Show Source
-
amount: number
(float)
Title:
Amount
Default Value:1
A numeric value. -
units: string
Title:
Units
A unit. For example, MB or minutes.
Nested Schema : Bill Ref
Type:
object
Title:
Bill Ref
A reference to a bill.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType: string
Title:
Referred Type
The actual type of the target instance when needed for disambiguation. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships -
@type: string
Title:
Type
The object's subclass. -
href: string
Title:
Bill Href
The bill's href. -
id: string
Title:
Bill ID
The bill's ID.
Nested Schema : billEvent
Type:
array
Events associated with the dispute.
Show Source
-
Array of:
object BillEvent Dispute Oracle
Title:
BillEvent Dispute Oracle
A disputed bill event.
Nested Schema : Billing Cycle Specification Ref Oracle
Type:
object
Title:
Billing Cycle Specification Ref Oracle
A reference to a billing cycle specification, extended for BRM REST Services Manager.
Show Source
-
href: string
Title:
Href
The billing cycle specification's href. -
id: string
Title:
ID
The billing cycle specification's ID. -
name: string
Title:
Name
The billing cycle specification's name.
Nested Schema : billItem
Type:
array
The bill items associated with the dispute.
Show Source
-
Array of:
object BillItem Dispute Oracle
Title:
BillItem Dispute Oracle
A disputed bill item (AppliedCustomerBillingRate).
Nested Schema : Party Account Ref
Type:
object
Title:
Party Account Ref
A reference to a party account.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType: string
Title:
Referred Type
The object's type in the target system, if baseType and type need further disambiguation. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
description: string
Title:
Description
The party account's description. -
href: string
Title:
Href
The party account's href. -
id(required): string
Title:
Account ID
The party account's ID. -
name: string
Title:
Name
The party account's name. -
status: string
Title:
Status
The overall status of the account. For example, due, paid, or in arrears.
Nested Schema : BillEvent Dispute Oracle
Type:
object
Title:
BillEvent Dispute Oracle
A disputed bill event.
Show Source
-
adjustmentAmount: object
object
Money
Title:
Money
An amount of money. -
href: string
Title:
Href
The disputed event's href. -
id: string
Title:
Id
The disputed event's ID. -
name: string
Title:
Name
The disputed event's name. -
originalCharge: object
object
Money
Title:
Money
An amount of money.
Nested Schema : Money
Type:
object
Title:
Money
An amount of money.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
unit: string
Title:
Currency
An ISO 4217 three letter currency code. -
value: number
(float)
Title:
Amount
A positive floating point number.
Nested Schema : BillItem Dispute Oracle
Type:
object
Title:
BillItem Dispute Oracle
A disputed bill item (AppliedCustomerBillingRate).
Show Source
-
adjustmentAmount: object
object
Money
Title:
Money
An amount of money. -
href(required): string
Title:
Href
The disputed item's href. -
id(required): string
Title:
Id
The disputed item's ID. -
name(required): string
Title:
Name
The disputed item's name. -
originalCharge: object
object
Money
Title:
Money
An amount of money.
400 Response
Bad Request
Root Schema : Error
Type:
object
Title:
Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
code(required): string
Title:
Error Code
An error code. -
message: string
Title:
Error Message
Details and corrective actions related to the error. -
reason(required): string
Title:
Reason
The reason for the error. -
referenceError: string
(uri)
Title:
Reference Error
A URI to documentation describing the error. -
status: string
Title:
Error Status
The HTTP Error code extension.
401 Response
Unauthorized
Root Schema : Error
Type:
object
Title:
Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
code(required): string
Title:
Error Code
An error code. -
message: string
Title:
Error Message
Details and corrective actions related to the error. -
reason(required): string
Title:
Reason
The reason for the error. -
referenceError: string
(uri)
Title:
Reference Error
A URI to documentation describing the error. -
status: string
Title:
Error Status
The HTTP Error code extension.
403 Response
Forbidden
Root Schema : Error
Type:
object
Title:
Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
code(required): string
Title:
Error Code
An error code. -
message: string
Title:
Error Message
Details and corrective actions related to the error. -
reason(required): string
Title:
Reason
The reason for the error. -
referenceError: string
(uri)
Title:
Reference Error
A URI to documentation describing the error. -
status: string
Title:
Error Status
The HTTP Error code extension.
405 Response
Method Not Allowed
Root Schema : Error
Type:
object
Title:
Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
code(required): string
Title:
Error Code
An error code. -
message: string
Title:
Error Message
Details and corrective actions related to the error. -
reason(required): string
Title:
Reason
The reason for the error. -
referenceError: string
(uri)
Title:
Reference Error
A URI to documentation describing the error. -
status: string
Title:
Error Status
The HTTP Error code extension.
409 Response
Conflict
Root Schema : Error
Type:
object
Title:
Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
code(required): string
Title:
Error Code
An error code. -
message: string
Title:
Error Message
Details and corrective actions related to the error. -
reason(required): string
Title:
Reason
The reason for the error. -
referenceError: string
(uri)
Title:
Reference Error
A URI to documentation describing the error. -
status: string
Title:
Error Status
The HTTP Error code extension.
500 Response
Internal Server Error
Root Schema : Error
Type:
object
Title:
Error
Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
code(required): string
Title:
Error Code
An error code. -
message: string
Title:
Error Message
Details and corrective actions related to the error. -
reason(required): string
Title:
Reason
The reason for the error. -
referenceError: string
(uri)
Title:
Reference Error
A URI to documentation describing the error. -
status: string
Title:
Error Status
The HTTP Error code extension.
Examples
The following example shows how to create a disputed balance for an event by submitting a POST request on the REST resource using cURL. For more information about cURL, see Use cURL.
The -d option specifies the file to attach as the request body.
curl -X POST 'http://host:port/brm/prepayBalanceManagement/version/disputeBalance' -d @disputeBalanceCreate.json
Example of Request Body
The following is an example of the contents of the disputeBalanceCreate.json file sent as the request body.
{ "description": "My First Event Dispute", "reason": "1", "amount": { "amount": 1.00, "units": "USD" }, "bieId": [ { "id": "0.0.0.1+-event-billing-product-fee-cycle-cycle_forward_monthly+324100843496386447" } ], "taxTreatment": "TaxExcluded" }
Example of Response Body
The following is an example of the response body in JSON format.
{ "id": "0.0.0.1+-item-dispute+115931", "href": "https://host:port/brm/prepayBalanceManagement/version/disputeBalance/0.0.0.1+-item-dispute+115931", "actionType": "EventDispute", "disputeNo": null, "amount": { "amount": -1.0, "units": "USD", "@baseType": null, "@schemaLocation": null, "@type": null }, "taxAmount": null, "reason": "1", "description": "My First Event Dispute", "partyAccount": { "id": "0.0.0.1+-account+114053", "href": null, "description": null, "name": null, "status": null, "@baseType": null, "@schemaLocation": null, "@type": null, "@referredType": null }, "validFor": null, "discount": null, "taxTreatment": null, "confirmationDate": null, "requestedDate": "2020-06-23T03:24:36-07:00", "billingCycleSpecification": null, "bill": null, "billItem": null, "billEvents": null, "status": "Open", "settlementId": null, "@baseType": null, "@schemaLocation": null, "@type": null }