Warranty Autodiscovery

Discover Warranty Details with Device42

Device42 supports auto-discovery of hardware warranties for easy tracking within Device42.

The Device42 warrranty autodiscovery and management tools will find and help you keep track of your hardware warranties from Dell, Lenovo, HP Inc., and IBM. The functionality originally started as a standalone script, which still functions, and is now integrated into the main UI (see Discovery –> Warranty Sync).

Warranty Sync Menu

To configure automatic warranty discovery, you’ll need to simply request API keys from the vendors that require them (currently Dell and HP, links below), and once you’ve provided Device42 with your API access keys, simply let Device42 loose! As long as your device CI’s have a mdoel and serial number present so Device42 knows what vendor to ask, and the ID of the machine, warranty autodiscovery does the rest, automatically discovering and populating your hardware’s service contract information.

Detailed Warranty AutoDiscover Setup Instructions

Supported Models:

  • Dell
  • HP (Hewlett Packard)
  • IBM
  • Lenovo

API Keys, Configuration and Prerequisites:

  1. In order for the script to successfully retrieve warranty information of a given device. The device’s model and serial must be correctly entered or discovered.
  2. If using the script, Python 2.7 must be installed along with the python library requests.
  3. The Device42 Model field must be set to one of the following: “Dell”, “Hewlett Packard”, “IBM” or “Lenovo”.
  4. A Dell API key must be obtained to enable Device42 to retrieve warranty information from Dell. Instructions to obtain a Dell API key are available (in PPT format) from here: http://en.community.dell.com/dell-groups/supportapisgroup/m/mediagallery/20428185
  5. An HP API key must be obtained to enable Device42 to retrieve HP warranty information. Instructions to obtain HP API key: https://developers.hp.com/css-enroll

Secure Communication Details

Both the UI and the warranty script transmit the same information [Relevant serial number(s)] to the appropriate vendor via port 443 SSL, including the API key entered into Device42 for this purpose only if required by the vendor (Dell/HP). Payload looks as follows:

payload = {'id': inline_serials, 'apikey': self.api_key, 'accept': 'Application/json'}

Warranty lookup queries the APIs at the following URLs:

Dell - sandbox.api.dell.com https port 443
Lenovo/IBM - support.lenovo.com https port 443
HP - css.api.hp.com https port 443

Configuring a Job / API key Example

  1. From the TOOLS menu–> Autodiscovery –> Warranty Sync, Choose “Add Warranty Check” and name your job.
  2. Choose a vendor, and if your vendor is Dell or HP, choose your API key. You can store it from the “access key” screen by clicking the magnifying glass, and adding it as such:

Add Warranty Check

  1. Choose your order number generation option, set a schedule if desired, and save the job.
  2. Go ahead and run the job!

As long as your API key is active, devices have valid model, vendor, and serial information the sync will gather warranty information. On each Device in the “LifeCycle” tab or Datacenter > Purchases, you will find past and present warranty information. This includes O/home/device42/d42/docs/media/images/autodiscovery/warranty-discovery-management/rder details, contract/service types, and dates.

Warranty Sync Data

If you are using the STANDALONE Script:

  1. Create working directory. Copy files in Device42’s GitHub warranty_check Repo
  2. Copy warranty.cfg.example to warranty.cfg
  3. Set the required parameters in warranty.cfg [D42 instance info & API keys]:
# set Device42 params
username =
password =
url =


# set api_key as provided by Dell
api_key =
url = https://sandbox.api.dell.com/support/assetinfo/v4/getassetwarranty


# set api_key as provided by HP
api_key =
api_secret =
url = https://css.api.hp.com 
  1. Run the script! [ $ python starter.py ]

Obtaining the standalone script (note: may be deprecated in the future)

As noted, the functionality is now built into the main UI:

The latest version of the standalone script can be downloaded from GitHub