pain.014.001.01
Scope This message is sent by a party to the next party in the creditor payment activation request chain. It is used to inform the latter about the positive or negative status of a creditor payment activation request (either single or file).
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
%% CreditorPaymentActivationRequestStatusReportV01 recursion level 0 with max 0
CreditorPaymentActivationRequestStatusReportV01 *-- "1..1" GroupHeader46 : GroupHeader
CreditorPaymentActivationRequestStatusReportV01 *-- "1..1" OriginalGroupInformation25 : OriginalGroupInformationAndStatus
CreditorPaymentActivationRequestStatusReportV01 *-- "0..1" OriginalPaymentInformation5 : OriginalPaymentInformationAndStatus
Now, we will zero-in one-by-one on each of these building blocks.
GroupHeader building block
Set of characteristics shared by all individual transactions included in the message. Set of characteristics shared by all individual transactions included in the message. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% GroupHeader46 recursion level 0 with max 1
class GroupHeader46{
MessageIdentification IsoMax35Text
CreationDateTime IsoISODateTime
}
GroupHeader46 *-- "1..1" PartyIdentification43 : InitiatingParty
GroupHeader46 *-- "0..1" BranchAndFinancialInstitutionIdentification5 : DebtorAgent
GroupHeader46 *-- "0..1" BranchAndFinancialInstitutionIdentification5 : CreditorAgent
%% 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
%% BranchAndFinancialInstitutionIdentification5 recursion level 1 with max 1
BranchAndFinancialInstitutionIdentification5 *-- "1..1" FinancialInstitutionIdentification8 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification5 *-- "0..1" BranchData2 : BranchIdentification
%% BranchAndFinancialInstitutionIdentification5 recursion level 1 with max 1
BranchAndFinancialInstitutionIdentification5 *-- "1..1" FinancialInstitutionIdentification8 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification5 *-- "0..1" BranchData2 : BranchIdentification
GroupHeader46 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| MessageIdentification | Point to point reference assigned by the instructing party and sent to the next party in the chain to unambiguously identify the message. | |
| CreationDateTime | Date and time at which the status report was created by the instructing party. | IsoISODateTime - Required 1..1 |
| InitiatingParty | Party initiating the creditor payment activation request. This can either be the creditor himself or the party that initiates the request on behalf of the creditor. | PartyIdentification43 - Required 1..1 |
| DebtorAgent | Financial institution servicing an account for the debtor. | BranchAndFinancialInstitutionIdentification5 - Optional 0..1 |
| CreditorAgent | Financial institution servicing an account for the creditor. | BranchAndFinancialInstitutionIdentification5 - Optional 0..1 |
OriginalGroupInformationAndStatus building block
Original group information concerning the group of transactions, to which the status report message refers to. Set of elements used to provide information on the original group, to which the message refers. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% OriginalGroupInformation25 recursion level 0 with max 1
class OriginalGroupInformation25{
OriginalMessageIdentification IsoMax35Text
OriginalMessageNameIdentification IsoMax35Text
OriginalCreationDateTime IsoISODateTime
OriginalNumberOfTransactions IsoMax15NumericText
OriginalControlSum IsoDecimalNumber
GroupStatus TransactionGroupStatus3Code
}
OriginalGroupInformation25 *-- "0..0" StatusReasonInformation9 : StatusReasonInformation
OriginalGroupInformation25 *-- "0..0" NumberOfTransactionsPerStatus3 : NumberOfTransactionsPerStatus
%% StatusReasonInformation9 recursion level 1 with max 1
class StatusReasonInformation9{
AdditionalInformation IsoMax105Text
}
StatusReasonInformation9 *-- "0..1" PartyIdentification43 : Originator
StatusReasonInformation9 *-- "0..1" IStatusReason6Choice : Reason
%% NumberOfTransactionsPerStatus3 recursion level 1 with max 1
class NumberOfTransactionsPerStatus3{
DetailedNumberOfTransactions IsoMax15NumericText
DetailedStatus TransactionIndividualStatus3Code
DetailedControlSum IsoDecimalNumber
}
OriginalGroupInformation25 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| OriginalMessageIdentification | Point to point reference, as assigned by the original instructing party, to unambiguously identify the original message. | IsoMax35Text - Required 1..1 |
| OriginalMessageNameIdentification | Specifies the original message name identifier to which the message refers. | IsoMax35Text - Required 1..1 |
| OriginalCreationDateTime | Date and time at which the original message was created. | IsoISODateTime - Optional 0..1 |
| OriginalNumberOfTransactions | Number of individual transactions contained in the original message. | IsoMax15NumericText - Optional 0..1 |
| OriginalControlSum | Total of all individual amounts included in the original message, irrespective of currencies. | IsoDecimalNumber - Optional 0..1 |
| GroupStatus | Specifies the status of a group of transactions. | TransactionGroupStatus3Code - Optional 0..1 |
| StatusReasonInformation | Set of elements used to provide detailed information on the status reason. | StatusReasonInformation9 - Unknown 0..0 |
| NumberOfTransactionsPerStatus | Detailed information on the number of transactions for each identical transaction status. | NumberOfTransactionsPerStatus3 - Unknown 0..0 |
OriginalPaymentInformationAndStatus building block
Information concerning the original payment information, to which the status report message refers. Set of elements used to provide information on the original transactions, to which the status report message refers. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% OriginalPaymentInformation5 recursion level 0 with max 1
class OriginalPaymentInformation5{
OriginalPaymentInformationIdentification IsoMax35Text
OriginalNumberOfTransactions IsoMax15NumericText
OriginalControlSum IsoDecimalNumber
PaymentInformationStatus TransactionGroupStatus3Code
}
OriginalPaymentInformation5 *-- "0..0" StatusReasonInformation9 : StatusReasonInformation
OriginalPaymentInformation5 *-- "0..0" NumberOfTransactionsPerStatus3 : NumberOfTransactionsPerStatus
OriginalPaymentInformation5 *-- "0..0" PaymentTransactionInformation34 : TransactionInformationAndStatus
%% StatusReasonInformation9 recursion level 1 with max 1
class StatusReasonInformation9{
AdditionalInformation IsoMax105Text
}
StatusReasonInformation9 *-- "0..1" PartyIdentification43 : Originator
StatusReasonInformation9 *-- "0..1" IStatusReason6Choice : Reason
%% NumberOfTransactionsPerStatus3 recursion level 1 with max 1
class NumberOfTransactionsPerStatus3{
DetailedNumberOfTransactions IsoMax15NumericText
DetailedStatus TransactionIndividualStatus3Code
DetailedControlSum IsoDecimalNumber
}
%% PaymentTransactionInformation34 recursion level 1 with max 1
class PaymentTransactionInformation34{
StatusIdentification IsoMax35Text
OriginalInstructionIdentification IsoMax35Text
OriginalEndToEndIdentification IsoMax35Text
TransactionStatus TransactionIndividualStatus3Code
AcceptanceDateTime IsoISODateTime
AccountServicerReference IsoMax35Text
ClearingSystemReference IsoMax35Text
}
PaymentTransactionInformation34 *-- "0..0" StatusReasonInformation9 : StatusReasonInformation
PaymentTransactionInformation34 *-- "0..0" ChargesInformation7 : ChargesInformation
PaymentTransactionInformation34 *-- "0..1" OriginalTransactionReference15 : OriginalTransactionReference
OriginalPaymentInformation5 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| OriginalPaymentInformationIdentification | Unique identification, as assigned by the original sending party, to unambiguously identify the original payment information group. | IsoMax35Text - Required 1..1 |
| OriginalNumberOfTransactions | Number of individual transactions contained in the original payment information group. | IsoMax15NumericText - Optional 0..1 |
| OriginalControlSum | Total of all individual amounts included in the original payment information group, irrespective of currencies. | IsoDecimalNumber - Optional 0..1 |
| PaymentInformationStatus | Specifies the status of the payment information group. | TransactionGroupStatus3Code - Optional 0..1 |
| StatusReasonInformation | Set of elements used to provide detailed information on the status reason. | StatusReasonInformation9 - Unknown 0..0 |
| NumberOfTransactionsPerStatus | Detailed information on the number of transactions for each identical transaction status. | NumberOfTransactionsPerStatus3 - Unknown 0..0 |
| TransactionInformationAndStatus | Set of elements used to provide information on the original transactions to which the status report message refers. | PaymentTransactionInformation34 - Unknown 0..0 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the CreditorPaymentActivationRequestStatusReportV01 implementation follows a specific implementaiton pattern. First of all, CreditorPaymentActivationRequestStatusReportV01 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, CreditorPaymentActivationRequestStatusReportV01Document implements IOuterDocument. Because CreditorPaymentActivationRequestStatusReportV01 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type CreditorPaymentActivationRequestStatusReportV01.
classDiagram
class IOuterRecord
CreditorPaymentActivationRequestStatusReportV01 --|> IOuterRecord : Implements
CreditorPaymentActivationRequestStatusReportV01Document --|> IOuterDocument~CreditorPaymentActivationRequestStatusReportV01~ : Implements
class IOuterDocument~CreditorPaymentActivationRequestStatusReportV01~ {
CreditorPaymentActivationRequestStatusReportV01 Message
}
Document wrapper for serialization
The only real purpose CreditorPaymentActivationRequestStatusReportV01Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:pain.014.001.01’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using CreditorPaymentActivationRequestStatusReportV01.ToDocument() method. The returned CreditorPaymentActivationRequestStatusReportV01Document value will serialize correctly according to ISO 20022 standards.
classDiagram
CreditorPaymentActivationRequestStatusReportV01Document *-- CreditorPaymentActivationRequestStatusReportV01 : 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:pain.014.001.01">
<CdtrPmtActvtnReqStsRpt>
<GrpHdr>
<!-- GroupHeader inner content -->
</GrpHdr>
<OrgnlGrpInfAndSts>
<!-- OriginalGroupInformationAndStatus inner content -->
</OrgnlGrpInfAndSts>
<OrgnlPmtInfAndSts>
<!-- OriginalPaymentInformationAndStatus inner content -->
</OrgnlPmtInfAndSts>
</CdtrPmtActvtnReqStsRpt>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_GV_IptEvEd-BzquC8wXy7w_1012339931"
nextVersions="_r_AYEFkyEeGeoaLUQk__nA_-2103829610"
name="CreditorPaymentActivationRequestStatusReportV01"
definition="Scope
This message is sent by a party to the next party in the creditor payment activation request chain.
It is used to inform the latter about the positive or negative status of a creditor payment activation request (either single or file)."
registrationStatus="Registered"
messageSet="_urpIICeJEeOCeO5e7islRQ"
xmlTag="CdtrPmtActvtnReqStsRpt"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<constraint
xmi:id="_GWISk9EvEd-BzquC8wXy7w_140531557"
name="GroupAndTransactionStatus1Rule"
definition="If OriginalGroupInformationAndStatus/GroupStatus is present and is equal to ACTC, ACCP, ACSP or ACSC, ACCR or ACWC, then TransactionInformationAndStatus/TransactionStatus must be different from RJCT."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_GWISltEvEd-BzquC8wXy7w_172096965"
name="GroupAndTransactionStatus2Rule"
definition="If OriginalGroupInformationAndStatus/GroupStatus is present and is equal to PDNG, then TransactionInformationAndStatus/TransactionStatus must be different from RJCT."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_GWISmdEvEd-BzquC8wXy7w_1482996916"
name="GroupAndTransactionStatus3Rule"
definition="If OriginalGroupInformationAndStatus/GroupStatus is present and is equal to RJCT, then TransactionInformationAndStatus/TransactionStatus must be different from ACTC, ACCP, ACSP, ACSC, ACCR, ACWC or PDNG."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_GWISnNEvEd-BzquC8wXy7w_-368888835"
name="GroupAndTransactionStatus4Rule"
definition="If OriginalGroupInformationAndStatus/GroupStatus is present and is equal to RCVD, then TransactionInformationAndStatus/TransactionStatus is not allowed."
registrationStatus="Provisionally Registered" />
<messageBuildingBlock
xmi:id="_GWISkNEvEd-BzquC8wXy7w_335049287"
name="GroupHeader"
definition="Set of characteristics shared by all individual transactions included in the message."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="GrpHdr"
complexType="_UQlCcdp-Ed-ak6NoX_4Aeg_-1988631022" />
<messageBuildingBlock
xmi:id="_GWISkdEvEd-BzquC8wXy7w_1282037289"
name="OriginalGroupInformationAndStatus"
definition="Original group information concerning the group of transactions, to which the status report message refers to."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="OrgnlGrpInfAndSts"
complexType="_Pe9Ge9p-Ed-ak6NoX_4Aeg_-379878312" />
<messageBuildingBlock
xmi:id="_GWISktEvEd-BzquC8wXy7w_-534994905"
name="OriginalPaymentInformationAndStatus"
definition="Information concerning the original payment information, to which the status report message refers."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="OrgnlPmtInfAndSts"
complexType="_PezVcNp-Ed-ak6NoX_4Aeg_-1733791998" />
<messageDefinitionIdentifier
businessArea="pain"
messageFunctionality="014"
flavour="001"
version="01" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.