Trading_ReturnPolicyType Class Reference
Inherits from | NSObject |
Conforms to | PicoBindable |
Declared in | Trading_ReturnPolicyType.h Trading_ReturnPolicyType.m |
Tasks
-
refundOption
Indicates how the seller will compensate the buyer for a returned item.
property
Use the ReturnPolicy.Description field to explain the policy details
(such as how quickly the seller will process the refund, whether the seller must
receive the item before processing the refund, and other useful details.).
Applicable values:
To get the applicable RefundOption values for your site,
call GeteBayDetails
with DetailName set to RefundDetails,
and then look for the ReturnPolicyDetails.Refund.RefundOption fields in the response.
RefundOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem (and
corresponding FixedPrice calls):
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this RefundOption field when listing the item,
some eBay sites may set a default value (like MoneyBack), and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
Note:
As of version 771, listings created, revised, or relisted with
deprecated RefundOption and/or
ReturnsWithinOption values (using Add/Revise/Relist
API calls) will be blocked.
For RefundOption, the deprecated values are MerchandiseCredit
and Exchange. Instead of these deprecated values, the seller must
offer a MoneyBack or a MoneyBackOrExchange refund
option. Consider using the MoneyBackOrExchange option when you have
the depth of inventory to support an exchange for a different size, color, or undamaged
unit. Otherwise, use the MoneyBack option if you have limited
inventory.
-
refund
Display string that buyer applications can use to present RefundOption in
property
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the Refund.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use RefundOption instead.) -
returnsWithinOption
The buyer can return the item within this period of time from the day they receive the item.
property
Use the ReturnPolicy.Description field to explain the policy details.
Applicable values:
To get the applicable ReturnsWithinOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.ReturnsWithin.ReturnsWithinOption fields in the response.
ReturnsWithinOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this ReturnsWithinOption field when listing the item,
some eBay sites may set a default value (like Days_14), and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
Note:
As of version 771, listings created, revised, or relisted with
deprecated RefundOption and/or
ReturnsWithinOption values (using Add/Revise/Relist
API calls) will be blocked.
For ReturnsWithinOption, the deprecated values are Days_3
and Days_7. Instead of these deprecated values, the seller must offer a
14-day, 30-day, or 60-day return window.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details. -
returnsWithin
Display string that buyer applications can use to present ReturnsWithinOption in
property
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the ReturnsWithin.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use ReturnsWithinOption instead.) -
returnsAcceptedOption
Indicates whether the seller allows the buyer to return the item.
property
This field is required when ReturnPolicy is specified.
(If you specify ReturnsNotAccepted, the View Item page may initially show the
return policy as unspecified. In a future release, the View Item page
will be updated to indicate that returns are not accepted instead.)
All sites support the ability for a seller to not accept returns.
If the seller doesn’t accept returns, the item must specifically
indicate ReturnsNotAccepted. (The return policy cannot be omitted
from the item.)
On the eBay UK and Ireland sites, business sellers must accept
returns for fixed price items (including auction items with
Buy It Now, and any other fixed price formats) when the category
requires a return policy.
On some European sites (such as eBay Germany (DE)), registered
business sellers are required to accept returns.
Your application can call GetUser to determine a user’s current
business seller status.
Note:
In order for Top Rated sellers to receive a Top Rated Plus seal for their listings,
returns must be accepted for the item (ReturnsAcceptedOption=ReturnsAccepted) and
handling time should be set to one day (Item.DispatchTimeMax=1).
Top Rated listings qualify for the greatest average boost in Best Match and
the 20 percent Final Value Fee discount. For more information on changes to eBay's
Top Rated seller program, see the
2012 Fall Seller Update page.
Applicable values:
To get the applicable ReturnsAcceptedOption values for your site, call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.ReturnsAccepted.Description fields in the response.
ReturnsAcceptedOptionsCodeType defines all the possible values.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details. -
returnsAccepted
Display string that buyer applications can use to present ReturnsAcceptedOption in
property
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the ReturnsAccepted.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use ReturnsAcceptedOption instead.) -
description
A detailed explanation of the seller’s return policy.
property
eBay uses this text string as-is in the Return Policy section of the View Item page. Avoid HTML, and avoid character entity references (such as £ or £). If you include special characters in the return policy description, use the literal UTF-8 or ISO-8559-1 character (e.g. £). -
warrantyOfferedOption
Indicates whether a warranty is offered for the item.
property
Applicable values:
To get the applicable WarrantyOfferedOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.WarrantyOffered.WarrantyOfferedOption fields in the response.
WarrantyOfferedCodeType defines all the possible values.
Note: Only the eBay India site supports this field.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this WarrantyOfferedOption field when listing the item,
the eBay India site may set a default value, and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
Note:
For the US eBay Motors limited warranty (Short-Term Service Agreement) option,
use Item.LimitedWarrantyEligible instead.
For the US eBay Motors “Is There an Existing Warranty?” option, use
Item.AttributeSetArray instead.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details. -
warrantyOffered
Display string that buyer applications can use to present WarrantyOfferedOption in
property
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the WarrantyOffered.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use WarrantyOfferedOption instead.) -
warrantyTypeOption
Indicates the source or type of the warranty, if any.
property
Applicable values:
To get the applicable WarrantyTypeOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.WarrantyType.WarrantyTypeOption fields in the response.
WarrantyTypeOptionsCodeType defines all the possible values.
Note: Only the eBay India site supports this field.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this WarrantyTypeOption field when listing the item,
the eBay India site may set a default value, and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details. -
warrantyType
Display string that buyer applications can use to present WarrantyTypeOption in
property
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the WarrantyType.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use WarrantyTypeOption instead.) -
warrantyDurationOption
The warranty period.
property
Applicable values:
To get the applicable WarrantyDurationOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.WarrantyDuration. WarrantyDurationOption fields in the response.
WarrantyDurationOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this WarrantyDurationOption field when listing the item,
the eBay India site may set a default value, and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details. -
warrantyDuration
Display string that buyer applications can use to present WarrantyDurationOption in
property
a more user-friendly format to buyers. For example, For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the WarrantyDuration.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use WarrantyDurationOption instead.) -
ean
The European Article Number (EAN) associated with the item, if any.
property
To determine if your site supports this field, call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for a ‘true’ value in the ReturnPolicyDetails.EAN field.
Only returned if the seller has specified this value in their return policy.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details. -
shippingCostPaidByOption
The party who pays the shipping cost for a returned item.
property
Use the ReturnPolicy.Description field to explain any additional details.
Applicable values:
To get the applicable ShippingCostPaidByOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.ShippingCostPaidBy.ShippingCostPaidByOption fields in the response.
ShippingCostPaidByOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this ShippingCostPaidByOption field when listing the item,
some eBay sites may set a default value (like Buyer), and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details. -
shippingCostPaidBy
Display string that buyer applications can use to present ShippingCostPaidByOption in
property
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the ShippingCostPaidBy.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use ShippingCostPaidByOption instead.) -
restockingFeeValue
Display string that indicates the restocking fee charged by the
property
seller for returned items. This value is directly related to the
RestockingFeeValueOption value, with the difference
being that applications can use RestockingFeeValue
to present the RestockingFeeValueOption value
in a more user-friendly format when used in a GUI features such as option
buttons or drop-down lists. -
restockingFeeValueOption
This enumeration value indicates the restocking fee charged by the
property
seller for returned items. In order to charge the buyer a restocking
fee when an item is returned, a US seller must input a restocking
fee value as part of the return policy.
For Add/Revise/Relist calls: To obtain the list
of applicable values, call GeteBayDetails with
DetailName set to ReturnPolicyDetails.
Then look for the list of restocking fee value options in the
ReturnPolicyDetails.RestockingFeeValue container in the
response.
For Get calls: The RestockingFeeValue
field is directly related to RestockingFeeValueOption, and
gives a user-friendly description of the restocking fee policy. -
any
(public property)
property
Properties
any
(public property)
@property (nonatomic, retain) NSMutableArray *any
Discussion
(public property)
entry type : PicoAnyElement, wrapper for primitive anyelement
Declared In
Trading_ReturnPolicyType.h
description
A detailed explanation of the seller’s return policy.
eBay uses this text string as-is in the Return Policy section of the View Item page. Avoid HTML, and avoid character entity references (such as £ or £). If you include special characters in the return policy description, use the literal UTF-8 or ISO-8559-1 character (e.g. £).
@property (nonatomic, retain) NSString *description
Discussion
A detailed explanation of the seller’s return policy.
eBay uses this text string as-is in the Return Policy section of the View Item page. Avoid HTML, and avoid character entity references (such as £ or £). If you include special characters in the return policy description, use the literal UTF-8 or ISO-8559-1 character (e.g. £).
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but does not specify this field when listing the item,
GetItem returns this as an empty node
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
ean
The European Article Number (EAN) associated with the item, if any.
To determine if your site supports this field, call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for a ‘true’ value in the ReturnPolicyDetails.EAN field.
Only returned if the seller has specified this value in their return policy.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
@property (nonatomic, retain) NSString *ean
Discussion
The European Article Number (EAN) associated with the item, if any.
To determine if your site supports this field, call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for a ‘true’ value in the ReturnPolicyDetails.EAN field.
Only returned if the seller has specified this value in their return policy.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
refund
Display string that buyer applications can use to present RefundOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the Refund.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use RefundOption instead.)
@property (nonatomic, retain) NSString *refund
Discussion
Display string that buyer applications can use to present RefundOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the Refund.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use RefundOption instead.)
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
refundOption
Indicates how the seller will compensate the buyer for a returned item.
Use the ReturnPolicy.Description field to explain the policy details
(such as how quickly the seller will process the refund, whether the seller must
receive the item before processing the refund, and other useful details.).
Applicable values:
To get the applicable RefundOption values for your site,
call GeteBayDetails
with DetailName set to RefundDetails,
and then look for the ReturnPolicyDetails.Refund.RefundOption fields in the response.
RefundOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem (and
corresponding FixedPrice calls):
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this RefundOption field when listing the item,
some eBay sites may set a default value (like MoneyBack), and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
Note:
As of version 771, listings created, revised, or relisted with
deprecated RefundOption and/or
ReturnsWithinOption values (using Add/Revise/Relist
API calls) will be blocked.
For RefundOption, the deprecated values are MerchandiseCredit
and Exchange. Instead of these deprecated values, the seller must
offer a MoneyBack or a MoneyBackOrExchange refund
option. Consider using the MoneyBackOrExchange option when you have
the depth of inventory to support an exchange for a different size, color, or undamaged
unit. Otherwise, use the MoneyBack option if you have limited
inventory.
@property (nonatomic, retain) NSString *refundOption
Discussion
Indicates how the seller will compensate the buyer for a returned item.
Use the ReturnPolicy.Description field to explain the policy details
(such as how quickly the seller will process the refund, whether the seller must
receive the item before processing the refund, and other useful details.).
Applicable values:
To get the applicable RefundOption values for your site,
call GeteBayDetails
with DetailName set to RefundDetails,
and then look for the ReturnPolicyDetails.Refund.RefundOption fields in the response.
RefundOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem (and
corresponding FixedPrice calls):
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this RefundOption field when listing the item,
some eBay sites may set a default value (like MoneyBack), and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
Note:
As of version 771, listings created, revised, or relisted with
deprecated RefundOption and/or
ReturnsWithinOption values (using Add/Revise/Relist
API calls) will be blocked.
For RefundOption, the deprecated values are MerchandiseCredit
and Exchange. Instead of these deprecated values, the seller must
offer a MoneyBack or a MoneyBackOrExchange refund
option. Consider using the MoneyBackOrExchange option when you have
the depth of inventory to support an exchange for a different size, color, or undamaged
unit. Otherwise, use the MoneyBack option if you have limited
inventory.
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
restockingFeeValue
Display string that indicates the restocking fee charged by the
seller for returned items. This value is directly related to the
RestockingFeeValueOption value, with the difference
being that applications can use RestockingFeeValue
to present the RestockingFeeValueOption value
in a more user-friendly format when used in a GUI features such as option
buttons or drop-down lists.
@property (nonatomic, retain) NSString *restockingFeeValue
Discussion
Display string that indicates the restocking fee charged by the
seller for returned items. This value is directly related to the
RestockingFeeValueOption value, with the difference
being that applications can use RestockingFeeValue
to present the RestockingFeeValueOption value
in a more user-friendly format when used in a GUI features such as option
buttons or drop-down lists.
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
restockingFeeValueOption
This enumeration value indicates the restocking fee charged by the
seller for returned items. In order to charge the buyer a restocking
fee when an item is returned, a US seller must input a restocking
fee value as part of the return policy.
For Add/Revise/Relist calls: To obtain the list
of applicable values, call GeteBayDetails with
DetailName set to ReturnPolicyDetails.
Then look for the list of restocking fee value options in the
ReturnPolicyDetails.RestockingFeeValue container in the
response.
For Get calls: The RestockingFeeValue
field is directly related to RestockingFeeValueOption, and
gives a user-friendly description of the restocking fee policy.
@property (nonatomic, retain) NSString *restockingFeeValueOption
Discussion
This enumeration value indicates the restocking fee charged by the
seller for returned items. In order to charge the buyer a restocking
fee when an item is returned, a US seller must input a restocking
fee value as part of the return policy.
For Add/Revise/Relist calls: To obtain the list
of applicable values, call GeteBayDetails with
DetailName set to ReturnPolicyDetails.
Then look for the list of restocking fee value options in the
ReturnPolicyDetails.RestockingFeeValue container in the
response.
For Get calls: The RestockingFeeValue
field is directly related to RestockingFeeValueOption, and
gives a user-friendly description of the restocking fee policy.
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
returnsAccepted
Display string that buyer applications can use to present ReturnsAcceptedOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the ReturnsAccepted.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use ReturnsAcceptedOption instead.)
@property (nonatomic, retain) NSString *returnsAccepted
Discussion
Display string that buyer applications can use to present ReturnsAcceptedOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the ReturnsAccepted.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use ReturnsAcceptedOption instead.)
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
returnsAcceptedOption
Indicates whether the seller allows the buyer to return the item.
This field is required when ReturnPolicy is specified.
(If you specify ReturnsNotAccepted, the View Item page may initially show the
return policy as unspecified. In a future release, the View Item page
will be updated to indicate that returns are not accepted instead.)
All sites support the ability for a seller to not accept returns.
If the seller doesn’t accept returns, the item must specifically
indicate ReturnsNotAccepted. (The return policy cannot be omitted
from the item.)
On the eBay UK and Ireland sites, business sellers must accept
returns for fixed price items (including auction items with
Buy It Now, and any other fixed price formats) when the category
requires a return policy.
On some European sites (such as eBay Germany (DE)), registered
business sellers are required to accept returns.
Your application can call GetUser to determine a user’s current
business seller status.
Note:
In order for Top Rated sellers to receive a Top Rated Plus seal for their listings,
returns must be accepted for the item (ReturnsAcceptedOption=ReturnsAccepted) and
handling time should be set to one day (Item.DispatchTimeMax=1).
Top Rated listings qualify for the greatest average boost in Best Match and
the 20 percent Final Value Fee discount. For more information on changes to eBay's
Top Rated seller program, see the
2012 Fall Seller Update page.
Applicable values:
To get the applicable ReturnsAcceptedOption values for your site, call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.ReturnsAccepted.Description fields in the response.
ReturnsAcceptedOptionsCodeType defines all the possible values.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
@property (nonatomic, retain) NSString *returnsAcceptedOption
Discussion
Indicates whether the seller allows the buyer to return the item.
This field is required when ReturnPolicy is specified.
(If you specify ReturnsNotAccepted, the View Item page may initially show the
return policy as unspecified. In a future release, the View Item page
will be updated to indicate that returns are not accepted instead.)
All sites support the ability for a seller to not accept returns.
If the seller doesn’t accept returns, the item must specifically
indicate ReturnsNotAccepted. (The return policy cannot be omitted
from the item.)
On the eBay UK and Ireland sites, business sellers must accept
returns for fixed price items (including auction items with
Buy It Now, and any other fixed price formats) when the category
requires a return policy.
On some European sites (such as eBay Germany (DE)), registered
business sellers are required to accept returns.
Your application can call GetUser to determine a user’s current
business seller status.
Note:
In order for Top Rated sellers to receive a Top Rated Plus seal for their listings,
returns must be accepted for the item (ReturnsAcceptedOption=ReturnsAccepted) and
handling time should be set to one day (Item.DispatchTimeMax=1).
Top Rated listings qualify for the greatest average boost in Best Match and
the 20 percent Final Value Fee discount. For more information on changes to eBay's
Top Rated seller program, see the
2012 Fall Seller Update page.
Applicable values:
To get the applicable ReturnsAcceptedOption values for your site, call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.ReturnsAccepted.Description fields in the response.
ReturnsAcceptedOptionsCodeType defines all the possible values.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
returnsWithin
Display string that buyer applications can use to present ReturnsWithinOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the ReturnsWithin.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use ReturnsWithinOption instead.)
@property (nonatomic, retain) NSString *returnsWithin
Discussion
Display string that buyer applications can use to present ReturnsWithinOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the ReturnsWithin.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use ReturnsWithinOption instead.)
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
returnsWithinOption
The buyer can return the item within this period of time from the day they receive the item.
Use the ReturnPolicy.Description field to explain the policy details.
Applicable values:
To get the applicable ReturnsWithinOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.ReturnsWithin.ReturnsWithinOption fields in the response.
ReturnsWithinOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this ReturnsWithinOption field when listing the item,
some eBay sites may set a default value (like Days_14), and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
Note:
As of version 771, listings created, revised, or relisted with
deprecated RefundOption and/or
ReturnsWithinOption values (using Add/Revise/Relist
API calls) will be blocked.
For ReturnsWithinOption, the deprecated values are Days_3
and Days_7. Instead of these deprecated values, the seller must offer a
14-day, 30-day, or 60-day return window.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
@property (nonatomic, retain) NSString *returnsWithinOption
Discussion
The buyer can return the item within this period of time from the day they receive the item.
Use the ReturnPolicy.Description field to explain the policy details.
Applicable values:
To get the applicable ReturnsWithinOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.ReturnsWithin.ReturnsWithinOption fields in the response.
ReturnsWithinOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this ReturnsWithinOption field when listing the item,
some eBay sites may set a default value (like Days_14), and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
Note:
As of version 771, listings created, revised, or relisted with
deprecated RefundOption and/or
ReturnsWithinOption values (using Add/Revise/Relist
API calls) will be blocked.
For ReturnsWithinOption, the deprecated values are Days_3
and Days_7. Instead of these deprecated values, the seller must offer a
14-day, 30-day, or 60-day return window.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
shippingCostPaidBy
Display string that buyer applications can use to present ShippingCostPaidByOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the ShippingCostPaidBy.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use ShippingCostPaidByOption instead.)
@property (nonatomic, retain) NSString *shippingCostPaidBy
Discussion
Display string that buyer applications can use to present ShippingCostPaidByOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the ShippingCostPaidBy.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use ShippingCostPaidByOption instead.)
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
shippingCostPaidByOption
The party who pays the shipping cost for a returned item.
Use the ReturnPolicy.Description field to explain any additional details.
Applicable values:
To get the applicable ShippingCostPaidByOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.ShippingCostPaidBy.ShippingCostPaidByOption fields in the response.
ShippingCostPaidByOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this ShippingCostPaidByOption field when listing the item,
some eBay sites may set a default value (like Buyer), and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
@property (nonatomic, retain) NSString *shippingCostPaidByOption
Discussion
The party who pays the shipping cost for a returned item.
Use the ReturnPolicy.Description field to explain any additional details.
Applicable values:
To get the applicable ShippingCostPaidByOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.ShippingCostPaidBy.ShippingCostPaidByOption fields in the response.
ShippingCostPaidByOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this ShippingCostPaidByOption field when listing the item,
some eBay sites may set a default value (like Buyer), and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
warrantyDuration
Display string that buyer applications can use to present WarrantyDurationOption in
a more user-friendly format to buyers. For example, For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the WarrantyDuration.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use WarrantyDurationOption instead.)
@property (nonatomic, retain) NSString *warrantyDuration
Discussion
Display string that buyer applications can use to present WarrantyDurationOption in
a more user-friendly format to buyers. For example, For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the WarrantyDuration.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use WarrantyDurationOption instead.)
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
warrantyDurationOption
The warranty period.
Applicable values:
To get the applicable WarrantyDurationOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.WarrantyDuration. WarrantyDurationOption fields in the response.
WarrantyDurationOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this WarrantyDurationOption field when listing the item,
the eBay India site may set a default value, and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
@property (nonatomic, retain) NSString *warrantyDurationOption
Discussion
The warranty period.
Applicable values:
To get the applicable WarrantyDurationOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.WarrantyDuration. WarrantyDurationOption fields in the response.
WarrantyDurationOptionsCodeType defines all the possible values.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this WarrantyDurationOption field when listing the item,
the eBay India site may set a default value, and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
warrantyOffered
Display string that buyer applications can use to present WarrantyOfferedOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the WarrantyOffered.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use WarrantyOfferedOption instead.)
@property (nonatomic, retain) NSString *warrantyOffered
Discussion
Display string that buyer applications can use to present WarrantyOfferedOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the WarrantyOffered.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use WarrantyOfferedOption instead.)
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
warrantyOfferedOption
Indicates whether a warranty is offered for the item.
Applicable values:
To get the applicable WarrantyOfferedOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.WarrantyOffered.WarrantyOfferedOption fields in the response.
WarrantyOfferedCodeType defines all the possible values.
Note: Only the eBay India site supports this field.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this WarrantyOfferedOption field when listing the item,
the eBay India site may set a default value, and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
Note:
For the US eBay Motors limited warranty (Short-Term Service Agreement) option,
use Item.LimitedWarrantyEligible instead.
For the US eBay Motors “Is There an Existing Warranty?” option, use
Item.AttributeSetArray instead.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
@property (nonatomic, retain) NSString *warrantyOfferedOption
Discussion
Indicates whether a warranty is offered for the item.
Applicable values:
To get the applicable WarrantyOfferedOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.WarrantyOffered.WarrantyOfferedOption fields in the response.
WarrantyOfferedCodeType defines all the possible values.
Note: Only the eBay India site supports this field.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this WarrantyOfferedOption field when listing the item,
the eBay India site may set a default value, and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
Note:
For the US eBay Motors limited warranty (Short-Term Service Agreement) option,
use Item.LimitedWarrantyEligible instead.
For the US eBay Motors “Is There an Existing Warranty?” option, use
Item.AttributeSetArray instead.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
warrantyType
Display string that buyer applications can use to present WarrantyTypeOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the WarrantyType.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use WarrantyTypeOption instead.)
@property (nonatomic, retain) NSString *warrantyType
Discussion
Display string that buyer applications can use to present WarrantyTypeOption in
a more user-friendly format to buyers. For example, in GetItem and
related calls, this value is usually localized and can contain spaces.
If necessary, you can predict the choice of values based on
the WarrantyType.Description options returned by GeteBayDetails.
Not applicable as input to the AddItem family of calls. (Use WarrantyTypeOption instead.)
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h
warrantyTypeOption
Indicates the source or type of the warranty, if any.
Applicable values:
To get the applicable WarrantyTypeOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.WarrantyType.WarrantyTypeOption fields in the response.
WarrantyTypeOptionsCodeType defines all the possible values.
Note: Only the eBay India site supports this field.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this WarrantyTypeOption field when listing the item,
the eBay India site may set a default value, and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
@property (nonatomic, retain) NSString *warrantyTypeOption
Discussion
Indicates the source or type of the warranty, if any.
Applicable values:
To get the applicable WarrantyTypeOption values for your site,
call GeteBayDetails
with DetailName set to ReturnPolicyDetails,
and then look for the ReturnPolicyDetails.WarrantyType.WarrantyTypeOption fields in the response.
WarrantyTypeOptionsCodeType defines all the possible values.
Note: Only the eBay India site supports this field.
For AddItem, VerifyAddItem, and RelistItem:
If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted)
but you do not pass in this WarrantyTypeOption field when listing the item,
the eBay India site may set a default value, and the seller
is obligated to honor this setting. Therefore, to avoid unexpected obligations,
the seller should set a specific value for this field.
For ReviseItem only:
If the listing has bids or sales and/or ends within 12 hours,
you can’t change this value. See the parent ReturnPolicy node description
for more details.
type : NSString, wrapper for primitive string
Declared In
Trading_ReturnPolicyType.h