Medications and families

ModuleCatalogs

Suggested profileAdministration

PermissionMEDICATIONS: WRITE / ADMIN

StatusValidated

Objective

Maintain the catalog of medications, their variants (presentations, indications, formulas) and the families that group them. It is the source of the medications used when creating prescriptions.

How the screen is organized

TreeTable with two levels:

1. Medication family (first level).
2. Medications of the family (second level).
3. Variants of the medication (presentation, indication, formulas) inside each medication.

Above the table there is a search engine (300 ms debounce) and a toolbar with high and bulk delete actions.

Available actions

• Create family: registration of a family to group medications.
• Create medication: registration inside a family.
• Create variant: registration of a variant with presentation, indication and formulas.
• Edit family / medication / variant: adjust the data.
• Delete: each level has its own confirmation dialog. Requires MEDICATIONS: ADMIN.

Permissions

• MEDICATIONS: WRITE to create and edit.
• MEDICATIONS: ADMIN to delete.

Before starting

• Have the presentation containers configured (see Presentations).
• Know the families that the clinic manages.

Step by step - Create family

1. Go to Catalogs -> Medications and families.
2. In the Families sub-tab, click New family.
3. Enter name and description.
4. Confirm.

Step by step - Create medication

1. Locate the destination family.
2. Click the Add medication icon.
3. Enter: name, family, tags, active components.
4. Confirm.

Step by step - Create variant

1. Locate the destination medication.
2. Click the Add variant icon.
3. Enter: presentation (container), indication, formulas.
4. Confirm.

Expected result

• The family, medication or variant are registered.
• They appear available in the catalog when creating prescriptions.
• The system shows a success message.

Pending: add screenshot of catalogos-medicamentos-01-listado.png and catalogos-medicamentos-02-variantes.png.

Common errors

Situation	What to do
The medication does not appear when creating a prescription	Verify that the family, medication and variant are active.
An active component is missing	Register it from Active components.

Suggested permissions

• MEDICATIONS: WRITE.

Operational recommendations

• Create the families before the medications.
• Use standardized active components to facilitate searches and reports.
• Keep the variants updated (for example, when the presentation of a lab changes).

Relation with other modules

• Prescriptions: medications and variants are selected when creating a prescription.
• Templates: templates use medications and variants from the catalog.
• Active components: variants reference active components from the catalog.
• Presentations: containers (box, bottle, ampule) come from the presentations catalog.