Schemas

Pay type code

Description of the pay type

The product id

Human readable product name

When the product is valid from

When the product is valid to

Rule id

Rule name

If the system has failed in sending the ticket right to the ticketing system, this will hold the error message. Default is null

Whether the ticket right is ready to be sent to the ticketing system

When the ticket right was sync'ed

The travel type id

The travel type code

The travel type description

Amount amount. Format: -?\d*.\d\d Examples: 123.34 1.00 34000.00

Currency of the amount

When the amount was calculated

The request URI.

The http status reason.

The http status code.

The main error message.

When the error occurred.

The unique correlation id for the request.

Optional list of error specifications.

Application specific error code

Text localized to the language given in languageCode

Loyalty program description. Supports any kind of text

Language code according to ISO 639-3

Id of the policy

Key for which field that should be matching

The company name

The company ID

Whether the company is deleted

The company postal code

The company postal address

Whether the company allows the usage of e-tickets for its personnel tickets

Which character to separate elements within tax report: ','(default) or ';'

A prefix to be prepended to all employee numbers connected to this company

Whether local employees are allowed

Station in NetEX format.

Station name

Unique contract identifier

The contract status. A normal contract has status valid. It can be expired, refunded, cancelled, misused and valid

When the contract was created

Which client created the contract

When the contract was last changed

Which client changed the contract last

From when the contract can be consumed

The current values for a loyalty program

Which organisation the contract concerns

If present, contract UUID of the parent contract. This field is usually set if the contract is created by a coupon usage, whereas this contract has a time constraint and the parent has a coupon constraint.

The list of keys validated against the customer claiming the contract

Optional external reference. Examples are membership number and employee number

How many coupons the contract has. Default is cascaded from Loyalty Program Version. If set, the contract will be blocked for usage when all coupons are used. Coupons are registered via an OrderLineEvent.

The current total for this contract (earn/burn or giftcard)

If present, contains timed contracts that are dependent on this contract. See Contract response

The list of transactions for this contract (earn/burn or giftcard)

When the contract was accepted by the customer

When the contract expires

A list of order line events related to this contract

The remaining coupons for coupon based contracts. Derived from couponsLimit and orderLineEvents. The amount of remaining coupons are counted yearly and based of the earliest travel date.

The list of customers allowed to use the contract

The id of the employee

The employee's surname

The employee's first name

Whether the employee has been marked for deletion

Employee number

The employee's postal code

The employee's ticket holder code

The employee's social security number

Any additional information

Companies are where employees are hired

Pay type - see the codes in the API documentation

The date of creation.

The source for the first creation

The registered categories on this employee

When the imported employee was last updated

The status of yearly fees for the current and the next year

The employee's postal address

When the employee was born

When the employee left the company

Why the employee left the company

The employee's ticket rights

The employee's family members

When the employee was hired

When the employee starts a leave

The employees customer number in ESS. Note this profile is owned by JBD and is the profile connected to the ticket right. A 'null'-value here may indicate that the ticket right is not yet synced to ESS.

Employment type. Examples include Employee, Part time, Temp

The pay level. This is calculated based on the employment percentage and the type of employment. Typically holds the same value as employment percentage, unless special circumstances apply

The employee's degree of disability. Default 0.

The status of disability proofs for the current and the next year

A personnel ticket product

The source for the last update

Whether a ticket should be created

Employment percentage

Date for registered employment percentage

The field of the associated object in the request related to the error.

The message explaining why the error occurred.

A list of rejected values.

The Order id, used for lookup when trying to find the order in Enturs systems.

The order line Id for Entur orders.

Ticket type id

Ticket type

Whether the ticket type is deleted.

Country code

Ticket type description

Whether or not this ticket type is compatible with station pairs when placing a manual order. The default = false.

Whether or not this this ticket type is relevant for sending as input to a Manual order. If this = false (the default), it will not generate new tickets rights by manual order.

The id of the contract consumed

The customer attempting to consume the contract

The start date and time of travel.

The id of the product consumed. This is on NetEX format and must match the product in use by the supplied contract.

The number of coupons consumed. Has no effect if the contract does not specify a number of available coupons. Defaults to 1.

The end date and time of travel. Defaults to firstTravelDate if not provided.

The order line reference. This is used to check if consumption has already been validated.

The version of the product consumed. This is on NetEX format and if supplied must match the product version in use by the supplied contract.

Id of the product connected to the contracts loyalty program

Contract UUID, used to identify a contract

Version of the product connected to the contracts loyalty program

Contract consumable from date

Passenger category.

Contract owners first and last name

Contract owner customer number

Display name for loyalty program

How many coupons the contract has. Default is cascaded from Loyalty Program Version. If set, the contract will be blocked for usage when all coupons are used. Coupons are registered via an OrderLineEvent.

If present, a ticket is included in this right. It may be distributed or redistributed to this device.

If present, contract UUID of the parent contract. This field is usually set if the contract is created by a coupon usage, whereas this contract has a time constraint and the parent has a coupon constraint.

Contract expiration date

Remaining coupons connected to the contract

External contract reference if set.

Contract owners birth day

The FIP ticket type id

The FIP ticket type code

Description of the ticket type

Id of this manual order.

Last date the ticket right should be available.

First date the ticket right should be available.

Whether this manual order is deleted or not.

When this manual order was first issued.

The Ticket type informs of which country it is valid in and what train class it covers.

Any station pairs for this manual order.

All items for this page

Total items which could be returned

Total number of pages

Postal code

Postal place

Country, format ISO 3166-1 alpha-3

If the postal place has been deleted

Id of this station pair

Station with NetEX and name

Station with NetEX and name

The date from when the ticket right is valid

The id of the employee who is responsible

The Ticket type informs of which country it is valid in and what train class it covers.

The date from when the ticket right stops being valid

The ticket right id

The id of the ticket holder, either an employee or a family member

When the ticketright was calculated

Any additional information

A manual order. This may contain a list of station pairs.

Rule describing who are eligible for what ticket right

Status fields related to synchronization with other services

Status fields related to synchronization with other services

All items for this page

How much was the amount changed by this transaction? Positive value means deposit onto the card, negative withdrawal. Example: -130.00

Currency used in this transaction. Only one currency is allowed for all transactions on a single contract.

Timestamp for this transaction.

External RRN for the payment.

Identifying sellers email for this transaction.

Identifying point of sale for this transaction.

External transaction id for the ongoing transaction.

Internal unique identifier for this transaction.

Default number of how many coupons can be used. May be overridden by contract coupon limit

The loyalty program the contract created by the coupon is connected to

The default start time of the contract created by a coupon usage. If set, the contract created by a coupon usage will start on the specified time of the travel date or when created

The duration of the of the contract created by a coupon usage. If set, the contract created by a coupon usage will set expiration date to the end of the duration. It will override loyalty program usageValidityPeriod

The ID of the family member

The family member's surname

The relation a family member has to an employee

The family member's first name

Whether the family member has been marked for deletion

The ID of the employee

The family members social security number

Any additional information

The date of creation.

The source for the first creation

The date the last time the family member was updated

The source for the last update

The low income registrations for the current and the next year

When the family member was born

A list of the family member's ticket rights

The employees customer number in ESS. Note this profile is owned by JBD and is the profile connected to the ticket right. A 'null'-value here may indicate that the ticket right is not yet synced to ESS.

The family members ticket holder code

Whether a ticket should be created

All items for this page

Total items which could be returned

Total number of pages

Whether the claim was successful

The customerNumber for the customer now claiming the personnel ticket

Employee number

Company id

Ticket number

Issued date

The date the ticket is valid from

Travel type

The date the ticket is valid to

FIP ticket type

The actual paid price for this item, i.e. what did the user actually pay after rebate. Negative if this was a cancellation

The order ID

The order line event type. Can be one of 'PURCHASE' or 'CANCELLATION'. PURCHASE is used when the order line event describe purchase of a travel using a contract (not the same as isPurchased). CANCELLATION is when the order line event is a cancellation (can be the same as isCancelled)

When the order line event was saved

Whether the order line event is a cancellation

Whether the order line event describes the purchase of a contract, or contract consumer

The order line ID

The organisation through which the order was placed

The order line version

Codespace

The first date of travel on this ticket. Will be used to decide when to report this usage to the Norwegian tax administration, if applicable. Defaults to the current date and time.

How many coupons (usages) this event is using. This defaults to 1, but will be ignored if the contract in question does not use coupons.

The name of the product that this usage refers to. This should be supplied by the caller to indicate which item has been bought. This is displayed to the user in reports.

The original price for this item, i.e. i.e the original price without the travellers discount.

The last date of travel, related to entitlement usage. Defaults to equal travelDate. Relevant for period tickets only.

Tax savings for this order line

If the order line is added manually, this field will have an explanation

If set, the effective date for cancellation.

All items for this page

Total items which could be returned

Total number of pages

All items for this page

Total items which could be returned

Total number of pages

The employee's social security number. 5 digits.

The employee's surname

The company the employee is employed by

The employee's first name

Whether the employee has been marked for deletion. Default false

Employee number

The postal code for the employee's address

The employee's postal address

When the employee was born

When the employee was hired

The type of employment

Employment percentage

If present, this will perform an update of the employee

Pay type - see the codes in the API documentation

When the employee left the company

Why the employee left the company

When the employee starts a leave

The pay level. This is calculated based on the employment percentage and the type of employment. Typically holds the same value as employment percentage, unless special circumstances apply

The employee's degree of disability. Default 0.

Whether a ticket should be created. Default false

When the employee's disability was granted

Date for registered employment percentage

All items for this page

Total items which could be returned

Total number of pages

The year of the tax saving

The month of the tax saving

If set, the tax distribution saving for that month is unknown. This is the case for all period tickets before may 2021. They need to be calculated manually

The value of tax saved

When the contract consumer was created

Which client created the contract consumer

Marks that this specific user has been disallowed from using this contract by the contract owner

When the contract consumer was last changed

Which client changed the contract consumer last

The customer entitled to use the contract. Unique Entur specific number

Marks that this specific user's organisation is the owner of the contract

The organisation ID the customer belongs to

The customer entitled to use the contract. External reference unique to organisation

The year this category is valid

A personnel ticket product

Whether this yearly fee has been paid

The id of the imported employee

The employee's surname

The company the employee is employed by

The employee's first name

Employee number

The employee's social security number

Any additional information

Pay type - see the codes in the API documentation

The date of creation.

The source for the first creation

Whether the employee has been marked for deletion

When the imported employee was last updated

The postal data for the employee's address

The employee's postal address

When the employee was born

When the employee left the company

Why the employee left the company

When the employee was hired

When the employee starts a leave

The pay level. This is calculated based on the employment percentage and the type of employment. Typically holds the same value as employment percentage, unless special circumstances apply

The employee's degree of disability. Default 0.

The type of employment

The source for the last update

Whether a ticket should be created

When the employee's disability was granted

Employment percentage

Date for registered employment percentage

All items for this page

Total items which could be returned

Total number of pages

The year this fee is valid

Whether this yearly fee has been paid

The id of the loyalty program

The current status of this loyalty program. Can be DRAFT, CURRENT, DEPRECATED

The end date of the loyaltyprogram. All contracts will expire when the loyaltyprogram expires. Supports ISO 8601 date format.

The id of the product associated with this loyalty program.

The start date of the loyaltyprogram. If specified ahead in time, the loyaltyprogram will get status = draft. Supports ISO 8601 date format.

A list of human readable descriptions in different languages. Only one language per description is allowed.

The version of this loyalty program.

The organisation that owns this loyalty program.

The version of the product associated with this loyalty program.

The type of loyalty program. Types include COUPONS, TIMED and POINTS. A time-based loyalty program specifies a duration a connected contract is valid. A point-based loyalty program has contracts keeping track of earning and burning of points. This also includes gift cards. A coupon-based loyalty programs specifies how many times a contract can be consumed. For compatibility reasons, UNMAPPED is also available for loyalty programs that has not yet been classified.

A human readable internal description of the loyalty program.

Configuration for coupons. This is only set for loyalty program type COUPONS

A word or code the customer can use to activate a loyalty program for themselves, set by the creator of the loyalty program

Deprecated. See couponConfig instead. How many coupons (eg. the maximum amount of usages) the underlying contracts of the loyalty program has.

The duration of a contract associated with this loyaltyprogram. This is set for loyalty program types TIMED and POINTS. The default value is null, which means the contract has an unlimited duration. This field uses the ISO 8601 duration format and accept the units: Days and Time. For example; 'P3DT12H30M5S' represents a duration of three days, twelve hours, thirty minutes, and five seconds.

The ticket right holder id

The personnel ticket code for the ticket rights holder

A ticket right granted to an employee or a family member

The customerNumber referring to the customer who claims the personnel ticket

The code of the personnel ticket to claim

Year of registered low income

Whether low income is registered

Whether proof of disability has been registered

All items for this page

Total items which could be returned

Total number of pages

The year this information is valid for

Whether a disability proof has been registered this year

Type of the ticket holder, possible values are 'Ansatt', 'Pensjonist' and 'Familie'

The surname of the ticket holder

The id of the company

The first name of the ticket holder

When the ticket right was granted

The employee number

If the ticket holder is an employee or a family member

Type of the ticket right, possible values are 'bronse' and 'sølv'

City in postal address

Postal code

Postal address line

The hire end date for pensioners

Company Id

Whether the employee has been marked for deletion. Default false

Employee number

Type of employment

Employment percentage

Birthdate-number og D-number, 5 digits

Pay type - see the codes in the API documentation

The employee's surname

The employee's first name

The postal code for the employee's address

The employee's address line

When the employee was born

When the employee left the company

Why the employee left the company

When the employee was hired

When the employee starts a leave

The pay level. This is calculated based on the employment percentage and the type of employment. Typically holds the same value as employment percentage, unless special circumstances apply

The employee's degree of disability. Default 0.

Whether a ticket should be created

When the employee's disability was granted

The employee's product

Date for registered employment percentage

When the loyalty program was created

Which client created the loyalty program

Loyalty program description. Supports any kind of text

What language the description is written in, ISO639-3

When the loyalty program was last changed

Which client changed the loyalty program last

Display name for loyalty program

When the report generation started

How far the generation has progressed in percent from 0 to 100

Error if the report generation fails

When the report generation finished

A list of consumptions to verify

A code pertaining to the reason for rejection, if any. Code 3101 = OK.

A short message detailing the reasoning behind the status.

True if all consumptions were valid, otherwise false

All items for this page

Total items which could be returned

Total number of pages