tsrv.002.001.01
The UndertakingIssuanceAdvice 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 issuance of an undertaking. Other interested parties may also be informed of the advice. The undertaking advised could be a demand guarantee, standby letter of credit, or counter-undertaking (counter-guarantee or counter-standby). In addition to providing details on the applicable rules, expiry date, the amount, required documents, and terms and conditions of the undertaking, the advice may provide information from the sender such as confirmation details.
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
%% UndertakingIssuanceAdviceV01 recursion level 0 with max 0
class UndertakingIssuanceAdviceV01{
BankToBankInformation IsoMax2000Text
}
UndertakingIssuanceAdviceV01 *-- "1..1" PartyIdentification43 : AdvisingParty
UndertakingIssuanceAdviceV01 *-- "0..1" PartyIdentification43 : SecondAdvisingParty
UndertakingIssuanceAdviceV01 *-- "1..1" IDateAndDateTimeChoice : DateOfAdvice
UndertakingIssuanceAdviceV01 *-- "1..1" UndertakingAdvice1 : UndertakingIssuanceAdviceDetails
UndertakingIssuanceAdviceV01 *-- "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. Choice between a date or a date and time format. For comparison, see the ISO20022 official specification
classDiagram direction tb %% IDateAndDateTimeChoice recursion level 0 with max 1
DateAndDateTimeChoice members
| Member name | Description | Data Type / Multiplicity |
|---|
UndertakingIssuanceAdviceDetails building block
Details related to the advice of the issued undertaking. Details of the advice for the issuance of an undertaking. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% UndertakingAdvice1 recursion level 0 with max 1
UndertakingAdvice1 *-- "1..1" UndertakingIssuanceMessage : UndertakingIssuanceMessage
UndertakingAdvice1 *-- "0..1" AdvisingPartyAdditionalInformation1 : FirstAdvisingPartyAdditionalInformation
UndertakingAdvice1 *-- "0..1" AdvisingPartyAdditionalInformation1 : SecondAdvisingPartyAdditionalInformation
UndertakingAdvice1 *-- "0..1" UndertakingConfirmation1 : ConfirmationDetails
UndertakingAdvice1 *-- "0..3" PartyAndSignature2 : DigitalSignature
%% UndertakingIssuanceMessage recursion level 1 with max 1
UndertakingIssuanceMessage *-- "1..1" Undertaking3 : UndertakingDetails
UndertakingIssuanceMessage *-- "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
UndertakingAdvice1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| UndertakingIssuanceMessage | Contents of the related UndertakingIssuance message. | UndertakingIssuanceMessage - 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 related to the confirmation of the undertaking. | UndertakingConfirmation1 - Optional 0..1 |
| DigitalSignature | Digital signature of the party providing additional undertaking 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 undertaking 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 UndertakingIssuanceAdviceV01 implementation follows a specific implementaiton pattern. First of all, UndertakingIssuanceAdviceV01 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, UndertakingIssuanceAdviceV01Document implements IOuterDocument. Because UndertakingIssuanceAdviceV01 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type UndertakingIssuanceAdviceV01.
classDiagram
class IOuterRecord
UndertakingIssuanceAdviceV01 --|> IOuterRecord : Implements
UndertakingIssuanceAdviceV01Document --|> IOuterDocument~UndertakingIssuanceAdviceV01~ : Implements
class IOuterDocument~UndertakingIssuanceAdviceV01~ {
UndertakingIssuanceAdviceV01 Message
}
Document wrapper for serialization
The only real purpose UndertakingIssuanceAdviceV01Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:tsrv.002.001.01’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using UndertakingIssuanceAdviceV01.ToDocument() method. The returned UndertakingIssuanceAdviceV01Document value will serialize correctly according to ISO 20022 standards.
classDiagram
UndertakingIssuanceAdviceV01Document *-- UndertakingIssuanceAdviceV01 : 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.002.001.01">
<UdrtkgIssncAdvc>
<AdvsgPty>
<!-- AdvisingParty inner content -->
</AdvsgPty>
<ScndAdvsgPty>
<!-- SecondAdvisingParty inner content -->
</ScndAdvsgPty>
<DtOfAdvc>
<!-- DateOfAdvice inner content -->
</DtOfAdvc>
<UdrtkgIssncAdvcDtls>
<!-- UndertakingIssuanceAdviceDetails inner content -->
</UdrtkgIssncAdvcDtls>
<BkToBkInf>
<!-- BankToBankInformation inner content -->
</BkToBkInf>
<DgtlSgntr>
<!-- DigitalSignature inner content -->
</DgtlSgntr>
</UdrtkgIssncAdvc>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_9fkHg3ltEeG7BsjMvd1mEw_-135389308"
name="UndertakingIssuanceAdviceV01"
definition="The UndertakingIssuanceAdvice 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 issuance of an undertaking. Other interested parties may also be informed of the advice. The undertaking advised could be a demand guarantee, standby letter of credit, or counter-undertaking (counter-guarantee or counter-standby). In addition to providing details on the applicable rules, expiry date, the amount, required documents, and terms and conditions of the undertaking, the advice may provide information from the sender such as confirmation details."
registrationStatus="Registered"
messageSet="_SiMuI9n1EeGEPsbnW6ebrw"
xmlTag="UdrtkgIssncAdvc"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_HtBI0z1UEeKvwJ48Wu13ug"
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="_WPnPkz1UEeKvwJ48Wu13ug"
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="_bOgLdT1UEeKvwJ48Wu13ug"
name="DateOfAdvice"
definition="Date on which the undertaking is advised."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="DtOfAdvc"
complexType="_T6OX59p-Ed-ak6NoX_4Aeg_1215657154" />
<messageBuildingBlock
xmi:id="_9fkHhHltEeG7BsjMvd1mEw_-1882715655"
name="UndertakingIssuanceAdviceDetails"
definition="Details related to the advice of the issued undertaking."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="UdrtkgIssncAdvcDtls"
complexType="_-AMvZnltEeG7BsjMvd1mEw_-927366247" />
<messageBuildingBlock
xmi:id="_pgGLlRWxEeKtPMeuz5Qhfw"
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="_9fkHhXltEeG7BsjMvd1mEw_1405552400"
name="DigitalSignature"
definition="Digital signature of the undertaking advice."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="DgtlSgntr"
complexType="_k4nFNZKuEeGnRMFvqYmPBQ" />
<messageDefinitionIdentifier
businessArea="tsrv"
messageFunctionality="002"
flavour="001"
version="01" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.