InventoryLocationFull

location

This required container is used to set the physical address and geographical coordinates of a warehouse, store, or fulfillment center inventory location. A warehouse location only requires the postal code and country OR city, province/state, and country, and does not require a full street address. However, the seller may still supply a full street address for a warehouse location. A complete address (addressLine1, city, stateOrProvince, postalCode, and country) is required for store and fulfillment center locations.

Note: For fulfillment center locations, the addressLine1, stateOrProvince, country and postalCode fields cannot be changed once they have been set, though they can be added through the updateInventoryLocation method if they were omitted during location creation.

locationAdditionalInformation

This text field is used by the merchant to provide additional information about an inventory location.

Max length: 256

locationInstructions

This text field is generally used by the merchant to provide special pickup instructions for a store inventory location. Although this field is optional, it is recommended that merchants provide this field to create a pleasant and easy pickup experience for In-Store Pickup and Click and Collect orders. If this field is not included in the call request payload, eBay will use the default pickup instructions contained in the merchant's profile (if available).

locationTypes

array of StoreTypeEnum

This container is used to define the function of the inventory location. Typically, an inventory location will serve as a store, warehouse, or fulfillment center, but in some cases, an inventory location may be more than one type.

For In-Store Pickup inventory, set StoreTypeEnum to STORE.

To utilize the Multi-warehouse program, set StoreTypeEnum to FULFILLMENT_CENTER.

If this container is omitted, the location type of the inventory location will default to WAREHOUSE. See StoreTypeEnum for the supported values.

Default: WAREHOUSE

locationWebUrl

This text field is used by the merchant to provide the Website address (URL) associated with the inventory location.

Max length: 512

merchantLocationStatus

This field is used to indicate whether the inventory location will be enabled (inventory can be loaded to location) or disabled (inventory can not be loaded to location). If this field is omitted, a successful createInventoryLocation call will automatically enable the location. A merchant may want to create a new location but leave it as disabled if the location is not yet ready for active inventory. Once the location is ready, the merchant can use the enableInventoryLocation call to enable a location that is in a disabled state.

See StatusEnum for the supported values.

Default: ENABLED

name

The seller-defined name of the inventory location. This name should be a human-friendly name as it will be displayed in In-Store Pickup and Click and Collect listings. A name is not required for warehouse locations. For store locations, this field is not immediately required, but will be required before an offer enabled with the In-Store Pickup or Click and Collect capability can be published. So, if the seller omits this field in a createInventoryLocation call, it becomes required for an updateInventoryLocation call.

Max length: 1000

operatingHours

array of OperatingHours

This container is used to express the regular operating hours for a store location during each day of the week. A dayOfWeekEnum field and an intervals container will be needed for each day of the week that the store location is open.

Although not technically required, this container is highly recommended to be used to specify operating hours for a store location.

phone

This field is used to specify the phone number for an inventory location.

Max length: 36

specialHours

array of SpecialHours

This container is used to express the special operating hours for a store inventory location on a specific date, such as a holiday. The special hours specified for the specific date will override the normal operating hours for that particular day of the week.

timeZoneId

This field specifies the time zone of the inventory location being created. This value should be in Olson format (for example America/Vancouver). For supported values, see Java Supported Zone Ids and Offsets.

Note: If specified, this time zone will be used for all hour related fields. If this field is not specified for a fulfillment center location, the time zone will be calculated from the provided address fields.

fulfillmentCenterSpecifications

This container is used to specify information about a fulfillment center's shipping specifications, such as the weekly cut-off time schedule for order handling and any cut-off time overrides.

Note: This container is required if one of the locationTypes of the inventory location is FULFILLMENT_CENTER, and is not applicable to other location types.