This type details the shipping carrier and shipment tracking number associated with a package shipment. It also contains information about the line items shipped through the Global Shipping program.
Types that use ShipmentTrackingDetailsType:
Calls that use ShipmentTrackingDetailsType:
The seller is responsible for the accuracy of the shipment tracking number, as eBay only verifies that the tracking number is consistent with the numbering scheme used by the specified shipping carrier, but cannot verify the accuracy of the tracking number. For order management calls,
For GetOrders, GetSellerTransactions, and GetItemTransactions only: This field is only returned if a valid tracking number is set. With the exception of the GetSellerTransactions (where it is only returned to the seller and not buyer), the tracking number will only be returned to the seller or buyer. If a user is using a Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, this field is returned to third parties, but the string value returned in the field will be
Note: The Trading API only supports alphanumeric characters for shipment tracking numbers, and any other characters are not supported, including spaces, hyphens, and all other special characters. Users should not enter spaces even if spaces are shown for the tracking number on the shipping label.
When the site ID is Austria, Poland, or UK, ShippingCarrierUsed can be any value, because it is not checked by eBay. For all other sites, only the following characters are allowed: letters (
A-Z), numbers (
0-9), space, and dash (
-). The site ID is specified in the CompleteSale request header.
Note: Commonly used shipping carriers can be found by calling GeteBayDetails with DetailName set to
ShippingCarrierDetails and examining the returned ShippingCarrierDetails.ShippingCarrier field. ShippingCarrierCodeType also has a list of valid shipping carriers, but eBay cannot guarantee that this enumerated type contains a full, updated list of shipping carriers. For the CompleteSale call:
- This field is not case sensitive in the CompleteSale request.
- When using UPS Mail Innovations, supply the value
UPS-MI. Buyers will subsequently be sent to the UPS Mail Innovations website for tracking status.
- When using FedEx SmartPost, supply the value
FedEx. Buyers will subsequently be sent to the FedEx web site for tracking status.