EU Data Act

Users without a Volvo Connect Account
If you are a machine owner that has not yet registered for an account at https://connect.volvoce.com then please contact your local dealer to ensure your machine ownership is registered.
Find your local dealer: Volvo Construction Equipment Global Dealer Locator

Otherwise, for example if you are renting a machine, use the self-service to register a Volvo Connect Account.

Users with a Volvo Connect Account
Several actions are required to enable and gain access to your data in a secure manner. The main actions associated with collecting and accessing your data are described here:

1. Enable / disable data collection for each machine:
This is done via the ’Machines’ section and the ‘Machine Details’ screen in Volvo Connect. You need to have an End Customer Manager account, then for each machine you need to Enable/
Disable the ‘Manage EU Data Act API’ option. Before you do this, expect a request for validation [1], provide a Callback URL for the API (this is necessary for authorization and authentication [2] of your application. You will need your application developer to provide this), and eventually receive an invitation [3] to the EU Data Act Developer Portal.

2. Setup Access to the EU Data Act Developer Portal:
The technical solution requires that you develop your own application [4] and subscribe to the free API product (The data that you have requested us to capture in step 1). Follow the ‘Getting started’ instructions on the EU Data Act Developer Portal to set up access and subscribe to the API product.

3. Develop your APP / API integration:
You will require a degree of technical knowledge to integrate with this API into either a self-developed software or a third-party application, to consume the information provided by it. Once you have access to the EU Data Act Developer Portal (https://developer.volvoce.com/cecompliance/eu/get-started), you will find documentation to help you integrate the API into your software in the ‘Get Started’ page, and if any support is needed during this process, you can contact support following the steps outlined in the ‘Support ‘ page

[1] You may be required to provide details of machine ownership and/or organizational details to validate your eligibility to the data.
[2] Authentication is done through OpenID Connect.
[3] Invitation to the Developer Portal for EU Data Act is only applicable the first time you enable Manage EU Data Act API for a machine.
[4] You will need a good understanding of API’s to develop your integration to the API.

Connecting a Third Party to your data
In accordance with EU Data Act regulations, any EUbased customer can request that a third party (e.g. providers of data processing services), be given access to the data they generate by using their EUbased products & services. Choosing and connecting a third party to that data requires a few steps:

Choosing your Third Party

• Both the customer & third party must be based within the EU.
• The third party shall not be a Gatekeeper, as defined in the Digital Markets Act. (Assessed when onboarding).
• The customer and third party should have a contractual agreement/letter of authorization and should agree with our DMA and DSA (Required during onboarding).

Onboarding your Third Party
When you’ve chosen an eligible third party, you will need to request that they be onboarded, so they can be assigned access to our systems and your data.

1. The customer should initiate the request via the Volvo Connect support function. The request should include the letter of authorization that cites the third party name, invoicing address, contact name and email address.
2. In response to the request, the Volvo Connect support team will verify information and engage with the third party.
3. Upon approval, the third party will be provided with access to the EU Data Act Developer Portal and can begin their APP development.

The API Portal provides ‘Getting started’ instructions, data documentation along with an API support function that can assist with development and APP approval.

As a Third Party you will

You will await an initiating email from Volvo, based on the request of the user to onboard you. Do not create a Volvo Connect account

During onboarding you will need to supply documentation of your size, billing country, agree to the Data Sharing Agreements and then provide necessary technical information of your application, including a Callback URL for the authorization and authentication of your application.

You will be invited to the EU Data Act Developer Portal to register and gain access to the API documentation, and all onboarded organizations of the customers you manage, all with a single login.

The FAQ texts below provide answers to common customer and third party questions. Third party vendors can also contact support.vcedataactpartner@volvo.com directly for more information.

The Direct Data Access solution lets you retrieve machine telematics data from Volvo Construction Equipment machines via an API.

Users without a Volvo Connect Account

If you are a machine owner that has not yet registered for an account at https://connect.volvoce.com then please contact your local dealer to ensure your machine ownership is registered.

Find your local dealer: https://www.volvoce.com/global/en/global-dealer-locator/

Otherwise, for example if you are renting a machine, use the self-service to register a Volvo Connect Account.

Users with a Volvo Connect Account
Several actions are required to gain access to your data in a secure manner. Ensure that you have:

1. Organization permissions in Volvo Connect
   You must be assigned to a verified organization. Register your organization in Volvo Connect Customer Portal by selecting "My company" from the menu and completing the required form fields.
   
   If you need help with your organization, contact your local dealer.
   
   If your organization is already linked to your account but you do not have access to the specific machines, request access from the organization or machine owner.
   
   
2. Machine access confirmed
   Confirm that your machines exist in your Volvo Connect Customer Portal organization. If not, add machines in "Machine Management" or contact your machine owner or dealer.
   
   
3. Application / API integration
   Integrating with this API requires technical knowledge. If you plan to integrate this API, a self-developed application or a third-party application is required. In the Direct Data Access Portal https://eudadirect.volvoce.com/login, you will find documentation details to help you integrate the API into your software in the 'API Documentation' page.

Once these actions are completed, the portal is available to delegate machines, access data, and create API keys for consumption.

Delegation and Access Data
If you belong to the organization that owns the machine, you can add a machine to your API to access data. A machine can have only one active delegation at a time. To assign:

1. Verify that you are an authorized user, such as a user within a machine-owner or dealer organization of a machine.
2. "Machines", locate the machine in the "Your machines" table.
3. Click "Assign to my API".

You have now access to the machine data by using an API key associated with your email address. You can revoke the access at any time by clicking "Remove assignment". The previous delegation is automatically revoked, and a new user can assign access to the machine.

If you are an authorized dealer, you also have access to "Dealer View" where you can manage machines assigned to your dealership, although you do not own the machine. You can assign the machine to other user's by entering their email address. The recipient will now have access to their machine until revoked.

Affected Products:

Compact Wheeled Loaders (All)
Compact Excavators (All except EW65F & ECR90F)
GPE Wheeled Excavators (All)

Creating an API Key
To access the data through the API, you will need to create an API key associated with your Volvo Connect email. The email address of your API key must match the email address to which the machine was delegated. To create an API key: 

1. On the side menu, go to "API Keys".
2. Click "Create new API key"
3. Edit name or choose default, and then press "Create new API key".
4. Now your secret key is displayed. Copy it and store it somewhere safe, it won't be possible to access it again after closing the window. Press "Done".

The key that you have saved can now be used to access the data of your machine. The API key is active for 30 days. Once an API key expires or is revoked, it can no longer authenticate API request. Create or regenerate a key as needed to maintain access.

Connecting to the API
When your machine uses the API to provide Direct Offboard Data access, complete the steps below to establish a secure connection and start consuming data.

• Confirm activated access
  Verify that Direct Offboard Data access is enabled for the machine. This should normally be activated when the machine is purchased or rented. If access has not been enabled, contact the machine owner or your local dealer.
• Confirm eligibility and permissions
  Ensure your user and organization are authorized for the selected machines.
• Set up access credentials
  Create an API key by following the steps in the 'Creating an API Key' section.
• Configure your integration
  Add the API key to your application in HTTP header and complete any authentication required for your environment. For technical implementation details, refer to the API documentation on the Support page in the Direct Data Access Portal.
• Test and verify
  Run a test request to confirm connectivity, permissions, and data availability before moving to production usage.

If any additional support is needed during this process, you can contact support in the "Support"page.