Summary
This page contains documentation of create shipment REST API.
Request Details
| Parameter | Details |
|---|---|
| label | Displays label for shipment. Label must be unique. |
barcode | Barcode of shipment. Barcode must be unique. |
| specimenListIdentifier | Identifier of specimen list which is shipping. |
| senderSite | Sender site name. |
| receiverSite | Receiver site name. |
| senderContactPerson | Sender's user name |
| receiverContactPerson | Receivers user name |
| sendDate | Date of shipping |
| courierName | Courier name of which shipping sent. |
| courierTrackingId | Courier tracking identifier for a shipment. |
| courierTrackingUrl | Courier Tracking url. |
| activityStatus | Activity status of shipment. Permissible values are {In Progress, Received, Rejected } |
Response :
Response of this event contains details of newly created shipment.
Example :
...
{
"label" : "Brain Cancer Specimen Lists",
"barcode" : "11111",
"specimenListIdentifier" :1,
"senderSite" : "Site A",
"receiverSite" : "Site B",
"senderContactPerson" : "siteA.admin@admin.com",
"receiverContactPerson" : "siteB.admin@admin.com"
"senderComments" : "comments",
"sendDate" : "2014-01-01",
"courierName" : "xyz",
"courierTrackingId" : "CT123",
"courierTrackingUrl" : "xyz.com"
}
...
Error Cases
code | Applies to | Status Message |
|---|---|---|
| 200 | All resources | Shipment has been created successfully. |
| 400 | All requests | Invalid parameters, e.g Invalid User-ids, Invalid Specimen-ids, Null or empty label. |
| 401 | All requests | Authorization failed, User doesn’t have Authority. |
| 500 | All requests | Internal server error, Encountered server error while performing operations. |
Tissue banks, also known as sites, are interdependent on each other for their biospecimen requirements. These sites interact with each other for various reasons like shipping the specimens from one site to another site. Some sites act as a central repository where other sites store specimens. For that one site can ship specimens and the receiver site will receive the specimens and store in a new location.