Home » NOVA Public Transport

Domain NOVA Public Transport

[Planned Breaking Changes] [Diagrams] [Artifacts] [Dependencies] [Provided REST Endpoints / Services] [Deprecations] [Maven Artifacts]


Capabilities:

Diagrams

NOVA Public Transport Data Types NOVA Public Transport Service Model NOVA Public Transport Master Data NOVA Public Transport Master Data
- Public Transport Data Types - OpenAPI
- Public Transport Data Types - Types 		- Public Transport Service Model - Extensions
- Public Transport Service Model - OpenAPI
- Public Transport Service Model - Request / Response
- Public Transport Service Model - SuperSaver Statistics 		- Public Transport Master Data - Data Unit
- Public Transport Master Data - Domain
- Public Transport Master Data - OpenAPI 		- Public Transport Events - Domain
- Public Transport Events - OpenAPI

Artifacts

Artifact Icon Maturity Level since
NOVA Public Transport Data Types 🐔 Crazy Chicken
NOVA Public Transport Service Model 🐔 Crazy Chicken
NOVA Public Transport Master Data 🐔 Crazy Chicken
NOVA Public Transport Events 🐦 Early Bird

Dependencies

Artifact Outgoing Dependencies Incoming Dependencies
NOVA Public Transport Data Types - NOVA Public Transport Service Model
NOVA Public Transport Service Model - NOVA Booking Data Types
- NOVA Common Data Types
- NOVA Finance Data Types
- NOVA Master Data Data Types
- NOVA Offer Service Model
- NOVA Organization Data Types
- NOVA Product Data Types
- NOVA Public Transport Data Types
- NOVA System Problem
- NOVA Transport Net Service Model
- NOVA Zone Service Model 		- NOVA Packaging Service Model
NOVA Public Transport Master Data - NOVA Master Data Data Types
- NOVA Tariff Data Types
NOVA Public Transport Events - NOVA Common Data Types
- NOVA Common Events
- NOVA Service Point Data Types
- NOVA Transport Net Data Types
- NOVA Transport Net Service Model

Provided REST Endpoints / Services

PublicTransportActivationService

Service provides operations to activate existing bookable items.


REST Path / Operation Description
/pricing/public-transport:activationOffers [POST]

createActivationOffers(ActivationOfferRequest, SalesContext)


PublicTransportPricingService

Service provides possibility to request public transport offers.

Thereby the following types of requests are supported: * Creation of offers based on timetable connection (one-way or back and forth) * Creation of offers based on so called routes. A route aggregates all similar timetable connections within a period of time. * Creation of offers for a specific NOVA product.

All offer request allow to pass one or more passengers.

In addition to this service there are also more specialized services to request renewal offers or activate a travel authorization.


REST Path / Operation Description
/pricing/public-transport:connection-offers [POST]

createTimetableConnectionOffers(TimetableConnectionOfferRequest, SalesContext) 		Operation can be used to request offers for a timetable connection (one-way or back and forth).

Please be aware that NOVA always operates on scheduled (planned) timetable data and not realtime data. This means to integrators that is expected that the passed timetable connection(s) exists in the scheduled timetable data from Info+.
/pricing/public-transport:route-offers [POST]

createRouteOffers(RouteOfferRequest, SalesContext)
/pricing/public-transport:product-offers [POST]

createProductOffers(ProductOfferRequest, SalesContext)
/pricing/public-transport:fare-network-offers [POST]

createFareNetworkOffers(FareNetworkOfferRequest, SalesContext)
/pricing/public-transport:leg-offers [POST]

createLegOffers(LegBasedOfferRequest, SalesContext)


PublicTransportRenewalService

Service provides operations to create renewal offers for existing bookable items.


REST Path / Operation Description
/pricing/public-transport:renewalOffers [POST]

createRenewalOffers(RenewalOfferRequest, SalesContext)


Planned Breaking Changes

No breaking changes planned.

Deprecations

Package ch.voev.nova.publictransport.datatypes

No deprecations published.


Package ch.voev.nova.publictransport.servicemodel

No deprecations published.


Package ch.voev.nova.publictransport.masterdata

No deprecations published.


Package ch.voev.nova.publictransport.events

No deprecations published.


Maven Artifacts

The following table shows the Maven modules that might be used by integrators.

Module Type [1] NOVA Public Transport Data Types NOVA Public Transport Service Model NOVA Public Transport Master Data NOVA Public Transport Events
OpenAPI 
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-datatypes-api-openapi</artifactId>
</dependency>
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-servicemodel-api-openapi</artifactId>
</dependency>
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-masterdata-api-openapi</artifactId>
</dependency>
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-events-api-openapi</artifactId>
</dependency>
Java 
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-datatypes-api-java</artifactId>
</dependency>
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-servicemodel-api-java</artifactId>
</dependency>
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-masterdata-api-java</artifactId>
</dependency>
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-events-api-java</artifactId>
</dependency>
Java Runtime 
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-datatypes-api-java-runtime</artifactId>
</dependency>
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-servicemodel-api-java-runtime</artifactId>
</dependency>
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-masterdata-api-java-runtime</artifactId>
</dependency>
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-events-api-java-runtime</artifactId>
</dependency>
Services 
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-servicemodel-api-services</artifactId>
</dependency>
REST Client 
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-servicemodel-api-rest-client</artifactId>
</dependency>
REST Client Starter 
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-servicemodel-api-rest-client-starter</artifactId>
</dependency>
Jackson Starter 
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-masterdata-api-starter</artifactId>
</dependency>
<dependency>
    <groupId>ch.voev.nova.publictransport.api</groupId>
    <artifactId>nova-publictransport-events-api-starter</artifactId>
</dependency>

[1] For further details about the different module types please see: