API - Onhand - Остатки
Пакетное добавление/обновление информации по остаткам
Пример запроса
POST /onhand/batch-update
HTTP/1.1
HOST: api.zelenka.ru
[
{"id": "ЦБ-00004897", "warehouse_id": 341, "quantity": 8.1},
{"id": "ЦБ-00004898", "warehouse_id": 341, "quantity": 12},
{"id": "ЦБ-00004899", "warehouse_id": 3411, "quantity": 0.00}
]
HTTP/1.1
HOST: api.zelenka.ru
[
{"id": "ЦБ-00004897", "warehouse_id": 341, "quantity": 8.1},
{"id": "ЦБ-00004898", "warehouse_id": 341, "quantity": 12},
{"id": "ЦБ-00004899", "warehouse_id": 3411, "quantity": 0.00}
]
Параметры запроса
Информация принимается в теле запроса в формате JSON. Ограничение на размер тела запроса 16 мегабайт.
- Каждый элемент передаваемого массива должен содержать следующие элементы:
- id - идентификатор товара
- warehouse_id - идентификатор точки продаж
- quantity - количество (приводится к целому)
Ответ сервера
В ответе содержится информация:
- success - о количестве успешно обновленных/добавленных записей об остатках
- errors - массив с ошибками по неуспешно обновленным записям
{
"success": 2,
"errors": {
"ЦБ-00004899": "Warehouse not found"
}
}
"success": 2,
"errors": {
"ЦБ-00004899": "Warehouse not found"
}
}
Обработка полных остатков
В соответствии с регламентом, раз в сутки необходимо передавать остатки по всем товарам по точке продаж. Для запроса такого типа необходимо указать GET параметр isfull=1.
Пример запроса
POST /onhand/batch-update?isfull=1
HTTP/1.1
HOST: api.zelenka.ru
[
{"id": "ЦБ-00004897", "warehouse_id": 341, "quantity": 8.1},
{"id": "ЦБ-00004898", "warehouse_id": 341, "quantity": 12},
{"id": "ЦБ-00004899", "warehouse_id": 342, "quantity": 3.00}
{"id": "ЦБ-00004897", "warehouse_id": 342, "quantity": 90.00}
...... остатки по всем товарам точек продаж 341, 342 ......
HTTP/1.1
HOST: api.zelenka.ru
[
{"id": "ЦБ-00004897", "warehouse_id": 341, "quantity": 8.1},
{"id": "ЦБ-00004898", "warehouse_id": 341, "quantity": 12},
{"id": "ЦБ-00004899", "warehouse_id": 342, "quantity": 3.00}
{"id": "ЦБ-00004897", "warehouse_id": 342, "quantity": 90.00}
...... остатки по всем товарам точек продаж 341, 342 ......
]
Добавление/обновление информации по одному товару
POST /onhand/update
HTTP/1.1
HOST: api.zelenka.ru
{
"id": 7,
"warehouse_id": 123,
"quantity": 8.1
}
HTTP/1.1
HOST: api.zelenka.ru
{
"id": 7,
"warehouse_id": 123,
"quantity": 8.1
}
Параметры запроса
Информация принимается в теле запроса в формате JSON.
- id - обязательный параметр - идентификатор товара.
- warehouse_id - идентификатор точки продаж
- quantity - количество (приводится к целому)
Ответ сервера
При успешном добавлении ответ возвращается с кодом статуса 201, при обновлении 200.
В теле ответа переданные параметры и количество которое было принято.
{
"id": 44,
"warehouse_id": "341",
"quantity": 8
}
"id": 44,
"warehouse_id": "341",
"quantity": 8
}