For full functionality of this site it is necessary to enable JavaScript.
Here are the instructions how to enable JavaScript in your web browser.

Knowledge base

Find the answer to your question

Advanced Search PView

Search terms
Search Type
Product
Category
Language
Format
SDK
Sort by
Direction

Sending Return Policy for your listing

  • Answer ID 1304
  • Published 03/11/2016 04:31 AM
  • Updated 03/11/2016 04:31 AM
  • Permalink https://ebaydts.com/eBayKBDetails?KBid=1304
Product

How to send Return Policy AddItem calls family?


Summary 

Starting in October 2008, seller is required to clearly specify if returns are accepted, and the restriction applies to most categories. To include Return Policy in a listing, you need to first find out if the category of interest requires return policy, which return policies are supported for the category and then specify Return Policy in Item.ReturnPolicy node.


Detailed Description  

   1. make GetCategoryFeatures api call and check ReturnPolicyEnabled flag to determine if ReturnPolicy is required for the category of interest, let's take the US CategoryID 2312 as an example.

   <?xml version="1.0" encoding="utf-8"?>
<GetCategoryFeaturesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <Version>585</Version>
  <ViewAllNodes>true</ViewAllNodes>
  <DetailLevel>ReturnAll</DetailLevel>
  <RequesterCredentials>
    <eBayAuthToken>xxxx</eBayAuthToken>
  </RequesterCredentials>
  <FeatureID>ReturnPolicyEnabled</FeatureID>
  <CategoryID>2312</CategoryID
>
</GetCategoryFeaturesRequest>

<?xml version="1.0" encoding="utf-8"?>
<GetCategoryFeaturesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2008-09-26T11:30:05.041Z</Timestamp>
  <Ack>Success</Ack>
  <Version>583</Version>
  <Build>e583_core_Bundled_7275746_R1</Build>
  <CategoryVersion>1712</CategoryVersion>
  <UpdateTime>2008-09-26T09:38:10.000Z</UpdateTime>
  <SiteDefaults>
    <ReturnPolicyEnabled>true</ReturnPolicyEnabled>
  </SiteDefaults>

  <FeatureDefinitions>
    <ReturnPolicyEnabled />
  </FeatureDefinitions>
</GetCategoryFeaturesResponse>

2. As shows in the GetCategoryFeaturesResponse payload, the category takes the ReturnPolicyEnabled=true the site default,  we then use GeteBayDetails API to determine the available Return Policy values:

    <?xml version="1.0" encoding="utf-8"?>
<GeteBayDetailsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <Version>585</Version>
  <RequesterCredentials>
     <eBayAuthToken>xxxx</eBayAuthToken> 
  </RequesterCredentials>
  <DetailName>ReturnPolicyDetails</DetailName>
</GeteBayDetailsRequest>

<?xml version="1.0" encoding="utf-8"?>
<GeteBayDetailsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2008-09-26T11:50:37.754Z</Timestamp>
  <Ack>Success</Ack>
  <Version>583</Version>
  <Build>e583_core_Bundled_7275746_R1</Build>
  <ReturnPolicyDetails>
    <Refund>
      <RefundOption>MoneyBack</RefundOption>
      <Description>Money Back</Description>
    </Refund>
    <Refund>
      <RefundOption>Exchange</RefundOption>
      <Description>Exchange</Description>
    </Refund>
    <Refund>
      <RefundOption>MerchandiseCredit</RefundOption>
      <Description>Merchandise Credit</Description>
    </Refund>
    <ReturnsWithin>
      <ReturnsWithinOption>Days_3</ReturnsWithinOption>
      <Description>3 Days</Description>
    </ReturnsWithin>
    <ReturnsWithin>
      <ReturnsWithinOption>Days_7</ReturnsWithinOption>
      <Description>7 Days</Description>
    </ReturnsWithin>
    <ReturnsWithin>
      <ReturnsWithinOption>Days_14</ReturnsWithinOption>
      <Description>14 Days</Description>
    </ReturnsWithin>
    <ReturnsWithin>
      <ReturnsWithinOption>Days_30</ReturnsWithinOption>
      <Description>30 Days</Description>
    </ReturnsWithin>
    <ReturnsWithin>
      <ReturnsWithinOption>Days_60</ReturnsWithinOption>
      <Description>60 Days</Description>
    </ReturnsWithin>
    <ReturnsAccepted>
      <ReturnsAcceptedOption>ReturnsAccepted</ReturnsAcceptedOption>
      <Description>Returns Accepted</Description>
    </ReturnsAccepted>
    <ReturnsAccepted>
      <ReturnsAcceptedOption>ReturnsNotAccepted</ReturnsAcceptedOption>
      <Description>Returns Not Accepted</Description>
    </ReturnsAccepted>
    <Description>true</Description>
    <ShippingCostPaidBy>
      <ShippingCostPaidByOption>Buyer</ShippingCostPaidByOption>
      <Description>Buyer</Description>
    </ShippingCostPaidBy>
    <ShippingCostPaidBy>
      <ShippingCostPaidByOption>Seller</ShippingCostPaidByOption>
      <Description>Seller</Description>
    </ShippingCostPaidBy>
  </ReturnPolicyDetails>
</GeteBayDetailsResponse>

 3. Send the ReturnPolicy options in Item.ReturnPolicy container in AddItem call as below:

  <?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <Version>581</Version>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Item>
    <Country>US</Country>
    <Currency>USD</Currency>
    <Description>TEST -  FlatSimple</Description>
    <DispatchTimeMax>3</DispatchTimeMax>
    <ListingDuration>Days_7</ListingDuration>
    <Location>San Jose, CA</Location>
    <PaymentMethods>PaymentSeeDescription</PaymentMethods>
    <PaymentMethods>PayPal</PaymentMethods>
    <PayPalEmailAddress>ve2@aol.com</PayPalEmailAddress>
    <PrimaryCategory>
      <CategoryID>2312</CategoryID>
    </PrimaryCategory>
    <Quantity>1</Quantity>
    <StartPrice>1</StartPrice>
    <BuyItNowPrice>10</BuyItNowPrice>
    <Title>ISDA TEST -  FlatSimple</Title>
    <ShippingDetails>
      <ShippingType>Flat</ShippingType>
      <ShippingServiceOptions>
        <ShippingServicePriority>1</ShippingServicePriority>
        <ShippingService>UPS2ndDay</ShippingService>
        <ShippingServiceCost>5</ShippingServiceCost>
        <ShippingServiceAdditionalCost>1</ShippingServiceAdditionalCost>
        <ShippingSurcharge>1</ShippingSurcharge>
      </ShippingServiceOptions>
    </ShippingDetails>
    <ReturnPolicy>
      <ReturnsAcceptedOption>ReturnsAccepted</ReturnsAcceptedOption>
      <RefundOption>MoneyBack</RefundOption>
      <ReturnsWithinOption>Days_30</ReturnsWithinOption>
      <Description>Text description of return policy details</Description>
      <ShippingCostPaidByOption>Buyer</ShippingCostPaidByOption>
    </ReturnPolicy>
  </Item>
  <RequesterCredentials>
    <eBayAuthToken>XXXXXXXXXXX</eBayAuthToken>
  </RequesterCredentials>
</AddItemRequest>

 

How well did this answer your question?

Answers others found helpful

Print Email This Page Delicious Digg Facebook Reddit StumbleUpon Twitter