release: 0.5.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.4.0"
+  ".": "0.5.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 12
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/azure/partnermax-eb7585f84c961b4388b2cfe057e3dba9edf92af55cd9cb6fa097f0d1ca21c55b.yml
-openapi_spec_hash: fa2c2ed67b11bd033589562913a61a41
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/azure/partnermax-4426eaa7a8352dde34f30097e25554f3361f148d5d424c0f4d4f95a619c5e34c.yml
+openapi_spec_hash: 868381cc42d1ff37e163dd9f243f7762
 config_hash: bf921bb2f4db038ffed15141c74cd018

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.5.0 (2026-05-17)
+
+Full Changelog: [v0.4.0...v0.5.0](https://github.com/DealerMax-app/partnermax-python/compare/v0.4.0...v0.5.0)
+
+### Features
+
+* **api:** api update ([0aabc2c](https://github.com/DealerMax-app/partnermax-python/commit/0aabc2c77be975a277b4e312846d4756c2c3d416))
+
 ## 0.4.0 (2026-05-17)
 
 Full Changelog: [v0.3.0...v0.4.0](https://github.com/DealerMax-app/partnermax-python/compare/v0.3.0...v0.4.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "partnermax"
-version = "0.4.0"
+version = "0.5.0"
 description = "The official Python library for the partnermax API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/partnermax/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "partnermax"
-__version__ = "0.4.0"  # x-release-please-version
+__version__ = "0.5.0"  # x-release-please-version

src/partnermax/resources/dealers/nlt/offers.py

@@ -95,10 +95,10 @@ def list(
         canone_max_eur: int | Omit = omit,
         cursor: str | Omit = omit,
         duration_months: Literal[24, 36, 48] | Omit = omit,
-        fuel_type: Literal["electric", "hybrid", "plugin_hybrid", "petrol", "diesel", "lpg", "methane"] | Omit = omit,
+        fuel_type: str | Omit = omit,
         km_per_year: Literal[10000, 15000, 20000, 25000, 30000, 40000] | Omit = omit,
         limit: int | Omit = omit,
-        segment: Literal["A", "B", "C", "D", "E", "SUV", "VAN"] | Omit = omit,
+        segment: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -118,6 +118,12 @@ def list(
 
           cursor: Opaque pagination cursor.
 
+          fuel_type: Raw Italian label (case-insensitive ILIKE match). Examples: "Benzina", "Diesel",
+              "Ibrido benzina", "Ibrido diesel", "Elettrica", "GPL", "Metano".
+
+          segment: Raw Italian label (case-insensitive ILIKE substring match). Examples: "SUV
+              piccoli", "SUV medi", "Superiori", "Medie", "Utilitarie".
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -224,10 +230,10 @@ async def list(
         canone_max_eur: int | Omit = omit,
         cursor: str | Omit = omit,
         duration_months: Literal[24, 36, 48] | Omit = omit,
-        fuel_type: Literal["electric", "hybrid", "plugin_hybrid", "petrol", "diesel", "lpg", "methane"] | Omit = omit,
+        fuel_type: str | Omit = omit,
         km_per_year: Literal[10000, 15000, 20000, 25000, 30000, 40000] | Omit = omit,
         limit: int | Omit = omit,
-        segment: Literal["A", "B", "C", "D", "E", "SUV", "VAN"] | Omit = omit,
+        segment: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -247,6 +253,12 @@ async def list(
 
           cursor: Opaque pagination cursor.
 
+          fuel_type: Raw Italian label (case-insensitive ILIKE match). Examples: "Benzina", "Diesel",
+              "Ibrido benzina", "Ibrido diesel", "Elettrica", "GPL", "Metano".
+
+          segment: Raw Italian label (case-insensitive ILIKE substring match). Examples: "SUV
+              piccoli", "SUV medi", "Superiori", "Medie", "Utilitarie".
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request

src/partnermax/resources/dealers/nlt_settings.py

@@ -104,12 +104,12 @@ def update(
         ```
         listino_imponibile = prezzo_listino / 1.22
         provvigione = listino_imponibile × (agency_markup_percent / 100)
-        canon = base_canon + provvigione / durata - anticipo_eur / durata
-        if offer.vat_treatment == "private": canon *= 1.22
+        canon = base_canon + provvigione / duration_months - down_payment_eur / duration_months
+        if offer.private_only: canon *= 1.22
         ```
 
-        VAT treatment is a property of each offer (`NltOfferSummary.vat_treatment`), not
-        of the dealer.
+        VAT treatment is a property of each offer (`NltOfferDetail.private_only` /
+        `NltOfferSummary.vat_treatment`), not of the dealer.
 
         Args:
           down_payment_tiers: Three down-payment scenarios shown to consumers, in strictly ascending order
@@ -223,12 +223,12 @@ async def update(
         ```
         listino_imponibile = prezzo_listino / 1.22
         provvigione = listino_imponibile × (agency_markup_percent / 100)
-        canon = base_canon + provvigione / durata - anticipo_eur / durata
-        if offer.vat_treatment == "private": canon *= 1.22
+        canon = base_canon + provvigione / duration_months - down_payment_eur / duration_months
+        if offer.private_only: canon *= 1.22
         ```
 
-        VAT treatment is a property of each offer (`NltOfferSummary.vat_treatment`), not
-        of the dealer.
+        VAT treatment is a property of each offer (`NltOfferDetail.private_only` /
+        `NltOfferSummary.vat_treatment`), not of the dealer.
 
         Args:
           down_payment_tiers: Three down-payment scenarios shown to consumers, in strictly ascending order

src/partnermax/types/dealers/nlt/nlt_offer_summary.py

@@ -12,13 +12,12 @@ class NltOfferSummary(BaseModel):
     brand: str
 
     dealer_id: str
+    """Dealer id (prefixed `dlr_<n>`)."""
 
-    duration_months: Literal[24, 36, 48]
+    duration_months: Literal[36, 48, 60]
     """Duration corresponding to the `monthly_canon_from_eur` quote."""
 
-    fuel_type: Literal["electric", "hybrid", "plugin_hybrid", "petrol", "diesel", "lpg", "methane"]
-
-    km_per_year_at_quote: int
+    km_per_year_at_quote: Literal[10000, 15000, 20000, 25000, 30000, 40000]
     """Km/year corresponding to the `monthly_canon_from_eur` quote."""
 
     model: str
@@ -30,8 +29,13 @@ class NltOfferSummary(BaseModel):
     """
 
     offer_id: str
+    """Numeric `nlt_offerte.id_offerta` as string.
+
+    Use as the path parameter for the detail endpoint.
+    """
 
-    segment: Literal["A", "B", "C", "D", "E", "SUV", "VAN"]
+    slug: str
+    """Offer slug used in canonical URLs (`/noleggio-lungo-termine/{slug}`)."""
 
     vat_treatment: Literal["private", "business"]
     """VAT treatment of this offer (not the dealer).
@@ -41,10 +45,26 @@ class NltOfferSummary(BaseModel):
     """
 
     canonical_url: Optional[str] = None
-    """Consumer-facing URL on the dealer's public site."""
+    """
+    Consumer-facing URL on the dealer's public site:
+    `https://{primary_domain}/noleggio-lungo-termine/{slug}`. Null when the dealer
+    has no site row.
+    """
+
+    fuel_type: Optional[str] = None
+    """Raw Italian label from `nlt_offerte.alimentazione` (e.g.
+
+    "Benzina", "Ibrido diesel"). Apimax-aligned, no enum normalization.
+    """
 
     has_promo: Optional[bool] = None
 
     image_url: Optional[str] = None
 
+    segment: Optional[str] = None
+    """Raw Italian label from `nlt_offerte.segmento` (e.g.
+
+    "SUV piccoli", "Superiori"). Apimax-aligned, no enum normalization.
+    """
+
     trim: Optional[str] = None

src/partnermax/types/dealers/nlt/offer_list_params.py

@@ -19,10 +19,19 @@ class OfferListParams(TypedDict, total=False):
 
     duration_months: Literal[24, 36, 48]
 
-    fuel_type: Literal["electric", "hybrid", "plugin_hybrid", "petrol", "diesel", "lpg", "methane"]
+    fuel_type: str
+    """Raw Italian label (case-insensitive ILIKE match).
+
+    Examples: "Benzina", "Diesel", "Ibrido benzina", "Ibrido diesel", "Elettrica",
+    "GPL", "Metano".
+    """
 
     km_per_year: Literal[10000, 15000, 20000, 25000, 30000, 40000]
 
     limit: int
 
-    segment: Literal["A", "B", "C", "D", "E", "SUV", "VAN"]
+    segment: str
+    """Raw Italian label (case-insensitive ILIKE substring match).
+
+    Examples: "SUV piccoli", "SUV medi", "Superiori", "Medie", "Utilitarie".
+    """