← All product docs
Gearflow · Parts

Order timeline

Every quote and order in Gearflow records a timeline of itself: who created it, every edit, the moment it was approved, when it shipped, when an invoice arrived. Buyers and dealers see the same trail from their respective sides.

#Why this exists

The procurement conversation between a buyer and a vendor is rarely clean. A vendor sends a Quote, the buyer asks for a different quantity, the shipping cost gets revised, an item gets added or dropped — and somewhere in there both sides agree on a number. Days later, when an invoice doesn't match the original Quote, the question "what changed?" needs to be answerable in seconds, not by hunting through email.

The timeline solves this. Every event that touches the Quote or Order is recorded with a snapshot of what the order looked like at that moment, and "Order edited" events spell out what changed compared to the previous state. It is the audit trail that makes a multi-step negotiation legible after the fact.

#What you're looking at

The buyer-side Timeline tab on an Order detail page. From top: 'Quote approved by Michael Lewis', 'Invoice received', 'Shipped' with carrier UPS and a tracking number, then a chain of 'Order edited - Quote created' entries each listing what changed: shipping increased, a line removed, a line added.
The buyer-side Timeline tab on an Order detail page. Newest events at the top. Lifecycle markers (Quote approved, Shipped, Invoice received) carry their own metadata; "Order edited" events show a "Changes" header followed by a bulleted diff against the prior snapshot.

Each entry contains:

#What the change diff covers

The "Changes" bullets describe the delta between consecutive snapshots. The diff covers:

It does not surface unit-price changes on existing lines. If a vendor revises only a unit price (and quantity stays the same), the "Changes" header still appears but the bullet list comes up empty. The price difference is still visible inside the snapshot disclosure for both events; it just isn't called out at the top level.

#The snapshot disclosure

The same timeline with one Order snapshot disclosure expanded, showing the full line items at that point: Cutting Edge Bolt Kit $80.00 x 1, Engine Oil Filter (CAT) $50.00 x 5, Fuel Filter $42.00 x 2, Hydraulic Oil Filter $58.50 x 2, plus Shipping $42.50.
Any event's Order snapshot can be expanded to show the full state of the order at that moment — every line with its current price and quantity, plus shipping and tax. Useful when the buyer wants to resolve a dispute against the exact state at a specific time.

The snapshot is the canonical "what did the order look like right then" record. It's available on the initial Quote-created event, on every "Order edited" event, and on a few other event types that change the order's shape.

#Where it surfaces

The same timeline data renders on both sides of Gearflow:

Both sides see the same lifecycle of the Quote-then-Order, but each side's version filters out events that don't belong to it (e.g., a buyer's private timeline note doesn't show up on the dealer side).

#Tips