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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ozonapi-async
-Version: 0.77.0
+Version: 0.78.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
 
-**Реализовано методов: 394 / 447**
+**Реализовано методов: 401 / 447**
 
 <details>
 <summary>Информация по API-ключу (1/1)</summary>
@@ -673,17 +673,17 @@ pytest --cov=ozonapi --cov-report=html
 | ✓ | `/v2/posting/fbs/product/change` | Изменить вес весовых товаров (устарел, удалён из API Ozon) | `posting_fbs_product_change()` |
 </details>
 <details>
-<summary>Полигоны (0/7)</summary>
+<summary>Полигоны (7/7)</summary>
 
 | ✓ | Адрес метода Ozon | Описание метода | Python-метод |
 |---|---|---|---|
-| ☐ | `/v1/polygon/create` | Создайте полигон доставки | `polygon_create()` |
-| ☐ | `/v1/polygon/bind` | Свяжите метод доставки с полигоном доставки | `polygon_bind()` |
-| ☐ | `/v2/polygon/bind` | Связать метод доставки с полигоном | `polygon_bind()` |
-| ☐ | `/v1/polygon/delete` | Удалить полигон из области доставки | `polygon_delete()` |
-| ☐ | `/v1/polygon/list` | Получить список установленных полигонов на метод доставки | `polygon_list()` |
-| ☐ | `/v1/polygon/time/coordinates/update` | Обновить координаты полигона доставки | `polygon_time_coordinates_update()` |
-| ☐ | `/v1/polygon/time/set` | Установить новое время доставки в полигоне | `polygon_time_set()` |
+| ✓ | `/v1/polygon/create` | Создайте полигон доставки | `polygon_create()` |
+| ✓ | `/v1/polygon/bind` | Свяжите метод доставки с полигоном доставки | `polygon_bind_v1()` |
+| ✓ | `/v2/polygon/bind` | Связать метод доставки с полигоном | `polygon_bind()` |
+| ✓ | `/v1/polygon/delete` | Удалить полигон из области доставки | `polygon_delete()` |
+| ✓ | `/v1/polygon/list` | Получить список установленных полигонов на метод доставки | `polygon_list()` |
+| ✓ | `/v1/polygon/time/coordinates/update` | Обновить координаты полигона доставки | `polygon_time_coordinates_update()` |
+| ✓ | `/v1/polygon/time/set` | Установить новое время доставки в полигоне | `polygon_time_set()` |
 </details>
 <details>
 <summary>Доставка FBO (15/15)</summary>

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

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

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

@@ -410,7 +410,7 @@ pytest --cov=ozonapi --cov-report=html
 
 ## ✔️ Реализованные методы Ozon Seller API
 
-**Реализовано методов: 394 / 447**
+**Реализовано методов: 401 / 447**
 
 <details>
 <summary>Информация по API-ключу (1/1)</summary>
@@ -631,17 +631,17 @@ pytest --cov=ozonapi --cov-report=html
 | ✓ | `/v2/posting/fbs/product/change` | Изменить вес весовых товаров (устарел, удалён из API Ozon) | `posting_fbs_product_change()` |
 </details>
 <details>
-<summary>Полигоны (0/7)</summary>
+<summary>Полигоны (7/7)</summary>
 
 | ✓ | Адрес метода Ozon | Описание метода | Python-метод |
 |---|---|---|---|
-| ☐ | `/v1/polygon/create` | Создайте полигон доставки | `polygon_create()` |
-| ☐ | `/v1/polygon/bind` | Свяжите метод доставки с полигоном доставки | `polygon_bind()` |
-| ☐ | `/v2/polygon/bind` | Связать метод доставки с полигоном | `polygon_bind()` |
-| ☐ | `/v1/polygon/delete` | Удалить полигон из области доставки | `polygon_delete()` |
-| ☐ | `/v1/polygon/list` | Получить список установленных полигонов на метод доставки | `polygon_list()` |
-| ☐ | `/v1/polygon/time/coordinates/update` | Обновить координаты полигона доставки | `polygon_time_coordinates_update()` |
-| ☐ | `/v1/polygon/time/set` | Установить новое время доставки в полигоне | `polygon_time_set()` |
+| ✓ | `/v1/polygon/create` | Создайте полигон доставки | `polygon_create()` |
+| ✓ | `/v1/polygon/bind` | Свяжите метод доставки с полигоном доставки | `polygon_bind_v1()` |
+| ✓ | `/v2/polygon/bind` | Связать метод доставки с полигоном | `polygon_bind()` |
+| ✓ | `/v1/polygon/delete` | Удалить полигон из области доставки | `polygon_delete()` |
+| ✓ | `/v1/polygon/list` | Получить список установленных полигонов на метод доставки | `polygon_list()` |
+| ✓ | `/v1/polygon/time/coordinates/update` | Обновить координаты полигона доставки | `polygon_time_coordinates_update()` |
+| ✓ | `/v1/polygon/time/set` | Установить новое время доставки в полигоне | `polygon_time_set()` |
 </details>
 <details>
 <summary>Доставка FBO (15/15)</summary>

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

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

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

@@ -29,6 +29,7 @@ from .methods import (
     SellerNotificationAPI,
     SellerOrderAPI,
     SellerPassAPI,
+    SellerPolygonAPI,
     SellerPostingAPI,
     SellerQuantAPI,
     SellerRFBSDeliveryAPI,
@@ -65,6 +66,7 @@ class SellerAPI(
     SellerNotificationAPI,
     SellerOrderAPI,
     SellerPassAPI,
+    SellerPolygonAPI,
     SellerPostingAPI,
     SellerPricesAndStocksAPI,
     SellerPricingStrategyAPI,

ozonapi_async-0.78.0/src/ozonapi/seller/common/enumerations/polygons.py

@@ -0,0 +1,22 @@
+from enum import IntEnum
+
+
+class PolygonDeliveryTime(IntEnum):
+    """Время доставки в полигоне, минуты.
+
+    Attributes:
+        MIN_15: 15 минут
+        MIN_30: 30 минут
+        MIN_45: 45 минут
+        MIN_60: 60 минут
+        MIN_90: 90 минут
+        MIN_120: 120 минут
+        MIN_150: 150 минут
+    """
+    MIN_15 = 15
+    MIN_30 = 30
+    MIN_45 = 45
+    MIN_60 = 60
+    MIN_90 = 90
+    MIN_120 = 120
+    MIN_150 = 150

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

@@ -22,6 +22,7 @@ __all__ = [
     "SellerNotificationAPI",
     "SellerOrderAPI",
     "SellerPassAPI",
+    "SellerPolygonAPI",
     "SellerPostingAPI",
     "SellerPricesAndStocksAPI",
     "SellerProductAPI",
@@ -61,6 +62,7 @@ from .invoices import SellerInvoiceAPI
 from .notifications import SellerNotificationAPI
 from .orders import SellerOrderAPI
 from .passes import SellerPassAPI
+from .polygons import SellerPolygonAPI
 from .postings import SellerPostingAPI
 from .prices_and_stocks import SellerPricesAndStocksAPI
 from .pricing_strategies import SellerPricingStrategyAPI

ozonapi_async-0.78.0/src/ozonapi/seller/methods/polygons/__init__.py

@@ -0,0 +1,26 @@
+__all__ = ["SellerPolygonAPI", ]
+
+from .polygon_create import PolygonCreateMixin
+from .polygon_bind import PolygonBindMixin
+from .polygon_bind_v1 import PolygonBindV1Mixin
+from .polygon_delete import PolygonDeleteMixin
+from .polygon_list import PolygonListMixin
+from .polygon_time_coordinates_update import PolygonTimeCoordinatesUpdateMixin
+from .polygon_time_set import PolygonTimeSetMixin
+
+
+class SellerPolygonAPI(
+    PolygonCreateMixin,
+    PolygonBindMixin,
+    PolygonBindV1Mixin,
+    PolygonDeleteMixin,
+    PolygonListMixin,
+    PolygonTimeCoordinatesUpdateMixin,
+    PolygonTimeSetMixin,
+):
+    """Реализует методы раздела «Полигоны».
+
+    References:
+        https://docs.ozon.ru/api/seller/#tag/PolygonAPI
+    """
+    pass

ozonapi_async-0.78.0/src/ozonapi/seller/methods/polygons/polygon_bind.py

@@ -0,0 +1,47 @@
+from ...core import APIManager
+from ...schemas.polygons import PolygonBindRequest, PolygonBindResponse
+
+
+class PolygonBindMixin(APIManager):
+    """Реализует метод /v2/polygon/bind"""
+
+    async def polygon_bind(
+            self: "PolygonBindMixin",
+            request: PolygonBindRequest,
+    ) -> PolygonBindResponse:
+        """Связывает метод доставки с полигоном доставки.
+
+        Notes:
+            • Канонический метод привязки полигона (v2). Устаревшая версия v1
+              доступна как `polygon_bind_v1()`.
+            • Время доставки `time` ограничено набором: 15, 30, 45, 60, 90, 120, 150
+              минут (перечисление `PolygonDeliveryTime`).
+            • Тело ответа отсутствует — успех подтверждается кодом 200.
+
+        References:
+            https://docs.ozon.ru/api/seller/?#operation/PolygonBind
+
+        Args:
+            request: Параметры привязки полигона по схеме `PolygonBindRequest`
+
+        Returns:
+            Пустой ответ по схеме `PolygonBindResponse`
+
+        Example:
+            async with SellerAPI(client_id, api_key) as api:
+                await api.polygon_bind(
+                    PolygonBindRequest(
+                        delivery_method_id=123,
+                        polygon_id=456,
+                        time=PolygonDeliveryTime.MIN_30,
+                        warehouse_id=789,
+                    )
+                )
+        """
+        response = await self._request(
+            method="post",
+            api_version="v2",
+            endpoint="polygon/bind",
+            payload=request.model_dump(),
+        )
+        return PolygonBindResponse(**response)

ozonapi_async-0.78.0/src/ozonapi/seller/methods/polygons/polygon_bind_v1.py

@@ -0,0 +1,48 @@
+from ...core import APIManager
+from ...schemas.polygons import PolygonBindV1Request, PolygonBindV1Response
+
+
+class PolygonBindV1Mixin(APIManager):
+    """Реализует метод /v1/polygon/bind"""
+
+    async def polygon_bind_v1(
+            self: "PolygonBindV1Mixin",
+            request: PolygonBindV1Request,
+    ) -> PolygonBindV1Response:
+        """Связывает метод доставки с полигонами доставки (устаревшая версия v1).
+
+        Notes:
+            • Устаревшая версия метода привязки. Предпочтительно использовать
+              канонический `polygon_bind()` (v2).
+            • Позволяет привязать сразу несколько полигонов и указывает координаты
+              склада явно (`warehouse_location`).
+            • Тело ответа отсутствует — успех подтверждается кодом 200.
+
+        References:
+            https://docs.ozon.ru/api/seller/?#operation/PolygonAPI_BindPolygon
+
+        Args:
+            request: Параметры привязки полигонов по схеме `PolygonBindV1Request`
+
+        Returns:
+            Пустой ответ по схеме `PolygonBindV1Response`
+
+        Example:
+            async with SellerAPI(client_id, api_key) as api:
+                await api.polygon_bind_v1(
+                    PolygonBindV1Request(
+                        delivery_method_id=123,
+                        polygons=[PolygonBindV1Polygon(polygon_id=456, time=30)],
+                        warehouse_location=PolygonBindV1WarehouseLocation(
+                            lat="58.27", lon="92.13"
+                        ),
+                    )
+                )
+        """
+        response = await self._request(
+            method="post",
+            api_version="v1",
+            endpoint="polygon/bind",
+            payload=request.model_dump(),
+        )
+        return PolygonBindV1Response(**response)

ozonapi_async-0.78.0/src/ozonapi/seller/methods/polygons/polygon_create.py

@@ -0,0 +1,46 @@
+from ...core import APIManager
+from ...schemas.polygons import PolygonCreateRequest, PolygonCreateResponse
+
+
+class PolygonCreateMixin(APIManager):
+    """Реализует метод /v1/polygon/create"""
+
+    async def polygon_create(
+            self: "PolygonCreateMixin",
+            request: PolygonCreateRequest,
+    ) -> PolygonCreateResponse:
+        """Создаёт полигон доставки.
+
+        Notes:
+            • Координаты полигона задаются строкой с JSON-массивом точек
+              `[[[lat, lon], [lat, lon], ...]]`.
+            • Координаты можно получить, например, через geojson.io.
+            • После создания полигон нужно привязать к методу доставки методом
+              `polygon_bind()`.
+
+        References:
+            https://docs.ozon.ru/api/seller/?#operation/PolygonAPI_CreatePolygon
+
+        Args:
+            request: Координаты полигона по схеме `PolygonCreateRequest`
+
+        Returns:
+            Идентификатор созданного полигона по схеме `PolygonCreateResponse`
+
+        Example:
+            async with SellerAPI(client_id, api_key) as api:
+                result = await api.polygon_create(
+                    PolygonCreateRequest(
+                        coordinates="[[[58.27,92.13],[58.30,92.16],[58.27,92.13]]]"
+                    )
+                )
+
+            polygon_id = result.polygon_id
+        """
+        response = await self._request(
+            method="post",
+            api_version="v1",
+            endpoint="polygon/create",
+            payload=request.model_dump(),
+        )
+        return PolygonCreateResponse(**response)

ozonapi_async-0.78.0/src/ozonapi/seller/methods/polygons/polygon_delete.py

@@ -0,0 +1,41 @@
+from ...core import APIManager
+from ...schemas.polygons import PolygonDeleteRequest, PolygonDeleteResponse
+
+
+class PolygonDeleteMixin(APIManager):
+    """Реализует метод /v1/polygon/delete"""
+
+    async def polygon_delete(
+            self: "PolygonDeleteMixin",
+            request: PolygonDeleteRequest,
+    ) -> PolygonDeleteResponse:
+        """Удаляет полигон из области доставки.
+
+        Notes:
+            • Удаляет связь полигона с методом доставки на указанном складе.
+            • Тело ответа отсутствует — успех подтверждается кодом 200.
+
+        References:
+            https://docs.ozon.ru/api/seller/?#operation/PolygonDelete
+
+        Args:
+            request: Параметры удаления полигона по схеме `PolygonDeleteRequest`
+
+        Returns:
+            Пустой ответ по схеме `PolygonDeleteResponse`
+
+        Example:
+            async with SellerAPI(client_id, api_key) as api:
+                await api.polygon_delete(
+                    PolygonDeleteRequest(
+                        delivery_method_id=123, polygon_id=456, warehouse_id=789
+                    )
+                )
+        """
+        response = await self._request(
+            method="post",
+            api_version="v1",
+            endpoint="polygon/delete",
+            payload=request.model_dump(),
+        )
+        return PolygonDeleteResponse(**response)

ozonapi_async-0.78.0/src/ozonapi/seller/methods/polygons/polygon_list.py

@@ -0,0 +1,42 @@
+from ...core import APIManager
+from ...schemas.polygons import PolygonListRequest, PolygonListResponse
+
+
+class PolygonListMixin(APIManager):
+    """Реализует метод /v1/polygon/list"""
+
+    async def polygon_list(
+            self: "PolygonListMixin",
+            request: PolygonListRequest,
+    ) -> PolygonListResponse:
+        """Получает список установленных полигонов на метод доставки.
+
+        Notes:
+            • Возвращает полигоны, привязанные к указанному методу доставки на складе,
+              вместе с их координатами и временем доставки.
+
+        References:
+            https://docs.ozon.ru/api/seller/?#operation/PolygonList
+
+        Args:
+            request: Идентификаторы метода доставки и склада по схеме `PolygonListRequest`
+
+        Returns:
+            Список полигонов по схеме `PolygonListResponse`
+
+        Example:
+            async with SellerAPI(client_id, api_key) as api:
+                result = await api.polygon_list(
+                    PolygonListRequest(delivery_method_id=123, warehouse_id=789)
+                )
+
+            for polygon in result.polygons:
+                print(polygon.polygon_id, polygon.time)
+        """
+        response = await self._request(
+            method="post",
+            api_version="v1",
+            endpoint="polygon/list",
+            payload=request.model_dump(),
+        )
+        return PolygonListResponse(**response)

ozonapi_async-0.78.0/src/ozonapi/seller/methods/polygons/polygon_time_coordinates_update.py

@@ -0,0 +1,48 @@
+from ...core import APIManager
+from ...schemas.polygons import (
+    PolygonTimeCoordinatesUpdateRequest,
+    PolygonTimeCoordinatesUpdateResponse,
+)
+
+
+class PolygonTimeCoordinatesUpdateMixin(APIManager):
+    """Реализует метод /v1/polygon/time/coordinates/update"""
+
+    async def polygon_time_coordinates_update(
+            self: "PolygonTimeCoordinatesUpdateMixin",
+            request: PolygonTimeCoordinatesUpdateRequest,
+    ) -> PolygonTimeCoordinatesUpdateResponse:
+        """Обновляет координаты полигона доставки.
+
+        Notes:
+            • Изменяет координаты ранее созданного полигона.
+            • Тело ответа отсутствует — успех подтверждается кодом 200.
+
+        References:
+            https://docs.ozon.ru/api/seller/?#operation/PolygonTimeCoordinatesUpdate
+
+        Args:
+            request: Новые координаты полигона по схеме
+                `PolygonTimeCoordinatesUpdateRequest`
+
+        Returns:
+            Пустой ответ по схеме `PolygonTimeCoordinatesUpdateResponse`
+
+        Example:
+            async with SellerAPI(client_id, api_key) as api:
+                await api.polygon_time_coordinates_update(
+                    PolygonTimeCoordinatesUpdateRequest(
+                        coordinates="[[[58.27,92.13],[58.30,92.16],[58.27,92.13]]]",
+                        delivery_method_id=123,
+                        polygon_id=456,
+                        warehouse_id=789,
+                    )
+                )
+        """
+        response = await self._request(
+            method="post",
+            api_version="v1",
+            endpoint="polygon/time/coordinates/update",
+            payload=request.model_dump(),
+        )
+        return PolygonTimeCoordinatesUpdateResponse(**response)

ozonapi_async-0.78.0/src/ozonapi/seller/methods/polygons/polygon_time_set.py

@@ -0,0 +1,47 @@
+from ...core import APIManager
+from ...schemas.polygons import PolygonTimeSetRequest, PolygonTimeSetResponse
+
+
+class PolygonTimeSetMixin(APIManager):
+    """Реализует метод /v1/polygon/time/set"""
+
+    async def polygon_time_set(
+            self: "PolygonTimeSetMixin",
+            request: PolygonTimeSetRequest,
+    ) -> PolygonTimeSetResponse:
+        """Устанавливает новое время доставки в полигоне.
+
+        Notes:
+            • Меняет время доставки полигона с `current_time` на `new_time`.
+            • Допустимые значения времени: 15, 30, 45, 60, 90, 120, 150 минут
+              (перечисление `PolygonDeliveryTime`).
+            • Тело ответа отсутствует — успех подтверждается кодом 200.
+
+        References:
+            https://docs.ozon.ru/api/seller/?#operation/PolygonTimeSet
+
+        Args:
+            request: Параметры изменения времени по схеме `PolygonTimeSetRequest`
+
+        Returns:
+            Пустой ответ по схеме `PolygonTimeSetResponse`
+
+        Example:
+            async with SellerAPI(client_id, api_key) as api:
+                await api.polygon_time_set(
+                    PolygonTimeSetRequest(
+                        current_time=PolygonDeliveryTime.MIN_30,
+                        new_time=PolygonDeliveryTime.MIN_60,
+                        delivery_method_id=123,
+                        polygon_id=456,
+                        warehouse_id=789,
+                    )
+                )
+        """
+        response = await self._request(
+            method="post",
+            api_version="v1",
+            endpoint="polygon/time/set",
+            payload=request.model_dump(),
+        )
+        return PolygonTimeSetResponse(**response)

ozonapi_async-0.78.0/src/ozonapi/seller/schemas/polygons/__init__.py

@@ -0,0 +1,54 @@
+"""Описывает модели раздела «Полигоны».
+https://docs.ozon.ru/api/seller/#tag/PolygonAPI
+"""
+__all__ = [
+    "PolygonCreateRequest",
+    "PolygonCreateResponse",
+    "PolygonBindRequest",
+    "PolygonBindResponse",
+    "PolygonBindV1Request",
+    "PolygonBindV1Response",
+    "PolygonBindV1Polygon",
+    "PolygonBindV1WarehouseLocation",
+    "PolygonDeleteRequest",
+    "PolygonDeleteResponse",
+    "PolygonListRequest",
+    "PolygonListResponse",
+    "PolygonListPolygon",
+    "PolygonTimeCoordinatesUpdateRequest",
+    "PolygonTimeCoordinatesUpdateResponse",
+    "PolygonTimeSetRequest",
+    "PolygonTimeSetResponse",
+]
+
+from .v1__polygon_create import (
+    PolygonCreateRequest,
+    PolygonCreateResponse,
+)
+from .v1__polygon_bind import (
+    PolygonBindV1Polygon,
+    PolygonBindV1Request,
+    PolygonBindV1Response,
+    PolygonBindV1WarehouseLocation,
+)
+from .v2__polygon_bind import (
+    PolygonBindRequest,
+    PolygonBindResponse,
+)
+from .v1__polygon_delete import (
+    PolygonDeleteRequest,
+    PolygonDeleteResponse,
+)
+from .v1__polygon_list import (
+    PolygonListPolygon,
+    PolygonListRequest,
+    PolygonListResponse,
+)
+from .v1__polygon_time_coordinates_update import (
+    PolygonTimeCoordinatesUpdateRequest,
+    PolygonTimeCoordinatesUpdateResponse,
+)
+from .v1__polygon_time_set import (
+    PolygonTimeSetRequest,
+    PolygonTimeSetResponse,
+)

ozonapi_async-0.78.0/src/ozonapi/seller/schemas/polygons/v1__polygon_bind.py

@@ -0,0 +1,63 @@
+"""https://docs.ozon.ru/api/seller/#operation/PolygonAPI_BindPolygon"""
+from pydantic import BaseModel, Field
+
+
+class PolygonBindV1Polygon(BaseModel):
+    """Полигон и время доставки для привязки (v1).
+
+    Attributes:
+        polygon_id: Идентификатор полигона
+        time: Время доставки в полигоне, минуты
+    """
+
+    polygon_id: int = Field(
+        ..., description="Идентификатор полигона."
+    )
+    time: int = Field(
+        ..., description="Время доставки в полигоне, минуты."
+    )
+
+
+class PolygonBindV1WarehouseLocation(BaseModel):
+    """Координаты склада (v1).
+
+    Attributes:
+        lat: Широта склада
+        lon: Долгота склада
+    """
+
+    lat: str = Field(
+        ..., description="Широта склада."
+    )
+    lon: str = Field(
+        ..., description="Долгота склада."
+    )
+
+
+class PolygonBindV1Request(BaseModel):
+    """Схема запроса привязки полигонов к методу доставки (v1).
+
+    Attributes:
+        delivery_method_id: Идентификатор метода доставки
+        polygons: Список полигонов с временем доставки
+        warehouse_location: Координаты склада
+    """
+
+    delivery_method_id: int = Field(
+        ..., description="Идентификатор метода доставки."
+    )
+    polygons: list[PolygonBindV1Polygon] = Field(
+        default_factory=list,
+        description="Список полигонов с временем доставки."
+    )
+    warehouse_location: PolygonBindV1WarehouseLocation = Field(
+        ..., description="Координаты склада."
+    )
+
+
+class PolygonBindV1Response(BaseModel):
+    """Схема ответа привязки полигонов к методу доставки (v1).
+
+    Notes:
+        • Тело ответа отсутствует — успех подтверждается кодом 200.
+    """

ozonapi_async-0.78.0/src/ozonapi/seller/schemas/polygons/v1__polygon_create.py

@@ -0,0 +1,28 @@
+"""https://docs.ozon.ru/api/seller/#operation/PolygonAPI_CreatePolygon"""
+from pydantic import BaseModel, Field
+
+
+class PolygonCreateRequest(BaseModel):
+    """Схема запроса создания полигона доставки.
+
+    Attributes:
+        coordinates: Координаты полигона в формате `[[[lat, lon], ...]]` (строка JSON)
+    """
+
+    coordinates: str = Field(
+        ...,
+        description="Координаты полигона в формате `[[[lat, lon], [lat, lon], ...]]` "
+                    "(строка с JSON-массивом координат)."
+    )
+
+
+class PolygonCreateResponse(BaseModel):
+    """Схема ответа создания полигона доставки.
+
+    Attributes:
+        polygon_id: Идентификатор созданного полигона
+    """
+
+    polygon_id: int = Field(
+        ..., description="Идентификатор созданного полигона."
+    )