CSPS Parts Price (New)
Detailed description of API:
Version & Updates
| Version | Revision Date | Revision History |
|---|---|---|
| 1.0 | 9th Jan 2026 | Created a new CSPS Part price API which includes NetPrice and Other details |
Overview
CNH offers a Part Price integration with daily delta capability to seamlessly share the latest updated part price file with DMS’s. Users can retrieve the part price data file queried by date, ensuring they receive the current updated file for the following day. To access the most recent data, dealers should use the previous day as the filter. For handling large volumes of data, such as uploading new files or monthly updates, the existing SFTP is the preferred method.
Pre-requisites
- Dealer must use their Dealer Portal credentials to authorize API call.
- Each DMS provider will have a subscription_key assigned by CNHi team, please reach out to dlnadmssupport@cnh.com for assistance
- Each Subscription key is unique to DMS and the environment it belongs to
- Based on the payload (XML/JSON), user to pass the content-type in the header
Authentication
- DMS will pass Basic auth in HTTP header with username/password
- Each DMS provider will have a subscription_key assigned by CNHi team, please reach out to dlnadmssupport@cnh.com for assistance
- The UserID and Password will be set up in the Dealer Portal by the Dealer uniquely for DMS access to interfaces
- DEP API will require subscription_key in HTTP header to identify client
API Format
- REST
The DEP takes care of the format transformations (as needed) to process the request and provide a response to the DMS system. REST format is always suggested for greater simplicity.
Connection Details
CNHi provides two environments:
- CERT / UAT
- Production
For CSPS Parts Price, CNH offers a single API:
- Net and List Price
Net and List Price
Using this API, DMS/Dealer can request the daily part price list (list price along with net price)
| Environment | URL | API | Request Type |
|---|---|---|---|
| CERT/UAT | https://{base_url}/external/services/csps/partprice/netandlistprice | REST | GET |
| Production | https://{base_url}/external/services/csps/partprice/netandlistprice | REST | GET |
Request Description
Note: validityDate is case sensitive| Name | Params Type | Type | Is Required | Default Value | Comments |
|---|---|---|---|---|---|
| validityDate | Query | Date Time | True | - | Effective date of price for a part: Date to be applied as YYYY-MM-DD format Eastern Standard Time |
Response Description
| Name | Type | Description |
|---|---|---|
| statusCode | Integer | Response Status Code |
| message | String | Response Message |
| returnedDocumentsCount | Integer | Returned Documents Count |
| documents.MARKETING_UNIT_CODE | String | Marketing unit code. USA1 or CAN1 |
| documents.BRAND_CODE | String | Band Code |
| documents.REGION_CODE | String | Region Code. For NAFTA this code is 4 |
| documents.PART_CODE | String | Part code |
| documents.COUNTRY_ISO_CODE | String | Contry |
| documents.VALIDITY_START_DATE | DateTime | Validity start date |
| documents.VALIDITY_END_DATE | DateTime | Validity end date |
| documents.LIST_PRICE | Integer | List Price Amount |
| documents.NET_PRICE | Integer | Net Price Amount (List Price - Discount Amount) |
| documents.CURRENCY | String | Currency name ( Canadian Dollar, United States Dollar) |
| documents.PART_DISCOUNT_CODE | String | Part discount code (PDC) |
| documents.UPDATE_DATE | String | Update Date |
Sample Response
Download Parts Price List SampleResponse Codes
| Status Code | Reason |
|---|---|
| 200 | Success |
| 400 | Please input a valid validity date |
| 400 | Input date cannot be future date. |
| 400 | Parts price file larger than API load [5000], total item found:[TOTALCOUNT]. Please use SFTP server to ingest file |
| 401 | Access denied due to invalid credentials! |
| 401 | Access denied due to missing subscription key. Make sure to include a subscription key when making requests to an API. |
| 500 | Internal Server Error |