Version: 2023.0.89
Last updated: November 22 December 01 2023
| Info |
|---|
DISCLAIMER The Samtrafiken ACCESS API and its documentation is work in progress. Changes and additions will be made to the documentation during the implementation process. |
...
When searching for offers, anonymousPassengerSpecifications are provided. One for each passenger.The only used passengerType is
In the request for a passenger with no special need use passenger type “PERSON”.
To get different prices depending on age, the age parameter must be set. No age will return an adult-price offer.
...
| Code Block |
|---|
"anonymousPassengerSpecifications": [
{
"externalRef": "PASSENGER_1",
"age": 60,
"type": "PERSON",
"cards": [
{
"typestype": [
"REDUCTION_CARD"
],
"code": "SWE_PENSIONER"
}
]
}
], |
The IMS returns respond with the carrier’s applied passenger type for in the matched fare. For student and early retiree fare the applied passenger type is ADULT in combination with applied reduction card.description text.
Example
Client request
| Code Block |
|---|
"anonymousPassengerSpecifications": [
{
"externalRef": "PASSENGER_1",
"age": 18,
"type": "PERSON",
"cards": [
{
"typestype": [
"REDUCTION_CARD"
],
"code": "SWE_STUDENT"
}
]
}
], |
IMS respond with STUDENT fare and passenger type ADULT as carrier offer STUDENT fare.
...
In appliedPassengerTypes.description the IMS respond with the “actual” passenger type to be printed on the ticket.
In addtion the IMS respond with their own carrier code, when the reduction cards SWE_STUDENT, SWE_PENSIONER or SWE_TDT are used in the request. The redction cards starting with SWE_ are generic cards used at the swedish market without an issuer but all carriers returning discounts based om these cards should return their own carrier code as issuer.
| Code Block |
|---|
"appliedPassengerTypes": [ { "passengerRef": "PASSENGER_1", "type": "ADULT", "description": "AdultStudent", "appliedReductionCardTypes": [ { "code": "SWE_STUDENT" |
...