PharmacyCopilot Docs

Moving a Transfer Through Its Status Pipeline

The 4 statuses a transfer moves through, in order.

A transfer has 4 possible statuses:

  • Pending — created, not yet moved
  • In transit — stock has left the source location
  • Completed — stock has arrived and been received at the destination
  • Cancelled — abandoned before completion

Allowed transitions

FromCan move to
PendingIn transit, Completed, or Cancelled
In transitCompleted or Cancelled

You can mark a transfer Completed directly from Pending — moving through "In transit" first isn't required, useful for a same-location handoff where there's no real transit time. Once a transfer reaches Completed or Cancelled, it's final — attempting any further status change is rejected with "Cannot transition from '{status}' to '{newStatus}'."

Completing a transfer is the point where stock actually moves — the source location's stock decreases and the destination's increases only once status hits Completed, not when it's created or marked in transit.