The Installer Onboarding feature enables Telematics Service Providers (TSPs) to automate installer company and user provisioning in the SKF TraX platform using the TraX API. This replaces manual setup processes with a secure, scalable, API-driven onboarding model.
By automating provisioning and access control, TSPs can reduce administrative effort, accelerate fleet activation, and support operational growth without increasing manual workload.
Key Goals
- Faster onboarding: Fleets can begin operating immediately after integration, with vehicles visible and device commissioning available without delay.
- Scalable delegation: TSPs can delegate installer onboarding, user management, and device commissioning while maintaining centralized control.
Overview
The Installer Onboarding feature extends the TraX API with capabilities for:
- Initial provisioning: Automated creation of installer companies, administrator users, and access rules to fleet resources.
- Ongoing administration: Programmatic management of additional installers, users, and access rights over time.
Previously, installer setup and access management were handled manually. The enhanced TraX API enables automation, improving efficiency, consistency, and security while supporting long-term scalability.
Background
In the TraX operating model, an installer is the entity responsible for installing TraX devices. By default, the TSP is authorized to perform installations, but this responsibility may be delegated to a fleet owner or a third party (for example, a repair workshop).
For a TraX mobile app user to install devices, the following conditions must be met:
- A company representing the user’s real-world organization must exist in the SKF platform.
- The user must have a valid SKF platform account associated with that company.
- An access rule must grant that company permission to one or more fleets managed by the TSP.
The Installer Onboarding API enables TSPs to programmatically fulfill these requirements in a controlled and repeatable manner.
API Capabilities
Company Management
- Create installer companies (fleet-owned or third-party) via API.
- Companies are globally unique and defined by registered email domains, which control user creation.
- Third-party companies are visible by default.
- Fleet companies are not visible by default for commercial reasons. A fleet company becomes visible to a TSP only after the TSP explicitly creates it, even if it already exists in the platform.
- The TSP’s own company is always visible, allowing user creation through the API in the same manner as other installer companies.
User Management
- Users can be created only if their email domain matches the company’s registered domains.
- Users with free email domains must be created through the SKF platform.
Access Control
- Access rules grant all users within a company access to specific fleets.
- Access updates for existing users typically propagate within seconds. Newly added users may require up to two hours for full access activation.