tsrv.015.001.01
The ExtendOrPayResponse message is sent by the party that requested issuance of the undertaking (applicant or obligor) to the party that issued the undertaking, in response to the issuer’s request for the applicant’s response to the beneficiary’s request to extend or pay.
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 %% ExtendOrPayResponseV01 recursion level 0 with max 0 ExtendOrPayResponseV01 *-- "1..1" ExtendOrPayQuery2 : ExtendOrPayResponseDetails ExtendOrPayResponseV01 *-- "0..1" PartyAndSignature2 : DigitalSignature
Now, we will zero-in one-by-one on each of these building blocks.
ExtendOrPayResponseDetails building block
Details of the extend or pay response. Undertaking extend or pay query details. For comparison, see the ISO20022 official specification
classDiagram direction tb %% ExtendOrPayQuery2 recursion level 0 with max 1 class ExtendOrPayQuery2{ Status DemandStatus1Code } ExtendOrPayQuery2 *-- "1..1" Undertaking9 : UndertakingIdentification ExtendOrPayQuery2 *-- "1..1" Demand4 : DemandDetails %% Undertaking9 recursion level 1 with max 1 class Undertaking9{ Identification IsoMax35Text ApplicantReferenceNumber IsoMax35Text } Undertaking9 *-- "1..1" PartyIdentification43 : Issuer %% Demand4 recursion level 1 with max 1 class Demand4{ Identification IsoMax35Text Amount IsoActiveCurrencyAndAmount }
ExtendOrPayQuery2 members
Member name | Description | Data Type / Multiplicity |
---|---|---|
UndertakingIdentification | Details related to the identification of the undertaking. | Undertaking9 - Required 1..1 |
DemandDetails | Details related to the demand. | Demand4 - Required 1..1 |
Status | Processing status reported by the applicant. | DemandStatus1Code - Required 1..1 |
DigitalSignature building block
Digital signature of the response. 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 ExtendOrPayResponseV01 implementation follows a specific implementaiton pattern. First of all, ExtendOrPayResponseV01 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, ExtendOrPayResponseV01Document implements IOuterDocument. Because ExtendOrPayResponseV01 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type ExtendOrPayResponseV01.
classDiagram class IOuterRecord ExtendOrPayResponseV01 --|> IOuterRecord : Implements ExtendOrPayResponseV01Document --|> IOuterDocument~ExtendOrPayResponseV01~ : Implements class IOuterDocument~ExtendOrPayResponseV01~ { ExtendOrPayResponseV01 Message }
Document wrapper for serialization
The only real purpose ExtendOrPayResponseV01Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:tsrv.015.001.01’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using ExtendOrPayResponseV01.ToDocument() method. The returned ExtendOrPayResponseV01Document value will serialize correctly according to ISO 20022 standards.
classDiagram ExtendOrPayResponseV01Document *-- ExtendOrPayResponseV01 : 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.015.001.01">
<XtndOrPayRspn>
<XtndOrPayRspnDtls>
<!-- ExtendOrPayResponseDetails inner content -->
</XtndOrPayRspnDtls>
<DgtlSgntr>
<!-- DigitalSignature inner content -->
</DgtlSgntr>
</XtndOrPayRspn>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_9iZZEnltEeG7BsjMvd1mEw_519258789"
name="ExtendOrPayResponseV01"
definition="The ExtendOrPayResponse message is sent by the party that requested issuance of the undertaking (applicant or obligor) to the party that issued the undertaking, in response to the issuer's request for the applicant's response to the beneficiary’s request to extend or pay."
registrationStatus="Registered"
messageSet="_SiMuI9n1EeGEPsbnW6ebrw"
xmlTag="XtndOrPayRspn"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_9iZZE3ltEeG7BsjMvd1mEw_-29894697"
name="ExtendOrPayResponseDetails"
definition="Details of the extend or pay response."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="XtndOrPayRspnDtls"
complexType="_-Dxn0nltEeG7BsjMvd1mEw_1814093000" />
<messageBuildingBlock
xmi:id="_9iZZFHltEeG7BsjMvd1mEw_1281187011"
name="DigitalSignature"
definition="Digital signature of the response."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="DgtlSgntr"
complexType="_k4nFNZKuEeGnRMFvqYmPBQ" />
<messageDefinitionIdentifier
businessArea="tsrv"
messageFunctionality="015"
flavour="001"
version="01" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.