InventoryReport
A stock snapshot at a given time: quantities on hand, locations, near-expiry dates. The reporting pivot for hospital logistics.
Purpose
InventoryReport aggregates stock lines (InventoryItem) to produce an inventory snapshot on a given date: annual audit, quality control, insurance declaration after a loss. The report may be a full snapshot, a delta (difference since the last report) or a trend (evolution over a period).
Key elements
| Field | Type | Cardinality | Role |
|---|---|---|---|
identifier | Identifier[] | 0..* | Report identifiers. |
status | code | 1..1 | `draft`, `requested`, `active`, `entered-in-error`. |
countType | code | 1..1 | `snapshot`, `difference`. |
operationType | CodeableConcept | 0..1 | Operation type (cycle count, audit, recall). |
reportedDateTime | dateTime | 1..1 | Stock-taking date. |
reporter | Reference(Practitioner | Patient | RelatedPerson | Device) | 0..1 | Report author. |
reportingPeriod | Period | 0..1 | Period covered if delta/trend. |
inventoryListing | BackboneElement[] | 0..* | Detailed stock lines. |
JSON example
{
"resourceType": "InventoryReport",
"id": "example-inv-report-2026Q2",
"status": "active",
"countType": "snapshot",
"operationType": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/inventoryreport-operationtype",
"code": "stocktake"
}]
},
"reportedDateTime": "2026-06-30T20:00:00+00:00",
"reporter": {
"reference": "Practitioner/pharmacist-001"
},
"inventoryListing": [{
"location": {
"reference": "Location/pharmacy-cabinet-A12"
},
"items": [{
"category": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/inventoryitem-category",
"code": "drug"
}]
},
"quantity": {
"value": 247,
"unit": "tablet"
},
"item": {
"reference": {
"reference": "InventoryItem/example-inv-aspirin"
}
}
}]
}]
}Common pitfalls
- Confusing countType=snapshot and difference: snapshot replaces the prior state, difference only touches listed items.
- No location.reference: cannot geo-locate shortages.
- reportedDateTime drifting several hours from the real count moment: rotation KPIs skewed.
Related resources
- inventoryitem — stock lines.
- location — location.
- organization — owning organisation.
- auditevent — audit trace.