InvoiceFinancingCancellationRequestV01

tsin.003.001.01

Scope The InvoiceFinancingCancellationRequest message is sent by the Financing Requestor to the Intermediary Agent (relay scenario) or First Agent (direct scenario). It is used to request the cancellation of a previously sent financing request. Usage The InvoiceFinancingCancellationRequest message is used by the Financing Requestor to request the cancellation of a previously sent financing request. It is not possible to send a cancellation request for a single invoice contained in a bulk invoice financing request. The InvoiceFinancingCancellationRequest message contains references (original group identification and original creation date and time) of the original financing request message to which is referred. As for InvoiceFinancingRequest, the message can be used in a direct or a relay scenario:

In a direct scenario, the message is sent directly to the First Agent. The First Agent is the account servicer of the Financing Requestor.
In a relay scenario, the message is sent to an Intermediary Agent. The Intermediary Agent forwards the InvoiceFinancingCancellingRequest message to the First Agent.

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
%% InvoiceFinancingCancellationRequestV01 recursion level 0 with max 0
InvoiceFinancingCancellationRequestV01 *-- "1..1" MessageIdentification1 : CancellationRequestIdentification
InvoiceFinancingCancellationRequestV01 *-- "1..1" CancellationRequestInformation1 : CancellationRequestInformation

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

CancellationRequestIdentification building block

Unique and unambiguous identification of the message. Identifies a message by a unique identifier and the date and time when the message was created by the sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% MessageIdentification1 recursion level 0 with max 1
class MessageIdentification1{
    Identification IsoMax35Text
    CreationDateTime IsoISODateTime
}

MessageIdentification1 members

Member name	Description	Data Type / Multiplicity
Identification	Identification of the message.	IsoMax35Text - Required 1..1
CreationDateTime	Date of creation of the message.	IsoISODateTime - Required 1..1

CancellationRequestInformation building block

Set of information related to the cancellation request, such as actors involved and identification of the original invoice financing request to which the cancellation request refers. Set of information related to the cancellation request, such as actors involved and identification of the original multiple invoice financing request to which the cancellation request is referring. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% CancellationRequestInformation1 recursion level 0 with max 1
class CancellationRequestInformation1{
    OriginalGroupIdentification IsoMax35Text
    OriginalCreationDateTime IsoISODateTime
    NumberOfInvoiceRequests IsoMax15NumericText
    TotalBulkInvoiceAmount IsoActiveCurrencyAndAmount
    CancellationReason IsoMax105Text
}
CancellationRequestInformation1 *-- "0..1" PartyIdentificationAndAccount6 : FinancingRequestor
CancellationRequestInformation1 *-- "0..1" FinancialInstitutionIdentification6 : IntermediaryAgent
CancellationRequestInformation1 *-- "0..1" FinancialInstitutionIdentification6 : FirstAgent
%% PartyIdentificationAndAccount6 recursion level 1 with max 1
PartyIdentificationAndAccount6 *-- "1..1" PartyIdentification25 : PartyIdentification
PartyIdentificationAndAccount6 *-- "0..1" CashAccount7 : CreditAccount
PartyIdentificationAndAccount6 *-- "0..1" CashAccount7 : FinancingAccount
%% FinancialInstitutionIdentification6 recursion level 1 with max 1
class FinancialInstitutionIdentification6{
    BIC IsoBICIdentifier
}
FinancialInstitutionIdentification6 *-- "0..1" IClearingSystemMemberIdentification2Choice : ClearingSystemMemberIdentification
FinancialInstitutionIdentification6 *-- "0..1" GenericIdentification4 : ProprietaryIdentification
%% FinancialInstitutionIdentification6 recursion level 1 with max 1
class FinancialInstitutionIdentification6{
    BIC IsoBICIdentifier
}
FinancialInstitutionIdentification6 *-- "0..1" IClearingSystemMemberIdentification2Choice : ClearingSystemMemberIdentification
FinancialInstitutionIdentification6 *-- "0..1" GenericIdentification4 : ProprietaryIdentification

CancellationRequestInformation1 members

Member name	Description	Data Type / Multiplicity
OriginalGroupIdentification	Unique and unambiguous identifier of the original financing request message as assigned by the original sending party.	IsoMax35Text - Required 1..1
OriginalCreationDateTime	Date and time at which the original financing request message was created.	IsoISODateTime - Required 1..1
NumberOfInvoiceRequests	Specifies the number of single invoice financing requests included in the original financing request message.	IsoMax15NumericText - Optional 0..1
TotalBulkInvoiceAmount	Total amount of the bulk invoice financing request. It is composed by the sum of the total amounts of all invoices included in the original financing request message.	IsoActiveCurrencyAndAmount - Optional 0..1
CancellationReason	Further details on the cancellation request information, in an uncoded form.	IsoMax105Text - Required 1..1
FinancingRequestor	Party that requests the cancellation of a financing request previously sent.	PartyIdentificationAndAccount6 - Optional 0..1
IntermediaryAgent	Financial institution that receives the request from the financing requestor and forwards it to the first agent for execution.	FinancialInstitutionIdentification6 - Optional 0..1
FirstAgent	Financial institution of financing requestor to which an invoice financing cancellation request is addressed.	FinancialInstitutionIdentification6 - Optional 0..1

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    InvoiceFinancingCancellationRequestV01 --|> IOuterRecord : Implements
    InvoiceFinancingCancellationRequestV01Document --|> IOuterDocument~InvoiceFinancingCancellationRequestV01~ : Implements
    class IOuterDocument~InvoiceFinancingCancellationRequestV01~ {
        InvoiceFinancingCancellationRequestV01 Message
     }

Document wrapper for serialization

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

classDiagram
    InvoiceFinancingCancellationRequestV01Document *-- InvoiceFinancingCancellationRequestV01 : 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:tsin.003.001.01">
    <InvcFincgCxlReq>
        <CxlReqId>
            <!-- CancellationRequestIdentification inner content -->
        </CxlReqId>
        <CxlReqInf>
            <!-- CancellationRequestInformation inner content -->
        </CxlReqInf>
    </InvcFincgCxlReq>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_BUjIPn1LEeCF8NjrBemJWQ_-1871971623"
  name="InvoiceFinancingCancellationRequestV01"
  definition="Scope&#xD;&#xA;The InvoiceFinancingCancellationRequest message is sent by the Financing Requestor to the Intermediary Agent (relay scenario) or First Agent (direct scenario). It is used to request the cancellation of a previously sent financing request.&#xD;&#xA;Usage&#xD;&#xA;The InvoiceFinancingCancellationRequest message is used by the Financing Requestor to request the cancellation of a previously sent financing request.&#xD;&#xA;It is not possible to send a cancellation request for a single invoice contained in a bulk invoice financing request.&#xD;&#xA;The InvoiceFinancingCancellationRequest message contains references (original group identification and original creation date and time) of the original financing request message to which is referred.&#xD;&#xA;As for InvoiceFinancingRequest, the message can be used in a direct or a relay scenario:&#xD;&#xA;- In a direct scenario, the message is sent directly to the First Agent. The First Agent is the account servicer of the Financing Requestor.&#xD;&#xA;- In a relay scenario, the message is sent to an Intermediary Agent. The Intermediary Agent forwards the InvoiceFinancingCancellingRequest message to the First Agent."
  registrationStatus="Registered"
  messageSet="_wRx2yE2rEeG_I4xRYCA_7g"
  xmlTag="InvcFincgCxlReq"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_BUjIP31LEeCF8NjrBemJWQ_-2121755534"
    name="CancellationRequestIdentification"
    definition="Unique and unambiguous identification of the message."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="CxlReqId"
    complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
  <messageBuildingBlock
    xmi:id="_BUsSIH1LEeCF8NjrBemJWQ_-1725175047"
    name="CancellationRequestInformation"
    definition="Set of information related to the cancellation request, such as actors involved and identification of the original invoice financing request to which the cancellation request refers."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="CxlReqInf"
    complexType="_TiiQo9p-Ed-ak6NoX_4Aeg_1653900933" />
  <messageDefinitionIdentifier
    businessArea="tsin"
    messageFunctionality="003"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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