megaplan-sdk 0.2.1__tar.gz → 0.2.3__tar.gz

{megaplan_sdk-0.2.1/src/megaplan_sdk.egg-info → megaplan_sdk-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: megaplan-sdk
-Version: 0.2.1
+Version: 0.2.3
 Summary: Professional Python SDK for Megaplan API v3
 Author-email: Maxim Borzov <max@borzov.com>
 License-Expression: MIT
@@ -73,6 +73,7 @@ Dynamic: license-file
 - [Глобальные дефолтные лимиты](#глобальные-дефолтные-лимиты)
 - [Автоматическая подгрузка связанных сущностей](#автоматическая-подгрузка-связанных-сущностей)
 - [Работа с фильтрами](#работа-с-фильтрами)
+- [Работа с комментариями](#работа-с-комментариями)
 - [Настройка HTTP-клиента](#настройка-http-клиента)
 - [Работа через прокси](#работа-через-прокси)
 - [Ручное управление токенами](#ручное-управление-токенами)
@@ -314,7 +315,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`)
@@ -429,7 +430,7 @@ print(details.deal.name)      # для сделок
 # Связанные данные
 if details.comments:
     for comment in details.comments:
-        print(comment.text)
+        print(comment.content)
 
 if details.history:
     print(f"Записей в истории: {len(details.history)}")
@@ -517,8 +518,39 @@ 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`)
+- `activity: str | None` - Дата последней активности (API поле `activity`)
+- `last_comment_time_created: str | None` - Время последнего комментария (API поле `lastCommentTimeCreated`)
+- `status_change_time: str | None` - Время смены статуса (API поле `statusChangeTime`)
+- `actual_start: str | None` - Фактическое время начала (API поле `actualStart`)
+- `last_view: str | None` - Время последнего просмотра (API поле `lastView`)
+
+### Фильтрация задач по временным полям
+
+Временны́е поля (`activity`, `lastCommentTimeCreated` и др.) не возвращаются в `tasks.list()` по умолчанию.
+Используйте константу `DEFAULT_TASK_LIST_FIELDS`, чтобы запросить их явно:
+
+```python
+from megaplan_sdk import DEFAULT_TASK_LIST_FIELDS
+
+# Запросить задачи с временными полями (activity, lastCommentTimeCreated и др.)
+tasks = await client.tasks.list(
+    limit=50,
+    fields=list(DEFAULT_TASK_LIST_FIELDS),
+)
+for task in tasks:
+    print(f"{task.name}: активность {task.activity}")
+```
+
+> **Примечание:** Сортировка по `"timeUpdated"` не поддерживается API — используйте `"activity"`:
+>
+> ```python
+> tasks = await client.tasks.list(
+>     sort_by=[{"fieldName": "activity", "order": "desc"}],
+>     fields=list(DEFAULT_TASK_LIST_FIELDS),
+> )
+> ```
 
 ### Упрощенные методы создания
 
@@ -775,8 +807,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`)
 
 ### Упрощенные методы создания
 
@@ -967,18 +999,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` (программа/схема сделки).
 
@@ -1063,7 +1103,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,                     # Лимит комментариев (опционально)
@@ -1077,7 +1117,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` - Связанные задачи
 
@@ -1278,14 +1318,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()}")
@@ -1296,7 +1336,7 @@ for deal_full in deals_full:
 ```
 
 **Поддерживаемые поля для expand в сделках:**
-- `responsible` - ответственный сотрудник
+- `manager` - ответственный сотрудник
 - `contractor` - контрагент
 
 ### Использование expand в проектах
@@ -1494,6 +1534,56 @@ updated = await client.filters.update("task", filter_id=123, filter_config={...}
 export_data = await client.filters.export("task", filter_id=123)
 ```
 
+### Работа с комментариями
+
+Комментарии доступны для задач, проектов и сделок через `client.comments`.
+
+#### Получение комментариев
+
+```python
+# Комментарии задачи (entity_type по умолчанию "task")
+comments = await client.comments.list(entity_id=42)
+
+# Комментарии проекта
+comments = await client.comments.list(entity_id=5, entity_type="project")
+
+# Комментарии сделки
+comments = await client.comments.list(entity_id=200, entity_type="deal")
+
+# Автоматическая пагинация
+async for comment in client.comments.iterate(entity_id=42):
+    print(comment.content)
+```
+
+#### Подгрузка авторов через expand
+
+API Мегаплана не раскрывает поле `owner` (автор комментария) в списке комментариев.
+Используйте `expand=["owner"]`, чтобы SDK дозагрузил авторов отдельными запросами (с кэшированием):
+
+```python
+# Комментарии задачи с именами авторов
+comments = await client.comments.list(entity_id=42, expand=["owner"])
+for comment in comments:
+    author_name = comment.owner.name if comment.owner else "неизвестен"
+    print(f"{author_name}: {comment.content}")
+```
+
+#### Создание комментария
+
+```python
+# Комментарий к задаче
+comment = await client.comments.create(entity_id=42, comment_data={"text": "Текст комментария"})
+
+# Комментарий к проекту
+comment = await client.comments.create(entity_id=5, comment_data={"text": "Текст"}, entity_type="project")
+
+# Комментарий к сделке
+comment = await client.comments.create(entity_id=200, comment_data={"text": "Текст"}, entity_type="deal")
+```
+
+> **Ограничение:** Комментарии контрагентов не поддерживаются API (возвращает 500).
+> Используйте комментарии в связанных сделках или задачах.
+
 ### Настройка HTTP-клиента
 
 ```python

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.3}/README.md

@@ -41,6 +41,7 @@
 - [Глобальные дефолтные лимиты](#глобальные-дефолтные-лимиты)
 - [Автоматическая подгрузка связанных сущностей](#автоматическая-подгрузка-связанных-сущностей)
 - [Работа с фильтрами](#работа-с-фильтрами)
+- [Работа с комментариями](#работа-с-комментариями)
 - [Настройка HTTP-клиента](#настройка-http-клиента)
 - [Работа через прокси](#работа-через-прокси)
 - [Ручное управление токенами](#ручное-управление-токенами)
@@ -282,7 +283,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`)
@@ -397,7 +398,7 @@ print(details.deal.name)      # для сделок
 # Связанные данные
 if details.comments:
     for comment in details.comments:
-        print(comment.text)
+        print(comment.content)
 
 if details.history:
     print(f"Записей в истории: {len(details.history)}")
@@ -485,8 +486,39 @@ 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`)
+- `activity: str | None` - Дата последней активности (API поле `activity`)
+- `last_comment_time_created: str | None` - Время последнего комментария (API поле `lastCommentTimeCreated`)
+- `status_change_time: str | None` - Время смены статуса (API поле `statusChangeTime`)
+- `actual_start: str | None` - Фактическое время начала (API поле `actualStart`)
+- `last_view: str | None` - Время последнего просмотра (API поле `lastView`)
+
+### Фильтрация задач по временным полям
+
+Временны́е поля (`activity`, `lastCommentTimeCreated` и др.) не возвращаются в `tasks.list()` по умолчанию.
+Используйте константу `DEFAULT_TASK_LIST_FIELDS`, чтобы запросить их явно:
+
+```python
+from megaplan_sdk import DEFAULT_TASK_LIST_FIELDS
+
+# Запросить задачи с временными полями (activity, lastCommentTimeCreated и др.)
+tasks = await client.tasks.list(
+    limit=50,
+    fields=list(DEFAULT_TASK_LIST_FIELDS),
+)
+for task in tasks:
+    print(f"{task.name}: активность {task.activity}")
+```
+
+> **Примечание:** Сортировка по `"timeUpdated"` не поддерживается API — используйте `"activity"`:
+>
+> ```python
+> tasks = await client.tasks.list(
+>     sort_by=[{"fieldName": "activity", "order": "desc"}],
+>     fields=list(DEFAULT_TASK_LIST_FIELDS),
+> )
+> ```
 
 ### Упрощенные методы создания
 
@@ -743,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`)
 
 ### Упрощенные методы создания
 
@@ -935,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` (программа/схема сделки).
 
@@ -1031,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,                     # Лимит комментариев (опционально)
@@ -1045,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` - Связанные задачи
 
@@ -1246,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()}")
@@ -1264,7 +1304,7 @@ for deal_full in deals_full:
 ```
 
 **Поддерживаемые поля для expand в сделках:**
-- `responsible` - ответственный сотрудник
+- `manager` - ответственный сотрудник
 - `contractor` - контрагент
 
 ### Использование expand в проектах
@@ -1462,6 +1502,56 @@ updated = await client.filters.update("task", filter_id=123, filter_config={...}
 export_data = await client.filters.export("task", filter_id=123)
 ```
 
+### Работа с комментариями
+
+Комментарии доступны для задач, проектов и сделок через `client.comments`.
+
+#### Получение комментариев
+
+```python
+# Комментарии задачи (entity_type по умолчанию "task")
+comments = await client.comments.list(entity_id=42)
+
+# Комментарии проекта
+comments = await client.comments.list(entity_id=5, entity_type="project")
+
+# Комментарии сделки
+comments = await client.comments.list(entity_id=200, entity_type="deal")
+
+# Автоматическая пагинация
+async for comment in client.comments.iterate(entity_id=42):
+    print(comment.content)
+```
+
+#### Подгрузка авторов через expand
+
+API Мегаплана не раскрывает поле `owner` (автор комментария) в списке комментариев.
+Используйте `expand=["owner"]`, чтобы SDK дозагрузил авторов отдельными запросами (с кэшированием):
+
+```python
+# Комментарии задачи с именами авторов
+comments = await client.comments.list(entity_id=42, expand=["owner"])
+for comment in comments:
+    author_name = comment.owner.name if comment.owner else "неизвестен"
+    print(f"{author_name}: {comment.content}")
+```
+
+#### Создание комментария
+
+```python
+# Комментарий к задаче
+comment = await client.comments.create(entity_id=42, comment_data={"text": "Текст комментария"})
+
+# Комментарий к проекту
+comment = await client.comments.create(entity_id=5, comment_data={"text": "Текст"}, entity_type="project")
+
+# Комментарий к сделке
+comment = await client.comments.create(entity_id=200, comment_data={"text": "Текст"}, entity_type="deal")
+```
+
+> **Ограничение:** Комментарии контрагентов не поддерживаются API (возвращает 500).
+> Используйте комментарии в связанных сделках или задачах.
+
 ### Настройка HTTP-клиента
 
 ```python

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.3}/pyproject.toml

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

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.3}/src/megaplan_sdk/__init__.py

@@ -1,6 +1,7 @@
 """Megaplan Python SDK - Professional SDK for Megaplan API v3."""
 
 from megaplan_sdk.client import MegaplanClient
+from megaplan_sdk.constants import DEFAULT_TASK_LIST_FIELDS
 from megaplan_sdk.exceptions import (
     AuthenticationError,
     AuthorizationError,
@@ -26,7 +27,7 @@ from megaplan_sdk.helpers import (
 )
 from megaplan_sdk.logging_config import setup_logging
 from megaplan_sdk.models.comment import Comment
-from megaplan_sdk.models.common import DateTime
+from megaplan_sdk.models.common import DateTime, Money
 from megaplan_sdk.models.contractor import Contractor, ContractorCompany, ContractorHuman
 from megaplan_sdk.models.deal import Deal, DealFullDetails
 from megaplan_sdk.models.department import Department
@@ -66,6 +67,7 @@ __all__ = [
     "Deal",
     "DealFullDetails",
     "Comment",
+    "Money",
     "Contractor",
     "ContractorCompany",
     "ContractorHuman",
@@ -100,6 +102,8 @@ __all__ = [
     "TaskFilterBuilder",
     "TradeFilterBuilder",
     "ProjectFilterBuilder",
+    # Constants
+    "DEFAULT_TASK_LIST_FIELDS",
 ]
 
-__version__ = "0.1.0"
+__version__ = "0.2.3"

megaplan_sdk-0.2.3/src/megaplan_sdk/constants.py

@@ -0,0 +1,42 @@
+"""Constants for Megaplan SDK."""
+
+
+class ContentType:
+    """Content type constants for Megaplan API entities."""
+
+    TASK = "Task"
+    PROJECT = "Project"
+    DEAL = "Deal"
+    EMPLOYEE = "Employee"
+    CONTRACTOR = "Contractor"
+    CONTRACTOR_COMPANY = "ContractorCompany"
+    CONTRACTOR_HUMAN = "ContractorHuman"
+    CONTRACTOR_CATEGORY = "ContractorCategory"
+    DEPARTMENT = "Department"
+    COMMENT = "Comment"
+    GROUP = "Group"
+
+
+# Task fields users commonly try to sort by that the Megaplan API rejects (422).
+# Maps the unsupported field name to the supported replacement to suggest.
+UNSUPPORTED_TASK_SORT_FIELDS: dict[str, str] = {
+    "timeUpdated": "activity",
+    "updatedAt": "activity",
+}
+
+# Recommended `fields` set for tasks.list() so that date fields are populated.
+# Megaplan list endpoints omit these unless explicitly requested, which makes
+# client-side time-window filtering silently return nothing (#8).
+# Only fields confirmed to exist on Task are included (no "timeUpdated" — see #7).
+DEFAULT_TASK_LIST_FIELDS: tuple[str, ...] = (
+    "name",
+    "status",
+    "timeCreated",
+    "activity",
+    "lastCommentTimeCreated",
+    "statusChangeTime",
+    "actualStart",
+    "owner",
+    "responsible",
+    "commentsCount",
+)

megaplan_sdk-0.2.3/src/megaplan_sdk/models/base.py

@@ -0,0 +1,27 @@
+"""Base models for Megaplan SDK."""
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BaseEntity(BaseModel):
+    """Base entity with contentType, id, and optional name.
+
+    All Megaplan entities have ``contentType`` and ``id`` fields.
+    Many API responses also include a ``name`` field even in reference
+    objects, so it is captured here to avoid silent data loss.
+
+    Unknown fields from the API are preserved in ``model_extra`` via
+    ``extra="allow"``, which enables forward compatibility and prevents
+    silent data loss when the API returns new fields.
+
+    Attributes:
+        content_type: Entity type identifier (e.g., "Employee", "Task").
+        id: Entity numeric identifier.
+        name: Optional display name returned by the API in many contexts.
+    """
+
+    content_type: str = Field(alias="contentType")
+    id: int
+    name: str | None = None
+
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.3}/src/megaplan_sdk/models/comment.py

@@ -40,4 +40,4 @@ class Comment(BaseEntity, TimestampMixin):
     is_dropped: bool | None = Field(alias="isDropped", default=None)
     completed: int | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.3}/src/megaplan_sdk/models/common.py

@@ -50,7 +50,7 @@ class File(BaseModel):
     name: str | None = None
     size: int | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
 
 class DateTime(BaseModel):
@@ -66,7 +66,37 @@ class DateTime(BaseModel):
     content_type: str = Field(alias="contentType", default="DateTime")
     value: str
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class Money(BaseModel):
+    """Money model for monetary value fields.
+
+    Megaplan API returns monetary values as structured objects with
+    currency, value, and optional exchange rate information.
+
+    Attributes:
+        content_type: Always "Money".
+        currency: ISO 4217 currency code (e.g., "RUB", "USD").
+        value: Amount in the original currency.
+        value_in_main: Amount converted to the main company currency.
+        rate: Exchange rate relative to the main currency.
+
+    Example:
+        >>> money = Money(contentType="Money", currency="RUB", value=18055000)
+        >>> money.value
+        18055000
+        >>> money.currency
+        'RUB'
+    """
+
+    content_type: str = Field(alias="contentType", default="Money")
+    currency: str = ""
+    value: float | int | None = None
+    value_in_main: float | int | None = Field(None, alias="valueInMain")
+    rate: float | None = None
+
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
 
 class SortField(BaseModel):
@@ -84,10 +114,13 @@ class SortField(BaseModel):
 class TimestampMixin(BaseModel):
     """Mixin for entities with creation and update timestamps.
 
+    Megaplan API returns timestamps using the field names ``timeCreated``
+    and ``timeUpdated`` (not ``createdAt``/``updatedAt``).
+
     Attributes:
-        created_at: Entity creation timestamp.
-        updated_at: Entity last update timestamp.
+        time_created: Entity creation timestamp (API field: ``timeCreated``).
+        time_updated: Entity last update timestamp (API field: ``timeUpdated``).
     """
 
-    created_at: str | DateTime | None = Field(alias="createdAt", default=None)
-    updated_at: str | DateTime | None = Field(alias="updatedAt", default=None)
+    time_created: str | DateTime | None = Field(alias="timeCreated", default=None)
+    time_updated: str | DateTime | None = Field(alias="timeUpdated", default=None)

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.3}/src/megaplan_sdk/models/contractor.py

@@ -40,7 +40,7 @@ class Contractor(BaseEntity, TimestampMixin):
     tags: list[BaseEntity | str] | None = None  # Can be Tag entities or strings
     custom_fields: dict[str, Any] | None = Field(alias="customFields", default=None)
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
     def display_name(self) -> str:
         """Get display name for contractor.