SDKs
DealerMAX ships two SDK tracks. The PartnerMAX
enterprise SDK (partnermax) is generally available for
Python and TypeScript. The dealer read-only SDK
(dealermax), wrapping the public Dealer Public API, is
pre-release — generate from the OpenAPI contract until it ships.
PartnerMAX enterprise SDK Available
For the selected-partner PartnerMAX enterprise API. Published and generally available in two languages, released from CI with OIDC trusted publishing and signed build provenance:
| Python | pip install partnermax — PyPI · partnermax-python |
|---|---|
| TypeScript / Node.js | npm install partnermax — npm · partnermax-node |
For PartnerMAX integrations, these are the only official package names:
partnermax on PyPI and partnermax on npm. Do not
substitute packages named dealermax; that name refers to a
separate future read-only Dealer Public API SDK.
Current PartnerMAX methods
client.dealers.create(...) | Creates an opaque dealer reference through POST /api/partner/dealers. SDK users do not write raw HTTP for dealer creation. |
|---|---|
client.dealers.vehicles.* | Create, list, retrieve, update, delete, and bulk-import used vehicles under one dealer. Every create requires a Motornet UNI code: partners may obtain it from their own Motornet data subscription (Motornet banche dati) or from the paid DealerMAX plate/targa or VIN/telaio resolver, which consumes PartnerMAX credits. Required create fields are dealer_id, motornet_code, plate, registration_year, certified_km, and sale_price_eur when REWIND is enabled. |
client.dealers.vehicles.images.* | Upload/list/delete up to 20 JPEG, PNG, or WebP images per vehicle. Python accepts file=fh; Node uses toFile(stream, name, { type: "image/jpeg" }). |
client.dealers.vehicles.accessories.* | Read or refresh the catalog-backed accessory list, then replace selected optional/package/equipment IDs. |
client.dealers.nlt_settings.* | Set per-dealer markup and down-payment tiers. |
client.dealers.nlt.offers.* | Read dealer-aware NLT listing and detail responses with that dealer's pricing applied. |
See https://developers.dealermax.app/partner for enterprise access.
Dealer read-only SDK Pre-release
The official dealer read-only SDK packages are not published yet. This is
a different SDK track from PartnerMAX: use partnermax for
PartnerMAX, and use OpenAPI generation for the Dealer Public API until
official dealer read-only packages are linked from this page.
| TypeScript / Node.js | No official npm package is published yet. Do not install packages named dealermax unless they are linked from this page or another official DealerMAX developer channel. |
|---|---|
| Python | No official PyPI package is published yet. Do not install packages named dealermax unless they are linked from this page or another official DealerMAX developer channel. |
| Current path | Generate a server-side client from the canonical OpenAPI document: Dealer Public API OpenAPI. |
Until official package links appear here, the Dealer Public API SDK path is code generation from the OpenAPI document, not npm or PyPI installation.
Generation path
The Dealer Public API OpenAPI contract declares response schemas for inventory listing/details and dealer content hub/search/listing/details. Generated clients should therefore preserve typed successful responses, not just typed request parameters.
SDK contract
- Expose only read-only dealer resources.
- Load credentials from explicit constructor params or environment variables.
- Redact API keys from exceptions, logs, and debug output.
- Retry safe
GETrequests on transient failures and respectRetry-After. - Support configurable
baseUrlfor staging and test harnesses.
Release policy
Publish future dealer read-only SDK packages via trusted CI release only, link the official npm/PyPI artifacts from this page in the same release, and do not use local long-lived package tokens.