Pharmacy Catalog Reference Endpoints — FAR_* Tables

Before a pharmaceutical product can be registered in the system, its classification attributes must exist in a set of reference tables that make up the pharmacy catalog. These lookup entities define the controlled vocabulary used across the FAR_* module: the INN generic drug name (FAR_GENERICO), the pharmacological class (FAR_CLASE), the therapeutic family (FAR_FAMILIA), the regulatory typification (FAR_TIPIFICACION), the broad product type category (FAR_TIPO_PRODUCTO), and the consignment arrangement (FAR_CONSIGNACION). Each of the six controllers below exposes a GetAllActives endpoint that returns all active records in its respective table — these lists are typically loaded once at application startup or on catalog screens, and their IDs are used as foreign keys when creating or updating FAR_PRODUCTO records.

All catalog endpoints are HTTP POST with no request body (or an ignored body). Responses follow the standard JsonResponse envelope: Success, Message, and Data (array). All require an Authorization: Bearer {token} header.

FAR_GENERICO — Generic Drug Names (INN)

FAR_GENERICO holds the International Nonproprietary Names (INN) — the official generic names for pharmaceutical substances as designated by the WHO and DIGEMID (Peru’s drug regulatory authority). Each product in the pharmacy catalog is associated with exactly one generic name via id_generico.

`POST /api/FAR_GENERICO/GetAllActives`

Returns all active generic drug name records.Request body — none required.Response — array of FAR_GENERICODTO

Show FAR_GENERICODTO fields

id_generico

int

Primary key for the generic name record.

c_codigo

string

Short alphanumeric code identifying the generic within the system.

t_descripcion

string

Full INN / generic name text (e.g., "PARACETAMOL", "AMOXICILINA").

Sample response

{
  "Success": true,
  "Message": null,
  "Data": [
    { "id_generico": 1,  "c_codigo": "GEN001", "t_descripcion": "PARACETAMOL" },
    { "id_generico": 2,  "c_codigo": "GEN002", "t_descripcion": "AMOXICILINA" },
    { "id_generico": 12, "c_codigo": "GEN012", "t_descripcion": "IBUPROFENO" }
  ]
}

curl example

curl -s -X POST https://{host}/api/FAR_GENERICO/GetAllActives \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

FAR_CLASE — Drug Classification Classes

FAR_CLASE categorises products by their pharmacological class — the mechanism or chemical grouping that defines how a drug acts (e.g., analgesics, antibiotics, corticosteroids). This level of classification sits above the individual generic name and is used for inventory reports and formulary management.

`POST /api/FAR_CLASE/GetAllActives`

Returns all active drug class records.Request body — none required.Response — array of FAR_CLASEDTO

Show FAR_CLASEDTO fields

id_clase

int

Primary key for the drug class record.

c_codigo

string

Short code for the drug class.

t_descripcion

string

Full drug class description (e.g., "ANALGESICOS", "ANTIBIOTICOS").

Sample response

{
  "Success": true,
  "Message": null,
  "Data": [
    { "id_clase": 1, "c_codigo": "CLS001", "t_descripcion": "ANALGESICOS" },
    { "id_clase": 2, "c_codigo": "CLS002", "t_descripcion": "ANTIBIOTICOS" },
    { "id_clase": 3, "c_codigo": "CLS003", "t_descripcion": "ANTIINFLAMATORIOS" }
  ]
}

curl example

curl -s -X POST https://{host}/api/FAR_CLASE/GetAllActives \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

FAR_FAMILIA — Drug Families / Therapeutic Groups

FAR_FAMILIA groups products into therapeutic families that align broadly with the ATC (Anatomical Therapeutic Chemical) classification used by DIGEMID and the WHO. A family may contain multiple drug classes and represents the highest-level grouping used in the pharmacy module for reporting, purchasing budgets, and clinical formulary design.

`POST /api/FAR_FAMILIA/GetAllActives`

Returns all active therapeutic family records.Request body — none required.Response — array of FAR_FAMILIADTO

Show FAR_FAMILIADTO fields

id_familia

int

Primary key for the family record.

c_codigo

string

Short alphanumeric family code.

t_descripcion

string

Full therapeutic family description (e.g., "SISTEMA NERVIOSO CENTRAL", "ANTIBACTERIANOS").

Sample response

{
  "Success": true,
  "Message": null,
  "Data": [
    { "id_familia": 1, "c_codigo": "FAM001", "t_descripcion": "SISTEMA NERVIOSO CENTRAL" },
    { "id_familia": 2, "c_codigo": "FAM002", "t_descripcion": "ANTIBACTERIANOS DE USO SISTEMICO" },
    { "id_familia": 5, "c_codigo": "FAM005", "t_descripcion": "ANTIINFLAMATORIOS Y ANTIRREUMÁTICOS" }
  ]
}

curl example

curl -s -X POST https://{host}/api/FAR_FAMILIA/GetAllActives \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

FAR_TIPIFICACION — Product Typifications

FAR_TIPIFICACION stores the regulatory typification codes used by DIGEMID for official drug registration filings. In Peru, pharmaceutical products must be classified under a specific typification when obtaining a sanitary registration number (Registro Sanitario). This table ensures that every FAR_PRODUCTO record carries its correct regulatory classification for compliance and audit purposes.

`POST /api/FAR_TIPIFICACION/GetAllActives`

Returns all active product typification records.Request body — none required.Response — array of FAR_TIPIFICACIONDTO

Show FAR_TIPIFICACIONDTO fields

id_tipificacion

int

Primary key for the typification record.

c_codigo

string

Regulatory typification code.

t_descripcion

string

Full typification description (e.g., "MEDICAMENTO DE VENTA BAJO RECETA MEDICA").

Sample response

{
  "Success": true,
  "Message": null,
  "Data": [
    { "id_tipificacion": 1, "c_codigo": "TIP001", "t_descripcion": "VENTA LIBRE" },
    { "id_tipificacion": 2, "c_codigo": "TIP002", "t_descripcion": "VENTA BAJO RECETA MEDICA" },
    { "id_tipificacion": 3, "c_codigo": "TIP003", "t_descripcion": "VENTA BAJO RECETA ESPECIAL" }
  ]
}

curl example

curl -s -X POST https://{host}/api/FAR_TIPIFICACION/GetAllActives \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

FAR_TIPO_PRODUCTO — Product Types

FAR_TIPO_PRODUCTO is the top-level discriminator for items in the pharmacy catalog. It distinguishes between broad inventory categories such as manufactured medications, medical supplies, equipment, and reagents. The id_tipo_producto on a product record determines how it is treated in dispensing workflows, purchase orders, and financial reporting.

`POST /api/FAR_TIPO_PRODUCTO/GetAllActives`

Returns all active product type records.Request body — none required.Response — array of FAR_TIPO_PRODUCTODTO

Show FAR_TIPO_PRODUCTODTO fields

id_tipo_producto

int

Primary key for the product type record.

c_codigo

string

Short code for the product type.

t_descripcion

string

Full product type description (e.g., "MEDICAMENTO", "MATERIAL MEDICO", "EQUIPO MEDICO").

Sample response

{
  "Success": true,
  "Message": null,
  "Data": [
    { "id_tipo_producto": 1, "c_codigo": "TP001", "t_descripcion": "MEDICAMENTO" },
    { "id_tipo_producto": 2, "c_codigo": "TP002", "t_descripcion": "MATERIAL MEDICO" },
    { "id_tipo_producto": 3, "c_codigo": "TP003", "t_descripcion": "EQUIPO MEDICO" }
  ]
}

curl example

curl -s -X POST https://{host}/api/FAR_TIPO_PRODUCTO/GetAllActives \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

FAR_CONSIGNACION — Consignment Arrangements

FAR_CONSIGNACION tracks named consignment arrangements with suppliers. Under a consignment model, the clinic stores the supplier’s goods and records stock entries against the consignment ID; financial settlement occurs only when units are dispensed and billed. Each FAR_PRODUCTO record optionally references an id_consignacion to indicate that its stock is managed under such an agreement rather than through a standard purchase.

`POST /api/FAR_CONSIGNACION/GetAllActives`

Returns all active consignment arrangement records.Request body — none required.Response — array of FAR_CONSIGNACIONDTO

Show FAR_CONSIGNACIONDTO fields

id_consignacion

int

Primary key for the consignment arrangement.

c_codigo

string

Short code identifying the consignment arrangement.

t_descripcion

string

Description of the consignment arrangement, typically referencing the supplier name or contract number.

Sample response

{
  "Success": true,
  "Message": null,
  "Data": [
    { "id_consignacion": 1, "c_codigo": "CONS001", "t_descripcion": "CONSIGNACION LABORATORIOS FARMINDUSTRIA" },
    { "id_consignacion": 2, "c_codigo": "CONS002", "t_descripcion": "CONSIGNACION MEDIFARMA S.A." }
  ]
}

curl example

curl -s -X POST https://{host}/api/FAR_CONSIGNACION/GetAllActives \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

Relationship Map

The following table summarises how each catalog entity relates to FAR_PRODUCTO:

Catalog Table	FK on FAR_PRODUCTO	Purpose
`FAR_GENERICO`	`id_generico`	INN / generic substance name
`FAR_CLASE`	`id_clase`	Pharmacological class / mechanism of action
`FAR_FAMILIA`	`id_familia`	Therapeutic family / ATC group
`FAR_TIPIFICACION`	`id_tipificacion`	DIGEMID regulatory typification
`FAR_TIPO_PRODUCTO`	`id_tipo_producto`	Broad item category (medication, supply, etc.)
`FAR_CONSIGNACION`	`id_consignacion`	Consignment stock arrangement (0 = owned stock)

Load all six catalog lists at the start of a product-registration session so that dropdown controls in your UI are populated without per-keystroke API calls.

Security

Patient Management

Clinical Catalog

Insurance & Billing

Pharmacy

Accounting

Pharmacy Catalog Reference Endpoints — FAR_* Tables

`POST /api/FAR_GENERICO/GetAllActives`

`POST /api/FAR_CLASE/GetAllActives`

`POST /api/FAR_FAMILIA/GetAllActives`

`POST /api/FAR_TIPIFICACION/GetAllActives`

`POST /api/FAR_TIPO_PRODUCTO/GetAllActives`

`POST /api/FAR_CONSIGNACION/GetAllActives`

Relationship Map

Build docs developers (and LLMs) love

Security

Patient Management

Clinical Catalog

Insurance & Billing

Pharmacy

Accounting

Documentation Index

​POST /api/FAR_GENERICO/GetAllActives

​POST /api/FAR_CLASE/GetAllActives

​POST /api/FAR_FAMILIA/GetAllActives

​POST /api/FAR_TIPIFICACION/GetAllActives

​POST /api/FAR_TIPO_PRODUCTO/GetAllActives

​POST /api/FAR_CONSIGNACION/GetAllActives

​Relationship Map

Build docs developers (and LLMs) love

`POST /api/FAR_GENERICO/GetAllActives`

`POST /api/FAR_CLASE/GetAllActives`

`POST /api/FAR_FAMILIA/GetAllActives`

`POST /api/FAR_TIPIFICACION/GetAllActives`

`POST /api/FAR_TIPO_PRODUCTO/GetAllActives`

`POST /api/FAR_CONSIGNACION/GetAllActives`

Relationship Map