Obsidian Jet Docs

Build a trip from a quote

Turn an accepted quote into a trip and its legs — and what happens when the quote already has one.

Trip Builder turns an accepted quote into a trip with one or more legs. Use it to create a trip from a quote, or to start one from scratch.

  1. Open Trip Builder from the Dispatch & Ops navigation.
  2. If you're building from a quote, search for it in the quote history picker and select it. Trip Builder prefills the origin, tails, and passenger counts from the quote — every field is still editable before you submit.
  3. Add each leg with + ADD LEG: origin, destination, scheduled out/in, and PAX. Set a trip-level default tail, or override the tail on an individual leg, for example a repositioning/ferry leg.
  4. Watch the live route preview map as you add legs, and check the pre-flight validation panel — it mirrors the server's own itinerary check, so a fixable problem shows up before the round trip to the API.
  5. Select BUILD TRIP.

What "attach, not duplicate" means

A quote can only ever have one trip. If the quote you picked already has a trip — someone already built one from it, or the deal came back after the trip was cancelled and rebuilt — Trip Builder does not mint a second trip. It attaches your new legs to the existing trip, continuing that trip's leg numbering, and the response reports attached_to_existing.

If the quote's trip has already been marked SOLD or otherwise committed, the server refuses a silent append and returns a trip_locked conflict (HTTP 409) instead. Trip Builder surfaces this as a warning you can explicitly confirm past — appending to a committed trip is possible, but never silent.

A separate, unrelated conflict — turntime_conflict — can also stop a submit: the persisted minimum-turn-time guard between two legs on the same tail. This is an advisory scheduling guard, not a compliance verdict, and Trip Builder shows the server's reason verbatim.

Once the trip exists, open it in the Trip Workspace to work its legs, crew, and documents.

On this page

Build a trip from a quote — Obsidian Jet