wbapi-async 1.0.2__tar.gz → 1.0.3__tar.gz

{wbapi_async-1.0.2 → wbapi_async-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: wbapi-async
-Version: 1.0.2
+Version: 1.0.3
 Summary: Fast, lightweight async client for the Wildberries Seller API
 Project-URL: Documentation, https://github.com/serdukow/wbapi-async#readme
 Project-URL: Repository, https://github.com/serdukow/wbapi-async
@@ -66,16 +66,6 @@ Description-Content-Type: text/markdown
 
 </div>
 
-308 сгенерированных методов с автоматической пагинацией и понятными
-именами:
-
-| OpenAPI Generator                       | wbapi                             |
-| --------------------------------------- | --------------------------------- |
-| `api_v3_supplies_post()`                | `api.orders_fbs.create_supply()`  |
-| `api_v3_orders_new_get()`               | `api.orders_fbs.get_orders_new()` |
-| `api_v3_orders_order_id_cancel_patch()` | `api.orders_fbs.cancel_order()`   |
-| `content_v2_get_cards_list_post()`      | `api.items.get_cards_list()`      |
-
 ## Установка
 
 Требуется Python 3.10+.
@@ -105,7 +95,7 @@ async def main():
 asyncio.run(main())
 ```
 
-### End-to-end поставка FBS
+### Поставка FBS
 
 ```python
 import asyncio
@@ -125,7 +115,7 @@ async def main():
         print(f"Добавлено {len(order_ids)} новых сборочных заданий")
 
         await api.orders_fbs.update_supplies_deliver(supply_id=supply.id)
-        print(f"Передана {supply.id} в доставку")
+        print(f"Поставка {supply.id} передана в доставку")
 
 
 asyncio.run(main())
@@ -153,7 +143,7 @@ async def main():
 asyncio.run(main())
 ```
 
-На больших выборках лучше `iter_*` методы:
+На больших выборках используйте `iter_*` методы:
 
 ```python
 import asyncio
@@ -195,7 +185,7 @@ async def main():
         except WBRateLimitError as error:
             print(f"Превышен лимит, повтор через {error.retry_after} с")
         except WBAPIError as error:
-            print(f"WB вернул {error.status_code}: {error}")
+            print(f"{error.status_code}: {error}")
 
 
 asyncio.run(main())

{wbapi_async-1.0.2 → wbapi_async-1.0.3}/README.md

@@ -18,16 +18,6 @@
 
 </div>
 
-308 сгенерированных методов с автоматической пагинацией и понятными
-именами:
-
-| OpenAPI Generator                       | wbapi                             |
-| --------------------------------------- | --------------------------------- |
-| `api_v3_supplies_post()`                | `api.orders_fbs.create_supply()`  |
-| `api_v3_orders_new_get()`               | `api.orders_fbs.get_orders_new()` |
-| `api_v3_orders_order_id_cancel_patch()` | `api.orders_fbs.cancel_order()`   |
-| `content_v2_get_cards_list_post()`      | `api.items.get_cards_list()`      |
-
 ## Установка
 
 Требуется Python 3.10+.
@@ -57,7 +47,7 @@ async def main():
 asyncio.run(main())
 ```
 
-### End-to-end поставка FBS
+### Поставка FBS
 
 ```python
 import asyncio
@@ -77,7 +67,7 @@ async def main():
         print(f"Добавлено {len(order_ids)} новых сборочных заданий")
 
         await api.orders_fbs.update_supplies_deliver(supply_id=supply.id)
-        print(f"Передана {supply.id} в доставку")
+        print(f"Поставка {supply.id} передана в доставку")
 
 
 asyncio.run(main())
@@ -105,7 +95,7 @@ async def main():
 asyncio.run(main())
 ```
 
-На больших выборках лучше `iter_*` методы:
+На больших выборках используйте `iter_*` методы:
 
 ```python
 import asyncio
@@ -147,7 +137,7 @@ async def main():
         except WBRateLimitError as error:
             print(f"Превышен лимит, повтор через {error.retry_after} с")
         except WBAPIError as error:
-            print(f"WB вернул {error.status_code}: {error}")
+            print(f"{error.status_code}: {error}")
 
 
 asyncio.run(main())

{wbapi_async-1.0.2 → wbapi_async-1.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wbapi-async"
-version = "1.0.2"
+version = "1.0.3"
 description = "Fast, lightweight async client for the Wildberries Seller API"
 
 authors = [

{wbapi_async-1.0.2 → wbapi_async-1.0.3}/src/wbapi/analytics/__init__.py

@@ -59,8 +59,10 @@ from .models import (
     PastPeriod,
     PastPeriodItemRating,
     Period,
+    PeriodInv,
     PeriodItemRating,
     PeriodOrdersRequest,
+    TableOrderBy,
 )
 
 
@@ -724,21 +726,255 @@ class Analytics:
         ).stream(self._api):
             yield item
 
-    async def get_stocks_report_offices(self, *, body: Any) -> GetStocksReportOfficesResponse:
-        """Данные по складам"""
-        return await GetStocksReportOffices(body=body).emit(self._api)
+    async def get_stocks_report_offices(
+        self,
+        *,
+        current_period: PeriodInv,
+        skip_deleted_nm: bool,
+        stock_type: str,
+        brand_names: list[str] | None = None,
+        nm_ids: list[int] | None = None,
+        subject_ids: list[int] | None = None,
+        tag_ids: list[int] | None = None,
+    ) -> GetStocksReportOfficesResponse:
+        """Данные по складам
+
+        :param current_period: Период
+        :param skip_deleted_nm: Скрыть удалённые товары
+        :param stock_type: Тип складов хранения товаров:   - `""` — все   - `wb` — склады WB   - `mp` —
+            склады продавца
+        :param brand_names: Список брендов для фильтрации
+        :param nm_ids: Список артикулов WB для фильтрации
+        :param subject_ids: Список ID предметов для фильтрации
+        :param tag_ids: Список ID ярлыков для фильтрации
+        """
+        return await GetStocksReportOffices(
+            current_period=current_period,
+            skip_deleted_nm=skip_deleted_nm,
+            stock_type=stock_type,
+            brand_names=brand_names,
+            nm_ids=nm_ids,
+            subject_ids=subject_ids,
+            tag_ids=tag_ids,
+        ).emit(self._api)
+
+    async def get_stocks_report_products(
+        self,
+        *,
+        availability_filters: list[str],
+        current_period: PeriodInv,
+        offset: int,
+        order_by: TableOrderBy,
+        skip_deleted_nm: bool,
+        stock_type: str,
+        brand_name: str | None = None,
+        limit: int | None = 100,
+        nm_ids: list[int] | None = None,
+        subject_id: int | None = None,
+        tag_id: int | None = None,
+        auto_paginate: bool = False,
+    ) -> GetStocksReportProductsResponse | list[Any]:
+        """Данные по товарам
 
-    async def get_stocks_report_products(self, *, body: Any) -> GetStocksReportProductsResponse:
-        """Данные по товарам"""
-        return await GetStocksReportProducts(body=body).emit(self._api)
+        :param availability_filters: Доступность товара:   - `deficient` — Дефицит   - `actual` — Актуальный
+            - `balanced` — Баланс   - `nonActual` — Неактуальный   - `nonLiquid` —
+            Неликвид …
+        :param current_period: Период
+        :param offset: После какого элемента выдавать данные
+        :param order_by: Вид сортировки данных
+        :param skip_deleted_nm: Скрыть удалённые товары
+        :param stock_type: Тип складов хранения товаров:   - `""` — все   - `wb` — склады WB   - `mp` —
+            склады продавца
+        :param brand_name: Бренд
+        :param limit: Количество товаров в ответе
+        :param nm_ids: Список артикулов WB для фильтрации
+        :param subject_id: ID предмета
+        :param tag_id: ID ярлыка
+        :param auto_paginate: автоматически собрать все страницы выборки
+        """
+        call = GetStocksReportProducts(
+            availability_filters=availability_filters,
+            current_period=current_period,
+            offset=offset,
+            order_by=order_by,
+            skip_deleted_nm=skip_deleted_nm,
+            stock_type=stock_type,
+            brand_name=brand_name,
+            limit=limit,
+            nm_ids=nm_ids,
+            subject_id=subject_id,
+            tag_id=tag_id,
+        )
+        return await call.paginate(self._api) if auto_paginate else await call.emit(self._api)
 
-    async def get_stocks_report_products_groups(self, *, body: Any) -> GetStocksReportProductsGroupsResponse:
-        """Данные по группам"""
-        return await GetStocksReportProductsGroups(body=body).emit(self._api)
+    async def iter_get_stocks_report_products(
+        self,
+        *,
+        availability_filters: list[str],
+        current_period: PeriodInv,
+        offset: int,
+        order_by: TableOrderBy,
+        skip_deleted_nm: bool,
+        stock_type: str,
+        brand_name: str | None = None,
+        limit: int | None = 100,
+        nm_ids: list[int] | None = None,
+        subject_id: int | None = None,
+        tag_id: int | None = None,
+    ) -> AsyncIterator[Any]:
+        """Данные по товарам — постранично, по одной записи.
 
-    async def get_stocks_report_products_sizes(self, *, body: Any) -> GetStocksReportProductsSizesResponse:
-        """Данные по размерам"""
-        return await GetStocksReportProductsSizes(body=body).emit(self._api)
+        :param availability_filters: Доступность товара:   - `deficient` — Дефицит   - `actual` — Актуальный
+            - `balanced` — Баланс   - `nonActual` — Неактуальный   - `nonLiquid` —
+            Неликвид …
+        :param current_period: Период
+        :param offset: После какого элемента выдавать данные
+        :param order_by: Вид сортировки данных
+        :param skip_deleted_nm: Скрыть удалённые товары
+        :param stock_type: Тип складов хранения товаров:   - `""` — все   - `wb` — склады WB   - `mp` —
+            склады продавца
+        :param brand_name: Бренд
+        :param limit: Количество товаров в ответе
+        :param nm_ids: Список артикулов WB для фильтрации
+        :param subject_id: ID предмета
+        :param tag_id: ID ярлыка
+        """
+        async for item in GetStocksReportProducts(
+            availability_filters=availability_filters,
+            current_period=current_period,
+            offset=offset,
+            order_by=order_by,
+            skip_deleted_nm=skip_deleted_nm,
+            stock_type=stock_type,
+            brand_name=brand_name,
+            limit=limit,
+            nm_ids=nm_ids,
+            subject_id=subject_id,
+            tag_id=tag_id,
+        ).stream(self._api):
+            yield item
+
+    async def get_stocks_report_products_groups(
+        self,
+        *,
+        availability_filters: list[str],
+        current_period: PeriodInv,
+        offset: int,
+        order_by: TableOrderBy,
+        skip_deleted_nm: bool,
+        stock_type: str,
+        brand_names: list[str] | None = None,
+        limit: int | None = 100,
+        nm_ids: list[int] | None = None,
+        subject_ids: list[int] | None = None,
+        tag_ids: list[int] | None = None,
+        auto_paginate: bool = False,
+    ) -> GetStocksReportProductsGroupsResponse | list[Any]:
+        """Данные по группам
+
+        :param availability_filters: Доступность товара:   - `deficient` — Дефицит   - `actual` — Актуальный
+            - `balanced` — Баланс   - `nonActual` — Неактуальный   - `nonLiquid` —
+            Неликвид …
+        :param current_period: Период
+        :param offset: После какого элемента выдавать данные
+        :param order_by: Вид сортировки данных
+        :param skip_deleted_nm: Скрыть удалённые товары
+        :param stock_type: Тип складов хранения товаров:   - `""` — все   - `wb` — склады WB   - `mp` —
+            склады продавца
+        :param brand_names: Список брендов для фильтрации
+        :param limit: Количество групп в ответе
+        :param nm_ids: Список артикулов WB для фильтрации
+        :param subject_ids: Список ID предметов для фильтрации
+        :param tag_ids: Список ID ярлыков для фильтрации
+        :param auto_paginate: автоматически собрать все страницы выборки
+        """
+        call = GetStocksReportProductsGroups(
+            availability_filters=availability_filters,
+            current_period=current_period,
+            offset=offset,
+            order_by=order_by,
+            skip_deleted_nm=skip_deleted_nm,
+            stock_type=stock_type,
+            brand_names=brand_names,
+            limit=limit,
+            nm_ids=nm_ids,
+            subject_ids=subject_ids,
+            tag_ids=tag_ids,
+        )
+        return await call.paginate(self._api) if auto_paginate else await call.emit(self._api)
+
+    async def iter_get_stocks_report_products_groups(
+        self,
+        *,
+        availability_filters: list[str],
+        current_period: PeriodInv,
+        offset: int,
+        order_by: TableOrderBy,
+        skip_deleted_nm: bool,
+        stock_type: str,
+        brand_names: list[str] | None = None,
+        limit: int | None = 100,
+        nm_ids: list[int] | None = None,
+        subject_ids: list[int] | None = None,
+        tag_ids: list[int] | None = None,
+    ) -> AsyncIterator[Any]:
+        """Данные по группам — постранично, по одной записи.
+
+        :param availability_filters: Доступность товара:   - `deficient` — Дефицит   - `actual` — Актуальный
+            - `balanced` — Баланс   - `nonActual` — Неактуальный   - `nonLiquid` —
+            Неликвид …
+        :param current_period: Период
+        :param offset: После какого элемента выдавать данные
+        :param order_by: Вид сортировки данных
+        :param skip_deleted_nm: Скрыть удалённые товары
+        :param stock_type: Тип складов хранения товаров:   - `""` — все   - `wb` — склады WB   - `mp` —
+            склады продавца
+        :param brand_names: Список брендов для фильтрации
+        :param limit: Количество групп в ответе
+        :param nm_ids: Список артикулов WB для фильтрации
+        :param subject_ids: Список ID предметов для фильтрации
+        :param tag_ids: Список ID ярлыков для фильтрации
+        """
+        async for item in GetStocksReportProductsGroups(
+            availability_filters=availability_filters,
+            current_period=current_period,
+            offset=offset,
+            order_by=order_by,
+            skip_deleted_nm=skip_deleted_nm,
+            stock_type=stock_type,
+            brand_names=brand_names,
+            limit=limit,
+            nm_ids=nm_ids,
+            subject_ids=subject_ids,
+            tag_ids=tag_ids,
+        ).stream(self._api):
+            yield item
+
+    async def get_stocks_report_products_sizes(
+        self,
+        *,
+        current_period: PeriodInv,
+        include_office: bool,
+        nm_id: int,
+        order_by: TableOrderBy,
+        stock_type: str,
+    ) -> GetStocksReportProductsSizesResponse:
+        """Данные по размерам
+
+        :param current_period: Период
+        :param include_office: Включить детализацию по складам
+        :param nm_id: Артикул WB
+        :param order_by: Вид сортировки данных
+        :param stock_type: Тип складов хранения товаров:   - `""` — все   - `wb` — склады WB   - `mp` —
+            склады продавца
+        """
+        return await GetStocksReportProductsSizes(
+            current_period=current_period,
+            include_office=include_office,
+            nm_id=nm_id,
+            order_by=order_by,
+            stock_type=stock_type,
+        ).emit(self._api)
 
     async def get_stocks_report_wb_warehouses(
         self,

{wbapi_async-1.0.2 → wbapi_async-1.0.3}/src/wbapi/analytics/methods.py

@@ -24,13 +24,9 @@ from .models import (
     GetSearchReportResponse,
     GetSearchReportTableDetailsResponse,
     GetSearchReportTableGroupsResponse,
-    GetStocksReportOfficesBody,
     GetStocksReportOfficesResponse,
-    GetStocksReportProductsBody,
-    GetStocksReportProductsGroupsBody,
     GetStocksReportProductsGroupsResponse,
     GetStocksReportProductsResponse,
-    GetStocksReportProductsSizesBody,
     GetStocksReportProductsSizesResponse,
     GetStocksReportWbWarehousesResponse,
     NmReportCreateReportResponse,
@@ -43,9 +39,11 @@ from .models import (
     PastPeriod,
     PastPeriodItemRating,
     Period,
+    PeriodInv,
     PeriodItemRating,
     PeriodOrdersRequest,
     SalesFunnelItemReq,
+    TableOrderBy,
 )
 
 
@@ -649,8 +647,31 @@ class GetStocksReportOffices(WBMethod[GetStocksReportOfficesResponse]):
         "basic": (1800000, 1),
     }
     __items__ = "data"
+    __body_fields__ = {
+        "nm_ids": "nmIDs",
+        "subject_ids": "subjectIDs",
+        "brand_names": "brandNames",
+        "tag_ids": "tagIDs",
+        "current_period": "currentPeriod",
+        "stock_type": "stockType",
+        "skip_deleted_nm": "skipDeletedNm",
+    }
 
-    body: GetStocksReportOfficesBody | list[Any] | dict[str, Any]
+    current_period: PeriodInv
+    """Период"""
+    skip_deleted_nm: bool
+    """Скрыть удалённые товары"""
+    stock_type: str
+    """Тип складов хранения товаров:   - `""` — все   - `wb` — склады WB   - `mp` — склады продавца
+    """
+    brand_names: list[str] | None = None
+    """Список брендов для фильтрации"""
+    nm_ids: list[int] | None = None
+    """Список артикулов WB для фильтрации"""
+    subject_ids: list[int] | None = None
+    """Список ID предметов для фильтрации"""
+    tag_ids: list[int] | None = None
+    """Список ID ярлыков для фильтрации"""
 
 
 class GetStocksReportProducts(WBMethod[GetStocksReportProductsResponse]):
@@ -670,9 +691,47 @@ class GetStocksReportProducts(WBMethod[GetStocksReportProductsResponse]):
         "basic_secret": (60000, 3),
         "basic": (1800000, 1),
     }
+    __paginate__ = "offset_body"
     __items__ = "data"
+    __body_fields__ = {
+        "nm_ids": "nmIDs",
+        "subject_id": "subjectID",
+        "brand_name": "brandName",
+        "tag_id": "tagID",
+        "current_period": "currentPeriod",
+        "stock_type": "stockType",
+        "skip_deleted_nm": "skipDeletedNm",
+        "order_by": "orderBy",
+        "availability_filters": "availabilityFilters",
+        "limit": "limit",
+        "offset": "offset",
+    }
 
-    body: GetStocksReportProductsBody | list[Any] | dict[str, Any]
+    availability_filters: list[str]
+    """Доступность товара:   - `deficient` — Дефицит   - `actual` — Актуальный   - `balanced` —
+    Баланс   - `nonActual` — Неактуальный   - `nonLiquid` — Неликвид …
+    """
+    current_period: PeriodInv
+    """Период"""
+    offset: int
+    """После какого элемента выдавать данные"""
+    order_by: TableOrderBy
+    """Вид сортировки данных"""
+    skip_deleted_nm: bool
+    """Скрыть удалённые товары"""
+    stock_type: str
+    """Тип складов хранения товаров:   - `""` — все   - `wb` — склады WB   - `mp` — склады продавца
+    """
+    brand_name: str | None = None
+    """Бренд"""
+    limit: int | None = 100
+    """Количество товаров в ответе"""
+    nm_ids: list[int] | None = None
+    """Список артикулов WB для фильтрации"""
+    subject_id: int | None = None
+    """ID предмета"""
+    tag_id: int | None = None
+    """ID ярлыка"""
 
 
 class GetStocksReportProductsGroups(WBMethod[GetStocksReportProductsGroupsResponse]):
@@ -692,9 +751,47 @@ class GetStocksReportProductsGroups(WBMethod[GetStocksReportProductsGroupsRespon
         "basic_secret": (60000, 3),
         "basic": (1800000, 1),
     }
+    __paginate__ = "offset_body"
     __items__ = "data"
+    __body_fields__ = {
+        "nm_ids": "nmIDs",
+        "subject_ids": "subjectIDs",
+        "brand_names": "brandNames",
+        "tag_ids": "tagIDs",
+        "current_period": "currentPeriod",
+        "stock_type": "stockType",
+        "skip_deleted_nm": "skipDeletedNm",
+        "availability_filters": "availabilityFilters",
+        "order_by": "orderBy",
+        "limit": "limit",
+        "offset": "offset",
+    }
 
-    body: GetStocksReportProductsGroupsBody | list[Any] | dict[str, Any]
+    availability_filters: list[str]
+    """Доступность товара:   - `deficient` — Дефицит   - `actual` — Актуальный   - `balanced` —
+    Баланс   - `nonActual` — Неактуальный   - `nonLiquid` — Неликвид …
+    """
+    current_period: PeriodInv
+    """Период"""
+    offset: int
+    """После какого элемента выдавать данные"""
+    order_by: TableOrderBy
+    """Вид сортировки данных"""
+    skip_deleted_nm: bool
+    """Скрыть удалённые товары"""
+    stock_type: str
+    """Тип складов хранения товаров:   - `""` — все   - `wb` — склады WB   - `mp` — склады продавца
+    """
+    brand_names: list[str] | None = None
+    """Список брендов для фильтрации"""
+    limit: int | None = 100
+    """Количество групп в ответе"""
+    nm_ids: list[int] | None = None
+    """Список артикулов WB для фильтрации"""
+    subject_ids: list[int] | None = None
+    """Список ID предметов для фильтрации"""
+    tag_ids: list[int] | None = None
+    """Список ID ярлыков для фильтрации"""
 
 
 class GetStocksReportProductsSizes(WBMethod[GetStocksReportProductsSizesResponse]):
@@ -715,8 +812,25 @@ class GetStocksReportProductsSizes(WBMethod[GetStocksReportProductsSizesResponse
         "basic": (1800000, 1),
     }
     __items__ = "data"
+    __body_fields__ = {
+        "nm_id": "nmID",
+        "current_period": "currentPeriod",
+        "stock_type": "stockType",
+        "order_by": "orderBy",
+        "include_office": "includeOffice",
+    }
 
-    body: GetStocksReportProductsSizesBody | list[Any] | dict[str, Any]
+    current_period: PeriodInv
+    """Период"""
+    include_office: bool
+    """Включить детализацию по складам"""
+    nm_id: int
+    """Артикул WB"""
+    order_by: TableOrderBy
+    """Вид сортировки данных"""
+    stock_type: str
+    """Тип складов хранения товаров:   - `""` — все   - `wb` — склады WB   - `mp` — склады продавца
+    """
 
 
 class GetStocksReportWbWarehouses(WBMethod[GetStocksReportWbWarehousesResponse]):