Materials
Last updated
Last updated
This page documents a SanteDB 3.0 Feature
In SanteDB and is derived products: SanteEMR, SanteIMS, etc. the concept of a Material is used to express any physical object which is used to deliver care. This includes:
Types / Classifications of materials (see: Determiner Codes)
Manufactured types of materials (such a trade names, products, etc.)
Lot numbers (individual orderable instances of the material)
Take, for example, the material of HPV - HPV is modeled in SanteDB as:
Here:
HPV Unspecified Formulation is a Material with a DeterminerConcept of DescribedKind and a code of VaccineType-HPV (linking to an unspecified formulation)
Two Products are defined:
Guardasil4 10 Dose Vials is a ManufacturedMaterial with DeterminerConcept of QualifiedKind, a relationship of ManufacturedProduct with Organization Pfizer as the supplier/manufacturer, and a Has Generalization relationship with Quantity of 10 to the generic HPV (i.e. 1 Guardasil4 10 Dose Vial is 10 HPV Unspecified Formulation) and a TypeConcept of VaccineType-HPV4
Guardasil9 10 Dose Vials with the same linkages
Two Lot numbers defined as:
Lot #0293 which is an instance of Guardasil4 10 Dose Vials
Lot #3982 which is an instance of Guardasil4 10 Dose Vials
To manage materials, administrators should use Reference Data > Materials this will present the administrator with a list of all top level material definitions in SanteDB.
The administrator can use this screen to:
Create a new material definition in the SanteDB instance
Export the master material list as a dataset to be imported into another SanteDB instance
View an existing registered material
Delete or UnDelete a registered material
Creating a new material definition is accessed via the Material List. First the material core properties are configured
Material Type
The type/classification of the material being created, this dictates the CVX code used when this material is represented on user interfaces.
Is Administrable
When selected, indicates that the material can be administered to a patient (examples: drugs, vaccines, etc.) when a material cannot be administered these are supportive materials (examples: syringes, diluents, etc.)
Official Name
The long-form, official name for the material.
Common Name
The short-form name used in summary reports and user interfaces
Form
The form code which the material takes on - this can be injection, pills, drops, applicators
Dose Unit
When the material is dosed or administered, the unit of measure to be used (examples: Dose, Milliliter, Deciliter, Bags, Puffs, Drops etc.)
Special Instructions
Any special instructions which are to be added to the material.
Materials typically also carry one or more identifiers which are used for interoperability with logistics systems, and other trading partners.
Depending on your deployment of SanteDB, there may be additional identifier types which are required to facilitate interoperability. Please consult your local deployment documentation.
Additionally, the creation of a material may also specify additional extended attributes
Parent
If the material is a child in a hierarchy of materials, then the parent may be specified here. For example, it is possible to create a material kind called RoutineVitaminSupplement which is a parent of Vitamin K, Vitamin A, etc.
Has Parts
If the material is a composite of other materials, the individual components of the materials should be listed here.
Bundled Materials
If the material is directly linked to other materials which are consumed as a result of consuming this material, they are listed here. For example, one dose of BCG consumes one dose of BCG Diluent which consumes one ADS_0.05 syringe and a reconstitution syringe
Regulatory Body
If the material is a part of a regulation or approval process, then specify the regulatory bodies which are required to approve these materials.
Approved Treatment
If the material is used specifically for the treatment or prevention of one or more diseases, then list the diseases here. This can be used for more complex CDSS rules to determine full immunity for a specific disease.
The material details page shows all relevant information associated with the material including:
Core properties of the material
The relationships of one material to another
Products and lot number associated with the material
Any of the data in the panels can be changed by selecting the edit option for the material panel.
When a material is bundled with another, use the Bundle Items tab. Administrators should then select the material associated and the quantity of the material incuded. I.e. for every 1 of the current material n of the linked material is used.
To add a product to a material, select the Products tab. This will display a list of all products which are related to the current material.
A new product is created by selecting Add and entering the related material details.
Manufacturer
The manufacturer of the material (the registered manufacturing organization in the SanteDB organization list)
Product Code
If the product has a more specific codification than the parent/generic material then the product code is specified.
Trade Name
The trade name of the material
GS1 GTIN
The GTIN which is used for ordering the product from the LMIS system
Contained Quantity
The number of the parent material which is contained in one instance of the product. For 5 dose vials this is 5 for 20 dose vials this is 20, etc.
Stock Quantity
How this product is measured in your implementation of SanteDB. This can also be Doses or can be Vials or Crates or Boxes
Batches/Lots
If you wish to pre-create a series of lot numbers and batches this may be done here
Administrators can delete products as well using the product screen.
Deleting the Product also hides all associated lot numbers for that product, and prevents further syncrhonization to dCDR clients. It is recommended to use the status indiator instead.
Batches and lots can be added to the material via the Lot Numbers tab, which shows a summary of all lot numbers registered for the material.
To add a lot number, the Add option can be used, alternatively the Edit option can be used to edit a single instance of the batch.
