Materials
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 aDeterminerConcept
ofDescribedKind
and a code ofVaccineType-HPV
(linking to an unspecified formulation)Two Products are defined:
Guardasil4 10 Dose Vials is a
ManufacturedMaterial
withDeterminerConcept
ofQualifiedKind,
a relationship ofManufacturedProduct
withOrganization
Pfizer
as the supplier/manufacturer, and aHas Generalization
relationship withQuantity
of 10 to the generic HPV (i.e. 1 Guardasil4 10 Dose Vial is 10 HPV Unspecified Formulation) and aTypeConcept
ofVaccineType-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 Materials
Creating a new material definition is accessed via the Material List. First the material core properties are configured
Field | Description |
---|---|
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. |
Identification
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.
Extended Attributes
Additionally, the creation of a material may also specify additional extended attributes
Field | Description |
---|---|
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 |
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 |
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. |
Material Details
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.
Bundling Materials
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.
Adding Products
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.
Field | Description |
---|---|
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 |
Stock Quantity | How this product is measured in your implementation of SanteDB. This can also be |
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.
Adding Lot / Batch Numbers
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.
Last updated