cima-rs 0.0.7

Rust library and CLI providing access to the Spanish AEMPS CIMA REST API and nomenclator XML parser
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

# cima-rs

Rust library providing access to the [AEMPS CIMA](https://cima.aemps.es/cima/publico/home.html) (Centro de Información Online de Medicamentos de la AEMPS) nomenclator data and REST API.

## Features

- **XML Data Dumps**: Download and parse CIMA nomenclator XML files to CSV
- **REST API Client**: Complete async client for the CIMA REST API
  - Medication information (`medicamentos`)
  - Commercial presentations (`presentaciones`)
  - Supply problems (`psuministro`)
  - Clinical descriptions (VMP/VMPP)
  - Safety notes and informative materials
  - Segmented documents (ficha técnica, prospecto)
  - Master data catalogs
  - Change logs
- **CLI Tool**: `nomenclator` binary for both CSV conversion and API queries

## Installation

```bash
cargo install cima-rs
```

## Usage

### CLI Tool: `nomenclator`

The `nomenclator` binary provides two modes of operation:

#### CSV Mode: Download and Convert XML to CSV

```bash
# Download XML files and convert to CSV
nomenclator csv --output-dir ./output --work-dir ./data

# With custom concurrency
nomenclator csv --concurrency 8
```

This will:

- Download the latest CIMA nomenclator ZIP file
- Extract all XML files
- Parse them in parallel to CSV format
- Generate 20+ CSV files ready for database import

#### API Mode: Query REST API

```bash
# Get specific medication by registration number
nomenclator api medicamento --nregistro 51347 --presentaciones --activos

# Search medications
nomenclator api search-medicamentos --nombre "Paracetamol" --limit 20
nomenclator api search-medicamentos --laboratorio "Pfizer" --comercializados

# Get presentation details
nomenclator api presentacion --cn 12345678

# Get supply problems
nomenclator api supply-problems
nomenclator api supply-problems --cn 12345678

# Get safety notes
nomenclator api safety-notes --nregistro 51347

# Get changes since a date
nomenclator api changes --desde "01/01/2024"

# Query master data
nomenclator api maestra --tipo pa --nombre "Paracetamol"
nomenclator api maestra --tipo lab --limit 50
```

Available master data types (`--tipo`):

- `pa` - Principios activos (active ingredients)
- `ff` - Formas farmacéuticas (pharmaceutical forms)
- `va` - Vías de administración (administration routes)
- `lab` - Laboratorios (laboratories)
- `atc` - Códigos ATC (ATC codes)

### Rust Library API

```rust
use cima_rs::{CimaClient, SearchMedicationsParams};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let client = CimaClient::new()?;
    
    // Get specific medication by registration number
    let med = client.get_medication(Some("51347"), None).await?;
    println!("Medication: {}", med.name);
    
    // Search medications
    let params = SearchMedicationsParams {
        name: Some("Paracetamol".to_string()),
        ..Default::default()
    };
    let results = client.search_medications(&params).await?;
    
    Ok(())
}
```

See `examples/query_medicamento.rs` for a complete example.

#### Multi-CSV Parser (Recommended)

```rust,no_run
use cima_rs::parser::parse_prescription_xml_to_csvs;
use anyhow::Result;

fn main() -> Result<()> {
    parse_prescription_xml_to_csvs("input.xml", "output_dir")?;
    Ok(())
}
```

This generates multiple normalized CSV files:

## API Endpoints

All endpoints return structured Rust types with serde serialization support:

- `get_medication()` - Get medication details
- `search_medications()` - Search medications with filters
- `search_in_technical_sheet()` - Search in technical sheets
- `get_presentation()` - Get presentation details
- `search_presentations()` - Search presentations
- `get_all_supply_problems()` - Get all supply problems
- `get_supply_problems()` - Get supply problems by CN
- `search_clinical_descriptions()` - Search clinical descriptions
- `get_safety_notes()` - Get safety notes
- `get_informative_materials()` - Get informative materials
- `get_document_sections()` - Get document sections
- `get_document_content()` - Get document content
- `get_master_data()` - Get master data catalogs
- `get_change_log()` - Get change logs

## Requirements

- Rust 1.91+
- Tokio async runtime

## License

See LICENSE file.