eBay Post-Order APIVersion 2

Update Shipment Tracking

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

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

See also Samples.

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 identifier of the return request. The returnId value is required 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 are from ShippingCarrierEnum:See newCarrierEnum.
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 are from ShippingCarrierEnum:See usedCarrierEnum.
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

See also Samples.

Payload model

This call has no response payload.



Samples

Code samples not yet added for this call's documentation.



Change History

Change Date Description