1. REST Services Manager API for Billing and Revenue Management
  2. Tasks
  3. Account Management
  4. Billing Account

Partially Update a Billing Account

patch

/billingAccount/{id}

The operation updates partially a Billing Account entity.

Request

Path Parameters
Query Parameters
Supported Media Types
Request Body - application/json-patch-query+json ()
Root Schema : schema
Type: array
The JSONPatch Operations document as defined by RFC 6902.
Show Source
Nested Schema : JsonPatch
Type: object
The JSONPatch document as defined by RFC 6902.
Show Source
Request Body - application/json-patch+json ()
Root Schema : schema
Type: array
The JSONPatch Operations document as defined by RFC 6902.
Show Source
Nested Schema : JsonPatch
Type: object
The JSONPatch document as defined by RFC 6902.
Show Source
Request Body - application/merge-patch+json ()
Root Schema : schema
Match All
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.
Show Source
  • PartyAccount_MVO
  • 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.
Nested Schema : PartyAccount_MVO
Match All
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.
Show Source
Nested Schema : Account_MVO
Match All
The generic account structure used to define commonalities between sub concepts of Party Account other types of accounts supported by the API.
Show Source
Nested Schema : Entity_MVO
Type: object
THe Base entity schema for use in TMForum Open-APIs Property.
Match All
THe Base entity schema for use in TMForum Open-APIs Property.
Show Source
  • 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
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Account_MVO-allOf[1]
Type: object
The generic account structure used to define commonalities between sub concepts of Party Account other types of accounts supported by the API.
Show Source
Nested Schema : PartyAccount_MVO-allOf[1]
Type: object
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.
Show Source
Nested Schema : type
Type: object
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.
Nested Schema : accountRelationship
Type: array
The list of balances related to the account.
Show Source
Nested Schema : contact
Type: array
The list of balances for the account, for example, regular postpaid balance, deposit balance, write-off balance.
Show Source
Nested Schema : relatedParty
Type: array
The list of parties that have some relationship with the account, for example, the customer to whom the account belongs.
Show Source
Nested Schema : taxExemption
Type: array
The list of tax exemptions that can be applied when calculating charges levied to the account.
Show Source
Nested Schema : AccountRelationship_MVO
Match All
Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing account.
Show Source
Nested Schema : AccountRelationship_MVO-allOf[1]
Type: object
Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing account.
Show Source
Nested Schema : AccountRef_MVO
Type: object
The account reference.
Match All
The account reference.
Show Source
Nested Schema : EntityRef
Match All
The entity reference schema to be use for all entityRef class.
Show Source
  • 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
  • Addressable
    The base schema for adressable entities.
  • EntityRef-allOf[2]
    The entity reference schema to be use for all entityRef class.
Nested Schema : Addressable
Type: object
The base schema for adressable entities.
Show Source
Nested Schema : EntityRef-allOf[2]
Type: object
The entity reference schema to be use for all entityRef class.
Show Source
Nested Schema : Contact_MVO
Match All
The individual or an organization used as a contact point for a given account and accessed via some contact medium.
Show Source
  • 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
  • Contact_MVO-allOf[1]
    The individual or an organization used as a contact point for a given account and accessed via some contact medium.
Nested Schema : Contact_MVO-allOf[1]
Type: object
The individual or an organization used as a contact point for a given account and accessed via some contact medium.
Show Source
Nested Schema : contactMedium
Type: array
The list of contact mediums, such as mobile phone number and email addresses.
Show Source
Nested Schema : ContactMedium_MVO
Match All
The contact medium that could be used to contact the party.
Show Source
  • 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
  • ContactMedium_MVO-allOf[1]
    The contact medium that could be used to contact the party.
Nested Schema : ContactMedium_MVO-allOf[1]
Type: object
The contact medium that could be used to contact the party.
Show Source
Nested Schema : RelatedPartyRefOrPartyRoleRef_MVO
Match All
RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Show Source
  • 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
  • RelatedPartyRefOrPartyRoleRef_MVO-allOf[1]
    RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Nested Schema : RelatedPartyRefOrPartyRoleRef_MVO-allOf[1]
Type: object
RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Show Source
  • 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 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'
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The reference allows either a party or a party role to be specified.
Match One Schema
Show Source
Nested Schema : PartyRef_MVO
Type: object
A Party reference.
Match All
A Party reference.
Show Source
Nested Schema : PartyRoleRef_MVO
Match All
The Party Role reference. A party role represents the part played by a party in a given context.
Show Source
Nested Schema : PartyRoleRef_MVO-allOf[1]
Type: object
The Party Role reference. A party role represents the part played by a party in a given context.
Show Source
  • The identifier of the engaged party that is linked to the PartyRole object.
  • The name of the engaged party that is linked to the PartyRole object.
Nested Schema : TaxExemptionCertificate_MVO
Match All
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.
Show Source
  • 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
  • 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.
Nested Schema : TaxExemptionCertificate_MVO-allOf[1]
Type: object
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.
Show Source
Nested Schema : taxDefinition
Type: array
The list of taxes that are covered by the exemption, for example, City Tax, 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%).
Show Source
Nested Schema : TimePeriod
Type: object
The period of time, either as a deadline (endDateTime only) a startDateTime only, or both.
Show Source
Nested Schema : TaxDefinition_MVO
Match All
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.).
Show Source
  • 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
  • TaxDefinition_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.).
Nested Schema : TaxDefinition_MVO-allOf[1]
Type: object
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.).
Show Source
Nested Schema : BillStructure_MVO
Match All
The structure of the bill for party accounts (billing or settlement).
Show Source
  • 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
  • BillStructure_MVO-allOf[1]
    The structure of the bill for party accounts (billing or settlement).
Nested Schema : BillStructure_MVO-allOf[1]
Type: object
The structure of the bill for party accounts (billing or settlement).
Show Source
Nested Schema : BillingCycleSpecificationOracle_MVO
Match All
A detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Show Source
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillFormat entity and not the BillFormatRefOrValue class itself
Match One Schema
Show Source
Nested Schema : presentationMedia
Type: array
Show Source
  • 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
Nested Schema : BillingCycleSpecificationOracle_MVO-allOf[1]
Type: object
A detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Show Source
  • 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.
  • The explanation regarding this billing cycle specification.
  • Allowed Values: [ "monthly", "bi-monthly", "quarterly", "semiyearly", "yearly" ]
    The frequency of the billing cycle, such as monthly.
  • A short descriptive name
  • The offset of a payment due date. The offset is expressed as number of days with regard to the start of the BillingPeriod.
  • TimePeriod
    The period of time, either as a deadline (endDateTime only) a startDateTime only, or both.
Nested Schema : schema
Match All
The detailed description of the way in which a bill is presented.
Show Source
Nested Schema : BillFormatRef_MVO
Type: object
The BillFormat reference. A bill format is a description of the way in which a bill is presented.
Match All
The BillFormat reference. A bill format is a description of the way in which a bill is presented.
Show Source
Nested Schema : type
Type: object
The detailed description of the way in which a bill is presented.
Show Source
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillPresentationMedia entity and not the BillPresentationMediaRefOrValue class itself
Match One Schema
Show Source
Nested Schema : schema
Match All
The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
  • Entity_MVO
    THe Base entity schema for use in TMForum Open-APIs Property.
  • type
    The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Nested Schema : BillPresentationMediaRef_MVO
Type: object
The PresentationMedia reference. A mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Match All
The PresentationMedia reference. A mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
Nested Schema : type
Type: object
The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
Request Body - application/json ()
Root Schema : schema
Match One Schema
Show Source
Nested Schema : schema
Match All
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.
Show Source
  • PartyAccount_MVO
  • 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.
Nested Schema : BillingAccountOracle_MVO
Match All
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.
Show Source
  • Entity
    The Base entity schema for use in TMForum Open-APIs Property.
  • 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.
Nested Schema : PartyAccount_MVO
Match All
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.
Show Source
Nested Schema : Account_MVO
Match All
The generic account structure used to define commonalities between sub concepts of Party Account other types of accounts supported by the API.
Show Source
Nested Schema : Entity_MVO
Type: object
THe Base entity schema for use in TMForum Open-APIs Property.
Match All
THe Base entity schema for use in TMForum Open-APIs Property.
Show Source
  • 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
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Account_MVO-allOf[1]
Type: object
The generic account structure used to define commonalities between sub concepts of Party Account other types of accounts supported by the API.
Show Source
Nested Schema : PartyAccount_MVO-allOf[1]
Type: object
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.
Show Source
Nested Schema : type
Type: object
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.
Nested Schema : accountRelationship
Type: array
The list of balances related to the account.
Show Source
Nested Schema : contact
Type: array
The list of balances for the account, for example, regular postpaid balance, deposit balance, write-off balance.
Show Source
Nested Schema : relatedParty
Type: array
The list of parties that have some relationship with the account, for example, the customer to whom the account belongs.
Show Source
Nested Schema : taxExemption
Type: array
The list of tax exemptions that can be applied when calculating charges levied to the account.
Show Source
Nested Schema : AccountRelationship_MVO
Match All
Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing account.
Show Source
Nested Schema : AccountRelationship_MVO-allOf[1]
Type: object
Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing account.
Show Source
Nested Schema : AccountRef_MVO
Type: object
The account reference.
Match All
The account reference.
Show Source
Nested Schema : EntityRef
Match All
The entity reference schema to be use for all entityRef class.
Show Source
  • 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
  • Addressable
    The base schema for adressable entities.
  • EntityRef-allOf[2]
    The entity reference schema to be use for all entityRef class.
Nested Schema : Addressable
Type: object
The base schema for adressable entities.
Show Source
Nested Schema : EntityRef-allOf[2]
Type: object
The entity reference schema to be use for all entityRef class.
Show Source
Nested Schema : Contact_MVO
Match All
The individual or an organization used as a contact point for a given account and accessed via some contact medium.
Show Source
  • 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
  • Contact_MVO-allOf[1]
    The individual or an organization used as a contact point for a given account and accessed via some contact medium.
Nested Schema : Contact_MVO-allOf[1]
Type: object
The individual or an organization used as a contact point for a given account and accessed via some contact medium.
Show Source
Nested Schema : contactMedium
Type: array
The list of contact mediums, such as mobile phone number and email addresses.
Show Source
Nested Schema : ContactMedium_MVO
Match All
The contact medium that could be used to contact the party.
Show Source
  • 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
  • ContactMedium_MVO-allOf[1]
    The contact medium that could be used to contact the party.
Nested Schema : ContactMedium_MVO-allOf[1]
Type: object
The contact medium that could be used to contact the party.
Show Source
Nested Schema : RelatedPartyRefOrPartyRoleRef_MVO
Match All
RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Show Source
  • 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
  • RelatedPartyRefOrPartyRoleRef_MVO-allOf[1]
    RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Nested Schema : RelatedPartyRefOrPartyRoleRef_MVO-allOf[1]
Type: object
RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Show Source
  • 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 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'
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The reference allows either a party or a party role to be specified.
Match One Schema
Show Source
Nested Schema : PartyRef_MVO
Type: object
A Party reference.
Match All
A Party reference.
Show Source
Nested Schema : PartyRoleRef_MVO
Match All
The Party Role reference. A party role represents the part played by a party in a given context.
Show Source
Nested Schema : PartyRoleRef_MVO-allOf[1]
Type: object
The Party Role reference. A party role represents the part played by a party in a given context.
Show Source
  • The identifier of the engaged party that is linked to the PartyRole object.
  • The name of the engaged party that is linked to the PartyRole object.
Nested Schema : TaxExemptionCertificate_MVO
Match All
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.
Show Source
  • 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
  • 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.
Nested Schema : TaxExemptionCertificate_MVO-allOf[1]
Type: object
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.
Show Source
Nested Schema : taxDefinition
Type: array
The list of taxes that are covered by the exemption, for example, City Tax, 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%).
Show Source
Nested Schema : TimePeriod
Type: object
The period of time, either as a deadline (endDateTime only) a startDateTime only, or both.
Show Source
Nested Schema : TaxDefinition_MVO
Match All
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.).
Show Source
  • 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
  • TaxDefinition_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.).
Nested Schema : TaxDefinition_MVO-allOf[1]
Type: object
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.).
Show Source
Nested Schema : BillStructure_MVO
Match All
The structure of the bill for party accounts (billing or settlement).
Show Source
  • 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
  • BillStructure_MVO-allOf[1]
    The structure of the bill for party accounts (billing or settlement).
Nested Schema : BillStructure_MVO-allOf[1]
Type: object
The structure of the bill for party accounts (billing or settlement).
Show Source
Nested Schema : BillingCycleSpecificationOracle_MVO
Match All
A detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Show Source
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillFormat entity and not the BillFormatRefOrValue class itself
Match One Schema
Show Source
Nested Schema : presentationMedia
Type: array
Show Source
  • 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
Nested Schema : BillingCycleSpecificationOracle_MVO-allOf[1]
Type: object
A detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Show Source
  • 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.
  • The explanation regarding this billing cycle specification.
  • Allowed Values: [ "monthly", "bi-monthly", "quarterly", "semiyearly", "yearly" ]
    The frequency of the billing cycle, such as monthly.
  • A short descriptive name
  • The offset of a payment due date. The offset is expressed as number of days with regard to the start of the BillingPeriod.
  • TimePeriod
    The period of time, either as a deadline (endDateTime only) a startDateTime only, or both.
Nested Schema : schema
Match All
The detailed description of the way in which a bill is presented.
Show Source
Nested Schema : BillFormatRef_MVO
Type: object
The BillFormat reference. A bill format is a description of the way in which a bill is presented.
Match All
The BillFormat reference. A bill format is a description of the way in which a bill is presented.
Show Source
Nested Schema : type
Type: object
The detailed description of the way in which a bill is presented.
Show Source
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillPresentationMedia entity and not the BillPresentationMediaRefOrValue class itself
Match One Schema
Show Source
Nested Schema : schema
Match All
The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
  • Entity_MVO
    THe Base entity schema for use in TMForum Open-APIs Property.
  • type
    The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Nested Schema : BillPresentationMediaRef_MVO
Type: object
The PresentationMedia reference. A mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Match All
The PresentationMedia reference. A mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
Nested Schema : type
Type: object
The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
Nested Schema : Entity
Type: object
The Base entity schema for use in TMForum Open-APIs Property.
Match All
The Base entity schema for use in TMForum Open-APIs Property.
The Base entity schema for use in TMForum Open-APIs Property.
Show Source
  • 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
  • Addressable
    The base schema for adressable entities.
Nested Schema : BillingAccountOracle_MVO-allOf[1]
Type: object
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.
Show Source
Nested Schema : AccountRelationshipOracle_MVO
Match All
Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing account.
Show Source
Nested Schema : BillStructureOracle_MVO
Match All
The extended bill structure for Oracle implementation.
Show Source
Nested Schema : ContactOracle_MVO
Match All
The individual or an organization used as a contact point for a given account and accessed via some contact medium.
Show Source
Nested Schema : ServiceBillStructureOracle_MVO
Type: array
The array of Bill Structures.
Show Source
Nested Schema : TaxExemptionCertificateOracle_MVO
Match All
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.
Show Source
  • TaxExemptionCertificate_MVO
  • 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, 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.
Nested Schema : AccountRelationshipOracle_MVO-allOf[1]
Type: object
Significant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing account.
Show Source
Nested Schema : account
Type: object
Account reference. An account may be a party account or a financial account.
Show Source
Nested Schema : billStructure
Type: object
The bill structure object.
Show Source
Nested Schema : billStructure
Type: object
The bill structure object of account.
Show Source
Nested Schema : BillStructureOracle_MVO-allOf[1]
Type: object
The extended bill structure for Oracle implementation.
Show Source
Nested Schema : balanceGroup
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : limit
Type: array
Show Source
Nested Schema : rule
Type: array
Show Source
Nested Schema : tempLimit
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : thresholds
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : validFromDuration
Type: object
Show Source
Nested Schema : validToDuration
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : ContactOracle_MVO-allOf[0]
Type: object
The individual or an organization used as a contact point for a given account and accessed via some contact medium.
Show Source
Nested Schema : contactMedium
Type: array
Show Source
Nested Schema : ContactMediumOracle_MVO
Match All
Indicates the contact medium that could be used to contact the party.
Show Source
Nested Schema : ContactMediumOracle_MVO-allOf[0]
Type: object
Indicates the contact medium that could be used to contact the party.
Show Source
Nested Schema : TaxExemptionCertificateOracle_MVO-allOf[1]
Type: object
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.
Show Source
  • taxDefinition
    The list of taxes that are covered by the exemption, e.g. City Tax, 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%).
Nested Schema : taxDefinition
Type: array
The list of taxes that are covered by the exemption, e.g. City Tax, 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%).
Show Source
Nested Schema : TaxDefinitionOracle_MVO
Match All
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.).
Show Source
  • TaxDefinition_MVO
  • 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.).
Nested Schema : TaxDefinitionOracle_MVO-allOf[1]
Type: object
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.).
Show Source
  • The tax percent.
  • 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
Examples

Back to Top

Response

200 Response

The operation was successful.
Body ()
Root Schema : schema
Match One Schema
Show Source
Nested Schema : BillingAccount
Match All
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.
Show Source
Nested Schema : BillingAccountOracle
Match All
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.
Show Source
  • Entity
    The Base entity schema for use in TMForum Open-APIs Property.
  • 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.
Nested Schema : PartyAccount
Match All
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.
Show Source
Nested Schema : Account
Match All
The generic account structure defines common elements for account types, including PartyAccount and other accounts supported by the API.
Show Source
  • Entity
    The Base entity schema for use in TMForum Open-APIs Property.
  • Account-allOf[1]
    The generic account structure defines common elements for account types, including PartyAccount and other accounts supported by the API.
Nested Schema : Entity
Type: object
The Base entity schema for use in TMForum Open-APIs Property.
Match All
The Base entity schema for use in TMForum Open-APIs Property.
The Base entity schema for use in TMForum Open-APIs Property.
Show Source
  • 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
  • Addressable
    The base schema for adressable entities.
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Addressable
Type: object
The base schema for adressable entities.
Show Source
Nested Schema : Account-allOf[1]
Type: object
The generic account structure defines common elements for account types, including PartyAccount and other accounts supported by the API.
Show Source
Nested Schema : PartyAccount-allOf[1]
Type: object
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.
Show Source
Nested Schema : BillingAccount-allOf[1]
Type: object
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.
Show Source
  • The indication for whether the account follows a specific payment option such as prepaid or postpaid.
Nested Schema : accountBalance
Type: array
The list of balances for the account, such as regular postpaid balance, deposit balance, or write-off balance.
Show Source
Nested Schema : accountRelationship
Type: array
such as regular postpaid balance, deposit balance, or write-off balance.
Show Source
Nested Schema : contact
Type: array
The list of people who could be contacted regarding the account, such as the accountant who authorizes payments.
Show Source
Nested Schema : Money
Type: object
The base / value business entity used to represent money.
Show Source
  • The currency (ISO4217 norm uses 3 letters to define the currency).
  • The signed floating point number, the meaning of the sign is according to the context of the API that uses this Data type
Nested Schema : relatedParty
Type: array
The list of parties that have some relationship with the account, such as the customer to whom the account belongs.
Show Source
Nested Schema : taxExemption
Type: array
The list of tax exemptions that can be applied when calculating charges levied to the account.
Show Source
Nested Schema : AccountBalance
Match All
The balances linked to the account.
Show Source
  • 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
  • AccountBalance-allOf[1]
    The balances linked to the account.
Nested Schema : AccountBalance-allOf[1]
Type: object
The balances linked to the account.
Show Source
Nested Schema : TimePeriod
Type: object
The period of time, either as a deadline (endDateTime only) a startDateTime only, or both.
Show Source
Nested Schema : AccountRelationship
Match All
The significant connection between accounts. For instance, an aggregating account for a list of shop branches each having its own billing account.
Show Source
Nested Schema : AccountRelationship-allOf[1]
Type: object
The significant connection between accounts. For instance, an aggregating account for a list of shop branches each having its own billing account.
Show Source
Nested Schema : AccountRef
Type: object
The account reference.
Match All
The account reference.
Show Source
Nested Schema : EntityRef
Match All
The entity reference schema to be use for all entityRef class.
Show Source
  • 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
  • Addressable
    The base schema for adressable entities.
  • EntityRef-allOf[2]
    The entity reference schema to be use for all entityRef class.
Nested Schema : EntityRef-allOf[2]
Type: object
The entity reference schema to be use for all entityRef class.
Show Source
Nested Schema : Contact
Match All
The individual or an organization used as a contact point for a given account and accessed via some contact medium.
Show Source
  • 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
  • Contact-allOf[1]
    The individual or an organization used as a contact point for a given account and accessed via some contact medium.
Nested Schema : Contact-allOf[1]
Type: object
The individual or an organization used as a contact point for a given account and accessed via some contact medium.
Show Source
Nested Schema : contactMedium
Type: array
The list of contact mediums for the contact, such as mobile phone number and email addresses.
Show Source
Nested Schema : ContactMedium
Match All
The contact medium that could be used to contact the party.
Show Source
  • 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
  • ContactMedium-allOf[1]
    The contact medium that could be used to contact the party.
Nested Schema : ContactMedium-allOf[1]
Type: object
The contact medium that could be used to contact the party.
Show Source
Nested Schema : RelatedPartyRefOrPartyRoleRef
Match All
The RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Show Source
  • 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
  • RelatedPartyRefOrPartyRoleRef-allOf[1]
    The RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Nested Schema : RelatedPartyRefOrPartyRoleRef-allOf[1]
Type: object
The RelatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Show Source
  • 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.
  • 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'
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The reference allows either a party or a party role to be specified.
Match One Schema
Show Source
Nested Schema : PartyRef
Type: object
A Party reference.
Match All
A Party reference.
Show Source
Nested Schema : PartyRoleRef
Match All
The Party Role reference. A party role represents the part played by a party in a given context.
Show Source
Nested Schema : PartyRoleRef-allOf[1]
Type: object
The Party Role reference. A party role represents the part played by a party in a given context.
Show Source
  • The identifier of the engaged party that is linked to the PartyRole object.
  • The name of the engaged party that is linked to the PartyRole object.
Nested Schema : TaxExemptionCertificate
Match All
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.
Show Source
  • 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
  • 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.
Nested Schema : TaxExemptionCertificate-allOf[1]
Type: object
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.
Show Source
  • 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.
  • The identifier of a document that shows proof of exemption from taxes for the taxing jurisdiction.
  • The identifier of the tax exemption within list of the exemptions.
  • The name of the jurisdiction that issued the exemption.
    Example: USA
  • The reason for the tax exemption.
  • taxDefinition
    The list of taxes that are covered by the exemption, for example, City Tax, 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%).
  • TimePeriod
    The period of time, either as a deadline (endDateTime only) a startDateTime only, or both.
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The polymorphic attributes @type, @schemaLocation, and @referredType are related to the Attachment entity and not the AttachmentRefOrValue class itself.
Match One Schema
Show Source
Nested Schema : taxDefinition
Type: array
The list of taxes that are covered by the exemption, for example, City Tax, 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%).
Show Source
Nested Schema : Attachment
Match All
The complementary description of an element (for instance a product) through video, pictures, etc.
Show Source
Nested Schema : AttachmentRef
Match All
The attachment reference. An attachment complements the description of an element (for instance a product) through video, pictures.
Show Source
Nested Schema : Attachment-allOf[1]
Type: object
The complementary description of an element (for instance a product) through video, pictures, etc.
Show Source
Nested Schema : Quantity
Type: object
The amount in a given unit.
Show Source
Nested Schema : AttachmentRef-allOf[1]
Type: object
The attachment reference. An attachment complements the description of an element (for instance a product) through video, pictures.
Show Source
Nested Schema : TaxDefinition
Match All
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.).
Show Source
  • 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
  • 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.).
Nested Schema : TaxDefinition-allOf[1]
Type: object
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.).
Show Source
Nested Schema : BillStructure
Match All
The structure of the bill for party accounts (billing or settlement).
Show Source
  • 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
  • BillStructure-allOf[1]
    The structure of the bill for party accounts (billing or settlement).
Nested Schema : BillStructure-allOf[1]
Type: object
The structure of the bill for party accounts (billing or settlement).
Show Source
  • 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
  • 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
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillingCycleSpecification entity and not the BillingCycleSpecificationRefOrValue class itself
Match One Schema
Show Source
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillFormat entity and not the BillFormatRefOrValue class itself
Match One Schema
Show Source
Nested Schema : presentationMedia
Type: array
Show Source
  • 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
Nested Schema : BillingCycleSpecification
Match All
The detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Show Source
Nested Schema : BillingCycleSpecificationRef
Type: object
BillingCycleSpecification reference. A description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Match All
BillingCycleSpecification reference. A description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Show Source
Nested Schema : BillingCycleSpecification-allOf[1]
Type: object
The detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Show Source
Nested Schema : BillFormat
Match All
The detailed description of the way in which a bill is presented.
Show Source
Nested Schema : BillFormatRef
Type: object
The BillFormat reference. A bill format is a description of the way in which a bill is presented.
Match All
The BillFormat reference. A bill format is a description of the way in which a bill is presented.
Show Source
Nested Schema : BillFormat-allOf[1]
Type: object
The detailed description of the way in which a bill is presented.
Show Source
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillPresentationMedia entity and not the BillPresentationMediaRefOrValue class itself
Match One Schema
Show Source
Nested Schema : BillPresentationMedia
Match All
The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
Nested Schema : BillPresentationMediaRef
Type: object
The PresentationMedia reference. A mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Match All
The PresentationMedia reference. A mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
Nested Schema : BillPresentationMedia-allOf[1]
Type: object
The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
Nested Schema : BillingAccountOracle-allOf[1]
Type: object
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.
Show Source
Nested Schema : AccountRelationshipOracle
Match All
The significant connection between accounts. For instance, an aggregating account for a list of shop branches each having its own billing account.
Show Source
Nested Schema : BillStructureOracle
Type: array
The array of bill structures.
Show Source
Nested Schema : ContactOracle
Type: array
A list of individuals or organizations used as contact points for a given account, each accessed via some contact medium.
Show Source
  • items
    An individual or an organization used as a contact point for a given account and accessed via some contact medium.
Nested Schema : RelatedPartyOracle
Match All
The relatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Show Source
  • 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
  • RelatedPartyOracle-allOf[1]
    The relatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Nested Schema : TaxExemptionCertificateOracle
Match All
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.
Show Source
  • 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.
Nested Schema : AccountRelationshipOracle-allOf[1]
Type: object
The significant connection between accounts. For instance, an aggregating account for a list of shop branches each having its own billing account.
Show Source
Nested Schema : account
Type: object
The account reference.
Show Source
Nested Schema : billStructure
Type: object
The bill structure object.
Show Source
Nested Schema : billStructure
Type: object
The bill structure object of the account.
Show Source
Nested Schema : BillStructureOracle_FVO
Match All
The extended bill structure for Oracle implementation.
Show Source
Nested Schema : BillStructure_FVO
Match All
The structure of the bill for party accounts (billing or settlement).
Show Source
  • Extensible_FVO
    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
  • BillStructure_FVO-allOf[1]
    The structure of the bill for party accounts (billing or settlement).
Nested Schema : Extensible_FVO
Type: object
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
Show Source
Nested Schema : BillStructure_FVO-allOf[1]
Type: object
The structure of the bill for party accounts (billing or settlement).
Show Source
Nested Schema : BillStructureOracle_FVO-allOf[1]
Type: object
The extended bill structure for Oracle implementation.
Show Source
Nested Schema : BillingCycleSpecification_FVO
Match All
A detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Show Source
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillFormat entity and not the BillFormatRefOrValue class itself
Match One Schema
Show Source
Nested Schema : presentationMedia
Type: array
Show Source
  • Discriminator: @type
    Discriminator: { "propertyName":"@type", "mapping":{ "BillPresentationMedia":"#/components/schemas/BillPresentationMedia_FVO", "BillPresentationMediaRef":"#/components/schemas/BillPresentationMediaRef_FVO" } }
    The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillPresentationMedia entity and not the BillPresentationMediaRefOrValue class itself
Nested Schema : Entity_FVO
Type: object
The Base entity schema for use in TMForum Open-APIs Property.
Match All
The Base entity schema for use in TMForum Open-APIs Property.
The Base entity schema for use in TMForum Open-APIs Property.
Show Source
  • Extensible_FVO
    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
  • Addressable_FVO
    The base schema for adressable entities.
Nested Schema : Addressable_FVO
Type: object
The base schema for adressable entities.
Show Source
Nested Schema : BillingCycleSpecification_FVO-allOf[1]
Type: object
A detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Show Source
Nested Schema : schema
Match All
The detailed description of the way in which a bill is presented.
Show Source
Nested Schema : BillFormatRef_FVO
Type: object
The BillFormat reference. A bill format is a description of the way in which a bill is presented.
Match All
The BillFormat reference. A bill format is a description of the way in which a bill is presented.
Show Source
Nested Schema : type
Type: object
The detailed description of the way in which a bill is presented.
Show Source
Nested Schema : EntityRef_FVO
Match All
The entity reference schema to be use for all entityRef class.
Show Source
Nested Schema : EntityRef_FVO-allOf[2]
Type: object
The entity reference schema to be use for all entityRef class.
Show Source
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

The polymorphic attributes @type, @schemaLocation & @referredType are related to the BillPresentationMedia entity and not the BillPresentationMediaRefOrValue class itself
Match One Schema
Show Source
Nested Schema : schema
Match All
The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
  • Entity_FVO
    The Base entity schema for use in TMForum Open-APIs Property.
  • type
    The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Nested Schema : BillPresentationMediaRef_FVO
Type: object
The PresentationMedia reference. A mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Match All
The PresentationMedia reference. A mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
Nested Schema : type
Type: object
The mean of communicating a bill, supported by the associated bill format. For example, post mail, email, web page.
Show Source
Nested Schema : balanceGroup
Type: array
Show Source
Nested Schema : BillingCycleSpecificationOracle_FVO
Match All
A detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : limit
Type: array
Show Source
Nested Schema : tempLimit
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : validFromDuration
Type: object
Show Source
Nested Schema : validToDuration
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : BillingCycleSpecificationOracle_FVO-allOf[1]
Type: object
A detailed description of when to initiate a billing cycle and the various sub steps of a billing cycle.
Show Source
Nested Schema : items
Type: object
An individual or an organization used as a contact point for a given account and accessed via some contact medium.
Show Source
Match All
An individual or an organization used as a contact point for a given account and accessed via some contact medium.
Show Source
Nested Schema : contactMedium
Type: array
Show Source
Nested Schema : ContactMediumOracle
Match All
The contact medium that could be used to contact the party.
Show Source
Nested Schema : ContactMediumOracle-allOf[0]
Type: object
The contact medium that could be used to contact the party.
Show Source
Nested Schema : RelatedPartyOracle-allOf[1]
Type: object
The relatedParty reference. A related party defines party or party role or its reference, linked to a specific entity
Show Source
  • 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.
  • 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'
Nested Schema : TaxExemptionCertificateOracle-allOf[0]
Type: object
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.
Show Source
Match All
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.
Show Source
Examples

202 Response

The request has been accepted for processing, but the processing is not yet complete.

400 Response

The server received a bad request.
Body ()
Root Schema : Error
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Match All
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
  • 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
  • Error-allOf[1]
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Error-allOf[1]
Type: object
Show Source

401 Response

The request was not authorized.
Body ()
Root Schema : Error
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Match All
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
  • 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
  • Error-allOf[1]
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Error-allOf[1]
Type: object
Show Source

403 Response

The request was forbidden.
Body ()
Root Schema : Error
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Match All
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
  • 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
  • Error-allOf[1]
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Error-allOf[1]
Type: object
Show Source

404 Response

The requested resource cannot be found.
Body ()
Root Schema : Error
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Match All
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
  • 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
  • Error-allOf[1]
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Error-allOf[1]
Type: object
Show Source

405 Response

The method is not allowed.
Body ()
Root Schema : Error
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Match All
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
  • 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
  • Error-allOf[1]
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Error-allOf[1]
Type: object
Show Source

409 Response

The request could not be processed due to a conflict with the existing state of the resource.
Body ()
Root Schema : Error
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Match All
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
  • 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
  • Error-allOf[1]
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Error-allOf[1]
Type: object
Show Source

500 Response

THe system has encountered an internal server error.
Body ()
Root Schema : Error
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Match All
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
  • 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
  • Error-allOf[1]
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Error-allOf[1]
Type: object
Show Source

501 Response

The request was not implemented.
Body ()
Root Schema : Error
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Match All
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
  • 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
  • Error-allOf[1]
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Error-allOf[1]
Type: object
Show Source

503 Response

The service is unavailable.
Body ()
Root Schema : Error
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Match All
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
The operation used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
  • 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
  • Error-allOf[1]
Nested Schema : Extensible
Type: object
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
Show Source
Nested Schema : Error-allOf[1]
Type: object
Show Source
Back to Top

Examples

Example 1: Update the Description

The following example shows how to partially update a Billing Account description by submitting a PATCH request on the REST resource using cURL. For more information about cURL, see Use cURL. 

curl -X PATCH 'http://host:port/brm/accountManagement/version/billingAccount/id'

Example of Response Body

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

{
 "description": "patching description"
}

Example 2: Update the Account Type

The following example shows how to partially update a Billing Account type by submitting a PATCH request on the REST resource using cURL. For more information about cURL, see Use cURL. 

curl -X PATCH 'http://host:port/brm/accountManagement/version/billingAccount/id'

Example of Response Body

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

{
		"accountType": "account type",
		"state": "status of account"
	}

Example 3: Add the Tax Exemption

The following example shows how to add a Billing Account tax exemption by submitting a PATCH request on the REST resource using cURL. For more information about cURL, see Use cURL. 

curl -X PATCH 'http://host:port/brm/accountManagement/version/billingAccount/id'

Example of Response Body

The following is an example of the response 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": 5,
						"Type": "Federal"
					},
					{
						"percent": 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": 6,
						"Type": "Country"
					},
					{
						"percent": 7,
						"Type": "City"
					}
				]
			}
		]
	}
Back to Top