Jump to

• Request
• Response

v1.0

post

/ec-ors-svc/rest/v1.0/studies/{studyId}/{mode}/recon/shipments

Retrieves a list of resupply orders where each order contains an order ID and an order status. In the request body, kitRange should have the following format: KIT_NUMBER:min:max. Rights: OrsInventoryPost and either SourceDataVerification or OrsUnblinded.

Request

Path Parameters

• mode(required): string
  Indicates the operational mode of the study. Accepted values: active, test, or training.

  Example:

  test

• studyId(required): string(uuid)
  Unique identifier of the study. Uses UUID in a 32-character uppercase hexadecimal string format.

  Example:

  B1B8327AFAA6412287106192AB5984EF

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : Manual Depot Supply Request

Type: object

Title: Manual Depot Supply Request

Manual depot-to-depot supply request object.

Show Source

• jobInstanceId: string
  Title: Job Instance ID

  Job instance ID.

  Example: 4FEBE3E166454E2687C6FAC306E7C86E
• kits: array kits
  Minimum Number of Items: 1

  Maximum Number of Items: 2147483647
• shippedFrom(required): string (uuid)
  Source depot ID.
• shippedTo(required): string (uuid)
  Destination depot ID.

{
    "title":"Manual Depot Supply Request",
    "required":[
        "shippedFrom",
        "shippedTo"
    ],
    "type":"object",
    "properties":{
        "jobInstanceId":{
            "title":"Job Instance ID",
            "type":"string",
            "description":"Job instance ID.",
            "example":"4FEBE3E166454E2687C6FAC306E7C86E"
        },
        "kits":{
            "maxItems":2147483647,
            "minItems":1,
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/DepotShipmentKitRequest"
            }
        },
        "shippedFrom":{
            "type":"string",
            "description":"Source depot ID.",
            "format":"uuid"
        },
        "shippedTo":{
            "type":"string",
            "description":"Destination depot ID.",
            "format":"uuid"
        }
    },
    "description":"Manual depot-to-depot supply request object."
}

Nested Schema : kits

Type: array

Minimum Number of Items: 1

Maximum Number of Items: 2147483647

Show Source

• Array of: object DepotShipmentKitRequest
  Contains kit details for depot shipment creation.

{
    "maxItems":2147483647,
    "minItems":1,
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/DepotShipmentKitRequest"
    }
}

Nested Schema : DepotShipmentKitRequest

Type: object

Contains kit details for depot shipment creation.

Show Source

• kitTypeId: string (uuid)
  ID of the kit type.
• quantity: string
  Kit quantity

  Example: 2

{
    "type":"object",
    "properties":{
        "kitTypeId":{
            "type":"string",
            "description":"ID of the kit type.",
            "format":"uuid"
        },
        "quantity":{
            "type":"string",
            "description":"Kit quantity",
            "example":"2"
        }
    },
    "description":"Contains kit details for depot shipment creation.",
    "example":[
        {
            "kitTypeId":"B1B8327AFAA6412287106192AB5984EF",
            "quantity":"2"
        }
    ]
}

Example:

[
    {
        "kitTypeId":"B1B8327AFAA6412287106192AB5984EF",
        "quantity":"2"
    }
]

Examples

Select an example Create Depot Recon Shipment Request

Back to Top

Response

Supported Media Types

• application/json

202 Response

Successful operation

Body ()

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

• errorData: object ErrorResponseData
• 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

Show Source

• details: object details
• errorCode: string
• errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : result

Type: object

Result Object

Nested Schema : details

Type: object

Examples

Select an example Create Depot Recon Shipment Response

400 Response

'Kit reconciliation required was not set.','You can't update the status of this kit because the kit was sent to a depot.','You can't update the status of this kit because it's at a site that you don't have access to. Work with your clinical research associate or a clinical supply manager to update the kit.','Reconciliation shipment is not allowed as site has drug destruction capability.','Reconciliation shipment cannot be created as none of the depots have drug destruction capability.','Update kits cannot have both the kit identifiers list and the kits filter set.','Update kits must have either the kit identifiers list or the kits filter set.','Invalid inventory status transition.','Invalid kit at site.', 'Invalid kit range filter.', 'Subject ID is required.','Invalid subject.', 'Update kits no rows were found to update.','Update kits retrieved size exceeds maximum rows for update limit of.','Update kits retrieve error, the following kit identifiers were not found.'

Body ()

Root Schema : ErrorResponseData

Type: object

Show Source

• details: object details
• errorCode: string
• errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : details

Type: object

Examples

Select an example Create Depot Recon Shipment Bad Request Response

404 Response

Site ID not found in site service.

Body ()

Root Schema : ErrorResponseData

Type: object

Show Source

• details: object details
• errorCode: string
• errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : details

Type: object

Examples

Select an example Create Depot Recon Shipment Not Found Response

500 Response

Internal server error

Body ()

Root Schema : ErrorResponseData

Type: object

Show Source

• details: object details
• errorCode: string
• errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : details

Type: object

Examples

Select an example Create Depot Recon Shipment Server Error Response

Back to Top