REST Services Manager API for Billing and Revenue Management

Create a Customer Bill On Demand

post

/customerBillOnDemand

Creates a bill.

Request

There are no request parameters for this operation.

Supported Media Types

application/json;charset=utf-8

The bill to create.

Root Schema : Customer Bill OnDemand Create

Type: object

Title: Customer Bill OnDemand Create

An on-demand customer bill, used in the create request. The id and href properties are not used in the create request.

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.
billingAccount(required): object object Billing Account Ref

Title: Billing Account Ref

A billing account reference.
customerBill: object object Bill Ref

Title: Bill Ref

A reference to a bill.
description: string

Title: Bill Description

The on-demand bill's description.
lastUpdate: string

Title: Last Updated Date

The date that the on-demand bill was last updated.
name: string

Title: Bill Name

The on-demand bill's name.
relatedParty: object object Related Party Ref

Title: Related Party Ref

A reference to the party related to an object.
state: string

Title: State Values

Allowed Values: [ "inProgress", "rejected", "done", "terminatedWithError" ]

Possible values for an on-demand bill's state.

{
    "type":"object",
    "title":"Customer Bill OnDemand Create",
    "description":"An on-demand customer bill, used in the create request. The <b>id</b> and <b>href</b> properties are not used in the create request.",
    "properties":{
        "description":{
            "type":"string",
            "title":"Bill Description",
            "description":"The on-demand bill's description."
        },
        "lastUpdate":{
            "type":"string",
            "title":"Last Updated Date",
            "description":"The date that the on-demand bill was last updated."
        },
        "name":{
            "type":"string",
            "title":"Bill Name",
            "description":"The on-demand bill's name."
        },
        "billingAccount":{
            "description":"The billing account related to the on-demand bill.",
            "$ref":"#/components/schemas/BillingAccountRef"
        },
        "customerBill":{
            "description":"A reference to the related bill.",
            "$ref":"#/components/schemas/BillRef"
        },
        "relatedParty":{
            "description":"The party related to the on-demand bill.",
            "$ref":"#/components/schemas/RelatedPartyRef"
        },
        "state":{
            "description":"The on-demand bill's state.",
            "$ref":"#/components/schemas/StateValues"
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "format":"uri",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        }
    },
    "required":[
        "billingAccount"
    ]
}

Nested Schema : Billing Account Ref

Type: object

Title: Billing Account Ref

A billing account reference.

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

Title: Billing Account Href

The billing account reference's href.
id(required): string

Title: Billing Account ID

The billing account reference's ID.
name: string

Title: Billing Account Name

The billing account reference's name.

{
    "type":"object",
    "title":"Billing Account Ref",
    "description":"A billing account reference.",
    "properties":{
        "id":{
            "type":"string",
            "title":"Billing Account ID",
            "description":"The billing account reference's ID."
        },
        "href":{
            "type":"string",
            "title":"Billing Account Href",
            "description":"The billing account reference's href."
        },
        "name":{
            "type":"string",
            "title":"Billing Account Name",
            "description":"The billing account reference's name."
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "format":"uri",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The object's type in the target system, if <b>baseType</b> and <b>type</b> need further disambiguation."
        }
    },
    "required":[
        "id"
    ]
}

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.

{
    "type":"object",
    "title":"Bill Ref",
    "description":"A reference to a bill.",
    "properties":{
        "id":{
            "type":"string",
            "title":"Bill ID",
            "description":"The bill's ID."
        },
        "href":{
            "type":"string",
            "title":"Bill Href",
            "description":"The bill's href."
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "format":"uri",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The actual type of the target instance when needed for disambiguation."
        }
    }
}

Nested Schema : Related Party Ref

Type: object

Title: Related Party Ref

A reference to the party related to an object.

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

Title: Related Party Href

The related party's href.
id(required): string

Title: Related Party ID

The related party's ID.
name: string

Title: Related Party Name

The related party's name.
role: string

Title: Related Party Role

The related party's role.

{
    "type":"object",
    "title":"Related Party Ref",
    "description":"A reference to the party related to an object.",
    "properties":{
        "id":{
            "type":"string",
            "title":"Related Party ID",
            "description":"The related party's ID."
        },
        "href":{
            "type":"string",
            "title":"Related Party Href",
            "description":"The related party's href."
        },
        "name":{
            "type":"string",
            "title":"Related Party Name",
            "description":"The related party's name."
        },
        "role":{
            "type":"string",
            "title":"Related Party Role",
            "description":"The related party's role."
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "format":"uri",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The object's type in the target system, if <b>baseType</b> and <b>type</b> need further disambiguation."
        }
    },
    "required":[
        "id"
    ]
}

Response

Supported Media Types

application/json;charset=utf-8

201 Response

Created

Root Schema : Customer Bill OnDemand

Type: object

Title: Customer Bill OnDemand

A customer bill created on demand.

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.
billingAccount(required): object object Billing Account Ref

Title: Billing Account Ref

A billing account reference.
customerBill: object object Bill Ref

Title: Bill Ref

A reference to a bill.
description: string

Title: Bill Description

The on-demand bill's description.
href(required): string

Title: Bill Href

The on-demand bill's href.
id(required): string

Title: Bill ID

The on-demand bill's ID.
lastUpdate: string

Title: Last Updated Date

The date that the on-demand bill was last updated.
name: string

Title: Bill Name

The on-demand bill's name.
relatedParty: object object Related Party Ref

Title: Related Party Ref

A reference to the party related to an object.
state(required): string

Title: State Values

Allowed Values: [ "inProgress", "rejected", "done", "terminatedWithError" ]

Possible values for an on-demand bill's state.

{
    "type":"object",
    "title":"Customer Bill OnDemand",
    "description":"A customer bill created on demand.",
    "properties":{
        "id":{
            "type":"string",
            "title":"Bill ID",
            "description":"The on-demand bill's ID."
        },
        "href":{
            "type":"string",
            "title":"Bill Href",
            "description":"The on-demand bill's href."
        },
        "description":{
            "type":"string",
            "title":"Bill Description",
            "description":"The on-demand bill's description."
        },
        "lastUpdate":{
            "type":"string",
            "title":"Last Updated Date",
            "description":"The date that the on-demand bill was last updated."
        },
        "name":{
            "type":"string",
            "title":"Bill Name",
            "description":"The on-demand bill's name."
        },
        "billingAccount":{
            "description":"The billing account related to the on-demand bill.",
            "$ref":"#/components/schemas/BillingAccountRef"
        },
        "customerBill":{
            "description":"A reference to the related bill.",
            "$ref":"#/components/schemas/BillRef"
        },
        "relatedParty":{
            "description":"The party related to the on-demand bill.",
            "$ref":"#/components/schemas/RelatedPartyRef"
        },
        "state":{
            "description":"The on-demand bill's state.",
            "$ref":"#/components/schemas/StateValues"
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "format":"uri",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        }
    },
    "required":[
        "id",
        "href",
        "state",
        "billingAccount"
    ]
}

Nested Schema : Billing Account Ref

Type: object

Title: Billing Account Ref

A billing account reference.

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

Title: Billing Account Href

The billing account reference's href.
id(required): string

Title: Billing Account ID

The billing account reference's ID.
name: string

Title: Billing Account Name

The billing account reference's name.

{
    "type":"object",
    "title":"Billing Account Ref",
    "description":"A billing account reference.",
    "properties":{
        "id":{
            "type":"string",
            "title":"Billing Account ID",
            "description":"The billing account reference's ID."
        },
        "href":{
            "type":"string",
            "title":"Billing Account Href",
            "description":"The billing account reference's href."
        },
        "name":{
            "type":"string",
            "title":"Billing Account Name",
            "description":"The billing account reference's name."
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "format":"uri",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The object's type in the target system, if <b>baseType</b> and <b>type</b> need further disambiguation."
        }
    },
    "required":[
        "id"
    ]
}

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.

{
    "type":"object",
    "title":"Bill Ref",
    "description":"A reference to a bill.",
    "properties":{
        "id":{
            "type":"string",
            "title":"Bill ID",
            "description":"The bill's ID."
        },
        "href":{
            "type":"string",
            "title":"Bill Href",
            "description":"The bill's href."
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "format":"uri",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The actual type of the target instance when needed for disambiguation."
        }
    }
}

Nested Schema : Related Party Ref

Type: object

Title: Related Party Ref

A reference to the party related to an object.

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

Title: Related Party Href

The related party's href.
id(required): string

Title: Related Party ID

The related party's ID.
name: string

Title: Related Party Name

The related party's name.
role: string

Title: Related Party Role

The related party's role.

{
    "type":"object",
    "title":"Related Party Ref",
    "description":"A reference to the party related to an object.",
    "properties":{
        "id":{
            "type":"string",
            "title":"Related Party ID",
            "description":"The related party's ID."
        },
        "href":{
            "type":"string",
            "title":"Related Party Href",
            "description":"The related party's href."
        },
        "name":{
            "type":"string",
            "title":"Related Party Name",
            "description":"The related party's name."
        },
        "role":{
            "type":"string",
            "title":"Related Party Role",
            "description":"The related party's role."
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "format":"uri",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships."
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The object's type in the target system, if <b>baseType</b> and <b>type</b> need further disambiguation."
        }
    },
    "required":[
        "id"
    ]
}

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.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

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.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

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.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

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.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

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.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

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.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

Examples

The following example shows how to create a customer bill on demand 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/customerBillManagement/version/customerBillOnDemand' -d @billCreate.json

Example of Request Body

The following is an example of the contents of the billCreate.json file sent as the request body.

{   
    "billingAccount":{
    "id":"0.0.0.1+-account+341286"
    }
}

Example of Response Body

The following is an example of the response body in JSON format.

{
    "id": "0.0.0.1+-bill+494205",
    "href": "http://host:port/brm/customerBillManagement/version/customerBill/0.0.0.1+-bill+494205",
    "description": null,
    "lastUpdate": "2020-04-29T:18:34:02",
    "name": null,
    "billingAccount": {
        "id": "0.0.0.1+-account+341286",
        "href": null,
        "name": "Grace Wang",
        "@baseType": null,
        "@schemaLocation": null,
        "@type": "BillingAccountRef",
        "@referredType": null
    },
    "customerBill": {
        "id": "0.0.0.1+-bill+494205",
        "href": "http://host:port/brm/customerBillManagement/version/customerBill/0.0.0.1+-bill+494205",
        "@baseType": null,
        "@schemaLocation": null,
        "@type": "BillRef",
        "@referredType": "CustomerBill"
    },
    "relatedParty": null,
    "state": "DONE",
    "@baseType": "CustomerBillOnDemand",
    "@schemaLocation": null,
    "@type": "CustomerBillOnDemand"
}