partnermax 0.2.0

package/resources/dealers/nlt/offers.mjs

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+export class Offers extends APIResource {
+    /**
+     * Full offer detail. Payload shape mirrors apimax MCP `get_nlt_offer_details`
+     * bit-for-bit (mcp_server.py:1546-1606).
+     */
+    retrieve(offerID, params, options) {
+        const { dealer_id } = params;
+        return this._client.get(path `/v1/dealers/${dealer_id}/nlt/offers/${offerID}`, options);
+    }
+    /**
+     * Listing of NLT offers with monthly canon repriced for this dealer.
+     *
+     * Strategy:
+     *
+     * 1. Resolve + ACL the dealer.
+     * 2. Pull at most `limit + 1` offers from the catalog after the cursor. The extra
+     *    row lets us know if there's a next page without a second COUNT(\*) query.
+     * 3. Apply text/enum filters server-side via SQL where possible (brand, segment,
+     *    fuel) and the numeric `canone_max_eur` filter in Python after the pricing
+     *    pass (the DB has no "displayed canon" column; we synthesize it per dealer).
+     * 4. For each surviving offer, price the (duration, km) cells the caller filtered
+     *    to (if specified) or all 18, pick the cheapest cell as the headline.
+     */
+    list(dealerID, query = {}, options) {
+        return this._client.get(path `/v1/dealers/${dealerID}/nlt/offers`, { query, ...options });
+    }
+}
+//# sourceMappingURL=offers.mjs.map

package/resources/dealers/nlt/offers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.mjs","sourceRoot":"","sources":["../../../src/resources/dealers/nlt/offers.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAGrD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;OAGG;IACH,QAAQ,CACN,OAAe,EACf,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,eAAe,SAAS,eAAe,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,QAAgB,EAChB,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,eAAe,QAAQ,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;CACF"}

package/resources/dealers/nlt-settings.d.mts

@@ -0,0 +1,221 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class NltSettings extends APIResource {
+    /**
+     * Return current NLT economics for the dealer.
+     */
+    retrieve(dealerID: string, options?: RequestOptions): APIPromise<NltSettings>;
+    /**
+     * Set markup percent (0-10) and three down-payment tiers (strictly ascending).
+     *
+     * Validation:
+     *
+     * - `agency_markup_percent` ∈ [0, 10] (Pydantic).
+     * - `down_payment_tiers.{low,medium,high}` each
+     *   `{percent_of_list (0–100), fixed_eur (≥0)}`. No strict-ascending check — the
+     *   final EUR per tier is offer-dependent (`listino_imponibile * pct + eur`).
+     *
+     * Persistence:
+     *
+     * - `agency_markup_percent` → `dealer_public.nlt_agency_percent` (rounded to int;
+     *   live column is `Integer NOT NULL DEFAULT 2`).
+     * - `down_payment_tiers` → `dealer_public.nlt_anticipi_config` JSONB, stored in
+     *   apimax shape `[{"pct": <0..1>, "eur": <int>}, ...]`. The partner-facing
+     *   `percent_of_list` (0–100) is divided by 100 to keep the column byte-compatible
+     *   with the DealerMAX UI calculator that reads the same JSONB.
+     *
+     * There is NO `vat_treatment` field: VAT is per-offer (`nlt_offerte.solo_privati`)
+     * in the canonical DataMax pricing model, not per-dealer. The offer detail
+     * endpoint surfaces it per row instead.
+     *
+     * `Idempotency-Key` replay uses the shared endpoint helper; a re-applied identical
+     * PATCH is also a row-level no-op by construction.
+     */
+    update(dealerID: string, params: NltSettingUpdateParams, options?: RequestOptions): APIPromise<NltSettings>;
+}
+/**
+ * Three down-payment scenarios (basso / medio / alto).
+ *
+ * No strict-ascending validation: the final EUR amount depends on the offer's list
+ * price (`tier.percent_of_list / 100 * listino_imponibile + tier.fixed_eur`), so a
+ * tier that looks larger by % can produce a smaller EUR on cheap vehicles. Label
+ * semantics (low/medium/high) are advisory — apimax/DealerMAX UI treats the 3
+ * positions as opaque slots ordered by intent.
+ */
+export interface DownPaymentTiers {
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    high: DownPaymentTiers.High;
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    low: DownPaymentTiers.Low;
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    medium: DownPaymentTiers.Medium;
+}
+export declare namespace DownPaymentTiers {
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    interface High {
+        /**
+         * Flat EUR component added on top of the percentage (e.g. promo
+         * `0% + 500 EUR fissi`). Whole euros only.
+         */
+        fixed_eur: number;
+        /**
+         * Percentage of the IVA-excluded list price applied as down payment for this tier.
+         * Range 0–100. Typical defaults: 0 (low), 12.5 (medium), 25 (high).
+         */
+        percent_of_list: number;
+    }
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    interface Low {
+        /**
+         * Flat EUR component added on top of the percentage (e.g. promo
+         * `0% + 500 EUR fissi`). Whole euros only.
+         */
+        fixed_eur: number;
+        /**
+         * Percentage of the IVA-excluded list price applied as down payment for this tier.
+         * Range 0–100. Typical defaults: 0 (low), 12.5 (medium), 25 (high).
+         */
+        percent_of_list: number;
+    }
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    interface Medium {
+        /**
+         * Flat EUR component added on top of the percentage (e.g. promo
+         * `0% + 500 EUR fissi`). Whole euros only.
+         */
+        fixed_eur: number;
+        /**
+         * Percentage of the IVA-excluded list price applied as down payment for this tier.
+         * Range 0–100. Typical defaults: 0 (low), 12.5 (medium), 25 (high).
+         */
+        percent_of_list: number;
+    }
+}
+/**
+ * Response model for GET / PATCH /v1/dealers/{id}/nlt-settings.
+ *
+ * Note: there is no `vat_treatment` field — VAT is a property of the offer
+ * (`nlt_offerte.solo_privati`), not of the dealer. The offer detail returns the
+ * VAT treatment per row instead.
+ */
+export interface NltSettings {
+    agency_markup_percent: number;
+    dealer_id: string;
+    /**
+     * Three down-payment scenarios (basso / medio / alto).
+     *
+     * No strict-ascending validation: the final EUR amount depends on the offer's list
+     * price (`tier.percent_of_list / 100 * listino_imponibile + tier.fixed_eur`), so a
+     * tier that looks larger by % can produce a smaller EUR on cheap vehicles. Label
+     * semantics (low/medium/high) are advisory — apimax/DealerMAX UI treats the 3
+     * positions as opaque slots ordered by intent.
+     */
+    down_payment_tiers: DownPaymentTiers;
+    effective_from: string;
+    currency?: 'EUR';
+    image_mode?: 'branded' | 'scenario_locked' | 'scenario_seasonal';
+    image_scenario_locked?: 'mediterraneo' | 'cortina' | 'milano' | 'showroom' | 'building' | null;
+}
+export interface NltSettingUpdateParams {
+    /**
+     * Body param
+     */
+    agency_markup_percent: number;
+    /**
+     * Body param: Three down-payment scenarios (basso / medio / alto).
+     *
+     * No strict-ascending validation: the final EUR amount depends on the offer's list
+     * price (`tier.percent_of_list / 100 * listino_imponibile + tier.fixed_eur`), so a
+     * tier that looks larger by % can produce a smaller EUR on cheap vehicles. Label
+     * semantics (low/medium/high) are advisory — apimax/DealerMAX UI treats the 3
+     * positions as opaque slots ordered by intent.
+     */
+    down_payment_tiers: DownPaymentTiers;
+    /**
+     * Body param
+     */
+    currency?: 'EUR';
+    /**
+     * Body param
+     */
+    image_mode?: 'branded' | 'scenario_locked' | 'scenario_seasonal';
+    /**
+     * Body param
+     */
+    image_scenario_locked?: 'mediterraneo' | 'cortina' | 'milano' | 'showroom' | 'building' | null;
+    /**
+     * Header param
+     */
+    'Idempotency-Key'?: string;
+}
+export declare namespace NltSettings {
+    export { type DownPaymentTiers as DownPaymentTiers, type NltSettings as NltSettings, type NltSettingUpdateParams as NltSettingUpdateParams, };
+}
+//# sourceMappingURL=nlt-settings.d.mts.map

package/resources/dealers/nlt-settings.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nlt-settings.d.mts","sourceRoot":"","sources":["../../src/resources/dealers/nlt-settings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAI7E;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC;CAW3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC;IAE5B;;;;;;;;;;;OAWG;IACH,GAAG,EAAE,gBAAgB,CAAC,GAAG,CAAC;IAE1B;;;;;;;;;;;OAWG;IACH,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC;CACjC;AAED,yBAAiB,gBAAgB,CAAC;IAChC;;;;;;;;;;;OAWG;IACH,UAAiB,IAAI;QACnB;;;WAGG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;;WAGG;QACH,eAAe,EAAE,MAAM,CAAC;KACzB;IAED;;;;;;;;;;;OAWG;IACH,UAAiB,GAAG;QAClB;;;WAGG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;;WAGG;QACH,eAAe,EAAE,MAAM,CAAC;KACzB;IAED;;;;;;;;;;;OAWG;IACH,UAAiB,MAAM;QACrB;;;WAGG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;;WAGG;QACH,eAAe,EAAE,MAAM,CAAC;KACzB;CACF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAE9B,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;;OAQG;IACH,kBAAkB,EAAE,gBAAgB,CAAC;IAErC,cAAc,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,EAAE,KAAK,CAAC;IAEjB,UAAU,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;IAEjE,qBAAqB,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;CAChG;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;;;;;;;OAQG;IACH,kBAAkB,EAAE,gBAAgB,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;IAEjE;;OAEG;IACH,qBAAqB,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;IAE/F;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/dealers/nlt-settings.d.ts

@@ -0,0 +1,221 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class NltSettings extends APIResource {
+    /**
+     * Return current NLT economics for the dealer.
+     */
+    retrieve(dealerID: string, options?: RequestOptions): APIPromise<NltSettings>;
+    /**
+     * Set markup percent (0-10) and three down-payment tiers (strictly ascending).
+     *
+     * Validation:
+     *
+     * - `agency_markup_percent` ∈ [0, 10] (Pydantic).
+     * - `down_payment_tiers.{low,medium,high}` each
+     *   `{percent_of_list (0–100), fixed_eur (≥0)}`. No strict-ascending check — the
+     *   final EUR per tier is offer-dependent (`listino_imponibile * pct + eur`).
+     *
+     * Persistence:
+     *
+     * - `agency_markup_percent` → `dealer_public.nlt_agency_percent` (rounded to int;
+     *   live column is `Integer NOT NULL DEFAULT 2`).
+     * - `down_payment_tiers` → `dealer_public.nlt_anticipi_config` JSONB, stored in
+     *   apimax shape `[{"pct": <0..1>, "eur": <int>}, ...]`. The partner-facing
+     *   `percent_of_list` (0–100) is divided by 100 to keep the column byte-compatible
+     *   with the DealerMAX UI calculator that reads the same JSONB.
+     *
+     * There is NO `vat_treatment` field: VAT is per-offer (`nlt_offerte.solo_privati`)
+     * in the canonical DataMax pricing model, not per-dealer. The offer detail
+     * endpoint surfaces it per row instead.
+     *
+     * `Idempotency-Key` replay uses the shared endpoint helper; a re-applied identical
+     * PATCH is also a row-level no-op by construction.
+     */
+    update(dealerID: string, params: NltSettingUpdateParams, options?: RequestOptions): APIPromise<NltSettings>;
+}
+/**
+ * Three down-payment scenarios (basso / medio / alto).
+ *
+ * No strict-ascending validation: the final EUR amount depends on the offer's list
+ * price (`tier.percent_of_list / 100 * listino_imponibile + tier.fixed_eur`), so a
+ * tier that looks larger by % can produce a smaller EUR on cheap vehicles. Label
+ * semantics (low/medium/high) are advisory — apimax/DealerMAX UI treats the 3
+ * positions as opaque slots ordered by intent.
+ */
+export interface DownPaymentTiers {
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    high: DownPaymentTiers.High;
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    low: DownPaymentTiers.Low;
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    medium: DownPaymentTiers.Medium;
+}
+export declare namespace DownPaymentTiers {
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    interface High {
+        /**
+         * Flat EUR component added on top of the percentage (e.g. promo
+         * `0% + 500 EUR fissi`). Whole euros only.
+         */
+        fixed_eur: number;
+        /**
+         * Percentage of the IVA-excluded list price applied as down payment for this tier.
+         * Range 0–100. Typical defaults: 0 (low), 12.5 (medium), 25 (high).
+         */
+        percent_of_list: number;
+    }
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    interface Low {
+        /**
+         * Flat EUR component added on top of the percentage (e.g. promo
+         * `0% + 500 EUR fissi`). Whole euros only.
+         */
+        fixed_eur: number;
+        /**
+         * Percentage of the IVA-excluded list price applied as down payment for this tier.
+         * Range 0–100. Typical defaults: 0 (low), 12.5 (medium), 25 (high).
+         */
+        percent_of_list: number;
+    }
+    /**
+     * One down-payment tier — percent of list price + flat EUR.
+     *
+     * apimax: `dealer_public.nlt_anticipi_config` is a JSONB list of three
+     * `{"pct": <0..1>, "eur": <int>}` entries. The final EUR applied to a deal is
+     * `listino_imponibile * pct + eur` (see
+     * `apimax/app/services/nlt/calculator.py::calcola_anticipo_eur`).
+     *
+     * Partnermax API exposes `percent_of_list` as a 0–100 number (UI-friendly: write
+     * `12.5`, not `0.125`); the router persists `pct = percent_of_list / 100` to stay
+     * byte-compatible with the DealerMAX UI calculator.
+     */
+    interface Medium {
+        /**
+         * Flat EUR component added on top of the percentage (e.g. promo
+         * `0% + 500 EUR fissi`). Whole euros only.
+         */
+        fixed_eur: number;
+        /**
+         * Percentage of the IVA-excluded list price applied as down payment for this tier.
+         * Range 0–100. Typical defaults: 0 (low), 12.5 (medium), 25 (high).
+         */
+        percent_of_list: number;
+    }
+}
+/**
+ * Response model for GET / PATCH /v1/dealers/{id}/nlt-settings.
+ *
+ * Note: there is no `vat_treatment` field — VAT is a property of the offer
+ * (`nlt_offerte.solo_privati`), not of the dealer. The offer detail returns the
+ * VAT treatment per row instead.
+ */
+export interface NltSettings {
+    agency_markup_percent: number;
+    dealer_id: string;
+    /**
+     * Three down-payment scenarios (basso / medio / alto).
+     *
+     * No strict-ascending validation: the final EUR amount depends on the offer's list
+     * price (`tier.percent_of_list / 100 * listino_imponibile + tier.fixed_eur`), so a
+     * tier that looks larger by % can produce a smaller EUR on cheap vehicles. Label
+     * semantics (low/medium/high) are advisory — apimax/DealerMAX UI treats the 3
+     * positions as opaque slots ordered by intent.
+     */
+    down_payment_tiers: DownPaymentTiers;
+    effective_from: string;
+    currency?: 'EUR';
+    image_mode?: 'branded' | 'scenario_locked' | 'scenario_seasonal';
+    image_scenario_locked?: 'mediterraneo' | 'cortina' | 'milano' | 'showroom' | 'building' | null;
+}
+export interface NltSettingUpdateParams {
+    /**
+     * Body param
+     */
+    agency_markup_percent: number;
+    /**
+     * Body param: Three down-payment scenarios (basso / medio / alto).
+     *
+     * No strict-ascending validation: the final EUR amount depends on the offer's list
+     * price (`tier.percent_of_list / 100 * listino_imponibile + tier.fixed_eur`), so a
+     * tier that looks larger by % can produce a smaller EUR on cheap vehicles. Label
+     * semantics (low/medium/high) are advisory — apimax/DealerMAX UI treats the 3
+     * positions as opaque slots ordered by intent.
+     */
+    down_payment_tiers: DownPaymentTiers;
+    /**
+     * Body param
+     */
+    currency?: 'EUR';
+    /**
+     * Body param
+     */
+    image_mode?: 'branded' | 'scenario_locked' | 'scenario_seasonal';
+    /**
+     * Body param
+     */
+    image_scenario_locked?: 'mediterraneo' | 'cortina' | 'milano' | 'showroom' | 'building' | null;
+    /**
+     * Header param
+     */
+    'Idempotency-Key'?: string;
+}
+export declare namespace NltSettings {
+    export { type DownPaymentTiers as DownPaymentTiers, type NltSettings as NltSettings, type NltSettingUpdateParams as NltSettingUpdateParams, };
+}
+//# sourceMappingURL=nlt-settings.d.ts.map

package/resources/dealers/nlt-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nlt-settings.d.ts","sourceRoot":"","sources":["../../src/resources/dealers/nlt-settings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAI7E;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC;CAW3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC;IAE5B;;;;;;;;;;;OAWG;IACH,GAAG,EAAE,gBAAgB,CAAC,GAAG,CAAC;IAE1B;;;;;;;;;;;OAWG;IACH,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC;CACjC;AAED,yBAAiB,gBAAgB,CAAC;IAChC;;;;;;;;;;;OAWG;IACH,UAAiB,IAAI;QACnB;;;WAGG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;;WAGG;QACH,eAAe,EAAE,MAAM,CAAC;KACzB;IAED;;;;;;;;;;;OAWG;IACH,UAAiB,GAAG;QAClB;;;WAGG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;;WAGG;QACH,eAAe,EAAE,MAAM,CAAC;KACzB;IAED;;;;;;;;;;;OAWG;IACH,UAAiB,MAAM;QACrB;;;WAGG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;;WAGG;QACH,eAAe,EAAE,MAAM,CAAC;KACzB;CACF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAE9B,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;;OAQG;IACH,kBAAkB,EAAE,gBAAgB,CAAC;IAErC,cAAc,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,EAAE,KAAK,CAAC;IAEjB,UAAU,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;IAEjE,qBAAqB,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;CAChG;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;;;;;;;OAQG;IACH,kBAAkB,EAAE,gBAAgB,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;IAEjE;;OAEG;IACH,qBAAqB,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;IAE/F;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/dealers/nlt-settings.js

@@ -0,0 +1,54 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NltSettings = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+class NltSettings extends resource_1.APIResource {
+    /**
+     * Return current NLT economics for the dealer.
+     */
+    retrieve(dealerID, options) {
+        return this._client.get((0, path_1.path) `/v1/dealers/${dealerID}/nlt-settings`, options);
+    }
+    /**
+     * Set markup percent (0-10) and three down-payment tiers (strictly ascending).
+     *
+     * Validation:
+     *
+     * - `agency_markup_percent` ∈ [0, 10] (Pydantic).
+     * - `down_payment_tiers.{low,medium,high}` each
+     *   `{percent_of_list (0–100), fixed_eur (≥0)}`. No strict-ascending check — the
+     *   final EUR per tier is offer-dependent (`listino_imponibile * pct + eur`).
+     *
+     * Persistence:
+     *
+     * - `agency_markup_percent` → `dealer_public.nlt_agency_percent` (rounded to int;
+     *   live column is `Integer NOT NULL DEFAULT 2`).
+     * - `down_payment_tiers` → `dealer_public.nlt_anticipi_config` JSONB, stored in
+     *   apimax shape `[{"pct": <0..1>, "eur": <int>}, ...]`. The partner-facing
+     *   `percent_of_list` (0–100) is divided by 100 to keep the column byte-compatible
+     *   with the DealerMAX UI calculator that reads the same JSONB.
+     *
+     * There is NO `vat_treatment` field: VAT is per-offer (`nlt_offerte.solo_privati`)
+     * in the canonical DataMax pricing model, not per-dealer. The offer detail
+     * endpoint surfaces it per row instead.
+     *
+     * `Idempotency-Key` replay uses the shared endpoint helper; a re-applied identical
+     * PATCH is also a row-level no-op by construction.
+     */
+    update(dealerID, params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.patch((0, path_1.path) `/v1/dealers/${dealerID}/nlt-settings`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.NltSettings = NltSettings;
+//# sourceMappingURL=nlt-settings.js.map

package/resources/dealers/nlt-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nlt-settings.js","sourceRoot":"","sources":["../../src/resources/dealers/nlt-settings.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;OAEG;IACH,QAAQ,CAAC,QAAgB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,eAAe,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CACJ,QAAgB,EAChB,MAA8B,EAC9B,OAAwB;QAExB,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,eAAe,EAAE;YACpE,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AAjDD,kCAiDC"}

package/resources/dealers/nlt-settings.mjs

@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class NltSettings extends APIResource {
+    /**
+     * Return current NLT economics for the dealer.
+     */
+    retrieve(dealerID, options) {
+        return this._client.get(path `/v1/dealers/${dealerID}/nlt-settings`, options);
+    }
+    /**
+     * Set markup percent (0-10) and three down-payment tiers (strictly ascending).
+     *
+     * Validation:
+     *
+     * - `agency_markup_percent` ∈ [0, 10] (Pydantic).
+     * - `down_payment_tiers.{low,medium,high}` each
+     *   `{percent_of_list (0–100), fixed_eur (≥0)}`. No strict-ascending check — the
+     *   final EUR per tier is offer-dependent (`listino_imponibile * pct + eur`).
+     *
+     * Persistence:
+     *
+     * - `agency_markup_percent` → `dealer_public.nlt_agency_percent` (rounded to int;
+     *   live column is `Integer NOT NULL DEFAULT 2`).
+     * - `down_payment_tiers` → `dealer_public.nlt_anticipi_config` JSONB, stored in
+     *   apimax shape `[{"pct": <0..1>, "eur": <int>}, ...]`. The partner-facing
+     *   `percent_of_list` (0–100) is divided by 100 to keep the column byte-compatible
+     *   with the DealerMAX UI calculator that reads the same JSONB.
+     *
+     * There is NO `vat_treatment` field: VAT is per-offer (`nlt_offerte.solo_privati`)
+     * in the canonical DataMax pricing model, not per-dealer. The offer detail
+     * endpoint surfaces it per row instead.
+     *
+     * `Idempotency-Key` replay uses the shared endpoint helper; a re-applied identical
+     * PATCH is also a row-level no-op by construction.
+     */
+    update(dealerID, params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.patch(path `/v1/dealers/${dealerID}/nlt-settings`, {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=nlt-settings.mjs.map

package/resources/dealers/nlt-settings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nlt-settings.mjs","sourceRoot":"","sources":["../../src/resources/dealers/nlt-settings.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,EAAE,YAAY,EAAE,mCAA+B;AAEtD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACH,QAAQ,CAAC,QAAgB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,eAAe,QAAQ,eAAe,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CACJ,QAAgB,EAChB,MAA8B,EAC9B,OAAwB;QAExB,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,eAAe,QAAQ,eAAe,EAAE;YACpE,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/dealers/nlt.d.mts

@@ -0,0 +1,2 @@
+export * from "./nlt/index.mjs";
+//# sourceMappingURL=nlt.d.mts.map

package/resources/dealers/nlt.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nlt.d.mts","sourceRoot":"","sources":["../../src/resources/dealers/nlt.ts"],"names":[],"mappings":"AAEA,gCAA4B"}

package/resources/dealers/nlt.d.ts

@@ -0,0 +1,2 @@
+export * from "./nlt/index.js";
+//# sourceMappingURL=nlt.d.ts.map

package/resources/dealers/nlt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nlt.d.ts","sourceRoot":"","sources":["../../src/resources/dealers/nlt.ts"],"names":[],"mappings":"AAEA,+BAA4B"}

package/resources/dealers/nlt.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./..\\..\\internal\\tslib.js");
+tslib_1.__exportStar(require("./nlt/index.js"), exports);
+//# sourceMappingURL=nlt.js.map

package/resources/dealers/nlt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nlt.js","sourceRoot":"","sources":["../../src/resources/dealers/nlt.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,yDAA4B"}

package/resources/dealers/nlt.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./nlt/index.mjs";
+//# sourceMappingURL=nlt.mjs.map

package/resources/dealers/nlt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nlt.mjs","sourceRoot":"","sources":["../../src/resources/dealers/nlt.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,gCAA4B"}