eBay Post-Order APIVersion 2.7.7
 

Submit Return File

POST /post-order/v2/return/{returnId}/file/submit

Use this method to activate the associated file(s) on the return request. A file is associated to a return request with the POST /post-order/v2/return/{returnId}/file/upload method, and those files are then activated with this method.

This method is not supported in the Sandbox environment.

Input

See also Samples.

Resource URI (production)

POST https://api.ebay.com/post-order/v2/return/{returnId}/file/submit

URI parameters

Parameter Type Required? Meaning
returnId string Required The unique eBay-assigned ID of the return request. The returnId value is required as part of the call URI to identify the return request for which files are being activated.


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.

{ /* SubmitFileRequest */
"filePurpose": string
}

Request field descriptions



Input Container/Field Type Occurrence Meaning
filePurpose string Optional The enumeration value used in this field indicates the purpose of the file(s) associated with the return request. One of the enumeration values defined in the FilePurposeEnum type definition must be used here. These files will either include information about the condition of the item, proof of the refund, or shipment tracking information.

This field is optional, because it is also possible for the user to set the file's purpose when using POST /post-order/v2/return/{returnId}/file/upload method.

Applicable values are from FilePurposeEnum:

ITEM_RELATED
This enumeration value indicates that the file is intended to provide more information about the item. For example, in a case where the buyer and seller are in disagreement over the condition of the item, the buyer or seller may provide a photo of the item that visually shows the condition of the item.
LABEL_RELATED
This enumeration value indicates that the file is intended to provide more information about a shipping label or shipment tracking information. For example, in a case where the buyer and seller are in disagreement over whether shipment tracking information has been provided or not, the buyer or seller may provide a photo of the shipping label itself, or they may provide a file that proves a package has been shipped or delivered.
REFUND_RELATED
This enumeration value indicates that the file is intended to provide more information about a buyer refund. For example, in a case where the buyer is saying that they have not recieved their refund, the seller may provide a file that proves that a refund has been issued.
UNKNOWN
This enumeration value should not be used in a Submit/Upload File request, but it is possible that this value may get returned in a response if the purpose of the file is not known.

Output

See also Samples.

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

{ /* SubmitFileResponse */
"removedFileIds": [
    string
    /* More string nodes here */
  ]
}

Response field descriptions



Output Container/Field Type Occurrence Meaning
removedFileIds array of string Conditionally This container is an array of one or more associated files that were removed from a return request or return request draft.
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: Basic Call

Activate a proof file on a return request

Description

This call is used to activate a proof file that is associated with the return request. Proof files may included a picture of a damaged or 'not as described' item, or an image file of a shipment tracking number.

Input

The user passes in the returnId as a path parameter in the URI of the call. In the request payload, the seller passes in ITEM_RELATED in the filePurpose field to indicated that the proof file is related to the condition of the item.

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

POST https://api.ebay.com/post-order/v2/return/5********2/file/submit

{ 
"filePurpose": ITEM_RELATED
}

Output

A successful call contains an HTTP status code of 200.

JSON format.
SAMPLE COMING SOON



Change History

Change Date Description