com.prowidesoftware.swift.model.mx.dic.CustomerPaymentCancellationRequestV04 Maven / Gradle / Ivy
package com.prowidesoftware.swift.model.mx.dic;
import java.util.ArrayList;
import java.util.List;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlType;
import org.apache.commons.lang3.builder.EqualsBuilder;
import org.apache.commons.lang3.builder.HashCodeBuilder;
import org.apache.commons.lang3.builder.ToStringBuilder;
import org.apache.commons.lang3.builder.ToStringStyle;
/**
* Scope
* The Customer Payment Cancellation Request message is sent by a case creator/case assigner to a case assignee.
* This message is used to request the cancellation of an original payment instruction. The Customer Payment Cancellation Request message is issued by the initiating party to request the cancellation of an initiation payment message previously sent (such as CustomerCreditTransferInitiation or CustomerDirectDebitInitiation).
* Usage
* The Customer Payment Cancellation Request message must be answered with a:
* - Resolution Of Investigation message with a positive final outcome when the case assignee can perform the requested cancellation
* - Resolution Of Investigation message with a negative final outcome when the case assignee may perform the requested cancellation but fails to do so (too late, irrevocable instruction, ...)
* - Reject Investigation message when the case assignee is unable or not authorised to perform the requested cancellation
* - Notification Of Case Assignment message to indicate whether the case assignee will take on the case himself or reassign the case to a subsequent party in the payment processing chain.
* A Customer Payment Cancellation Request message concerns one and only one original payment instruction at a time.
* When a case assignee successfully performs a cancellation, it must return the corresponding funds to the case assigner. It may provide some details about the return in the Resolution Of Investigation message.
* The processing of a Customer Payment Cancellation Request message case may lead to a Debit Authorisation Request message sent to the creditor by its account servicing institution.
* The Customer Payment Cancellation Request message may be used to escalate a case after an unsuccessful request to modify the payment. In this scenario, the case identification remains the same as in the original Customer Payment Cancellation Request message and the element ReopenCaseIndication is set to 'Yes' or 'true'.
* The Customer Payment Cancellation Request message has the following main characteristics:
* The case creator assigns a unique case identification and the reason code for the cancellation request. This information will be passed unchanged to all subsequent case assignee(s). For the Customer Payment Cancellation Request message has been made optional, as the message might be used outside of a case management environment where the case identification is not relevant.
* Moreover, the case identification may be present at different levels:
* - One unique case is defined per cancellation request message: If multiple underlying groups, payment information blocks or transactions are present in the message and the case assignee has already forwarded the transaction for which the cancellation is requested, the case cannot be forwarded to the next party in the chain (see rule on uniqueness of the case) and the case creator will have to issue individual cancellation requests for each underlying individual transaction. In response to this cancellation request, the case must also be present at the message level in the Resolution of Investigation message.
* - One case per original group, payment information or transaction present in the cancellation request: For each group, payment information block or transaction within the payment information, a unique case has been assigned. This means, when a payment instruction has already been forwarded by the case assignee, the cancellation request may be forwarded to next party in the payment chain, with the unique case assigned to the transaction. When the group can only be cancelled partially, new cancellation requests need however to be issued for the individual transactions within the group for which the cancellation request has not been successful. In response to this cancellation request, the case must be present in the cancellation details identifying the original group or transaction in the Resolution of Investigation message.
* - No case used in cancellation request message:
* The cancellation of a payment instruction can be initiated by either the debtor/creditor or any subsequent agent in the payment instruction processing chain.
*
*
*
*/
@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(name = "CustomerPaymentCancellationRequestV04", propOrder = {
"assgnmt",
"_case",
"ctrlData",
"undrlyg",
"splmtryData"
})
public class CustomerPaymentCancellationRequestV04 {
@XmlElement(name = "Assgnmt", required = true)
protected CaseAssignment3 assgnmt;
@XmlElement(name = "Case")
protected Case3 _case;
@XmlElement(name = "CtrlData")
protected ControlData1 ctrlData;
@XmlElement(name = "Undrlyg", required = true)
protected List undrlyg;
@XmlElement(name = "SplmtryData")
protected List splmtryData;
/**
* Gets the value of the assgnmt property.
*
* @return
* possible object is
* {@link CaseAssignment3 }
*
*/
public CaseAssignment3 getAssgnmt() {
return assgnmt;
}
/**
* Sets the value of the assgnmt property.
*
* @param value
* allowed object is
* {@link CaseAssignment3 }
*
*/
public CustomerPaymentCancellationRequestV04 setAssgnmt(CaseAssignment3 value) {
this.assgnmt = value;
return this;
}
/**
* Gets the value of the case property.
*
* @return
* possible object is
* {@link Case3 }
*
*/
public Case3 getCase() {
return _case;
}
/**
* Sets the value of the case property.
*
* @param value
* allowed object is
* {@link Case3 }
*
*/
public CustomerPaymentCancellationRequestV04 setCase(Case3 value) {
this._case = value;
return this;
}
/**
* Gets the value of the ctrlData property.
*
* @return
* possible object is
* {@link ControlData1 }
*
*/
public ControlData1 getCtrlData() {
return ctrlData;
}
/**
* Sets the value of the ctrlData property.
*
* @param value
* allowed object is
* {@link ControlData1 }
*
*/
public CustomerPaymentCancellationRequestV04 setCtrlData(ControlData1 value) {
this.ctrlData = value;
return this;
}
/**
* Gets the value of the undrlyg property.
*
*
* This accessor method returns a reference to the live list,
* not a snapshot. Therefore any modification you make to the
* returned list will be present inside the JAXB object.
* This is why there is not a set method for the undrlyg property.
*
*
* For example, to add a new item, do as follows:
*
* getUndrlyg().add(newItem);
*
*
*
*
* Objects of the following type(s) are allowed in the list
* {@link UnderlyingTransaction11 }
*
*
*/
public List getUndrlyg() {
if (undrlyg == null) {
undrlyg = new ArrayList();
}
return this.undrlyg;
}
/**
* Gets the value of the splmtryData property.
*
*
* This accessor method returns a reference to the live list,
* not a snapshot. Therefore any modification you make to the
* returned list will be present inside the JAXB object.
* This is why there is not a set method for the splmtryData property.
*
*
* For example, to add a new item, do as follows:
*
* getSplmtryData().add(newItem);
*
*
*
*
* Objects of the following type(s) are allowed in the list
* {@link SupplementaryData1 }
*
*
*/
public List getSplmtryData() {
if (splmtryData == null) {
splmtryData = new ArrayList();
}
return this.splmtryData;
}
@Override
public String toString() {
return ToStringBuilder.reflectionToString(this, ToStringStyle.MULTI_LINE_STYLE);
}
@Override
public boolean equals(Object that) {
return EqualsBuilder.reflectionEquals(this, that);
}
@Override
public int hashCode() {
return HashCodeBuilder.reflectionHashCode(this);
}
/**
* Adds a new item to the undrlyg list.
* @see #getUndrlyg()
*
*/
public CustomerPaymentCancellationRequestV04 addUndrlyg(UnderlyingTransaction11 undrlyg) {
getUndrlyg().add(undrlyg);
return this;
}
/**
* Adds a new item to the splmtryData list.
* @see #getSplmtryData()
*
*/
public CustomerPaymentCancellationRequestV04 addSplmtryData(SupplementaryData1 splmtryData) {
getSplmtryData().add(splmtryData);
return this;
}
}