openapi: 3.0.0
info:
title: eBay Account Advertising_eligibility Location API
description: The Account API gives sellers the ability to configure their eBay seller accounts, including the seller's policies (eBay business policies and seller-defined custom policies), opt in and out of eBay seller programs, configure sales tax tables, and get account information.
For details on the availability of the methods in this API, see Account API requirements and restrictions.
contact:
name: eBay Inc,
license:
name: eBay API License Agreement
url: https://go.developer.ebay.com/api-license-agreement
version: v1.9.2
servers:
- url: https://api.ebay.com{basePath}
description: Production
variables:
basePath:
default: /sell/account/v1
tags:
- name: Location
paths:
/location/{merchantLocationKey}:
get:
tags:
- Location
description: This call retrieves all defined details of the inventory location that is specified by the merchantLocationKey path parameter. The authorization HTTP header is the only required request header for this call.
A successful call will return an HTTP status value of 200 OK.
operationId: getInventoryLocation
parameters:
- name: merchantLocationKey
in: path
description: 'This path parameter specifies the unique merchant-defined key (ID) for an inventory location that is being retrieved.
Use the getInventoryLocations method to retrieve merchant location keys.
Max length: 36'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/InventoryLocationResponse'
'400':
description: Bad Request
x-response-codes:
errors:
'25804':
domain: API_INVENTORY
category: REQUEST
description: Input error. {additionalInfo}
'25805':
domain: API_INVENTORY
category: REQUEST
description: '{fieldName} Not Found.'
'404':
description: Not Found
'500':
description: Internal Server Error
x-response-codes:
errors:
'25001':
domain: API_INVENTORY
category: APPLICATION
description: System error. {additionalInfo}
security:
- api_auth:
- https://api.ebay.com/oauth/api_scope/sell.inventory.readonly
- https://api.ebay.com/oauth/api_scope/sell.inventory
post:
tags:
- Location
description: Use this call to create a new inventory location. In order to create and publish an offer (and create an eBay listing), a seller must have at least one inventory location, as every offer must be associated with a location.
Upon first creating an inventory location, only a seller-defined location identifier and a physical location is required, and once set, these values can not be changed. The unique identifier value (merchantLocationKey) is passed in at the end of the call URI. This merchantLocationKey value will be used in other Inventory Location calls to identify the inventory location to perform an action against.
At this time, location types are either warehouse or store. Warehouse locations are used for traditional shipping, and store locations are generally used by US merchants selling products through the In-Store Pickup program, or used by UK, Australian, and German merchants selling products through the Click and Collect program. A full address is required for store inventory locations. However, for warehouse inventory locations, a full street address is not needed, but the city, state/province, and country of the location must be provided.
Note that all inventory locations are "enabled" by default when they are created, and you must specifically disable them (by passing in a value of DISABLED in the merchantLocationStatus field) if you want them to be set to the disabled state. The seller's inventory cannot be loaded to inventory locations in the disabled state.
Unless one or more errors and/or warnings occur with the call, there is no response payload for this call. A successful call will return an HTTP status value of 204 No Content.
operationId: createInventoryLocation
parameters:
- name: merchantLocationKey
in: path
description: 'This path parameter specifies the unique, seller-defined key (ID) for an inventory location.
Max length: 36'
required: true
schema:
type: string
- name: Content-Type
in: header
description: This header indicates the format of the request body provided by the client. Its value should be set to application/json.
For more information, refer to HTTP request headers.
required: true
schema:
type: string
requestBody:
description: Inventory Location details
content:
application/json:
schema:
description: Inventory Location details
$ref: '#/components/schemas/InventoryLocationFull'
required: true
responses:
'204':
description: No Content
'400':
description: Bad Request
x-response-codes:
errors:
'25800':
domain: API_INVENTORY
category: REQUEST
description: Invalid {fieldName}.
'25801':
domain: API_INVENTORY
category: REQUEST
description: Missing field {fieldName}.
'25802':
domain: API_INVENTORY
category: REQUEST
description: Input error. {additionalInfo}
'25803':
domain: API_INVENTORY
category: REQUEST
description: '{fieldName} already exists.'
'25804':
domain: API_INVENTORY
category: REQUEST
description: Input error. {additionalInfo}
'409':
description: Location Already Exists
'500':
description: Internal Server Error
x-response-codes:
errors:
'25001':
domain: API_INVENTORY
category: APPLICATION
description: System error. {additionalInfo}
security:
- api_auth:
- https://api.ebay.com/oauth/api_scope/sell.inventory
delete:
tags:
- Location
description: This call deletes the inventory location that is specified in the merchantLocationKey path parameter. Note that deleting a location will not affect any active eBay listings associated with the deleted location, but the seller will not be able modify the offers associated with the inventory location once it is deleted.
The authorization HTTP header is the only required request header for this call.
Unless one or more errors and/or warnings occur with the call, there is no response payload for this call. A successful call will return an HTTP status value of 200 OK.
operationId: deleteInventoryLocation
parameters:
- name: merchantLocationKey
in: path
description: 'This path parameter specifies the unique merchant-defined key (ID) for the inventory location that is to be deleted.
Use the getInventoryLocations method to retrieve merchant location keys.
Max length: 36'
required: true
schema:
type: string
responses:
'204':
description: Success
'400':
description: Bad Request
x-response-codes:
errors:
'25802':
domain: API_INVENTORY
category: REQUEST
description: Input error. {additionalInfo}
'25804':
domain: API_INVENTORY
category: REQUEST
description: Input error. {additionalInfo}
'25805':
domain: API_INVENTORY
category: REQUEST
description: '{fieldName} Not Found.'
'404':
description: Not Found
'500':
description: Internal Server Error
x-response-codes:
errors:
'25001':
domain: API_INVENTORY
category: APPLICATION
description: System error. {additionalInfo}
security:
- api_auth:
- https://api.ebay.com/oauth/api_scope/sell.inventory
/location/{merchantLocationKey}/disable:
post:
tags:
- Location
description: This call disables the inventory location that is specified in the merchantLocationKey path parameter. Sellers can not load/modify inventory to disabled inventory locations. Note that disabling an inventory location will not affect any active eBay listings associated with the disabled location, but the seller will not be able modify the offers associated with a disabled inventory location.
A successful call will return an HTTP status value of 200 OK.
operationId: disableInventoryLocation
parameters:
- name: merchantLocationKey
in: path
description: 'This path parameter specifies the unique merchant-defined key (ID) for an inventory location that is to be disabled.
Use the getInventoryLocations method to retrieve merchant location keys.
Max length: 36'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request
x-response-codes:
errors:
'25802':
domain: API_INVENTORY
category: REQUEST
description: Input error. {additionalInfo}
'25804':
domain: API_INVENTORY
category: REQUEST
description: Input error. {additionalInfo}
'25805':
domain: API_INVENTORY
category: REQUEST
description: '{fieldName} Not Found.'
'404':
description: Not Found
'500':
description: Internal Server Error
x-response-codes:
errors:
'25001':
domain: API_INVENTORY
category: APPLICATION
description: System error. {additionalInfo}
security:
- api_auth:
- https://api.ebay.com/oauth/api_scope/sell.inventory
/location/{merchantLocationKey}/enable:
post:
tags:
- Location
description: This call enables a disabled inventory location that is specified in the merchantLocationKey path parameter. Once a disabled inventory location is enabled, sellers can start loading/modifying inventory to that inventory location.
A successful call will return an HTTP status value of 200 OK.
operationId: enableInventoryLocation
parameters:
- name: merchantLocationKey
in: path
description: 'This path parameter specifies unique merchant-defined key (ID) for a disabled inventory location that is to be enabled.
Use the getInventoryLocations method to retrieve merchant location keys.
Max length: 36'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request
x-response-codes:
errors:
'25802':
domain: API_INVENTORY
category: REQUEST
description: Input error. {additionalInfo}
'25804':
domain: API_INVENTORY
category: REQUEST
description: Input error. {additionalInfo}
'25805':
domain: API_INVENTORY
category: REQUEST
description: '{fieldName} Not Found.'
'404':
description: Not Found
'500':
description: Internal Server Error
x-response-codes:
errors:
'25001':
domain: API_INVENTORY
category: APPLICATION
description: System error. {additionalInfo}
security:
- api_auth:
- https://api.ebay.com/oauth/api_scope/sell.inventory
/location:
get:
tags:
- Location
description: This call retrieves all defined details for every inventory location associated with the seller's account. There are no required parameters for this call and no request payload. However, there are two optional query parameters, limit and offset. The limit query parameter sets the maximum number of inventory locations returned on one page of data, and the offset query parameter specifies the page of data to return. These query parameters are discussed more in the URI parameters table below. The authorization HTTP header is the only required request header for this call.
A successful call will return an HTTP status value of 200 OK.
operationId: getInventoryLocations
parameters:
- name: limit
in: query
description: 'The value passed in this query parameter sets the maximum number of records to return per page of data. Although this field is a string, the value passed in this field should be a positive integer value. If this query parameter is not set, up to 100 records will be returned on each page of results.
Min: 1'
required: false
schema:
type: string
- name: offset
in: query
description: Specifies the number of locations to skip in the result set before returning the first location in the paginated response. Combine offset with the limit query parameter to control the items returned in the response. For example, if you supply an offset of 0 and a limit of 10, the first page of the response contains the first 10 items from the complete list of items retrieved by the call. If offset is 10 and limit is 20, the first page of the response contains items 11-30 from the complete result set.
Default: 0
required: false
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/LocationResponse'
'400':
description: Bad Request
'500':
description: Internal Server Error
x-response-codes:
errors:
'25001':
domain: API_INVENTORY
category: APPLICATION
description: System error. {additionalInfo}
security:
- api_auth:
- https://api.ebay.com/oauth/api_scope/sell.inventory.readonly
- https://api.ebay.com/oauth/api_scope/sell.inventory
/location/{merchantLocationKey}/update_location_details:
post:
tags:
- Location
description: 'Use this call to update non-physical location details for an existing inventory location. Specify the inventory location you want to update using the merchantLocationKey path parameter.
You can update the following text-based fields: name, phone, locationWebUrl, locationInstructions and locationAdditionalInformation. Whatever text is passed in for these fields in an updateInventoryLocation call will replace the current text strings defined for these fields. For store inventory locations, the operating hours and/or the special hours can also be updated.
The merchant location key, the physical location of the store, and its geo-location coordinates can not be updated with an updateInventoryLocation call
Unless one or more errors and/or warnings occurs with the call, there is no response payload for this call. A successful call will return an HTTP status value of 204 No Content.
'
operationId: updateInventoryLocation
parameters:
- name: merchantLocationKey
in: path
description: 'This path parameter specifies the unique merchant-defined key (ID) for an inventory location that is to be updated.
Use the getInventoryLocations method to retrieve merchant location keys.
Max length: 36'
required: true
schema:
type: string
- name: Content-Type
in: header
description: This header indicates the format of the request body provided by the client. Its value should be set to application/json.
For more information, refer to HTTP request headers.
required: true
schema:
type: string
requestBody:
description: The inventory location details to be updated (other than the address and geo co-ordinates).
content:
application/json:
schema:
description: The inventory location details to be updated (other than the address and geo co-ordinates).
$ref: '#/components/schemas/InventoryLocation'
required: true
responses:
'204':
description: Success
'400':
description: Bad Request
x-response-codes:
errors:
'25800':
domain: API_INVENTORY
category: REQUEST
description: Invalid {fieldName}.
'25801':
domain: API_INVENTORY
category: REQUEST
description: Missing field {fieldName}.
'25802':
domain: API_INVENTORY
category: REQUEST
description: Input error. {additionalInfo}
'25804':
domain: API_INVENTORY
category: REQUEST
description: Input error. {additionalInfo}
'25805':
domain: API_INVENTORY
category: REQUEST
description: '{fieldName} Not Found.'
'404':
description: Not Found
'500':
description: Internal Server Error
x-response-codes:
errors:
'25001':
domain: API_INVENTORY
category: APPLICATION
description: System error. {additionalInfo}
security:
- api_auth:
- https://api.ebay.com/oauth/api_scope/sell.inventory
components:
schemas:
InventoryLocation:
type: object
properties:
locationAdditionalInformation:
type: string
description: 'This text field is used by the merchant to provide/update additional information about an inventory location. Whatever text is passed in this field will replace the current text string defined for this field. If the text will not change, the same text should be passed in once again.
Max length: 256'
locationInstructions:
type: string
description: 'This text field is generally used by the merchant to provide/update 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). Whatever text is passed in this field will replace the current text string defined for this field. If the text will not change, the same text should be passed in once again.
Max length: 1000'
locationWebUrl:
type: string
description: 'This text field is used by the merchant to provide/update the Website address (URL) associated with the inventory location. The URL that is passed in this field will replace any other URL that may be defined for this field.
Max length: 512'
name:
type: string
description: This text field is used by the merchant to update the name of the inventory location. This name should be a human-friendly name as it will be in In-Store Pickup and Click and Collect listings. A name is not required for warehouse inventory locations. For store inventory 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 omitted this field in the createInventoryLocation call, it is required for an updateInventoryLocation call. The name that is passed in this field will replace any other name that may be defined for this field.
operatingHours:
type: array
description: This container is used to provide/update the regular operating hours for a store location during the days 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. Note that if operating hours are already set for an inventory location for a specific day of the week, whatever is set through an updateInventoryLocation call will override those existing hours.
items:
$ref: '#/components/schemas/OperatingHours'
phone:
type: string
description: 'This text field is used by the merchant to provide/update the phone number for the inventory location. The phone number that is passed in this field will replace any other phone number that may be defined for this field.
Max length: 36'
specialHours:
type: array
description: This container is used to provide/update the special operating hours for a store 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. If special hours have already been set up for an inventory location, specifying special hours through an updateInventoryLocation call will only add to the list, unless the date(s) used are the same special date(s) already set up, in which case, the special hours set up through the updateInventoryLocation call will override the existing special hours.
items:
$ref: '#/components/schemas/SpecialHours'
description: This type is used by the updateInventoryLocation call to update operating hours, special hours, phone number, and other minor details of an inventory location.
InventoryLocationFull:
type: object
properties:
location:
description: This required container is used to set the physical address and geographical coordinates (optional) of a warehouse or store inventory location. A warehouse inventory location only requires the 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. The physical location/address for an inventory location cannot be modified once set with a createInventoryLocation call. All other details of an inventory location (e.g. phone or operating hours) can be changed with an updateInventoryLocation call.
$ref: '#/components/schemas/LocationDetails'
locationAdditionalInformation:
type: string
description: 'This text field is used by the merchant to provide additional information about an inventory location.
Max length: 256'
locationInstructions:
type: string
description: 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:
type: array
description: 'This container is used to define the function of the inventory location. Typically, an inventory location will serve as a store or a warehouse, but in some cases, an inventory location may be both.
For In-Store Pickup inventory set StoreTypeEnum to STORE.
If this container is omitted, the location type of the inventory location will default to WAREHOUSE. See StoreTypeEnum for the supported values.
Default: WAREHOUSE'
items:
type: string
description: ' For implementation help, refer to eBay API documentation'
locationWebUrl:
type: string
description: 'This text field is used by the merchant to provide the Website address (URL) associated with the inventory location.
Max length: 512'
merchantLocationStatus:
type: string
description: '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 inventory location. A merchant may want to create a new inventory location but leave it as disabled if the inventory location is not yet ready for active inventory. Once the inventory location is ready, the merchant can use the enableInventoryLocation call to enable an inventory location that is in a disabled state.
See StatusEnum for the supported values.
Default: ENABLED For implementation help, refer to eBay API documentation'
name:
type: string
description: '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 inventory locations. For store inventory 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:
type: array
description: Although not technically required, this container is highly recommended to be used to specify operating hours for a store inventory location. 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.
items:
$ref: '#/components/schemas/OperatingHours'
phone:
type: string
description: 'This field is used to specify the phone number for an inventory location.
Max length: 36'
specialHours:
type: array
description: 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.
items:
$ref: '#/components/schemas/SpecialHours'
description: This type is used by the createInventoryLocation call to provide details on the inventory location, including the location's name, physical address, operating hours, special hours, phone number and other details of an inventory location.
Address:
type: object
properties:
addressLine1:
type: string
description: 'The first line of a street address. This field is required for store inventory locations that will be holding In-Store Pickup inventory. A street address is not required if the inventory location is not holding In-Store Pickup Inventory.
This field will be returned if defined for an inventory location.
Max length: 128'
addressLine2:
type: string
description: 'The second line of a street address. This field can be used for additional address information, such as a suite or apartment number. A street address is not required if the inventory location is not holding In-Store Pickup Inventory.
This field will be returned if defined for an inventory location.
Max length: 128'
city:
type: string
description: 'The city in which the inventory location resides. This field is required for store inventory locations that will be holding In-Store Pickup inventory. For warehouse locations, this field is technically optional, as a postalCode can be used instead of city/stateOrProvince pair, and then the city is just derived from this postal/zip code.
This field is returned if defined for an inventory location.
Max length: 128'
country:
type: string
description: The country in which the address resides, represented as two-letter ISO 3166 country code. For example, US represents the United States, and DE represents Germany. For implementation help, refer to eBay API documentation
county:
type: string
description: The county in which the address resides.
This field is returned if defined for an inventory location.
postalCode:
type: string
description: 'The postal/zip code of the address. eBay uses postal codes to surface In-Store Pickup items within the vicinity of a buyer''s location, and it also user postal codes (origin and destination) to estimate shipping costs when the seller uses calculated shipping. A city/stateOrProvince pair can be used instead of a postalCode value, and then the postal code is just derived from the city and state/province.
This field is returned if defined for an inventory location.
Max length: 16'
stateOrProvince:
type: string
description: 'The state/province in which the inventory location resides. This field is required for store inventory locations that will be holding In-Store Pickup inventory. For warehouse locations, this field is technically optional, as a postalCode can be used instead of city/stateOrProvince pair, and then the state or province is just derived from this postal/zip code.
Max length: 128'
description: This type is used to define the physical address of an inventory location.
Location:
type: object
properties:
address:
description: The address container is always returned in getInventoryLocation/getInventoryLocations calls. Except in the case of an inventory location that supports In-Store Pickup inventory, a full address is not a requirement when setting up an inventory location.
$ref: '#/components/schemas/Address'
geoCoordinates:
description: This container displays the Global Positioning System (GPS) latitude and longitude coordinates for the inventory location. This container is only returned if the geo-coordinates are set for an inventory location.
$ref: '#/components/schemas/GeoCoordinates'
locationId:
type: string
description: A unique eBay-assigned ID for the location.
Note: This field should not be confused with the seller-defined merchantLocationKey value. It is the merchantLocationKey value which is used to identify an inventory location when working with inventory location API calls. The locationId value is only used internally by eBay.
description: A complex type that is used to provide the physical address of a location, and it geo-coordinates.
OperatingHours:
type: object
properties:
dayOfWeekEnum:
type: string
description: A dayOfWeekEnum value is required for each day of the week that the store location has regular operating hours.
This field is returned if operating hours are defined for the store location. For implementation help, refer to eBay API documentation
intervals:
type: array
description: This container is used to define the opening and closing times of a store's working day (defined in the dayOfWeekEnum field). An intervals container is needed for each day of the week that the store location is open. If a store location closes for lunch (or any other period during the day) and then reopens, multiple open and close pairs are needed
This container is returned if operating hours are defined for the store location.
items:
$ref: '#/components/schemas/Interval'
description: This type is used to express the regular operating hours of a merchant's store during the days of the week.
SpecialHours:
type: object
properties:
date:
type: string
description: A date value is required for each specific date that the store location has special operating hours.
The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock.
Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z
Example: 2018-08-04T07:09:00.000Z
This field is returned if set for the store location.
intervals:
type: array
description: This container is used to define the opening and closing times of a store on a specific date (defined in the date field). An intervals container is needed for each specific date that the store has special operating hours. These special operating hours on the specific date override the normal operating hours for the specific day of the week. If a store location closes for lunch (or any other period during the day) and then reopens, multiple open and close pairs are needed.
This container is returned if set for the store location.
items:
$ref: '#/components/schemas/Interval'
description: This type is used to express the special operating hours of a store location on a specific date. A specialHours container is needed when the store's opening hours on a specific date are different than the normal operating hours on that particular day of the week.
GeoCoordinates:
type: object
properties:
latitude:
type: number
description: The latitude (North-South) component of the geographic coordinate. This field is required if a geoCoordinates container is used.
For In-Store Pickup inventory, geographical coordinates are required.
This field is returned if geographical coordinates are set for the inventory location.
longitude:
type: number
description: The longitude (East-West) component of the geographic coordinate. This field is required if a geoCoordinates container is used.
For In-Store Pickup inventory, geographical coordinates are required.
This field is returned if geographical coordinates are set for the inventory location.
description: This type is used to express the Global Positioning System (GPS) latitude and longitude coordinates of an inventory location.
LocationDetails:
type: object
properties:
address:
description: The address container is required for a createInventoryLocation call. Except in the case of an inventory location that supports In-Store Pickup inventory, a full address is not a requirement when setting up an inventory location.
$ref: '#/components/schemas/Address'
geoCoordinates:
description: This container is used to set the Global Positioning System (GPS) latitude and longitude coordinates for the inventory location.
Geographical coordinates are required for the location of In-Store Pickup inventory.
$ref: '#/components/schemas/GeoCoordinates'
description: This type is used by the createInventoryLocation call to provide an full or partial address of an inventory location.
InventoryLocationResponse:
type: object
properties:
location:
description: This container provides location details of an inventory location. The address container will always be returned, but it will not always have a complete street address. Except in the case of an inventory location that supports In-Store Pickup inventory, a full address is not a requirement when setting up an inventory location. The geoCoordinates container will only be returned if the merchant provided geographical coordinates. The locationId field is always returned, but this value is only used internally by eBay.
$ref: '#/components/schemas/Location'
locationAdditionalInformation:
type: string
description: 'This text field provides additional information about an inventory location. This field is returned if it is set for the inventory location.
Max length: 256'
locationInstructions:
type: string
description: 'This text field is used by the merchant to provide special pickup instructions for the store location. This field can help create a pleasant and easy pickup experience for In-Store Pickup and Click and Collect orders. If this field was not set up through a createInventoryLocation or a updateInventoryLocation call, eBay will use the default pickup instructions contained in the merchant''s profile.
Max length: 1000'
locationTypes:
type: array
description: This container defines the function of the inventory location. Typically, an inventory location will serve as a store or a warehouse, but in some cases, an inventory location may be both.
For In-Store Pickup inventory set StoreTypeEnum to STORE.
The location type of an inventory location defaults to WAREHOUSE if a location type is not specified when a merchant creates an inventory location.
items:
type: string
description: ' For implementation help, refer to eBay API documentation'
locationWebUrl:
type: string
description: 'This text field shows the Website address (URL) associated with the inventory location. This field is returned if defined for the inventory location.
Max length: 512'
merchantLocationKey:
type: string
description: 'The unique identifier of the inventory location. This identifier is set up by the merchant when the inventory location is first created with the createInventoryLocation call. Once this value is set for an inventory location, it cannot be modified.
Max length: 36'
merchantLocationStatus:
type: string
description: This field indicates whether the inventory location is enabled (inventory can be loaded to location) or disabled (inventory can not be loaded to location). The merchant can use the enableInventoryLocation call to enable an inventory location in disabled status, or the disableInventoryLocation call to disable an inventory location in enabled status. For implementation help, refer to eBay API documentation
name:
type: string
description: 'The 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. For store inventory locations, this field is not required for the createInventoryLocation call, but a store inventory location must have a defined name value before an In-Store Pickup and Click and Collect enabled offer is published. So, if the seller omits this field in the createInventoryLocation call, it will have to be added later through a updateInventoryLocation call.
Max length: 1000'
operatingHours:
type: array
description: This container shows the regular operating hours for a store location during the days of the week. A dayOfWeekEnum field and an intervals container is shown for each day of the week that the store location is open.
items:
$ref: '#/components/schemas/OperatingHours'
phone:
type: string
description: 'The phone number for an inventory location. This field will typically only be set and returned for store locations.
Max length: 36'
specialHours:
type: array
description: This container shows the special operating hours for a store location on a specific date or dates.
items:
$ref: '#/components/schemas/SpecialHours'
description: This type is used by the base response of the getInventoryLocation and getInventoryLocations calls. These responses provide details about inventory location(s) defined for the merchant's account.
LocationResponse:
type: object
properties:
href:
type: string
description: The URI of the current page of results from the result set.
limit:
type: integer
description: The number of items returned on a single page from the result set.
format: int32
next:
type: string
description: 'The URI for the following page of results. This value is returned only if there is an additional page of results to display from the result set.
Max length: 2048'
offset:
type: integer
description: 'The number of results skipped in the result set before listing the first returned result. This value is set in the request with the offset query parameter. Note: The items in a paginated result set use a zero-based list where the first item in the list has an offset of 0.
'
format: int32
prev:
type: string
description: 'The URI for the preceding page of results. This value is returned only if there is a previous page of results to display from the result set.
Max length: 2048'
total:
type: integer
description: The total number of items retrieved in the result set.
If no items are found, this field is returned with a value of 0.
format: int32
locations:
type: array
description: An array of one or more of the merchant's inventory locations.
items:
$ref: '#/components/schemas/InventoryLocationResponse'
description: This type is used by the base response payload for the getInventoryLocations call.
Interval:
type: object
properties:
close:
type: string
description: 'The close value is actually the time that the store closes. Local time (in Military format) is used. So, if a store closed at 8 PM local time, the close time would look like the following: 20:00:00. This field is conditionally required if the intervals container is used to specify working hours or special hours for a store.
This field is returned if set for the store location.'
open:
type: string
description: 'The open value is actually the time that the store opens. Local time (in Military format) is used. So, if a store opens at 9 AM local time, the close time would look like the following: 09:00:00. This field is conditionally required if the intervals container is used to specify working hours or special hours for a store.
This field is returned if set for the store location.'
description: 'This type is used by the intervals container to define the opening and closing times of a store''s working day. Local time (in Military format) is used, with the following format: hh:mm:ss.'
securitySchemes:
api_auth:
type: oauth2
description: The security definitions for this API. Please check individual operations for applicable scopes.
flows:
authorizationCode:
authorizationUrl: https://auth.ebay.com/oauth2/authorize
tokenUrl: https://api.ebay.com/identity/v1/oauth2/token
scopes:
https://api.ebay.com/oauth/api_scope/sell.account.readonly: View your account settings
https://api.ebay.com/oauth/api_scope/sell.account: View and manage your account settings