megaplan-sdk 0.2.0__tar.gz → 0.2.2__tar.gz

{megaplan_sdk-0.2.0/src/megaplan_sdk.egg-info → megaplan_sdk-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: megaplan-sdk
-Version: 0.2.0
+Version: 0.2.2
 Summary: Professional Python SDK for Megaplan API v3
 Author-email: Maxim Borzov <max@borzov.com>
 License-Expression: MIT
@@ -74,6 +74,7 @@ Dynamic: license-file
 - [Автоматическая подгрузка связанных сущностей](#автоматическая-подгрузка-связанных-сущностей)
 - [Работа с фильтрами](#работа-с-фильтрами)
 - [Настройка HTTP-клиента](#настройка-http-клиента)
+- [Работа через прокси](#работа-через-прокси)
 - [Ручное управление токенами](#ручное-управление-токенами)
 
 ### Справочная информация
@@ -313,7 +314,7 @@ entity = await client.{resource}.update(
 ```python
 task = await client.tasks.update(task_id=42, task_data={"status": "completed"})
 project = await client.projects.update(project_id=5, project_data={"name": "Новое название"})
-deal = await client.deals.update(deal_id=200, deal_data={"sum_base": 60000.0})
+deal = await client.deals.update(deal_id=200, deal_data={"price": {"currency": "RUB", "value": 60000}})
 ```
 
 #### Удаление (`delete`)
@@ -516,8 +517,8 @@ tasks = await client.tasks.list(filter=filter_obj)
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения (файлы)
 - `todos: list[BaseEntity]` - Подзадачи-чеклисты
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
 
 ### Упрощенные методы создания
 
@@ -570,6 +571,53 @@ actual_subtasks = await client.tasks.get_actual_sub_tasks(
 # Возвращает: list[Task] - список актуальных подзадач
 ```
 
+### Получение доступных родителей
+
+Методы для получения доступных надзадач и надпроектов (для выбора родителя при создании или перемещении задачи):
+
+```python
+# Глобальный поиск доступных родителей для новой задачи
+# Возвращает список Task и Project объектов
+parents = await client.tasks.get_available_parents(
+    is_template=False,                        # bool: Фильтр по шаблонам
+    limit=10,                                 # int: Количество элементов
+)
+for parent in parents:
+    print(f"{type(parent).__name__}: {parent.name}")  # "Task: ..." или "Project: ..."
+
+# Доступные родители для существующей задачи
+# Исключает саму задачу и её потомков
+parents = await client.tasks.get_available_parents_for(
+    task_id=123,
+    is_template=False,
+    limit=10,
+)
+```
+
+**Примечание:** Методы возвращают смешанный список объектов `Task` и `Project`, так как задача может быть вложена как в другую задачу, так и в проект.
+
+### Получение всех участников задачи
+
+Метод `get_all_participants()` возвращает полный список участников задачи (ответственный, соисполнители, аудиторы, владелец) в одном запросе:
+
+```python
+participants = await client.tasks.get_all_participants(
+    task_id=123,
+    limit=None,                               # int: Количество элементов
+    # ... стандартные параметры пагинации
+)
+# Возвращает: list[Employee | ContractorHuman | Group]
+
+for participant in participants:
+    if hasattr(participant, 'display_name'):
+        print(participant.display_name())
+```
+
+**Типы участников:**
+- `Employee` — сотрудник организации
+- `ContractorHuman` — контрагент-физлицо
+- `Group` — группа участников (например, отдел)
+
 ### Получение задач на уровне дерева
 
 ```python
@@ -727,8 +775,8 @@ milestone = await client.projects.add_milestone(
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения
 - `todos: list[BaseEntity]` - Подзадачи-чеклисты
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
 
 ### Упрощенные методы создания
 
@@ -790,6 +838,45 @@ actual_issues = await client.projects.get_actual_issues(
 # Возвращает: list[Task] - список актуальных задач проекта
 ```
 
+### Получение доступных родителей
+
+Методы для получения доступных родительских проектов (для выбора родителя при создании или перемещении проекта):
+
+```python
+# Глобальный поиск доступных родительских проектов
+parents = await client.projects.get_available_parents(
+    is_template=False,                        # bool: Фильтр по шаблонам
+    limit=10,                                 # int: Количество элементов
+)
+for parent in parents:
+    print(f"Project: {parent.name}")
+
+# Доступные родители для существующего проекта
+# Исключает сам проект и его потомков
+parents = await client.projects.get_available_parents_for(
+    project_id=456,
+    is_template=False,
+    limit=10,
+)
+```
+
+**Примечание:** В отличие от задач, проекты могут быть вложены только в другие проекты, поэтому возвращается список объектов `Project`.
+
+### Получение всех участников проекта
+
+Метод `get_all_participants()` возвращает полный список участников проекта в одном запросе:
+
+```python
+participants = await client.projects.get_all_participants(
+    project_id=123,
+    limit=None,                               # int: Количество элементов
+)
+# Возвращает: list[Employee | ContractorHuman | Group]
+
+for participant in participants:
+    print(f"{type(participant).__name__}: {participant.display_name()}")
+```
+
 ### Получение полной информации о проекте
 
 Метод `get_full_details()` для проектов поддерживает следующие специфичные параметры:
@@ -880,18 +967,26 @@ deals = await client.deals.list(filter=filter_obj)
 ### Поля модели Deal
 - `id: int` - Идентификатор сделки
 - `name: str` - Название сделки
+- `number: str` - Номер сделки
+- `short_description: str` - Краткое описание
 - `program: BaseEntity` - Программа (схема сделки)
 - `state: ProgramState` - Текущий статус в программе
 - `contractor: BaseEntity` - Контрагент (ContractorCompany/ContractorHuman)
-- `responsible: BaseEntity` - Ответственный (Employee)
-- `sum_base: float` - Сумма сделки
+- `manager: BaseEntity` - Ответственный (Employee, API поле `manager`)
+- `price: Money` - Сумма сделки (объект с полями `currency`, `value`)
+- `cost: Money` - Стоимость
+- `debt: Money` - Долг
+- `result: str` - Результат (`"positive"`, `"negative"`, `null`)
 - `currency: BaseEntity` - Валюта
 - `deadline: str` - Срок
-- `description: str` - Описание
+- `description: str` - Описание (только в `deals.get()`, не в списке)
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
+- `state_time_updated: str` - Дата последнего изменения статуса
+
+> **Примечание:** Поля `description`, `deadline` и пользовательские поля доступны только при запросе отдельной сделки через `deals.get(id)`, но не в списке.
 
 **Важно:** При создании сделки обязательно указывать поле `program` (программа/схема сделки).
 
@@ -917,6 +1012,23 @@ deal = await client.deals.apply_trigger(
 # Возвращает: Deal - обновленная сделка
 ```
 
+### Получение всех участников сделки
+
+Метод `get_all_participants()` возвращает полный список участников сделки:
+
+```python
+participants = await client.deals.get_all_participants(
+    deal_id=200,
+    limit=None,                               # int: Количество элементов
+)
+# Возвращает: list[Employee]
+
+for employee in participants:
+    print(employee.display_name())
+```
+
+**Примечание:** В отличие от задач и проектов, сделки возвращают только сотрудников (`Employee`).
+
 ### Получение аудиторов сделки
 
 ```python
@@ -959,7 +1071,7 @@ details = await client.deals.get_full_details(
     include_history=True,                  # Загрузить историю изменений
     include_status_history=True,           # Загрузить историю статусов
     include_auditors=True,                  # Загрузить список аудиторов
-    include_responsible_details=True,      # Загрузить полные данные ответственного
+    include_manager_details=True,          # Загрузить полные данные ответственного
     include_contractor_details=True,       # Загрузить полные данные контрагента
     include_related_tasks=True,            # Загрузить связанные задачи
     comments_limit=50,                     # Лимит комментариев (опционально)
@@ -973,7 +1085,7 @@ details = await client.deals.get_full_details(
 - `history: list[dict] | None` - История изменений
 - `status_history: list[dict] | None` - История статусов
 - `auditors: list[dict] | None` - Аудиторы
-- `responsible_details: Employee | None` - Полные данные ответственного
+- `manager_details: Employee | None` - Полные данные ответственного
 - `contractor_details: Contractor | None` - Полные данные контрагента
 - `related_tasks: list[Task] | None` - Связанные задачи
 
@@ -1174,14 +1286,14 @@ for task_full in tasks_full:
 ### Использование expand в сделках
 
 ```python
-deals_full = await client.deals.list(limit=10, expand=["responsible", "contractor"])
+deals_full = await client.deals.list(limit=10, expand=["manager", "contractor"])
 
 for deal_full in deals_full:
     deal = deal_full.deal
     print(f"Сделка: {deal.name}")
 
-    if deal_full.responsible_details:
-        print(f"Ответственный: {deal_full.responsible_details.display_name()}")
+    if deal_full.manager_details:
+        print(f"Ответственный: {deal_full.manager_details.display_name()}")
 
     if deal_full.contractor_details:
         print(f"Контрагент: {deal_full.contractor_details.display_name()}")
@@ -1192,7 +1304,7 @@ for deal_full in deals_full:
 ```
 
 **Поддерживаемые поля для expand в сделках:**
-- `responsible` - ответственный сотрудник
+- `manager` - ответственный сотрудник
 - `contractor` - контрагент
 
 ### Использование expand в проектах
@@ -1402,6 +1514,48 @@ client = MegaplanClient(
 )
 ```
 
+### Работа через прокси
+
+SDK поддерживает работу через HTTP/HTTPS/SOCKS5 прокси-серверы. Это полезно для корпоративных сетей, где все запросы должны проходить через прокси.
+
+```python
+# HTTP прокси с аутентификацией
+async with MegaplanClient(
+    base_url="https://my.megaplan.ru",
+    username="user@example.com",
+    password="password",
+    proxy="http://login:pass@proxy.corp.local:8080",
+) as client:
+    tasks = await client.tasks.list()
+
+# HTTP прокси без аутентификации
+client = MegaplanClient(
+    base_url="https://my.megaplan.ru",
+    access_token="token",
+    proxy="http://proxy.corp.local:8080",
+)
+
+# HTTPS прокси
+client = MegaplanClient(
+    base_url="https://my.megaplan.ru",
+    access_token="token",
+    proxy="https://proxy.corp.local:8080",
+)
+
+# SOCKS5 прокси (требует httpx[socks])
+client = MegaplanClient(
+    base_url="https://my.megaplan.ru",
+    access_token="token",
+    proxy="socks5://user:pass@proxy.corp.local:1080",
+)
+```
+
+**Поддерживаемые форматы прокси:**
+- `http://proxy:port` - HTTP прокси без аутентификации
+- `http://user:password@proxy:port` - HTTP прокси с аутентификацией
+- `https://proxy:port` - HTTPS прокси
+- `socks5://user:password@proxy:port` - SOCKS5 прокси (требует `pip install httpx[socks]`)
+
 ### Ручное управление токенами
 
 ```python
@@ -1440,13 +1594,39 @@ API возвращает ошибку 500 при попытке получить
 # comments = await client.contractors.get_comments(contractor_id=123)
 
 # Вместо этого используйте комментарии в сделках контрагента
-deals = await client.deals.list(
-    base_on={"contentType": "Contractor", "id": 123}
-)
+deals = await client.contractors.get_deals(contractor_id=123)
 for deal in deals:
     comments = await client.deals.get_comments(deal.id)
 ```
 
+### Получение сделок контрагента
+
+SDK предоставляет удобный метод `get_deals()` для получения сделок контрагента:
+
+```python
+# Получить все сделки контрагента
+deals = await client.contractors.get_deals(
+    contractor_id=123,
+    limit=50  # Опционально
+)
+
+for deal in deals:
+    print(f"[{deal.id}] {deal.name}")
+    if deal.state:
+        print(f"  Статус: {deal.state}")
+```
+
+Это удобнее, чем использование `FilterBuilder`:
+
+```python
+# Альтернатива через FilterBuilder (более сложный способ)
+from megaplan_sdk import TradeFilterBuilder
+filter_obj = TradeFilterBuilder().field("contractor").equals(
+    {"contentType": "Contractor", "id": 123}
+).build()
+deals = await client.deals.list(filter=filter_obj)
+```
+
 ### Поиск сотрудников
 
 Поиск сотрудников по имени или телефону может работать некорректно и возвращать 0 результатов. Для надежного поиска используйте точный email:

{megaplan_sdk-0.2.0 → megaplan_sdk-0.2.2}/README.md

@@ -42,6 +42,7 @@
 - [Автоматическая подгрузка связанных сущностей](#автоматическая-подгрузка-связанных-сущностей)
 - [Работа с фильтрами](#работа-с-фильтрами)
 - [Настройка HTTP-клиента](#настройка-http-клиента)
+- [Работа через прокси](#работа-через-прокси)
 - [Ручное управление токенами](#ручное-управление-токенами)
 
 ### Справочная информация
@@ -281,7 +282,7 @@ entity = await client.{resource}.update(
 ```python
 task = await client.tasks.update(task_id=42, task_data={"status": "completed"})
 project = await client.projects.update(project_id=5, project_data={"name": "Новое название"})
-deal = await client.deals.update(deal_id=200, deal_data={"sum_base": 60000.0})
+deal = await client.deals.update(deal_id=200, deal_data={"price": {"currency": "RUB", "value": 60000}})
 ```
 
 #### Удаление (`delete`)
@@ -484,8 +485,8 @@ tasks = await client.tasks.list(filter=filter_obj)
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения (файлы)
 - `todos: list[BaseEntity]` - Подзадачи-чеклисты
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
 
 ### Упрощенные методы создания
 
@@ -538,6 +539,53 @@ actual_subtasks = await client.tasks.get_actual_sub_tasks(
 # Возвращает: list[Task] - список актуальных подзадач
 ```
 
+### Получение доступных родителей
+
+Методы для получения доступных надзадач и надпроектов (для выбора родителя при создании или перемещении задачи):
+
+```python
+# Глобальный поиск доступных родителей для новой задачи
+# Возвращает список Task и Project объектов
+parents = await client.tasks.get_available_parents(
+    is_template=False,                        # bool: Фильтр по шаблонам
+    limit=10,                                 # int: Количество элементов
+)
+for parent in parents:
+    print(f"{type(parent).__name__}: {parent.name}")  # "Task: ..." или "Project: ..."
+
+# Доступные родители для существующей задачи
+# Исключает саму задачу и её потомков
+parents = await client.tasks.get_available_parents_for(
+    task_id=123,
+    is_template=False,
+    limit=10,
+)
+```
+
+**Примечание:** Методы возвращают смешанный список объектов `Task` и `Project`, так как задача может быть вложена как в другую задачу, так и в проект.
+
+### Получение всех участников задачи
+
+Метод `get_all_participants()` возвращает полный список участников задачи (ответственный, соисполнители, аудиторы, владелец) в одном запросе:
+
+```python
+participants = await client.tasks.get_all_participants(
+    task_id=123,
+    limit=None,                               # int: Количество элементов
+    # ... стандартные параметры пагинации
+)
+# Возвращает: list[Employee | ContractorHuman | Group]
+
+for participant in participants:
+    if hasattr(participant, 'display_name'):
+        print(participant.display_name())
+```
+
+**Типы участников:**
+- `Employee` — сотрудник организации
+- `ContractorHuman` — контрагент-физлицо
+- `Group` — группа участников (например, отдел)
+
 ### Получение задач на уровне дерева
 
 ```python
@@ -695,8 +743,8 @@ milestone = await client.projects.add_milestone(
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения
 - `todos: list[BaseEntity]` - Подзадачи-чеклисты
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
 
 ### Упрощенные методы создания
 
@@ -758,6 +806,45 @@ actual_issues = await client.projects.get_actual_issues(
 # Возвращает: list[Task] - список актуальных задач проекта
 ```
 
+### Получение доступных родителей
+
+Методы для получения доступных родительских проектов (для выбора родителя при создании или перемещении проекта):
+
+```python
+# Глобальный поиск доступных родительских проектов
+parents = await client.projects.get_available_parents(
+    is_template=False,                        # bool: Фильтр по шаблонам
+    limit=10,                                 # int: Количество элементов
+)
+for parent in parents:
+    print(f"Project: {parent.name}")
+
+# Доступные родители для существующего проекта
+# Исключает сам проект и его потомков
+parents = await client.projects.get_available_parents_for(
+    project_id=456,
+    is_template=False,
+    limit=10,
+)
+```
+
+**Примечание:** В отличие от задач, проекты могут быть вложены только в другие проекты, поэтому возвращается список объектов `Project`.
+
+### Получение всех участников проекта
+
+Метод `get_all_participants()` возвращает полный список участников проекта в одном запросе:
+
+```python
+participants = await client.projects.get_all_participants(
+    project_id=123,
+    limit=None,                               # int: Количество элементов
+)
+# Возвращает: list[Employee | ContractorHuman | Group]
+
+for participant in participants:
+    print(f"{type(participant).__name__}: {participant.display_name()}")
+```
+
 ### Получение полной информации о проекте
 
 Метод `get_full_details()` для проектов поддерживает следующие специфичные параметры:
@@ -848,18 +935,26 @@ deals = await client.deals.list(filter=filter_obj)
 ### Поля модели Deal
 - `id: int` - Идентификатор сделки
 - `name: str` - Название сделки
+- `number: str` - Номер сделки
+- `short_description: str` - Краткое описание
 - `program: BaseEntity` - Программа (схема сделки)
 - `state: ProgramState` - Текущий статус в программе
 - `contractor: BaseEntity` - Контрагент (ContractorCompany/ContractorHuman)
-- `responsible: BaseEntity` - Ответственный (Employee)
-- `sum_base: float` - Сумма сделки
+- `manager: BaseEntity` - Ответственный (Employee, API поле `manager`)
+- `price: Money` - Сумма сделки (объект с полями `currency`, `value`)
+- `cost: Money` - Стоимость
+- `debt: Money` - Долг
+- `result: str` - Результат (`"positive"`, `"negative"`, `null`)
 - `currency: BaseEntity` - Валюта
 - `deadline: str` - Срок
-- `description: str` - Описание
+- `description: str` - Описание (только в `deals.get()`, не в списке)
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
+- `state_time_updated: str` - Дата последнего изменения статуса
+
+> **Примечание:** Поля `description`, `deadline` и пользовательские поля доступны только при запросе отдельной сделки через `deals.get(id)`, но не в списке.
 
 **Важно:** При создании сделки обязательно указывать поле `program` (программа/схема сделки).
 
@@ -885,6 +980,23 @@ deal = await client.deals.apply_trigger(
 # Возвращает: Deal - обновленная сделка
 ```
 
+### Получение всех участников сделки
+
+Метод `get_all_participants()` возвращает полный список участников сделки:
+
+```python
+participants = await client.deals.get_all_participants(
+    deal_id=200,
+    limit=None,                               # int: Количество элементов
+)
+# Возвращает: list[Employee]
+
+for employee in participants:
+    print(employee.display_name())
+```
+
+**Примечание:** В отличие от задач и проектов, сделки возвращают только сотрудников (`Employee`).
+
 ### Получение аудиторов сделки
 
 ```python
@@ -927,7 +1039,7 @@ details = await client.deals.get_full_details(
     include_history=True,                  # Загрузить историю изменений
     include_status_history=True,           # Загрузить историю статусов
     include_auditors=True,                  # Загрузить список аудиторов
-    include_responsible_details=True,      # Загрузить полные данные ответственного
+    include_manager_details=True,          # Загрузить полные данные ответственного
     include_contractor_details=True,       # Загрузить полные данные контрагента
     include_related_tasks=True,            # Загрузить связанные задачи
     comments_limit=50,                     # Лимит комментариев (опционально)
@@ -941,7 +1053,7 @@ details = await client.deals.get_full_details(
 - `history: list[dict] | None` - История изменений
 - `status_history: list[dict] | None` - История статусов
 - `auditors: list[dict] | None` - Аудиторы
-- `responsible_details: Employee | None` - Полные данные ответственного
+- `manager_details: Employee | None` - Полные данные ответственного
 - `contractor_details: Contractor | None` - Полные данные контрагента
 - `related_tasks: list[Task] | None` - Связанные задачи
 
@@ -1142,14 +1254,14 @@ for task_full in tasks_full:
 ### Использование expand в сделках
 
 ```python
-deals_full = await client.deals.list(limit=10, expand=["responsible", "contractor"])
+deals_full = await client.deals.list(limit=10, expand=["manager", "contractor"])
 
 for deal_full in deals_full:
     deal = deal_full.deal
     print(f"Сделка: {deal.name}")
 
-    if deal_full.responsible_details:
-        print(f"Ответственный: {deal_full.responsible_details.display_name()}")
+    if deal_full.manager_details:
+        print(f"Ответственный: {deal_full.manager_details.display_name()}")
 
     if deal_full.contractor_details:
         print(f"Контрагент: {deal_full.contractor_details.display_name()}")
@@ -1160,7 +1272,7 @@ for deal_full in deals_full:
 ```
 
 **Поддерживаемые поля для expand в сделках:**
-- `responsible` - ответственный сотрудник
+- `manager` - ответственный сотрудник
 - `contractor` - контрагент
 
 ### Использование expand в проектах
@@ -1370,6 +1482,48 @@ client = MegaplanClient(
 )
 ```
 
+### Работа через прокси
+
+SDK поддерживает работу через HTTP/HTTPS/SOCKS5 прокси-серверы. Это полезно для корпоративных сетей, где все запросы должны проходить через прокси.
+
+```python
+# HTTP прокси с аутентификацией
+async with MegaplanClient(
+    base_url="https://my.megaplan.ru",
+    username="user@example.com",
+    password="password",
+    proxy="http://login:pass@proxy.corp.local:8080",
+) as client:
+    tasks = await client.tasks.list()
+
+# HTTP прокси без аутентификации
+client = MegaplanClient(
+    base_url="https://my.megaplan.ru",
+    access_token="token",
+    proxy="http://proxy.corp.local:8080",
+)
+
+# HTTPS прокси
+client = MegaplanClient(
+    base_url="https://my.megaplan.ru",
+    access_token="token",
+    proxy="https://proxy.corp.local:8080",
+)
+
+# SOCKS5 прокси (требует httpx[socks])
+client = MegaplanClient(
+    base_url="https://my.megaplan.ru",
+    access_token="token",
+    proxy="socks5://user:pass@proxy.corp.local:1080",
+)
+```
+
+**Поддерживаемые форматы прокси:**
+- `http://proxy:port` - HTTP прокси без аутентификации
+- `http://user:password@proxy:port` - HTTP прокси с аутентификацией
+- `https://proxy:port` - HTTPS прокси
+- `socks5://user:password@proxy:port` - SOCKS5 прокси (требует `pip install httpx[socks]`)
+
 ### Ручное управление токенами
 
 ```python
@@ -1408,13 +1562,39 @@ API возвращает ошибку 500 при попытке получить
 # comments = await client.contractors.get_comments(contractor_id=123)
 
 # Вместо этого используйте комментарии в сделках контрагента
-deals = await client.deals.list(
-    base_on={"contentType": "Contractor", "id": 123}
-)
+deals = await client.contractors.get_deals(contractor_id=123)
 for deal in deals:
     comments = await client.deals.get_comments(deal.id)
 ```
 
+### Получение сделок контрагента
+
+SDK предоставляет удобный метод `get_deals()` для получения сделок контрагента:
+
+```python
+# Получить все сделки контрагента
+deals = await client.contractors.get_deals(
+    contractor_id=123,
+    limit=50  # Опционально
+)
+
+for deal in deals:
+    print(f"[{deal.id}] {deal.name}")
+    if deal.state:
+        print(f"  Статус: {deal.state}")
+```
+
+Это удобнее, чем использование `FilterBuilder`:
+
+```python
+# Альтернатива через FilterBuilder (более сложный способ)
+from megaplan_sdk import TradeFilterBuilder
+filter_obj = TradeFilterBuilder().field("contractor").equals(
+    {"contentType": "Contractor", "id": 123}
+).build()
+deals = await client.deals.list(filter=filter_obj)
+```
+
 ### Поиск сотрудников
 
 Поиск сотрудников по имени или телефону может работать некорректно и возвращать 0 результатов. Для надежного поиска используйте точный email:

{megaplan_sdk-0.2.0 → megaplan_sdk-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "megaplan-sdk"
-version = "0.2.0"
+version = "0.2.2"
 description = "Professional Python SDK for Megaplan API v3"
 readme = "README.md"
 requires-python = ">=3.11"