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.