New Endpoint: Sold Itinerary Snapshot
Dear Developers,
In this deployment, we add external API support for the Sold Itinerary feature released in January. This addition allows you to use our API to retrieve this snapshot data -- the gross price and itinerary details from the point at which a given quote was booked (see: Sales Workflow Sequence).
For additional information on the Sold Itinerary feature within the FL3XX Web App, please see our Knowledge Base article.
Endpoint(s) Added
GET /api/external/quote/{reference}/bookedSnapshot
Usage Guidelines
- Determine a relevant
bookingid
orexternalReference
(e.g. viaGET /api/external/quote/bookings
) to use as the URL path parameter,reference
. - GET the snapshot information for your
reference
.
The QuoteSnapshotDto Model
The values returned by this endpoint are a record from the point at which the quote moved through the Book stage of the Sales Workflow Sequence.
This endpoint returns a JSON object represented by the **QuoteSnapshotDto**
model. This object has two keys: a PriceEntry object (grossPrice
) and an array of LegDto_2 objects (legs
). The following provides some additional detail regarding these objects.
grossPrice
The value of Total Gross when the quote was booked- This object uses the PriceEntry model, which you may already be familiar with from
GET /api/external/quote/price
. This is a copy of the Sold gross price for this quote as recorded when the quote was booked.
- This object uses the PriceEntry model, which you may already be familiar with from
legs
The itinerary details as they were when the quote was booked.- This key references an array of LegDto_2 objects -- a model used in many places within our API (in particular, the /quote and /leg groups of endpoints). This makes
legs
easily comparable to the current values of thelegs
array returned by, for example,GET /api/external/quote/**reference**
.
- This key references an array of LegDto_2 objects -- a model used in many places within our API (in particular, the /quote and /leg groups of endpoints). This makes
Specification
The full definition for this endpoint, the models used, and example values for payloads can be found under its entry GET /api/external/quote/{reference}/bookedSnapshot
(within the group /api/external/quote
) on our OpenAPI Specification page (SWAGGER UI). If you encounter any challenges or have questions, contact us at [email protected].
Best regards,
FL3XX API Team