The Series· No. 46 · Act XI — The Order, In Full

By DocuSeller · Published

The Order
DocuSeller · No. 46

Eleven states, one honest answer

An order in our system can be in eleven different states.

The buyer only ever sees one of them.

Getting that one right is harder than it sounds.

Three illustrative line items at different stages produce one calculated partially-ready order headline Calculated from the itemsPartially readyItem 1ReadyItem 2ProcessingItem 3VerifyingExample order with three line items
The headline is a calculation, not an opinion.

Buy three packages for three properties in one go. By lunchtime one is finished, one is still being assembled, and one is sitting with somebody in the office who has to read it before it goes out.

So what does the order say?

The old answer is that a person sets it by hand. A person who is, at that exact moment, in a meeting.

Ours is worked out again from scratch every time any line item moves:

→ all of them finished → Ready
→ some of them finished → Partially ready
→ none yet → Processing

Nobody types it. So nobody forgets to.

A status a human has to remember to update isn't a status. It's a rumour.
Eleven possible order states cover payment, fulfillment, refunds, expiry, failure, and archiving One headline, eleven possible statesPayment intentSubmittedPaidProcessingPartially readyReadyOther statesExpiredRefund pendingRefundedArchivedFailed
Eleven boxes. The buyer is shown exactly one of them.

Underneath, each line item runs its own ladder — pending, processing, verifying, on hold, ready, failed, unavailable — so an order can be honest about the two thirds of it that worked.

A late ready result is stopped at a guard while a refunded order remains refunded A refund guards the final stateLate finishReadyRefundedUnchangedA late finish cannot reopen the order
Finishing after the refund does not get you back in.

One rule overrules all of that. If an order has been refunded, a late finish cannot quietly flip it back to Ready. Those states are guarded.

When money is going out, the money wins.

Then the boring bit that saves you.

The moment somebody pays, we freeze a copy of what they bought: the package exactly as configured that day, the options, the price, every fee.

An illustrative catalog price changes from 120 to 135 dollars while the saved purchase still records 120 dollars Example catalog price changeCatalog$120$135New pricePurchase copy$120Purchased configuration stays fixed
The shelf can change. The slip in their hand cannot.

Edit the catalog next month and last month doesn't move.

A year later somebody will ask what exactly they bought. The order still knows.

History is not a live query.

Next: the same order page, on the day the answer isn't Ready at all.

#PropTech · #Automation · #SaaS