Shop(Store)

Create shop#

Creates new store

POST
/api/orgstruct/shops

Request body:

Attribute	Type	Description	Nullable
externalId	String	Shop external id	true
active	Boolean	Shop availability for users	false
regionId	Integer	Id of the region in which the store is located	false
regionExternalId	String	External id of the region in which the store is located	true
addrRegOffice	String	Address of the region in which the store is located	true
sap	String	Unique store number	false
address	String	Store address	false
locality	String	Name of store	false
city	String	The city where the store is located	false
latitude	Double	Latitude of store	false
longitude	Double	Longitude of store	false
timeZoneId	String	Id of the time zone in which the store is located (format like Europe/Moscow)	false
statusId	Integer	Status Id of the shop	true
email	String	Email of the shop	true
telegramChatId	String	TelegramChat Id of the shop	true

Response

Returns Store object

Examples

curl --request POST https://api.qvalon.com/v1/api/orgstruct/shops \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
-d '{"locality":"Store on st.Novogireevskaya","sap":"NVG01","active":true,"address":"Novogireevskaya","city":"Moscow","regionId":86,"latitude":55.756527,"longitude":37.796465,"timeZoneId":"Europe/Moscow"}'

200 OK

{
  "id": 669,
  "active": true,
  "sap": "NVG01",
  "locality": "Store on st.Novogireevskaya",
  "address": "Novogireevskaya",
  "city": "Moscow",
  "latitude": 55.756527,
  "longitude": 37.796465,
  "regionId": 86,
  "clusterId": 86,
  "timeZoneId": "Europe/Moscow"
}

Update shop#

Update existing store by id.

PUT
/orgstruct/shops/{id}

Request body:

Attribute	Type	Description	Nullable
externalId	String	Shop external id	true
active	Boolean	Shop availability for users	false
regionId	Integer	Id of the region in which the store is located	false
regionExternalId	String	External id of the region in which the store is located	true
addrRegOffice	String	Address of the region in which the store is located	true
sap	String	Unique store number	false
address	String	Store address	false
locality	String	Name of store	false
city	String	The city where the store is located	false
latitude	Double	Latitude of store	false
longitude	Double	Longitude of store	false
timeZoneId	String	Id of the time zone in which the store is located (format like Europe/Moscow)	false
statusId	Integer	Status Id of the shop	true
email	String	Email of the shop	true
telegramChatId	String	TelegramChat Id of the shop	true

Response

Returns Store object

Examples

curl --request PUT https://api.qvalon.com/v1/orgstruct/shops/669 \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
-d '{"active":true,"sap":"NVG01","locality":"Store on st.Novogireevskaya","address":"Novogireevskaya d.12","city":"Moscow","latitude":55.756527,"longitude":37.796465,"regionId":86,"timeZoneId":"Europe/Moscow"}'

200 OK

{
  "active": true,
  "sap": "NVG01",
  "locality": "Store on st.Novogireevskaya",
  "address": "Novogireevskaya d.12",
  "city": "Moscow",
  "latitude": 55.756527,
  "longitude": 37.796465,
  "regionId": 86,
  "timeZoneId": "Europe/Moscow"
}

List shops#

Return list of Shop objects

Available fields to add in object see here

GET
/orgstruct/shops

Request parameters:

Request Parameter	Type	Description	Required
fields	List of String (comma-separated)	Add additional fields to response object	false
active	Boolean	Return only active shops	false
ids	List of integers	Find shops by ids	false
region	List of integers	Find shops by region ids	false
division	List of integers	Find shops by division ids	false
sapLike	String	Find shops by SAP(store number) like	false
localityLike	String	Find shops by name like	false
cityLike	String	Find shops by city like	false
addressLike	String	Find shops by address like	false
searchString	String	Find shop by sap, name or division name or region name or city or address or manager of shop first or last name	true
status	Integer	Find shops by status	true
director	Boolean	Get shops where appointed are manager	true
allDay	Boolean	Get convenience shops	true

Examples

curl https://api.qvalon.com/v1/orgstruct/shops \
--header 'Authorization: Bearer <your_token>'

200 OK

[
  {
    "id": 669,
    "active": true,
    "sap": "NVG01",
    "locality": "Store on st.Novogireevskaya",
    "address": "Novogireevskaya d.12",
    "city": "Moscow",
    "latitude": 55.756527,
    "longitude": 37.796465,
    "regionId": 86,
    "timeZoneId": "Europe/Moscow"
  }
]

Get shop by id#

Return list of Shop objects

Available fields to add in object see here

GET
/orgstruct/shops/{id}

Request parameters:

Request Parameter	Type	Description	Required
fields	List of String (comma-separated)	Add additional fields to response object	false

Examples

curl https://api.qvalon.com/v1/orgstruct/shops/669 \
--header 'Authorization: Bearer <your_token>'

200 OK

{
  "id": 669,
  "active": true,
  "sap": "NVG01",
  "locality": "Store on st.Novogireevskaya",
  "address": "Novogireevskaya d.12",
  "city": "Moscow",
  "latitude": 55.756527,
  "longitude": 37.796465,
  "regionId": 86,
  "timeZoneId": "Europe/Moscow"
}