Skip to main content

How to set up shipping carrier and shipping service values

To determine the acceptable shippingCarrierCode and shippingServiceCode values you can use for any given marketplace, call GeteBayDetails (in the Trading API) and set DetailName to ShippingServiceDetails. Be sure to target the appropriate marketplace when you call GeteBayDetails.

The response to GeteBayDetails contains a set of ShippingServiceDetails objects, with each object describing a specific shipping service that's applicable to the target marketplace. To select any of the returned shipping services, use the value from the ShippingCarrier field in the fulfillment policy's shippingCarrierCode field, and use the associated value in the ShippingService field for the value that you set in the policy's shippingServiceCode field. Ensure that the costType that you set in the fulfillment policy is supported by your selected shipping service, and that the value for ValidForSellingFlow in the service is set to true.

Here is an example that uses the USPS Priority Flat Rate Box service, which takes 1 to 3 days to ship, depending on the destination:

"shippingServices": [
  {
    "shippingCarrierCode": "USPS",
    "shippingServiceCode": "USPSPriorityFlatRateBox"
  }
]

The above fulfillment policy targets the EBAY_US marketplace, so the policy specifies a shipping service that delivers domestically to US addresses. Of course, if your policy targets a different marketplace, the shippingServiceCode value must be a shipping service that delivers domestically to that marketplace region.

Tip: You can quickly review the values that GeteBayDetails returns using the eBay Metadata Lookup Tool. You can configure this tool to return any of the result sets that GeteBayDetails returns for a variety of DetailName settings. The tool returns the result sets in CSV files.