Lamoda B2B Platform предоставляет возможность получения информации о стоке, актуальном на момент времени выполнения запроса.
❗️ При создании заказа Lamoda B2B Platform автоматически проверяет доступность товаров на складе. В случае если товара нет в наличии, он перейдет в статус "отменен". Чтобы избежать подобного сценария, ниже описана возможность получения актуальной информации по доступным к продаже товарам.
| Триггер | Получить данные по товарам на складе (стоку) |
| Действие | GET /api/v1/stock/goods |
| Результат |
В ответе на запрос передано количество доступного для продажи стока (с учетом товаров в неподтвержденных заказах) |
Получение полного стока
Для получения информации по стоку предусмотрены следующие параметры фильтрации:
| Параметр | Формат | Описание | Пример |
| page |
число, больше 0, по умолчанию 1 |
Номер страницы со списком артикулов | page=1 |
| limit |
число, больше 0, по умолчанию 25 |
Количество SKU, возвращаемых на одной странице |
limit=10 |
| withZeroQuantity |
значение "1" или "0", по умолчанию "1" |
Параметр, исключающий отображение SKU с нулевым стоком. 1 - в ответе возвращается весь сток, включая нулевой. 0 - из ответа исключается нулевой сток |
withZeroQuantity=1 |
| updatedAt |
значение в формате "YYYY- MM-DD+hh:mm:ss" |
Дата и время, с которого было обновление количества стока Фильтрация только строго в будущее от переданных даты и времени |
updatedAt=2020-01- 01+10:00:00 |
Для получения стока по следующим артикулам, нужно сделать запрос с параметром page=2.
Ответ на запрос включает в себя список артикулов товаров (SKU - поставщика) и их количество (quantity), включая или не включая (в зависимости от настройки запроса) артикулы с нулевым стоком.
Получение дельты стока
При использовании в запросе параметра фильтрации updatedAt, в ответе будет возвращен только обновленный сток с момента переданных в запросе даты и времени. То есть дельта между стоком до момента наступления указанных даты и времени и после этого момента. Структура ответа останется прежней.
❗️ Таким образом, Lamoda B2B Platform предоставляет возможность получать данные по стоку, который был обновлен с определенного времени в прошлом. Это позволяет забирать меньший объем данных — только изменения по стоку (дельту) - тем самым, сокращая время обработки изменений по стоку на стороне партнера. Партнер сможет быстрее отражать эти изменения в своих системах. Например, партнер может отправлять запрос получения стока с updatedAt в Lamoda B2B Platform каждый час и получать сток, который был обновлен с начала прошлого часа.
Получение стока по артикулу
Если по переданным артикулам товаров нет в наличии, то в ответе будет возвращено значение 0.
При передаче параметра sku значения limit, page и withZeroQuantity устанавливаются по умолчанию (даже если они были указаны в строке запроса, они будут проигнорированы системой).
Структура ответа на такой запрос сохранится прежней, но будут возвращены данные только по тем артикулам, которые были указаны в запросе.
Помогла эта информация?
Спасибо за отзыв
