Personnel tickets
Personnel tickets are a discount scheme in the Norwegian railway industry. The scheme provides reduced fares on train travel for employees and pensioners within participating companies. Family members such as spouses, partners, and dependent children may also be eligible for discounted travel under the personnel ticket scheme, subject to defined eligibility criteria.
The scheme is owned by the Norwegian Railway Directorate and managed by Entur. Companies that wish to offer personnel tickets to their employees must enter into an agreement that defines the rules for using the scheme.
In Entur, this is handled through the personnel ticket system, which provides an API primarily for internal use. However, some endpoints are also relevant for participating companies and client systems that support the sale of these tickets.
To work with personnel tickets, you need to be a partner that has signed the personnel ticket agreement with Entur. This gives you access to the necessary API endpoints and allows you to manage employee data, connect user profiles to personnel ticket rights, and retrieve reports on usage. After having signed the agreement, you can obtain authentication credentials to access the API.
A personnel ticket right is also referred to as an entitlement, and the terms are used interchangeably in the documentation.
How to add and administrate employees
Organisations that have signed the personnel ticket agreement with Entur must maintain an updated list of all eligible employees. We therefore expose endpoints for importing updated records of employees:
Guide: How to add and administrate employees through the Personnel Ticket API.
Guide: How to import employees in CSV format.
How to connect user profiles with personnel ticket rights
For employees to be able to buy personnel tickets, they must connect their personnel ticket right to their personal user profile. Ticket rights are valid for a maximum of one year, or until a change in employee status occurs.
Guide: How to connect user profiles to personnel ticket rights.
How to use personnel ticket rights in the sales process
Supporting the sale of tickets with personnel ticket discounts in client applications involves retrieving available ticket rights for a customer, presenting them to the user, and including the selected entitlement information when requesting offers, so that discounted prices can be calculated.
Guide: How to use personnel ticket rights in the sales process.
How to fetch tax savings reports
Use of personnel tickets for employees of member companies is free of charge up to a limit set by the company. The limit may be set to 0, in which case all personnel ticket travel is considered taxable. If the total annual amount exceeds the company-defined limit, the excess must be reported by the company for tax purposes.
Guide: How to get reports on personnel ticket usage