CIMA — AEMPS Drug Reference
Category: Clinical Tools
Node id: cima
Standards: clinical-reference, CIMA-AEMPS
Query the Spanish medicines regulator (AEMPS) CIMA database for authoritative drug reference cards from the ficha técnica.
What it does
- Authoritative drug reference from Spanish medicines regulator (AEMPS)
- Full ficha técnica extraction: indications, posology, contraindications, interactions
- Subsection extraction: renal/hepatic/elderly/pediatric dose adjustments
- Supply problem flag per presentation (CN code)
- AEMPS safety note (pharmacovigilance) history
Use cases
- Retrieve dosing information for a Spanish-authorized medicine
- Check contraindications and interactions from the official ficha técnica
- Verify if a drug has an active supply problem in Spain
- Look up ATC classification for a brand-name drug
Runtime
- Performance tier:
slow
Input ports
| Name | Type | Required | Description |
|---|---|---|---|
query | text | No | Drug name, principio activo, ATC code, nregistro, or CN code |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
card | json | No | Full drug card (null when status is not ok/partial) |
status | text | No | ok | partial | not_found | disambiguation_required | unreachable | rate_limited | query_error |
missing_sections | json | No | List of section IDs not returned by CIMA (on partial status) |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Operation | operation | enum | No | drug_card | drug_card, search, get_section | CIMA operation to perform |
| Query Type | query_type | enum | No | name, principio, atc, nregistro, cn | Hint for search parameter | |
| Nregistro | nregistro | string | No | CIMA registration number (required for get_section) | ||
| Section | seccion | enum | No | 4.1, 4.2, 4.3, 4.4, 4.5, 5.1, 5.2 | Ficha técnica section (for get_section) |
Advanced
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Bypass Cache | bypass_cache | boolean | No | false | Force a fresh fetch from CIMA | |
| Timeout (s) | timeout_seconds | number | No | 15 | Per-call budget in seconds |
Errors
| Code | Description |
|---|---|
QUERY_REQUIRED | query input or config is empty for drug_card/search |
NREGISTRO_SECCION_REQUIRED | nregistro and seccion are required for get_section |
Runtime notes
- card output is null when status is not ok or partial — downstream nodes must check status before using card
- CIMA_USER_AGENT should identify your institution to AEMPS; unset falls back to a platform default rather than failing
- partial status means some ficha técnica sections were unavailable; check missing_sections output
- drug_card performs up to 12 parallel HTTP requests to CIMA; expect 250ms–2s cold-cache latency
See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.
¿Algo no está claro? Envíe sus comentarios sobre la documentación por correo electrónico..