eWarranty Vehicle Look Up
Detailed description of API:
Version & Updates
View Previous Revisions
| Version | Revision Date | Revision History |
|---|---|---|
| 1.0 | August 2022 | New Release |
| 1.1 | 26th Aug 2022 | Reformat |
| 1.2 | 16th Sep 2022 | Adding UAT URLS and version control info |
| 1.3 | 11th Oct 2022 | Subscription key steps in Pre-requisites section. URLs update in Connection details Section. Post man collection in the Examples section |
| 1.4 | 28th Nov 2022 | Update APIM URL to given domain URL |
| 1.5 | 02nd Dec 2022 | Update Prod URLs |
| 1.6 | 31st Aug 2023 | Updated the Pictorial representation of the data flow, Pre-requisites to access the API, Response Codes & Sample Postman Collection and added API, Request types. Moved Authentication Section to API and Connection Details, Sample Request and Response files to Sample Request and Responses section. Renamed Connection Details to API and Connection Details Corrected Navigation Headings |
| 1.7 | 13th Oct 2023 | Updated Response Structure under section 5.1.2 |
| 1.8 | 2nd Jan 2024 | Updated Section 2. Overview by adding additional details on VINs prior to 2012 |
| 1.9 | 20th Jun 2024 | Updated the response structure by adding PipType, PipSeverity into PipTable |
| 2.0 | 22nd Aug 2024 | Updated the response messages and codes |
| 2.1 | 10th Jun 2025 | Added Warranty types |
| 2.2 | 25th Jun 2025 | Added Request type |
| 2.3 | 23rd Sep 2025 | Updated REST API with new PPP information |
| Version | Revision Date | Revision History |
|---|---|---|
| 2.4 | 26th May 2025 | Updated the response structure by adding ETE parameter into vaichile PPP section |
Overview
Warranty Vehicle Lookup interface is designed to allow the dealers to retrieve warranty information from CNHi instance of SAP eWarranty system using with Vehicle Identification Number (VIN) on a real-time basis. The API provides information about the Repair history, PiP, and PPP, Vehicle description, End Customer description along with the Warranty data, for a selected VIN.
Note: API will not have a response for VINs manufactured prior to 2012.
Please refer to diagram below for information on the data flow of this interface.
Pre-requisites
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.
- User within Ownership Group has accepted CNH's Data Acknowledgement (if located in NAFTA)
Authentication
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 Formats
- REST
- SOAP (legacy format)
The DEP takes care of the format transformations (as needed) to process the request and provide a response to the DMS system. New development for this interface are always recommended to the build to REST API for greater simplicity.
DMS providers who already have the connection established to the SAP eWarranty system can continue to use the existing SOAP format. All such DMS providers are required to change the request end point URL alone in their systems (details in connection details section). The response format from the CNHi system will remain unchanged.
Connection Details
Endpoints
| Environment | API URL | API | Request Type |
|---|---|---|---|
| UAT / Staging | https://{base_url}/external/services/warranty/v2/vehiclelookup/{serialnumber} | REST | POST |
| Production | https://{base_url}/external/services/warranty/v2/vehiclelookup/{serialnumber} | REST | POST |
| Environment | API URL | API | Request Type |
|---|---|---|---|
| UAT / Staging | https://{base_url}/external/services/warranty/v1/vehiclelookup | SOAP | POST |
| Production | https://{base_url}/external/services/warranty/v1/vehiclelookup | SOAP | POST |
Response Description
Details
REST
REST Request
https://{base_url}/external/services/warranty/v2/vehiclelookup/{serialnumber}
REST Request Parameters
| Name | Params Type | Type | Is Required | Comments |
|---|---|---|---|---|
| workshopCode | Query Parameter | String | No | Workshop Code |
SOAP Request
<details>
<summary>SOAP</summary>
### SOAP Request
<p>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:sap-com:document:sap:soap:functions:mc-style">
<soapenv:Header/>
<soapenv:Body>
<urn:ZcnWtDmsVehicleLookup>
<SerialNumber>{serialnumber}</SerialNumber>
</urn:ZcnWtDmsVehicleLookup>
</soapenv:Body>
</soapenv:Envelope>
</p>
</details>
Response Structure
| Name | Type | Description |
|---|---|---|
| zcnWtDmsVehicleLookupResponse.vehicleHeader.vehicleNumber | CHAR (10) | SAP INTERNAL VEHICLE NBR (UINQUE) |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.materialNumber | CHAR (18) | FDP/SAP Product (above commercial model) |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.materialNumberDesc | CHAR (40) | FDP Description |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.ldp | CHAR (18) | Product Hierarchy |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.ldpDesc | CHAR (40) | Product Hierarchy Description |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.dealer | CHAR (10) | SAP Dealer Code |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.dealerName | CHAR (35) | SAP Dealer Name |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.serialNumber | CHAR (35) | Vehicle Identification Number (Vehicle Identification No.) |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.vehicleSearchArea | CHAR (10) | Vehicle Search Area |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.commercialModel | CHAR (30) | Commercial Model |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.salesOrg | CHAR (04) | Sales Organization |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.warrantyStartDate | CHAR (10) | Warranty Start Date |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.technicalType | CHAR (10) | Technical Type |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.technicalTypeDesc | CHAR (40) | Technical Type description |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.registrationType | CHAR (10) | Registration Type |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.servicingDealer | CHAR (12) | Partner |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.servicingDealerName | CHAR (35) | Service Dealer Name 1 |
| zcnWtDmsVehicleLookupResponse.vehicleHeader.17serialnum | CHAR (35) | 17 digited - Vehicle Identification Number (Vehicle Identification No.) |
| zcnWtDmsVehicleLookupResponse.VehicleServices.serviceDescription | CHAR (40) | Description for reference |
| zcnWtDmsVehicleLookupResponse.VehicleServices.service | CHAR (18) | Service number |
| zcnWtDmsVehicleLookupResponse.VehicleServices.warrantyType | CHAR (02) | Sort sequence |
| zcnWtDmsVehicleLookupResponse.VehicleServices.serviceDuration | CHAR (30) | Characteristic Value |
| zcnWtDmsVehicleLookupResponse.VehicleServices.serviceStartDate | CHAR (30) | Characteristic Value |
| zcnWtDmsVehicleLookupResponse.VehicleServices.serviceEndDate | CHAR (30) | Characteristic Value |
| zcnWtDmsVehicleLookupResponse.VehicleServices.mileageOrHours | CHAR (30) | Characteristic Value |
| zcnWtDmsVehicleLookupResponse.VehicleServices.serviceEvent | CHAR (03) | Laboratory/design office |
| zcnWtDmsVehicleLookupResponse.VehicleServices.grid | CHAR (20) | Services-vehicle association grid |
| zcnWtDmsVehicleLookupResponse.VehicleServices.gridEvent | CHAR (03) | Laboratory/design office |
| zcnWtDmsVehicleLookupResponse.VehicleServices.monthsPlusMinus | CHAR (05) | Months (+/-) |
| zcnWtDmsVehicleLookupResponse.VehicleServices.masterWarranty | CHAR (20) | Master warranty number |
| zcnWtDmsVehicleLookupResponse.VehicleServices.deductible | CHAR (10) | Numerical field (length 6) |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.cnhClaimNbr | CHAR (12) | CNH SAP Claim Dealer (Unique) |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.dealerClaimNbr | CHAR (10) | Processing Status of Warranty Claim |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.claimProcessingStatus | CHAR (04) | Description of Processing Status of Warranty Claim |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.claimStatusDescription | CHAR (40) | Description of Processing Status of Warranty Claim |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.dealerCode | CHAR (10) | Partner |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.dealerName | CHAR (35) | Data Element Type CHAR Length 35 |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.warrantyType | CHAR (04) | Refer below Warranty Types table |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.warrantyTypeDescription | CHAR (40) | Warranty Type Description |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.vehcileInDate | CHAR (10) | Vehicle In for Repair |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.vehicleHoursAtRepair | NUM (10) | Vehicle HOURS at Repair Time |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.defectCode | CHAR (40) | Defect Code Number |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.failureDescription | CHAR (100) | Failure description |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.totalAmountApproved | NUM (13,2) | Total Amount Approved. This field will be blank if the claim does not belong to the dealer making the inquiry |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.totalLaborApproved | NUM (13,2) | Total Labor Approved. This field will be blank if the claim does not belong to the dealer making the inquiry |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.totalMaterialApproved | NUM (13,2) | Total Material Approved. This field will be blank if the claim does not belong to the dealer making the inquiry |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.totalExtrworkApproved | NUM (13,2) | Total External Work Approved. This field will be blank if the claim does not belong to the dealer making the inquiry |
| zcnWtDmsVehicleLookupResponse.RepairHistoryTable.eligibleFor | CHAR (40) | eligibleFor |
| zcnWtDmsVehicleLookupResponse.PipTable.pipInternalNbr | CHAR (12) | PiP internal ID |
| zcnWtDmsVehicleLookupResponse.PipTable.pipNbr | CHAR (40) | PiP number |
| zcnWtDmsVehicleLookupResponse.PipTable.pipRefDate | CHAR (10) | Reference date |
| zcnWtDmsVehicleLookupResponse.PipTable.pipExpirationDate | CHAR (10) | Expiration date |
| zcnWtDmsVehicleLookupResponse.PipTable.pipDescription | CHAR (60) | Full description of PiP |
| zcnWtDmsVehicleLookupResponse.PipTable.pipExecutionStatus | CHAR (01) | Status of PiP campaign |
| zcnWtDmsVehicleLookupResponse.PipTable.inDate | CHAR (10) | Date field for PiP |
| zcnWtDmsVehicleLookupResponse.PipTable.pipDealer | CHAR (10) | Dealer PiP |
| zcnWtDmsVehicleLookupResponse.PipTable.dealerClaimNumber | CHAR (10) | Dealer PiP number |
| zcnWtDmsVehicleLookupResponse.PipTable.vehicleStolenDate | CHAR (10) | Date of theft |
| zcnWtDmsVehicleLookupResponse.PipTable.vehicleStolenIndicator | CHAR (01) | Theft indicator |
| zcnWtDmsVehicleLookupResponse.PipTable.pipType | CHAR (04) | Pip Type |
| zcnWtDmsVehicleLookupResponse.PipTable.pipSeverity | CHAR (60) | Pip Severity |
| zcnWtDmsVehicleLookupResponse.endCustomer.endCustomerCode | CHAR (10) | Business Partner Number |
| zcnWtDmsVehicleLookupResponse.endCustomer.endCustomerName | CHAR (40) | Name 1 |
| zcnWtDmsVehicleLookupResponse.endCustomer.endCustomerStreet | CHAR (60) | Street |
| zcnWtDmsVehicleLookupResponse.endCustomer.endCustomerCity | CHAR (40) | City |
| zcnWtDmsVehicleLookupResponse.endCustomer.endCustomerState | CHAR (03) | Region (State, Province, County) |
| zcnWtDmsVehicleLookupResponse.endCustomer.endCustomerPostalcode | CHAR (10) | City postal code |
| zcnWtDmsVehicleLookupResponse.endCustomer.endCustomerCountry | CHAR (03) | Country Key |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.vhcle | CHAR (10) | Initial Vehicle Number |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.serialNum | CHAR (35) | Serial Number |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.type | CHAR (35) | Type |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.model | CHAR (30) | Model |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.regisType | CHAR (3) | Registration |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.contractNum | CHAR (35) | Contract Number |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.recordId | CHAR (35) | Record Id |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.numMoths | CHAR (3) | No. of Months |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.numHours | CHAR (9) | No. of Hours |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.cover | CHAR (50) | Coverage |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.deduc | CHAR (10) | Deductible |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.startDat | DATE (10) | Start Date |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.endDat | DATE (10) | End Date |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.serviceFee | NUM (13,2) | Service Fee |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.coverNotes | CHAR (50) | Cover Notes |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.tttmInd | CHAR (10) | TTTM Indicator |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.brand | CHAR (10) | Brand |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.usedInd | CHAR (10) | Used Indicator |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.numHoursFrom | NUM (13,2) | Number of Hours From |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.mpsId | CHAR (10) | MPS Id |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.tcId | CHAR (10) | TC Id |
| zcnWtDmsVehicleLookupResponse.VehiclePpp.ete | CHAR (1) | ETE Indicator |
| zcnWtDmsVehicleLookupResponse.ReturnMessages.Type | CHAR (1) | Return Message Type I – Information E – Exception |
| zcnWtDmsVehicleLookupResponse.ReturnMessages.Message | CHAR (100) | Return Message |
| zcnWtDmsVehicleLookupResponse.ReturnMessages.Number | CHAR (3) | Return Message Number |
| zcnWtDmsVehicleLookupResponse.genericSerial | CHAR (40) | Generic Serial |
Warranty Types
| Warranty Type | Warranty Type Description |
|---|---|
| 0 | Maintenance |
| 1 | Customer warranty |
| 2 | Vendor/manufacturer warranty |
| 3 | High Voltage Components |
| 4 | Velcourt |
| 5 | EV Batteries |
| 6 | Optional Service |
| 7 | Service Assignment Rule (open logic) |
| 8 | Service Assignment Rule (closed logic) |
| 9 | Vehicle master warranty |
| A | Base Warranty |
| B | Extra Base Warranty |
| C | Technical Policy |
| D | Parts Warranty |
| E | Emissions Warranty |
| F | Maintenance SMO |
| G | Standard Extended Warranty |
| H | PIP |
| I | Extended Warranty |
| J | Dealer Demo |
| K | Breakdown assistance |
| L | Rent-to-Own |
| M | Service Quote (Case Care) |
| N | Non-serialized Attachments |
| O | Backhoe boom |
| P | Ultrashield Inspection |
| Q | Major assembly parts warranty |
| R | Purchased Warranty |
| S | Service Coupon |
| T | Commercial Policy |
| U | Ultrashield/Custom Care |
| V | CNH Demo |
| W | Wholegoods Shortage |
| X | WARRANT Programs |
| Y | PPP Warranty |
| Z | P.D.I |
Sample SOAP Response
Download eWarranty Vehicle Lookup SOAP SampleSample REST Response
Download eWarranty Vehicle Lookup REST SampleResponse Codes
The API responses are accompanied with a response code that describes the status (Successful, Unsuccessful) of the request. The below are the possible scenarios and their response codes.
Response Codes
| Status Code | Message |
|---|---|
| 200 | Response body (mentioned above) |
| 400 | Incorrect Serial Number - Please Check Input Serial Number - Invalid Value Entered {Serial Number} |
| 500 | Internal Server Error |
| 400 | 1. Required request body missing error! |
| 400 | 2. Invalid xml format in the request body! |
| 400 | 3. User not setup - Please contact SAP DMS Support Team |
| 400 | 4. Please check Input Serial Number - Invalid Value Entered {Provided VIN} |
| 400 | 5. Please try later - Valid Serial, but not yet ready for warranty {Provided VIN} |
| 400 | 6. Please check Input Serial Number - Appears to be duplicate - WS does not support {Provided VIN} |
| 400 | 7. Invalid json format in the request body! |
| 401 | Access denied due to invalid credentials! |
| 401 | Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API. |