ozonapi-async 0.76.0__tar.gz → 0.77.0__tar.gz

{ozonapi_async-0.76.0/src/ozonapi_async.egg-info → ozonapi_async-0.77.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ozonapi-async
-Version: 0.76.0
+Version: 0.77.0
 Summary: Асинхронный pydantic-интерфейс для Ozon Seller API c ограничением запросов и docstrings
 Author-email: Alexander Ulianov <a.v.ulianov@mail.ru>
 License: MIT
@@ -452,7 +452,7 @@ pytest --cov=ozonapi --cov-report=html
 
 ## ✔️ Реализованные методы Ozon Seller API
 
-**Реализовано методов: 393 / 447**
+**Реализовано методов: 394 / 447**
 
 <details>
 <summary>Информация по API-ключу (1/1)</summary>
@@ -563,11 +563,11 @@ pytest --cov=ozonapi --cov-report=html
 | ✓ | `/v1/pricing-strategy/delete` | Удалить стратегию | `strategy_delete()` |
 </details>
 <details>
-<summary>Сертификаты брендов (0/1)</summary>
+<summary>Сертификаты брендов (1/1)</summary>
 
 | ✓ | Адрес метода Ozon | Описание метода | Python-метод |
 |---|---|---|---|
-| ☐ | `/v1/brand/company-certification/list` | Список сертифицируемых брендов | `brand_company_certification_list()` |
+| ✓ | `/v1/brand/company-certification/list` | Список сертифицируемых брендов | `brand_company_certification_list()` |
 </details>
 <details>
 <summary>Сертификаты качества (15/15)</summary>

{ozonapi_async-0.76.0 → ozonapi_async-0.77.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ozonapi-async"
-version = "0.76.0"
+version = "0.77.0"
 description = "Асинхронный pydantic-интерфейс для Ozon Seller API c ограничением запросов и docstrings"
 readme = "readme.md"
 keywords = [

{ozonapi_async-0.76.0 → ozonapi_async-0.77.0}/readme.md

@@ -410,7 +410,7 @@ pytest --cov=ozonapi --cov-report=html
 
 ## ✔️ Реализованные методы Ozon Seller API
 
-**Реализовано методов: 393 / 447**
+**Реализовано методов: 394 / 447**
 
 <details>
 <summary>Информация по API-ключу (1/1)</summary>
@@ -521,11 +521,11 @@ pytest --cov=ozonapi --cov-report=html
 | ✓ | `/v1/pricing-strategy/delete` | Удалить стратегию | `strategy_delete()` |
 </details>
 <details>
-<summary>Сертификаты брендов (0/1)</summary>
+<summary>Сертификаты брендов (1/1)</summary>
 
 | ✓ | Адрес метода Ozon | Описание метода | Python-метод |
 |---|---|---|---|
-| ☐ | `/v1/brand/company-certification/list` | Список сертифицируемых брендов | `brand_company_certification_list()` |
+| ✓ | `/v1/brand/company-certification/list` | Список сертифицируемых брендов | `brand_company_certification_list()` |
 </details>
 <details>
 <summary>Сертификаты качества (15/15)</summary>

{ozonapi_async-0.76.0 → ozonapi_async-0.77.0}/src/ozonapi/__init__.py

@@ -37,7 +37,7 @@ from .infrastructure.logging import ozonapi_logger as logger
 from .seller import SellerAPI, SellerAPIConfig
 
 
-__version__ = "0.76.0"
+__version__ = "0.77.0"
 __author__ = "Alexander Ulianov"
 __email__ = "a.v.ulianov@mail.ru"
 __repository__ = "https://github.com/a-ulianov/OzonAPI"

{ozonapi_async-0.76.0 → ozonapi_async-0.77.0}/src/ozonapi/seller/__init__.py

@@ -5,6 +5,7 @@ from .methods import (
     SellerApiKeyAPI,
     SellerBetaAPI,
     SellerBarcodeAPI,
+    SellerBrandAPI,
     SellerCancellationAPI,
     SellerCategoryAPI,
     SellerFBSAPI,
@@ -46,6 +47,7 @@ class SellerAPI(
     SellerApiKeyAPI,
     SellerBetaAPI,
     SellerBarcodeAPI,
+    SellerBrandAPI,
     SellerCancellationAPI,
     SellerCategoryAPI,
     SellerCertificateAPI,

{ozonapi_async-0.76.0 → ozonapi_async-0.77.0}/src/ozonapi/seller/methods/__init__.py

@@ -4,6 +4,7 @@ __all__ = [
     "SellerApiKeyAPI",
     "SellerBarcodeAPI",
     "SellerBetaAPI",
+    "SellerBrandAPI",
     "SellerCancellationAPI",
     "SellerCategoryAPI",
     "SellerCertificateAPI",
@@ -43,6 +44,7 @@ from .api_key import SellerApiKeyAPI
 from .attributes_and_characteristics import SellerCategoryAPI
 from .barcodes import SellerBarcodeAPI
 from .beta import SellerBetaAPI
+from .brands import SellerBrandAPI
 from .cancellations import SellerCancellationAPI
 from .certificates import SellerCertificateAPI
 from .chats import SellerChatAPI

ozonapi_async-0.77.0/src/ozonapi/seller/methods/brands/__init__.py

@@ -0,0 +1,14 @@
+__all__ = ["SellerBrandAPI", ]
+
+from .brand_company_certification_list import BrandCompanyCertificationListMixin
+
+
+class SellerBrandAPI(
+    BrandCompanyCertificationListMixin,
+):
+    """Реализует методы раздела «Сертификаты брендов».
+
+    References:
+        https://docs.ozon.ru/api/seller/#tag/BrandAPI
+    """
+    pass

ozonapi_async-0.77.0/src/ozonapi/seller/methods/brands/brand_company_certification_list.py

@@ -0,0 +1,50 @@
+from ...core import APIManager
+from ...schemas.brands import (
+    BrandCompanyCertificationListRequest,
+    BrandCompanyCertificationListResponse,
+)
+
+
+class BrandCompanyCertificationListMixin(APIManager):
+    """Реализует метод /v1/brand/company-certification/list"""
+
+    async def brand_company_certification_list(
+            self: "BrandCompanyCertificationListMixin",
+            request: BrandCompanyCertificationListRequest = BrandCompanyCertificationListRequest(),
+    ) -> BrandCompanyCertificationListResponse:
+        """Метод для получения списка сертифицируемых брендов.
+
+        Notes:
+            • Возвращает список брендов с признаком необходимости сертификата
+              (`has_certificate`).
+            • Список брендов, для которых нужен сертификат, не статичен и может
+              меняться.
+            • Использует постраничную пагинацию (`page`, `page_size`).
+
+        References:
+            https://docs.ozon.ru/api/seller/?#operation/BrandAPI_BrandCompanyCertificationList
+
+        Args:
+            request: Параметры пагинации по схеме `BrandCompanyCertificationListRequest`
+
+        Returns:
+            Список сертифицируемых брендов по схеме
+            `BrandCompanyCertificationListResponse`
+
+        Example:
+            async with SellerAPI(client_id, api_key) as api:
+                result = await api.brand_company_certification_list(
+                    BrandCompanyCertificationListRequest(page=1, page_size=100)
+                )
+
+            total = result.result.total
+            for brand in result.result.brand_certification:
+                print(brand.brand_name, brand.has_certificate)
+        """
+        response = await self._request(
+            method="post",
+            api_version="v1",
+            endpoint="brand/company-certification/list",
+            payload=request.model_dump(),
+        )
+        return BrandCompanyCertificationListResponse(**response)

ozonapi_async-0.77.0/src/ozonapi/seller/schemas/brands/__init__.py

@@ -0,0 +1,16 @@
+"""Описывает модели раздела «Сертификаты брендов».
+https://docs.ozon.ru/api/seller/#tag/BrandAPI
+"""
+__all__ = [
+    "BrandCertification",
+    "BrandCompanyCertificationListRequest",
+    "BrandCompanyCertificationListResult",
+    "BrandCompanyCertificationListResponse",
+]
+
+from .v1__brand_company_certification_list import (
+    BrandCertification,
+    BrandCompanyCertificationListRequest,
+    BrandCompanyCertificationListResponse,
+    BrandCompanyCertificationListResult,
+)

ozonapi_async-0.77.0/src/ozonapi/seller/schemas/brands/v1__brand_company_certification_list.py

@@ -0,0 +1,66 @@
+"""https://docs.ozon.ru/api/seller/#operation/BrandAPI_BrandCompanyCertificationList"""
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+class BrandCompanyCertificationListRequest(BaseModel):
+    """Схема запроса списка сертифицируемых брендов.
+
+    Attributes:
+        page: Номер страницы, возвращаемой в ответе
+        page_size: Количество элементов на странице
+    """
+
+    page: Optional[int] = Field(
+        None, description="Номер страницы, возвращаемой в ответе."
+    )
+    page_size: Optional[int] = Field(
+        None, description="Количество элементов на странице."
+    )
+
+
+class BrandCertification(BaseModel):
+    """Бренд и признак необходимости сертификата.
+
+    Attributes:
+        brand_name: Название бренда
+        has_certificate: Признак того, что для бренда нужен сертификат
+    """
+
+    brand_name: Optional[str] = Field(
+        None, description="Название бренда."
+    )
+    has_certificate: Optional[bool] = Field(
+        None, description="Признак того, что для бренда необходим сертификат."
+    )
+
+
+class BrandCompanyCertificationListResult(BaseModel):
+    """Результат запроса списка сертифицируемых брендов.
+
+    Attributes:
+        brand_certification: Список брендов с признаком необходимости сертификата
+        total: Общее количество брендов
+    """
+
+    brand_certification: list[BrandCertification] = Field(
+        default_factory=list,
+        description="Список брендов с признаком необходимости сертификата."
+    )
+    total: Optional[int] = Field(
+        None, description="Общее количество брендов."
+    )
+
+
+class BrandCompanyCertificationListResponse(BaseModel):
+    """Схема ответа со списком сертифицируемых брендов.
+
+    Attributes:
+        result: Результат запроса со списком брендов и их общим количеством
+    """
+
+    result: BrandCompanyCertificationListResult = Field(
+        default_factory=BrandCompanyCertificationListResult,
+        description="Результат запроса со списком брендов и их общим количеством."
+    )

{ozonapi_async-0.76.0 → ozonapi_async-0.77.0/src/ozonapi_async.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ozonapi-async
-Version: 0.76.0
+Version: 0.77.0
 Summary: Асинхронный pydantic-интерфейс для Ozon Seller API c ограничением запросов и docstrings
 Author-email: Alexander Ulianov <a.v.ulianov@mail.ru>
 License: MIT
@@ -452,7 +452,7 @@ pytest --cov=ozonapi --cov-report=html
 
 ## ✔️ Реализованные методы Ozon Seller API
 
-**Реализовано методов: 393 / 447**
+**Реализовано методов: 394 / 447**
 
 <details>
 <summary>Информация по API-ключу (1/1)</summary>
@@ -563,11 +563,11 @@ pytest --cov=ozonapi --cov-report=html
 | ✓ | `/v1/pricing-strategy/delete` | Удалить стратегию | `strategy_delete()` |
 </details>
 <details>
-<summary>Сертификаты брендов (0/1)</summary>
+<summary>Сертификаты брендов (1/1)</summary>
 
 | ✓ | Адрес метода Ozon | Описание метода | Python-метод |
 |---|---|---|---|
-| ☐ | `/v1/brand/company-certification/list` | Список сертифицируемых брендов | `brand_company_certification_list()` |
+| ✓ | `/v1/brand/company-certification/list` | Список сертифицируемых брендов | `brand_company_certification_list()` |
 </details>
 <details>
 <summary>Сертификаты качества (15/15)</summary>

{ozonapi_async-0.76.0 → ozonapi_async-0.77.0}/src/ozonapi_async.egg-info/SOURCES.txt

@@ -86,6 +86,8 @@ src/ozonapi/seller/methods/beta/removal_from_stock_list.py
 src/ozonapi/seller/methods/beta/removal_from_supply_list.py
 src/ozonapi/seller/methods/beta/seller_info.py
 src/ozonapi/seller/methods/beta/seller_ozon_logistics_info.py
+src/ozonapi/seller/methods/brands/__init__.py
+src/ozonapi/seller/methods/brands/brand_company_certification_list.py
 src/ozonapi/seller/methods/cancellations/__init__.py
 src/ozonapi/seller/methods/cancellations/cancel_reason_list.py
 src/ozonapi/seller/methods/cancellations/cancel_reason_list_by_order.py
@@ -522,6 +524,8 @@ src/ozonapi/seller/schemas/beta/v2__cluster_list.py
 src/ozonapi/seller/schemas/beta/v2__posting_digital_list.py
 src/ozonapi/seller/schemas/beta/entities/__init__.py
 src/ozonapi/seller/schemas/beta/entities/beta.py
+src/ozonapi/seller/schemas/brands/__init__.py
+src/ozonapi/seller/schemas/brands/v1__brand_company_certification_list.py
 src/ozonapi/seller/schemas/cancellations/__init__.py
 src/ozonapi/seller/schemas/cancellations/base.py
 src/ozonapi/seller/schemas/cancellations/v1__cancel_reason_list.py