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.
Something unclear? Send documentation feedback by email.