Order statuses

Every order status this store has, grouped by the three axes an order carries — status (the cart lifecycle), payment_status and fulfillment_status — with a live count of how many orders stand in each. Each row has a stable code, the merchant's label, a colour, and the flags code branches on: flag (new, complete or cancelled), counts_as_paid, reduces_stock, restores_stock and is_final. Read this before setting a status on an order: the four values the plugin shipped with are no longer the only ones a store can have. is_seed rows cannot be deleted.

Add a status to one axis. axis, code and flag are required and the rest have defaults. The code is lowercase letters, digits and underscores, at most 16 characters, and it is permanent — every order that ever reaches this status stores it, so it cannot be renamed afterwards. flag is what every report, retention rule and add-on branches on and is the one field worth getting right: complete counts the order as a sale, cancelled takes it back out, new means it has not happened yet.

Rename, recolour, reposition, reflag or switch off one status. The axis and the code are not editable and are ignored if sent: every order already written carries the code. Switching off a status that orders are standing in is refused with the count. A built-in status can be changed here in every way except deleted.

Remove a status a merchant added. Refused with 409 for a built-in status — those can be renamed, recoloured and switched off but never removed, because the schema names several of them — and refused with 409 and a count for any status orders are currently standing in. Move those orders first.