Update Shipment Tracking Info

PUT /post-order/v2/return/{returnId}/update_tracking

This method can be used to override the current shipping carrier and/or shipment tracking number for the return item.

This method is not supported in the Sandbox environment.

Input

Resource URI (production)

PUT https://api.ebay.com/post-order/v2/return/{returnId}/update_tracking

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 shipment tracking information is being updated.

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.

{ /* UpdateTrackingRequest */
"newCarrierEnum": string,
"newCarrierName": string,
"newTrackingNumber": string,
"usedCarrierEnum": string,
"usedCarrierName": string,
"usedTrackingNumber": string
}

Request field descriptions

Input Container/Field	Type	Occurrence	Meaning
newCarrierEnum	string	Conditional	This enumeration value represents a new shipping carrier that will replace the enumeration value specified in the usedCarrierEnumfield. To update the shipping carrier, either the usedCarrierEnum and newCarrierEnum fields can be used, or the usedCarrierName and newCarrierName fields. Applicable values: See ShippingCarrierEnum
newCarrierName	string	Conditional	This string value represents a new shipping carrier that will replace the string value specified in the usedCarrierNamefield. To update the shipping carrier, either the usedCarrierName and newCarrierName fields can be used, or the usedCarrierEnum and newCarrierEnum fields.
newTrackingNumber	string	Conditional	This string value represents a new tracking number that will replace the tracking number value specified in the usedTrackingNumber field. This field, along with the usedTrackingNumber field is required if the shipment tracking number is being updated.
usedCarrierEnum	string	Conditional	This enumeration value represents the current shipping carrier being used to ship the item. To update the shipping carrier, either the usedCarrierEnum and newCarrierEnum fields can be used, or the usedCarrierName and newCarrierName fields. This enumeration value must be accurate or the shipping carrier will not be updated to the new value specified in the newCarrierEnum field. Applicable values: See ShippingCarrierEnum
usedCarrierName	string	Conditional	This string value represents the current shipping carrier being used to ship the item. To update the shipping carrier, either the usedCarrierName and newCarrierName fields can be used, or the usedCarrierEnum and newCarrierEnum fields. This value must be accurate or the shipping carrier will not be updated to the new value specified in the newCarrierName field.
usedTrackingNumber	string	Conditional	This string value represents the current tracking number of the item. This field, along with the newTrackingNumber field is required if the shipment tracking number is being updated. This tracking number must be accurate or the shipment tracking number will not be updated to the new value specified in the newTrackingNumber field.

Output

Payload model

This call has no response payload.

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: Update shipment tracking information

This call updates shipment tracking information

Description

This call allows buyer or seller to override the current shipping carrier and/or shipment tracking number for the return item or replacement item, respectively.

Input

For this call, the seller is switching shipping carriers from FedEx to USPS, so the seller must pass in the FedEx information in the usedCarrierEnum and in the usedTrackingNumber fields, and the USPS information in the newCarrierEnum and in the newTrackingNumber fields. The USPS information will override the FedEx information.

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

PUT https://api.ebay.com/post-order/v2/return/{returnId}/update_tracking
{ 
	"newCarrierEnum": "USPS",
	"newTrackingNumber": "9********************0",
	"usedCarrierEnum": "FEDEX",
	"usedTrackingNumber": "1**********4"
}

Output

There is no response payload for this call, but only an HTTP status code that indicates success.

JSON format.
No response payload

Change History

Change Date	Description