Rest API Остатки по товарам - datawizio/pythonAPI GitHub Wiki

35. Ресурс /products-stock/ POST

Остатки по категориям. С помощью ресурса /products-stock/ можно получить данные по остаткам, отфильтровать по дате, магазинам, категориям и товарам.

35.1. POST-параметры:

Название поля Тип поля Доступные значения Значение по умолчанию Описание
format строка "json", "api" "json" Формат ответа сервера
products число, список - Все товары Идентификатор или список идентификаторов товаров, по которым осуществлять выборку
categories число, список - Все категории Идентификатор или список идентификаторов категорий, по которым осуществлять выборку
shops число, список - Все магазины Идентификатор или список идентификаторов категорий, по которым осуществлять выборку
date_from строка - Дата последней подгрузки клиента - 30 дней Начальная дата выборки
date_to строка - Дата последней подгрузки клиента Конечная дата выборки
select строка, список "stock_qty", "stock_value" "stock_qty" Показатели, по которым осуществлять выборку

35.1.2. Параметры ответа:

Название поля Тип поля Обязательно присутствует в ответе Описание
date строка да Дата, за которую осуществилась выборка
category число да Идентификатор категории, по которой осуществлялась выборка
name строка да Название категории, по которой осуществлялась выборка
stock_qty число нет Кол-во товаров категории на остатке
stock_value число нет Себестоимость товаров категории на остатке

35.2. Пример работы с ресурсом

Команда: POST http://api.datawiz.io/api/v1/products-stock/

Суффиксы (аналог параметра format):
  • .json - получить ответ с сервера в формате JSON
  • .api - получить ответ с сервера в формате HTML (тестовая платформа)
Пример POST-параметров:
{
  "products": [68498, 65391],
  "shops": 674,
  "date_from": "2018-01-01",
  "date_to": "2018-01-15",
}
Ответ сервера:

HTTP 200 OK
Content-Type: application/json
Vary: Accept
Allow: GET, HEAD, OPTIONS
{
  "result": [
    {
      "date": "2018-01-01",
      "product": 68498,
      "name": "STC Orelsky tin 700g",
      "stock_qty": 38
    },
    {
      "date": "2018-01-02",
      "category": 68498,
      "name": "STC Orelsky tin 700g",
      "stock_qty": 34.34
    },
    {
      "date": "2018-01-14",
      "category": 68498,
      "name": "STC Orelsky tin 700g",
      "stock_qty": 16
    },
    {
      "date": "2018-01-15",
      "category": 68498,
      "name": "STC Orelsky tin 700g",
      "stock_qty": 18.34
    }
  ]
}
⚠️ **GitHub.com Fallback** ⚠️