# Entur

> Entur er Norges nasjonale reiseplanlegger for kollektivtransport. Her kan du søke etter og kjøpe billetter for tog, buss, ferge, T-bane og trikk fra alle operatører i Norge på ett sted.

Entur samler kollektivtilbudet fra hele Norge. Tjenesten dekker reiseplanlegging, billettkjøp og sanntidsinformasjon.

## Reisesøk og billettkjøp

- [Reiseplanlegger](https://entur.no/reiseplanlegger): Søk etter reiser mellom to steder i Norge med alle transportmidler.
- [Direkte billettkjøp – sonesøk](https://entur.no/direktekjop/tilbud?authority=INN:Authority:INN_ID&from=INN:FareZone:60&to=INN:FareZone:139): Kjøp billett direkte basert på soner. Parametere: `authority` (operatør-ID), `from` (avgangssone), `to` (destinasjonssone).
- [Direkte billettkjøp – stoppestedssøk](https://entur.no/direktekjop/tilbud?authority=INN:Authority:INN_ID&from=NSR:StopPlace:14115&to=NSR:StopPlace:14608): Kjøp billett direkte basert på stoppesteder. Parametere: `authority` (operatør-ID), `from` (NSR-ID for avgangsstoppested), `to` (NSR-ID for destinasjonsstoppested).

### URL-struktur for direkte billettkjøp

Bruk følgende mønster for å bygge en direktelenke til billettkjøp:

```
https://entur.no/direktekjop/tilbud
  ?authority={OPERATOR}:Authority:{OPERATOR_ID}
  &from={ZONE_OR_STOPPLACE_ID}
  &to={ZONE_OR_STOPPLACE_ID}
```

**Sone-ID-format:** `{OPERATOR}:FareZone:{ZONE_NUMBER}`
Eksempel: `INN:FareZone:60`

**Stoppested-ID-format (NSR):** `NSR:StopPlace:{NUMBER}`
Eksempel: `NSR:StopPlace:14115`

**Operatør-ID-format:** `{OPERATOR}:Authority:{OPERATOR_ID}`
Eksempel: `INN:Authority:INN_ID` eller `TRO:Authority:1`

## Stoppestedsregister (NSR)

- [Stoppestedsregisteret](https://stoppested.entur.org/): Nasjonalt register over alle offentlige stoppesteder i Norge, inkludert bussholdeplasser, togstasjoner, fergekaier og flyplasser. Hver lokasjon har en unik NSR-ID på formatet `NSR:StopPlace:{NUMBER}`.
- [Om stoppestedsregisteret](https://om.entur.no/kom-i-gang/stoppestedregister): Dokumentasjon og veiledning for bruk av NSR.

For å slå opp en NSR-ID, søk i registeret på stoppested.entur.org eller bruk Enturs åpne API.

## Kjøpslenke for partnere (`/kjop-reise`)

Lar partnere sende brukere direkte til kjøp av en spesifikk reise på entur.no, basert på serviceJourney-IDer. Brukeren slipper å søke selv.

### URL-format

```
https://entur.no/kjop-reise?legs=<legs>&travellers=<travellers>
```

### Parametere

**`legs` (påkrevd):** Semikolon-separerte etapper, hver med fire kommaseparerte verdier:
```
serviceJourneyId,fraStopPlace,tilStopPlace,dato
```

Eksempel med to etapper (tog Halden→Oslo S, tog Oslo S→Trondheim):
```
legs=VYG:ServiceJourney:146-HLD_509067-R,NSR:StopPlace:127,NSR:StopPlace:337,2026-03-02;VYG:ServiceJourney:808_444388-R,NSR:StopPlace:337,NSR:StopPlace:269,2026-03-02
```

**`travellers` (valgfri):** Kommaseparerte reisendekategorier med valgfri alder (`category` eller `category:age`).

Gyldige kategorier: `adult`, `child`, `student`, `senior`, `military`

Alder er påkrevd for `child` og `student`. For andre kategorier er alder valgfri.

```
travellers=adult,child:8,student:22
travellers=adult,senior
travellers=child:5,child:12,adult
```

### Flyt

1. Web-klienten parser `legs` og `travellers` fra URL og kaller BFF-et (`POST /v1/buy-trip`).
2. BFF-et beriker reisen via OTP (henter linjeinfo, stoppestedsnavn, avgangstid) og finner eksakt match på serviceJourney-IDer.
3. Ved match: redirect til `/reisedetaljer/{id}` – brukeren velger billett og betaler.
4. Ingen match: fallback-redirect til vanlig reisesøk med riktig tidspunkt.

### Feilhåndtering

| Situasjon | Resultat |
|---|---|
| Ugyldig URL (mangler `legs`, feil format) | Feilside med forklaring |
| ServiceJourney finnes ikke i OTP | Fallback til reisesøk |
| Ingen eksakt match i OTP-resultater | Fallback til reisesøk med riktig tidspunkt |
| BFF-feil (timeout, nettverksfeil) | Fallback til reisesøk |

### Begrensninger

- Maks 10 etapper per forespørsel
- `tripPatternId` fra Redis har 2 timers levetid
- Krever eksakt match på alle serviceJourney-IDer

## Travel Link

Travel Link lar deg lage en forhåndsutfylt lenke direkte til et reisesøk på entur.no. Nyttig for å sende brukere rett til en spesifikk reise.

- [Dokumentasjon og generator](https://developer.entur.org/pages-travel-link): Offisiell dokumentasjon med interaktiv lenke-generator.

### URL-struktur for Travel Link

```
https://entur.no/reiselenke
  ?startLabel={STEDSNAVN_FRA}
  &startLat={BREDDEGRAD_FRA}
  &startLon={LENGDEGRAD_FRA}
  &stopLabel={STEDSNAVN_TIL}
  &stopLat={BREDDEGRAD_TIL}
  &stopLon={LENGDEGRAD_TIL}
  &transportModes={TRANSPORTMIDLER}
  &date={UNIX_TIMESTAMP_MS}
  &timepickerMode={MODUS}
```

### Parametere

| Parameter | Beskrivelse | Eksempel |
|---|---|---|
| `startLabel` | Navn på avreisested (URL-kodet) | `Nesoddtangen%2C%20Nesodden` |
| `startLat` | Breddegrad for avreisested | `59.858841` |
| `startLon` | Lengdegrad for avreisested | `10.663423` |
| `stopLabel` | Navn på destinasjon (URL-kodet) | `%C3%98rsta` |
| `stopLat` | Breddegrad for destinasjon | `62.198717` |
| `stopLon` | Lengdegrad for destinasjon | `6.129015` |
| `transportModes` | Kommaseparert liste over transportmidler | Se under |
| `date` | Dato og tid som Unix-tidsstempel i millisekunder | `1772697480000` |
| `timepickerMode` | `departAfter` (avgang etter) eller `arriveBy` (ankomst innen) | `departAfter` |

### Tilgjengelige transportmidler (`transportModes`)

`rail`, `metro`, `tram`, `bus`, `coach`, `water`, `car_ferry`, `flytog`, `flybuss`, `air`

For å inkludere alle: `rail,metro,tram,bus,coach,water,car_ferry,flytog,flybuss,air`

### Eksempel

Reise fra Nesoddtangen til Ørsta med alle transportmidler:

```
https://entur.no/reiselenke?startLabel=Nesoddtangen%2C%20Nesodden&startLat=59.858841&startLon=10.663423&stopLabel=%C3%98rsta&stopLat=62.198717&stopLon=6.129015&transportModes=rail%2Cmetro%2Ctram%2Cbus%2Ccoach%2Cwater%2Ccar_ferry%2Cflytog%2Cflybuss%2Cair&date=1772697480000&timepickerMode=departAfter
```

Merk: `startLabel` og `stopLabel` kan utelates – Entur vil da forsøke å bruke brukerens posisjon for manglende felt.

## Øvrige tjenester

- [Datakatalog](https://data.entur.no/): Åpne data fra Entur, inkludert rutedata og stoppestedsdata.
- [Utviklerportalen](https://developer.entur.org/): API-dokumentasjon for utviklere som vil integrere Enturs data.
- [Last ned appen](https://entur.no/last-ned-appen): Entur-appen for iOS og Android.

## Om Entur

- [Om Entur](https://om.entur.no/): Informasjon om selskapet og tjenestene.
- Entur AS, Rådhusgata 5, 0151 Oslo
- Organisasjonsnummer: 917 422 575