Zoomed Image
USA
800 691 9120
UK
01225 704844

Dell Warranties

xAssets Configuration Guide
Integration to Specific Applications

Dell Warranties

xAssets can automatically import warranty information for Dell hardware using the Dell TechDirect API. Once configured, the integration retrieves warranty start dates, end dates, and service level details for all Dell assets in your estate, eliminating the need to manually look up and enter warranty data.

What the Integration Provides

The Dell Warranty integration matches Dell assets in your xAssets database by their serial number and retrieves the following warranty information from Dell:

Field Description
Warranty Start Date The date warranty coverage began (typically the ship date)
Warranty End Date The date warranty coverage expires
Service Level The type of warranty coverage (e.g., ProSupport, Basic, Next Business Day)
Warranty Provider Dell or the relevant third-party warranty provider
Warranty Status Whether the warranty is active or expired

This data is written to the warranty fields on each matching asset record, making it available in queries, reports, and the warranty expiry dashboard.

Prerequisites

  • A Dell TechDirect account with API access
  • A Dell API Client ID and Client Secret (obtained from the Dell Developer Portal)
  • Dell assets in your xAssets database with serial numbers populated (typically from discovery)
  • Access to xAssets with permission to create credential packs and run transformations
  • The xAssets Batch Service must be running

Setup

Step 1: Obtain Dell API Credentials

  1. Visit the Dell Developer Portal at developer.dell.com
  1. Sign in or create an account
  2. Register a new application to obtain a Client ID and Client Secret
  3. Note the API endpoint URL provided in the documentation

Tip: Dell may require approval for API access. Allow time for the application review process before planning your go-live date.

Step 2: Create a Credential Pack in xAssets

  1. Navigate to Discover > Prepare > Credentials
  2. Click Create Credentials
  3. Configure the credential pack:
Field Value
Credential Type Named Credentials
Collection Server Application Server
Pack Name Dell Warranty
Username The Client ID from Step 1
Password The Client Secret from Step 1
  1. Save the credential pack

Step 3: Configure the Integration

  1. Navigate to the Dell Warranty integration menu item (typically under Discover > Integrations or Admin > Transformations)
  2. Verify that the transformation is configured to use the Dell Warranty credential pack
  3. The transformation is pre-configured to:
    • Query your xAssets database for Dell assets with serial numbers
    • Call the Dell API for each serial number (or in batches)
    • Write the warranty data back to the corresponding asset records

Step 4: Run the Integration

  1. Run the transformation manually for the first time to verify it works correctly
  2. Check a few Dell assets to confirm that warranty data has been populated
  3. Review any errors in the batch job log -- common issues include invalid serial numbers or API rate limits

Scheduling

After verifying the integration works correctly, schedule it to run automatically:

  1. Navigate to Admin > Batch Jobs > Schedules
  2. Add the Dell Warranty transformation to a schedule
  3. A weekly or monthly frequency is usually sufficient, as warranty data changes infrequently

Tip: Running the integration too frequently may cause unnecessary API calls and could hit Dell's API rate limits. Weekly is usually the right balance between data freshness and API usage.

How the Matching Works

The integration matches Dell assets using the serial number field. For the integration to work:

  1. The asset must have a serial number populated (typically from discovery)
  2. The serial number must be a valid Dell service tag
  3. The asset's manufacturer field should be "Dell" (or a recognised Dell variant)

Assets without serial numbers, or with non-Dell serial numbers, are skipped automatically.

Handling Multiple Warranty Contracts

A single Dell device can have multiple warranty contracts (e.g., a base warranty plus an extended ProSupport contract). The integration handles this by:

  • Recording the latest expiry date as the primary Warranty End Date on the asset
  • Storing details of individual contracts where the data model supports it

Tips

Tip: Run the integration shortly after a large hardware purchase to immediately populate warranty data for the new assets, rather than waiting for the next scheduled run.

Tip: Use the Warranty Expiring dashboard tile to monitor upcoming Dell warranty expirations. This allows you to plan extended warranty purchases or hardware replacements before coverage lapses.

Tip: If you have assets from other Dell subsidiaries (e.g., EMC storage, VMware appliances), check whether the Dell API covers those product lines. Some Dell subsidiary products use different warranty systems.

Warning: Dell API credentials should be treated as sensitive. Do not share them outside of the credential pack. If you suspect they have been compromised, regenerate them in the Dell Developer Portal immediately.