---
type: enum
title: order-status
description: Canonical lifecycle states of an order; stored in the orders.status column.
tags: [enum, canonical]
database: main
stored_in: orders.status
timestamp: {{DATE}}
---
<!-- ✂ docujoint template sample — replace with your own content, then delete this comment. -->
# order-status

## Purpose
The one vocabulary for "where is this order". Flows and services must use
these values — a new state means editing this document first.

## Values
| Value | Meaning | Notes |
|-------|---------|-------|
| placed | Charge succeeded, order exists | initial state |
| fulfilled | Items shipped/delivered | terminal happy state |
| cancelled | Cancelled before fulfilment | refund handled by payments |
| refunded | Money returned after fulfilment | terminal |

## Open questions