External Service HP Warranty API
Advanced Insights (this is not relevant for Patch Insights) can access device warranty information from a variety of vendors. For access to HP warranty information you will need to sign up to HP Workforce Experience, enrol all the HP devices you want to collect warranty data on and set up a developer account to access the warranty data.
You will need to be a HP Workforce Experience customer for this to work, please speak to your HP representative about becoming a customer.
Developer account creation
First, we will create the developer account needed to interact with the HP Workforce Experience api.
Initial setup
API Enrolment
The url for the HP developer portal is https://developers.hp.com/
First, you will need to create an account if you do not have one already. If you have a HPID for HP Workforce Experience, you can use this account.
Once you have registered, you will need to message your HP representative and request access to the HP Proactive Insights APIs tech group for your developer account.
Creating credentials
The link to generate api credentials is: https://developers.hp.com/group/1275/manage-credentials/apis
Please visit the link above to open the credentials generation page. You will be show the following options below. Click Get Credentials in the HP Proactive Insights Analytics section.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252Fvg24dsOMCxZW3ADxHuBe%252Fimage.png%3Falt%3Dmedia%26token%3D1f5a0d25-61c7-4efb-9cc6-453e84c071b0&width=768&dpr=4&quality=100&sign=ad8b3a9&sv=1)
If the page has an error screen like shown below, HP have not enrolled your developer account in the HP Proactive Insights APIs tech group. Please contact HP again to have your account enrolled in the HP Proactive Insights API tech group.
![This image showcases the Hp Proactive Insights API web page, with the error You do not have appropriate permissions (role) to access any of this Tech Groups published Apis](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FAoCpecIVW3lVqLLwDfT7%252Fhp%2520no%2520api.png%3Falt%3Dmedia%26token%3Dc7acaa61-c2f7-4402-8731-f626e31c1016&width=768&dpr=4&quality=100&sign=f8cab51d&sv=1)
Credentials creation flow
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FO33iN0sbI6HheMleJkjm%252Fimage.png%3Falt%3Dmedia%26token%3D6596fea0-24e2-429a-95d3-e842802fd1f4&width=768&dpr=4&quality=100&sign=9fd3f3fd&sv=1)
You will need to provide the following information:
Credentials name: We recommend "Advanced Insight Warranty"
Description: We recommend "API Keys for Advanced Insight Warranty"
Developer Redirect Url: This will be used by HP to redirect when you log in. This needs to be your Advanced Insights in the following format https://FQDN:PORT/app/main/view/warranty. Example https://contoso.local:444/app/main/view/warranty
Client ID: Leave blank
Tick Read Checkbox
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FA3qzUziL5E7Ya1oFCYMP%252Fimage.png%3Falt%3Dmedia%26token%3D20777b2e-c5df-4fc8-8957-58f09c5f892d&width=768&dpr=4&quality=100&sign=998e4b5a&sv=1)
Click create and you will be redirected back to the previous page.
Viewing app
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FYIGfEkiesmr4FP8bjO4y%252Fimage.png%3Falt%3Dmedia%26token%3D90062ac6-5d6a-4ee8-b12a-b8eca2e89dee&width=768&dpr=4&quality=100&sign=fab7be3b&sv=1)
Once you have been redirected, there will be a green success banner on top of the page. Please now click the "My API Credentials" link in the banner.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252Fm2BSGGwCGOhSG0Fju67w%252Fimage.png%3Falt%3Dmedia%26token%3D110a16e2-299e-4ad6-bb91-c461f8d97d08&width=768&dpr=4&quality=100&sign=f945c3c6&sv=1)
Now click on the newly created app by click the app name, this will load the app details page.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FqOBoJ63R5gsIa7GOePmb%252Fimage.png%3Falt%3Dmedia%26token%3D977774a7-682f-4fdc-be3e-6b29b509350f&width=768&dpr=4&quality=100&sign=b73c9796&sv=1)
Here you will see information about the newly created app.
We need to copy
The API ClientId
The API Secret (click "Show Secret" to get this entry)
It's a good idea to double check that the Redirect URL is correct. You can come back to this page if you receive a redirect URL error when trying to authenticate. You will also want to change the URL if your installation FQDN of Advanced Insights changes in the future.
HP Settings in Advanced Insights
We now need to copy API ClientId and API Secret to Advanced Insights.
Go to Administration -> Settings -> External Services
Based on the location of the HP Workforce Experience portal you used, select US or EU.
Copy and paste the API Client ID into the Client ID input
Copy and paste the API Client Secret into the Client Secret input
Save settings.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FHoxpRdiGHZpWHNShOH8F%252Fimage.png%3Falt%3Dmedia%26token%3D9defcee0-b744-4be7-bd1a-00f43bfbf54c&width=768&dpr=4&quality=100&sign=43cb7a0b&sv=1)
The app client secret has an expiration date of one year from the date of creation. Please make a note of when this key will need to be rotated.
Register for HP Workforce Experience
If you are already a HP Workforce Experience customer, you may not need to do the registration steps below but you will need access to the HP Workforce Experience Portal.
HP has two versions of HP Workforce Experience, one for US (and ASIA) customers and one for EU customers.
You will need to sign up to the appropriate version based on your companies location.
Mistakes here will cause issues in the future. Here are the access urls.
US portal: https://admin.hp.com/
EU portal: https://eu.admin.hp.com/
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FTt29rMVxxAIcxFWxkxW3%252Fimage.png%3Falt%3Dmedia%26token%3D1c22502d-30e9-4ccd-9f51-b67cc150e803&width=768&dpr=4&quality=100&sign=13917c89&sv=1)
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FRPkjz7tdNB4bbiWCbF15%252Fimage.png%3Falt%3Dmedia%26token%3Df490060f-c416-49fb-8c68-034558cd7ed7&width=768&dpr=4&quality=100&sign=34009fb1&sv=1)
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FWT6OSF2DuRU0m9YcX5GR%252Fimage.png%3Falt%3Dmedia%26token%3De470820e-6400-41e8-9623-66aa541ec983&width=768&dpr=4&quality=100&sign=ddf9046e&sv=1)
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FGF6JZRidZmrLVJvxANbd%252Fimage.png%3Falt%3Dmedia%26token%3Dae609208-4676-40a1-91fe-b20ab7cb39ba&width=768&dpr=4&quality=100&sign=2f55f8f5&sv=1)
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FP2t2Me8DwxFfL7yWSO2j%252Fimage.png%3Falt%3Dmedia%26token%3D2f479ac3-f304-4260-8a8c-e1c62e710415&width=768&dpr=4&quality=100&sign=73f1ed12&sv=1)
Using HP Workforce Experience
When you have registered and logged in, you will be greeted by the home experience of HP Workforce Experience. On the left hand side, you will need to click "Assets" to begin importing your HP devices into HP Workforce Experience.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FZehzW5jp9wLEomNpumq1%252Fimage.png%3Falt%3Dmedia%26token%3D80dc1eeb-c2c5-456b-a8a1-09c2403718d7&width=768&dpr=4&quality=100&sign=8a5f8f39&sv=1)
Importing devices
HP Workforce Experience allows you to import your device using four different mechanisms. Currently only Intune Import and Asset enrolment allow for warranty data collection, manual and csv upload do not trigger warranty collection by design. To begin importing devices, please click the "Add" button in the top left of the page.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252F5LF2QNsZuv6f44iR54q9%252Fimage.png%3Falt%3Dmedia%26token%3Db80d5bb7-6048-4c85-8322-15e4481fae79&width=768&dpr=4&quality=100&sign=19cd3c73&sv=1)
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FKoDdmC4mOSuUwdf4jsLM%252Fimage.png%3Falt%3Dmedia%26token%3D26f7df5c-807b-4b17-bb51-cfbaf31bc3bd&width=768&dpr=4&quality=100&sign=3766a52c&sv=1)
Intune import
To begin importing from Intune, please click the Intune Import button then click next.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FOra9V22CeuRASGDzygWH%252Fimage.png%3Falt%3Dmedia%26token%3D5f290c8d-edfe-4aeb-bb49-273b56769faa&width=768&dpr=4&quality=100&sign=126ee153&sv=1)
You will be now asked to provide your Intune Domain Name, this can be found by going to the Intune portal, clicking Tenant Administration on the left hand menu and copying the Tenant name from the Tenant Status page.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252Fs8uJfGGtwDF4U2ffzUvf%252Fimage.png%3Falt%3Dmedia%26token%3D027b8bc7-4087-4cee-83cd-4c8910e997da&width=768&dpr=4&quality=100&sign=6a6e4888&sv=1)
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FYovGm5D8IfyELUGMyIZl%252Fimage.png%3Falt%3Dmedia%26token%3D1764e562-ffa9-46ca-8051-72acc4408a95&width=768&dpr=4&quality=100&sign=c20d15ee&sv=1)
You will now be greeted by the Microsoft Login flow, please log in using your microsoft credenitals as normal. You will be then presented the list of permission HP requests to perform the Intune import.
All of the permissions requested by HP is for the HP Workforce Experience platform. They are not defined/requested by Patch My PC. Advanced Insights does not use or read any of your Intune data.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FCHxvNvELPRoMiP2TMF2Y%252Ffixed.png%3Falt%3Dmedia%26token%3D919d80cf-1297-4e5c-b9c2-24f3371baace&width=768&dpr=4&quality=100&sign=7effa08&sv=1)
Once you have accepted the permission, the connection to Intune will be completed by HP.
You will now be asked if you wish to import Assets from Intune Groups, or to import all of your assets.
We recommend you use the Group functionality, as this allows you to only provide HP the devices you wish to collect warranty information on. Only use full import if you really want every device in HP Workforce Experience as it is vendor agnostic and will collect all competing vendor devices.
We shall continue using Group import only.
When you click on Import assets only from Intune groups, you will be presented with a full list of all your groups in Intune. You can filter out the groups you want to import and you can import multiple groups. Select the groups you want to import and click Import.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FlYb3szAi40vnNCHrXzXZ%252Fimage.png%3Falt%3Dmedia%26token%3D38f1a4de-7650-4077-aba3-da379f815228&width=768&dpr=4&quality=100&sign=87fcb70d&sv=1)
Intune will now begin importing your selected devices. You will receive a notification on begin and completion of the import.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FXlG8Q6z8NBE273uPALja%252Fimage.png%3Falt%3Dmedia%26token%3De194846e-f771-411a-82db-abc5bf46943c&width=768&dpr=4&quality=100&sign=53c797a4&sv=1)
You can also check progress by navigating to the logs link on the left hand side.
Asset Enrolment
To enrol your device by Asset Enrolment, please use the following HP documentation to distribute the agent.
Once the devices are imported, HP Workforce Experience will begin collecting warranty information. This process can take some time, depending on how many devices you have imported.
Collecting Warranty
Collecting warranty in Advanced Insights works in the same way as the other providers, but you will need to log into HP on bulk caching.
Navigate to the warranty dashboard.
To begin, click the "Bulk Processing" statistic to begin re-caching warranty.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252Fm38bPZUzMxK6jvSyVjfu%252Fimage.png%3Falt%3Dmedia%26token%3D391bbd49-27b0-436c-8291-a74796f3d48e&width=768&dpr=4&quality=100&sign=6a32f6e3&sv=1)
You will be asked to log in to HP, click yes and Advanced Insights will go to HP to log in.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FiJDzd68efpWW2ImuIW1M%252Fimage.png%3Falt%3Dmedia%26token%3D6a3bc2cc-dcda-43f0-bb70-7cd96b31d272&width=768&dpr=4&quality=100&sign=dbe3c118&sv=1)
If you receive a redirect url is incorrect error. Please go back to your developer app and check the redirect url provided.
Once you have logged in, HP will redirect you back to Advanced Insights and warranty will begin caching warranty data.
![](https://docs.patchmypc.com/~gitbook/image?url=https%3A%2F%2F3773699522-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MX7dvS0r_4fc0AikgJS%252Fuploads%252FAXSCmkfVTrr3rwsNLXeH%252Fimage.png%3Falt%3Dmedia%26token%3D71917cec-ca13-4a7a-87f8-d98e953f2e36&width=768&dpr=4&quality=100&sign=883e48a0&sv=1)
Note
If you have any feedback or comments on our docs, please email docs@patchmypc.com.
Last updated