Получение текущих цен для элемента Справочника продуктов
Для получения текущих цен продукта в регионе пользователя используйте метод POST /products/element/{$id}/price/, где {$id} — уникальный идентификатор элемента(fc_id), цены на который необходимо получить.
Метод позволяет получить текущие минимальную, максимальную и среднюю цены закупки продукта в регионе по умолчанию. Регион по умолчанию устанавливается при регистрации новой компании (см. метод /auth/company/ параметр location).
Параметры запроса POST
| Параметр | Обязательно | Описание |
|---|---|---|
| token | Да | Текущий токен |
| storage_unit | Да | Код единицы хранения по ОКЕИ (килограмм — 166, литр — 112, штука — 796) |
| price | Да | Текущая пользовательская цена на продукт за единицу хранения |
Обратите внимание!
Как правило, в параметрах запроса требуется указывать текущую цену продукта за 1 килограмм или 1 литр, за исключением:
— для яиц требуется указывать цену за 1 штуку;
— для консервированных продуктов требуется указывать цену за 1 килограмм сухого(!) веса.
Пример запроса POST
POST /api/1.0/products/element/10/price/?token=ae41f1c74dbf75593d297fa457d03175&storage_unit=166&price=24 HTTP/1.1
Host: foodcost.pro
Параметры ответа
| Свойства | Описание | Значения |
|---|---|---|
| status | Статус ответа на запрос | success/error |
| cost_min | минимальная текущая закупочная цена продукта в регионе пользователя | |
| cost_average | средняя текущая закупочная цена продукта в регионе пользователя | |
| cost_max | максимальная текущая закупочная цена продукта в регионе пользователя | |
| token | Новый токен |
Обратите внимание!
Для доступа к Справочнику продуктов потребуется токен. Не забудьте перезаписать записать новый токен!
