Search offers - the 'What' part - Trip based - 20260702 by edwinvandenbelt · Pull Request #67 · TransmodelEcosystem/EUDIT

edwinvandenbelt · 2026-06-19T14:06:57Z

Summary

Adds YAML data model files for the Search Offers deliverable (ContinuousLeg, DistributionFilter, FlexibilityFilter, Leg, LegAlight, LegBoard, LegIntermediate, Mode, SearchOfferFilter, SearchOfferPolicy, SearchOfferRequest, ServiceFilter, TimedLeg, TransferLeg, Trip, TripSection)

The request:

The Trip concepts:

edwinvandenbelt · 2026-06-23T12:06:17Z

+      duration:
+        type: integer
+        description: Duration of the leg in minutes
+      individualMode:


@Ulf9 What is this? I don't see it in TM.

It should be PersonalModeofOperations

edwinvandenbelt · 2026-06-23T12:06:38Z

+      individualMode:
+        type: string
+        enum: []
+      start:


startPlace?

keep consistent with TimedLeg

edwinvandenbelt · 2026-06-23T12:06:47Z

+      start:
+        type: string
+        format: place-ref
+      end:


and endPlace?

edwinvandenbelt · 2026-06-23T12:07:38Z

+        type: string
+        description: discriminator for the leg type
+        const: continuous
+      continuousMode:


I don't know this one.

edwinvandenbelt · 2026-06-23T12:07:59Z

+  mode:
+    type: string
+    description: Mode of transportation for the leg (e.g., bus, train, walking). See modes as specified in NeTEx.
+    enum: []


should be a ref to Mode.yaml

Yes, it would be clearer.

edwinvandenbelt · 2026-06-23T12:10:36Z

@@ -0,0 +1,28 @@
+type: object
+properties:
+  searchOfferId:


should be 'allOf' + request.yaml. The searchOfferId = requestId

edwinvandenbelt · 2026-06-23T12:11:14Z

+        description: Reference to the operating day associated with this leg
+        format: day-of-week
+        enum: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
+      privateMode:


Again, what does this mean?

To make consistent with Transmodel: PersonalModesOfOperationEnumeration

Though it might not be needed in the TimedLeg

edwinvandenbelt · 2026-06-23T12:11:35Z

+      privateMode:
+        type: string
+        enum: []
+      ptMode:


Why isn't 'mode' on the Leg level (as specified) enough?

edwinvandenbelt · 2026-06-23T12:12:31Z

+        type: string
+        description: discriminator for the leg type
+        const: transfer
+      continuousMode:


And again, I don't know what should be in here. There is already 'mode' at leg level, what does this mode mean?

edwinvandenbelt · 2026-06-23T12:12:36Z

+      duration:
+        type: integer
+        description: Duration of the leg in minutes
+      transferMode:


And again, I don't know what should be in here. There is already 'mode' at leg level, what does this mode mean?

edwinvandenbelt · 2026-06-23T12:12:48Z

+      transferMode:
+        type: string
+        enum: []
+      start:


startPlace?

edwinvandenbelt · 2026-06-23T12:12:55Z

+      start:
+        type: string
+        format: place-ref
+      end:


OlivierBigex · 2026-07-02T07:56:24Z

If there is a trip pattern section, is the retailer supposed to provide to the distributor the complete trip, even sections that are not covered by the distributor (in case of multi-distributor trip) ?

OlivierBigex · 2026-07-01T15:31:47Z

+          - "ISO/IEC 7816-4" # NFC, MIFARE DESFire
+          - "GATT" # Bluetooth Low Energy
+          - "AXA Bike lock" # AXA Bike lock
+          - "OTHER" # Other content standard


is calypso card somewhere in that list ?

OlivierBigex · 2026-07-01T15:35:27Z

+          - "ISO/IEC 7816-4" # NFC, MIFARE DESFire
+          - "GATT" # Bluetooth Low Energy
+          - "AXA Bike lock" # AXA Bike lock
+          - "OTHER" # Other content standard


could be interesting to avec an object for the Fulfillment Storage Location (or something more accurate): ON_MEDIA, ON_SYSTEM. Indicating if the ticket is technically stored in the media or in system.

OlivierBigex · 2026-07-02T08:20:05Z

+        description: The channel of the offer.
+        x-enum-values:
+          - "web"
+          - "mobile"


edwinvandenbelt · 2026-07-02T08:48:22Z

+allOf:
+  - $ref: .\Leg.yaml
+  - type: object
+    properties:


to add:

modeOfOperation: enum, to be found in OJP/NeTEx. (fixed)

TuThoThai · 2026-07-02T08:55:54Z

+    enum: []
+  sequenceNumber:
+    type: integer
+    description: The order of the leg in the overall journey. In case of parallel legs, the sequence number should be the same for those legs.


Further discussion / modelling is needed on the concept of parallel leg especially if we are taking into account parking

CGantert345 · 2026-07-07T09:59:29Z

+          - "application/pdf"
+          - "image/jpeg"
+          - "image/svg+xml"
+      contentStandard:


The client must indicate the technology of issuing:

FulfillmentMediaType: ["ALLOCATOR_APP","DISTRIBUTOR_APP","RETAILER_APP","FULFILLMENT_PARTS","PDF_A4","PKPASS","RCCST","RCT2","UIC_PDF","TICKETLESS","APPLICATION","WALLET","CHIP_CARD"]

The dedicated applications available:
Application: string : this is proprietary coding to be agreed multilateraly with the providers of the applications / specifications

The specification used via the application:
Specification: string : this is proprietary coding to be agreed multilateraly with the providers of the applications / specifications

CGantert345 · 2026-07-07T10:01:12Z

+        type: string
+        description: The content standard of the offer.
+        x-enum-values:
+          - "ISO/IEC 18004" # QR Code


Which format the barcode included in a pdf, jpg or wallet fulfillment has is not relevant.

CGantert345 · 2026-07-07T10:02:26Z

+mode:
+  type: string
+  description: These classes are taken from the NeTeX standard, but ALL and UNKNOWN are removed. On the other hand OTHER and PARKING are added.
+  enum: [ AIR,


this should be extensible

CGantert345 · 2026-07-07T10:06:03Z

+      afterSalesLevel:
+        type: string
+        enum:
+          - "cancellable"


what is the difference between cancellable and refundable?

CGantert345 · 2026-07-07T10:11:14Z

LegAlight is used in ScheduledLegs. To include continuous leg data like DownLocation and pickup location there needs to be a ContinuousLeg"Alight".

CGantert345 · 2026-07-07T10:11:57Z

LegBoard is used in ScheduledLegs. To include continuous leg data like DownLocation and pickup location there needs to be a ContinuousLegBoard.

CGantert345 · 2026-07-07T10:15:29Z

+    type: array
+    items:
+      type: string
+      format: train-number


Where is the train-number format?

CGantert345 · 2026-07-07T10:16:58Z

+    type: string
+    format: stop-point-ref
+    description: Reference to the stop point where the leg starts
+  trainNumbers:


regional traffic often uses line numbers instead of train numbers. To be multimodal it should be named vehicleNumbers.

Or ServiceJourney/PublicCode according to NeTEx. But shall be definitly multimodal

CGantert345 · 2026-07-07T10:17:39Z

@@ -0,0 +1,26 @@
+type: object
+required:
+  - pickupLocation


pickupLocation is for continuous legs only

CGantert345 · 2026-07-07T10:28:50Z

+        $ref: .\Mode.yaml
+      class:
+        type: string
+        x-enum-values:


airline categories are of little use. Use rail and public transport classes:

["FIRST","SECOND","ANY_CLASS"]
["BEST","HIGH","STANDARD","BASIC","ANY_CLASS"]

CGantert345 · 2026-07-07T10:39:31Z

There is a large differece between the trip data in the request and the trip data in the reply. The requested trip data are reduced and only need to describe the trip uniquely whereas the trip in replies includes a lot more details (realtime delay information, platform information, the time format for departure and arrival is different (local date time in requests, UTC with offset in replies). I would suggest to use a TripSpecification, LegSpecification in the request.

CGantert345 · 2026-07-07T10:45:39Z

+        type: string
+        description: discriminator for the leg type
+        const: timed
+      journeyRef:


The TimedLeg must contain the DatedJourney, a ref does not work.

DatedJourney: type: object additionalProperties: false description: | Vehicle journey that runs at a specific date. Provided by OJP. required: - vehicleNumbers properties: operatingDayRef: $ref: '#/components/schemas/OperationDayRef' mode: $ref: '#/components/schemas/Mode' productCategory: $ref: '#/components/schemas/ProductCategory' publishedServiceName: description: | Line name or service description as known to the public, f.e. '512', 'S8' or 'Circle Line' or 'ICE 488'. type: string nullable: true example: S1 vehicleNumbers: type: array items: $ref: '#/components/schemas/VehicleNumber' minItems: 1 lineNumbers: type: array items: $ref: '#/components/schemas/LineNumber' serviceStatus: $ref: '#/components/schemas/ServiceStatus' situationFullRefs: type: array items: $ref: '#/components/schemas/SituationFullRef' carriers: type: array items: $ref: '#/components/schemas/NamedCompany' minItems: 1 attributes: type: array items: $ref: '#/components/schemas/GeneralAttribute'

CGantert345 · 2026-07-07T11:12:01Z

serviceDepartureFormation should be added to provide platform information (in the reply)

CGantert345 · 2026-07-07T11:25:03Z

The list of trip sections for the offers is missing in the SearchOfferFilters

Add search offers deliverables: data model YAML files and QEA

a9d8558

edwinvandenbelt changed the title ~~Add search offers deliverables~~ Search offers - the 'What' part - Trip based Jun 22, 2026

edwinvandenbelt changed the title ~~Search offers - the 'What' part - Trip based~~ Search offers - the 'What' part - Trip based - 20260702 Jun 22, 2026

edwinvandenbelt commented Jun 23, 2026

View reviewed changes

OlivierBigex reviewed Jul 2, 2026

View reviewed changes

edwinvandenbelt commented Jul 2, 2026

View reviewed changes

TuThoThai reviewed Jul 2, 2026

View reviewed changes

CGantert345 reviewed Jul 7, 2026

View reviewed changes

Uh oh!

Conversation

edwinvandenbelt commented Jun 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

Choose a reason for hiding this comment

Uh oh!

TuThoThai Jul 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

OlivierBigex commented Jul 2, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

edwinvandenbelt commented Jun 19, 2026 •

edited

Loading

TuThoThai Jul 2, 2026 •

edited

Loading

CGantert345 Jul 7, 2026 •

edited

Loading

CGantert345 Jul 7, 2026 •

edited

Loading