ozonapi-async 0.4.0__tar.gz → 0.6.0__tar.gz

{ozonapi_async-0.4.0 → ozonapi_async-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ozonapi-async
-Version: 0.4.0
+Version: 0.6.0
 Summary: Асинхронный клиент для работы с API маркетплейса Ozon
 Author: Alexander Ulianov
 License: MIT
@@ -377,9 +377,9 @@ pytest --cov=ozonapi --cov-report=html
 |---|---|---|---|
 | ✓ | `/v3/posting/fbs/unfulfilled/list` | Список необработанных отправлений | `posting_fbs_unfulfilled_list()` |
 | ✓ | `/v3/posting/fbs/list` | Список отправлений | `posting_fbs_list()` |
-| ☐ | `/v3/posting/fbs/get` | Получить информацию об отправлении по идентификатору | `posting_fbs_get()` |
-| ☐ | `/v2/posting/fbs/get-by-barcode` | Получить информацию об отправлении по штрихкоду | `posting_fbs_get_by_barcode()` |
-| ☐ | `/v3/posting/multiboxqty/set` | Указать количество коробок для многокоробочных отправлений | `posting_multiboxqty_set()` |
+| ✓ | `/v3/posting/fbs/get` | Получить информацию об отправлении по идентификатору | `posting_fbs_get()` |
+| ✓ | `/v2/posting/fbs/get-by-barcode` | Получить информацию об отправлении по штрихкоду | `posting_fbs_get_by_barcode()` |
+| ✓ | `/v3/posting/multiboxqty/set` | Указать количество коробок для многокоробочных отправлений | `posting_multiboxqty_set()` |
 | ☐ | `/v2/posting/fbs/product/change` | Добавить вес для весовых товаров в отправлении | `posting_fbs_product_change()` |
 | ☐ | `/v2/posting/fbs/product/country/list` | Список доступных стран-изготовителей | `posting_fbs_product_country_list()` |
 | ☐ | `/v2/posting/fbs/product/country/set` | Добавить информацию о стране-изготовителе товара | `posting_fbs_product_country_set()` |

{ozonapi_async-0.4.0 → ozonapi_async-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ozonapi-async"
-version = "0.4.0"
+version = "0.6.0"
 description = "Асинхронный клиент для работы с API маркетплейса Ozon"
 readme = "readme.md"
 keywords = ["ozon", "api", "async", "ecommerce", "seller", "client"]

{ozonapi_async-0.4.0 → ozonapi_async-0.6.0}/readme.md

@@ -335,9 +335,9 @@ pytest --cov=ozonapi --cov-report=html
 |---|---|---|---|
 | ✓ | `/v3/posting/fbs/unfulfilled/list` | Список необработанных отправлений | `posting_fbs_unfulfilled_list()` |
 | ✓ | `/v3/posting/fbs/list` | Список отправлений | `posting_fbs_list()` |
-| ☐ | `/v3/posting/fbs/get` | Получить информацию об отправлении по идентификатору | `posting_fbs_get()` |
-| ☐ | `/v2/posting/fbs/get-by-barcode` | Получить информацию об отправлении по штрихкоду | `posting_fbs_get_by_barcode()` |
-| ☐ | `/v3/posting/multiboxqty/set` | Указать количество коробок для многокоробочных отправлений | `posting_multiboxqty_set()` |
+| ✓ | `/v3/posting/fbs/get` | Получить информацию об отправлении по идентификатору | `posting_fbs_get()` |
+| ✓ | `/v2/posting/fbs/get-by-barcode` | Получить информацию об отправлении по штрихкоду | `posting_fbs_get_by_barcode()` |
+| ✓ | `/v3/posting/multiboxqty/set` | Указать количество коробок для многокоробочных отправлений | `posting_multiboxqty_set()` |
 | ☐ | `/v2/posting/fbs/product/change` | Добавить вес для весовых товаров в отправлении | `posting_fbs_product_change()` |
 | ☐ | `/v2/posting/fbs/product/country/list` | Список доступных стран-изготовителей | `posting_fbs_product_country_list()` |
 | ☐ | `/v2/posting/fbs/product/country/set` | Добавить информацию о стране-изготовителе товара | `posting_fbs_product_country_set()` |

{ozonapi_async-0.4.0 → ozonapi_async-0.6.0}/src/ozonapi/__init__.py

@@ -2,7 +2,7 @@
 Асинхронный интерфейс для взаимодействия с API маркетплейса Ozon.
 """
 
-__version__ = "0.4.0"
+__version__ = "0.6.0"
 __author__ = "Alexander Ulianov"
 __repository__ = "https://github.com/a-ulianov/OzonAPI"
 __docs__ = "https://github.com/a-ulianov/OzonAPI#readme"

{ozonapi_async-0.4.0 → ozonapi_async-0.6.0}/src/ozonapi/seller/common/enumerations/postings.py

@@ -12,6 +12,7 @@ class AvailablePostingActions(str, Enum):
         CLICK_TRACK_NUMBER: просмотреть по трек-номеру историю изменения статусов в личном кабинете
         CUSTOMER_PHONE_AVAILABLE: телефон покупателя
         HAS_WEIGHT_PRODUCTS: весовые товары в отправлении
+        HAS_BARCODE_FOR_PRINTING: штрихкод для печати
         HIDE_REGION_AND_CITY: скрыть регион и город покупателя в отчёте
         INVOICE_GET: получить информацию из счёта-фактуры
         INVOICE_SEND: создать счёт-фактуру
@@ -204,6 +205,7 @@ class PrrOption(str, Enum):
     Attributes:
         LIFT: подъём на лифте
         STAIRS: подъём по лестнице
+        FLOOR: подъем на этаж
         NONE: покупатель отказался от услуги, поднимать товары не нужно
         DELIVERY_DEFAULT: доставка включена в стоимость, по условиям оферты нужно доставить товар на этаж
         UNSPECIFIED: не указано

{ozonapi_async-0.4.0 → ozonapi_async-0.6.0}/src/ozonapi/seller/core/config.py

@@ -45,7 +45,7 @@ class APIConfig(BaseSettings):
         description="Базовый URL API Ozon"
     )
     max_requests_per_second: int = Field(
-        default=50,
+        default=25,
         ge=1,
         le=50,
         description="Максимальное количество запросов в секунду (50 по документации Ozon)"

{ozonapi_async-0.4.0 → ozonapi_async-0.6.0}/src/ozonapi/seller/methods/fbs.py

@@ -1,6 +1,7 @@
 from ..core import APIManager
 from ..schemas.fbs import PostingFBSUnfulfilledListRequest, PostingFBSUnfulfilledListResponse, PostingFBSListResponse, \
-    PostingFBSListRequest
+    PostingFBSListRequest, PostingFBSGetRequest, PostingFBSGetResponse, PostingFBSGetByBarcodeResponse, \
+    PostingFBSGetByBarcodeRequest, PostingFBSMultiBoxQtySetResponse, PostingFBSMultiBoxQtySetRequest
 
 
 class SellerFBSAPI(APIManager):
@@ -160,4 +161,137 @@ class SellerFBSAPI(APIManager):
             endpoint="posting/fbs/list",
             json=request.model_dump(by_alias=True)
         )
-        return PostingFBSListResponse(**response)
+        return PostingFBSListResponse(**response)
+
+    async def posting_fbs_get(
+            self: "SellerFBSAPI",
+            request: PostingFBSGetRequest
+    ) -> PostingFBSGetResponse:
+        """Метод для получения информации об отправлении FBS по его номеру.
+
+        Notes:
+            • Чтобы получать актуальную дату отгрузки, регулярно обновляйте информацию об отправлениях или подключите пуш-уведомления.
+            • Для получения дополнительных данных используйте параметр `with_` в запросе.
+
+        References:
+            https://docs.ozon.ru/api/seller/#operation/PostingAPI_GetFbsPostingV3
+
+        Args:
+            request: Запрос на получение информации об отправлении FBS по схеме `PostingFBSGetRequest`
+
+        Returns:
+            Детализированная информация об отправлении по схеме `PostingFBSGetResponse`
+
+        Examples:
+            Базовое применение:
+                async with SellerAPI(client_id, api_key) as api:
+                    result = await api.posting_fbs_get(
+                        PostingFBSGetRequest(
+                            posting_number="57195475-0050-3"
+                        )
+                    )
+
+            Пример с дополнительными полями:
+                async with SellerAPI(client_id, api_key) as api:
+                    result = await api.posting_fbs_get(
+                        PostingFBSGetRequest(
+                            posting_number="57195475-0050-3",
+                            with_=PostingFBSGetRequestWith(
+                                analytics_data=True,
+                                barcodes=True,
+                                financial_data=True,
+                                legal_info=False,
+                                product_exemplars=True,
+                                related_postings=True,
+                                translit=False
+                            )
+                        )
+                    )
+        """
+        response = await self._request(
+            method="post",
+            api_version="v3",
+            endpoint="posting/fbs/get",
+            json=request.model_dump(by_alias=True)
+        )
+        return PostingFBSGetResponse(**response)
+
+    async def posting_fbs_get_by_barcode(
+            self: "SellerFBSAPI",
+            request: PostingFBSGetByBarcodeRequest
+    ) -> PostingFBSGetByBarcodeResponse:
+        """Метод для получения информации об отправлении FBS по штрихкоду.
+
+        Notes:
+            • Штрихкод отправления можно получить с помощью методов posting_fbs_get(), posting_fbs_list(), posting_fbs_unfulfilled_list() в массиве barcodes
+            • Метод возвращает основную информацию об отправлении: статус, данные о заказе, товары и штрихкоды.
+            • Для получения дополнительных данных (финансовой информации, аналитики и т.д.) используйте метод posting_fbs_get().
+
+        References:
+            https://docs.ozon.ru/api/seller/?__rr=1#operation/PostingAPI_GetFbsPostingByBarcode
+
+        Args:
+            request: Запрос на получение информации об отправлении по штрихкоду по схеме `PostingFBSGetByBarcodeRequest`
+
+        Returns:
+            Информация об отправлении FBS по схеме `PostingFBSGetByBarcodeResponse`
+
+        Examples:
+            async with SellerAPI(client_id, api_key) as api:
+                result = await api.posting_fbs_get_by_barcode(
+                    PostingFBSGetByBarcodeRequest(
+                        barcode="20325804886000"
+                    )
+                )
+        """
+        response = await self._request(
+            method="post",
+            api_version="v2",
+            endpoint="posting/fbs/get-by-barcode",
+            json=request.model_dump()
+        )
+        return PostingFBSGetByBarcodeResponse(**response["result"])
+
+    async def posting_fbs_multiboxqty_set(
+            self: "SellerFBSAPI",
+            request: PostingFBSMultiBoxQtySetRequest
+    ) -> PostingFBSMultiBoxQtySetResponse:
+        """Метод для передачи количества коробок для отправлений, в которых есть многокоробочные товары.
+
+        Notes:
+            • Метод используется при работе по схеме rFBS Агрегатор — с доставкой партнёрами Ozon.
+            • Используется только для многокоробочных отправлений, где товары упакованы в несколько коробок.
+            • Количество коробок должно быть целым положительным числом.
+            • После успешного выполнения метода система учитывает указанное количество коробок при дальнейшей обработке отправления.
+
+        References:
+            https://docs.ozon.ru/api/seller/?__rr=1#operation/PostingAPI_PostingMultiBoxQtySetV3
+
+        Args:
+            request: Запрос на указание количества коробок для многокоробочного отправления по схеме `PostingFBSMultiBoxQtySetRequest`
+
+        Returns:
+            Результат выполнения операции по схеме `PostingFBSMultiBoxQtySetResponse`
+
+        Examples:
+            Пример с проверкой результата:
+                async with SellerAPI(client_id, api_key) as api:
+                    result = await api.posting_multiboxqty_set(
+                        PostingFBSMultiBoxQtySetRequest(
+                            posting_number="57195475-0050-3",
+                            multi_box_qty=3
+                        )
+                    )
+
+                    if result.result.result:
+                        print("Количество коробок успешно передано")
+                    else:
+                        print("Произошла ошибка при указании количества коробок")
+        """
+        response = await self._request(
+            method="post",
+            api_version="v3",
+            endpoint="posting/fbs/multi-box-qty/set",
+            json=request.model_dump()
+        )
+        return PostingFBSMultiBoxQtySetResponse(**response)

{ozonapi_async-0.4.0 → ozonapi_async-0.6.0}/src/ozonapi/seller/schemas/fbs/__init__.py

@@ -9,39 +9,48 @@ __all__ = [
     "PostingFBSCustomer",
     "PostingFBSCustomerAddress",
     "PostingFBSDeliveryMethod",
+    "PostingFBSFilterWith",
     "PostingFBSFinancialData",
     "PostingFBSFinancialDataProducts",
+    "PostingFBSGetByBarcodeRequest",
+    "PostingFBSGetByBarcodeResponse",
+    "PostingFBSGetRequest",
+    "PostingFBSGetResponse",
     "PostingFBSLegalInfo",
     "PostingFBSOptional",
     "PostingFBSPosting",
-    "PostingFBSProducts",
+    "PostingFBSProduct",
+    "PostingFBSProductDetailed",
     "PostingFBSRequirements",
     "PostingFBSTariffication",
     "PostingFBSListRequestFilterLastChangedStatusDate",
-    "PostingFBSListFilterWith",
     "PostingFBSListFilter",
     "PostingFBSListRequest",
     "PostingFBSListResult",
     "PostingFBSListResponse",
+    "PostingFBSMultiBoxQtySetRequest",
+    "PostingFBSMultiBoxQtySetResponse",
     "PostingFBSUnfulfilledListRequest",
     "PostingFBSUnfulfilledListResponse",
     "PostingFBSUnfulfilledListRequestFilterLastChangedStatusDate",
-    "PostingFBSUnfulfilledListFilterWith",
     "PostingFBSUnfulfilledListFilter",
     "PostingFBSUnfulfilledListResult",
 ]
 
 from .entities import PostingFBSAddressee, PostingFBSAnalyticsData, PostingFBSBarcodes, PostingFBSCancellation, \
     PostingFBSCustomer, PostingFBSCustomerAddress, PostingFBSDeliveryMethod, PostingFBSFinancialData, \
-    PostingFBSFinancialDataProducts, PostingFBSLegalInfo, PostingFBSOptional, PostingFBSPosting, PostingFBSProducts, \
-    PostingFBSRequirements, PostingFBSTariffication
-from .v3__posting_fbs_list import PostingFBSListRequestFilterLastChangedStatusDate, PostingFBSListFilterWith, \
+    PostingFBSFinancialDataProducts, PostingFBSLegalInfo, PostingFBSOptional, PostingFBSPosting, \
+    PostingFBSProductDetailed, \
+    PostingFBSRequirements, PostingFBSTariffication, PostingFBSFilterWith, PostingFBSProduct
+from .v2__posting_fbs_get_by_barcode import PostingFBSGetByBarcodeRequest, PostingFBSGetByBarcodeResponse
+from .v3__posting_fbs_get import PostingFBSGetRequest, PostingFBSGetResponse
+from .v3__posting_fbs_list import PostingFBSListRequestFilterLastChangedStatusDate, \
     PostingFBSListFilter, PostingFBSListRequest, PostingFBSListResult, PostingFBSListResponse
+from .v3__posting_multiboxqty_set import PostingFBSMultiBoxQtySetResponse, PostingFBSMultiBoxQtySetRequest
 from .v3__posting_fbs_unfulfilled_list import (
     PostingFBSUnfulfilledListRequest,
     PostingFBSUnfulfilledListResponse,
     PostingFBSUnfulfilledListRequestFilterLastChangedStatusDate,
-    PostingFBSUnfulfilledListFilterWith,
     PostingFBSUnfulfilledListFilter,
     PostingFBSUnfulfilledListResult,
 )

{ozonapi_async-0.4.0 → ozonapi_async-0.6.0}/src/ozonapi/seller/schemas/fbs/entities/__init__.py

@@ -11,37 +11,26 @@ __all__ = [
     "PostingFBSLegalInfo",
     "PostingFBSOptional",
     "PostingFBSPosting",
-    "PostingFBSProducts",
+    "PostingFBSProduct",
+    "PostingFBSProductDetailed",
     "PostingFBSRequirements",
     "PostingFBSTariffication",
+    "PostingFBSFilterWith",
 ]
 
 from .posting__analytics_data import PostingFBSAnalyticsData
-
 from .posting__barcodes import PostingFBSBarcodes
-
 from .posting__cancellation import PostingFBSCancellation
-
 from .posting__customer import PostingFBSCustomer
-
 from .posting__customer_address import PostingFBSCustomerAddress
-
 from .posting__delivery_method import PostingFBSDeliveryMethod
-
+from .posting__filter_with import PostingFBSFilterWith
 from .posting__financial_data import PostingFBSFinancialData
-
 from .posting__financial_data_products import PostingFBSFinancialDataProducts
-
 from .posting__legal_info import PostingFBSLegalInfo
-
 from .posting__optional import PostingFBSOptional
-
 from .posting__posting import PostingFBSPosting
-
-from .posting__products import PostingFBSProducts
-
+from .posting__product import PostingFBSProductDetailed, PostingFBSProduct
 from .posting__requirements import PostingFBSRequirements
-
 from .posting__tariffication import PostingFBSTariffication
-
 from .posting__addressee import PostingFBSAddressee

ozonapi_async-0.6.0/src/ozonapi/seller/schemas/fbs/entities/posting__filter_with.py

@@ -0,0 +1,30 @@
+from typing import Optional
+
+from pydantic import Field, BaseModel
+
+
+class PostingFBSFilterWith(BaseModel):
+    """Дополнительные поля, которые нужно добавить в ответ.
+
+    Attributes:
+        analytics_data: Добавить в ответ данные аналитики (опционально)
+        barcodes: Добавить в ответ штрихкоды отправления (опционально)
+        financial_data: Добавить в ответ финансовые данные (опционально)
+        legal_info: Добавить в ответ юридическую информацию (опционально)
+        translit: Выполнить транслитерацию возвращаемых значений (опционально)
+    """
+    analytics_data: Optional[bool] = Field(
+        False, description="Добавить в ответ данные аналитики."
+    )
+    barcodes: Optional[bool] = Field(
+        False, description="Добавить в ответ штрихкоды отправления."
+    )
+    financial_data: Optional[bool] = Field(
+        False, description="Добавить в ответ финансовые данные."
+    )
+    legal_info: Optional[bool] = Field(
+        False, description="Добавить в ответ юридическую информацию."
+    )
+    translit: Optional[bool] = Field(
+        False, description="Выполнить транслитерацию возвращаемых значений."
+    )

{ozonapi_async-0.4.0 → ozonapi_async-0.6.0}/src/ozonapi/seller/schemas/fbs/entities/posting__posting.py

@@ -14,7 +14,7 @@ from .posting__delivery_method import PostingFBSDeliveryMethod
 from .posting__financial_data import PostingFBSFinancialData
 from .posting__legal_info import PostingFBSLegalInfo
 from .posting__optional import PostingFBSOptional
-from .posting__products import PostingFBSProducts
+from .posting__product import PostingFBSProductDetailed
 from .posting__requirements import PostingFBSRequirements
 from .posting__tariffication import PostingFBSTariffication
 
@@ -114,14 +114,14 @@ class PostingFBSPosting(BaseModel):
     posting_number: str = Field(
         ..., description="Номер отправления."
     )
-    products: list[PostingFBSProducts] = Field(
+    products: list[PostingFBSProductDetailed] = Field(
         ..., description="Список товаров в отправлении."
     )
     prr_option: Optional[PrrOption] = Field(
         None, description="Код услуги погрузочно-разгрузочных работ."
     )
     quantum_id: Optional[int] = Field(
-        ..., description="Идентификатор эконом-товара."
+        None, description="Идентификатор эконом-товара."
     )
     requirements: PostingFBSRequirements = Field(
         ..., description="""

ozonapi_async-0.4.0/src/ozonapi/seller/schemas/fbs/entities/posting__products.py → ozonapi_async-0.6.0/src/ozonapi/seller/schemas/fbs/entities/posting__product.py

@@ -5,8 +5,8 @@ from pydantic import Field, BaseModel
 from ....common.enumerations.localization import CurrencyCode
 
 
-class PostingFBSProducts(BaseModel):
-    """Список товаров в отправлении.
+class PostingFBSProduct(BaseModel):
+    """Информация о товаре в отправлении.
 
     Attributes:
         name: Название товара
@@ -14,10 +14,6 @@ class PostingFBSProducts(BaseModel):
         price: Цена товара
         quantity: Количество товара в отправлении
         sku: Идентификатор товара в системе Ozon
-        currency_code: Валюта цен
-        is_blr_traceable: Признак прослеживаемости товара
-        is_marketplace_buyout: Признак выкупа товара в ЕАЭС и другие страны
-        imei: Список IMEI мобильных устройств
     """
     name: str = Field(
         ..., description="Название товара."
@@ -34,6 +30,21 @@ class PostingFBSProducts(BaseModel):
     sku: int = Field(
         ..., description="Идентификатор товара в системе Ozon — SKU."
     )
+
+class PostingFBSProductDetailed(PostingFBSProduct):
+    """Детализированная информация о товаре в отправлении.
+
+    Attributes:
+        name: Название товара
+        offer_id: Идентификатор товара в системе продавца
+        price: Цена товара
+        quantity: Количество товара в отправлении
+        sku: Идентификатор товара в системе Ozon
+        currency_code: Валюта цен
+        is_blr_traceable: Признак прослеживаемости товара
+        is_marketplace_buyout: Признак выкупа товара в ЕАЭС и другие страны
+        imei: Список IMEI мобильных устройств
+    """
     currency_code: CurrencyCode = Field(
         ..., description="Валюта ваших цен. Совпадает с валютой, которая установлена в настройках личного кабинета."
     )

ozonapi_async-0.6.0/src/ozonapi/seller/schemas/fbs/v2__fbs_posting_delivering.py

@@ -0,0 +1,2 @@
+"""https://docs.ozon.com/api/seller/?__rr=1#operation/PostingAPI_FbsPostingDelivering"""
+

ozonapi_async-0.6.0/src/ozonapi/seller/schemas/fbs/v2__posting_fbs_get_by_barcode.py

@@ -0,0 +1,65 @@
+"""https://docs.ozon.com/api/seller/?__rr=1#operation/PostingAPI_GetFbsPostingByBarcode"""
+import datetime
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+from .entities import PostingFBSBarcodes, PostingFBSProduct
+
+
+class PostingFBSGetByBarcodeRequest(BaseModel):
+    """Запрос на получение информации об отправлении по штрихкоду.
+
+    Attributes:
+        barcode: Штрихкод отправления (можно получить с помощью методов posting_fbs_get(), posting_fbs_list() и posting_fbs_unfulfilled_list() в массиве barcodes)
+    """
+    barcode: str = Field(
+        ..., title="Штрихкод отправления (можно получить с помощью методов posting_fbs_get(), posting_fbs_list() и posting_fbs_unfulfilled_list() в массиве barcodes)."
+    )
+
+
+class PostingFBSGetByBarcodeResponse(BaseModel):
+    """Описывает схему ответа на запрос на получение информации об отправлении по штрихкоду.
+
+    Attributes:
+        barcodes: Штрихкоды отправления
+        cancel_reason_id: Идентификатор причины отмены отправления
+        created_at: Дата и время создания отправления
+        in_process_at: Дата и время начала обработки отправления
+        order_id: Идентификатор заказа, к которому относится отправление
+        order_number: Номер заказа, к которому относится отправление
+        posting_number: Номер отправления
+        products: Список товаров в отправлении
+        shipment_date: Дата и время, до которой необходимо собрать отправление (если отправление не собрать к этой дате — оно автоматически отменится)
+        status: Статус отправления
+    """
+    barcodes: PostingFBSBarcodes = Field(
+        ..., description="Штрихкоды отправления"
+    )
+    cancel_reason_id: Optional[int] = Field(
+        None, description="Идентификатор причины отмены отправления"
+    )
+    created_at: datetime.datetime = Field(
+        ..., description="Дата и время создания отправления"
+    )
+    in_process_at: Optional[datetime.datetime] = Field(
+        None, description="Дата и время начала обработки отправления"
+    )
+    order_id: int = Field(
+        ..., description="Идентификатор заказа, к которому относится отправление"
+    )
+    order_number: str = Field(
+        ..., description="Номер заказа, к которому относится отправление"
+    )
+    posting_number: str = Field(
+        ..., description="Номер отправления"
+    )
+    products: list[PostingFBSProduct] = Field(
+        ..., description="Список товаров в отправлении"
+    )
+    shipment_date: datetime.datetime = Field(
+        ..., description="Дата и время, до которой необходимо собрать отправление (если отправление не собрать к этой дате — оно автоматически отменится)"
+    )
+    status: str = Field(
+        ..., description="Статус отправления"
+    )