BankServicesBillingStatementV04

camt.086.001.04

Scope The BankServicesBillingStatement message is used to send from a Financial Institution (FI) to its wholesale customers (corporations, governments, institutions, etc.), information describing the FI’s billing of services rendered in the form of an electronic statement in a standardised format. The BankServicesBillingStatement is a periodic (usually end of month) recounting of all service chargeable events that occurred during a reporting cycle, typically a calendar month, along with detailed tax and currency translation information. Account balance information, although strongly recommended, is not required. Usage The BankServicesBillingStatement message is designed to provide details related to invoices (or an advice of debit) which a financial institution may supply to its customers. The BankServicesBillingStatement is not expressly designed to be an invoice, nor to replace invoices currently in use. The message may be used as an invoice by agreement between the sender and the receiver. No regulatory or legislative requirements were considered when creating this message standard. Users of the BankServicesBillingStatement message are cautioned to be aware of any regulatory or legal requirement for invoices before replacing existing invoices. The BankServicesBillingStatement message can supply the detail supporting separate invoices or debits but it is not the invoice or advice of debit of record. The BankServicesBillingStatement message must accurately reflect all the charge and tax related events that occurred during the calendar month and how the FI and taxing authorities were compensated for these events. The BankServicesBillingStatement does not ask the financial institution to revise its established pricing and billing procedures. How, when and what the customer is actually charged for remains in place. The BankServicesBillingStatement message asks the financial institution to aggregate and report what actually happened during the calendar month. The BankServicesBillingStatement message is intended for use with the ISO 20022 Business Application Header.

Message Construction

Every ISO20022 message has at the highest level what we call ‘building blocks’. Because the message is constructed as immutable records, the association is by composition. Below you can see the relationship between the message and its constituent building blocks: For comparison, see the ISO20022 official specification

classDiagram
     direction LR
%% BankServicesBillingStatementV04 recursion level 0 with max 0
BankServicesBillingStatementV04 *-- "1..1" ReportHeader6 : ReportHeader
BankServicesBillingStatementV04 *-- "1..1" StatementGroup4 : BillingStatementGroup
  

Now, we will zero-in one-by-one on each of these building blocks.

ReportHeader building block

Provides header details on the billing statement report. Provides header details on the report. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ReportHeader6 recursion level 0 with max 1
class ReportHeader6{
    ReportIdentification IsoMax35Text
}
ReportHeader6 *-- "0..1" Pagination1 : MessagePagination
%% Pagination1 recursion level 1 with max 1
class Pagination1{
    PageNumber IsoMax5NumericText
    LastPageIndicator IsoYesNoIndicator
}
  

ReportHeader6 members

BillingStatementGroup building block

Group of bank services billing statements with the same sender and receiver characteristics. Group of the statement header reporting the bank services billing and the billing statement. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% StatementGroup4 recursion level 0 with max 1
class StatementGroup4{
    GroupIdentification IsoMax35Text
}
StatementGroup4 *-- "1..1" PartyIdentification138 : Sender
StatementGroup4 *-- "0..2" Contact4 : SenderIndividualContact
StatementGroup4 *-- "1..1" PartyIdentification138 : Receiver
StatementGroup4 *-- "0..2" Contact4 : ReceiverIndividualContact
StatementGroup4 *-- "1..0" BillingStatement4 : BillingStatement
%% PartyIdentification138 recursion level 1 with max 1
class PartyIdentification138{
    Name IsoMax140Text
    LegalName IsoMax140Text
    CountryOfResidence CountryCode
}
PartyIdentification138 *-- "0..1" PostalAddress24 : PostalAddress
PartyIdentification138 *-- "1..1" IParty43Choice : Identification
PartyIdentification138 *-- "0..1" Contact4 : ContactDetails
%% Contact4 recursion level 1 with max 1
class Contact4{
    NamePrefix NamePrefix2Code
    Name IsoMax140Text
    PhoneNumber IsoPhoneNumber
    MobileNumber IsoPhoneNumber
    FaxNumber IsoPhoneNumber
    EmailAddress IsoMax2048Text
    EmailPurpose IsoMax35Text
    JobTitle IsoMax35Text
    Responsibility IsoMax35Text
    Department IsoMax70Text
    PreferredMethod PreferredContactMethod1Code
}
Contact4 *-- "0..0" OtherContact1 : Other
%% PartyIdentification138 recursion level 1 with max 1
class PartyIdentification138{
    Name IsoMax140Text
    LegalName IsoMax140Text
    CountryOfResidence CountryCode
}
PartyIdentification138 *-- "0..1" PostalAddress24 : PostalAddress
PartyIdentification138 *-- "1..1" IParty43Choice : Identification
PartyIdentification138 *-- "0..1" Contact4 : ContactDetails
%% Contact4 recursion level 1 with max 1
class Contact4{
    NamePrefix NamePrefix2Code
    Name IsoMax140Text
    PhoneNumber IsoPhoneNumber
    MobileNumber IsoPhoneNumber
    FaxNumber IsoPhoneNumber
    EmailAddress IsoMax2048Text
    EmailPurpose IsoMax35Text
    JobTitle IsoMax35Text
    Responsibility IsoMax35Text
    Department IsoMax70Text
    PreferredMethod PreferredContactMethod1Code
}
Contact4 *-- "0..0" OtherContact1 : Other
%% BillingStatement4 recursion level 1 with max 1
class BillingStatement4{
    StatementIdentification IsoMax35Text
    CreationDateTime IsoISODateTime
    Status BillingStatementStatus1Code
}
BillingStatement4 *-- "1..1" DatePeriod1 : FromToDate
BillingStatement4 *-- "1..1" CashAccountCharacteristics4 : AccountCharacteristics
BillingStatement4 *-- "0..0" BillingRate1 : RateData
BillingStatement4 *-- "0..0" CurrencyExchange6 : CurrencyExchange
BillingStatement4 *-- "0..0" BillingBalance1 : Balance
BillingStatement4 *-- "0..0" BillingCompensation1 : Compensation
BillingStatement4 *-- "0..0" BillingService2 : Service
BillingStatement4 *-- "0..0" BillingTaxRegion2 : TaxRegion
BillingStatement4 *-- "0..0" BalanceAdjustment1 : BalanceAdjustment
BillingStatement4 *-- "0..0" BillingServiceAdjustment1 : ServiceAdjustment
  

StatementGroup4 members

Extensibility and generalization considerations

To facilitate generalized design patterns in the system, the BankServicesBillingStatementV04 implementation follows a specific implementaiton pattern. First of all, BankServicesBillingStatementV04 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, BankServicesBillingStatementV04Document implements IOuterDocument. Because BankServicesBillingStatementV04 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type BankServicesBillingStatementV04.

classDiagram
    class IOuterRecord
    BankServicesBillingStatementV04 --|> IOuterRecord : Implements
    BankServicesBillingStatementV04Document --|> IOuterDocument~BankServicesBillingStatementV04~ : Implements
    class IOuterDocument~BankServicesBillingStatementV04~ {
        BankServicesBillingStatementV04 Message
     }
  

Document wrapper for serialization

The only real purpose BankServicesBillingStatementV04Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:camt.086.001.04’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using BankServicesBillingStatementV04.ToDocument() method. The returned BankServicesBillingStatementV04Document value will serialize correctly according to ISO 20022 standards.

classDiagram
    BankServicesBillingStatementV04Document *-- BankServicesBillingStatementV04 : Document
  

Sample of message format

This is an abbreviated version of what the message should look like.

<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.086.001.04">
    <BkSvcsBllgStmt>
        <RptHdr>
            <!-- ReportHeader inner content -->
        </RptHdr>
        <BllgStmtGrp>
            <!-- BillingStatementGroup inner content -->
        </BllgStmtGrp>
    </BkSvcsBllgStmt>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_u4dOAdcAEeq_l4BJLVUF2Q"
  previousVersion="_bf9SDW2PEei3KuUgpx7Xcw"
  name="BankServicesBillingStatementV04"
  definition="Scope&#xD;&#xA;The BankServicesBillingStatement message is used to send from a Financial Institution (FI) to its wholesale customers (corporations, governments, institutions, etc.), information describing the FI’s billing of services rendered in the form of an electronic statement in a standardised format. The BankServicesBillingStatement is a periodic (usually end of month) recounting of all service chargeable events that occurred during a reporting cycle, typically a calendar month, along with detailed tax and currency translation information. Account balance information, although strongly recommended, is not required.&#xD;&#xA;Usage&#xD;&#xA;The BankServicesBillingStatement message is designed to provide details related to invoices (or an advice of debit) which a financial institution may supply to its customers. The BankServicesBillingStatement is not expressly designed to be an invoice, nor to replace invoices currently in use. The message may be used as an invoice by agreement between the sender and the receiver. No regulatory or legislative requirements were considered when creating this message standard. Users of the BankServicesBillingStatement message are cautioned to be aware of any regulatory or legal requirement for invoices before replacing existing invoices.&#xD;&#xA;The BankServicesBillingStatement message can supply the detail supporting separate invoices or debits but it is not the invoice or advice of debit of record. The BankServicesBillingStatement message must accurately reflect all the charge and tax related events that occurred during the calendar month and how the FI and taxing authorities were compensated for these events. The BankServicesBillingStatement does not ask the financial institution to revise its established pricing and billing procedures. &#xD;&#xA;How, when and what the customer is actually charged for remains in place. The BankServicesBillingStatement message asks the financial institution to aggregate and report what actually happened during the calendar month.&#xD;&#xA;The BankServicesBillingStatement message is intended for use with the ISO 20022 Business Application Header."
  registrationStatus="Registered"
  messageSet="_7Dl-wJYqEeKQfPIgXStMNw"
  xmlTag="BkSvcsBllgStmt"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_u4dOB9cAEeq_l4BJLVUF2Q"
    previousVersion="_bf9SD22PEei3KuUgpx7Xcw"
    name="ReportHeader"
    definition="Provides header details on the billing statement report."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="RptHdr"
    complexType="_IXU44Xk4Eei6JsZKrqN0hQ" />
  <messageBuildingBlock
    xmi:id="_u4dOCdcAEeq_l4BJLVUF2Q"
    previousVersion="_bf9SEW2PEei3KuUgpx7Xcw"
    name="BillingStatementGroup"
    definition="Group of bank services billing statements with the same sender and receiver characteristics."
    registrationStatus="Provisionally Registered"
    minOccurs="1"
    xmlTag="BllgStmtGrp"
    complexType="_cI-GsdcZEeqRFcf2R4bPBw" />
  <messageDefinitionIdentifier
    businessArea="camt"
    messageFunctionality="086"
    flavour="001"
    version="04" />
</messageDefinition>

ISO Building Blocks

The following items are used as building blocks to construct this message.