Retrieve and manage information for Dell orders.
You can access details about the orders placed with Dell, such as the order status, tracking information for the orders, and shipment details. You can retrieve information about the assets included in each order, such as serial numbers, quantities, and descriptions.
Important
In order to successfully run the integration, you need to provide the order numbers, DPIDs, or PO numbers associated with the order that you want to track.
To learn more about the API that is used in the integration, see Dell OrderStatus API 3.
Connect Oomnitza and Dell in minutes
Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:
- Configurable dashboards and list views of key asset information
- Configurable reports to share information about orders with your colleagues and management
Note on the Dell basic integration
This integration is a local basic integration, which means that it must be managed on your local machine. Before you complete the integration, you must configure your local environment, download the Oomnitza connector, update a configuration file, and push it to your Oomnitza instance. Finally, you must manage the scheduling of your basic integration on your local machine. You can use tools such as Task Scheduler for scheduling.
The process of retrieving Dell orders is significantly easier using an extended integration. In comparison with the basic integration, the set up steps required are minimal, and you can manage Oomnitza credentials, the mapping of fields, integration runs, the setting of set schedules, and troubleshooting all from the integrations page in your Oomnitza instance.
See Creating an extended shim integration for Dell Order Assets.
Before you start
To stream data into Oomnitza, complete these tasks:
- Review the system requirements.
- Download and install Python. Best practice is to create a virtual environment. A virtual environment is created on top of the existing Python installation and can be isolated from the packages in the base environment, so only those explicitly installed in the virtual environment are available.
Download the source code for the Oomnitza connector
-
In Oomnitza, click Configuration > Integrations and click Block view
- In the Basic section for Asset Integrations, click the Dell tile.
- Download the source code and place it in a directory, such as
C:\oomnitza_connector
You can also download the source code on the Oomnitza Connector page on GitHub.
Installing the requirements
In the directory you created (C:\oomnitza_connector), install the required Python dependencies stored in the requirements.txt file using pip install -r requirements.txt
Tip
Run pip install --upgrade pip before installing and use the new version of pip
Generate the configuration file
In the same directory, runpython connector.py generate-ini to generate theconfig.inifile. For further information read the Connector Configs section in the Getting started document.
Tip
Run python connector.py --help to see all available command line options.
Edit the configuration file
You must modify the following sections in the configuration file:
- The Oomnitza section
- The Dell section
Before you edit the configuration file, you must retrieve the following information:
Your Oomnitza token which can be created in Configuration > Security > API tokens.
Your Dell Client ID and Secret.
This integration uses the Dell Order Status API. This API cannot be implemented without the help of the Dell Integration Team and requires your organization to have an established Premier page. If you do not have a Premier page, please visit the Premier Solutions Page to apply for a Premier account. If you already have a Premier page, please contact your Dell account team to request assistance with a B2B API integration. Your account team can get you connected with the right Dell technical resources to guide you through the API implementation process.
The Dell account team may request a redirect URI. The redirect URI is the endpoint that the authorization server will send the user after they grant access to your application. You'll need to supply the following URI: https://generic-oauth2-proxy.oomnitza.com/oauth2/redirect_url
- Open the configuration file that you generated in edit mode.
- In the Oomnitza section, enter the URL of your Oomnitza instance and enter the API token that you generated in Oomnitza.
Oomnitza configuration settings
[oomnitza]
url= https://<name_of_instance>.oomnitza.com
api token = <my_Oomnitza_token> - In the [dell_asset_order_status] section, make the following changes:
- Set enable to True.
- Enter your Dell Client ID and Secret
- is_dp_id: Set to True to input DPIDs.
- is_po_numbers: Set to True to input PO Numbers.
- is_order_no_country_code: Set to True to input Order Numbers and country code.
- values: Enter the PO Numbers, DPIDs, or Order Numbers you want to retrieve using the format specified below. You can enter a maximum of 10 values.
- country_code: If you choose to input Order Numbers, include an ISO two-digit country code using the format specified below. For a list of approved country codes, refer to the Appendix: Country Code Enumeration section in
Dell OrdeStatus API.
[dell_asset_order_status]
enable = True
client_id = *****
client_secret = *****
is_dp_id = False
is_po_numbers = True
is_order_no_country_code = False
values = ["PO123", "PO432"]
country_code = ["GB", "FR", "IN"] - You can delete all the other configurations you do not need from the list, i.e. Kace, Jasper, etc.
- Save your changes.
Map Dell fields to Oomnitza fields
Map Dell fields to Oomnitza fields to get the asset information that you need. For the field mapping, it is recommended to follow these steps:
-
Click Configuration > Integrations and click Block view
- In the Basic section for Asset Integrations, click the Dell tile.
- Click Mappings.
- Map the Dell fields to the Oomnitza fields.
- Select the Serial Number as the sync key, which will synchronize the data that is streamed from Dell to Oomnitza.
- Click FINISH.
When your connector is uploaded to Oomnitza, it will use the mappings that you have configured.
Custom mappings
Actual Shipment Date
Dell Purchase ID
Description
Estimated Delivery Date
Estimated Shipment Date
Invoice Date
Invoice Number
Item Quantity
Order Number
Order Status
Purchase Order Date
Purchase Order Number
Purchase Order Status
Revised Delivery Date
Revised Shipment Date
Serial Number
Shipping Information: City
Shipping Information: Company Name
Shipping Information: Contact Address 1
Shipping Information: Contact Address 2
Shipping Information: Contact Name
Shipping Information: Country
Shipping Information: Postal Code
Shipping Information: State Province
Status Date and Time
SKU Number
The Serial Number corresponds to productInfo.serviceTags in the response. Service tags are unique identifiers for Dell devices.
Run the Dell network devices connector
To upload the Dell information to Oomnitza, run the connector.
Run the connector in test mode to ensure that the mapped information is uploaded to Oomnitza:
python connector.py upload dell_asset_order_status --testmode
When you are confident that you are uploading the information that you mapped, run the connector again in normal mode:
python connector.py upload dell_asset_order_status
Getting your results
-
Click Configuration > Integrations and click Block view
- In the Basic section for Asset Integrations, click the Dell tile.
- Click SYNC SESSIONS.
- Go to the Assets page and review the information that is uploaded.
Schedule
To find out how to schedule the Dell integration, contact Support or see Installing the connector
Unleash the power of Oomnitza
To get valuable actionable insights that help you manage your assets, learn how to:
- Configure dashboards for your assets
- Configure custom reports about your assets
See Getting started.
Comments
0 comments
Please sign in to leave a comment.