Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Purpose

This WS allows to create Specimen entity by employees without submitting Encounter Data Package.

...

  • Check it references to employee or patient resource

    • in case of error - return 422 ('value is not allowed in enum')

  • If collector is an employee:

    • Check it exists in the DB

      • in case of error - return 422 ('Employee not found')

    • Check it is active and approved

      • in case of error - return 422 ('Invalid employee status')

    • Check that employee is related to the legal entity (client_id) from token

      • in case of error - return 422 ('Employee doesn't belong to your legal entity')

  • If collector is a patient:

    • Check it is an existing current patient in the DB (mongosubject)

      • in case of error - return 422 ('Patient not found')

      Check it is active

      • in case of error - return 422 ('Patient is not activeIn case collector is patient it must be the current patient')

2. Collected

Validate there is one of the required $.collection.collected_[x] field is set: collected_date_time or collected_period.

...

HTTP status code

Message

What caused the error

400 

Invalid signed content

401 

Invalid access token

403 

Access denied. Party is not verified

403 

Access denied. Party is deceased

403 

Your scope does not allow to access this resource. Missing allowances: specimen:write

404

not found

409

Patient is not verified

409 

'client_id refers to legal entity that is not active'

409 

'Patient is not active'

422 

Service request expiration date must be greater than or equal to current date

422 

Service request is not active or in progress

422 

Identifier already exists in the specimen

422 

Legal entity with such id is not found

422 

Service request is used by another legal entity

422 

Service request not found

422 

Does not match the signer drfo

422 

Collected quantity must not be exceeded by the specimen quantity distributed among the containers

422 

Date must be greater than <current date - SPECIMEN_MAX_DAYS_PASSED>

422 

Does not match the code of the collected quantity

422 

Employee doesn't belong to your legal entity

422 

Employee not found

422 

End date must be greater than or equal the start date

422 

End date must be in past

422 

Invalid employee status

422 

Invalid specimen status

422 

Must be in past

422 

not allowed in enum

422 

Patient is not active

422 

Patient not found

422 

Specimen with such id is not found

422 

Start date must be in past

422 

User is not allowed to register a specimen for the employee

422 

value is not allowed in enum

422 

schema validation error

422 

Managing_organization does not correspond to user's legal_entity

422 

Specimen with id <id> already exists

422 

Only one of the parameters must be present

422

In case collector is patient it must be the current patient