Integration GuidesGuide
Catalog & mappings
Canonical Catalog, laboratory codes, biomarker mapping, lifecycle and what each channel sees.
On this page
Catalog onboarding and safe reimport
- Step 2 file import and manual entry use the same governed draft workflow. Preserve source provenance and review worksheet/table, row and field errors before saving.
- Existing-item reconciliation uses exact, case-sensitive native codes. Keep existing entries deliberately; similar names or biomarker overlap do not establish the same test or clinical equivalence.
- A saved draft can remain inactive, unavailable or unmapped. Confirm the canonical readback before treating the import as saved, and retain unsaved work when a request fails.
- Basic durable catalog drafts do not establish reviewed clinical substitution, Production eligibility or a validated laboratory connection. Resolve each missing requirement in its own workflow.
Canonical Catalog
Each workspace has one Catalog. Partner API Programs, Standard DTC and Solia On Demand read governed projections of it; none holds a separate copy.
Laboratory codes and biomarkers
- Every orderable maps to the laboratory's own order code; an unmapped item cannot be transmitted and surfaces as a catalog-mapping exception.
- Expected biomarkers link a test to entries in the canonical biomarker registry. Free text never creates a biomarker.
- Result observations carry terminology codes only as the laboratory supplied them; missing codes are never derived.
Duplicates and lifecycle
- Duplicating a test copies reusable details and biomarker selections but never the laboratory code mapping.
- Active items are orderable where Fulfillment and clinical policy allow; paused items are visible but not orderable; archived items are hidden and restorable; only never-used items can be deleted.
What each channel sees
- Partner API — items in Programs granted to the key, via
GET /v1/programs/{programId}/catalog. - Standard DTC — only storefront-eligible tests: active, visible, available and with a storefront address.
- Solia On Demand — explicitly Published offerings from canonical directory discovery. Directory publication, network-price disclosure and Production transaction readiness remain separate. Discovery displays only public network prices; otherwise Quote required. A configured destination may be laboratory DTC or external HTTPS, but does not grant a Program, Partner API access or serviceability.