Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Summary 

This page contains documentation of update shipment REST API.You can use http[s]:<host>:<port>/catissuecore/rest/ng/shipments/{label}  url to update shipment. 


Request Details

ParameterDetails
labelDisplays label for shipment. Label must be unique.

barcode

Barcode of shipment. Barcode must be unique.
specimenListIdentifierIdentifier of specimen list which is shipping.
senderSiteSender site name.
receiverSiteReceiver site name.
senderContactPersonSender's user name
receiverContactPersonReceivers user name
sendDateDate of shipping
courierNameCourier name of which shipping sent.
courierTrackingIdCourier tracking identifier for a shipment.
courierTrackingUrlCourier Tracking url.
activityStatusActivity status of shipment. Permissible values are {In Progress, Received, Rejected }

...

Response of this event contains details of updated shipment. 


Example :

URLhttp://<host>:<port>/catissuecore/rest/ng/shipments/{label}
MethodPUT
Content-Typeapplication/json
Request

{
"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"
}

Response


{
"id" : 1,
"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
200All resourcesShipment has been deleted successfully.
400All requestsInvalid parameters, e.g Invalid Users, Invalid Specimen-List id, Null or empty label, barcode.
401All requestsAuthorization failed, User doesn’t have Authority.
500All requestsInternal server error, Encountered server error while performing operations.