Information till direktöverföringsleverantörer

Punkt-till-punktintegrationer med REST eller SOAP

För punkt-till-punktintegrationer finns det ytterligare teknisk, detaljerad information om hur vi hanterar det i vår registerplattform Stratum, i Apiary-dokumentationen. För både REST och SOAP gäller att man behöver skicka med ett ContextID. Varje ContextID motsvarar en vårdenhet i verkligenheten.
Om ni planerar att skicka in data för flera vårdenheter är det ett krav från vår sida att ni testar integrationen i demo genom att skicka till båda testenheterna som finns tillgängliga för alla register.

Demo
Information om ContextID för aktuellt register, hittar du under fliken Om registret och på sidan Registerspecifik information till direktöverföringsleverantörer.

Testa att registrera manuellt och verifiera era inskickade registreringar i demomiljön.

Ni kommer åt demo-versionen av registret på adressen:
https://[registerförkortningen ska in här].demo.registercentrum.se, exempel LVR - https://lvr.demo.registercentrum.se
I demo hittar ni registrets formulär med dess data och dess eventuella relationer till varandra.

Klicka på ”Logga in” uppe till höger, välj ”Verktyg före registrerare”, välj ett av test-personnumren och gör en "Ny registrering". Vi rekommenderar att ni använder våra testpersonnummer som finns i demo under testfasen då kan ni verifiera den data som ni skickar in.
OBS! Demo-miljön töms på registreringar varje natt.

Endpoint för REST i demo
REST - http://demo.registercentrum.se/api/registrations

Endpoint för SOAP i demo och XML-schema
XML-schema hittar du här: http://stratum.registercentrum.se/schemas/[registerförkortningen ska in här]
Exempel XML-schema för LVR: http://stratum.registercentrum.se/schemas/lvr
Endpoint: http://demo.registercentrum.se/Soap/Services/DataDelivery.svc

Produktion
Aktuellt register tillhandahåller ContextID för produktionsmiljön för aktuell vårdenhet. I produktionsmiljön krävs också att man har ett SITHS-funktionscertifikat för att identifiera det system som ska föra över data.

Verifiering av en lyckad registrering

När en lyckad registrering genomförs kommer det att skickas ett EventID tillbaka. EventID kan användas för att identifiera en befintlig registrering och kan användas för framtida uppdateringar.

Uppdatera en befintlig registrering

Det finns två olika metoder för att uppdatera en befintling registrering.

EventID

För att uppdatera en befintlig registrering med EventID skickas enbart EventID tillsammans med de variabler som uppdateringen avser och inga andra variabler skickas in förutom ContextID, som måste skickas med för autentisering.

Identifierare

En annan metodik som kan användas för att uppdatera en befintlig registrering är att använda identifierare. Metoden använder formulärets identifierande variabler för att avgöra om det är en ny registrering eller en uppdatering. Flaggan ”Upsert” avgör då hur beteendet skall vara. Om upsert flaggan är satt till true kommer registreringen sparas som en uppdatering. Ifall flaggan utelämnas kommer ni få upp ett meddelande om att registreringen redan existerar och inte kan skapas igen. Här behöver man även skicka med de obligatoriska variablerna för formuläret tillsammans med ContextID som måste skickas med för autentisering.

OBS! skicka bara in data som faktiskt har uppdaterat sig och där med skiljer sig från förra tillfället då data skickades in till registret för aktuell patient och datum.
För varje registrering valideras/jämförs den data som skickas in med den data som redan finns för att kunna avgöra att den data som faktiskt skiljer sig och ska sparas ner i databasen, gör det.
På plattformen Stratum finns många register som direktöverför data.

Variabellista

På varje registerhemsida under fliken Om registret finns det information om registrets metadata, det vill säga vilka formulär, variabler och utfall registret består av. Verktyget variabellista innehåller information om allt som berör variablerna.
Här finns kolumnen "Inskickningsbar” som innehåller information om vilka variabler som är möjliga att skicka in. Här finns också kolumnerna ”Obligatorisk” och ”Identifierare” som innehåller information som är nödvändig för direktöverföring. Utan de obligatoriska variablerna kommer en registrering inte att kunna registreras. Kolumnen ”Identifierare” är användbar för de som kommer att använda identifierare för att uppdatera en befintlig registrering, om inte metodiken EventID kommer att användas.

Kontaktinformation

För mera detaljerad information om hur ni ska gå tillväga, kontakta respektive register.