MPT-17888: add first-level field annotations to catalog service models

mpt_api_client/resources/catalog/authorizations.py

@@ -6,10 +6,37 @@
     ManagedResourceMixin,
 )
 from mpt_api_client.models import Model
+from mpt_api_client.models.model import BaseModel
 
 
 class Authorization(Model):
-    """Authorization resource."""
+    """Authorization resource.
+
+    Attributes:
+        name: Authorization name.
+        external_ids: External identifiers for the authorization.
+        currency: Currency code associated with the authorization.
+        notes: Additional notes.
+        product: Reference to the product.
+        vendor: Reference to the vendor.
+        owner: Reference to the owner account.
+        statistics: Authorization statistics.
+        journal: Journal reference.
+        eligibility: Eligibility information.
+        audit: Audit information (created, updated events).
+    """
+
+    name: str | None
+    external_ids: BaseModel | None
+    currency: str | None
+    notes: str | None
+    product: BaseModel | None
+    vendor: BaseModel | None
+    owner: BaseModel | None
+    statistics: BaseModel | None
+    journal: BaseModel | None
+    eligibility: BaseModel | None
+    audit: BaseModel | None
 
 
 class AuthorizationsServiceConfig:

mpt_api_client/resources/catalog/items.py

@@ -6,14 +6,41 @@
     ManagedResourceMixin,
 )
 from mpt_api_client.models import Model
+from mpt_api_client.models.model import BaseModel
 from mpt_api_client.resources.catalog.mixins import (
     AsyncPublishableMixin,
     PublishableMixin,
 )
 
 
 class Item(Model):  # noqa: WPS110
-    """Item resource."""
+    """Item resource.
+
+    Attributes:
+        name: Item name.
+        description: Item description.
+        external_ids: External identifiers for the item.
+        group: Reference to the item group.
+        unit: Reference to the unit of measure.
+        terms: Reference to the terms and conditions.
+        quantity_not_applicable: Whether quantity is not applicable to this item.
+        status: Item status.
+        product: Reference to the product.
+        parameters: List of parameters associated with this item.
+        audit: Audit information (created, updated events).
+    """
+
+    name: str | None
+    description: str | None
+    external_ids: BaseModel | None
+    group: BaseModel | None
+    unit: BaseModel | None
+    terms: BaseModel | None
+    quantity_not_applicable: bool | None
+    status: str | None
+    product: BaseModel | None
+    parameters: list[BaseModel] | None
+    audit: BaseModel | None
 
 
 class ItemsServiceConfig:

mpt_api_client/resources/catalog/listings.py

@@ -6,10 +6,35 @@
     ManagedResourceMixin,
 )
 from mpt_api_client.models import Model
+from mpt_api_client.models.model import BaseModel
 
 
 class Listing(Model):
-    """Listing resource."""
+    """Listing resource.
+
+    Attributes:
+        authorization: Reference to the authorization.
+        product: Reference to the product.
+        vendor: Reference to the vendor.
+        seller: Reference to the seller.
+        price_list: Reference to the associated price list.
+        primary: Whether this is the primary listing.
+        notes: Additional notes.
+        statistics: Listing statistics.
+        eligibility: Eligibility information.
+        audit: Audit information (created, updated events).
+    """
+
+    authorization: BaseModel | None
+    product: BaseModel | None
+    vendor: BaseModel | None
+    seller: BaseModel | None
+    price_list: BaseModel | None
+    primary: bool | None
+    notes: str | None
+    statistics: BaseModel | None
+    eligibility: BaseModel | None
+    audit: BaseModel | None
 
 
 class ListingsServiceConfig:

mpt_api_client/resources/catalog/price_list_items.py

@@ -8,10 +8,55 @@
     UpdateMixin,
 )
 from mpt_api_client.models import Model
+from mpt_api_client.models.model import BaseModel
 
 
 class PriceListItem(Model):
-    """Price List Item resource."""
+    """Price List Item resource.
+
+    Attributes:
+        status: Price list item status.
+        description: Price list item description.
+        reason_for_change: Reason for the price change.
+        unit_lp: Unit list price.
+        unit_pp: Unit purchase price.
+        markup: Markup percentage.
+        margin: Margin percentage.
+        unit_sp: Unit sell price.
+        p_px1: Purchase price for 1-year term.
+        p_px_m: Purchase price for monthly term.
+        p_px_y: Purchase price for yearly term.
+        s_px1: Sell price for 1-year term.
+        s_px_m: Sell price for monthly term.
+        s_px_y: Sell price for yearly term.
+        l_px1: List price for 1-year term.
+        l_px_m: List price for monthly term.
+        l_px_y: List price for yearly term.
+        price_list: Reference to the parent price list.
+        item: Reference to the associated item.
+        audit: Audit information (created, updated events).
+    """
+
+    status: str | None
+    description: str | None
+    reason_for_change: str | None
+    unit_lp: float | None
+    unit_pp: float | None
+    markup: float | None
+    margin: float | None
+    unit_sp: float | None
+    p_px1: float | None
+    p_px_m: float | None
+    p_px_y: float | None
+    s_px1: float | None
+    s_px_m: float | None
+    s_px_y: float | None
+    l_px1: float | None
+    l_px_m: float | None
+    l_px_y: float | None
+    price_list: BaseModel | None
+    item: BaseModel | None
+    audit: BaseModel | None
 
 
 class PriceListItemsServiceConfig:

mpt_api_client/resources/catalog/price_lists.py

@@ -6,14 +6,39 @@
     ManagedResourceMixin,
 )
 from mpt_api_client.models import Model
+from mpt_api_client.models.model import BaseModel
 from mpt_api_client.resources.catalog.price_list_items import (
     AsyncPriceListItemsService,
     PriceListItemsService,
 )
 
 
 class PriceList(Model):
-    """Price List resource."""
+    """Price List resource.
+
+    Attributes:
+        currency: Currency code for this price list.
+        precision: Decimal precision for prices.
+        default_markup: Default markup percentage.
+        default_margin: Default margin percentage.
+        notes: Additional notes.
+        external_ids: External identifiers for the price list.
+        statistics: Price list statistics.
+        product: Reference to the associated product.
+        vendor: Reference to the vendor.
+        audit: Audit information (created, updated events).
+    """
+
+    currency: str | None
+    precision: int | None
+    default_markup: float | None
+    default_margin: float | None
+    notes: str | None
+    external_ids: BaseModel | None
+    statistics: BaseModel | None
+    product: BaseModel | None
+    vendor: BaseModel | None
+    audit: BaseModel | None
 
 
 class PriceListsServiceConfig:

mpt_api_client/resources/catalog/pricing_policies.py

@@ -9,14 +9,41 @@
     ManagedResourceMixin,
 )
 from mpt_api_client.models import Model, ResourceData
+from mpt_api_client.models.model import BaseModel
 from mpt_api_client.resources.catalog.pricing_policy_attachments import (
     AsyncPricingPolicyAttachmentsService,
     PricingPolicyAttachmentsService,
 )
 
 
 class PricingPolicy(Model):
-    """Pricing policy resource."""
+    """Pricing policy resource.
+
+    Attributes:
+        name: Pricing policy name.
+        external_ids: External identifiers for the pricing policy.
+        client: Reference to the client account.
+        eligibility: Eligibility information.
+        markup: Markup percentage.
+        margin: Margin percentage.
+        notes: Additional notes.
+        products: List of associated products.
+        status: Pricing policy status.
+        statistics: Pricing policy statistics.
+        audit: Audit information (created, updated events).
+    """
+
+    name: str | None
+    external_ids: BaseModel | None
+    client: BaseModel | None
+    eligibility: BaseModel | None
+    markup: float | None
+    margin: float | None
+    notes: str | None
+    products: list[BaseModel] | None
+    status: str | None
+    statistics: BaseModel | None
+    audit: BaseModel | None
 
 
 class PricingPoliciesServiceConfig:

mpt_api_client/resources/catalog/pricing_policy_attachments.py

@@ -10,10 +10,31 @@
     ModifiableResourceMixin,
 )
 from mpt_api_client.models import Model
+from mpt_api_client.models.model import BaseModel
 
 
 class PricingPolicyAttachment(Model):
-    """Pricing Policy Attachment resource."""
+    """Pricing Policy Attachment resource.
+
+    Attributes:
+        name: Attachment name.
+        type: Attachment type.
+        size: File size in bytes.
+        description: Attachment description.
+        file_name: Original file name.
+        content_type: MIME content type of the attachment.
+        status: Attachment status.
+        audit: Audit information (created, updated events).
+    """
+
+    name: str | None
+    type: str | None
+    size: int | None
+    description: str | None
+    file_name: str | None
+    content_type: str | None
+    status: str | None
+    audit: BaseModel | None
 
 
 class PricingPolicyAttachmentsServiceConfig:

mpt_api_client/resources/catalog/product_term_variants.py

@@ -10,14 +10,43 @@
     ModifiableResourceMixin,
 )
 from mpt_api_client.models import Model
+from mpt_api_client.models.model import BaseModel
 from mpt_api_client.resources.catalog.mixins import (
     AsyncPublishableMixin,
     PublishableMixin,
 )
 
 
 class TermVariant(Model):
-    """Term variant resource."""
+    """Term variant resource.
+
+    Attributes:
+        type: Variant type.
+        asset_url: URL to the term variant asset.
+        language_code: Language code for this variant.
+        name: Variant name.
+        description: Variant description.
+        status: Variant status.
+        filename: Original file name.
+        size: File size in bytes.
+        content_type: MIME content type of the file.
+        terms_and_conditions: Reference to the parent terms and conditions.
+        file_id: Identifier of the uploaded file.
+        audit: Audit information (created, updated events).
+    """
+
+    type: str | None
+    asset_url: str | None
+    language_code: str | None
+    name: str | None
+    description: str | None
+    status: str | None
+    filename: str | None
+    size: int | None
+    content_type: str | None
+    terms_and_conditions: BaseModel | None
+    file_id: str | None
+    audit: BaseModel | None
 
 
 class TermVariantServiceConfig:

mpt_api_client/resources/catalog/product_terms.py

@@ -6,6 +6,7 @@
     ManagedResourceMixin,
 )
 from mpt_api_client.models import Model
+from mpt_api_client.models.model import BaseModel
 from mpt_api_client.resources.catalog.mixins import AsyncPublishableMixin, PublishableMixin
 from mpt_api_client.resources.catalog.product_term_variants import (
     AsyncTermVariantService,
@@ -14,7 +15,23 @@
 
 
 class Term(Model):
-    """Term resource."""
+    """Term resource.
+
+    Attributes:
+        name: Term name.
+        description: Term description.
+        display_order: Display order of the term.
+        status: Term status.
+        product: Reference to the product.
+        audit: Audit information (created, updated events).
+    """
+
+    name: str | None
+    description: str | None
+    display_order: int | None
+    status: str | None
+    product: BaseModel | None
+    audit: BaseModel | None
 
 
 class TermServiceConfig: