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
    }
  ]
}

Rest API Залишки по товарах - datawizio/pythonAPI GitHub Wiki

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