provideSellerInfo

This call is used by the seller to provide a Return Merchandise Authorization number to the buyer, or an alternative return shipping address to the buyer who is returning an item. In this case, an "alternative" shipping address is one other than the seller's primary return address on file.

Request Details

In the provideSellerInfo request, the seller must provide the return ID for the return for which a Return Merchandise Authorization number or alternative return shipping address will be provided. If not already known, the return ID can be retrieved with a call to getUserReturns.

The seller inputs the Return Merchandise Authorization number in the returnMerchandiseAuthorization field.

To provide the buyer with an alternative return address, the returnAddress container must be used. The street1, city, stateOrProvince, and postalCode are the required child fields. The name, country, and street2 fields are optional child fields. The county field is not always applicable.

Working with the Response

The response for provideSellerInfo includes the standard fields for a successful call, which are timestamp and version. If they occur, errors and/or warnings will be returned in an errorMessage container.

Input

See also Samples.

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

<?xml version="1.0" encoding="utf-8"?>
<provideSellerInfoRequest xmlns="http://www.ebay.com/marketplace/returns/v1/services">
  <!-- Call-specific Input Fields -->
  <returnAddress> Address
    <city> string </city>
    <country> string </country>
    <county> string </county>
    <name> string </name>
    <postalCode> string </postalCode>
    <stateOrProvince> string </stateOrProvince>
    <street1> string </street1>
    <street2> string </street2>
  </returnAddress>
  <ReturnId> ReturnIdType
    <id> string </id>
  </ReturnId>
  <returnMerchandiseAuthorization> string </returnMerchandiseAuthorization>
</provideSellerInfoRequest>

Output

See also Samples.

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are not returned (or soon will not be returned) or are not operational (or soon will be non-operational).

<?xml version="1.0" encoding="utf-8"?>
<provideSellerInfoResponse xmlns="http://www.ebay.com/marketplace/returns/v1/services">
  <!-- (No call-specific Output fields) -->

  <!-- Standard Output Fields -->
  <ack> AckValue </ack>
  <errorMessage> ErrorMessage
    <error> ErrorData
      <category> ErrorCategory </category>
      <domain> string </domain>
      <errorId> long </errorId>
      <exceptionId> token </exceptionId>
      <message> string </message>
      <parameter name="string"> ErrorParameter (string) </parameter>
      <!-- ... more parameter values allowed here ... -->
      <severity> ErrorSeverity </severity>
      <subdomain> string </subdomain>
    </error>
    <!-- ... more error nodes allowed here ... -->
  </errorMessage>
  <timestamp> dateTime </timestamp>
  <version> string </version>
</provideSellerInfoResponse>

Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

This call is used by a seller to provide a Return Merchandise Authorization number and a return shipping address to the buyer who is returning an item.

Description

This provideSellerInfo call sample is used by a seller to provide a Return Merchandise Authorization number and a return shipping address to the buyer, who is requesting this information before returning the item.

Note that Return Merchandise Authorization numbers cannot be verified, so the seller should be careful in ensuring that an accurate number is provided to the buyer.

This call only returns the standard output fields to indicate a successful call.

Input

A seller provides a Return Merchandise Authorization number to the buyer using the returnMerchandiseAuthorization field, and a return shipping address using the returnAddress container.

The return ID is 5********0, so this Return Merchandise Authorization number applies to the item being returned.

SOAP format. Also available is the XML equivalent.

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ser="http://www.ebay.com/marketplace/returns/v1/services">
   <soap:Header/>
   <soap:Body>
      <ser:provideSellerInfoRequest>
         <ser:ReturnId>
            <ser:id>5********0</ser:id>
         </ser:ReturnId>
         <ser:returnMerchandiseAuthorization>t********3</ser:returnMerchandiseAuthorization>
         <ser:returnAddress>
           <ser:name>A********r</ser:name>
           <ser:street1>1********t</ser:street1>
           <ser:street2>S********0</ser:street2>
           <ser:city>S********e</ser:city>
           <ser:county>S********a</ser:county>
           <ser:stateOrProvince>**</ser:stateOrProvince>
           <ser:country>US</ser:country>
           <ser:postalCode>9***9</ser:postalCode>
         </ser:returnAddress>
      </ser:provideSellerInfoRequest>
   </soap:Body>
</soap:Envelope>

Output

The seller's call is successful as indicated by the Success value in the ack field.

SOAP format. Also available is the XML equivalent.

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Header/>
   <soapenv:Body>
      <ns1:provideSellerInfoResponse xmlns="http://www.ebay.com/marketplace/services" xmlns:ns1="http://www.ebay.com/marketplace/returns/v1/services">
         <ns1:ack>Success</ns1:ack>
         <ns1:version>1.0.0</ns1:version>
         <ns1:timestamp>2011-11-06T00:55:52.572Z</ns1:timestamp>
      </ns1:provideSellerInfoResponse>
   </soapenv:Body>
</soapenv:Envelope>

   Here is the same output in XML format. Note that this does not include standard values.

XML format. Also available is the SOAP equivalent.

<?xml version="1.0" encoding="utf-8"?>
<provideSellerInfoResponse xmlns="http://www.ebay.com/marketplace/services" xmlns:ns1="http://www.ebay.com/marketplace/returns/v1/services">
   <ack>Success</ack>
   <version>1.0.0</version>
   <timestamp>2011-11-06T00:55:52.572Z</timestamp>
</provideSellerInfoResponse>
 

Change History