Book a load sequence
Follow a quote request through booking confirmation and asynchronous dispatch.
A successful booking returns to the caller before dispatch consumes its confirmation event. This fictional freight workflow puts synchronous requests and asynchronous messages in the same sequence diagram.
Adapt the flow
Change the participants to match your services. Steps refer to participant IDs through from and to; msgType distinguishes sync, return and async messages.
The example follows the successful path through quote creation and booking. Add the failures your review needs to cover, such as an expired quote or a rejected booking. The diagram records the intended message order; it does not verify runtime behavior.
Template YAML
apiVersion: archdocs/v1
title: Book a load
nodes:
- id: bookFlow
type: sequence-diagram
title: Book a load
at:
x: 0
y: 400
participants:
- id: tms
label: Shipper TMS
kind: actor
- id: api
label: Public API
- id: quote
label: Quote Engine
- id: booking
label: Booking Service
- id: events
label: booking-events
- id: dispatch
label: Dispatch Service
steps:
- message: POST /v2/quotes
from: tms
to: api
msgType: sync
- message: PriceLane
from: api
to: quote
msgType: sync
- message: 201 Quote
from: api
to: tms
msgType: return
- message: POST /v2/bookings
from: tms
to: api
msgType: sync
- message: CreateBooking
from: api
to: booking
msgType: sync
- message: BookingConfirmed
from: booking
to: events
msgType: async
- message: 201 Booking
from: api
to: tms
msgType: return
- message: BookingConfirmed
from: events
to: dispatch
msgType: async