Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ttpullima/RomsoftBackEnd2021_v2/llms.txt

Use this file to discover all available pages before exploring further.

CIE-10 — the Spanish abbreviation for Clasificación Internacional de Enfermedades, 10.ª revisión (ICD-10, International Classification of Diseases, 10th Revision) — is the global standard for encoding diagnoses, diseases, symptoms, and causes of death. In Peru, CIE-10 codes are mandated by MINSA (Ministerio de Salud) for all clinical records, insurance claims, and SUSALUD reporting. The Gestión Clínica system stores the full CIE-10 catalogue in the ADM_CIE10 table and organises codes into hierarchical categories via ADM_TIPO_CIE10. Two controllers expose this catalogue: ADM_CIE10Controller for querying individual codes, and ADM_TIPO_CIE10Controller for retrieving the category types. All endpoints require a valid Authorization bearer token.
All endpoints in both controllers use HTTP POST. Filter criteria are passed in the request body following the API-wide convention.

​
Data Transfer Objects

​
ADM_CIE10DTO

Represents a single CIE-10 diagnosis code entry.
​
id_cie10
integer
Unique numeric surrogate key for the CIE-10 record.
​
c_codigo
string
The official CIE-10 alphanumeric code (e.g., "J00" for acute nasopharyngitis, "I10" for essential hypertension). Format follows the ICD-10 pattern: one letter followed by two digits, optionally with a decimal subdivision.
​
t_descripcion
string
Full Spanish-language description of the diagnosis (e.g., "Hipertensión esencial (primaria)").
​
valorReq
string
A free-text search token used exclusively as a request filter in GetAllFilters. Pass a partial code or partial description to perform a substring search. Not populated in response objects.

​
ADM_TIPO_CIE10DTO

Represents a CIE-10 category type — a top-level grouping used to classify codes into broad diagnostic chapters.
​
id_tipo_cie10
integer
Unique numeric key for the CIE-10 type/category.
​
c_codigo
string
Short code for the category (e.g., "I" for diseases of the circulatory system).
​
t_descripcion
string
Full Spanish description of the CIE-10 category chapter.

​
ADM_CIE10 Endpoints

​
POST /api/ADM_CIE10/GetAllActives

Returns every active CIE-10 diagnosis code in the system. No request body is required. This endpoint is most useful for initial catalogue loading; for interactive search use GetAllFilters instead.
The full CIE-10 catalogue contains thousands of entries. Consider caching the result client-side and using GetAllFilters for real-time typeahead search rather than requesting the full list on every interaction.
Request 
curl -s -X POST \
  https://{base_url}/api/ADM_CIE10/GetAllActives \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"
Response — success 
{
  "Success": true,
  "Data": [
    {
      "id_cie10": 1,
      "c_codigo": "A00",
      "t_descripcion": "Cólera",
      "valorReq": null
    },
    {
      "id_cie10": 2,
      "c_codigo": "A00.0",
      "t_descripcion": "Cólera debida a Vibrio cholerae 01, biotipo cholerae",
      "valorReq": null
    }
  ],
  "Message": null,
  "Warning": false
}
Response — error 
{
  "Success": false,
  "Data": null,
  "Message": "Ocurrió un error, inténtelo más tarde.",
  "Warning": false
}

​
POST /api/ADM_CIE10/GetAllFilters

Searches active CIE-10 codes using a free-text filter. Pass an ADM_CIE10DTO body with the valorReq field set to your search term. The server performs a substring match against both the code and the description, making this endpoint ideal for typeahead autocomplete in diagnosis entry forms. Request body
​
valorReq
string
required
Search token. Can match any part of c_codigo or t_descripcion. Case-insensitive. Example: "hipert" would match "Hipertensión esencial".
​
id_cie10
integer
Optional. If provided, restricts results to a specific record by its primary key.
​
c_codigo
string
Optional. If provided, filters by exact or partial code match (behaviour determined by the BL layer).
​
t_descripcion
string
Optional. If provided, filters by description substring.
Request 
curl -s -X POST \
  https://{base_url}/api/ADM_CIE10/GetAllFilters \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"valorReq": "hipert"}'
Response — success 
{
  "Success": true,
  "Data": [
    {
      "id_cie10": 412,
      "c_codigo": "I10",
      "t_descripcion": "Hipertensión esencial (primaria)",
      "valorReq": null
    },
    {
      "id_cie10": 413,
      "c_codigo": "I11",
      "t_descripcion": "Enfermedad cardíaca hipertensiva",
      "valorReq": null
    }
  ],
  "Message": null,
  "Warning": false
}
Response — no matches 
{
  "Success": true,
  "Data": [],
  "Message": null,
  "Warning": false
}

​
ADM_TIPO_CIE10 Endpoints

​
POST /api/ADM_TIPO_CIE10/GetAllActives

Returns all active CIE-10 type categories. These categories correspond to the chapter-level groupings of the ICD-10 classification (e.g., Chapter I: Certain infectious and parasitic diseases, Chapter IX: Diseases of the circulatory system). No request body is required.
Use this endpoint to populate a category filter on diagnosis search UIs, allowing clinicians to narrow searches to a specific clinical domain before drilling into individual codes.
Request 
curl -s -X POST \
  https://{base_url}/api/ADM_TIPO_CIE10/GetAllActives \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"
Response — success 
{
  "Success": true,
  "Data": [
    {
      "id_tipo_cie10": 1,
      "c_codigo": "I",
      "t_descripcion": "Ciertas enfermedades infecciosas y parasitarias"
    },
    {
      "id_tipo_cie10": 2,
      "c_codigo": "II",
      "t_descripcion": "Tumores (neoplasias)"
    },
    {
      "id_tipo_cie10": 9,
      "c_codigo": "IX",
      "t_descripcion": "Enfermedades del sistema circulatorio"
    }
  ],
  "Message": null,
  "Warning": false
}

​
Response Envelope

All endpoints return a uniform JsonResponse envelope:
FieldTypeDescription
Successbooleantrue if the request completed without a server-side exception.
Dataarray / nullThe payload — array of ADM_CIE10DTO or ADM_TIPO_CIE10DTO on success.
Messagestring / nullHuman-readable message, populated on warning or error states.
Warningbooleantrue when a business-rule condition was triggered (not a hard failure).

​
Common Use Cases

ScenarioRecommended endpoint
Initial load of all codes for offline-capable appGetAllActives
Real-time typeahead in a diagnosis fieldGetAllFilters with valorReq
Populating a chapter/category filterADM_TIPO_CIE10/GetAllActives

Build docs developers (and LLMs) love

Get started for freeTalk to us