Introduction

OpenSpecimen allows the user you 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:

...

Below are prerequisites to ship/receive specimens using OpenSpecimen:

• The 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).

Create

...

You can create shipment shipments 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.

Gliffy
imageAttachmentId att287997987 baseUrl https://openspecimen.atlassian.net/wiki migration 1 name Shipment diagramAttachmentId att288194590 containerId 14811246 timestamp 1530883519771

...

Click here to view the steps..

Expand
title Expand to view steps..
title	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. Info title Note From v7.1 onwards, users will be able to create shipments with past/future dates .
Expand
. Go to the home page and click on the 'Shipments' card. Click on the 'Create' button and select the option 'Specimens' Image Removed Image Added In On the 'Create Shipment' page, fill in the details and click on 'Next'. Image Added  Image Removed           Add specimen labels/barcode and click on "Add". Image Added                                                                                             Selected specimens will appear on the next page. In order to To confirm the shipment, click on 'Ship' Image Removed Image Added Further, the users selected in 'Notify Users' will receive an email with a link to the shipment details. A 'Shipment Shipped Event' is created under all specimens that were shipped. Info Once the shipment is “Shipped“, you cannot edit the “Notify Users“ field. You can see the “Notify Users“ field on the overview page for the Shipped shipments but cannot see it on the edit screen.

Ship from query

You can query specimens using the query interface and can ship from the results page.

Expand
title Click here to view the steps...
Go to the queries list page and click on 'Create'  Create a query using any filters and click on 'View Records' to get the list of records Select the specimen rows or click on 'Select All' from the results page and click on 'Specimens' → 'Ship' Image Removed Image Added Enter the further details and click 'Ship' to ship the specimens.

Ship from cart

You can create a cart of the specimens to be shipped and can ship from the cart.

Expand
title Click here to view the steps...
Create a 'Specimen cart' or click on an existing cart from which the specimens have to be shipped. Click on the 'Actions' button and select the option 'Ship'. Image Removed Image Added Enter the further details and click on 'Ship' to ship the specimens.

Ship from other places

You can also ship specimens from the below-listed pages:

1. CP specimen list
2. Container specimen list
3. Reserved specimens list
4. Visit and specimen pages
5. Participant specimen list

E.g., Ship specimens from the participant's specimen list

Expand
title Click here to view the steps...
Go to the overview page of the participant whose specimens has have to be shipped. Click on the 'Specimens' icon from the left-side menu. Select the specimens from the list, click on 'Actions' → 'Ship' Image Removed Image Added Note From v5.1, the The ‘Actions’ button will appear only after selecting at least one specimen from the specimen tree. Enter the further details and click 'Ship' to ship the specimens Similarly, you can ship specimens from any specimen list pages.

Receive

...

The receiver can receive the shipment by clicking on the 'Receive' button from the shipment details page.

Expand
title Click here to view the steps...
In order to To receive the specimens, user from receiving site logs in and selects 'Shipments' from the homepage. Select the shipment from the list and click on 'Receive'. Image Removed Image Added                                                                                                                                                                                       Review the shipment details and click on 'Next' to confirm the receipt of samples. Image Removed Image Added In the next step, you can choose the Received sample quantity  Quality (e.g., acceptable, unacceptable, etc.). Storage location: where the receiving site is storing the specimen On saving, the system will create a 'Shipment Received Event' for each specimen in the shipment. Info Once the shipment is ”Received”, you cannot edit the “Notify Users“ field. You can see the “Notify Users“ field on the overview page for the Received shipments but cannot see it on the edit screen.

Edit the specimen details while receiving a shipment

...

Many a time, the specimens are collected in multiple hospitals for different studies. These specimens are labeled and then shipped to the receiving site receiving site facility for further processing and storage purposepurposes. 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 for better organization and retrieval purposes. From v5.1, there

Expand
There is a system-level setting

...

that 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 the 'Update' button.

...

Image Added Once enabled, you can edit the specimen labels along with other details while receiving the shipment. From the shipped shipments overview page, click on the 'Receive' button→ Click on the 'Next'

...

button,→ Change the specimen labels or other details, and click on the 'Receive' button. Image Added

...

Edit

From v7.1 onwards, user will be able to you edit the shipment details as well. Shipments in draft, shipped, or received mode can be edited. Fields  

Shipment Report

Is It 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 You can download a shipment report as a CSV file with all the details of the shipment event events and sample information from the shipments overview page. 

Expand
title Click here to view the steps...
Go to the shipments list page  page. Click on the shipment whose report has to be downloaded. Click on 'Download Report' from the overview page. Image Removed Image Added

Configure

...

Report

If you want to customize the shipment report, you will have to first create a saved query using the query interface. In the query results view of the query, you have to define the columns you wish to include in the CSV.

Expand
title Click here to view the steps...
Login as super admin and go to the homepage. Click on 'Settings' →  'Common' module. Click on the property 'Shipment Report' Image Removed Image Added  Specify the identifier of the saved query and update the property Image Removed .

Create

...

in bulk

You can create specimens shipment in bulk through bulk operation, for more details refer to 'Create/Update Specimens Shipment'.