Inherits from NSObject
Conforms to PicoBindable
Declared in Trading_ReturnPolicyType.h
Trading_ReturnPolicyType.m

Overview

Type for the return policy details of an item.

@ingroup EBayAPIInterface

Tasks

  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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
  •   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