Medicator Connector for Odoo 17

API Methods

Method	Endpoint	Description
classify(device_name)	POST /api/v1/classify	AI classification of a medical device by name
catalog_search(query)	GET /api/v1/catalog	Search the device catalog (paginated)
catalog_detail(code)	GET /api/v1/catalog/{code}	Detailed device info by Medicator code
ocr(file_content)	POST /api/v1/ocr	Extract device info from nameplate photo
account_info()	GET /api/v1/me	Plan and API usage info
manufacturers(query)	GET /api/manufacturers	List manufacturers (paginated)
manufacturer_detail(slug)	GET /api/manufacturer/{slug}	Manufacturer detail with categories
manufacturer_devices(slug)	GET /api/manufacturer/{slug}/devices	Devices by manufacturer (paginated)
request(method, endpoint)	any	Generic authenticated request

Usage Examples

Classify a device

api = self.env["medicator.api"]
result = api.classify("Ultraschallgerät Siemens Acuson")

result["medicator_code"]  # "MED-IMG-ULT"
result["confidence"]  # 0.95
result["reasoning"]   # "Ultraschallgeräte gehören zur Bildgebung..."
result["category"]    # {"name_de": "Ultraschall", "cluster": "Medizin", ...}
result["path"]        # [{"level": "l1", "code": "MED", "name": "Medizin"}, ...]
result["in_catalog"]  # True

Search the catalog

results = self.env["medicator.api"].catalog_search("Röntgen", page=1)

results["items"]  # list of matching devices
results["total"]  # total number of results
results["pages"]  # total pages

Get device detail

device = self.env["medicator.api"].catalog_detail("RAD-COM-SOA")

device["model_name"]    # "Somatom"
device["manufacturer"]  # {"id": "...", "name": "Siemens Healthineers"}
device["category"]      # {"code": "RAD-COM-SOA", "name_de": "CT", ...}

OCR from a nameplate photo

# Accepts Odoo Binary fields (base64) directly:
result = self.env["medicator.api"].ocr(
    record.image_field,
    filename="nameplate.jpg",
)

result["manufacturer"]    # "Siemens"
result["model"]           # "Acuson Sequoia"
result["serial_number"]   # "SN-12345"
result["medicator_code"]  # "MED-IMG-ULT"
result["candidates"]      # [{"code": "...", "model_name": "...", ...}]

Manufacturers

# List
mfrs = self.env["medicator.api"].manufacturers(query="Siemens")

# Detail
mfr = self.env["medicator.api"].manufacturer_detail("siemens-healthineers")

# Devices by manufacturer
devs = self.env["medicator.api"].manufacturer_devices(
    "siemens-healthineers", category="RAD", page=1,
)

Account info

info = self.env["medicator.api"].account_info()

info["plan"]    # "pro"
info["limit"]   # 1000
info["name"]    # account name
info["email"]   # account email

Configuration

1. Go to Settings → Medicator
2. Enter your API URL (default: https://medicator.io)
3. Enter your API Key (format: med_xxxxxxxxxxxxx)
4. Click Test Connection to verify

For Developers

# your_addon/__manifest__.py
{
    "depends": ["dtx_medicator_connector"],
}

# your_addon/models/your_model.py
class YourModel(models.Model):
    _name = "your.model"

    def action_classify_device(self):
        result = self.env["medicator.api"].classify(self.device_name)
        self.medicator_code = result["medicator_code"]
        self.confidence = result["confidence"]

All methods raise odoo.exceptions.UserError on configuration, authentication, rate-limit, or validation errors.

Full API documentation: Swagger UI | ReDoc | OpenAPI JSON