REST API for Clinical One Platform

Update kit attributes

put

/ec-ors-svc/rest/v4.0/studies/{studyId}/{mode}/inventory/kits

Updates kit attributes. Rights: OrsInventoryPost and OrsUnblinded.New filter tempExcursionNumber added.

Request

Path Parameters

mode(required): string

Mode of the study, accepts: test, active, or training
studyId(required): string(uuid)

ID of the study

Supported Media Types

application/json

Root Schema : schema

Type: object

Show Source

inventoryStatusId: integer (int32)

Allowed Values: [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 ]

Unique ID corresponding to each inventory status value (1 for Available, 2 for Damaged, 3 for Destroyed, 4 for Dispensed, 5 for Expired, 6 for Not in Use, 7 for Misallocated, 8 for Missing, 9 for In Transit, 10 for Quarantined, 11 for Pre-quarantined, 12 for Pending Destruction, 13 for Lost by Subject, 14 for Temporarily Unavailable, 15 for Damaged by Subject, 16 for New, 17 for Not Dispensed to Subject, 18 for Returned to Site, 19 for Conserved, 20 for Received for Destruction).

Example: 10
itemNumber: string

Item Numberd

Example: 30100000200000000000000000000005
kitFilters: object KitFiltersRequest

Kit filter request
kits: array kits

Title: kits

Kit id.
labelGroupId: string

Label group id

Example: 30100000200000000000000000000005
location: string

Location

Example: 30100000200000000000000000000005
manufacturingLotId: string

Manufactoring lot id

Example: 30100000200000000000000000000005
materialId: string

Material id

Example: 30100000200000000000000000000005
reason: string

Minimum Length: 0

Maximum Length: 255

Reason of update

Example: kit damaged by subject
updateItemNumber: boolean

Item Number to update or not

Example: true
updateMaterialId: boolean

Material Id to update or not

Example: true

{
    "type":"object",
    "properties":{
        "inventoryStatusId":{
            "type":"integer",
            "description":"Unique ID corresponding to each inventory status value (1 for Available, 2 for Damaged, 3 for Destroyed, 4 for Dispensed, 5 for Expired, 6 for Not in Use, 7 for Misallocated, 8 for Missing, 9 for In Transit, 10 for Quarantined, 11 for Pre-quarantined, 12 for Pending Destruction, 13 for Lost by Subject, 14 for Temporarily Unavailable, 15 for Damaged by Subject, 16 for New, 17 for Not Dispensed to Subject, 18 for Returned to Site, 19 for Conserved, 20 for Received for Destruction).",
            "format":"int32",
            "example":10,
            "enum":[
                1,
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9,
                10,
                11,
                12,
                13,
                14,
                15,
                16,
                17,
                18,
                19,
                20
            ]
        },
        "labelGroupId":{
            "type":"string",
            "description":"Label group id",
            "example":"30100000200000000000000000000005"
        },
        "location":{
            "type":"string",
            "description":"Location",
            "example":"30100000200000000000000000000005"
        },
        "manufacturingLotId":{
            "type":"string",
            "description":"Manufactoring lot id",
            "example":"30100000200000000000000000000005"
        },
        "materialId":{
            "type":"string",
            "description":"Material id",
            "example":"30100000200000000000000000000005"
        },
        "itemNumber":{
            "type":"string",
            "description":"Item Numberd",
            "example":"30100000200000000000000000000005"
        },
        "updateMaterialId":{
            "type":"boolean",
            "description":"Material Id to update or not",
            "example":true
        },
        "updateItemNumber":{
            "type":"boolean",
            "description":"Item Number to update or not",
            "example":true
        },
        "kitFilters":{
            "$ref":"#/components/schemas/KitFiltersRequest"
        },
        "kits":{
            "title":"kits",
            "type":"array",
            "description":"Kit id.",
            "items":{
                "type":"string",
                "format":"uuid"
            }
        },
        "reason":{
            "maxLength":255,
            "minLength":0,
            "type":"string",
            "description":"Reason of update",
            "example":"kit damaged by subject"
        }
    }
}

Nested Schema : KitFiltersRequest

Type: object

Kit filter request

Show Source

blockNumber: string

blockNumber

Example: 1
kitNumber: string

Kit Number

Example: abc-2
kitRange: string

Kit range

Example: SEQUENCE_NUMBER:900:1200
kitStatus: string

Kit status id

Example: 1
kitTypeIds: array kitTypeIds

kitTypeIds
labelGroupId: string

Label group id

Example: B1B8327AFAA6412287106192AB5984EF
location: string

Location

Example: ALL_SITES
lotId: string

Lot id

Example: B1B8327AFAA6412287106192AB5984EF
tempExcursionNumber: string

tempExcursionNumber

Example: 1

{
    "type":"object",
    "properties":{
        "location":{
            "type":"string",
            "description":"Location",
            "example":"ALL_SITES"
        },
        "lotId":{
            "type":"string",
            "description":"Lot id",
            "example":"B1B8327AFAA6412287106192AB5984EF"
        },
        "kitStatus":{
            "type":"string",
            "description":"Kit status id",
            "example":"1"
        },
        "kitRange":{
            "type":"string",
            "description":"Kit range",
            "example":"SEQUENCE_NUMBER:900:1200"
        },
        "labelGroupId":{
            "type":"string",
            "description":"Label group id",
            "example":"B1B8327AFAA6412287106192AB5984EF"
        },
        "kitNumber":{
            "type":"string",
            "description":"Kit Number",
            "example":"abc-2"
        },
        "blockNumber":{
            "type":"string",
            "description":"blockNumber",
            "example":"1"
        },
        "kitTypeIds":{
            "type":"array",
            "description":"kitTypeIds",
            "example":[
                "3F6567865E694182BEEA2B4F76538F05",
                "461A0B8261454C1EBA56285BB538E7B5",
                "EB2B77004EF74E479B6DDBA56D8B6A51"
            ],
            "items":{
                "type":"string",
                "description":"kitTypeIds",
                "format":"uuid"
            }
        },
        "tempExcursionNumber":{
            "type":"string",
            "description":"tempExcursionNumber",
            "example":"1"
        }
    },
    "description":"Kit filter request"
}

Nested Schema : kits

Type: array

Title: kits

Kit id.

Show Source

Array of: string(uuid)

{
    "title":"kits",
    "type":"array",
    "description":"Kit id.",
    "items":{
        "type":"string",
        "format":"uuid"
    }
}

Nested Schema : kitTypeIds

Type: array

kitTypeIds

Show Source

Array of: string(uuid)

kitTypeIds

{
    "type":"array",
    "description":"kitTypeIds",
    "example":[
        "3F6567865E694182BEEA2B4F76538F05",
        "461A0B8261454C1EBA56285BB538E7B5",
        "EB2B77004EF74E479B6DDBA56D8B6A51"
    ],
    "items":{
        "type":"string",
        "description":"kitTypeIds",
        "format":"uuid"
    }
}

Example:

[
    "3F6567865E694182BEEA2B4F76538F05",
    "461A0B8261454C1EBA56285BB538E7B5",
    "EB2B77004EF74E479B6DDBA56D8B6A51"
]

Response

Supported Media Types

application/json

200 Response

Successful operation

Root Schema : UpdateKitsResponse

Type: object

Show Source

noOfRowsUpdated: integer (int32)

Numbers of kits updated

Example: 10
tempExcursionNumber: string

Temperature excursion number

Example: 001

{
    "type":"object",
    "properties":{
        "noOfRowsUpdated":{
            "type":"integer",
            "description":"Numbers of kits updated",
            "format":"int32",
            "example":10
        },
        "tempExcursionNumber":{
            "type":"string",
            "description":"Temperature excursion number",
            "example":"001"
        }
    }
}

400 Response

Specify at least one kit attribute OR Reason is required OR Specify at least one filter. OR Either kits or kitFilters is required OR Invalid kit status OR Invalid kit range filter OR Invalid lot OR Invalid label group in kit filters OR Invalid kit type OR Invalid location OR No kits to update OR Update kits retrieved size exceeds maximum rows for update limit OR Invalid inventory status transition

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

errorData: object ErrorResponseData

Title: ErrorResponseData

Error Response Details Information
result: object result

Result Object
status: string

Status of request

Example: Success
version: integer (int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of request",
            "example":"Success"
        },
        "result":{
            "type":"object",
            "description":"Result Object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        },
        "version":{
            "type":"integer",
            "format":"int32"
        }
    },
    "description":"Common response object."
}

Nested Schema : ErrorResponseData

Type: object

Title: ErrorResponseData

Error Response Details Information

Show Source

details: object Object

Title: Object

Object with error details information.
errorCode: string

Error code which is stored in ErrorCode enum. Example : C1-003

Example: C1-003
errorMessage: string

Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved

Example: Cannot modify object after a study version has been approved

{
    "title":"ErrorResponseData",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Error code which is stored in ErrorCode enum. Example : C1-003",
            "example":"C1-003"
        },
        "errorMessage":{
            "type":"string",
            "description":"Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved",
            "example":"Cannot modify object after a study version has been approved"
        },
        "details":{
            "title":"Object",
            "type":"object",
            "description":"Object with error details information."
        }
    },
    "description":"Error Response Details Information"
}

Nested Schema : result

Type: object

Result Object

Nested Schema : Object

Type: object

Title: Object

Object with error details information.

404 Response

Invalid study ID or version

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

errorData: object ErrorResponseData

Title: ErrorResponseData

Error Response Details Information
result: object result

Result Object
status: string

Status of request

Example: Success
version: integer (int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of request",
            "example":"Success"
        },
        "result":{
            "type":"object",
            "description":"Result Object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        },
        "version":{
            "type":"integer",
            "format":"int32"
        }
    },
    "description":"Common response object."
}

Nested Schema : ErrorResponseData

Type: object

Title: ErrorResponseData

Error Response Details Information

Show Source

details: object Object

Title: Object

Object with error details information.
errorCode: string

Error code which is stored in ErrorCode enum. Example : C1-003

Example: C1-003
errorMessage: string

Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved

Example: Cannot modify object after a study version has been approved

{
    "title":"ErrorResponseData",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Error code which is stored in ErrorCode enum. Example : C1-003",
            "example":"C1-003"
        },
        "errorMessage":{
            "type":"string",
            "description":"Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved",
            "example":"Cannot modify object after a study version has been approved"
        },
        "details":{
            "title":"Object",
            "type":"object",
            "description":"Object with error details information."
        }
    },
    "description":"Error Response Details Information"
}

Nested Schema : result

Type: object

Result Object

Nested Schema : Object

Type: object

Title: Object

Object with error details information.

500 Response

Internal server error

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

errorData: object ErrorResponseData

Title: ErrorResponseData

Error Response Details Information
result: object result

Result Object
status: string

Status of request

Example: Success
version: integer (int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of request",
            "example":"Success"
        },
        "result":{
            "type":"object",
            "description":"Result Object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        },
        "version":{
            "type":"integer",
            "format":"int32"
        }
    },
    "description":"Common response object."
}

Nested Schema : ErrorResponseData

Type: object

Title: ErrorResponseData

Error Response Details Information

Show Source

details: object Object

Title: Object

Object with error details information.
errorCode: string

Error code which is stored in ErrorCode enum. Example : C1-003

Example: C1-003
errorMessage: string

Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved

Example: Cannot modify object after a study version has been approved

{
    "title":"ErrorResponseData",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Error code which is stored in ErrorCode enum. Example : C1-003",
            "example":"C1-003"
        },
        "errorMessage":{
            "type":"string",
            "description":"Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved",
            "example":"Cannot modify object after a study version has been approved"
        },
        "details":{
            "title":"Object",
            "type":"object",
            "description":"Object with error details information."
        }
    },
    "description":"Error Response Details Information"
}

Nested Schema : result

Type: object

Result Object

Nested Schema : Object

Type: object

Title: Object

Object with error details information.