Welche Schnittstellen bietet Probatix?

REST-API für Aufträge, Statusabfragen und Befundabruf; Webhooks für Push-Benachrichtigungen bei Statuswechseln (derzeit im Beta-Release); FHIR-R4-Endpoint für interoperable Befunde. Optional: Partner-Portal als grafische Alternative ohne eigene Entwicklung.

Werden Befunde FHIR-konform geliefert?

Ja. Befunde werden als FHIR-R4-Bundle ausgeliefert, mit Observation-Ressourcen je Parameter, einer DiagnosticReport-Ressource für den Gesamtbefund und passenden Patient/Practitioner-Referenzen. Werte sind LOINC-codiert.

Was sind LOINC-Codes und warum sind sie wichtig?

LOINC (Logical Observation Identifiers Names and Codes) ist der internationale Standard zur eindeutigen Identifikation klinischer Messparameter. „Glukose im Serum“ hat unter LOINC 2345-7 in jedem System dieselbe Identität – das macht Befunde interoperabel und spart Mapping-Aufwand auf der Empfängerseite.

Wie lange dauert die Integration?

Für eine Standard-Anbindung an die REST-API typischerweise wenige Tage Entwicklungszeit. Hinzu kommen Test-Sandbox-Phase und Compliance-Setup. Realistische Time-to-Live: 2–6 Wochen ab Vertragsschluss, je nach Programm-Tiefe.

Geht es auch ohne eigene Entwicklung?

Ja. Das Partner-Portal deckt alle operativen Workflows ab – Aufträge anlegen, Status verfolgen, Befunde abrufen, Statistiken auswerten. Ideal für Programme, die kein eigenes Dev-Team binden wollen.

Labordiagnostik per API integrieren: REST, FHIR-Befund, LOINC und ein flexibler Workflow

Der API-Flow

Im Kern besteht die Integration aus vier Schritten:

1.  POST /v1/orders              → Auftrag anlegen (Panel, Empfänger, Branding-Profil)
2.  Aktivierung                  → Endnutzer aktiviert das Kit (Link/QR aus Ihrem System)
3.  Webhook: status_changed      → Push-Benachrichtigung bei jedem Statuswechsel
4.  GET /v1/orders/{id}/report   → Befund abrufen (JSON oder FHIR R4)

Auftrag anlegen

POST /v1/orders
Authorization: Bearer <token>
Content-Type: application/json

{
  "panel": "longevity-basic",
  "recipient": { ... },
  "branding_profile": "partner-xyz",
  "callback_url": "https://yourapp.example/webhook"
}

Response: Order-ID, geschätzte ETA bis Probeneingang.

Status verfolgen

Statusübergänge erfolgen typischerweise so: created → shipped → delivered → sample_received → analyzed → report_ready. Über Webhooks werden Sie über jeden Übergang in Echtzeit informiert – kein Polling.

Ergebnis abrufen

Sobald report_ready ausgelöst wurde, holen Sie den Befund:

GET /v1/orders/{id}/report?format=fhir

→ FHIR-R4-Bundle mit DiagnosticReport + Observations je Parameter. Alternativ format=json für ein vereinfachtes Probatix-internes Format.

Standardisierte Ergebnisdaten

Standardisierung ist hier der ganze Hebel. Wer in Health-Apps, Telemedizin- oder Versorgungsplattformen arbeitet, sollte beim Befund-Datenformat zwei Ebenen unterscheiden:

Struktur – wie die Felder eines Befunds organisiert sind.
Codierung – wie ein einzelner Parameter eindeutig benannt wird.

Probatix liefert beides nach internationalem Standard:

FHIR R4 ist das HL7-Format für klinische Daten. Ein Befund kommt als Bundle, in dem Sie strukturiert finden:

DiagnosticReport — der zusammenfassende Befund (Status, Auswertungsdatum, Schlussfolgerung).
Observation je Parameter — Wert, Einheit, Referenzbereich, LOINC-Code, Flags (high/low/critical).
Patient / Practitioner — referenzielle Metadaten.

LOINC-Codes identifizieren jeden Parameter eindeutig. Beispiel: „Glukose im Serum oder Plasma” bekommt den Code LOINC 2345-7 – weltweit. Egal welches System auf der Empfängerseite arbeitet: dieser Code wird verstanden. Das gilt für Cholesterin (2093-3), HbA1c (4548-4) und tausende weitere Parameter.

Vorteil für Sie: Wenn Sie Befunde an ein Drittsystem (Kasse, EHR, FHIR-Server) weitergeben, sparen Sie sich das Parameter-Mapping. Befund-Aufnahme funktioniert „aus der Box”. Das macht den Unterschied zwischen einem PDF, das jemand mappen muss, und einem Datenobjekt, das automatisch andocken kann.

Webhooks statt Polling

Statt regelmässig nach dem Status zu fragen, melden wir uns bei Ihnen – auf Ihrer Webhook-URL, mit signierter Nutzlast. Das spart Last und hält Ihre App in Echtzeit synchron. Hinweis: Die Webhook-Schnittstelle befindet sich aktuell im Beta-Release; Spezifikation, Signatur-Verfahren und Retry-Logik stellen wir Partnern im Beta-Programm direkt zur Verfügung. Polling über die REST-API ist parallel jederzeit möglich.

Flexibler Workflow

Die API ist nicht das einzige Integrationsmuster. Sie können kombinieren:

Reine API — Ihre App orchestriert den gesamten Flow.
Partner-Portal — operatives Tagesgeschäft im UI; API nur für Befunddaten.
Webshop-Einbindung — Kit-Bestellung über fertige Module in Ihrem Shop.

Auch die Aussteuerung des Befunds ist konfigurierbar:

Befund an Ihre App — Sie zeigen ihn in Ihrem UI.
Befund an den Endnutzer — über Probatix-Patientenportal (white-label).
Befund an Telemedizin/Vertragsarzt — direkte Übergabe an Praxissystem (vor allem für Modelle nach §116b/117).

Time-to-Result

Für die meisten Tests liegt das Ergebnis innerhalb von 48 Stunden nach Probeneingang im Labor vor. Was die Spanne beeinflusst:

Parameter-Spezifika (manche Methoden brauchen Inkubationszeiten).
Anzahl der Parameter (Panel-Grösse).
Labor-Routing (Auslastung der angebundenen Labore).

Status-Webhooks halten Sie über jeden Schritt auf dem Laufenden.

Integrationsaufwand

Realistisch:

Minimaler Use-Case (Auftrag anlegen + Status pollen + Befund-PDF abrufen): wenige Tage Entwicklungszeit.
Tiefe FHIR-Integration (Mapping in eigene FHIR-Server, Parameter-Logik im UI): 1–3 Wochen.
Volle Programm-Integration (UI, App-Flow, Befund-Aussteuerung, Reporting): 4–8 Wochen mit Test- und Compliance-Phase.

Wenn Sie kein Dev-Team haben: das Partner-Portal deckt alle Workflows ab — Sie können sofort starten und API-Anbindung später nachziehen.