Jump to

• Request
• Response

[Deprecated]: v1.0

put

/ec-ors-svc/rest/v1.0/studies/{studyId}/{mode}/supply/settings

Deprecated: Use latest version instead. Updates supply settings of a study by study ID.
Rights: SupplySettingRightsPost.
Required sponsor roles are: clinical supply manager and site manager.

Request

Path Parameters

• studyId(required): string(uuid)

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : SupplySettingsTO v1.0

Type: object

Title: SupplySettingsTO v1.0

Supply settings for study/site.

Show Source

• allowManualConsignments(required): boolean
  Title: Allow Manual Consignments

  Indicates whether manual consignments are allowed.

  Example: true
• allowSingleKitQuarantine(required): boolean
  Title: Allow Single Kit Quarantine

  Indicates whether single kit quarantine is allowed.

  Example: true
• customShipmentIdPrefix: string
  Title: Shipment ID Prefix

  Prefix used while generating shipment IDs.

  Example: SomePrefix
• intlShipmentTriggerId(required): number (double)
  Initial shipment trigger Id.

  Example: 2
• intlShipmentVisitId: string (uuid)
  Title: Initial Shipment Visit ID

  Identifier of the visit for initial shipments.
• sendKitTypeForSingleKitOrder: string (uuid)
  Title: Kit Type ID

  Identifier of the selected kit type for single kit ordering.
• shipmentPrefixType(required): string
  Title: Shipment ID Prefix Type

  Allowed Values: [ "DEPOTID", "CUSTOM", "NONE" ]

  Type identifier used when generating shipment ID prefixes.

  Example: DEPOTID
• singleKitSettingId: number (double)
  Title: Single Kit Setting ID

  Identifier of the single kit ordering setting.

  Example: 1
• useBlindingGroups(required): boolean
  Title: Blinded Groups Required

  Indicates whether blinding groups are required.

  Example: true
• useLabelGroups(required): boolean
  Title: Label Groups Required

  Indicates whether label groups are required.

  Example: true
• useShippingGroups(required): boolean
  Title: Multiple Storage Requirements

  Indicates whether multiple storage/shipping requirement groups are used.

  Example: true
• useTemperatureExcursion(required): boolean
  Title: Allow Temperature Excursions

  Indicates whether temperature excursions are allowed.

  Example: true
• waitDaysBeforeNotifying: number (double)
  Title: Notification To Receive Shipment (in days)

  Minimum Value: 0

  Maximum Value: 30

  Number of days before a notification is sent to receive a shipment.

  Example: 2

{
    "title":"SupplySettingsTO v1.0",
    "required":[
        "allowManualConsignments",
        "allowSingleKitQuarantine",
        "intlShipmentTriggerId",
        "shipmentPrefixType",
        "useBlindingGroups",
        "useLabelGroups",
        "useShippingGroups",
        "useTemperatureExcursion"
    ],
    "type":"object",
    "properties":{
        "useBlindingGroups":{
            "title":"Blinded Groups Required",
            "type":"boolean",
            "description":"Indicates whether blinding groups are required.",
            "example":true
        },
        "useLabelGroups":{
            "title":"Label Groups Required",
            "type":"boolean",
            "description":"Indicates whether label groups are required.",
            "example":true
        },
        "useShippingGroups":{
            "title":"Multiple Storage Requirements",
            "type":"boolean",
            "description":"Indicates whether multiple storage/shipping requirement groups are used.",
            "example":true
        },
        "useTemperatureExcursion":{
            "title":"Allow Temperature Excursions",
            "type":"boolean",
            "description":"Indicates whether temperature excursions are allowed.",
            "example":true
        },
        "allowSingleKitQuarantine":{
            "title":"Allow Single Kit Quarantine",
            "type":"boolean",
            "description":"Indicates whether single kit quarantine is allowed.",
            "example":true
        },
        "allowManualConsignments":{
            "title":"Allow Manual Consignments",
            "type":"boolean",
            "description":"Indicates whether manual consignments are allowed.",
            "example":true
        },
        "singleKitSettingId":{
            "title":"Single Kit Setting ID",
            "type":"number",
            "description":"Identifier of the single kit ordering setting.",
            "format":"double",
            "example":1
        },
        "sendKitTypeForSingleKitOrder":{
            "title":"Kit Type ID",
            "type":"string",
            "description":"Identifier of the selected kit type for single kit ordering.",
            "format":"uuid"
        },
        "intlShipmentTriggerId":{
            "type":"number",
            "description":"Initial shipment trigger Id.",
            "format":"double",
            "example":2
        },
        "intlShipmentVisitId":{
            "title":"Initial Shipment Visit ID",
            "type":"string",
            "description":"Identifier of the visit for initial shipments.",
            "format":"uuid"
        },
        "waitDaysBeforeNotifying":{
            "title":"Notification To Receive Shipment (in days)",
            "maximum":30,
            "minimum":0,
            "type":"number",
            "description":"Number of days before a notification is sent to receive a shipment.",
            "format":"double",
            "example":2
        },
        "shipmentPrefixType":{
            "title":"Shipment ID Prefix Type",
            "type":"string",
            "description":"Type identifier used when generating shipment ID prefixes.",
            "example":"DEPOTID",
            "enum":[
                "DEPOTID",
                "CUSTOM",
                "NONE"
            ]
        },
        "customShipmentIdPrefix":{
            "title":"Shipment ID Prefix",
            "type":"string",
            "description":"Prefix used while generating shipment IDs.",
            "example":"SomePrefix"
        }
    },
    "description":"Supply settings for study/site."
}

Examples

Select an example Update Supply Settings Request

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation

Body ()

Root Schema : IDResponse v1.0

Type: object

Title: IDResponse v1.0

Response containing the identifier.

Show Source

• id: string (uuid)
  ID

{
    "title":"IDResponse v1.0",
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"ID",
            "format":"uuid"
        }
    },
    "description":"Response containing the identifier."
}

Examples

Select an example Update Supply Settings Response

400 Response

Invalid shipment OR Invalid Kit status OR One or more shipment are not in valid status OR Custom shipment prefix should be of length between 1 to 10 and contains only alphanumerics OR Invalid shipment prefix type.

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 Update Supply Settings Bad Request Response

404 Response

Not found

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 Update Supply Settings Not Found Response

500 Response

Internal server error

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 Update Supply Settings Server Error Response

Back to Top