1. REST API for Clinical One Cloud Service
  2. Tasks
  3. Randomization and Supplies
  4. Report APIs
  5. Get Order Summary report

[Deprecated]: v3.0
post

/ec-ors-svc/rest/v3.0/studies/{studyId}/{mode}/reports/order-summary

Deprecated: Retrieves the Order Summary report.

Request

Path Parameters
  • Indicates the operational mode of the study. Accepted values: active, test, or training.
    Example:
    test
  • Unique identifier of the study. Uses UUID in a 32-character uppercase hexadecimal string format.
    Example:
    1BC29B36F5D64B1B95F4BDBBCEA481BE
Supported Media Types
Request Body - */* ()
Root Schema : SearchSpecs
Type: object
Title: SearchSpecs
Request body passing search specs like limit, offset and list of fields
Show Source
  • fieldSpecsList
    Field Specification List. Each element describes a single filter applied to the report.
  • Minimum Value: 1
    Maximum Value: 5000
    Maximum number of records to display per page. Provide a value between 1 and 5000 inclusive. Negative numbers are not accepted.
    Example: 50
  • Minimum Value: 0
    Maximum Value: 2147483647
    An order number to specify with which object you want to start retrieving result. If provided, you also need to specify a value for the limit parameter. Provide a zero or positive value.
    Example: 5
Nested Schema : fieldSpecsList
Type: array
Field Specification List. Each element describes a single filter applied to the report.
Show Source
  • Field
    Generic representation of a report filter. Each entry specifies the field to evaluate, its data type, and the values to use when filtering.
Example:
[
    {
        "fieldName":"ruleState",
        "fieldType":"list",
        "fieldSequence":1,
        "fieldValueList":[
            "approved"
        ]
    }
]
Nested Schema : Field
Type: object
Generic representation of a report filter. Each entry specifies the field to evaluate, its data type, and the values to use when filtering.
Show Source
  • Minimum Length: 1
    Maximum Length: 255
    Field name to evaluate. Examples include STUDYID, SITEID, ruleState, and dateRange.
    Example: ruleState
  • Minimum Value: 0
    Maximum Value: 2147483647
    Sequence/order of the field. Provide a non-negative integer.
    Example: 1
  • Minimum Length: 4
    Maximum Length: 16
    Allowed Values: [ "list", "date", "date-time", "number", "string", "boolean" ]
    Field value classification. Use list for enumerations, date for calendar values, date-time for timestamps, number for numeric filters, string for textual filters, or boolean for true/false.
    Example: list
  • fieldValueList
    List of values for the Field. Provide GUIDs for identifier filters or literal values for textual filters.
Example:
{
    "fieldName":"ruleState",
    "fieldType":"list",
    "fieldSequence":1,
    "fieldValueList":[
        "approved"
    ]
}
Nested Schema : fieldValueList
Type: array
List of values for the Field. Provide GUIDs for identifier filters or literal values for textual filters.
Show Source
Example:
[
    {
        "id":"C36A3197FDEE433FB5547EE83DE99E4B"
    }
]
Back to Top

Response

Supported Media Types

200 Response

The result contains the following attributes 1. Shipped By SDF UUID of the site/depot which shipped the shipment. E.g. '41300000900000000000000000000001' 2. Received By SDF UUID of the site/depot which received the shipment. E.g. '41300000900000000000000000000001' 3. Received By SDF ID of Country UUID of the country of the site/depot which received the shipment. E.g. '41300000900000000000000000000001' 4. Shipment ID Name of shipment. E.g. 'Hyd125' 5. Shipment Type Type of shipment. E.g. 'Resupply' 6. Shipment Status Current status of the shipment. E.g. '4' 7. Date Requested Date on which the shipment was raised. E.g. '2020-01-20' 8. Date Received Date on which the shipment was received. null if the shipment is still not received 9. Days Outstanding Number of days until the shipment was received. If the shipment is still not received, this equals the number of days since the shipment was requested (current date - date requested). 9. Days Outstanding Number of days until the shipment was received. If the shipment is still not received, this equals the number of days since the shipment was requested (current date - date requested). 10. Date Cancelled/Marked Lost Date on which the shipment was canceled. null if not available (shipment not canceled) 11. Kit Count No. of kits in the shipment. 12. Kit Numbers in Shipment Kit numbers separated by `\u7F`. E.g. "300\u7F400" Use Character.toString((char) 0x7F) as the delimiter when concatenating multiple kits Use Character.toString((char) 0x7F) as the delimiter when concatenating multiple kits 13. Tracking Number Tracking number which is assigned to the shipment Response Payload: { "result": { "hasMore": "true", "totalResults": 221, "count": 1, "limit": 1, "offset": 0, "columns": [ "Shipped By SDF", "Received By SDF", "Received By SDF ID for Country", "Shipment ID", "Shipment Type", "Shipment Status", "Date Requested", "Date Received", "Days Outstanding", "Date Cancelled/Marked Lost", "Kit Count", "Kit Numbers in Shipment", "Tracking Number", "Temperature Monitor Status" ], "data": [ [ "09CA38D0A01145A285B2086729B4453C", "EB0F5FE4B75E4652800B90BE21521733", "EB0F5FE4B75E4652800B90BE21521733", "depo161", "Manual", "Received", "04-Jan-2022", "04-Jan-2022", "0", "", "4", "100324704780", "", "Yes" ] ] }, "status": "success", "errorData": null }
Body ()
Root Schema : ReportBaseResponse
Type: object
Title: ReportBaseResponse
Response object for report APIs.
Show Source
Nested Schema : PaginatedResponseDto
Type: object
Title: PaginatedResponseDto
Paginated Response Object for report APIs.
Show Source
  • columns
  • Minimum Value: 0
    Maximum Value: 5000
    Total count of result Provide a non-negative integer.
    Example: 5
  • data
    Tabular data where each item is a row represented as an array of string values that align with the columns order.
  • Minimum Length: 4
    Maximum Length: 5
    Allowed Values: [ "true", "false" ]
    Attribute describes if result set has more records Returns "true" when additional records exist, otherwise "false".
    Example: true
  • Minimum Value: 1
    Maximum Value: 5000
    Maximum number of records to display per page. Provide a value between 1 and 5000 inclusive.
    Example: 5
  • Minimum Value: 0
    Maximum Value: 2147483647
    An order number to specify with which object you want to start retrieving result. If provided, you also need to specify a value for the limit parameter. Provide a zero or positive value.
    Example: 400
  • Minimum Value: 0
    Maximum Value: 2147483647
    Total number of entities in response Provide a non-negative integer.
    Example: 5
Nested Schema : columns
Type: array
Show Source
Example:
[
    "name",
    "status"
]
Nested Schema : data
Type: array
Tabular data where each item is a row represented as an array of string values that align with the columns order.
Show Source
  • items
    Row values aligned with the `columns` list; each row must include between 1 and 50 string columns.
Example:
[
    [
        "38891F5E75BB4071BBF8ACE1F43BD1BD",
        "Visit Start Date Validation",
        "approved"
    ]
]
Nested Schema : items
Type: array
Row values aligned with the `columns` list; each row must include between 1 and 50 string columns.
Show Source
  • Row values aligned with the `columns` list; each row must include between 1 and 50 string columns.
    Example: ["38891F5E75BB4071BBF8ACE1F43BD1BD","Visit Start Date Validation","approved"]
Example:
[
    "38891F5E75BB4071BBF8ACE1F43BD1BD",
    "Visit Start Date Validation",
    "approved"
]

400 Response

Invalid search criteria
Body ()
Root Schema : ORSResponse
Type: object
Common response object.
Show Source
Nested Schema : ErrorResponseData
Type: object
Show Source
Nested Schema : result
Type: object
Result Object
Nested Schema : details
Type: object

404 Response

Study not found
Body ()
Root Schema : ORSResponse
Type: object
Common response object.
Show Source
Nested Schema : ErrorResponseData
Type: object
Show Source
Nested Schema : result
Type: object
Result Object
Nested Schema : details
Type: object

500 Response

Internal server error
Body ()
Root Schema : ORSResponse
Type: object
Common response object.
Show Source
Nested Schema : ErrorResponseData
Type: object
Show Source
Nested Schema : result
Type: object
Result Object
Nested Schema : details
Type: object
Back to Top