...

Different types of supplies are consumed in different ways. Some supplies are used for a complete visit, e.g., assay kits, whereas supplies like specimen collection containers are used for a single specimen.

OpenSpecimen allows you to decide how the supplies will be consumed. Collection protocols can be configured to consume supplies by specifying the barcode of items or by creating rules. 

Consuming

...

Barcoded Supplies

To consume barcoded supplies:

1. Go Navigate to 'CP settings' and click on 'Supply'.'
2. Specify how you want to consume supplies 

Image Removed 

...

1. supplies. 

Image Added

Consuming Supplies Per Visit

To consume supplies per visit:

1. Configure CP to consume supply per visit.
2. Go to any anticipated visit of configured CP and enter the supply's barcode in the visit name field.
3. Collect the visit   visit.

Image RemovedImage Added

Consuming

...

Supplies Per Specimen

1. Configure CP to consume supply per specimen.
2. Enable specimen barcoding from label format settings.
3. Go to any uncollected specimen of configured CP and enter the barcode of the supply. 
4. Collect the specimen  specimen.  

Image RemovedImage Added

Once the visit/specimen is collected, the barcoded item's status is displayed as 'Used'. 

...

You can configure the system to give an error if the barcode used in a CP is not available unavailable in the supplies inventory. There are two modes:

1. Strict: Gives an error if the barcode is not available.
2. Relaxed: No error (default mode).

To enable the strict mode go to CP → Settings → Supply → select 'Barcode Validation Mode' as 'Strict'.

Image RemovedImage Added

Consuming

...

Non-

...

Barcoded Supplies

OpenSpecimen allows tracking supplies that do not have barcodes, e.g., gloves, syringes, reagents, etc. Once Rules can be set up once these supplies are setup, rules can be set up under a protocol on how these supplies can be consumed.

...

1. Go to protocol overview, click on 'CP settings' and select 'Supply'.'
2. Specify how you want to consume supplies as rules.

Image RemovedImage Added

According to the above rules, whenever a visit is complete for this protocol and if the visit site is 'MSKCC,' 'Lab Safety Gloves' supply will be reduced by 2. 

Similar rules can be specified under specimen, and the supply will be consumed when specific specimens are collected.

Additional

...

Examples

1. Visit rules: Below rules will consume supplies if:

• A visit is created: one supply of type '5ml Vials' is consumed.
• Visit name starts with '04': one supply of type 'Vinyl Gloves' is consumed.

[  
{
    "criteria": "#visit.site == 'MSKCC'",
    "supplyType": "Lab Safety Gloves",
    "consumeQty": 2
  },
  {
    "criteria": "#visit.id != null",
    "supplyType": "5ml Vials",
    "consumeQty": 1
  },
{
    "criteria": "#visit.name matches '^04.*'",
    "supplyType": "Vinyl Gloves",
    "consumeQty": 2
  }
]

...

• Primary fluid specimens collected: One '10ml Tube' will be consumed.
• Aliquot specimen with '2' as initial quantity is created: One '2ml Vials' will be consumed.
• Value of custom field(ST2) is '5ml' for a collected specimen: Five '5ml Vials' will be consumed.

[
  {
    "criteria": "#specimen.lineage == 'New' && #specimen.specimenClass == 'Fluid'",
    "supplyType": "10ml Tube",
    "consumeQty": 1
  },
  {
    "criteria": "#specimen.lineage == 'Aliquot' && #specimen.initialQty == 2",
    "supplyType": "2ml Vials"
  },
  {
    "init": "#specimen.extensionDetail.getAttrsMap()",
    "criteria": "#specimen.extensionDetail.attrsMap['ST2'] == '5ml'",
    "supplyType": "5ml Vials",
    "consumeQty": 5
  },
 {
    "criteria": "#specimen.lineage == 'New' && #specimen.specimenClass == 'Fluid' && #specimen.collectionEvent.container == 'EDTA Vacutainer' && #specimen.collectionEvent.user.emailAddress == 'divya@krishagni.com'",
    "supplyType": "Supply for AQ",
    "consumeQty": 5
  }
]