Dell Warranty

On this page

Dell Warranty is an integration that fills in purchase and warranty expiration dates on assets of the manufacturers you list. It runs as the Dell Warranty scheduled task, looks up each asset by its serial number through the Dell API, and writes the dates to the asset's record.

The Default Workflow supplies the integration's scheduled task and parameters. This page describes them as they are in a new 2026.1 database created with the Default Workflow; see Default Workflow Configuration. An administrator may have changed the parameter values since. An upgrade to 2026.1 also imports the Dell Warranty task into the upgraded database. An upgrade from a version that did not have the integration's parameters adds them, and an upgrade keeps the values of the parameters the database already has. Only a migration that reloads the supplied configuration, when you choose Install Default Workflow or migrate from Alloy Navigator Express, replaces them.

The integration is available on-premises and in Alloy Navigator Cloud.

How it works

Each run of the Dell Warranty scheduled task:

  • Selects the assets whose manufacturer matches a name in the Manufacturers parameter.
  • Queries the Dell API with the serial number of each selected asset.
  • Writes two dates to each asset's record:
    • The purchase date, taken from the ship date that Dell returns.
    • The warranty expiration date, the latest end date among the entitlements that Dell returns. Three service types are not counted.

The Manufacturers parameter lists one manufacturer name per line. Each name is compared with the brand names in Alloy Navigator. Spaces are ignored, but any other difference in spelling means the brand does not match. When no brand matches, the task selects no assets: the run reports Total Assets found: 0 and raises no error.

The task's own workflow steps call the Dell API at apigtwb2c.us.dell.com.

Prerequisites

  • A Dell API client ID and API secret. See Get Dell API credentials.
  • To change the integration's settings: in the Settings App, the administrative right that allows managing Workflow Configuration; in the Admin Center, the Workflow Configuration permission. See Permissions Reference.

Get Dell API credentials

Dell issues the client ID and secret through Dell TechDirect, which you sign in to with a Dell business account.

  1. Sign in to Dell TechDirect with your Dell business account, or register if you do not have one.
  2. In TechDirect, request access to the Dell API and submit the request form. Dell processes the request before it issues the credentials.
  3. Copy the client ID and the client secret that Dell issues. The client ID goes into the Dell API Client ID parameter and the client secret into the API Secret parameter; see Integration settings.

Integration settings

The integration has five parameters, on its own settings page in Workflow Configuration, Integrations > Dell Warranty:

  • Manufacturers: the manufacturer names to select, one per line, spelled as your brand names are spelled. Its help text reads "Put each manufacturer on a separate line".
  • Dell API Client ID and API Secret: your Dell API credentials.
  • Debug: its help text reads "Enable debug mode".
  • Safe Mode: when selected, the task calls the Dell API and logs its results without saving asset changes. It has no value in the supplied configuration, so select it before a trial run; otherwise the run writes dates to assets.

Dell API Client ID, API Secret and Safe Mode have no help text.

The API Secret is a parameter of the encrypted type, and the Dell API Client ID a plain-text parameter. Both are stored as workflow parameter values, not with your accounts or mail profiles. Treat an exported workflow file as sensitive: the plain-text values are readable, and the encrypted values can be decrypted by the product.

In the Settings App

  1. Under Workflow and Business Logic, open Workflow Configuration.
  2. In the category tree, select Integrations > Dell Warranty. The right pane shows one control per parameter, with its description.
  3. Enter the values, and then write them with the main window's save command. It writes the changed values of the selected category.

In the Admin Center

  1. Under Workflow and Business Logic, open Workflow Configuration.
  2. Open Integrations > Dell Warranty. The page shows one control per parameter.
  3. Enter the values, and then click Save. Save and Cancel appear once you change a field. If you leave the page with unsaved changes, the Admin Center asks: "You should save you changes before leaving this page. Do you want to leave this page?"

Test in Safe Mode

  1. In Workflow Configuration > Integrations > Dell Warranty, select Safe Mode and save your changes.
  2. Run Dell Warranty manually and review its session log; see Scheduled Tasks.
  3. Confirm that the log identifies the run as a Safe Mode run, and review its results. Its updated-asset count describes the changes that would be saved. A successful job status alone does not distinguish a trial run from a run that saves changes.
  4. When the results are as expected, clear Safe Mode, save, and enable the task's schedule. Later runs save the purchase and warranty dates.

Enable and run the task

The Dell Warranty task is disabled in the supplied configuration, so a new database makes no call to the Dell API until you supply the credentials and enable the task. The configuration an upgrade imports does not change whether an existing Dell Warranty task is enabled. When the upgrade wizard creates a pilot database with Create Pilot Database, it turns off every job of the pilot except the business rules, the job of this task included, and the wizard turns none of them on again; see Upgrade Overview.

The Dell Warranty scheduled task is enabled, run, and its sessions read on the Scheduled Tasks pages of the Settings App and the Admin Center; see Scheduled Tasks.