/// <summary>
/// Simulates the creation of a new Second Chance Offer
/// listing of an item without actually creating a listing.
/// </summary>
///
/// <param name="RecipientBidderUserID">
/// Specifies the bidder from the original, ended listing to whom the seller
/// is extending the second chance offer. Specify only one
/// RecipientBidderUserID per call. If multiple users are specified (each in a
/// RecipientBidderUserID node), only the last one specified receives the
/// offer.
/// </param>
///
/// <param name="BuyItNowPrice">
/// Specifies the amount the offer recipient must pay to purchase the item
/// from the second chance offer listing. Use only when the original item was
/// an eBay Motors (or in some categories on U.S. and international sites for
/// high-priced items, such as items in many U.S. and Canada Business and
/// Industrial categories) and it ended unsold because the reserve price was
/// not met. Call fails with an error for any other item conditions.
/// </param>
///
/// <param name="Duration">
/// Specifies the length of time the second chance offer listing will be
/// active. The recipient bidder has that much time to purchase the item or
/// the listing expires.
/// </param>
///
/// <param name="ItemID">
/// Specifies the item ID for the original, ended listing from which the
/// second chance offer item comes. A new ItemID is returned for the second
/// chance offer item.
/// </param>
///
/// <param name="SellerMessage">
/// Message content. Cannot contain HTML, asterisks, or quotes. This content
/// is included in the second chance offer email sent to the recipient, which
/// can be retrieved with GetMyMessages.
/// </param>
///
public DateTime VerifyAddSecondChanceItem(string RecipientBidderUserID, AmountType BuyItNowPrice, SecondChanceOfferDurationCodeType Duration, string ItemID, string SellerMessage)
{
this.RecipientBidderUserID = RecipientBidderUserID;
this.BuyItNowPrice = BuyItNowPrice;
this.Duration = Duration;
this.ItemID = ItemID;
this.SellerMessage = SellerMessage;
Execute();
return ApiResponse.StartTime;
}
/// <summary>
/// For backward compatibility with old wrappers.
/// </summary>
public void VerifyAddSecondChanceItem(string RecipientBidderUserID, AmountType BuyItNowPrice, bool CopyEmailToSeller, SecondChanceOfferDurationCodeType Duration, string ItemID)
{
this.RecipientBidderUserID = RecipientBidderUserID;
this.BuyItNowPrice = BuyItNowPrice;
this.Duration = Duration;
this.ItemID = ItemID;
Execute();
}
/// <summary>
/// Base request of the <b>AddTransactionConfirmationItem</b> call, which is used to end an eBay Motors listing and creates a new Transaction Confirmation Request (TCR) for the motor vehichle, thus enabling the TCR recipient to purchase the item. You can also use this call to see if a new TCR can be created for the specified item.
/// </summary>
///
/// <param name="RecipientUserID">
/// This field is used to specify the recipient of the Transaction
/// Confirmation Request (TCR).
/// </param>
///
/// <param name="VerifyEligibilityOnly">
/// This field is included and set to <code>true</code> if the seller wants to verify whether or not a new Transaction
/// Confirmation Request (TCR) can be created for the item. If this field is included and its value set to <code>true</code>, no TCR is actually created. If this field is included and its value set to <code>false</code>, or if it is omitted, a Transaction
/// Confirmation Request is actually created.
/// </param>
///
/// <param name="RecipientPostalCode">
/// This field is used to specify the postal code of the user to whom the seller is offering the Transaction Confirmation Request. This field is only required if the user does not meet the other options listed in <b>RecipientRelationCodeType</b>.
/// </param>
///
/// <param name="RecipientRelationType">
/// The enumeration value supplied in this field specifies the current relationship between the seller and the potential
/// buyer. A Transaction Confirmation Request (TCR) for an
/// item can be sent to a potential buyer who has at least one of the following criteria: is an active bidder on the auction listing; has made a Best Offer on the fixed-price listing, is an eBay user who has used the Ask Seller a Question feature, or is an eBay user whose postal code is known.
/// </param>
///
/// <param name="NegotiatedPrice">
/// The amount in this field is the price that the seller is asking for to purchase the motor vehicle.
/// </param>
///
/// <param name="ListingDuration">
/// The enumeration value specified in this field will control how many days that the recipient of the offer has to purchase the motor vehicle at the price listed in the <b>NegotiatedPrice</b> field.
/// </param>
///
/// <param name="ItemID">
/// This field is used to identify the eBay Motors listing using the unique identifier of the listing (<b>ItemID</b>).
/// </param>
///
/// <param name="Comments">
/// This is optional free-form string field that can be used by the seller to provide any comments or additional information about the Transaction Confirmation Item.
/// </param>
///
public string AddTransactionConfirmationItem(string RecipientUserID, string VerifyEligibilityOnly, string RecipientPostalCode, RecipientRelationCodeType RecipientRelationType, AmountType NegotiatedPrice, SecondChanceOfferDurationCodeType ListingDuration, string ItemID, string Comments)
{
this.RecipientUserID = RecipientUserID;
this.VerifyEligibilityOnly = VerifyEligibilityOnly;
this.RecipientPostalCode = RecipientPostalCode;
this.RecipientRelationType = RecipientRelationType;
this.NegotiatedPrice = NegotiatedPrice;
this.ListingDuration = ListingDuration;
this.ItemID = ItemID;
this.Comments = Comments;
Execute();
return(ApiResponse.ItemID);
}
/// <summary>
/// Simulates the creation of a new Second Chance Offer
/// listing of an item without actually creating a listing.
/// </summary>
///
/// <param name="RecipientBidderUserID">
/// Specifies the bidder from the original, ended listing to whom the seller
/// is extending the second chance offer. Specify only one
/// RecipientBidderUserID per call. If multiple users are specified (each in a
/// RecipientBidderUserID node), only the last one specified receives the
/// offer.
/// </param>
///
/// <param name="BuyItNowPrice">
/// Specifies the amount the offer recipient must pay to purchase the item
/// from the second chance offer listing. Use only when the original item was
/// an eBay Motors (or in some categories on U.S. and international sites for
/// high-priced items, such as items in many U.S. and Canada Business and
/// Industrial categories) and it ended unsold because the reserve price was
/// not met. Call fails with an error for any other item conditions.
/// </param>
///
/// <param name="Duration">
/// Specifies the length of time the second chance offer listing will be
/// active. The recipient bidder has that much time to purchase the item or
/// the listing expires.
/// </param>
///
/// <param name="ItemID">
/// Specifies the item ID for the original, ended listing from which the
/// second chance offer item comes. A new ItemID is returned for the second
/// chance offer item.
/// </param>
///
/// <param name="SellerMessage">
/// Message content. Cannot contain HTML, asterisks, or quotes. This content
/// is included in the second chance offer email sent to the recipient, which
/// can be retrieved with GetMyMessages.
/// </param>
///
public DateTime VerifyAddSecondChanceItem(string RecipientBidderUserID, AmountType BuyItNowPrice, SecondChanceOfferDurationCodeType Duration, string ItemID, string SellerMessage)
{
this.RecipientBidderUserID = RecipientBidderUserID;
this.BuyItNowPrice = BuyItNowPrice;
this.Duration = Duration;
this.ItemID = ItemID;
this.SellerMessage = SellerMessage;
Execute();
return(ApiResponse.StartTime);
}
/// <summary>
/// For backward compatibility with old wrappers.
/// </summary>
public void VerifyAddSecondChanceItem(string RecipientBidderUserID, AmountType BuyItNowPrice, bool CopyEmailToSeller, SecondChanceOfferDurationCodeType Duration, string ItemID)
{
this.RecipientBidderUserID = RecipientBidderUserID;
this.BuyItNowPrice = BuyItNowPrice;
this.Duration = Duration;
this.ItemID = ItemID;
Execute();
}
/// <summary>
/// Ends the eBay Motors listing specified by ItemID and creates a new Transaction
/// Confirmation Request (TCR) for the item, thus enabling the TCR recipient to
/// purchase the item. You can also use this call to see if a new TCR can be created
/// for the specified item.
/// </summary>
///
/// <param name="RecipientUserID">
/// Specifies the user to whom the seller is offering the Transaction
/// Confirmation Request.
/// </param>
///
/// <param name="VerifyEligibilityOnly">
/// If true, specifies that the seller is verifying whether a new Transaction
/// Confirmation Request (TCR) can be created. Thus, if this value is passed
/// as true, then no Transaction Confirmation Request is actually made. If
/// VerifyEligibilityOnly is not passed, or is false, a Transaction
/// Confirmation Request is actually made.
/// </param>
///
/// <param name="RecipientPostalCode">
/// Specifies the postal code of the user to whom the seller is offering the
/// Transaction Confirmation Request. Required only if the user does not meet
/// the other options listed in RecipientRelationCodeType. An error is
/// returned if RecipientUserID and RecipientPostalCode do not match for more
/// than 3 times for a seller per day.
/// </param>
///
/// <param name="RecipientRelationType">
/// Specifies the current relationship between the seller and the potential
/// buyer. A seller can make a Transaction Confirmation Request (TCR) for an
/// item to a potential buyer if the buyer meets one of several criteria. A
/// TCR is sent by a seller to one of the following: a bidder, a best offer
/// buyer, a member with an ASQ question, or any member with a postal code.
/// See the values and annotations in RecipientRelationCodeType.
/// </param>
///
/// <param name="NegotiatedPrice">
/// The amount the offer recipient must pay to buy the item
/// specified in the Transaction Confirmation Request (TCR).
/// A negotiated amount between the buyer and the seller.
/// </param>
///
/// <param name="ListingDuration">
/// Specifies the length of time the item in the Transaction Confirmation
/// Request (TCR) will be available for purchase.
/// </param>
///
/// <param name="ItemID">
/// The ItemID of the item that the seller wants to end in order to create a
/// Transaction Confirmation Request (TCR).
/// </param>
///
/// <param name="Comments">
/// Comments the seller wants to send to the recipient (bidder, best offer
/// buyer, member with an ASQ question, or member with a postal code).
/// </param>
///
public string AddTransactionConfirmationItem(string RecipientUserID, string VerifyEligibilityOnly, string RecipientPostalCode, RecipientRelationCodeType RecipientRelationType, AmountType NegotiatedPrice, SecondChanceOfferDurationCodeType ListingDuration, string ItemID, string Comments)
{
this.RecipientUserID = RecipientUserID;
this.VerifyEligibilityOnly = VerifyEligibilityOnly;
this.RecipientPostalCode = RecipientPostalCode;
this.RecipientRelationType = RecipientRelationType;
this.NegotiatedPrice = NegotiatedPrice;
this.ListingDuration = ListingDuration;
this.ItemID = ItemID;
this.Comments = Comments;
Execute();
return ApiResponse.ItemID;
}
