createLocation
post
/ccadmin/v1/locations
Create Location. Create a location.
Request
Supported Media Types
- application/json
Root Schema : createLocation_request
Type:
Show Source
object
-
address1(optional):
string
The first address field of the location.
-
address2(optional):
string
The second address field of the location.
-
address3(optional):
string
The third address field of the location.
-
city(optional):
string
The city of the location.
-
country(optional):
string
The country of the location.
-
county(optional):
string
The county of the location.
-
email(optional):
string
The email address of the location.
-
endDate(optional):
string
The end date for the location in the form of 'yyyy-MM-dd'. This is used when performing a search for inventory available from a store during a specific date range. If the search contains a specific date range, only locations that have a date that are contained within that date range will be displayed.
-
externalLocationId(optional):
string
An optional additional location ID, such as the merchant store ID. Use this if you have extra parameters for identifying your stores or locations.
-
faxNumber(optional):
string
The fax number of the location.
-
hours(optional):
string
The store opening hours. Only applicable to location type 'store'.
-
latitude(optional):
number
The latitude of the location.
-
locationId(optional):
string
The unique ID of the location. This ID will be generated if none is provided.
-
longitude(optional):
number
The longitude of the location.
-
name:
string
The name of the location.
-
phoneNumber(optional):
string
The phone number of the location.
-
postalCode(optional):
string
The postal code of the location.
-
siteGroups(optional):
array siteGroups
List of site groups. A location can be constrained to a list of site groups. If no site group is defined, the location is available on all sites.
-
sites(optional):
array sites
List of sites. A location can be constrained to a list of sites. If no site is defined, the location is available on all sites.
-
startDate(optional):
string
The start date for the location in the form of 'yyyy-MM-dd'. This is used when performing a search for inventory available from a store during a specific date range. If the search contains a specific date range, only locations that have a date that are contained within that date range will be displayed.
-
stateAddress(optional):
string
The state of the location.
-
type(optional):
string
The type of location, either 'location' (default) or 'store'.
Example:
{
"country":"USA",
"hours":"9:00am - 5:00pm",
"address3":null,
"endDate":"2017-04-25",
"address2":"Suite 101",
"city":"Glen Allen",
"address1":"4870 Sadler Rd.",
"latitude":37.6659833,
"postalCode":"23060",
"county":"Henrico",
"stateAddress":"VA",
"sites":[
{
"id":"siteUS"
},
{
"id":"siteCA"
}
],
"type":"store",
"externalLocationId":"187",
"phoneNumber":"(617) 386-1200",
"siteGroups":[
{
"id":"siteGroup1"
},
{
"id":"siteGroup2"
}
],
"locationId":"CRSHome-GlenAllen187",
"name":"CRS Home - Glen Allen #187",
"faxNumber":"(617) 386-1200",
"startDate":"2016-04-25",
"email":"store187@example.com",
"longitude":-77.5063697
}
Nested Schema : siteGroups
Type:
array
List of site groups. A location can be constrained to a list of site groups. If no site group is defined, the location is available on all sites.
Show Source
Nested Schema : sites
Type:
array
List of sites. A location can be constrained to a list of sites. If no site is defined, the location is available on all sites.
Show Source
Nested Schema : items
Type:
Show Source
object
-
id(optional):
string
The site group ID to associate this location with. The site group must already exist.
Nested Schema : items
Type:
Show Source
object
-
id(optional):
string
The site ID to associate this location with. The site must already exist.
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : createLocation_response
Type:
Show Source
object
-
address1(optional):
string
The first address field of the location.
-
address2(optional):
string
The second address field of the location.
-
address3(optional):
string
The third address field of the location.
-
city(optional):
string
The city of the location.
-
country(optional):
string
The country of the location.
-
county(optional):
string
The county of the location.
-
distance(optional):
number
A session-scoped property that contains the distance when searching for location items. Not applicable.
-
email(optional):
string
The email address of the location.
-
endDate(optional):
string
The end date for the location. This is used when performing a search for inventory available from a store during a specific date range. If the search contains a specific date range, only locations that have a date that are contained within that date range will be displayed.
-
externalLocationId(optional):
string
An optional additional location ID, such as the merchant store ID. Use this if you have extra parameters for identifying your stores or locations.
-
faxNumber(optional):
string
The fax number of the location.
-
hours(optional):
string
The store opening hours. Only applicable to location type 'store'.
-
latitude(optional):
number
The latitude of the location.
-
locationId(optional):
string
The ID of the location. This ID will be generated if none is provided.
-
longitude(optional):
number
The longitude of the location.
-
name(optional):
string
The name of the location.
-
phoneNumber(optional):
string
The phone number of the location.
-
postalCode(optional):
string
The postal code of the location.
-
repositoryId(optional):
string
The ID of the location repository item.
-
siteGroups(optional):
array siteGroups
List of site groups. A location can be constrained to a list of site groups. If no site group is defined, the location is available on all sites.
-
sites(optional):
array sites
List of sites. A location can be constrained to a list of sites. If no site is defined, the location is available on all sites.
-
startDate(optional):
string
The start date for the location. This is used when performing a search for inventory available from a store during a specific date range. If the search contains a specific date range, only locations that have a date that are contained within that date range will be displayed.
-
stateAddress(optional):
string
The state of the location.
-
type(optional):
string
The type of location, either 'location' or 'store'.
Nested Schema : siteGroups
Type:
array
List of site groups. A location can be constrained to a list of site groups. If no site group is defined, the location is available on all sites.
Show Source
Nested Schema : sites
Type:
array
List of sites. A location can be constrained to a list of sites. If no site is defined, the location is available on all sites.
Show Source
Nested Schema : items
Type:
Show Source
object
-
repositoryId(optional):
string
The site group ID associated with this location.
Nested Schema : items
Type:
Show Source
object
-
id(optional):
string
The site ID associated with this location.
-
repositoryId(optional):
string
The site repositoryId associated with this location.
Example Response (application/json)
{
"country":"USA",
"distance":null,
"endDate":"2017-04-25T00:00:00.000Z",
"city":"Glen Allen",
"latitude":37.6659833,
"postalCode":"23060",
"county":"Henrico",
"stateAddress":"VA",
"sites":[
{
"repositoryId":"siteUS",
"id":"siteUS"
},
{
"repositoryId":"siteCA",
"id":"siteCA"
}
],
"type":"store",
"locationId":"CRSHome-GlenAllen187",
"links":[
{
"rel":"self",
"href":"https://www.example.com/ccadminui/v1/locations"
}
],
"email":"store187@example.com",
"longitude":-77.5063697,
"hours":"9:00am - 5:00pm",
"address3":null,
"address2":"Suite 101",
"address1":"4870 Sadler Rd.",
"externalLocationId":"187",
"phoneNumber":"(617) 386-1200",
"siteGroups":[
{
"repositoryId":"siteGroup1"
},
{
"repositoryId":"siteGroup2"
}
],
"repositoryId":"4000345",
"name":"CRS Home - Glen Allen #187",
"faxNumber":"(617) 386-1200",
"startDate":"2016-04-25T00:00:00.000Z"
}
Default Response
The error response.
The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud:
|Error Code|Description|
|------------------|------------------|
|51120|Location id string value required.|
|51111|Failed to create location.|
|51110|An internal error occurred while processing the request to create location.|
|51113|Location record already exists.|
|51112|No properties passed in to create location.|
|51115|Invalid location site property.|
|51114|Invalid location type, must be 'store' or 'location'.|
|51117|Invalid location date property (endDate and/or startDate).|
|51116|Invalid location site group property.|
|51119|Location name string value required.|
|51118|Invalid location coordinate property (latitude and/or longitude).|
Root Schema : errorModel
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
errors(optional):
array errors
An optional list of errors if multiple errors were encountered
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code
-
type(optional):
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code