acmt.027.001.02
The AccountSwitchInformationRequest message is sent by the new account servicer to the account servicer which previously held the account to initiate the account switch process. It provides information sufficient for the old account servicer to identify the old account and validate the account parties. The new account servicer is able to inform the old bank of the maximum funding the new account will provide to settle a negative closing balance and the proposed balance transfer window.
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
%% AccountSwitchInformationRequestV02 recursion level 0 with max 0
AccountSwitchInformationRequestV02 *-- "1..1" MessageIdentification1 : MessageIdentification
AccountSwitchInformationRequestV02 *-- "1..1" AccountSwitchDetails1 : AccountSwitchDetails
AccountSwitchInformationRequestV02 *-- "1..1" NewAccount2 : NewAccount
AccountSwitchInformationRequestV02 *-- "1..1" CashAccount39 : OldAccount
AccountSwitchInformationRequestV02 *-- "0..1" BalanceTransfer2 : BalanceTransfer
AccountSwitchInformationRequestV02 *-- "0..1" SupplementaryData1 : SupplementaryData
Now, we will zero-in one-by-one on each of these building blocks.
MessageIdentification building block
Unique identification for the message. Identifies a message by a unique identifier and the date and time when the message was created by the sender. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% MessageIdentification1 recursion level 0 with max 1
class MessageIdentification1{
Identification IsoMax35Text
CreationDateTime IsoISODateTime
}
MessageIdentification1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Identification of the message. | IsoMax35Text - Required 1..1 |
| CreationDateTime | Date of creation of the message. | IsoISODateTime - Required 1..1 |
AccountSwitchDetails building block
Contains information about the details of the account switch. Details of the account switch, including its status and any response codes. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% AccountSwitchDetails1 recursion level 0 with max 1
class AccountSwitchDetails1{
UniqueReferenceNumber IsoMax35Text
RoutingUniqueReferenceNumber IsoMax35Text
SwitchReceivedDateTime IsoISODateTime
SwitchDate IsoISODate
SwitchType SwitchType1Code
SwitchStatus SwitchStatus1Code
BalanceTransferWindow BalanceTransferWindow1Code
}
AccountSwitchDetails1 *-- "0..0" ResponseDetails1 : Response
%% ResponseDetails1 recursion level 1 with max 1
class ResponseDetails1{
ResponseCode IsoMax35Text
AdditionalDetails IsoMax350Text
}
AccountSwitchDetails1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| UniqueReferenceNumber | Unique number that provides unique and unambiguous identification of the account switch. | IsoMax35Text - Required 1..1 |
| RoutingUniqueReferenceNumber | Unique number that provides unique and unambiguous identification of the account switch. Usage: Where one or more account switches have taken place since the original account switch this field contains the unique number that relates to the switch that transferred the account to the latest new account servicer. | IsoMax35Text - Required 1..1 |
| SwitchReceivedDateTime | Date and time that the request was received by the central switch service, populated by the central switch service only. | IsoISODateTime - Optional 0..1 |
| SwitchDate | Date on which the account switch is expected to have completed. The value is the same as the targeted switch date if the switch completes in the expected timeline. | IsoISODate - Optional 0..1 |
| SwitchType | Indicates whether the account switch is a full switch or a partial switch. Usage: A full switch indicates the transfer of the full balance of the account and associated payment mandates. A partial switch indicates the transfer of certain payment mandates to a new account. | SwitchType1Code - Required 1..1 |
| SwitchStatus | State of the account switch at the time the message is sent. | SwitchStatus1Code - Optional 0..1 |
| BalanceTransferWindow | Identifies the processing window in which the balance transfer will be processed on the day of the account switch. | BalanceTransferWindow1Code - Optional 0..1 |
| Response | Response code and additional information. | ResponseDetails1 - Unknown 0..0 |
NewAccount building block
Account servicer holding the account to which the switch will be made. That is, the acquiring account servicer. Information about the new account. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% NewAccount2 recursion level 0 with max 1
NewAccount2 *-- "1..1" CashAccount39 : Account
NewAccount2 *-- "1..0" IndividualPerson36 : AccountParty
NewAccount2 *-- "0..1" Organisation35 : Organisation
%% CashAccount39 recursion level 1 with max 1
class CashAccount39{
Currency ActiveOrHistoricCurrencyCode
Name IsoMax70Text
}
CashAccount39 *-- "1..1" IAccountIdentification4Choice : Identification
CashAccount39 *-- "0..1" ICashAccountType2Choice : Type
CashAccount39 *-- "0..1" ProxyAccountIdentification1 : Proxy
CashAccount39 *-- "0..1" PartyIdentification135 : Owner
CashAccount39 *-- "0..1" BranchAndFinancialInstitutionIdentification6 : Servicer
%% IndividualPerson36 recursion level 1 with max 1
class IndividualPerson36{
Gender Gender1Code
Language LanguageCode
BirthDate IsoISODate
CountryOfBirth CountryCode
ProvinceOfBirth IsoMax35Text
CityOfBirth IsoMax35Text
TaxationCountry CountryCode
SocialSecurityNumber IsoMax35Text
}
IndividualPerson36 *-- "1..1" IndividualPersonNameLong2 : CurrentName
IndividualPerson36 *-- "0..0" IndividualPersonNameLong2 : PreviousName
IndividualPerson36 *-- "0..1" CountryAndResidentialStatusType1 : CountryAndResidentialStatus
IndividualPerson36 *-- "0..0" PostalAddress24 : PostalAddress
IndividualPerson36 *-- "0..0" CitizenshipInformation1 : CitizenshipInformation
IndividualPerson36 *-- "0..1" CommunicationAddress3 : PrimaryCommunicationAddress
IndividualPerson36 *-- "0..1" CommunicationAddress3 : SecondaryCommunicationAddress
IndividualPerson36 *-- "0..0" GenericIdentification44 : OtherIdentification
IndividualPerson36 *-- "0..0" TransferInstruction1 : OtherDetails
%% Organisation35 recursion level 1 with max 1
class Organisation35{
FullLegalName IsoMax350Text
TradingName IsoMax350Text
OrganisationLegalStatus OrganisationLegalStatus1Code
EstablishedDate IsoISODate
RegistrationNumber IsoMax70Text
RegistrationCountry CountryCode
RegistrationDate IsoISODate
TaxationIdentificationNumber IsoMax35Text
TaxationCountry CountryCode
CountryOfOperation CountryCode
BoardResolutionIndicator IsoTrueFalseIndicator
}
Organisation35 *-- "0..1" PostalAddress24 : BusinessAddress
Organisation35 *-- "0..1" PostalAddress24 : OperationalAddress
Organisation35 *-- "0..1" PostalAddress24 : LegalAddress
Organisation35 *-- "0..0" PartyIdentification135 : RepresentativeOfficer
Organisation35 *-- "0..1" PartyIdentification135 : TreasuryManager
Organisation35 *-- "0..0" PartyIdentification135 : MainMandateHolder
Organisation35 *-- "0..0" PartyIdentification135 : Sender
NewAccount2 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Account | Details of the new account. | CashAccount39 - Required 1..1 |
| AccountParty | Party or parties to be identified in the context of account operations. | IndividualPerson36 - Unknown 1..0 |
| Organisation | Organised structure that is set up for a particular purpose, for example, a business, government body, department, charity, or financial institution. | Organisation35 - Optional 0..1 |
OldAccount building block
Account held at the old account servicer being switched to the new account servicer. Provides the details to identify an account. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% CashAccount39 recursion level 0 with max 1
class CashAccount39{
Currency ActiveOrHistoricCurrencyCode
Name IsoMax70Text
}
CashAccount39 *-- "1..1" IAccountIdentification4Choice : Identification
CashAccount39 *-- "0..1" ICashAccountType2Choice : Type
CashAccount39 *-- "0..1" ProxyAccountIdentification1 : Proxy
CashAccount39 *-- "0..1" PartyIdentification135 : Owner
CashAccount39 *-- "0..1" BranchAndFinancialInstitutionIdentification6 : Servicer
%% 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
%% PartyIdentification135 recursion level 1 with max 1
class PartyIdentification135{
Name IsoMax140Text
CountryOfResidence CountryCode
}
PartyIdentification135 *-- "0..1" PostalAddress24 : PostalAddress
PartyIdentification135 *-- "0..1" IParty38Choice : Identification
PartyIdentification135 *-- "0..1" Contact4 : ContactDetails
%% BranchAndFinancialInstitutionIdentification6 recursion level 1 with max 1
BranchAndFinancialInstitutionIdentification6 *-- "1..1" FinancialInstitutionIdentification18 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification6 *-- "0..1" BranchData3 : BranchIdentification
CashAccount39 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. | ActiveOrHistoricCurrencyCode - Optional 0..1 |
| 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 |
| Owner | Party that legally owns the account. | PartyIdentification135 - Optional 0..1 |
| Servicer | Party that manages the 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. | BranchAndFinancialInstitutionIdentification6 - Optional 0..1 |
BalanceTransfer building block
Information that enables the receiving account servicer to reconcile the payment with the request. Information that enables any payments made in connection with the fulfilment of an account switch to be reconciled by the relevant account servicer with the associated request. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% BalanceTransfer2 recursion level 0 with max 1
BalanceTransfer2 *-- "0..1" BalanceTransferReference1 : BalanceTransferReference
BalanceTransfer2 *-- "0..1" ISettlementMethod2Choice : BalanceTransferMethod
BalanceTransfer2 *-- "0..1" BalanceTransferFundingLimit1 : BalanceTransferFundingLimit
%% BalanceTransferReference1 recursion level 1 with max 1
class BalanceTransferReference1{
BalanceTransferReference IsoMax35Text
}
%% ISettlementMethod2Choice recursion level 1 with max 1
%% BalanceTransferFundingLimit1 recursion level 1 with max 1
class BalanceTransferFundingLimit1{
CurrencyAmount IsoActiveCurrencyAndAmount
}
BalanceTransfer2 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| BalanceTransferReference | Reference that enables the creditor to reconcile a payment received through a different payment channel with the payment request. | BalanceTransferReference1 - Optional 0..1 |
| BalanceTransferMethod | Contains details of the clearance and settlement method chosen to make the appropriate payment from account servicer to account servicer in order to transfer the positive or negative closing balance of the old account to the new account. | ISettlementMethod2Choice - Optional 0..1 |
| BalanceTransferFundingLimit | Maximum value that the new account servicer will pay to the old account servicer when the closing balance on the old account is negative. | BalanceTransferFundingLimit1 - 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 AccountSwitchInformationRequestV02 implementation follows a specific implementaiton pattern. First of all, AccountSwitchInformationRequestV02 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, AccountSwitchInformationRequestV02Document implements IOuterDocument. Because AccountSwitchInformationRequestV02 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type AccountSwitchInformationRequestV02.
classDiagram
class IOuterRecord
AccountSwitchInformationRequestV02 --|> IOuterRecord : Implements
AccountSwitchInformationRequestV02Document --|> IOuterDocument~AccountSwitchInformationRequestV02~ : Implements
class IOuterDocument~AccountSwitchInformationRequestV02~ {
AccountSwitchInformationRequestV02 Message
}
Document wrapper for serialization
The only real purpose AccountSwitchInformationRequestV02Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:acmt.027.001.02’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using AccountSwitchInformationRequestV02.ToDocument() method. The returned AccountSwitchInformationRequestV02Document value will serialize correctly according to ISO 20022 standards.
classDiagram
AccountSwitchInformationRequestV02Document *-- AccountSwitchInformationRequestV02 : 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:acmt.027.001.02">
<AcctSwtchInfReq>
<MsgId>
<!-- MessageIdentification inner content -->
</MsgId>
<AcctSwtchDtls>
<!-- AccountSwitchDetails inner content -->
</AcctSwtchDtls>
<NewAcct>
<!-- NewAccount inner content -->
</NewAcct>
<OdAcct>
<!-- OldAccount inner content -->
</OdAcct>
<BalTrf>
<!-- BalanceTransfer inner content -->
</BalTrf>
<SplmtryData>
<!-- SupplementaryData inner content -->
</SplmtryData>
</AcctSwtchInfReq>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_7HK1jW42EeiU9cctagi5ow"
nextVersions="_LvzYf8P_Eemsic1bQcEtLA"
previousVersion="_Yn9UMhMKEeSTk5fcu7tr9w"
name="AccountSwitchInformationRequestV02"
definition="The AccountSwitchInformationRequest message is sent by the new account servicer to the account servicer which previously held the account to initiate the account switch process. It provides information sufficient for the old account servicer to identify the old account and validate the account parties. The new account servicer is able to inform the old bank of the maximum funding the new account will provide to settle a negative closing balance and the proposed balance transfer window."
registrationStatus="Registered"
messageSet="_urpIICeJEeOCeO5e7islRQ"
xmlTag="AcctSwtchInfReq"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_7HK1j242EeiU9cctagi5ow"
nextVersions="_LvzYgcP_Eemsic1bQcEtLA"
previousVersion="_Q5TMsa5jEee17eDA_q0a9g"
name="MessageIdentification"
definition="Unique identification for the message."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="MsgId"
complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
<messageBuildingBlock
xmi:id="_7HK1kW42EeiU9cctagi5ow"
nextVersions="_LvzYg8P_Eemsic1bQcEtLA"
previousVersion="_SAHDwa5jEee17eDA_q0a9g"
name="AccountSwitchDetails"
definition="Contains information about the details of the account switch."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="AcctSwtchDtls"
complexType="_8m2xcQ2ZEeSNWNtJlXOAhg" />
<messageBuildingBlock
xmi:id="_7HK1k242EeiU9cctagi5ow"
nextVersions="_LvzYhcP_Eemsic1bQcEtLA"
previousVersion="_gBpekBMKEeSTk5fcu7tr9w"
name="NewAccount"
definition="Account servicer holding the account to which the switch will be made. That is, the acquiring account servicer."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="NewAcct"
complexType="_XYiKkW49EeiU9cctagi5ow" />
<messageBuildingBlock
xmi:id="_7HK1lW42EeiU9cctagi5ow"
nextVersions="_LvzYh8P_Eemsic1bQcEtLA"
previousVersion="_i-JE4BMKEeSTk5fcu7tr9w"
name="OldAccount"
definition="Account held at the old account servicer being switched to the new account servicer."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="OdAcct"
complexType="_8t9lYW48EeiU9cctagi5ow" />
<messageBuildingBlock
xmi:id="_7HK1l242EeiU9cctagi5ow"
nextVersions="_LvzYicP_Eemsic1bQcEtLA"
previousVersion="_U55xAA_WEeejZrQVdmNFGg"
name="BalanceTransfer"
definition="Information that enables the receiving account servicer to reconcile the payment with the request."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="BalTrf"
complexType="_6zmxjW48EeiU9cctagi5ow" />
<messageBuildingBlock
xmi:id="_7HK1mW42EeiU9cctagi5ow"
nextVersions="_LvzYi8P_Eemsic1bQcEtLA"
previousVersion="_U91zsA8DEeeJ4ZumUkzG4Q"
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="acmt"
messageFunctionality="027"
flavour="001"
version="02" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.