AccountOpeningAdditionalInformationRequestV01

acmt.009.001.01

Scope The AccountOpeningAdditionalInformationRequest message is sent from a financial institution to an organisation as part of the account opening process. This message is sent in response to an opening request message from the organisation, if the business content is valid, but additional information is required. Usage This message should only be sent if additional information is required as part of the account opening process.

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
%% AccountOpeningAdditionalInformationRequestV01 recursion level 0 with max 0
AccountOpeningAdditionalInformationRequestV01 *-- "1..1" References3 : References
AccountOpeningAdditionalInformationRequestV01 *-- "1..1" OrganisationIdentification6 : OrganisationIdentification
AccountOpeningAdditionalInformationRequestV01 *-- "1..1" CustomerAccount1 : Account
AccountOpeningAdditionalInformationRequestV01 *-- "1..1" BranchAndFinancialInstitutionIdentification4 : AccountServicerIdentification
AccountOpeningAdditionalInformationRequestV01 *-- "0..1" ContractDocument1 : UnderlyingMasterAgreement
AccountOpeningAdditionalInformationRequestV01 *-- "0..1" PartyAndSignature1 : DigitalSignature
  

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

OrganisationIdentification building block

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

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

OrganisationIdentification6 members

Account building block

Unique and unambiguous identification of the account between the account owner and the account servicer. Account owned by a customer. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% CustomerAccount1 recursion level 0 with max 1
class CustomerAccount1{
    Name IsoMax70Text
    Status AccountStatus3Code
    Currency ActiveCurrencyCode
    MonthlyPaymentValue IsoImpliedCurrencyAndAmount
    MonthlyReceivedValue IsoImpliedCurrencyAndAmount
    MonthlyTransactionNumber IsoMax5NumericText
    AverageBalance IsoImpliedCurrencyAndAmount
    AccountPurpose IsoMax140Text
    FloorNotificationAmount IsoImpliedCurrencyAndAmount
    CeilingNotificationAmount IsoImpliedCurrencyAndAmount
    StatementCycle Frequency3Code
    ClosingDate IsoISODate
}
CustomerAccount1 *-- "1..1" IAccountIdentification4Choice : Identification
CustomerAccount1 *-- "0..1" CashAccountType2 : Type
CustomerAccount1 *-- "0..0" Restriction1 : Restriction
%% IAccountIdentification4Choice recursion level 1 with max 1
%% CashAccountType2 recursion level 1 with max 1
class CashAccountType2{
    Code CashAccountType4Code
    Proprietary IsoMax35Text
}
%% Restriction1 recursion level 1 with max 1
class Restriction1{
    ValidFrom IsoISODateTime
    ValidUntil IsoISODateTime
}
Restriction1 *-- "1..1" ICodeOrProprietary1Choice : RestrictionType
  

CustomerAccount1 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
%% BranchAndFinancialInstitutionIdentification4 recursion level 0 with max 1
BranchAndFinancialInstitutionIdentification4 *-- "1..1" FinancialInstitutionIdentification7 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification4 *-- "0..1" BranchData2 : BranchIdentification
%% FinancialInstitutionIdentification7 recursion level 1 with max 1
class FinancialInstitutionIdentification7{
    BIC IsoBICIdentifier
    Name IsoMax140Text
}
FinancialInstitutionIdentification7 *-- "0..1" ClearingSystemMemberIdentification2 : ClearingSystemMemberIdentification
FinancialInstitutionIdentification7 *-- "0..1" PostalAddress6 : PostalAddress
FinancialInstitutionIdentification7 *-- "0..1" GenericFinancialIdentification1 : Other
%% BranchData2 recursion level 1 with max 1
class BranchData2{
    Identification IsoMax35Text
    Name IsoMax140Text
}
BranchData2 *-- "0..1" PostalAddress6 : PostalAddress
  

BranchAndFinancialInstitutionIdentification4 members

UnderlyingMasterAgreement building block

Account contract established between the organisation or the Group to which the organisation belongs, and the account Servicer. This contract has to be applied for the new account to be opened and maintained. Document that contains the information of the contract agreed between both parties. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ContractDocument1 recursion level 0 with max 1
class ContractDocument1{
    Reference IsoMax35Text
    SignOffDate IsoISODate
    Version IsoMax6Text
}
  

ContractDocument1 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
%% PartyAndSignature1 recursion level 0 with max 1
PartyAndSignature1 *-- "1..1" PartyIdentification41 : Party
PartyAndSignature1 *-- "1..1" ProprietaryData3 : Signature
%% PartyIdentification41 recursion level 1 with max 1
class PartyIdentification41{
    Name IsoMax140Text
    CountryOfResidence CountryCode
}
PartyIdentification41 *-- "0..1" PostalAddress6 : PostalAddress
PartyIdentification41 *-- "0..1" IParty8Choice : Identification
PartyIdentification41 *-- "0..1" ContactDetails2 : ContactDetails
%% ProprietaryData3 recursion level 1 with max 1
ProprietaryData3 *-- "1..1" SkipProcessing : Any
  

PartyAndSignature1 members

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    AccountOpeningAdditionalInformationRequestV01 --|> IOuterRecord : Implements
    AccountOpeningAdditionalInformationRequestV01Document --|> IOuterDocument~AccountOpeningAdditionalInformationRequestV01~ : Implements
    class IOuterDocument~AccountOpeningAdditionalInformationRequestV01~ {
        AccountOpeningAdditionalInformationRequestV01 Message
     }
  

Document wrapper for serialization

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

classDiagram
    AccountOpeningAdditionalInformationRequestV01Document *-- AccountOpeningAdditionalInformationRequestV01 : 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.009.001.01">
    <AcctOpngAddtlInfReq>
        <Refs>
            <!-- References inner content -->
        </Refs>
        <OrgId>
            <!-- OrganisationIdentification inner content -->
        </OrgId>
        <Acct>
            <!-- Account inner content -->
        </Acct>
        <AcctSvcrId>
            <!-- AccountServicerIdentification inner content -->
        </AcctSvcrId>
        <UndrlygMstrAgrmt>
            <!-- UnderlyingMasterAgreement inner content -->
        </UndrlygMstrAgrmt>
        <DgtlSgntr>
            <!-- DigitalSignature inner content -->
        </DgtlSgntr>
    </AcctOpngAddtlInfReq>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_s7Y_yNE9Ed-BzquC8wXy7w_1867153324"
  nextVersions="_ZzIbwQ1TEeKGXqvMN6jpiw"
  name="AccountOpeningAdditionalInformationRequestV01"
  definition="Scope&#xD;&#xA;The AccountOpeningAdditionalInformationRequest message is sent from a financial institution to an organisation as part of the account opening process. This message is sent in response to an opening request message from the organisation, if the business content is valid, but additional information is required.&#xD;&#xA;Usage&#xD;&#xA;This message should only be sent if additional information is required as part of the account opening process."
  registrationStatus="Registered"
  messageSet="_urpIICeJEeOCeO5e7islRQ"
  xmlTag="AcctOpngAddtlInfReq"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_s7Y_ydE9Ed-BzquC8wXy7w_1765185822"
    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="_s7iwwNE9Ed-BzquC8wXy7w_-2055295141"
    name="OrganisationIdentification"
    definition="Identification of the organisation."
    registrationStatus="Provisionally Registered"
    minOccurs="1"
    xmlTag="OrgId"
    complexType="_QPrYxtp-Ed-ak6NoX_4Aeg_434657677" />
  <messageBuildingBlock
    xmi:id="_s7iwwdE9Ed-BzquC8wXy7w_336169512"
    name="Account"
    definition="Unique and unambiguous identification of the account between the account owner and the account servicer."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="Acct"
    complexType="_SN5Y99p-Ed-ak6NoX_4Aeg_-1328700496" />
  <messageBuildingBlock
    xmi:id="_s7iwwtE9Ed-BzquC8wXy7w_-911179757"
    name="AccountServicerIdentification"
    definition="Unique and unambiguous identifier of a financial institution, as assigned under an internationally recognised or proprietary identification scheme."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AcctSvcrId"
    complexType="_TFB1RNp-Ed-ak6NoX_4Aeg_-736060150" />
  <messageBuildingBlock
    xmi:id="_s7iww9E9Ed-BzquC8wXy7w_-792726722"
    name="UnderlyingMasterAgreement"
    definition="Account contract established between the organisation or the Group to which the organisation belongs, and the account Servicer. This contract has to be applied for the new account to be opened and maintained."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="UndrlygMstrAgrmt"
    complexType="_UkjHQtp-Ed-ak6NoX_4Aeg_15886237" />
  <messageBuildingBlock
    xmi:id="_s7iwxNE9Ed-BzquC8wXy7w_369890722"
    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="_PW59tdp-Ed-ak6NoX_4Aeg_-515475026" />
  <messageDefinitionIdentifier
    businessArea="acmt"
    messageFunctionality="009"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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