Partially Update a Billing Account
/billingAccount/{id}
Request
-
id(required): string
The identifier of the resource.
-
fields: string
The comma-separated properties to be provided in response.
- application/json-patch+json
- application/json
- application/merge-patch+json
- application/json-patch-query+json
array-
Array of:
object JsonPatch
The JSONPatch document as defined by RFC 6902.
object-
from: string
The string containing a JSON Pointer value.
-
op(required): string
Allowed Values:
[ "add", "remove", "replace", "move", "copy", "test" ]The operation to perform: add, remove, replace, move, copy, or test. -
path(required): string
The JSON pointer.
-
value:
The value to be used within the operations.
array-
Array of:
object JsonPatch
The JSONPatch document as defined by RFC 6902.
object-
from: string
The string containing a JSON Pointer value.
-
op(required): string
Allowed Values:
[ "add", "remove", "replace", "move", "copy", "test" ]The operation to perform: add, remove, replace, move, copy, or test. -
path(required): string
The JSON pointer.
-
value:
The value to be used within the operations.
-
allOf
PartyAccount_MVO
-
object
type
The party account used for billing purposes. It includes a description of the bill structure (frequency, presentation media, format and so on). It is a specialization of entity Party Account.
-
allOf
Account_MVO
-
object
PartyAccount_MVO-allOf[1]
The account used for billing or for settlement purposes concerning a given party (an organization or an individual). It is a specialization of entity Account.
-
object
allOf
Entity_MVO
The Base entity schema for use in TMForum Open-APIs Property.
-
object
Account_MVO-allOf[1]
The generic account structure used to define commonalities between sub concepts of Party Account other types of accounts supported by the API.
object-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
accountRelationship: array
accountRelationship
The list of balances related to the account.
-
accountType: string
The categorization of an account, such as individual, joint, and so forth, whose instances share some of the same characteristics. Note that for flexibility, we use a String here but an implementation may use an enumeration with a limited list of valid values.
-
contact: array
contact
The list of balances for the account, for example, regular postpaid balance, deposit balance, write-off balance.
-
description: string
The detailed description of the account.
-
name: string
The name of the account.
- relatedParty: array relatedParty
-
state: string
The lifecycle state such as, Active, Closed, Suspended, and so on.
-
taxExemption: array
taxExemption
The list of tax exemptions that can be applied when calculating charges levied to the account.
objectobjectarrayarrayarray-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
AccountRelationship_MVO-allOf[1]
Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing account.
object-
account: object
AccountRef_MVO
The account reference. An account may be a party account or a financial account.
-
relationshipType: string
Type of relationship
object-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Addressable
The base schema for adressable entities.
-
object
EntityRef-allOf[2]
The entity reference schema to be used for all entityRef class.
object-
href: string
The hyperlink reference.
-
id: string
The unique identifier.
object-
@referredType: string
The actual type of the target instance when needed for disambiguation.
-
href: string
The URI of the referred entity.
-
id(required): string
The identifier of the referred entity.
-
name: string
The name of the referred entity.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Contact_MVO-allOf[1]
The individual or organization used as a contact point for a given account and accessed via some contact medium.
object-
contactMedium: array
contactMedium
The list of contact mediums, such as mobile phone number and email addresses.
-
contactName: string
The displayable name for that contact.
-
contactType: string
The type of contact, such as primary or secondary.
-
id: string
The identifier of the contact within list of the contacts (for entities with a list).
array-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
ContactMedium_MVO-allOf[1]
The contact medium that could be used to contact the party.
object-
id: string
Identifier for this contact medium.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
RelatedPartyRefOrPartyRoleRef_MVO-allOf[1]
RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
object-
partyOrPartyRole: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "PartyRef":"#/components/schemas/PartyRef_MVO", "PartyRoleRef":"#/components/schemas/PartyRoleRef_MVO" } }The reference allows either a party or a party role to be specified. -
role: string
Role played by the related party or party role in the context of the specific entity it is linked to. Such as 'initiator', 'customer', 'salesAgent', 'user'
objectDiscriminator Values
-
object
PartyRef_MVO
A party reference.
-
PartyRoleRef_MVO
object-
allOf
EntityRef
-
object
PartyRoleRef_MVO-allOf[1]
The Party Role reference. A party role represents the part played by a party in a given context.
object-
partyId: string
The identifier of the engaged party that is linked to the PartyRole object.
-
partyName: string
The name of the engaged party that is linked to the PartyRole object.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
TaxExemptionCertificate_MVO-allOf[1]
The tax exemption certificate represents a tax exemption granted to a party (individual or organization) by a tax jurisdiction which may be a city, state, country,... An exemption has a certificate identifier (received from the jurisdiction that levied the tax) and a validity period. An exemption is per tax types and determines for each type of tax what portion of the tax is exempted (partial by percentage or complete) via the tax definition.
object-
certificateNumber: string
The identifier of a document that shows proof of exemption from taxes for the taxing jurisdiction.
-
id: string
The identifier of the tax exemption within list of the exemptions.
-
issuingJurisdiction: string
The name of the jurisdiction that issued the exemption.Example:
USA -
reason: string
The reason for the tax exemption.
-
taxDefinition: array
taxDefinition
The list of taxes that are covered by the exemption, such as City Tax or State Tax. The definition would include the exemption (e.g. for a rate exemption 0% would be a full exemption, 5% could be a partial exemption if the actual rate was 10%).
-
validFor: object
TimePeriod
The period of time, as a deadline (endDateTime only), a startDateTime only, or both.
arrayobject-
endDateTime: string
(date-time)
The end of the time period, using IETC-RFC-3339 format.Example:
1985-04-12T23:20:50.52Z -
startDateTime: string
(date-time)
The start of the time period, using IETC-RFC-3339 format.Example:
1985-04-12T23:20:50.52Z
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
TaxDefinition_MVO-allOf[1]
Reference of a tax definition. A tax is levied by an authorized tax jurisdiction. For example, there are many different types of tax (Federal Tax levied by the US Government, State Tax levied by the State of California, City Tax levied by the City of Los Angeles, etc.).
object-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
BillStructure_MVO-allOf[1]
The structure of the bill for party accounts (billing or settlement).
object-
cycleSpecification: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillingCycleSpecification":"#/components/schemas/BillingCycleSpecification_MVO", "BillingCycleSpecificationRef":"#/components/schemas/BillingCycleSpecificationRef_MVO" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillingCycleSpecification entity and not the BillingCycleSpecificationRefOrValue class itself -
format: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillFormat":"#/components/schemas/BillFormat_MVO", "BillFormatRef":"#/components/schemas/BillFormatRef_MVO" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillFormat entity and not the BillFormatRefOrValue class itself -
presentationMedia: array
presentationMedia
objectDiscriminator Values
-
BillingCycleSpecification_MVO
-
object
BillingCycleSpecificationRef_MVO
BillingCycleSpecification reference. A description of when to initiate a billing cycle and the various sub steps of a billing cycle.
objectDiscriminator Values
-
schema
-
object
BillFormatRef_MVO
The BillFormat reference. A bill format is a description of the way in which a bill is presented.
array-
Array of:
object Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillPresentationMedia":"#/components/schemas/BillPresentationMedia_MVO", "BillPresentationMediaRef":"#/components/schemas/BillPresentationMediaRef_MVO" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillPresentationMedia entity and not the BillPresentationMediaRefOrValue class itself
-
object
allOf
Entity_MVO
The Base entity schema for use in TMForum Open-APIs Property.
-
object
BillingCycleSpecification_MVO-allOf[1]
The detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
objectobject-
billingDateShift: integer
The offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period.
-
description: string
An explanation regarding this billing cycle specification
-
frequency: string
Frequency of the billing cycle (monthly for instance)
-
name: string
The short descriptive name.
-
paymentDueDateOffset: integer
The offset of a date through which charges previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriod.
-
object
allOf
Entity_MVO
The Base entity schema for use in TMForum Open-APIs Property.
-
object
type
The detailed description of the way in which a bill is presented.
objectobject-
description: string
The explanatory text for this bill format.
-
name: string
The short descriptive name.
objectDiscriminator Values
-
schema
-
object
BillPresentationMediaRef_MVO
The PresentationMedia reference. A mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
-
object
allOf
Entity_MVO
The Base entity schema for use in TMForum Open-APIs Property.
-
object
type
The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
objectobject-
description: string
The explanatory text describing this bill presentation media.
-
name: string
The short descriptive name.
-
allOf
PartyAccount_MVO
-
object
type
The party account used for billing purposes. It includes a description of the bill structure (frequency, presentation media, format and so on). It is a specialization of entity Party Account.
-
object
allOf
Entity
The Base entity schema for use in TMForum Open-APIs Property.
-
object
BillingAccountOracle_MVO-allOf[1]
The party account used for billing purposes. It includes a description of the bill structure (frequency, presentation media, format and so on). It is a specialization of entity Party Account.
-
allOf
Account_MVO
-
object
PartyAccount_MVO-allOf[1]
The account used for billing or for settlement purposes concerning a given party (an organization or an individual). It is a specialization of entity Account.
-
object
allOf
Entity_MVO
The Base entity schema for use in TMForum Open-APIs Property.
-
object
Account_MVO-allOf[1]
The generic account structure used to define commonalities between sub concepts of Party Account other types of accounts supported by the API.
object-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
accountRelationship: array
accountRelationship
The list of balances related to the account.
-
accountType: string
The categorization of an account, such as individual, joint, and so forth, whose instances share some of the same characteristics. Note that for flexibility, we use a String here but an implementation may use an enumeration with a limited list of valid values.
-
contact: array
contact
The list of balances for the account, for example, regular postpaid balance, deposit balance, write-off balance.
-
description: string
The detailed description of the account.
-
name: string
The name of the account.
- relatedParty: array relatedParty
-
state: string
The lifecycle state such as, Active, Closed, Suspended, and so on.
-
taxExemption: array
taxExemption
The list of tax exemptions that can be applied when calculating charges levied to the account.
objectobjectarrayarrayarray-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
AccountRelationship_MVO-allOf[1]
Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing account.
object-
account: object
AccountRef_MVO
The account reference. An account may be a party account or a financial account.
-
relationshipType: string
Type of relationship
object-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Addressable
The base schema for adressable entities.
-
object
EntityRef-allOf[2]
The entity reference schema to be used for all entityRef class.
object-
href: string
The hyperlink reference.
-
id: string
The unique identifier.
object-
@referredType: string
The actual type of the target instance when needed for disambiguation.
-
href: string
The URI of the referred entity.
-
id(required): string
The identifier of the referred entity.
-
name: string
The name of the referred entity.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Contact_MVO-allOf[1]
The individual or organization used as a contact point for a given account and accessed via some contact medium.
object-
contactMedium: array
contactMedium
The list of contact mediums, such as mobile phone number and email addresses.
-
contactName: string
The displayable name for that contact.
-
contactType: string
The type of contact, such as primary or secondary.
-
id: string
The identifier of the contact within list of the contacts (for entities with a list).
array-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
ContactMedium_MVO-allOf[1]
The contact medium that could be used to contact the party.
object-
id: string
Identifier for this contact medium.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
RelatedPartyRefOrPartyRoleRef_MVO-allOf[1]
RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
object-
partyOrPartyRole: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "PartyRef":"#/components/schemas/PartyRef_MVO", "PartyRoleRef":"#/components/schemas/PartyRoleRef_MVO" } }The reference allows either a party or a party role to be specified. -
role: string
Role played by the related party or party role in the context of the specific entity it is linked to. Such as 'initiator', 'customer', 'salesAgent', 'user'
objectDiscriminator Values
-
object
PartyRef_MVO
A party reference.
-
PartyRoleRef_MVO
object-
allOf
EntityRef
-
object
PartyRoleRef_MVO-allOf[1]
The Party Role reference. A party role represents the part played by a party in a given context.
object-
partyId: string
The identifier of the engaged party that is linked to the PartyRole object.
-
partyName: string
The name of the engaged party that is linked to the PartyRole object.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
TaxExemptionCertificate_MVO-allOf[1]
The tax exemption certificate represents a tax exemption granted to a party (individual or organization) by a tax jurisdiction which may be a city, state, country,... An exemption has a certificate identifier (received from the jurisdiction that levied the tax) and a validity period. An exemption is per tax types and determines for each type of tax what portion of the tax is exempted (partial by percentage or complete) via the tax definition.
object-
certificateNumber: string
The identifier of a document that shows proof of exemption from taxes for the taxing jurisdiction.
-
id: string
The identifier of the tax exemption within list of the exemptions.
-
issuingJurisdiction: string
The name of the jurisdiction that issued the exemption.Example:
USA -
reason: string
The reason for the tax exemption.
-
taxDefinition: array
taxDefinition
The list of taxes that are covered by the exemption, such as City Tax or State Tax. The definition would include the exemption (e.g. for a rate exemption 0% would be a full exemption, 5% could be a partial exemption if the actual rate was 10%).
-
validFor: object
TimePeriod
The period of time, as a deadline (endDateTime only), a startDateTime only, or both.
arrayobject-
endDateTime: string
(date-time)
The end of the time period, using IETC-RFC-3339 format.Example:
1985-04-12T23:20:50.52Z -
startDateTime: string
(date-time)
The start of the time period, using IETC-RFC-3339 format.Example:
1985-04-12T23:20:50.52Z
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
TaxDefinition_MVO-allOf[1]
Reference of a tax definition. A tax is levied by an authorized tax jurisdiction. For example, there are many different types of tax (Federal Tax levied by the US Government, State Tax levied by the State of California, City Tax levied by the City of Los Angeles, etc.).
object-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
BillStructure_MVO-allOf[1]
The structure of the bill for party accounts (billing or settlement).
object-
cycleSpecification: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillingCycleSpecification":"#/components/schemas/BillingCycleSpecification_MVO", "BillingCycleSpecificationRef":"#/components/schemas/BillingCycleSpecificationRef_MVO" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillingCycleSpecification entity and not the BillingCycleSpecificationRefOrValue class itself -
format: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillFormat":"#/components/schemas/BillFormat_MVO", "BillFormatRef":"#/components/schemas/BillFormatRef_MVO" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillFormat entity and not the BillFormatRefOrValue class itself -
presentationMedia: array
presentationMedia
objectDiscriminator Values
-
BillingCycleSpecification_MVO
-
object
BillingCycleSpecificationRef_MVO
BillingCycleSpecification reference. A description of when to initiate a billing cycle and the various sub steps of a billing cycle.
objectDiscriminator Values
-
schema
-
object
BillFormatRef_MVO
The BillFormat reference. A bill format is a description of the way in which a bill is presented.
array-
Array of:
object Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillPresentationMedia":"#/components/schemas/BillPresentationMedia_MVO", "BillPresentationMediaRef":"#/components/schemas/BillPresentationMediaRef_MVO" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillPresentationMedia entity and not the BillPresentationMediaRefOrValue class itself
-
object
allOf
Entity_MVO
The Base entity schema for use in TMForum Open-APIs Property.
-
object
BillingCycleSpecification_MVO-allOf[1]
The detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
objectobject-
billingDateShift: integer
The offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period.
-
description: string
An explanation regarding this billing cycle specification
-
frequency: string
Frequency of the billing cycle (monthly for instance)
-
name: string
The short descriptive name.
-
paymentDueDateOffset: integer
The offset of a date through which charges previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriod.
-
object
allOf
Entity_MVO
The Base entity schema for use in TMForum Open-APIs Property.
-
object
type
The detailed description of the way in which a bill is presented.
objectobject-
description: string
The explanatory text for this bill format.
-
name: string
The short descriptive name.
objectDiscriminator Values
-
schema
-
object
BillPresentationMediaRef_MVO
The PresentationMedia reference. A mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
-
object
allOf
Entity_MVO
The Base entity schema for use in TMForum Open-APIs Property.
-
object
type
The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
objectobject-
description: string
The explanatory text describing this bill presentation media.
-
name: string
The short descriptive name.
object-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Addressable
The base schema for adressable entities.
object-
accountNum: string
The account number.
-
accountRelationship: array
accountRelationship
The list of balances related to the account. For example, a list of billing accounts that contribute to a financial account.
-
accountType: string
Allowed Values:
[ "consumer", "business" ]The account categorization whose instances share some of the same characteristics, such as consumer or business.Note: For flexibility, we use a string here but an implementation may use an enumeration with a limited list of valid values.
-
billStructure:
BillStructureOracle_MVO
-
brmAccountType: string
Allowed Values:
[ "standard", "brand" ]The type of BRM account: standard or brand. -
contact: array
contact
The list of people who could be contacted regarding the account, such as the accountant who authorizes payments.
-
currency: string
The currency. The ISO4217 norm uses 3 letters to define the currency.
-
currencySecondary: string
The currency. The ISO4217 norm uses 3 letters to define the currency.
-
customerSegmentList: string
The customer segment list.
-
description: string
A detailed description of the account.
-
glSegment: string
The GL segment value.
-
locale: string
The language. The default value is en_US.
-
name: string
The name of the account.
-
serviceBillStructure: array
ServiceBillStructureOracle_MVO
The array of bill structures.
-
state: string
Allowed Values:
[ "active", "inactive", "closed" ]The lifecycle state: active, inactive, or closed. -
taxExemption: array
taxExemption
The list of tax exemptions that can be applied when calculating charges levied to the account.
-
vatCertificate: string
The VAT certificate.
array-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
BillStructureOracle_MVO-allOf[1]
The extended bill structure for the Oracle implementation.
arrayarrayarray-
allOf
AccountRelationship_MVO
-
object
AccountRelationshipOracle_MVO-allOf[1]
Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing account.
object-
account: object
account
Account reference. An account may be a party account or a financial account.
-
billStructure: object
billStructure
The bill structure object.
-
relationshipType: string
Allowed Values:
[ "Parent", "AR" ]The type of relationship: AR or Parent.
object-
billStructure: object
billStructure
The bill structure object of account.
object-
id: string
The bill structure ID for the child account.
object-
id: string
The bill structure id of parent account.
-
name: string
The bill structure name of parent account.
object-
acctSuppressed: boolean
Whether the account is suppressed: true or false.
-
actgType: string
Allowed Values:
[ "open_items", "balance_forward" ]The accounting type: open_items or balance_forward. -
balanceGroup: array
balanceGroup
-
billingSegment: string
The billing segment of the bill structure.
-
businessProfileId: string
The business profile ID.
-
cycleSpecification: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillingCycleSpecification":"#/components/schemas/BillingCycleSpecificationOracle_MVO", "BillingCycleSpecificationRef":"#/components/schemas/BillingCycleSpecificationRef_MVO" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillingCycleSpecification entity and not the BillingCycleSpecificationRefOrValue class itself -
format: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillFormat":"#/components/schemas/BillFormat_MVO", "BillFormatRef":"#/components/schemas/BillFormatRef_MVO" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillFormat entity and not the BillFormatRefOrValue class itself -
id: string
The bill unit ID.
-
name: string
The bill unit name.
-
payType: string
Allowed Values:
[ "invoice", "credit_card", "direct_debit", "subordinate" ]The pay type: invoice, credit_card, direct_debit, or subordinate. -
presentationMedia: array
presentationMedia
objectDiscriminator Values
-
BillingCycleSpecificationOracle_MVO
-
object
BillingCycleSpecificationRef_MVO
BillingCycleSpecification reference. A description of when to initiate a billing cycle and the various sub steps of a billing cycle.
array-
Array of:
object Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillPresentationMedia":"#/components/schemas/BillPresentationMedia_MVO", "BillPresentationMediaRef":"#/components/schemas/BillPresentationMediaRef_MVO" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillPresentationMedia entity and not the BillPresentationMediaRefOrValue class itself
object-
consumptionRule: string
The consumption rule.
-
id: string
The identification of the balance group.
-
isDefault: boolean
The Boolean value for default balance group.
-
limit: array
limit
-
name: string
The name of the balance group.
-
rolledUpCreditLimit: integer
(double)
The rolled up credit limit.
-
tempLimit: array
tempLimit
object-
creditFloor: integer
(double)
The credit floor.
-
creditLimit(required): integer
(double)
The credit limit of the balance group.
-
dynamicCreditFloor: boolean
The Boolean value for the dynamic credit floor.
-
unit(required): string
The unit of the credit limit.
object-
creditLimit(required): integer
(double)
The credit limit
-
recId: string
The rec ID.
-
unit(required): string
The credit limit.
-
validFrom: string
(date-time)
The valid start date.Example:
1985-04-12T23:20:50.52Z -
validFromDuration: object
validFromDuration
-
validTo: string
(date-time)
The valid end date.Example:
1985-04-12T23:20:50.52Z -
validToDuration: object
validToDuration
object-
offset: integer
(double)
The valid start date offset.
-
unit: string
(date-time)
The valid start date unit.Example:
1985-04-12T23:20:50.52Z
object-
offset: integer
(double)
The valid end date offset.
-
unit: string
(date-time)
The valid end date unit.Example:
1985-04-12T23:20:50.52Z
-
object
allOf
Entity_MVO
The Base entity schema for use in TMForum Open-APIs Property.
-
object
BillingCycleSpecificationOracle_MVO-allOf[1]
A detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
object-
billingDateShift: integer
The offset of a date through which credits previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriod.
-
description: string
The explanation regarding this billing cycle specification.
-
frequency: string
Allowed Values:
[ "monthly", "bi-monthly", "quarterly", "semiyearly", "yearly" ]The frequency of the billing cycle: monthly, bi-monthly, quarterly, semiyearly, or yearly. -
name: string
A short descriptive name
-
paymentDueDateOffset: integer
The offset of a payment due date. The offset is expressed as number of days with regard to the start of the BillingPeriod.
-
validFor: object
TimePeriod
The period of time, as a deadline (endDateTime only), a startDateTime only, or both.
-
object
ContactOracle_MVO-allOf[0]
The individual or organization used as a contact point for a given account and accessed via some contact medium.
object-
contactMedium: array
contactMedium
-
contactName: string
The name of the contact.
-
contactType: string
The type of contact.
-
salutation: string
The salutation for the name.
-
object
ContactMediumOracle_MVO-allOf[0]
Indicates the contact medium that could be used to contact the party.
object-
company: string
Associated company name.
-
geoCode: string
Geographic code for the address.
-
mediumType: string
Allowed Values:
[ "PostalAddress", "Phone", "Email", "Fax" ]The type of contact medium: PostalAddress, Phone, Email, or Fax. -
phoneType: string
Allowed Values:
[ "email", "home", "work", "pager", "portable", "pop", "support" ]The phone type classification: email, home, work, pager, portable, pop, or support.
-
allOf
TaxExemptionCertificate_MVO
-
object
TaxExemptionCertificateOracle_MVO-allOf[1]
The tax exemption certificate represents a tax exemption granted to a party (individual or organization) by a tax jurisdiction which may be a city, state, or country. An exemption has a certificate identifier (received from the jurisdiction that levied the tax) and a validity period. An exemption is per tax types and determines for each type of tax what portion of the tax is exempted (partial by percentage or complete) via the tax definition.
object-
taxDefinition: array
taxDefinition
The list of taxes that are covered by the exemption, such as City Tax or State Tax. The definition would include the exemption (e.g. for a rate exemption 0% would be a full exemption, 5% could be a partial exemption if the actual rate was 10%).
array-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
TaxDefinitionOracle_MVO-allOf[1]
The reference of a tax definition. A tax is levied by an authorized tax jurisdiction. For example, there are many different types of tax (Federal Tax levied by the US Government, State Tax levied by the State of California, City Tax levied by the City of Los Angeles, etc.).
object-
percent: number
(double)
The tax percent.
-
Type: string
Allowed Values:
[ "federal", "state", "country", "city", "secondary country", "secondary city", "territory", "secondary state", "district", "secondary federal", "country district", "city district", "other" ]The issuing jurisdiction that issues the tax: federal, state, country, city, secondary country, secondary city, territory, secondary state, district, secondary federal, country district, city district, or other.
Response
200 Response
-
allOf
PartyAccount
-
object
BillingAccount-allOf[1]
The party account used for billing purposes. It includes a description of the bill structure (frequency, presentation media, format and so on). It is a specialization of Party Account entity.
-
object
allOf
Entity
The Base entity schema for use in TMForum Open-APIs Property.
-
object
BillingAccountOracle-allOf[1]
A party account used for billing purposes. It includes a description of the bill structure (frequency, presentation media, format and so on). It is a specialization of entity PartyAccount.
-
allOf
Account
-
object
PartyAccount-allOf[1]
The account used for billing or for settlement purposes concerning a given party (an organization or an individual). It is a specialization of entity Account.
-
object
allOf
Entity
The Base entity schema for use in TMForum Open-APIs Property.
-
object
Account-allOf[1]
The generic account structure defines common elements for account types, including PartyAccount and other accounts supported by the API.
object-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Addressable
The base schema for adressable entities.
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
href: string
The hyperlink reference.
-
id: string
The unique identifier.
object-
accountBalance: array
accountBalance
The list of balances for the account, such as regular postpaid balance, deposit balance, or write-off balance.
-
accountRelationship: array
accountRelationship
A list of balances related to the account. For example, a list of billing accounts that contribute to a financial account.
-
accountType: string
The categorization of an account, such as individual or joint, that defines shared characteristics.
-
contact: array
contact
The list of people who could be contacted regarding the account, such as the accountant who authorizes payments.
-
creditLimit: object
Money
The base / value business entity used to represent money.
-
description: string
The detailed description of the account.
-
lastUpdate: string
(date-time)
The date and time that the account was last updated.
-
name: string
The name of the account.
- relatedParty: array relatedParty
-
state: string
The attribute contains the lifecycle state, such as Active, Closed, Suspended, and so on.
-
taxExemption: array
taxExemption
The list of tax exemptions that can be applied when calculating charges levied to the account.
objectobject-
ratingType: string
The indication for whether the account follows a specific payment option such as prepaid or postpaid.
arrayarrayarrayobject-
unit: string
The currency (ISO4217 norm uses 3 letters to define the currency).
-
value: number
(double)
The signed floating point number, the meaning of the sign is according to the context of the API that uses this Data type
array-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
AccountBalance-allOf[1]
The balances linked to the account.
object-
amount: object
Money
The base / value business entity used to represent money.
-
balanceType: string
The type of the balance, for example, deposit balance, disputed balance, loyalty balance, receivable balance.
-
delayedBal: string
The delayed balance.
-
grantedBal: string
The granted balance.
-
id: string
The identifier of the balance within the list of balances.
-
nextBal: string
The next balance.
-
validFor: object
TimePeriod
The period of time, as a deadline (endDateTime only), a startDateTime only, or both.
object-
endDateTime: string
(date-time)
The end of the time period, using IETC-RFC-3339 format.Example:
1985-04-12T23:20:50.52Z -
startDateTime: string
(date-time)
The start of the time period, using IETC-RFC-3339 format.Example:
1985-04-12T23:20:50.52Z
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
AccountRelationship-allOf[1]
The significant connection between accounts. For instance, an aggregating account for a list of shop branches each having its own billing account.
object-
account: object
AccountRef
The account reference. An account may be a party account or a financial account.
-
relationshipType: string
The type of relationship.
object-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Addressable
The base schema for adressable entities.
-
object
EntityRef-allOf[2]
The entity reference schema to be used for all entityRef class.
object-
@referredType: string
The actual type of the target instance when needed for disambiguation.
-
href: string
The URI of the referred entity.
-
id(required): string
The identifier of the referred entity.
-
name: string
The name of the referred entity.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Contact-allOf[1]
The individual or organization used as a contact point for a given account and accessed via some contact medium.
object-
contactMedium: array
contactMedium
The list of contact mediums for the contact, such as mobile phone number and email addresses.
-
contactName: string
The displayable name for the contact.
-
contactType: string
The type of contact, such as primary or secondary.
array-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
ContactMedium-allOf[1]
The contact medium that could be used to contact the party.
object-
id: string
The identifier for this contact medium.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
RelatedPartyRefOrPartyRoleRef-allOf[1]
The RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
object-
partyOrPartyRole: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "PartyRef":"#/components/schemas/PartyRef", "PartyRoleRef":"#/components/schemas/PartyRoleRef" } }The reference allows either a party or a party role to be specified. -
role: string
The role played by the related party or party role in the context of the specific entity it is linked to. Such as 'initiator', 'customer', 'salesAgent', 'user'
objectDiscriminator Values
-
object
PartyRef
A party reference.
-
PartyRoleRef
-
allOf
EntityRef
-
object
PartyRoleRef-allOf[1]
The Party Role reference. A party role represents the part played by a party in a given context.
object-
partyId: string
The identifier of the engaged party that is linked to the PartyRole object.
-
partyName: string
The name of the engaged party that is linked to the PartyRole object.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
TaxExemptionCertificate-allOf[1]
The tax exemption certificate represents a tax exemption granted to a party (individual or organization) by a tax jurisdiction which may be a city, state, country,... An exemption has a certificate identifier (received from the jurisdiction that levied the tax) and a validity period. An exemption is per tax types and determines for each type of tax what portion of the tax is exempted (partial by percentage or complete) via the tax definition.
object-
attachment: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "Attachment":"#/components/schemas/Attachment", "AttachmentRef":"#/components/schemas/AttachmentRef" } }The polymorphic attributes @type, @schemaLocation, and @referredType are related to the Attachment entity and not the AttachmentRefOrValue class itself. -
certificateNumber: string
The identifier of a document that shows proof of exemption from taxes for the taxing jurisdiction.
-
id: string
The identifier of the tax exemption within list of the exemptions.
-
issuingJurisdiction: string
The name of the jurisdiction that issued the exemption.Example:
USA -
reason: string
The reason for the tax exemption.
-
taxDefinition: array
taxDefinition
The list of taxes that are covered by the exemption, such as City Tax or State Tax. The definition would include the exemption (e.g. for a rate exemption 0% would be a full exemption, 5% could be a partial exemption if the actual rate was 10%).
-
validFor: object
TimePeriod
The period of time, as a deadline (endDateTime only), a startDateTime only, or both.
objectDiscriminator Values
array-
object
allOf
Entity
The Base entity schema for use in TMForum Open-APIs Property.
-
object
Attachment-allOf[1]
The complementary description of an element (for instance a product) through video, pictures, etc.
-
allOf
EntityRef
-
object
AttachmentRef-allOf[1]
The attachment reference. An attachment complements the description of an element (for instance a product) through video, pictures.
object-
attachmentType: string
The business characterization of the purpose of the attachment, for example, the logo, instructionManual, contractCopy.
-
content: string
(base64)
The actual contents of the attachment object, if embedded, encoded as base64.
-
description: string
The narrative text describing the content of the attachment.Example:
Photograph of the Product -
mimeType: string
The technical characterization of the attachment content format using IETF Mime Types.
-
name: string
The name of the attachment.
-
size: object
Quantity
The amount in a given unit.
-
url: string
The Uniform Resource Locator is a web page address (a subset of URI).Example:
http://host/Content/4aafacbd-11ff-4dc8-b445-305f2215715f -
validFor: object
TimePeriod
The period of time, as a deadline (endDateTime only), a startDateTime only, or both.
object-
amount: number
(double)
Default Value:
1The numeric value in a given unit. -
units: string
The unit.
object-
description: string
The narrative text describing the content of the attachment.
-
url: string
The link to the attachment media/content.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
TaxDefinition-allOf[1]
The reference of a tax definition. A tax is levied by an authorized tax jurisdiction. For example, there are many different types of tax (Federal Tax levied by the US Government, State Tax levied by the State of California, City Tax levied by the City of Los Angeles, etc.).
object-
certificateNumber: string
The certificate number.
-
id: string
The unique identifier of the tax.
-
issuingJurisdiction: string
The jurisdiction that issues the tax.
-
jurisdictionLevel: string
The level of the jurisdiction that levies the tax.Example:
Country -
jurisdictionName: string
The name of the jurisdiction that levies the tax.Example:
USA -
name: string
The tax name.
-
percent: integer
The tax percent.
-
reason: string
The tax reason.
-
taxType: string
The type of the tax.Example:
VAT -
validFor: object
TimePeriod
The period of time, as a deadline (endDateTime only), a startDateTime only, or both.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
BillStructure-allOf[1]
The structure of the bill for party accounts (billing or settlement).
object-
cycleSpecification: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillingCycleSpecification":"#/components/schemas/BillingCycleSpecification", "BillingCycleSpecificationRef":"#/components/schemas/BillingCycleSpecificationRef" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillingCycleSpecification entity and not the BillingCycleSpecificationRefOrValue class itself -
format: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillFormat":"#/components/schemas/BillFormat", "BillFormatRef":"#/components/schemas/BillFormatRef" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillFormat entity and not the BillFormatRefOrValue class itself -
presentationMedia: array
presentationMedia
objectDiscriminator Values
-
BillingCycleSpecification
-
object
BillingCycleSpecificationRef
BillingCycleSpecification reference. A description of when to initiate a billing cycle and the various sub steps of a billing cycle.
objectDiscriminator Values
-
BillFormat
-
object
BillFormatRef
The BillFormat reference. A bill format is a description of the way in which a bill is presented.
array-
Array of:
object Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillPresentationMedia":"#/components/schemas/BillPresentationMedia", "BillPresentationMediaRef":"#/components/schemas/BillPresentationMediaRef" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillPresentationMedia entity and not the BillPresentationMediaRefOrValue class itself
-
object
allOf
Entity
The Base entity schema for use in TMForum Open-APIs Property.
-
object
BillingCycleSpecification-allOf[1]
The detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
objectobject-
billingDateShift: integer
The offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period.
-
description: string
An explanation regarding this billing cycle specification.
-
frequency: string
Frequency of the billing cycle (monthly for instance)
-
name: string
The short descriptive name
-
paymentDueDateOffset: integer
An offset of a payment due date. The offset is expressed as number of days with regard to the start of the BillingPeriod.
-
object
allOf
Entity
The Base entity schema for use in TMForum Open-APIs Property.
-
object
BillFormat-allOf[1]
The detailed description of the way in which a bill is presented.
objectobject-
description: string
The explanatory text for this bill format.
-
name: string
The short descriptive name.
objectDiscriminator Values
-
BillPresentationMedia
-
object
BillPresentationMediaRef
The PresentationMedia reference. A mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
-
object
allOf
Entity
The Base entity schema for use in TMForum Open-APIs Property.
-
object
BillPresentationMedia-allOf[1]
The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
objectobject-
description: string
The explanatory text describing this bill presentation media.
-
name: string
The short descriptive name.
object-
accountNum: string
The account number.
-
accountRelationship: array
accountRelationship
The list of balances related to the account. For example, a list of billing accounts that contribute to a financial account.
-
accountType: string
Allowed Values:
[ "unknown", "consumer", "business" ]The account categorization whose instances share some of the same characteristics, such as unknown, consumer, or business.Note: For flexibility, we use a string here but an implementation may use an enumeration with a limited list of valid values.
-
attribute: integer
The attribute name.
-
billStructure:
BillStructureOracle
-
brmAccountType: string
Allowed Values:
[ "standard", "brand" ]The type of BRM account: standard or brand. -
contact: array
contact
The list of people who could be contacted regarding the account, such as the accountant who authorizes payments.
-
currency: string
The currency. The ISO4217 norm uses 3 letters to define the currency.
-
currencySecondary: string
The currency. The ISO4217 norm uses 3 letters to define the currency.
-
customerSegmentList: string
The customer segment list.
-
description: string
Detailed description of the account
-
glSegment: string
The GL segment value.
-
href: string
Hyperlink reference
-
id: string
unique identifier
-
locale: string
The language. The default value is en_US.
-
name: string
Name of the account
- relatedParty: array relatedParty
-
serviceBillStructure: array
ServiceBillStructureOracle
Array of Bill Structures
-
state: string
Allowed Values:
[ "active", "inactive", "closed" ]The lifecycle state: active, inactive, or closed. -
taxExemption: array
taxExemption
The list of tax exemptions that can be applied when calculating charges levied to the account.
-
vatCertificate: string
The VAT certificate.
array-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
BillStructureOracle-allOf[1]
The structure of the bill for party accounts (billing or settlement).
arrayarray-
allOf
AccountRelationship
-
object
AccountRelationshipOracle-allOf[1]
The significant connection between accounts. For instance, an aggregating account for a list of shop branches each having its own billing account.
object-
account: object
account
The account reference. An account may be a party account or a financial account.
-
billStructure: object
billStructure
The bill structure object.
-
relationshipType: string
Allowed Values:
[ "AR", "Parent" ]The type of relationship: AR or Parent.
object-
billStructure: object
billStructure
The bill structure object of the account.
object-
id(required): string
The bill structure id of child account.
object-
id(required): string
The bill structure ID of the parent account.
-
name: string
The bill structure name of parent account.
object-
acctSuppressed: boolean
The accepted values are true and false.
-
actgType: string
Allowed Values:
[ "open_items", "balance_forward" ]The accounting type: open_items or balance_forward. -
balanceGroup: array
balanceGroup
-
billingSegment: string
The billing segment of bill structure.
-
businessProfileId: string
The business profile ID.
-
cycleSpecification: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillingCycleSpecification":"#/components/schemas/BillingCycleSpecification", "BillingCycleSpecificationRef":"#/components/schemas/BillingCycleSpecificationRef" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillingCycleSpecification entity and not the BillingCycleSpecificationRefOrValue class itself -
format: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillFormat":"#/components/schemas/BillFormat", "BillFormatRef":"#/components/schemas/BillFormatRef" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillFormat entity and not the BillFormatRefOrValue class itself -
id: string
The bill unit ID.
-
name: string
The bill unit name.
-
payType: string
Allowed Values:
[ "invoice", "credit_card", "direct_debit", "subordinate" ]The pay type: invoice, credit_card, direct_debit, or subordinate. -
presentationMedia: array
presentationMedia
objectDiscriminator Values
-
BillingCycleSpecificationOracle
-
object
BillingCycleSpecificationRef
BillingCycleSpecification reference. A description of when to initiate a billing cycle and the various sub steps of a billing cycle.
array-
Array of:
object Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "BillPresentationMedia":"#/components/schemas/BillPresentationMedia", "BillPresentationMediaRef":"#/components/schemas/BillPresentationMediaRef" } }The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillPresentationMedia entity and not the BillPresentationMediaRefOrValue class itself
object-
consumptionRule: string
The consumption rule.
-
id: string
The identification of the balance group.
-
isDefault: boolean
The Boolean value for the default balance group.
-
limit: array
limit
-
name: string
The name of the balance group.
-
rolledUpCreditLimit: integer
(double)
The credit threshold.
-
services: array
services
-
tempLimit: array
tempLimit
object-
creditFloor: integer
(double)
The credit floor.
-
creditLimit(required): integer
(double)
The credit limit of balance group.
-
dynamicCreditFloor: boolean
The Boolean value for dynamic credit floor.
-
unit(required): string
The unit of credit limit.
object-
id: string
The service id associated with the balance group
object-
creditLimit(required): integer
(double)
The credit limit.
-
recId: string
The rec ID.
-
unit(required): string
The credit limit's unit.
-
validFrom: string
(date-time)
The valid start date.Example:
1985-04-12T23:20:50.52Z -
validFromDuration: object
validFromDuration
-
validTo: string
(date-time)
The valid end date.Example:
1985-04-12T23:20:50.52Z -
validToDuration: object
validToDuration
object-
offset: integer
(double)
The valid start date offset.
-
unit: string
(date-time)
The valid start date unit.Example:
1985-04-12T23:20:50.52Z
object-
offset: integer
(double)
The valid end date offset.
-
unit: string
(date-time)
The valid end date unit.Example:
1985-04-12T23:20:50.52Z
-
object
allOf
Entity
The Base entity schema for use in TMForum Open-APIs Property.
-
object
BillingCycleSpecificationOracle-allOf[1]
A detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
object-
billingDateShift: integer
An offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period.
-
description: string
An explanation regarding this billing cycle specification
-
frequency: string
Allowed Values:
[ "monthly", "bi-monthly", "quarterly", "semiyearly", "yearly" ]The frequency of the billing cycle: monthly, bi-monthly, quarterly, semiyearly, or yearly. -
name: string
A short descriptive name
-
paymentDueDateOffset: integer
An offset of a payment due date. The offset is expressed as number of days with regard to the start of the BillingPeriod.
-
object
ContactOracle-allOf[0]
A list of individuals or organizations used as contact points for a given account, each accessed via some contact medium.
object-
contactMedium: array
contactMedium
-
contactName: string
Name of the contact
-
contactType: string
Type of the contact
-
salutation: string
Salutation for name
-
object
ContactMediumOracle-allOf[0]
The contact medium that could be used to contact the party.
object-
company: string
Associated company name.
-
geoCode: string
Geographic code for the address.
-
mediumType: string
Allowed Values:
[ "PostalAddress", "Phone", "Email", "Fax" ]The type of contact medium: PostalAddress, Phone, Email, or Fax. -
phoneType: string
Allowed Values:
[ "email", "home", "work", "pager", "portable", "pop", "support" ]The phone type classification: email, home, work, pager, portable, pop, or support.
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
RelatedPartyOracle-allOf[1]
The relatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
object-
partyOrPartyRole: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type", "mapping":{ "PartyRef":"#/components/schemas/PartyRef", "PartyRoleRef":"#/components/schemas/PartyRoleRef" } }The reference allows either a party or a party role to be specified. -
role(required): string
The role played by the related party or party role in the context of the specific entity it is linked to. Such as 'initiator', 'customer', 'salesAgent', 'user'
-
object
allOf
TaxExemptionCertificateOracle-allOf[0]
A tax exemption certificate represents a tax exemption granted to a party (individual or organization) by a tax jurisdiction which may be a city, state, country,... An exemption has a certificate identifier (received from the jurisdiction that levied the tax) and a validity period. An exemption is per tax types and determines for each type of tax what portion of the tax is exempted (partial by percentage or complete) via the tax definition.
object-
certificateNumber: string
The identifier of a document that shows proof of exemption from taxes for the taxing jurisdiction.
-
id(required): string
Identifier of the tax exemption within list of the exemptions
-
issuingJurisdiction: string
Name of the jurisdiction that issued the exemptionExample:
USA -
reason: string
Reason for the tax exemption
-
taxDefinition: array
taxDefinition
A list of taxes that are covered by the exemption, such as City Tax or State Tax. The definition would include the exemption (e.g. for a rate exemption 0% would be a full exemption, 5% could be a partial exemption if the actual rate was 10%).
-
validFor: object
TimePeriod
The period of time, as a deadline (endDateTime only), a startDateTime only, or both.
-
object
allOf
Entity
The Base entity schema for use in TMForum Open-APIs Property.
202 Response
400 Response
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Error-allOf[1]
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
code(required): string
The application relevant detail, defined in the API or a common list.
-
message: string
The details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
The explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
The URI of documentation describing the error.
-
status: string
The HTTP error code extension
401 Response
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Error-allOf[1]
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
code(required): string
The application relevant detail, defined in the API or a common list.
-
message: string
The details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
The explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
The URI of documentation describing the error.
-
status: string
The HTTP error code extension
403 Response
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Error-allOf[1]
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
code(required): string
The application relevant detail, defined in the API or a common list.
-
message: string
The details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
The explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
The URI of documentation describing the error.
-
status: string
The HTTP error code extension
404 Response
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Error-allOf[1]
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
code(required): string
The application relevant detail, defined in the API or a common list.
-
message: string
The details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
The explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
The URI of documentation describing the error.
-
status: string
The HTTP error code extension
405 Response
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Error-allOf[1]
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
code(required): string
The application relevant detail, defined in the API or a common list.
-
message: string
The details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
The explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
The URI of documentation describing the error.
-
status: string
The HTTP error code extension
409 Response
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Error-allOf[1]
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
code(required): string
The application relevant detail, defined in the API or a common list.
-
message: string
The details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
The explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
The URI of documentation describing the error.
-
status: string
The HTTP error code extension
500 Response
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Error-allOf[1]
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
code(required): string
The application relevant detail, defined in the API or a common list.
-
message: string
The details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
The explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
The URI of documentation describing the error.
-
status: string
The HTTP error code extension
501 Response
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Error-allOf[1]
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
code(required): string
The application relevant detail, defined in the API or a common list.
-
message: string
The details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
The explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
The URI of documentation describing the error.
-
status: string
The HTTP error code extension
503 Response
-
object
Extensible
The Base Extensible schema for use in TMForum Open-APIs - When used for in a schema it means that the Entity described by the schema MUST be extended with the @type
-
object
Error-allOf[1]
object-
@baseType: string
The defines the super-class when sub-classing.
-
@schemaLocation: string
The URI to a JSON-Schema file that defines additional attributes and relationships.
-
@type(required): string
The definition of the sub-class extensible name, when sub-classing.
object-
code(required): string
The application relevant detail, defined in the API or a common list.
-
message: string
The details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
The explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
The URI of documentation describing the error.
-
status: string
The HTTP error code extension
Examples
Example 1: Update the Description
The following example shows how to update a billing account's description by submitting a PATCH 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 PATCH 'http://host:port/brm/accountManagement/version/billingAccount/0.0.0.1+-account+177082' -d @createBillingAccount.json
Request Body
The following is an example of the request body in JSON format.
{
"description": "patching description"
}
Response Body
The following is an example of the response body in JSON format.
{
"name": "Full Home Account",
"@type": "BillingAccount",
"billStructure": {
"payType": "invoice",
"name": "Comprehensive Bill Structure",
"businessProfileId": "0.0.0.0++0",
"actgType": "balance_forward",
"billingSegment": "0",
"id": "Comprehensice-Bill-Structure",
"@type": "BillStructure",
"format": {
"name": "Summary Invoice",
"id": "summary-invoice",
"href": "https://localhost:9998/brm/accountManagement/v5/billFormat/summary-invoice",
"@type": "BillFormat"
},
"acctSuppressed": false,
"cycleSpecification": {
"name": "test4",
"id": "test4",
"href": "https://localhost:9998/brm/accountManagement/v5/billingCycleSpecification/test4",
"@type": "BillingCycleSpecification",
"billingDateShift": 3,
"paymentDueDateOffset": 3,
"frequency": "yearly"
},
"balanceGroup": [
{
"id": "0.0.0.1+-balance_group+195759",
"name": "",
"isDefault": true,
"limit": [
{
"unit": "USD",
"dynamicCreditFloor": false,
"creditFloor": null,
"creditLimit": 10000
}
]
}
],
"presentationMedia": [
{
"name": "Post Mail",
"id": "post-mail",
"href": "https://localhost:9998/brm/accountManagement/v5/billPresentationMedia/post-mail",
"@type": "BillPresentationMedia"
}
]
},
"glSegment": ".",
"description": "patching description",
"accountType": "consumer",
"state": "active",
"relatedParty": [
{
"partyOrPartyRole": {
"id": "9948",
"name": "Related Party Name2",
"partyName": "partyName-004",
"partyId": "partyId-004"
},
"@type": "RelatedPartyRefOrPartyRoleRef",
"role": "service provider2"
}
],
"id": "account-with-only-mandatory-fields",
"href": "https://localhost:9998/brm/accountManagement/v5/billingAccount/account-with-only-mandatory-fields",
"brmAccountType": "standard",
"currencySecondary": "",
"accountNum": "0.0.0.1-193839",
"contact": [
{
"contactMedium": [
{
"@type": "GeographicAddressContactMedium",
"mediumType": "PostalAddress",
"country": "France",
"city": "France",
"street1": "Rue des Canards",
"postCode": "75014"
},
{
"@type": "EmailContactMedium",
"emailAddress": "test@oracle.com",
"mediumType": "Email"
},
{
"phoneType": "email",
"@type": "PhoneContactMedium",
"phoneNumber": "28412",
"mediumType": "Phone"
},
{
"phoneType": "fax",
"@type": "FaxContactMedium",
"faxNumber": "141231112",
"mediumType": "Fax"
}
],
"@type": "Contact",
"contactType": "primary",
"contactName": "John MB Douglas",
"salutation": ""
}
],
"customerSegmentList": "",
"locale": "en_US",
"currency": "USD"
}
Example 2: Update the Account State
The following example shows how to update a billing account's state to cancelled by submitting a PATCH 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 PATCH 'http://host:port/brm/accountManagement/version/billingAccount/0.0.0.1+-account+177082' -d @createBillingAccount.json
Request Body
The following is an example of the request body in JSON format.
{
"@type": "BillingAccount",
"state": "cancelled"
}
Response Body
The following is an example of the response body in JSON format.
{
"name": "Full Home Account",
"@type": "BillingAccount",
"billStructure": {
"payType": "invoice",
"name": "Comprehensive Bill Structure",
"businessProfileId": "0.0.0.0++0",
"actgType": "balance_forward",
"billingSegment": "0",
"id": "Comprehensice-Bill-Structure",
"@type": "BillStructure",
"format": {
"name": "Summary Invoice",
"id": "summary-invoice",
"href": "https://localhost:9998/brm/accountManagement/v5/billFormat/summary-invoice",
"@type": "BillFormat"
},
"acctSuppressed": false,
"cycleSpecification": {
"name": "test4",
"id": "test4",
"href": "https://localhost:9998/brm/accountManagement/v5/billingCycleSpecification/test4",
"@type": "BillingCycleSpecification",
"billingDateShift": 3,
"paymentDueDateOffset": 3,
"frequency": "yearly"
},
"balanceGroup": [
{
"id": "0.0.0.1+-balance_group+195759",
"name": "",
"isDefault": true,
"limit": [
{
"unit": "USD",
"dynamicCreditFloor": false,
"creditFloor": null,
"creditLimit": 10000
}
]
}
],
"presentationMedia": [
{
"name": "Post Mail",
"id": "post-mail",
"href": "https://localhost:9998/brm/accountManagement/v5/billPresentationMedia/post-mail",
"@type": "BillPresentationMedia"
}
]
},
"glSegment": ".",
"description": "Billing Account",
"accountType": "consumer",
"state": "cancelled",
"relatedParty": [
{
"partyOrPartyRole": {
"id": "9948",
"name": "Related Party Name2",
"partyName": "partyName-004",
"partyId": "partyId-004"
},
"@type": "RelatedPartyRefOrPartyRoleRef",
"role": "service provider2"
}
],
"id": "account-with-only-mandatory-fields",
"href": "https://localhost:9998/brm/accountManagement/v5/billingAccount/account-with-only-mandatory-fields",
"brmAccountType": "standard",
"currencySecondary": "",
"accountNum": "0.0.0.1-193839",
"contact": [
{
"contactMedium": [
{
"@type": "GeographicAddressContactMedium",
"mediumType": "PostalAddress",
"country": "France",
"city": "France",
"street1": "Rue des Canards",
"postCode": "75014"
},
{
"@type": "EmailContactMedium",
"emailAddress": "test@oracle.com",
"mediumType": "Email"
},
{
"phoneType": "email",
"@type": "PhoneContactMedium",
"phoneNumber": "28412",
"mediumType": "Phone"
},
{
"phoneType": "fax",
"@type": "FaxContactMedium",
"faxNumber": "141231112",
"mediumType": "Fax"
}
],
"@type": "Contact",
"contactType": "primary",
"contactName": "John MB Douglas",
"salutation": ""
}
],
"customerSegmentList": "",
"locale": "en_US",
"currency": "USD"
}
Example 3: Add the Tax Exemption
The following example shows how to add a tax exemption to a billing account by submitting a PATCH 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 PATCH 'http://host:port/brm/accountManagement/version/billingAccount/0.0.0.1+-account+177082' -d @createBillingAccount.json
Request Body
The following is an example of the request body in JSON format.
{
"taxExemption": [
{
"certificateNumber": "1234",
"issuingJurisdiction": "USA",
"validFor": {
"startDateTime": "2024-07-31T11:30:00.000Z",
"endDateTime": "2027-08-06T11:30:00.000Z"
},
"reason": "NGO",
"id": "EXEM01",
"taxDefinition": [
{
"percent": 0.5,
"Type": "Federal"
},
{
"percent": 0.3,
"Type": "State"
}
]
},
{
"certificateNumber": "6789",
"issuingJurisdiction": "USA",
"validFor": {
"startDateTime": "2024-07-31T11:30:00.000Z",
"endDateTime": "2027-08-06T11:30:00.000Z"
},
"reason": "Embassy",
"id": "EXEM02",
"taxDefinition": [
{
"percent": 0.6,
"Type": "Country"
},
{
"percent": 0.7,
"Type": "City"
}
]
}
]
}
Response Body
The following is an example of the response body in JSON format.
{
"name": "Full Home Account",
"@type": "BillingAccount",
"billStructure": {
"payType": "invoice",
"name": "Comprehensive Bill Structure",
"businessProfileId": "0.0.0.0++0",
"actgType": "balance_forward",
"billingSegment": "0",
"id": "Comprehensice-Bill-Structure",
"@type": "BillStructure",
"format": {
"name": "Summary Invoice",
"id": "summary-invoice",
"href": "https://localhost:9998/brm/accountManagement/v5/billFormat/summary-invoice",
"@type": "BillFormat"
},
"acctSuppressed": false,
"cycleSpecification": {
"name": "test4",
"id": "test4",
"href": "https://localhost:9998/brm/accountManagement/v5/billingCycleSpecification/test4",
"@type": "BillingCycleSpecification",
"billingDateShift": 3,
"paymentDueDateOffset": 3,
"frequency": "yearly"
},
"balanceGroup": [
{
"id": "0.0.0.1+-balance_group+195759",
"name": "",
"isDefault": true,
"limit": [
{
"unit": "USD",
"dynamicCreditFloor": false,
"creditFloor": null,
"creditLimit": 10000
}
]
}
],
"presentationMedia": [
{
"name": "Post Mail",
"id": "post-mail",
"href": "https://localhost:9998/brm/accountManagement/v5/billPresentationMedia/post-mail",
"@type": "BillPresentationMedia"
}
]
},
"glSegment": ".",
"description": "patching description",
"accountType": "consumer",
"state": "active",
"relatedParty": [
{
"partyOrPartyRole": {
"id": "9948",
"name": "Related Party Name2",
"partyName": "partyName-004",
"partyId": "partyId-004"
},
"@type": "RelatedPartyRefOrPartyRoleRef",
"role": "service provider2"
}
],
"id": "account-with-only-mandatory-fields",
"href": "https://localhost:9998/brm/accountManagement/v5/billingAccount/account-with-only-mandatory-fields",
"taxExemption": [
{
"certificateNumber": "1234",
"issuingJurisdiction": "USA",
"validFor": {
"endDateTime": "2024-07-31T11:30:00.000Z",
"startDateTime": "2027-08-06T11:30:00.000Z"
},
"reason": "NGO",
"id": "EXEM01",
"taxDefinition": [
{
"percent": 0.5,
"Type": "federal"
},
{
"percent": 0.3,
"Type": "state"
}
]
},
{
"certificateNumber": "6789",
"issuingJurisdiction": "USA",
"validFor": {
"startDateTime": "2024-07-31T11:30:00.000Z",
"endDateTime": "2027-08-06T11:30:00.000Z"
},
"reason": "Embassy",
"id": "EXEM02",
"taxDefinition": [
{
"percent": 0.6,
"Type": "Country"
},
{
"percent": 0.7,
"Type": "City"
}
]
}
],
"brmAccountType": "standard",
"currencySecondary": "",
"accountNum": "0.0.0.1-193839",
"contact": [
{
"contactMedium": [
{
"@type": "GeographicAddressContactMedium",
"mediumType": "PostalAddress",
"country": "France",
"city": "France",
"street1": "Rue des Canards",
"postCode": "75014"
},
{
"@type": "EmailContactMedium",
"emailAddress": "test@oracle.com",
"mediumType": "Email"
},
{
"phoneType": "email",
"@type": "PhoneContactMedium",
"phoneNumber": "28412",
"mediumType": "Phone"
},
{
"phoneType": "fax",
"@type": "FaxContactMedium",
"faxNumber": "141231112",
"mediumType": "Fax"
}
],
"@type": "Contact",
"contactType": "primary",
"contactName": "John MB Douglas",
"salutation": ""
}
],
"customerSegmentList": "",
"locale": "en_US",
"currency": "USD"
}