IntraBalanceMovementConfirmationV01

camt.068.001.01

The IntraBalanceMovementConfirmation message is sent from a settlement infrastructure to an account owner/requestor to confirm the movement of an amount of money within its holdings from one sub-balance to another.

Usage: The message may be used to:

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
%% IntraBalanceMovementConfirmationV01 recursion level 0 with max 0
IntraBalanceMovementConfirmationV01 *-- "0..1" DocumentIdentification51 : Identification
IntraBalanceMovementConfirmationV01 *-- "0..1" AdditionalParameters16 : AdditionalParameters
IntraBalanceMovementConfirmationV01 *-- "1..1" CashAccount38 : CashAccount
IntraBalanceMovementConfirmationV01 *-- "0..1" SystemPartyIdentification8 : CashAccountOwner
IntraBalanceMovementConfirmationV01 *-- "0..1" BranchAndFinancialInstitutionIdentification6 : CashAccountServicer
IntraBalanceMovementConfirmationV01 *-- "1..1" IntraBalance6 : IntraBalance
IntraBalanceMovementConfirmationV01 *-- "0..1" SupplementaryData1 : SupplementaryData
  

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

Identification building block

Unambiguous identification of the message as known by the account servicer or settlement infrastructure. Identification and creation date of a document. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% DocumentIdentification51 recursion level 0 with max 1
class DocumentIdentification51{
    Identification IsoMax35Text
    CopyDuplicate CopyDuplicate1Code
}
DocumentIdentification51 *-- "0..1" IDateAndDateTime2Choice : CreationDateTime
DocumentIdentification51 *-- "0..1" PartyIdentification136 : MessageOriginator
DocumentIdentification51 *-- "0..1" PartyIdentification136 : MessageRecipient
%% IDateAndDateTime2Choice recursion level 1 with max 1
%% PartyIdentification136 recursion level 1 with max 1
class PartyIdentification136{
    LEI IsoLEIIdentifier
}
PartyIdentification136 *-- "1..1" IPartyIdentification120Choice : Identification
%% PartyIdentification136 recursion level 1 with max 1
class PartyIdentification136{
    LEI IsoLEIIdentifier
}
PartyIdentification136 *-- "1..1" IPartyIdentification120Choice : Identification
  

DocumentIdentification51 members

Member name Description Data Type / Multiplicity
Identification Unique identifier of the document (message) assigned by the sender of the document. IsoMax35Text - Required 1..1
CreationDateTime Date and time at which the document (message) was created by the sender. IDateAndDateTime2Choice - Optional 0..1
CopyDuplicate Specifies if this document is a copy, a duplicate, or a duplicate of a copy. CopyDuplicate1Code - Optional 0..1
MessageOriginator Party that originated the message, if other than the sender. PartyIdentification136 - Optional 0..1
MessageRecipient Party that is the final destination of the message, if other than the receiver. PartyIdentification136 - Optional 0..1

AdditionalParameters building block

Additional parameters to the transaction. Specifies additional parameters to the message or transaction. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AdditionalParameters16 recursion level 0 with max 1
class AdditionalParameters16{
    PartialSettlement PartialSettlement2Code
    PreviousPartialConfirmationIdentification IsoMax35Text
    AccountOwnerTransactionIdentification IsoMax35Text
    AccountServicerTransactionIdentification IsoMax35Text
    PoolIdentification IsoMax35Text
    CorporateActionEventIdentification IsoMax35Text
    MarketInfrastructureTransactionIdentification IsoMax35Text
    ProcessorTransactionIdentification IsoMax35Text
}
  

AdditionalParameters16 members

Member name Description Data Type / Multiplicity
PartialSettlement Specifies partial settlement information. PartialSettlement2Code - Optional 0..1
PreviousPartialConfirmationIdentification Identification of the confirmation previously sent to confirm the partial settlement of a transaction. IsoMax35Text - Optional 0..1
AccountOwnerTransactionIdentification Unambiguous identification of the transaction as known by the account owner (or the instructing party managing the account). IsoMax35Text - Optional 0..1
AccountServicerTransactionIdentification Unambiguous identification of the transaction as known by the account servicer. IsoMax35Text - Optional 0..1
PoolIdentification Collective reference identifying a set of messages. IsoMax35Text - Optional 0..1
CorporateActionEventIdentification Identification assigned by the account servicer to unambiguously identify a corporate action event. IsoMax35Text - Optional 0..1
MarketInfrastructureTransactionIdentification Identification of a transaction assigned by a market infrastructure other than a central securities depository, for example, Target2-Securities. IsoMax35Text - Optional 0..1
ProcessorTransactionIdentification Identification of the transaction as assigned by the processor. IsoMax35Text - Optional 0..1

CashAccount building block

Account to or from which an entry is made. Provides the details to identify an account. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% CashAccount38 recursion level 0 with max 1
class CashAccount38{
    Currency ActiveOrHistoricCurrencyCode
    Name IsoMax70Text
}
CashAccount38 *-- "1..1" IAccountIdentification4Choice : Identification
CashAccount38 *-- "0..1" ICashAccountType2Choice : Type
CashAccount38 *-- "0..1" ProxyAccountIdentification1 : Proxy
%% IAccountIdentification4Choice recursion level 1 with max 1
%% ICashAccountType2Choice recursion level 1 with max 1
%% ProxyAccountIdentification1 recursion level 1 with max 1
class ProxyAccountIdentification1{
    Identification IsoMax2048Text
}
ProxyAccountIdentification1 *-- "0..1" IProxyAccountType1Choice : Type
  

CashAccount38 members

Member name Description Data Type / Multiplicity
Identification Unique and unambiguous identification for the account between the account owner and the account servicer. IAccountIdentification4Choice - Required 1..1
Type Specifies the nature, or use of the account. ICashAccountType2Choice - Optional 0..1
Currency Identification of the currency in which the account is held.
Name Name of the account, as assigned by the account servicing institution, in agreement with the account owner in order to provide an additional means of identification of the account.
Proxy Specifies an alternate assumed name for the identification of the account. ProxyAccountIdentification1 - Optional 0..1

CashAccountOwner building block

Party that legally owns the cash account. Unique and unambiguous identification of a party within a system. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SystemPartyIdentification8 recursion level 0 with max 1
SystemPartyIdentification8 *-- "1..1" PartyIdentification136 : Identification
SystemPartyIdentification8 *-- "0..1" PartyIdentification136 : ResponsiblePartyIdentification
%% PartyIdentification136 recursion level 1 with max 1
class PartyIdentification136{
    LEI IsoLEIIdentifier
}
PartyIdentification136 *-- "1..1" IPartyIdentification120Choice : Identification
%% PartyIdentification136 recursion level 1 with max 1
class PartyIdentification136{
    LEI IsoLEIIdentifier
}
PartyIdentification136 *-- "1..1" IPartyIdentification120Choice : Identification
  

SystemPartyIdentification8 members

Member name Description Data Type / Multiplicity
Identification Unique identification to unambiguously identify the party within the system. PartyIdentification136 - Required 1..1
ResponsiblePartyIdentification Unique identification of the party responsible for the maintenance of the party reference data. PartyIdentification136 - Optional 0..1

CashAccountServicer building block

Party that manages the cash account on behalf of the account owner, that is manages the registration and booking of entries on the account, calculates balances on the account and provides information about the account. Unique and unambiguous identification of a financial institution or a branch of a financial institution. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% BranchAndFinancialInstitutionIdentification6 recursion level 0 with max 1
BranchAndFinancialInstitutionIdentification6 *-- "1..1" FinancialInstitutionIdentification18 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification6 *-- "0..1" BranchData3 : BranchIdentification
%% FinancialInstitutionIdentification18 recursion level 1 with max 1
class FinancialInstitutionIdentification18{
    BICFI IsoBICFIDec2014Identifier
    LEI IsoLEIIdentifier
    Name IsoMax140Text
}
FinancialInstitutionIdentification18 *-- "0..1" ClearingSystemMemberIdentification2 : ClearingSystemMemberIdentification
FinancialInstitutionIdentification18 *-- "0..1" PostalAddress24 : PostalAddress
FinancialInstitutionIdentification18 *-- "0..1" GenericFinancialIdentification1 : Other
%% BranchData3 recursion level 1 with max 1
class BranchData3{
    Identification IsoMax35Text
    LEI IsoLEIIdentifier
    Name IsoMax140Text
}
BranchData3 *-- "0..1" PostalAddress24 : PostalAddress
  

BranchAndFinancialInstitutionIdentification6 members

Member name Description Data Type / Multiplicity
FinancialInstitutionIdentification Unique and unambiguous identification of a financial institution, as assigned under an internationally recognised or proprietary identification scheme. FinancialInstitutionIdentification18 - Required 1..1
BranchIdentification Identifies a specific branch of a financial institution.

IntraBalance building block

Intra-balance movement transaction details. Details of the intra-balance movement. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IntraBalance6 recursion level 0 with max 1
class IntraBalance6{
    InstructionProcessingAdditionalDetails IsoMax350Text
}
IntraBalance6 *-- "0..1" IAmount2Choice : SettledAmount
IntraBalance6 *-- "0..1" IAmount2Choice : PreviouslySettledAmount
IntraBalance6 *-- "0..1" IAmount2Choice : RemainingSettlementAmount
IntraBalance6 *-- "1..1" IDateAndDateTime2Choice : SettlementDate
IntraBalance6 *-- "1..1" CashSubBalanceTypeAndQuantityBreakdown3 : BalanceFrom
IntraBalance6 *-- "1..1" CashSubBalanceTypeAndQuantityBreakdown3 : BalanceTo
IntraBalance6 *-- "0..1" GenericIdentification37 : CashSubBalanceIdentification
%% IAmount2Choice recursion level 1 with max 1
%% IAmount2Choice recursion level 1 with max 1
%% IAmount2Choice recursion level 1 with max 1
%% IDateAndDateTime2Choice recursion level 1 with max 1
%% CashSubBalanceTypeAndQuantityBreakdown3 recursion level 1 with max 1
CashSubBalanceTypeAndQuantityBreakdown3 *-- "1..1" ICashBalanceType3Choice : Type
CashSubBalanceTypeAndQuantityBreakdown3 *-- "0..0" AmountAndQuantityBreakdown1 : QuantityBreakdown
%% CashSubBalanceTypeAndQuantityBreakdown3 recursion level 1 with max 1
CashSubBalanceTypeAndQuantityBreakdown3 *-- "1..1" ICashBalanceType3Choice : Type
CashSubBalanceTypeAndQuantityBreakdown3 *-- "0..0" AmountAndQuantityBreakdown1 : QuantityBreakdown
%% GenericIdentification37 recursion level 1 with max 1
class GenericIdentification37{
    Identification IsoMax35Text
    Issuer IsoMax35Text
}
  

IntraBalance6 members

Member name Description Data Type / Multiplicity
SettledAmount Amount of money effectively settled and which will be credited to/debited from the account owner’s cash account. It may differ from the instructed settlement amount based on market tolerance level. IAmount2Choice - Optional 0..1
PreviouslySettledAmount Amount of money previously settled. IAmount2Choice - Optional 0..1
RemainingSettlementAmount Amount of money remaining to be settled. IAmount2Choice - Optional 0..1
SettlementDate Date and time at which the amount of money is moved. IDateAndDateTime2Choice - Required 1..1
BalanceFrom Balance from which the amount of money is moved. CashSubBalanceTypeAndQuantityBreakdown3 - Required 1..1
BalanceTo Balance to which the amount of money is moved. CashSubBalanceTypeAndQuantityBreakdown3 - Required 1..1
CashSubBalanceIdentification Number identifying a lot constituting the sub-balance. GenericIdentification37 - Optional 0..1
InstructionProcessingAdditionalDetails Provides additional settlement processing information which can not be included within the structured fields of the message. IsoMax350Text - Optional 0..1

SupplementaryData building block

Additional information that cannot be captured in the structured elements and/or any other specific block. Additional information that can not be captured in the structured fields and/or any other specific block. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SupplementaryData1 recursion level 0 with max 1
class SupplementaryData1{
    PlaceAndName IsoMax350Text
}
SupplementaryData1 *-- "1..1" IsoSupplementaryDataEnvelope1 : Envelope
%% IsoSupplementaryDataEnvelope1 recursion level 1 with max 1
  

SupplementaryData1 members

Member name Description Data Type / Multiplicity
PlaceAndName Unambiguous reference to the location where the supplementary data must be inserted in the message instance. In the case of XML, this is expressed by a valid XPath. IsoMax350Text - Optional 0..1
Envelope Technical element wrapping the supplementary data. IsoSupplementaryDataEnvelope1 - Required 1..1

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    IntraBalanceMovementConfirmationV01 --|> IOuterRecord : Implements
    IntraBalanceMovementConfirmationV01Document --|> IOuterDocument~IntraBalanceMovementConfirmationV01~ : Implements
    class IOuterDocument~IntraBalanceMovementConfirmationV01~ {
        IntraBalanceMovementConfirmationV01 Message
     }
  

Document wrapper for serialization

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

classDiagram
    IntraBalanceMovementConfirmationV01Document *-- IntraBalanceMovementConfirmationV01 : 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.068.001.01">
    <IntraBalMvmntConf>
        <Id>
            <!-- Identification inner content -->
        </Id>
        <AddtlParams>
            <!-- AdditionalParameters inner content -->
        </AddtlParams>
        <CshAcct>
            <!-- CashAccount inner content -->
        </CshAcct>
        <CshAcctOwnr>
            <!-- CashAccountOwner inner content -->
        </CshAcctOwnr>
        <CshAcctSvcr>
            <!-- CashAccountServicer inner content -->
        </CshAcctSvcr>
        <IntraBal>
            <!-- IntraBalance inner content -->
        </IntraBal>
        <SplmtryData>
            <!-- SupplementaryData inner content -->
        </SplmtryData>
    </IntraBalMvmntConf>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_DLtKozncEem7JZMuWtwtsg"
  name="IntraBalanceMovementConfirmationV01"
  definition="The IntraBalanceMovementConfirmation message is sent from a settlement infrastructure to an account owner/requestor to confirm the movement of an amount of money within its holdings from one sub-balance to another. &#xA;&#xA;Usage: &#xA;The message may be used to: &#xA;- re-send a message previously sent (the sub-function of the message is &quot;Duplicate&quot;)&#xA;- provide a third party with a copy of a message for information (the sub-function of the message is &quot;Copy&quot;)&#xA;- re-send to a third party a copy of a message for information (the sub-function of the message is &quot;CopyDuplicate&quot;)."
  registrationStatus="Registered"
  messageSet="_Fl3iMBHREeqzEaNIFJIN-g"
  xmlTag="IntraBalMvmntConf"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_DLtKqzncEem7JZMuWtwtsg"
    name="Identification"
    definition="Unambiguous identification of the message as known by the account servicer or settlement infrastructure."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="Id"
    complexType="_BsblMTp6EemwKdP955WBJQ" />
  <messageBuildingBlock
    xmi:id="_DLtKrTncEem7JZMuWtwtsg"
    name="AdditionalParameters"
    definition="Additional parameters to the transaction."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="AddtlParams"
    complexType="_jY2uRe5NEeCisYr99QEiWA_-1035594150" />
  <messageBuildingBlock
    xmi:id="_DLtKrzncEem7JZMuWtwtsg"
    name="CashAccount"
    definition="Account to or from which an entry is made."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="CshAcct"
    complexType="_TnJx8Xh1EeidzqjNEfehPg" />
  <messageBuildingBlock
    xmi:id="_CWqjEjp8EemwKdP955WBJQ"
    name="CashAccountOwner"
    definition="Party that legally owns the cash account."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CshAcctOwnr"
    complexType="_7KrUEVhLEeih3fUfzR38Ig" />
  <messageBuildingBlock
    xmi:id="_CWqjEzp8EemwKdP955WBJQ"
    name="CashAccountServicer"
    definition="Party that manages the cash account on behalf of the account owner, that is manages the registration and booking of entries on the account, calculates balances on the account and provides information about the account."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CshAcctSvcr"
    complexType="_8nO10W49EeiU9cctagi5ow" />
  <messageBuildingBlock
    xmi:id="_DLtKsTncEem7JZMuWtwtsg"
    name="IntraBalance"
    definition="Intra-balance movement transaction details."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="IntraBal"
    complexType="_B-PU4TngEem7JZMuWtwtsg" />
  <messageBuildingBlock
    xmi:id="_DLtKszncEem7JZMuWtwtsg"
    name="SupplementaryData"
    definition="Additional information that cannot be captured in the structured elements and/or any other specific block."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="SplmtryData"
    complexType="_Qn0zC9p-Ed-ak6NoX_4Aeg_468227563" />
  <messageDefinitionIdentifier
    businessArea="camt"
    messageFunctionality="068"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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