AccountClosingAdditionalInformationRequestV02

acmt.021.001.02

The AccountClosingAdditionalInformationRequest message is sent from a financial institution to an organisation as part of the account closing process. This message is sent in response to a closing request message from the organisation, if the business content is valid, but additional information is required.

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
%% AccountClosingAdditionalInformationRequestV02 recursion level 0 with max 0
AccountClosingAdditionalInformationRequestV02 *-- "1..1" References3 : References
AccountClosingAdditionalInformationRequestV02 *-- "0..1" OrganisationIdentification8 : From
AccountClosingAdditionalInformationRequestV02 *-- "1..1" OrganisationIdentification8 : OrganisationIdentification
AccountClosingAdditionalInformationRequestV02 *-- "1..1" AccountForAction1 : AccountIdentification
AccountClosingAdditionalInformationRequestV02 *-- "1..1" BranchAndFinancialInstitutionIdentification5 : AccountServicerIdentification
AccountClosingAdditionalInformationRequestV02 *-- "0..1" AccountForAction1 : BalanceTransferAccount
AccountClosingAdditionalInformationRequestV02 *-- "0..1" BranchAndFinancialInstitutionIdentification5 : TransferAccountServicerIdentification
AccountClosingAdditionalInformationRequestV02 *-- "0..1" PartyAndSignature2 : DigitalSignature
AccountClosingAdditionalInformationRequestV02 *-- "0..1" SupplementaryData1 : SupplementaryData
  

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

References building block

Set of elements for the identification of the message and related references. Set of elements for the identification of the message and related references. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% References3 recursion level 0 with max 1
class References3{
    RequestReason IsoMax35Text
    AttachedDocumentName IsoMax70Text
}
References3 *-- "1..1" MessageIdentification1 : MessageIdentification
References3 *-- "1..1" MessageIdentification1 : RequestToBeCompletedIdentification
References3 *-- "1..1" MessageIdentification1 : ProcessIdentification
%% MessageIdentification1 recursion level 1 with max 1
class MessageIdentification1{
    Identification IsoMax35Text
    CreationDateTime IsoISODateTime
}
%% MessageIdentification1 recursion level 1 with max 1
class MessageIdentification1{
    Identification IsoMax35Text
    CreationDateTime IsoISODateTime
}
%% MessageIdentification1 recursion level 1 with max 1
class MessageIdentification1{
    Identification IsoMax35Text
    CreationDateTime IsoISODateTime
}
  

References3 members

From building block

Identifies the business sender of the message, if it is not the account owner or account servicing financial institution. Unique and unambiguous way to identify an organisation. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% OrganisationIdentification8 recursion level 0 with max 1
class OrganisationIdentification8{
    AnyBIC IsoAnyBICIdentifier
}
OrganisationIdentification8 *-- "0..0" GenericOrganisationIdentification1 : Other
%% GenericOrganisationIdentification1 recursion level 1 with max 1
class GenericOrganisationIdentification1{
    Identification IsoMax35Text
    Issuer IsoMax35Text
}
GenericOrganisationIdentification1 *-- "0..1" IOrganisationIdentificationSchemeName1Choice : SchemeName
  

OrganisationIdentification8 members

OrganisationIdentification building block

Identifier for an organisation. Unique and unambiguous way to identify an organisation. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% OrganisationIdentification8 recursion level 0 with max 1
class OrganisationIdentification8{
    AnyBIC IsoAnyBICIdentifier
}
OrganisationIdentification8 *-- "0..0" GenericOrganisationIdentification1 : Other
%% GenericOrganisationIdentification1 recursion level 1 with max 1
class GenericOrganisationIdentification1{
    Identification IsoMax35Text
    Issuer IsoMax35Text
}
GenericOrganisationIdentification1 *-- "0..1" IOrganisationIdentificationSchemeName1Choice : SchemeName
  

OrganisationIdentification8 members

AccountIdentification building block

Unique and unambiguous identification of the account between the account owner and the account servicer. Account to or from which a cash entry is made. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AccountForAction1 recursion level 0 with max 1
class AccountForAction1{
    Currency ActiveCurrencyCode
}
AccountForAction1 *-- "1..1" IAccountIdentification4Choice : Identification
%% IAccountIdentification4Choice recursion level 1 with max 1
  

AccountForAction1 members

AccountServicerIdentification building block

Unique and unambiguous identifier of a financial institution, as assigned under an internationally recognised or proprietary identification scheme. . Set of elements used to uniquely and unambiguously identify a financial institution or a branch of a financial institution. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% BranchAndFinancialInstitutionIdentification5 recursion level 0 with max 1
BranchAndFinancialInstitutionIdentification5 *-- "1..1" FinancialInstitutionIdentification8 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification5 *-- "0..1" BranchData2 : BranchIdentification
%% FinancialInstitutionIdentification8 recursion level 1 with max 1
class FinancialInstitutionIdentification8{
    BICFI IsoBICFIIdentifier
    Name IsoMax140Text
}
FinancialInstitutionIdentification8 *-- "0..1" ClearingSystemMemberIdentification2 : ClearingSystemMemberIdentification
FinancialInstitutionIdentification8 *-- "0..1" PostalAddress6 : PostalAddress
FinancialInstitutionIdentification8 *-- "0..1" GenericFinancialIdentification1 : Other
%% BranchData2 recursion level 1 with max 1
class BranchData2{
    Identification IsoMax35Text
    Name IsoMax140Text
}
BranchData2 *-- "0..1" PostalAddress6 : PostalAddress
  

BranchAndFinancialInstitutionIdentification5 members

BalanceTransferAccount building block

Identification of the account to which the remaining positive balance of the account to be closed must be transferred or account from which funds can be moved to the account to be closed and which balance is negative. This account must be held in the same financial institution as the account to be closed if the transfer account is used to compensate a negative balance. For a positive balance to be transferred, an account in another financial institution might be used. In that case the account servicer is mandatory. Account to or from which a cash entry is made. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AccountForAction1 recursion level 0 with max 1
class AccountForAction1{
    Currency ActiveCurrencyCode
}
AccountForAction1 *-- "1..1" IAccountIdentification4Choice : Identification
%% IAccountIdentification4Choice recursion level 1 with max 1
  

AccountForAction1 members

TransferAccountServicerIdentification building block

Unique and unambiguous identifier of a financial institution, as assigned under an internationally recognised or proprietary identification scheme, that is the servicer of the transfer account. Set of elements used to uniquely and unambiguously identify a financial institution or a branch of a financial institution. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% BranchAndFinancialInstitutionIdentification5 recursion level 0 with max 1
BranchAndFinancialInstitutionIdentification5 *-- "1..1" FinancialInstitutionIdentification8 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification5 *-- "0..1" BranchData2 : BranchIdentification
%% FinancialInstitutionIdentification8 recursion level 1 with max 1
class FinancialInstitutionIdentification8{
    BICFI IsoBICFIIdentifier
    Name IsoMax140Text
}
FinancialInstitutionIdentification8 *-- "0..1" ClearingSystemMemberIdentification2 : ClearingSystemMemberIdentification
FinancialInstitutionIdentification8 *-- "0..1" PostalAddress6 : PostalAddress
FinancialInstitutionIdentification8 *-- "0..1" GenericFinancialIdentification1 : Other
%% BranchData2 recursion level 1 with max 1
class BranchData2{
    Identification IsoMax35Text
    Name IsoMax140Text
}
BranchData2 *-- "0..1" PostalAddress6 : PostalAddress
  

BranchAndFinancialInstitutionIdentification5 members

DigitalSignature building block

Contains the signature with its components, namely signed info, signature value, key info and the object. Entity involved in an activity. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% PartyAndSignature2 recursion level 0 with max 1
PartyAndSignature2 *-- "1..1" PartyIdentification43 : Party
PartyAndSignature2 *-- "1..1" ProprietaryData3 : Signature
%% PartyIdentification43 recursion level 1 with max 1
class PartyIdentification43{
    Name IsoMax140Text
    CountryOfResidence CountryCode
}
PartyIdentification43 *-- "0..1" PostalAddress6 : PostalAddress
PartyIdentification43 *-- "0..1" IParty11Choice : Identification
PartyIdentification43 *-- "0..1" ContactDetails2 : ContactDetails
%% ProprietaryData3 recursion level 1 with max 1
ProprietaryData3 *-- "1..1" SkipProcessing : Any
  

PartyAndSignature2 members

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

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    AccountClosingAdditionalInformationRequestV02 --|> IOuterRecord : Implements
    AccountClosingAdditionalInformationRequestV02Document --|> IOuterDocument~AccountClosingAdditionalInformationRequestV02~ : Implements
    class IOuterDocument~AccountClosingAdditionalInformationRequestV02~ {
        AccountClosingAdditionalInformationRequestV02 Message
     }
  

Document wrapper for serialization

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

classDiagram
    AccountClosingAdditionalInformationRequestV02Document *-- AccountClosingAdditionalInformationRequestV02 : 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.021.001.02">
    <AcctClsgAddtlInfReq>
        <Refs>
            <!-- References inner content -->
        </Refs>
        <Fr>
            <!-- From inner content -->
        </Fr>
        <OrgId>
            <!-- OrganisationIdentification inner content -->
        </OrgId>
        <AcctId>
            <!-- AccountIdentification inner content -->
        </AcctId>
        <AcctSvcrId>
            <!-- AccountServicerIdentification inner content -->
        </AcctSvcrId>
        <BalTrfAcct>
            <!-- BalanceTransferAccount inner content -->
        </BalTrfAcct>
        <TrfAcctSvcrId>
            <!-- TransferAccountServicerIdentification inner content -->
        </TrfAcctSvcrId>
        <DgtlSgntr>
            <!-- DigitalSignature inner content -->
        </DgtlSgntr>
        <SplmtryData>
            <!-- SupplementaryData inner content -->
        </SplmtryData>
    </AcctClsgAddtlInfReq>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_QvJSwQ1TEeKGXqvMN6jpiw"
  nextVersions="_bf9RX22PEei3KuUgpx7Xcw"
  previousVersion="_nIplFtE9Ed-BzquC8wXy7w_877834733"
  name="AccountClosingAdditionalInformationRequestV02"
  definition="The AccountClosingAdditionalInformationRequest message is sent from a financial institution to an organisation as part of the account closing process. This message is sent in response to a closing request message from the organisation, if the business content is valid, but additional information is required."
  registrationStatus="Registered"
  messageSet="_Q3UKwL0wEeKGooZDzppDJQ"
  xmlTag="AcctClsgAddtlInfReq"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_QvJSww1TEeKGXqvMN6jpiw"
    nextVersions="_bf9RYW2PEei3KuUgpx7Xcw"
    name="References"
    definition="Set of elements for the identification of the message and related references."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="Refs"
    complexType="_QoHt8tp-Ed-ak6NoX_4Aeg_1839218221" />
  <messageBuildingBlock
    xmi:id="_g4JZ0A1XEeKGXqvMN6jpiw"
    nextVersions="_bf9RY22PEei3KuUgpx7Xcw"
    name="From"
    definition="Identifies the business sender of the message, if it is not the account owner or account servicing financial institution."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="Fr"
    complexType="_QPiO1Np-Ed-ak6NoX_4Aeg_1971114098" />
  <messageBuildingBlock
    xmi:id="_QvJSxw1TEeKGXqvMN6jpiw"
    nextVersions="_bf9RZW2PEei3KuUgpx7Xcw"
    name="OrganisationIdentification"
    definition="Identifier for an organisation."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="OrgId"
    complexType="_QPiO1Np-Ed-ak6NoX_4Aeg_1971114098" />
  <messageBuildingBlock
    xmi:id="_QvJSyw1TEeKGXqvMN6jpiw"
    nextVersions="_bf9RZ22PEei3KuUgpx7Xcw"
    name="AccountIdentification"
    definition="Unique and unambiguous identification of the account between the account owner and the account servicer."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AcctId"
    complexType="_SN5Y9Np-Ed-ak6NoX_4Aeg_1820239688" />
  <messageBuildingBlock
    xmi:id="_QvJSzw1TEeKGXqvMN6jpiw"
    nextVersions="_bf9RaW2PEei3KuUgpx7Xcw"
    name="AccountServicerIdentification"
    definition="Unique and unambiguous identifier of a financial institution, as assigned under an internationally recognised or proprietary identification scheme. &#xA;."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AcctSvcrId"
    complexType="_TFB1Qdp-Ed-ak6NoX_4Aeg_1367253312" />
  <messageBuildingBlock
    xmi:id="_QvJS0w1TEeKGXqvMN6jpiw"
    nextVersions="_bf9Ra22PEei3KuUgpx7Xcw"
    name="BalanceTransferAccount"
    definition="Identification of the account to which the remaining positive balance of the account to be closed must be transferred or account from which funds can be moved to the account to be closed and which balance is negative. This account must be held in the same financial institution as the account to be closed if the transfer account is used to compensate a negative balance. For a positive balance to be transferred, an account in another financial institution might be used. In that case the account servicer is mandatory."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="BalTrfAcct"
    complexType="_SN5Y9Np-Ed-ak6NoX_4Aeg_1820239688" />
  <messageBuildingBlock
    xmi:id="_QvJS1w1TEeKGXqvMN6jpiw"
    nextVersions="_bf9RbW2PEei3KuUgpx7Xcw"
    name="TransferAccountServicerIdentification"
    definition="Unique and unambiguous identifier of a financial institution, as assigned under an internationally recognised or proprietary identification scheme, that is the servicer of the transfer account."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="TrfAcctSvcrId"
    complexType="_TFB1Qdp-Ed-ak6NoX_4Aeg_1367253312" />
  <messageBuildingBlock
    xmi:id="_QvJS2w1TEeKGXqvMN6jpiw"
    nextVersions="_bf9Rb22PEei3KuUgpx7Xcw"
    name="DigitalSignature"
    definition="Contains the signature with its components, namely signed info, signature value, key info and the object."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="DgtlSgntr"
    complexType="_k4nFNZKuEeGnRMFvqYmPBQ" />
  <messageBuildingBlock
    xmi:id="_6aME4A4AEeKGXqvMN6jpiw"
    nextVersions="_bf9RcW2PEei3KuUgpx7Xcw"
    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="021"
    flavour="001"
    version="02" />
</messageDefinition>

ISO Building Blocks

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