Testgeräte in covidoo einbinden

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.

Der Kunde merkt keinen Unterschied. Buchung und Ergebnisübermittlung sind identisch.

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.

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.

1. Der Kunde bucht einen PCR-Test
2. Er erscheint vor Ort mit seinem Ticket
3. Das Ticket wird gescannt und covidoo erkennt durch das gebuchte Ticket, welchen Workflow es für diesen Kunden gibt (hier PCR)
4. covidoo generiert eine externe ID (12-Stellige Buchstaben-Zahlen Kombination), die für diesen Test eindeutig ist
5. Der Mitarbeiter klickt bis zum Status "Test durchgeführt"
6. Eingabe der Probe in die Maschine (3 Optionen)
1. Der Code wird manuell ins Testgerät übertragen
2. Der Barcode, der im Testprozess in covidoo sichtbar ist, wird vom Testgerät gescannt
3. Es wird ein Label mit Barcode erstellt, das vom Testgerät, ggf. zusammen mit der Probe, eingelesen wird
7. Die Maschine wertet die Probe aus und übermittelt mit Hilfe der externen Id das Ergebnis über die REST-Api an covidoo
1. Je nach Anforderung nur positiv, negativ, nicht auswertbar oder noch weitere Informationen wie z.B. den befundenden Arzt und den c/t-Wert
8. covidoo speichert das Ergebnis und sendet anschließend eine Mail an den Kunden (dieser Schritt ist analog zur manuellen Eingabe durch einen Mitarbeiter)

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.

1. Der Kunde bucht einen PCR-Test
2. Er erscheint vor Ort mit seinem Ticket
3. Das Ticket wird gescannt und covidoo erkennt durch das gebuchte Ticket, welchen Workflow es für diesen Kunden gibt (hier PCR)
4. covidoo generiert eine externe ID (12-Stellige Buchstaben-Zahlen Kombination), die für diesen Test eindeutig ist
5. Der Mitarbeiter klickt bis zum Status "Test durchgeführt"
6. Eingabe der Probe in die Maschine (3 Optionen)
1. Der Code wird manuell ins Testgerät übertragen
2. Der Barcode, der im Testprozess in covidoo sichtbar ist, wird vom Testgerät gescannt
3. Es wird ein Label mit Barcode erstellt, das vom Testgerät, ggf. zusammen mit der Probe, eingelesen wird
7. Die Maschine wertet die Probe aus und stellt eine Excel-Tabelle (siehe unten) mit den Ergebnissen zur Verfügung
8. 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.

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.

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.