Um Euer Testgerät in covidoo einbinden zu können, muss dieses mit der covidoo REST-API sprechen können oder Ihr Euch eine Excel-Tabelle liefern, die Ihr in covidoo importieren könnt.
Testgeräte in covidoo einbinden
So können PCR-Testgeräte oder Antikörper- ganz einfach selber in covidoo eingebunden werden
Für die Einbindung von externen Testgeräten (z.B. Antikörper oder PCR) stellt covidoo eine einfache API zur Verfügung.
![](https://www.guestoo.de/assets/media/doku/guestoo/Sonstiges/look-alt-vs-neu.jpg)
Hier siehst Du die Unterschiede, damit Du dich auch im "Modernen Design" zurecht findest: » guestoo Back-End-Design
Inhalte dieser Seite:
Voraussetzungen
Voraussetzungen für das anbinden eines Testgerätes
Ablauf für den Kunden
So ist der Ablauf für den Kunden
Der Kunde merkt keinen Unterschied. Buchung und Ergebnisübermittlung sind identisch.
Ablauf für Testzentren-Mitarbeiter
Das ändert sich für Deine Mitarbeiter
Auch für Deine Mitarbeiter ändert sich nicht viel. Nur folgendes:
- Er muss mit der Probe eine Nummer in das Testgerät übergeben werden, die dem Mitarbeiter in covidoo angezeigt wird. Dazu gibt es drei Möglichkeiten:
- Der Code wird manuell ins Testgerät übertragen
- Der Barcode, der im Testprozess in covidoo sichtbar ist, wird vom Testgerät gescannt
- Es wird ein Label mit Barcode erstellt, das vom Testgerät, ggf. zusammen mit der Probe, eingelesen wird
- Das Ergebnis muss nicht manuell erfasst werden, sondern wird vom Gerät automatisch über die API übermittelt und gespeichert oder der Mitarbeiter importiert die Exce-Tabelle mit den Ergebnissen.
Die Übermittlung über die API löst die E-Mail mit dem Testergebnis an den Kunden direkt aus, es ist kein manuelles Eingreifen erforderlich.
Ablauf mit API-Anbindung im Detail
In diesem Beispiel gehen wir von einem PCR-Test aus, der über eine mobile Testmaschine ausgewertet wird. Bei Antigen- oder Antikörper-Tests wäre es identisch, nur das andere Werte als Ergebnis übermittelt werden.
- Der Kunde bucht einen PCR-Test
- Er erscheint vor Ort mit seinem Ticket
- Das Ticket wird gescannt und covidoo erkennt durch das gebuchte Ticket, welchen Workflow es für diesen Kunden gibt (hier PCR)
- covidoo generiert eine externe ID (12-Stellige Buchstaben-Zahlen Kombination), die für diesen Test eindeutig ist
- Der Mitarbeiter klickt bis zum Status "Test durchgeführt"
- Eingabe der Probe in die Maschine (3 Optionen)
- Der Code wird manuell ins Testgerät übertragen
- Der Barcode, der im Testprozess in covidoo sichtbar ist, wird vom Testgerät gescannt
- Es wird ein Label mit Barcode erstellt, das vom Testgerät, ggf. zusammen mit der Probe, eingelesen wird
- Die Maschine wertet die Probe aus und übermittelt mit Hilfe der externen Id das Ergebnis über die REST-Api an covidoo
- Je nach Anforderung nur positiv, negativ, nicht auswertbar oder noch weitere Informationen wie z.B. den befundenden Arzt und den c/t-Wert
- covidoo speichert das Ergebnis und sendet anschließend eine Mail an den Kunden (dieser Schritt ist analog zur manuellen Eingabe durch einen Mitarbeiter)
Ablauf mit Excel-Import der Ergebnisse im Detail
In diesem Beispiel gehen wir von einem PCR-Test aus, der über eine mobile Testmaschine ausgewertet wird. Bei Antigen- oder Antikörper-Tests wäre es identisch, nur das andere Werte als Ergebnis übermittelt werden.
- Der Kunde bucht einen PCR-Test
- Er erscheint vor Ort mit seinem Ticket
- Das Ticket wird gescannt und covidoo erkennt durch das gebuchte Ticket, welchen Workflow es für diesen Kunden gibt (hier PCR)
- covidoo generiert eine externe ID (12-Stellige Buchstaben-Zahlen Kombination), die für diesen Test eindeutig ist
- Der Mitarbeiter klickt bis zum Status "Test durchgeführt"
- Eingabe der Probe in die Maschine (3 Optionen)
- Der Code wird manuell ins Testgerät übertragen
- Der Barcode, der im Testprozess in covidoo sichtbar ist, wird vom Testgerät gescannt
- Es wird ein Label mit Barcode erstellt, das vom Testgerät, ggf. zusammen mit der Probe, eingelesen wird
- Die Maschine wertet die Probe aus und stellt eine Excel-Tabelle (siehe unten) mit den Ergebnissen zur Verfügung
- covidoo speichert das Ergebnis und sendet anschließend eine Mail an den Kunden (dieser Schritt ist analog zur manuellen Eingabe durch einen Mitarbeiter)
Anforderungen an die Excel-Tabelle
Die Excel-Tabelle muss folgende Spalten beinhalten (exacte Benamung ist relevant)
- Sample
Ist die 12-Stellige Externe ID, die covidoo liefert - Result
Ist das Ergebnis. Die Spalte kann folgende Werte beinhalten:
POSITIVE // NEGATIVE // ? - CT
Der CT-Wert
So funktioniert der Import
- Importieren dürfen nur Event-/Gäste-Admins und Agenturmanager
- Gehe ins Dashboard > Widget "Events" > Button: "Testergebnis Import" klicken
- Import starten
Danach startet der Import. Fehlerhafte Zeilen werden im Anschluss in dem Fenster angezeigt.
Überprüfung der Daten
Überprüfung der Ergebnisse, bevor sie an die getestete Person gesendet werden
covidoo bietet Dir die Möglichkeit, dass Testergebnisse bevor sie an Testpersonene gesendet werden erst noh einmal überprüft werden. Du kannst auch einstellen, ob nur Tests mit einem bestimmten Ergebnissen (z.B. positiv und nicht auswertbar) überprüft werden sollen.
In dem Fall zeigt Dir covidoo im Test-Board alle Tests, die auf eine Freigabe warten.
Wenn Deine Maschine Fotos der Teststreifen macht, kannst Du diese ebenfalls an covidoo übermitteln und im Test-Board bei der Freigabe anzeigen.
covidoo API
Die genauen API-Details senden wir gerne per Anfrage. Hier sind die wichtigsten Infos um den Aufwand abschätzen zu können:
- REST-API
- Authentifizierung per OAUTH 2 (Client-ID + Secret) oder per Authentifizierungstoken
- Um das Ergebnis zu Speichern wird die externe- oder interne-Id und das Ergebnis + ggf. weitere Daten übermittelt
- Beispiel:
{
"externalTestCode": "T2H8RTWEWR2AW",
"testNumber": "C29A172654Z60546",
"testManager": "Max Mustermanager",
"testNote": "Notiz für Test-Prozess",
"testResultValue": 32.50,
"testState": "TEST_POSITIVE",
"testImage": "data:image/png;base64,iVBORw0KGgoAAA ..."}
externalTestCode: eindeutige externe Id
testNumber: eindeutige interne Id
testManager: Name des Managers oder auswertenden Arztes (falls benötigt)
testNote: Notiz zum Test, ist in covidoo im Testprozess sichtbar
testResultValue: CT-Wert, falls benötigt
testState: Testergebnis - mögliche Werte: TEST_NEGATIVE, TEST_POSITIVE, TEST_UNKNOWN
testImage: Base64-kodierte Image-URL
Es muss entweder externalTestCode oder testNumber angegeben werden.
Es muss ein Testergebnis über testState angegeben werden. - Für die Authentifizierung via Api-Token muss der Header CPApiToken verwendet werden.
- Für eine OAuth2-Authentifizierung muss zunächst ein OAuth2-Token abgerufen und als Authorization-Header mitgeschickt werden. Informationen zum Token-Abruf sind unter Agentur > API > API-Benutzer zu finden.