Skip to main content

Supply Chain Workflow

# For Randomization Study

How the IMP supply chain works in ClinicalDataS for studies using Randomization mode — from IP code assignment through delivery to sites, dispensing, and returns.

Supply Chain Workflow (Randomization mode)​

info

For the business definition of IMP, see IMP in Getting Started. For setup, see IMP Setup — Randomization Mode.

The IMP supply chain tracks investigational product (IP) from creation through subject dispensing and return. A Randomization-mode study is limited to a single investigational product, tracking is fixed to By Unique Serial Number, and dispensing is driven by the subject's randomized treatment arm rather than a manual product selection.

IP Code list of CARDIO-RELIEF 2025 with Placebo Tablet codes in Available, Assigned, Returned and Omitted status
  1. Add a single IP code
  2. Import a batch of IP codes from a file
MenuSub-itemPurpose
TransferReceiptsWarehouse confirms receipt from the Central Depot — see Receipts
TransferDelivery to SiteShip IP kits to a Clinical Research Site, filtered by treatment arm — see Delivery to Site
TransferDispensesConfirm IP dispensed to a subject after randomization and kit assignment — see Dispenses
TransferReturnsRecord unused, expired, damaged, or excess IP returned from a site — see Returns
ProductsProductsView the study's single product and its barcode
ProductsIP CodeAdd and manage individual IP codes, with Study Group (treatment arm) assignment — see IP Codes
ConfigurationWarehousesCentral Depot plus intermediate/site pharmacy locations — requires Manage Warehouse = On
ConfigurationUnit of Measure CategoryProduct units (e.g., Tablet)
ReportStock by Warehouse, Stock by Site, Move History, Dispensation, Expiry, DamagedInventory and movement reporting — see Inventory Warehouse, Inventory Site, Waste Warehouse, Waste Site, Internal Transfer
DashboardDashboardReal-time supply chain analytics and charts — see Dashboard

Supply Chain Flow​

Each movement is a record with its own status, shown on the matching Transfer list:

MovementStatuses, in orderEnds early with
ReceiptsDraft → DoneRejected
Delivery to SiteDraft → Prepared → On Delivery → DoneCancelled — Reject while Draft or Prepared
DispensesReady For Dispense → DispensedOn Hold, Cancelled
ReturnsDraft → Requested → Approved → Preparing → On Delivery → Received → ClosedRejected — while Requested

The two movements with the most steps:

Delivery to Site

Returns

  • A delivery moves to Prepared when the sponsor side confirms it, to On Delivery when the warehouse confirms the shipment, and to Done when the site validates receipt. The site's confirmation is its receipt record; there is no separate site receipt step.
  • A return created by the sponsor side skips Requested and goes from Draft to Approved. A return received with a shipping error is set to Quarantined instead of Received; both are closed with Verify all detail.

The full sequence, including the setup steps that come before the first movement:

Step 1 — Configuration
└─ Warehouses: Central Depot + site pharmacies (e.g., Bach Mai Hospital Pharmacy, Cho Ray Hospital Pharmacy)
└─ Unit of Measure: Tablet

Step 2 — Products
└─ Single product defined: e.g., CardioRelief CRF-101 50mg Tablet (Randomization mode allows only one product per study)

Step 3 — IP Codes (Products → IP Code)
└─ Add codes one-by-one or bulk import via CSV
└─ Assign Study Group at creation (e.g., CardioRelief CRF-101 arm or Placebo arm)
⚠️ Unblinded operation — visible to unblinded roles only

Step 4 — Receipts: Central Depot → Warehouse [Manage Warehouse = ON only]
└─ Sponsor ships from Central Depot to an intermediate Warehouse
└─ Warehouse confirms receipt (Transfer → Receipts), selecting kits per treatment arm

Step 5 — Delivery to Site (Transfer → Delivery to Site)
Two request types:
└─ Sponsor-initiated: Sponsor selects a warehouse → ships to site
└─ Site-initiated: Site Pharmacist requests → Sponsor approves + assigns warehouse → ships to site
[Manage Warehouse = OFF: source is the Central Depot directly]

Step 6 — Dispenses (Transfer → Dispenses)
└─ Subject completes randomization → Site Pharmacist generates and confirms the dispense from the subject's event

Step 7 — Returns (Transfer → Returns)
└─ Site records unused, expired, damaged, or excess IP returned
Two IMP Configuration toggles control the supply chain

Is the Supply Chain function enabled?

  • Yes — activates the Delivery Request workflow (Transfer → Delivery to Site). Two request types are available:
    • Sponsor-initiated: Sponsor selects a warehouse and creates a delivery to a site.
    • Site-initiated: Site Pharmacist requests a delivery → Sponsor reviews, approves, and assigns the source warehouse.
  • No — the Transfer section is not available; supply chain operations are disabled.

Manage Warehouse (in IMP Setup)

  • On — 3-tier flow: Central Depot → Warehouse → Site Pharmacy. The intermediate Receipts step is required before IP codes can be delivered to sites.
  • Off — 2-tier flow: Central Depot → Site Pharmacy directly. The Receipts step does not apply.

Design vs Production mode​

The IMP app header shows Design and Production toggle buttons:

  • Design — configuration changes allowed; no real supply transactions
  • Production — live operational mode; IP codes and transfers are real

Configure all settings in Design mode before switching to Production.


Prerequisites​

Before adding IP codes:

  1. The Randomization module is fully configured (treatment arms, randomization algorithm, study group parameters) — see IMP Setup — Randomization Mode.
  2. Exactly one product is defined under Products → Products (Randomization mode allows only one).
  3. At least one warehouse is defined under Configuration → Warehouses, when Manage Warehouse is on.
  4. Units of measure are defined under Configuration → Unit of Measure Category.

Studies using PSP mode instead: For PSP Study — Supply Chain Workflow