Iso20022

UndertakingAmendmentAdviceV01

tsrv.006.001.01

The UndertakingAmendmentAdvice message is sent by an advising party to the beneficiary, either directly or via one or more other advising parties in the transaction chain, to advise the content of a proposed amendment to an undertaking. Information about the message may also be sent to other interested parties. The proposed undertaking amendment could be to a demand guarantee, standby letter of credit, or counter-undertaking (counter-guarantee or counter-standby). In addition to providing the terms of the proposed amendment and relevant details on proposed changes to the undertaking, the message may provide information from the sender such as confirmation details. It may also be used to advise the proposed termination or cancellation of the undertaking.

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
%% UndertakingAmendmentAdviceV01 recursion level 0 with max 0
class UndertakingAmendmentAdviceV01{
    DateOfAdvice IsoISODate
    BankToBankInformation IsoMax2000Text
}
UndertakingAmendmentAdviceV01 *-- "1..1" PartyIdentification43 : AdvisingParty
UndertakingAmendmentAdviceV01 *-- "0..1" PartyIdentification43 : SecondAdvisingParty
UndertakingAmendmentAdviceV01 *-- "1..1" Amendment2 : UndertakingAmendmentAdviceDetails
UndertakingAmendmentAdviceV01 *-- "0..1" PartyAndSignature2 : DigitalSignature

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

AdvisingParty building block

Party advising the undertaking to the beneficiary or to another party. Set of elements used to identify a person or an organisation. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% PartyIdentification43 recursion level 0 with max 1
class PartyIdentification43{
    Name IsoMax140Text
    CountryOfResidence CountryCode
}
PartyIdentification43 *-- "0..1" PostalAddress6 : PostalAddress
PartyIdentification43 *-- "0..1" IParty11Choice : Identification
PartyIdentification43 *-- "0..1" ContactDetails2 : ContactDetails
%% PostalAddress6 recursion level 1 with max 1
class PostalAddress6{
    AddressType AddressType2Code
    Department IsoMax70Text
    SubDepartment IsoMax70Text
    StreetName IsoMax70Text
    BuildingNumber IsoMax16Text
    PostCode IsoMax16Text
    TownName IsoMax35Text
    CountrySubDivision IsoMax35Text
    Country CountryCode
    AddressLine IsoMax70Text
}
%% IParty11Choice recursion level 1 with max 1
%% ContactDetails2 recursion level 1 with max 1
class ContactDetails2{
    NamePrefix NamePrefix1Code
    Name IsoMax140Text
    PhoneNumber IsoPhoneNumber
    MobileNumber IsoPhoneNumber
    FaxNumber IsoPhoneNumber
    EmailAddress IsoMax2048Text
    Other IsoMax35Text
}

PartyIdentification43 members

Member name Description Data Type / Multiplicity
Name Name by which a party is known and which is usually used to identify that party. IsoMax140Text - Optional 0..1
PostalAddress Information that locates and identifies a specific address, as defined by postal services. PostalAddress6 - Optional 0..1
Identification Unique and unambiguous identification of a party. IParty11Choice - Optional 0..1
CountryOfResidence Country in which a person resides (the place of a person’s home). In the case of a company, it is the country from which the affairs of that company are directed. CountryCode - Optional 0..1
ContactDetails Set of elements used to indicate how to contact the party. ContactDetails2 - Optional 0..1

SecondAdvisingParty building block

Additional party that advises the undertaking. Set of elements used to identify a person or an organisation. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% PartyIdentification43 recursion level 0 with max 1
class PartyIdentification43{
    Name IsoMax140Text
    CountryOfResidence CountryCode
}
PartyIdentification43 *-- "0..1" PostalAddress6 : PostalAddress
PartyIdentification43 *-- "0..1" IParty11Choice : Identification
PartyIdentification43 *-- "0..1" ContactDetails2 : ContactDetails
%% PostalAddress6 recursion level 1 with max 1
class PostalAddress6{
    AddressType AddressType2Code
    Department IsoMax70Text
    SubDepartment IsoMax70Text
    StreetName IsoMax70Text
    BuildingNumber IsoMax16Text
    PostCode IsoMax16Text
    TownName IsoMax35Text
    CountrySubDivision IsoMax35Text
    Country CountryCode
    AddressLine IsoMax70Text
}
%% IParty11Choice recursion level 1 with max 1
%% ContactDetails2 recursion level 1 with max 1
class ContactDetails2{
    NamePrefix NamePrefix1Code
    Name IsoMax140Text
    PhoneNumber IsoPhoneNumber
    MobileNumber IsoPhoneNumber
    FaxNumber IsoPhoneNumber
    EmailAddress IsoMax2048Text
    Other IsoMax35Text
}

PartyIdentification43 members

Member name Description Data Type / Multiplicity
Name Name by which a party is known and which is usually used to identify that party. IsoMax140Text - Optional 0..1
PostalAddress Information that locates and identifies a specific address, as defined by postal services. PostalAddress6 - Optional 0..1
Identification Unique and unambiguous identification of a party. IParty11Choice - Optional 0..1
CountryOfResidence Country in which a person resides (the place of a person’s home). In the case of a company, it is the country from which the affairs of that company are directed. CountryCode - Optional 0..1
ContactDetails Set of elements used to indicate how to contact the party. ContactDetails2 - Optional 0..1

DateOfAdvice building block

Date on which the undertaking is advised. A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format. This representation is defined in “XML Schema Part 2: Datatypes Second Edition - W3C Recommendation 28 October 2004” which is aligned with ISO 8601. For comparison, see the ISO20022 official specification This message is declared as ISODate in the ISO specification. In our implementation, it is represented in source code as IsoISODate. Due to global using directives, it is treated as a System.DateOnly by the compiler and runtime.

UndertakingAmendmentAdviceDetails building block

Details related to the advice of the proposed amended undertaking. Details of the amendment. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Amendment2 recursion level 0 with max 1
Amendment2 *-- "1..1" UndertakingAmendmentMessage1 : UndertakingAmendmentMessage
Amendment2 *-- "0..1" AdvisingPartyAdditionalInformation1 : FirstAdvisingPartyAdditionalInformation
Amendment2 *-- "0..1" AdvisingPartyAdditionalInformation1 : SecondAdvisingPartyAdditionalInformation
Amendment2 *-- "0..1" UndertakingConfirmation1 : ConfirmationDetails
Amendment2 *-- "0..3" PartyAndSignature2 : DigitalSignature
%% UndertakingAmendmentMessage1 recursion level 1 with max 1
UndertakingAmendmentMessage1 *-- "1..1" Amendment1 : UndertakingAmendmentDetails
UndertakingAmendmentMessage1 *-- "0..1" PartyAndSignature2 : DigitalSignature
%% AdvisingPartyAdditionalInformation1 recursion level 1 with max 1
class AdvisingPartyAdditionalInformation1{
    ReferenceNumber IsoMax35Text
    BankToBeneficiaryInformation IsoMax2000Text
}
%% AdvisingPartyAdditionalInformation1 recursion level 1 with max 1
class AdvisingPartyAdditionalInformation1{
    ReferenceNumber IsoMax35Text
    BankToBeneficiaryInformation IsoMax2000Text
}
%% UndertakingConfirmation1 recursion level 1 with max 1
class UndertakingConfirmation1{
    ReferenceNumber IsoMax35Text
    Confirmation IsoMax2000Text
}
UndertakingConfirmation1 *-- "1..1" PartyIdentification43 : Confirmer
UndertakingConfirmation1 *-- "1..1" IDateAndDateTimeChoice : Date
%% PartyAndSignature2 recursion level 1 with max 1
PartyAndSignature2 *-- "1..1" PartyIdentification43 : Party
PartyAndSignature2 *-- "1..1" ProprietaryData3 : Signature

Amendment2 members

Member name Description Data Type / Multiplicity
UndertakingAmendmentMessage Contents of the related Undertaking Amendment message. UndertakingAmendmentMessage1 - Required 1..1
FirstAdvisingPartyAdditionalInformation Additional information related to the first advising party. AdvisingPartyAdditionalInformation1 - Optional 0..1
SecondAdvisingPartyAdditionalInformation Additional information related to the second advising party. AdvisingPartyAdditionalInformation1 - Optional 0..1
ConfirmationDetails Details concerning the confirmation of the proposed amendment. UndertakingConfirmation1 - Optional 0..1
DigitalSignature Digital signature of the party providing additional undertaking amendment advice details. PartyAndSignature2 - Collection 0..3

BankToBankInformation building block

Additional information specific to the bank-to-bank communication. Specifies a character string with a maximum length of 2000 characters. For comparison, see the ISO20022 official specification This message is declared as Max2000Text in the ISO specification. In our implementation, it is represented in source code as IsoMax2000Text. Due to global using directives, it is treated as a System.String by the compiler and runtime.

DigitalSignature building block

Digital signature of the proposed amendment advice. 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

Member name Description Data Type / Multiplicity
Party Entity involved in an activity. PartyIdentification43 - Required 1..1
Signature Signature of a party. ProprietaryData3 - Required 1..1

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    UndertakingAmendmentAdviceV01 --|> IOuterRecord : Implements
    UndertakingAmendmentAdviceV01Document --|> IOuterDocument~UndertakingAmendmentAdviceV01~ : Implements
    class IOuterDocument~UndertakingAmendmentAdviceV01~ {
        UndertakingAmendmentAdviceV01 Message
     }

Document wrapper for serialization

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

classDiagram
    UndertakingAmendmentAdviceV01Document *-- UndertakingAmendmentAdviceV01 : 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:tsrv.006.001.01">
    <UdrtkgAmdmntAdvc>
        <AdvsgPty>
            <!-- AdvisingParty inner content -->
        </AdvsgPty>
        <ScndAdvsgPty>
            <!-- SecondAdvisingParty inner content -->
        </ScndAdvsgPty>
        <DtOfAdvc>
            <!-- DateOfAdvice inner content -->
        </DtOfAdvc>
        <UdrtkgAmdmntAdvcDtls>
            <!-- UndertakingAmendmentAdviceDetails inner content -->
        </UdrtkgAmdmntAdvcDtls>
        <BkToBkInf>
            <!-- BankToBankInformation inner content -->
        </BkToBkInf>
        <DgtlSgntr>
            <!-- DigitalSignature inner content -->
        </DgtlSgntr>
    </UdrtkgAmdmntAdvc>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_9gJ9ZnltEeG7BsjMvd1mEw_1371399250"
  name="UndertakingAmendmentAdviceV01"
  definition="The UndertakingAmendmentAdvice message is sent by an advising party to the beneficiary, either directly or via one or more other advising parties in the transaction chain, to advise the content of a proposed amendment to an undertaking. Information about the message may also be sent to other interested parties. The proposed undertaking amendment could be to a demand guarantee, standby letter of credit, or counter-undertaking (counter-guarantee or counter-standby). In addition to providing the terms of the proposed amendment and relevant details on proposed changes to the undertaking, the message may provide information from the sender such as confirmation details. It may also be used to advise the proposed termination or cancellation of the undertaking."
  registrationStatus="Registered"
  messageSet="_SiMuI9n1EeGEPsbnW6ebrw"
  xmlTag="UdrtkgAmdmntAdvc"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_pUXylT1XEeKWjKfYlNE7jQ"
    name="AdvisingParty"
    definition="Party advising the undertaking to the beneficiary or to another party."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AdvsgPty"
    complexType="_PWnCxdp-Ed-ak6NoX_4Aeg_-1518984548" />
  <messageBuildingBlock
    xmi:id="_rsgupT1XEeKWjKfYlNE7jQ"
    name="SecondAdvisingParty"
    definition="Additional party that advises the undertaking."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="ScndAdvsgPty"
    complexType="_PWnCxdp-Ed-ak6NoX_4Aeg_-1518984548" />
  <messageBuildingBlock
    xmi:id="_uNTQYz1XEeKWjKfYlNE7jQ"
    name="DateOfAdvice"
    definition="Date on which the undertaking is advised."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="DtOfAdvc"
    simpleType="_YXSZFtp-Ed-ak6NoX_4Aeg_2032498111" />
  <messageBuildingBlock
    xmi:id="_9gJ9Z3ltEeG7BsjMvd1mEw_315692948"
    name="UndertakingAmendmentAdviceDetails"
    definition="Details related to the advice of the proposed amended undertaking."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="UdrtkgAmdmntAdvcDtls"
    complexType="_9-Q1snltEeG7BsjMvd1mEw_-687774575" />
  <messageBuildingBlock
    xmi:id="_EUVqJxWyEeKtPMeuz5Qhfw"
    name="BankToBankInformation"
    definition="Additional information specific to the bank-to-bank communication."
    registrationStatus="Provisionally Registered"
    maxOccurs="5"
    minOccurs="0"
    xmlTag="BkToBkInf"
    simpleType="_YYn11dp-Ed-ak6NoX_4Aeg_2132907481" />
  <messageBuildingBlock
    xmi:id="_9gJ9aHltEeG7BsjMvd1mEw_1348230221"
    name="DigitalSignature"
    definition="Digital signature of the proposed amendment advice."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="DgtlSgntr"
    complexType="_k4nFNZKuEeGnRMFvqYmPBQ" />
  <messageDefinitionIdentifier
    businessArea="tsrv"
    messageFunctionality="006"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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