Update Shipment

URL: http[s]:<host>:<port>/openspecimen/rest/ng/shipments/{id}

Use this URL to update a shipment in the OpenSpecimen application. Use HTTP PUT method to call this API by passing the below details in JSON format.

Below are the attributes which need to be sent in the request body:

Parameter	Details

Parameter	Details
name	Name of the shipment.
type	Type of the shipment (Optional). Permissible values are {'SPECIMEN', 'CONTAINER'}
courierName	Courier name of which shipping sent (Optional).
trackingNumber	Courier tracking number for a shipment (Optional).
trackingUrl	Courier tracking URL (Optional).
sendingSite	Sender site name.
receivingInstitute	Receiving institute name (Optional).
receivingSite	Receiver site name.
notifyUsers	Collection of users to be notified (Optional).
shippedDate	Date of shipping (Optional).
senderComments	Sender comments (Optional).
status	Status of shipment. Permissible values are {'Pending', 'Shipped'}
senderComments	Comments from the sender of the shipment (Optional).
shipmentSpmns	Collection of specimens to be shipped. When the shipment type is 'SPECIMEN'.
shipmentContainers	Collection of shipments to be shipped. When the shipment type is 'CONTAINER'.

Example:

Below is an example of updating a shipment:

URL	http[s]://<host>:<port>/`openspecimen/rest/ng/shipments/{id}`
Method	PUT
Content-Type	application/JSON
Request	{ "name":"Testing_Shipment_#14", "type":"SPECIMEN", "courierName":"FedEx", "trackingNumber":"FedEx#14", "trackingUrl":null, "sendingSite":"Pune Site", "receivingInstitute":"USB", "receivingSite":"Applied Research", "shippedDate":1591697659000, "status":"Pending", "sender":{ "emailAddress":"admin@localhost" }, "senderComments":"Handle with care. (Edit#2: Added more Specimen)", "activityStatus":"Active", "shipmentSpmns":[ { "specimen":{ "label":"TCP_TBS_4.D1.A14" } }, { "specimen":{ "label":"TCP_TBS_4.D1.A15" } } ], "shipmentContainers":[], "notifyUsers":[ { "emailAddress":"admin@localhost" } ] }
Response	{ "id": 15, "name": "Testing_Shipment_#14", "type": "SPECIMEN", "courierName": "FedEx", "trackingNumber": "FedEx#14", "trackingUrl": null, "sendingSite": "Pune Site", "receivingInstitute": "USB", "receivingSite": "Applied Research", "shippedDate": 1591697659000, "sender": { "id": 2, "type": "SUPER", "firstName": "System", "lastName": "Administrator", "loginName": "admin", "domain": "openspecimen", "emailAddress": "admin@localhost", "instituteName": "USB", "primarySite": "Site BO 1", "admin": true, "instituteAdmin": false, "manageForms": true, "cpCount": 0, "creationDate": null, "activityStatus": "Active" }, "senderComments": "Handle with care. (Edit#2: Added more Specimen)", "receivedDate": null, "receiver": null, "receiverComments": null, "status": "Pending", "activityStatus": "Active", "shipmentSpmns": [], "shipmentContainers": [], "notifyUsers": [ { "id": 2, "type": "SUPER", "firstName": "System", "lastName": "Administrator", "loginName": "admin", "domain": "openspecimen", "emailAddress": "admin@localhost", "instituteName": "USB", "primarySite": "Site BO 1", "admin": true, "instituteAdmin": false, "manageForms": true, "cpCount": 0, "creationDate": null, "activityStatus": "Active" } ], "specimensCount": null, "request": null, "shipmentSpecimen": null, "shipmentContainer": null, "sendMail": true, "mergeKey": "Testing_Shipment_#14" }

Error Cases

code	Applies to	Status Message

code	Applies to	Status Message
200	All resources	The Shipment has been updated successfully.
400	All requests	Invalid parameters, e.g Invalid Users, Invalid Specimen-List id, Null or empty label, barcode.
401	All requests	Authorization failed, User doesn’t have Authority.
500	All requests	Internal server error, Encountered server error while performing operations.