Introduction
OpenSpecimen allows the user to track the shipment of samples from one site to another. For example, collection site to the central repository.
To ship boxes refer to Shipment of Containers
Prerequisites to ship
System will throw an error and will not allow you to ship if any of the below is not satisfied:
- Shipping site and receiving site should use the same instance of OpenSpecimen
- Both sites and the logged-in user should be part of the CP that has the specimens being shipped
- Cannot ship specimens from multiple sites in one shipment
- If the specimens being shipped are stored in a container, the site of the container should be sending site.
- When receiving a shipment, the user can only store specimens in the containers of the receiving site
- The sending site should be the site to which specimens belong (Site under CP).
Difference between 'Distribution' & 'Shipping'
Create Shipment
You can create shipment from multiple pages. The "Action" button now available in all specimen pages allows you to create shipments without having to add specimens to the cart.
Create Shipment
You can create a new shipment by going to the "Shipment" module and scanning or typing in the specimen labels. This works well when you already have the list of specimens to ship.
Note
From v7.1 onwards, users will be able to create shipments with past/future dates.
Ship from query
You can query specimens using the query interface and can ship from the results page.
Ship from cart
You can create a cart of the specimens to be shipped and can ship from the cart
Ship from other places
You can also ship specimens from the below-listed pages:
- CP specimen list
- Container specimen list
- Reserved specimens list
- Visit and specimen pages
- Participant specimen list
E.g. Ship specimens from the participant's specimen list
Receive Shipment
The receiver can receive shipment by clicking on 'Receive' button from the shipment details page.
Edit the specimen details while receiving a shipment (New in v5.1)
Many a time, the specimens are collected in multiple hospitals for different studies. These specimens are labeled and then shipped to the receiving site facility for further processing and storage purpose. For faster collection and data entry, the labeling at hospitals is done using generic labels like the randomly generated unique numbers etc. However, when specimens are received at the receiving site, for better organization and retrieval purpose, the biobankers relabel the received specimens based on their type, collection container, study, or other established practices.
From v5.1, there is a system level setting which will allow you to relabel the shipped specimens while receiving the shipment. To enable/disable this setting, go to 'Settings' → 'Administrative' module → 'Relabel Shipment Specimens' → Select option 'Enabled' and click on 'Update' button.
Once enabled, you can edit the specimen labels along with other details while receiving the shipment. From shipped shipments overview page, click on 'Receive' button→ Click on 'Next' button→ Change the specimen labels or other details and click on 'Receive' button.
From v7.1 onwards, user will be able to edit the shipment details as well. Shipments in draft, shipped or received mode can be edited. Fields allowed to be edited are mentioned below,
- Shipment name
- Tracking URL
- Courier name
- Sender/receiver comments
- Shipped and received dates
- Received quality
The following attributes are not editable:
- Sending and receiving sites cannot be modified after the shipment is shipped.
- Specimens cannot be added or removed from the shipment after it is shipped.
- Specimen location and quantity cannot be modified after the shipment is received.
Shipment Report
Is a CSV file that you can download from the shipment page. The system comes with a default report and can be customized by the super-admin.
Download Report
Users can download a shipment report as a CSV file with all the details of shipment event and sample information from shipments overview page.
Configure Shipment Export Report
If you want to customize the shipment report, you will have to first create a saved query using the query interface. In the results view of the query, you have to define the columns you wish to include in the CSV.
Create Specimens shipment in bulk
You can create specimens shipment in bulk through bulk operation, for more details refer to 'Create/Update Specimens Shipment'.