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. Navigate to 'CP settings' and click on 'Supply'.
2. Specify how you want to consume supplies. 

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.

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.  

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

Barcode Validation Mode

You can configure the system to give an error if the barcode used in a CP is 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'.

Consuming Non-Barcoded Supplies

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

To consume barcoded supplies:

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

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
  }
]

2. Specimen rules: Below rules will consume supplies if:

• Primary fluid specimens collected by the specified user and collected in EDTA Vacutainer: Five '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 == '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": "10ml Tube",
    "consumeQty": 5
  }
]