Jump to

• Request
• Response

v1.0

post

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

Marks reconciliation shipments as lost. Rights: OrsInventoryPost and either OrsBlinded 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 : schema

Type: object

Request object containing lost shipment details.

Show Source

• shipmentIds(required): array shipmentIds
  Minimum Number of Items: 1

  Maximum Number of Items: 2147483647

  Contains shipment IDs.

{
    "required":[
        "shipmentIds"
    ],
    "type":"object",
    "properties":{
        "shipmentIds":{
            "maxItems":2147483647,
            "minItems":1,
            "type":"array",
            "description":"Contains shipment IDs.",
            "example":[
                "E39FF55A445543A38D513325664F0B2D",
                "8ECE2C9D389645B09740DC7926DEFB69"
            ],
            "items":{
                "type":"string",
                "format":"uuid"
            }
        }
    },
    "description":"Request object containing lost shipment details."
}

Nested Schema : shipmentIds

Type: array

Minimum Number of Items: 1

Maximum Number of Items: 2147483647

Contains shipment IDs.

Show Source

• Array of: string(uuid)

{
    "maxItems":2147483647,
    "minItems":1,
    "type":"array",
    "description":"Contains shipment IDs.",
    "example":[
        "E39FF55A445543A38D513325664F0B2D",
        "8ECE2C9D389645B09740DC7926DEFB69"
    ],
    "items":{
        "type":"string",
        "format":"uuid"
    }
}

Example:

[
    "E39FF55A445543A38D513325664F0B2D",
    "8ECE2C9D389645B09740DC7926DEFB69"
]

Examples

Select an example Mark lost shipment

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: string(uuid)

{
    "type":"array",
    "items":{
        "type":"string",
        "format":"uuid"
    }
}

Examples

Select an example Success

400 Response

'Invalid shipment type', 'Invalid site ID', 'One or more shipments are invalid', 'Invalid kit status', 'Invalid shipment', 'One or more shipments are invalid'

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 Mark Lost Shipment Bad Request Response

403 Response

User doesn't have access to the site.

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 Mark Lost Shipment Forbidden Response

404 Response

'Site not found', 'Shipment 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 Mark Lost 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 Mark Lost Shipment Server Error Response

Back to Top