This root container defines a seller's fulfillment policy for a specific marketplace and category group. This type is used when creating or updating a fulfillment business policy.
Types that use FulfillmentPolicyRequest
Not used by any types.
Calls that use FulfillmentPolicyRequest
Fields
Max length: 250
true
if freight shipping is available for the item. Freight shipping can be used for large items over 150 lbs.Default: false
true
if the seller wants to use the Global Shipping Program for international shipments. See the Global Shipping Program help topic for more details and requirements on the Global Shipping Program.It is possible for a seller to use a combination of the Global Shipping Program and other international shipping services.
If this value is set to
false
or if the field is omitted, the seller is responsible for manually specifying individual international shipping services (if the seller ships internationally)., as described in Setting up worldwide shipping. Sellers can opt in or out of the Global Shipping Program through the Shipping preferences in My eBay.
Note: On the US marketplace, the Global Shipping Program is scheduled to be replaced by a new intermediated international shipping program called eBay International Shipping. US sellers who are opted in to the Global Shipping Program will be automatically opted in to eBay International Shipping when it becomes available to them. All US sellers will be migrated by March 31, 2023.
eBay International Shipping is an account level setting, and no field needs to be set in a Fulfillment business policy to enable it. As long as the US seller's account is opted in to eBay International Shipping, this shipping option will be enabled automatically for all listings where international shipping is available.
A US seller who is opted in to eBay International Shipping can also specify individual international shipping service options for a Fulfillment business policy.
Default: false
Valid values can vary by site and by category. To obtain the supported values for a site, call GeteBayDetails in the Trading API with DetailName set to
DispatchTimeMaxDetails
, then inspect the DispatchTimeMaxDetails container in the response for the time values supported by the site (typical handling times are 0
, 1
, 2
, 3
, 4
, 5
, 10
, 15
, and 20
, but these can vary by site and may change over time.) This field is conditionally required when the seller is offering one or more domestic or international shipping options, but it is not applicable when the item is only available through local pickup ("localPickup": "true"
), or if it will be shipped through a freight shipping service ("freightShipping": "true"
).
true
if local pickup is one of the fulfillment options available to the buyer. It is possible for the seller to make local pickup and some shipping service options available to the buyer.With local pickup, the buyer and seller make arrangements for pickup time and location.
Default:
false
Max length: 64
true
if the seller offers the "Click and Collect" feature for an item. To enable "Click and Collect" on a listing, a seller must be eligible for Click and Collect. Currently, Click and Collect is available to only large retail merchants selling in the eBay AU and UK marketplaces.
In addition to setting this field to true
, the merchant must also do the following to enable the "Click and Collect" option on a listing:
- Have inventory for the product at one or more physical stores tied to the merchant's account.
Sellers can use the createInventoryLocation method in the Inventory API to associate physical stores to their account and they can then can add inventory to specific store locations.
- Set an immediate payment requirement on the item. The immediate payment feature requires the seller to:
- Set the immediatePay flag in the payment policy to 'true'.
- Have a valid store location with a complete street address.
When a merchant successfully lists an item with Click and Collect, prospective buyers within a reasonable distance from one of the merchant's stores (that has stock available) will see the "Available for Click and Collect" option on the listing, along with information on the closest store that has the item.
Default: falseA separate ShippingOption object is required for domestic shipping service options and for international shipping service options (if the seller ships to international locations).
- The optionType field is used to indicate whether the ShippingOption object applies to domestic or international shipping, and the costType field is used to indicate whether flat-rate shipping or calculated shipping will be used.
- The rateTableId field can be used to associate a defined shipping rate table to the policy, and the packageHandlingCost container can be used to set a handling charge for the policy.
A separate ShippingServices object will be used to specify cost and other details for every available domestic and international shipping service option.
Note: Any shipping exclusions specified through this container can be overridden by the eBay International Shipping exclusions toggle located under Shipping Preferences in My eBay. For more information on eBay International Shipping, see eBay International Shipping program.
To retrieve the valid geographical shipping region values, two-digit country values, or special domestic regions for an eBay marketplace, call GeteBayDetails with DetailName value set to
ExcludeShippingLocationDetails
, then review the ExcludeShippingLocationDetails containers in the response for the strings you use in both the regionIncluded.regionName and in the regionExcluded.regionName fields. For valid geographical region names, look for the
ExcludeShippingLocationDetails
containers in the GeteBayDetails response where the Region value is Worldwide
, and the valid values will be shown in the corresponding Location fields. For valid two-digit country codes, look for
ExcludeShippingLocationDetails
in the GeteBayDetails response where the Region value is one of the defined geographical regions, and the valid values will be shown in the corresponding Location fields. Alternatively, you can find the two-digit country code values in the CountryCodeEnum type definition. For valid domestic region values, look for ExcludeShippingLocationDetails
in the GeteBayDetails response where the Region value is either Domestic Location
or Additional Locations
, and the valid values will be shown in the corresponding Location fields. The
STATE_OR_PROVINCE
region type is only applicable to the US and Canada, and valid values for US states are the same two-digit abbreviations used by the United States Postal Service, and valid values for Canadian provinces and territories are the same two-digit abbreviations used by the Canada Post.