Торгові точки

Список торгових точок

Отримати список торгових точок

GET /api/outlets{?active,with,order,filters,ids_list,offset,limit,unprotect_keys}

Параметри

Параметр	Тип	Обов’язковий	Опис
active	string	ні	Якщо параметр дорівнює “true”, то повертаються лише активні записи.
with	string	ні	Список імен пов’язаних ресурсів через кому без пробілів. Зв’язки: priceLevel, workplace, groupOutlet
order	string	ні	Список полів сортування через кому без пробілів
ids_list	string	ні	Список значень ключового поля записів, які потрібно повернути. Зазначається через кому без пробілу
filters	string	ні	Текстові фільтри у форматі: field_name:: |field_name1::
offset	integer	ні	Повертати дані, починаючи з указаного номера запису
limit	integer	ні	Повертати вказану кількість записів

Відповідь 200 (application/json)

[
  {
    "id_outlet": 2,
    "name_outlet": "This is outlet",
    "id_price_level": 1,
    "id_employee": 1,
    "id_teller_setting": 1,
    "id_group_outlet": 1,
    "active": true
  }
]

Додати торгову точку

POST /api/outlets{?active,with,order,filters,ids_list,offset,limit,unprotect_keys}

• Атрибут id_outlet у JSON-і запиту ігнорується, якщо не вказано параметр unprotect_keys=true.

Параметри

Параметр	Тип	Обов’язковий	Опис
unprotect_keys	string	ні	Якщо параметр існує і дорівнює “true”, в операціях створення/редагування значення ключового поля не ігноруються

Заголовки запиту:

• Content-Type: application/json

Тіло запиту:

{
  "id_outlet": 2,
  "name_outlet": "This is outlet",
  "id_price_level": 1,
  "id_employee": 1,
  "id_teller_setting": 1,
  "id_group_outlet": 1,
  "active": true
}

Відповідь 201 (application/json)

{
  "id_group_outlet": 2,
  "name_group": "Outlets group",
  "id_owner_group": 1,
  "active": true
}

Схема:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id_group_outlet": {
      "type": "number"
    },
    "name_group": {
      "type": "string"
    },
    "id_owner_group": {
      "type": "number"
    },
    "active": {
      "type": "boolean"
    }
  },
  "required": [
    "id_group_outlet",
    "name_group",
    "active"
  ]
}

Кількість торгових точок

Отримати кількість торгових точок

GET /api/outlets/count{?filters,ids_list,active}

Параметри

Параметр	Тип	Обов’язковий	Опис
ids_list	string	ні	Список значень ключового поля записів, які потрібно повернути. Зазначається через кому без пробілу
filters	string	ні	Текстові фільтри у форматі: field_name:: |field_name1::
active	string	ні	Якщо параметр дорівнює “true”, то враховуються лише активні записи.

Відповідь 200 (application/json)

{
  "count": 10
}

Схема:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "count": {
      "type": "number"
    }
  },
  "required": [
    "count"
  ]
}

Торгова точка

Отримати дані про торгову точку

GET /api/outlets/{id_outlet}/{?unprotect_keys,with}

Параметри

Параметр	Тип	Обов’язковий	Опис
id_outlet	integer	так	Код торгової точки
with	string	ні	Список імен пов’язаних ресурсів через кому без пробілів. Зв’язки: priceLevel, workplace, groupOutlet

Відповідь 200 (application/json)

{
  "id_outlet": 2,
  "name_outlet": "This is outlet",
  "id_price_level": 1,
  "id_employee": 1,
  "id_teller_setting": 1,
  "id_group_outlet": 1,
  "active": true
}

Схема:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id_outlet": {
      "type": "number"
    },
    "name_outlet": {
      "type": "string"
    },
    "id_price_level": {
      "type": "number"
    },
    "id_employee": {
      "type": "number"
    },
    "id_teller_setting": {
      "type": "number"
    },
    "id_group_outlet": {
      "type": "number"
    },
    "active": {
      "type": "boolean"
    }
  },
  "required": [
    "id_outlet",
    "name_outlet",
    "id_price_level",
    "id_employee",
    "id_teller_setting",
    "id_group_outlet",
    "active"
  ]
}

Змінити дані про торгову точку

PUT /api/outlets/{id_outlet}/{?unprotect_keys,with}

Параметри

Параметр	Тип	Обов’язковий	Опис
id_outlet	integer	так	Код торгової точки
unprotect_keys	string	ні	Якщо параметр існує і дорівнює “true”, в операціях створення/редагування значення ключового поля не ігноруються

Заголовки запиту:

• Content-Type: application/json

Тіло запиту:

{
  "id_outlet": 2,
  "name_outlet": "This is outlet",
  "id_price_level": 1,
  "id_employee": 1,
  "id_teller_setting": 1,
  "id_group_outlet": 1,
  "active": true
}

Відповідь 200 (application/json)

{
  "id_outlet": 2,
  "name_outlet": "This is outlet",
  "id_price_level": 1,
  "id_employee": 1,
  "id_teller_setting": 1,
  "id_group_outlet": 1,
  "active": true
}

Схема:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "id_outlet": {
      "type": "number"
    },
    "name_outlet": {
      "type": "string"
    },
    "id_price_level": {
      "type": "number"
    },
    "id_employee": {
      "type": "number"
    },
    "id_teller_setting": {
      "type": "number"
    },
    "id_group_outlet": {
      "type": "number"
    },
    "active": {
      "type": "boolean"
    }
  },
  "required": [
    "id_outlet",
    "name_outlet",
    "id_price_level",
    "id_employee",
    "id_teller_setting",
    "id_group_outlet",
    "active"
  ]
}

Деактивувати дані про торгову точку

DELETE /api/outlets/{id_outlet}/{?unprotect_keys,with}

Параметри

Параметр	Тип	Обов’язковий	Опис
id_outlet	integer	так	Код торгової точки

Відповідь 204