Labore an covidoo anbinden

Um ein Labor für z.B. PCR-Tests an covidoo anzubinden, muss dieses mit der covidoo REST-API sprechen können.

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

Der Prozess für die Mitarbeiter ist bis zum Setzen des Status "Test durchgeführt" identisch zu den normalen Antigen-Tests.
Danach, je nach Tiefe der Integration und Anforderungen des Labors, können sich die Prozesse unterscheiden. Die Proben müssen für das Labor vorbereitet und verpackt werden und es muss ggf. ein OEGD-Formular ausgedruckt werden.

In diesem Beispiel gehen wir von einem PCR-Test aus, der an ein Labor gesendet wird - zur identifizierung der Probe dient eine ID, die covidoo generiert.
Das Labor holt sich die Test-Daten per automatisch per API aus covidoo und spielt anschließend das Ergebnis zu covidoo zurück.

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 erstellt eine 12-Stellige eindeutige ID bestehend aus Buchstaben und Zahlen - externe Id
5. Der Mitarbeiter klickt bis zum Status "Test durchgeführt"
6. Vorbereitung der Probe für das Labor
1. Der Mitarbeiter druckt die externe Id als Barcode auf einem Label aus und klebt dieses auf die Probe und/oder das Formular
2. Bei Bedarf wird am Kunde ein OEGD-Formular ausgedruckt
3. Individuell können auch andere Formulare vorbereitet werden, die mit den persönlichen Daten des Kunden vorausgfüllt sind
7. Erhält das Labor die Probe, wird zusammen mit der Probe die externe Id eingelesen
8. Das Labor holt sich dann per covidoo API mit Hilfe der externen Id die Daten des Kunden und die CWA-Einverständnisse (übermittlung ja/nein, personalisiert ja/nein)
9. Das Labor wertet die Probe aus
10. - - - ab hier optional, wenn das Labor die Ergebnisse direkt an den Kunden übermitteln will  - - -
11. Das Labor übermittelt das Ergebnis mit Hilfe der externen Id über die API an covidoo
12. 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 an ein Labor gesendet wird - zur Identifizierung der Probe dient eine Id, die das Labor als Barcode liefert.
Das Labor holt sich die Test-Daten über die API von covidoo und übermittelt das Ergebnis anschließend an covidoo.de

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. Der Mitarbeiter klickt bis zum Status "Test durchgeführt"
5. Vorbereitung der Probe für das Labor
1. Der Mitarbeiter scannt den Barcode vom Labor für diese Probe mit der covidoo App und speichert ihn so am Test
2. Bei Bedarf wird am Gast ein OEGD-Formular ausgedruckt
3. Individuell können auch andere Formulare vorbereitet werden, die mit den persönlichen Daten des Kunden vorausgfüllt sind
6. Erhält das Labor die Probe, wird zusammen mit der Probe die Interne Id (Laboreigene Id) eingelesen
7. Das Labor holt sich dann per covidoo API mit Hilfe der internen Id die Daten des Kunden und die CWA-Einverständnisse (übermittlung ja/nein, personalisiert ja/nein)
8. Das Labor wertet die Probe aus
9. - - - ab hier optional, wenn das Labor die Ergebnisse direkt an den Kunden übermitteln will  - - -
10. Das Labor übermittelt das Ergebnis mit Hilfe der internen Id über die API an covidoo
11. 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 an ein Labor gesendet wird - zur Identifizierung der Probe dient eine Id, die das Labor als Barcode liefert.
Das Labor holt sich die Daten der durchgeführten Tests schon nach der Probeentnahme und erstellt Laborjobs zu den Proben über die API.

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. Der Mitarbeiter klickt bis zum Status "Test durchgeführt"
5. Vorbereitung der Probe für das Labor
1. Der Mitarbeiter scannt den Barcode vom Labor für diese Probe mit der covidoo App und speichert ihn so am Test
2. Bei Bedarf wird am Gast ein OEGD-Formular ausgedruckt
3. Individuell können auch andere Formulare vorbereitet werden, die mit den persönlichen Daten des Kunden vorausgfüllt sind
6. Das Labor fragt regelmäßig über die covidoo-API ab, ob PCR-Tests durchgeführt wurden, holt sich die Daten zu dem Test und legt einen Labor-Job an
1. Internen Id (Barcode des Labors), Daten des Kunden, CWA-Einverständnisse (übermittlung ja/nein, personalisiert ja/nein), Kostenloser oder kostenpflichtiger PCR-Test
7. Das Labor wertet die Probe aus und verbindet das Ergebnis über den Barcode mit dem angelegten Labor-Job
8. - - - ab hier optional, wenn das Labor die Ergebnisse direkt an den Kunden übermitteln will  - - -
9. Das Labor übermittelt das Ergebnis mit Hilfe der internen Id über die API an covidoo
10. covidoo speichert das Ergebnis und sendet anschließend eine Mail an den Kunden (dieser Schritt ist analog zur manuellen Eingabe durch einen Mitarbeiter)

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"
}

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
  
  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.

API zum anlegen von Labor-Jobs

Der Test-Workflow (Antigen, Antikörper, PCR) wird über Tickets gesteuert, die der Kunde bei der Anmeldung auswählt. Diesen Tickets kann ein interner Code zugewiesen werden, über den man dann z.B. alle Tests mit dem Status "Test durchgeführt" suchen kann die das Ticket mit dem Code "PCR-FREE-dD34d3-DieW84Lf2194" gebucht wurden. So ist auch sichergestellt, dass das Labor nur an Daten kommt, die für es bestimmt sind.

Als Ergebnis bekommt man die benötigten Kundendaten für die passenden Tests und kann mit diesen einen Laborjob generieren.