eBay::API::XML::Call::AddSecondChanceItem - eBay::API::XML::Call::AddSecondChanceItem documentation

eBay-API documentation Contained in the eBay-API distribution.

Index

Code Index:

NAME

Top

eBay::API::XML::Call::AddSecondChanceItem

DESCRIPTION

Top

SYNOPSIS

Top

INHERITANCE

Top

eBay::API::XML::Call::AddSecondChanceItem inherits from the eBay::API::XML::BaseCall class

Subroutines:

Top

setBuyItNowPrice()

The amount the offer recipient must pay to purchase the item from the second chance offer listing. Use only when the original item was listed in an eBay Motors vehicle category (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. Otherwise, eBay establishes the price and no price should be submitted.

  RequiredInput: No
#    Argument: 'ns:AmountType'

setDuration()

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.

  RequiredInput: Yes
#    Argument: 'ns:SecondChanceOfferDurationCodeType'

setItemID()

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.

MaxLength: 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits)

  RequiredInput: Yes
#    Argument: 'ns:ItemIDType'

setRecipientBidderUserID()

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.

  RequiredInput: Yes
#    Argument: 'ns:UserIDType'

setSellerMessage()

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.

MaxLength: 1000

  RequiredInput: No
#    Argument: 'xs:string'

getEndTime()

Indicates the date and time when the second chance offer listing expires, at which time the listing ends (if the recipient user does not purchase the item first).

  Returned: Always
#    Returns: 'xs:dateTime'

getItemID()

Contains the item ID for the new second chance offer listing. Different from the original ItemID passed in the request.

  Returned: Always
#    Returns: 'ns:ItemIDType'

getStartTime()

Indicates the date and time when the the new second chance offer listing became active and the recipient user could purchase the item.

  Returned: Always
#    Returns: 'xs:dateTime'
eBay-API documentation Contained in the eBay-API distribution. 
#!/usr/bin/perl

package eBay::API::XML::Call::AddSecondChanceItem;

use strict;
use warnings;  

##########################################################################
#
# Module: ............... <user defined location>eBay/API/XML
# File: ................. AddSecondChanceItem.pm
# Generated by: ......... genEBayApiDataTypes.pl
# Last Generated: ....... 08/24/2008 16:44
# API Release Number: ... 579
#
##########################################################################  


use eBay::API::XML::BaseCall;
our @ISA = ("eBay::API::XML::BaseCall");

use eBay::API::XML::Call::AddSecondChanceItem::AddSecondChanceItemRequestType;
use eBay::API::XML::Call::AddSecondChanceItem::AddSecondChanceItemResponseType;



sub getApiCallName {
   return 'AddSecondChanceItem';
}
sub getRequestDataTypeFullPackage {
   return 'eBay::API::XML::Call::AddSecondChanceItem::AddSecondChanceItemRequestType';
}
sub getResponseDataTypeFullPackage {
   return 'eBay::API::XML::Call::AddSecondChanceItem::AddSecondChanceItemResponseType';
}

#
# input properties
#


       
sub setBuyItNowPrice {
   my $self   = shift;
   my $pBuyItNowPrice = shift;
   $self->getRequestDataType()->setBuyItNowPrice($pBuyItNowPrice);
}


       
sub setDuration {
   my $self   = shift;
   my $sDuration = shift;
   $self->getRequestDataType()->setDuration($sDuration);
}


       
sub setItemID {
   my $self   = shift;
   my $pItemID = shift;
   $self->getRequestDataType()->setItemID($pItemID);
}


       
sub setRecipientBidderUserID {
   my $self   = shift;
   my $pRecipientBidderUserID = shift;
   $self->getRequestDataType()->setRecipientBidderUserID($pRecipientBidderUserID);
}


       
sub setSellerMessage {
   my $self   = shift;
   my $sSellerMessage = shift;
   $self->getRequestDataType()->setSellerMessage($sSellerMessage);
}



#
# output properties
#


       
sub getEndTime {
   my $self = shift;
   return $self->getResponseDataType()->getEndTime();
}


       
sub getItemID {
   my $self = shift;
   return $self->getResponseDataType()->getItemID();
}


       
sub getStartTime {
   my $self = shift;
   return $self->getResponseDataType()->getStartTime();
}





1;