Knowledge · Architecture

    Workflow State vs Business State

    Business state is what is true. Workflow state is where work has reached. Confusing the two is why status fields lie and reports disagree.

    What is the difference between workflow state and business state?

    Business state is what is factually true about a record — the amount owed, the address, the signature on file. Workflow state is where that record has reached in a process — qualified, scheduled, in progress, closed. Business state changes because reality changed; workflow state changes because someone or something advanced the work.

    Key takeaways

    • Business state = facts. Workflow state = position in a process.
    • Facts should never be inferred from a stage label.
    • One record can sit in several workflows at once.
    • Reports built on stage names drift; reports built on facts do not.
    • Automation should read facts and write stages, never the reverse.

    Why does the distinction matter?

    When the two are merged into one field, the field starts lying. A deal marked 'Won' does not prove a contract is signed. A job marked 'Complete' does not prove it was invoiced. Once a stage label is treated as evidence, every downstream number inherits the guess.

    Separating them means a stage can be wrong without the underlying facts being wrong — and the facts can be used to correct the stage automatically.

    How do you tell them apart?

    • Ask: could this be verified by an outside party? If yes, it is business state.
    • Ask: does this describe progress rather than reality? If yes, it is workflow state.
    • Business state has a value: an amount, a date, a document, a signature.
    • Workflow state has a position: a stage name in an ordered list.

    What happens when they collapse into one field

    Teams begin using stages to store facts — moving a record to 'Paid' as the only record that money arrived. Now the payment has no amount, no date, no method and no receipt. The moment someone drags the card back, the fact is deleted.

    This is the most common cause of two dashboards disagreeing about revenue.

    How should the two interact?

    Facts drive stages. When a signature is captured, the workflow advances. When payment is recorded, the invoice closes. The stage becomes a readout of reality rather than a claim about it.

    Manual stage changes stay available for human judgment, but they should never be the only evidence that something happened.

    Why AI depends on this separation

    An operational AI asked to 'invoice the completed jobs' needs facts, not labels. If completion is only a stage someone dragged, the AI is acting on an opinion. If completion is a fact with a timestamp and a source, the action is safe and auditable.

    Business state vs workflow state

    CapabilityQuestionBusiness stateWorkflow state
    What does it describe?What is trueWhere work has reached
    Can it be externally verified?YesNo
    Safe basis for money decisionsYesNo
    Changes when reality changesYesSometimes
    Reversible without data lossYesYes, if facts are stored separately
    Good source for automation triggersYesPartial

    Where URBLD fits

    URBLD stores lifecycle facts — signatures, payments, appointments, completions — as records with their own timestamps and actors. Pipeline stages are derived from them, so moving a card never rewrites history.

    FAQ

    Frequently Asked Questions

    Straight answers about how URBLD runs the business end-to-end.

    More in Architecture

    How information should move through a business.

    Browse Architecture
    Share this page