Update Return Draft

PUT /post-order/v2/return/draft/{draftId}

Use this method to update an existing return request draft. All applicable data fields in the returnRequest container must be passed in, even if they are not being modified.

This method is not supported in the Sandbox environment.

Input

Resource URI (production)

PUT https://api.ebay.com/post-order/v2/return/draft/{draftId}

URI parameters

Parameter	Type	Required?	Meaning
draftId	string	Required	The unique eBay-assigned ID of the return request draft. This identifier is included as part of the call URI and identifies the return request draft to update.

HTTP request headers

All requests made to eBay REST operations require you to provide the authorization HTTP header for authentication.
See HTTP request headers for details.

Authorization

This call uses standard authorization tokens. See Making a Call for details.

Payload model

The following lists all fields that could be included in the request.

{ /* SetReturnCreationSessionRequest */
"returnRequest":
    { /* ReturnRequestType */
    "carrier": string,
    "comments":
        { /* Text */
        "content": string,
        "language": string,
        "translatedFromContent": string,
        "translatedFromLanguage": string
        },
    "itemId": string,
    "reason": string,
    "requestType": string,
    "returnQuantity": integer,
    "transactionId": string,
    "type": string
    }
}

Request field descriptions

Input Container/Field	Type	Occurrence	Meaning
returnRequest	ReturnRequestType	Required	This container is used in the POST /post-order/v2/return/draft and PUT /post-order/v2/return/draft/{draftId} methods to provide details about the buyer's return request, including the order line item (and quantity) that is being returned and the reason for the return. If an existing return request draft is being updated with the PUT /post-order/v2/return/draft/{draftId} method, all fields of the returnRequest must be included in the method, not just the fields whose values are changing.
returnRequest.carrier	string	Optional	This enumeration value indicates the shipping carrier that will be used to ship the return item. The supported enumeration values representing shipping carriers are defined in the ShippingCarrierEnum type definition. Applicable values: See ShippingCarrierEnum
returnRequest.comments	Text	Optional	This container is used if the buyer wants to add a note or explanation about why the return request was created.
returnRequest.comments.content	string	Conditional	This field displays the actual textual content in the language specified in the language field. This field is always used for containers using the Text type.
returnRequest.comments .language	string	Conditional	This two-letter code indicates the language used to display the content in the content field. The language will default to the language used on the eBay site if a specific language is not specified through the Accept-Language HTTP header. This field is always used for containers using the Text type. The full list of language enumeration values are defined in the LanguageEnum type definition. Applicable values: See LanguageEnum
returnRequest.comments .translatedFromContent	string	Conditional	If language translation/localization is required, this field displays the actual textual content in the language specified in the translatedFromLanguage field. If language translation was not required, this field is not applicable.
returnRequest.comments .translatedFromLanguage	string	Conditional	If language translation/localization is required, this two-letter code indicates the language used to display the content in the translatedFromContent field. If language translation was not required, this field is not applicable. The full list of language enumeration values are defined in the LanguageEnum type definition. Applicable values: See LanguageEnum
returnRequest.itemId	string	Required	The unique identifier of the eBay listing where the item was purchased. This field is used in conjunction with the transactionId field to identify a line item within an order.
returnRequest.reason	string	Optional	This enumerated value indicates the buyer's reason for creating a return request or draft. The supported enumeration values representing valid return reasons are defined in the ReturnReasonEnum type definition. Applicable values: See ReturnReasonEnum
returnRequest.requestType	string	Required	This enumeration value indicates if the return request is an actual return request or a return draft. Applicable values are from RequestTypeEnum: CREATE Indicates the request is for a return request draft. REQUEST Indicates the request is for a return request. UNKNOWN Indicates that it's undetermined if the request is for a return request or a return request draft.
returnRequest.returnQuantity	integer	Optional	This integer value indicates the quantity of the line item being returned. This number is generally `1`, unless the buyer bought multiple quantity of the item in a multiple-quantity, fixed-price listing. This value defaults to `1` if this field is omitted when a return is created.
returnRequest.transactionId	string	Required	The unique identifier for the purchase of a item. This value is created right when the buyer is committed to buying the item, whether that buyer uses a 'Buy it Now' capability, is the winning bidder of an auction, or the buyer's Best Offer is accepted by the seller. This field is used in conjunction with the itemId field to identify a line item within an order.
returnRequest.type	string	Optional	This enumeration value indicates the buyer's desired outcome. Note: Currently, `MONEY_BACK` is the only supported value. Default:: `MONEY_BACK` Applicable values are from ReturnTypeEnum: EXCHANGE Note: This value is deprecated. MONEY_BACK This enumeration value indicates that the buyer is seeking a full refund after returning the item. REPLACEMENT This enumeration value indicates that the buyer is seeking a replacement item after returning the item. Note: This value is not currently supported. UNKNOWN Note: This value is deprecated.

Output

Payload model

Note: For information about the error fields and how to work with them, see Error Handling.

The following lists all fields that could be included in the response.

Supported response formats: application/json, application/xml

For more information:
- See SetReturnCreationSessionResponse for a description of the response structure
- See the following table for descriptions of each of the data elements returned
- See the Samples for an example of the response format

{ /* SetReturnCreationSessionResponse */
"draftId": integer
}

Response field descriptions

Output Container/Field	Type	Occurrence	Meaning
draftId	integer	Conditionally	The unique eBay-assigned ID of a new return request draft that was created with the POST /post-order/v2/return/draft method, or an existing draft that was updated with the PUT /post-order/v2/return/draft/{draftId} method.

null

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.

Sample: Create a return

This operation updates a return draft.

Description

This buyer-facing call updates an existing return draft. When using this call, all applicable fields must be supplied in the request payload, even if the exiting values for the draft are not being modified.

Input

Identify the return draft you are updating by supplying the draft ID as a path parameter. Include and supply values for all applicable fields, not just those fields whose values are being updated from the existing draft. The itemId and transactionId values must match the order line item that is part of the existing return draft or an error will occur.

URL format. See also the non-wrapped version of this URL.

PUT https://api.ebay.com/post-order/v2/return/draft/5*******0

{ 
"returnRequest":
    { 
    "itemId": "1**********2",
    "transactionId": "8********4",
    "returnQuantity": "1",
    "reason": "ORDERED_WRONG_ITEM",
    "type": "MONEY_BACK",
    "carrier": "USPS",
    "comments":
        { 
        "content": "I ordered the wrong item."
        }
    }
}

Output

The call returns the draftId value.

JSON format.
{ 
"draftId": 5*******0
}

Change History

Change Date	Description