/// <summary>
/// Enables a seller to create an Unpaid Item case against a buyer, or to cancel a
/// single line item order.
///
///
/// Although the seller is eligible to open up an Unpaid Item case two days after the buyer purchases the item or wins the item through an auction, it is recommended that the seller contacts the buyer first to try and make it right before opening a case. The <a href="http://pages.ebay.com/help/sell/unpaid-items.html" target="_blank">Unpaid Items</a> help page talks more about how a seller should to handle an unpaid item.
///
///
/// To cancel a multiple line item order programmatically, the seller would have to use the <a href="https://developer.ebay.com/Devzone/post-order/post-order_v2_cancellation__post.html" target="_blank">POST /post-order/v2/cancellation</a> call of the <b>Post-Order API</b>.
/// </summary>
///
/// <param name="DisputeExplanation">
/// This enumerated value gives the explanation of why the seller opened a case (or why seller canceled a single line item order). Not all values contained in <b>DisputeExplanationCodeType</b> are allowed in the <b>AddDispute</b> call, and the values that are allowed must match the <b>DisputeReason</b> value.
/// </param>
///
/// <param name="DisputeReason">
/// The enumeration value passed into this required field will depend on the action being taken. The seller will pass in <code>BuyerHasNotPaid</code> if the seller is creating an Unpaid Item case against the buyer, or
/// <code>TransactionMutuallyCanceled</code> if the seller is cancelling a single line item order at the request of the buyer, or if the seller has ran out of stock on the item or otherwise cannot fulfill the order.
/// </param>
///
/// <param name="ItemID">
/// Unique identifier of an eBay listing. To identify a specific order line item, either an <b>ItemID</b>/<b>TransactionID</b> pair or an <b>OrderLineItemID</b> value must be passed in the request. So, unless <b>OrderLineItemID</b> is used, this field is required.
///
/// </param>
///
/// <param name="TransactionID">
/// The unique identifier of a buyer's purchase. A <b>TransactionID</b> is created by eBay once a buyer purchases the item through a fixed-priced listing or by using the Buy It Now feature in an auction listing, or when an auction listing ends with a winning bidder. To identify a specific order line item, either an <b>ItemID</b>/<b>TransactionID</b> pair or an <b>OrderLineItemID</b> value must be passed in the request. So, unless <b>OrderLineItemID</b> is used, this field is required.
///
/// </param>
///
/// <param name="OrderLineItemID">
/// <b>OrderLineItemID</b> is a unique identifier of an order line item, and is based upon the concatenation of <b>ItemID</b> and <b>TransactionID</b>, with a hyphen in between these two IDs. To identify a specific order line item, either an <b>ItemID</b>/<b>TransactionID</b> pair or an <b>OrderLineItemID</b> value must be passed in the request. So, unless <b>ItemID</b>/<b>TransactionID</b> pair is used, this field is required.
///
/// </param>
///
public string AddDispute(DisputeExplanationCodeType DisputeExplanation, DisputeReasonCodeType DisputeReason, string ItemID, string TransactionID, string OrderLineItemID)
{
this.DisputeExplanation = DisputeExplanation;
this.DisputeReason = DisputeReason;
this.ItemID = ItemID;
this.TransactionID = TransactionID;
this.OrderLineItemID = OrderLineItemID;
Execute();
return(ApiResponse.DisputeID);
}
/// <summary>
/// For backward compatibility with old wrappers.
/// </summary>
public string AddDispute(string ItemID, string TransactionID, DisputeReasonCodeType DisputeReason, DisputeExplanationCodeType DisputeExplanation)
{
this.ItemID = ItemID;
this.TransactionID = TransactionID;
this.DisputeReason = DisputeReason;
this.DisputeExplanation = DisputeExplanation;
Execute();
return this.DisputeID;
}
/// <summary>
/// For backward compatibility with old wrappers.
/// </summary>
public string AddDispute(string ItemID, string TransactionID, DisputeReasonCodeType DisputeReason, DisputeExplanationCodeType DisputeExplanation)
{
this.ItemID = ItemID;
this.TransactionID = TransactionID;
this.DisputeReason = DisputeReason;
this.DisputeExplanation = DisputeExplanation;
Execute();
return(this.DisputeID);
}
/// <summary>
/// This call enables a seller to create an Unpaid Item case against a buyer, or to cancel a
/// single line item order.
/// <br/><br/>
/// <span class="tablenote"><b>Note:</b>
/// This call is only used by sellers to create an Unpaid Item case or to mutually cancel a
/// single line item order. Buyers must use the eBay Resolution Center or PayPal Resolution
/// Center (for orders that satisfy requirements) to create an Item Not Received or an Item
/// Significantly Not as Described case.
/// </span>
/// </summary>
///
/// <param name="DisputeExplanation">
/// This enumerated value gives the explanation of why the buyer or seller opened a
/// case (or why seller canceled an order line item). Not all values contained in
/// <b>DisputeExplanationCodeType</b> are allowed in the
/// <b>AddDispute</b> call, and the values that are allowed must match
/// the <b>DisputeReason</b> value.
/// </param>
///
/// <param name="DisputeReason">
/// The type of dispute being created. <b>BuyerHasNotPaid</b> and
/// <b>TransactionMutuallyCanceled</b> are the only values that may
/// be used with the <b>AddDispute</b> call.
/// </param>
///
/// <param name="ItemID">
/// Unique identifier for an eBay item listing. A listing can have multiple
/// orders, but only one <b>ItemID</b>. To
/// identify a specific order line item, either an
/// <b>ItemID</b>/<b>TransactionID</b> pair or an
/// <b>OrderLineItemID</b> value must be passed in the request. So,
/// unless <b>OrderLineItemID</b> is used, this field is required.
///
/// </param>
///
/// <param name="TransactionID">
/// The unique identifier of an order line item. An order line item is created once
/// a buyer purchases the item through a fixed-priced listing or by using the Buy It
/// Now feature in an auction listing, or when an auction listing ends with a
/// winning bidder. To identify a specific order line item, either an
/// <b>ItemID</b>/<b>TransactionID</b> pair or an
/// <b>OrderLineItemID</b> value must be passed in the request. So,
/// unless <b>OrderLineItemID</b> is used, this field is required.
///
/// </param>
///
/// <param name="OrderLineItemID">
/// <b>OrderLineItemID</b> is a unique identifier of an order line item,
/// and is based upon the concatenation of <b>ItemID</b> and
/// <b>TransactionID</b>, with a hyphen in between these two IDs. To
/// identify a specific order line item, either an
/// <b>ItemID</b>/<b>TransactionID</b> pair or an
/// <b>OrderLineItemID</b> value must be passed in the request. So,
/// unless <b>ItemID</b>/<b>TransactionID</b> pair is used,
/// this field is required.
///
/// </param>
///
public string AddDispute(DisputeExplanationCodeType DisputeExplanation, DisputeReasonCodeType DisputeReason, string ItemID, string TransactionID, string OrderLineItemID)
{
this.DisputeExplanation = DisputeExplanation;
this.DisputeReason = DisputeReason;
this.ItemID = ItemID;
this.TransactionID = TransactionID;
this.OrderLineItemID = OrderLineItemID;
Execute();
return ApiResponse.DisputeID;
}