Laboratory IntegrationGuide
Mappings
Linking Solia orderables to laboratory codes.
On this page
Why mappings matter
A mapping links a Solia orderable to the code your laboratory system expects. Unmapped orderables are reported as catalog health because they cannot be fulfilled reliably.
- The laboratory owns mapping accuracy; Solia enforces that an unmapped orderable cannot be transmitted.
- A missing mapping surfaces as a canonical catalog-mapping exception, not as a silent failure at order time.
- For native connections, mappings are authored as immutable draft revisions and must be approved by a different reviewer than the author; a rollback creates a new revision rather than editing history.
- Mapping keys are the mapping kind and the local laboratory code (case-insensitive). Output fields such as units are never used to tell two inputs apart, and two local codes mapping to the same target are flagged for review.
- Owner-facing connection changes require Lab Admin access. Native dictionary authoring requires separate governed integrations-management capability; independent review requires platform-operator authority and an active tenant-qualified clinical reviewer distinct from the author. Operations may contribute technical information.
Versioned full-panel review
Current equivalence review compares full nonempty test/panel component multiset including LOINC, UCUM, role, specimen and method. Names, biomarker overlap or required-only sets cannot grant exact equivalence. Changed fingerprints/revision, missing codes or stale approval refuse; advanced review remains draft-only until approved persistence exists.
Reference laboratory engineering boundary
Reference/send-out is source-only and unavailable in Sandbox or Production. Existing integration, buyer, publication and clinical authorities remain unchanged; a directory listing or relationship never authorizes a referral.
Native codes and terminology
- A native orderable is identified by its issuing system, version and code — not by its display name.
- Name or code similarity produces a suggestion for review, never an approved mapping.
- Approval is by an authorized laboratory reviewer against the current source version; a newer source revision invalidates pending reviews.
- Solia does not invent LOINC, SNOMED CT or UCUM codes or convert units. Unknown codes stay unknown until the laboratory supplies them.
- An approved mapping does not by itself make a test orderable, covered or releasable.