Program dla poradni i gabinetów Medfile® udostępnia specjalistyczne usługi e-Zdrowia poprzez API dla podmiotów oraz firm posiadających własne oprogramowanie gabinetowe (lub inne aplikacje zdrowotne w których wybrane komponenty są pożądane) przy bardzo niskim nakładzie pracy i czasu podmiotom planującym wdrożenie usług wymaganych ustawowo.
Medfile udostępnia wirtualne środowisko. Integrator łączy się z usługą poprzez interfejs REST API. W większości wymiana danych, to proste dokumenty w formacie JSON. W przypadku Zdarzeń Medycznych oraz Repozytorium XDS.b można stosować dokumenty w formacie JSON lub dokumenty w natywnym formacie XML (HL7 FHIR oraz CDA). Podmiot przed otrzymaniem dostępu do API musi zdecydować jakie usługi zamierza utylizować oraz w jakim modelu rozliczeniowym. Do usług można łączyć się w zależności od modelu rozliczeniowego z dowolnego miejsca na świecie lub z wybranych adresów IP.
Integracja, jest bardzo intuicyjna, umożliwia prowadzenie własnej kartoteki w oparciu o dokumentację medyczną udostępnianą przez specjalistę. W jednym miejscu dostępne są wszystkie informacje nt. stanu zdrowia pacjenta – recepty, skierowania, zaświadczenia, przebyte choroby czy pobyty w szpitalu. Możliwość ustawienia przypomnień dotyczących pory brania leków (DML - Dziennik monitorowania leków) to dodatkowy atut programu Medfile.
Nie. Do integracji z usługami takimi jak e-Recepta czy e-Zwolnienie nie jest potrzebna subskrypcja w aplikacji Medfile EDM. Dane wykorzystywane w ramach integracji nie są w żaden sposób połączone z Medfile EDM.
Tak, udostępniamy środowisko testowe zaraz po podpisaniu umowy o poufności. Środowisko testowe do testów wymaga również kontaktu np. z P1 celem wygenerowania certyfikatów do środowiska integracyjnego (testowego). Otrzymają Państwo własne certyfikaty, dane podmiotu i/lub praktyki a nawet apteczne. W przypadku usługi eWUŚ dane testowe są publiczne, a w przypadku eZLA potrzebny jest również kontakt z ZUS celem wygenerowania testowych danych: https://bip.zus.pl/inne/wymagania-dla-oprogramowania-interfejsowego/aplikacje-gabinetowe-e-zwolnienia-
Proszę wysłać wiadomość na adres [email protected]. W tytule powinna znaleźć się informacja: "Wniosek: nadanie dostępu do środowiska testowego.". W treści wiadomości powinny znaleźć się: nazwa podmiotu, adres podmiotu, dane osób do kontaktu (adresy e-mail). Po zakończeniu procedury wnioskowej otrzymają Państwo dane dostępowe do środowiska testowego. W tym:
Dostęp do środowiska produkcyjnego udostępniamy po podpisaniu umowy o współpracy. Dodatkowo dostęp do środowiska produkcyjnego wymaga przesłania listy adresów IP, z których będą Państwo się łączyć do produkcyjnego API. Istnieje również możliwość podłączenia do naszego VPN.
Uwaga: udostępnianie kluczy produkcyjnych stronom trzecim jest niedozwolone, a ich zabezpieczenie należy do obowiązków integratora.
W przypadku usług wymagających loginu i hasła, certyfikatu lub klucza dostępowego przechowujemy dane w prywatnej relacyjnej bazie. Dane przechowywane są w postaci zaszyfrowanej. Dane w bazie są zapisane w postaci zaszyfrowanej indywidualnym dla danego podmiotu kluczem.
Repozytorium XDS.b które udostępniamy to zupełnie prywatny kontener który uruchamiamy na zlecenie klienta i utrzymujemy. Wszystkie pliki w kontenerze są szyfrowane i replikowane.
W trybie asynchronicznym przechowujemy odpowiedzi zaszyfrowane w bazie danych gdzie oczekują na odebranie ich przez Państwa oprogramowanie przez kilkanaście godzin.
Dodatkowo wszystkie odpowiedzi jakie otrzymujemy od dostawców usług takich jak ZUS czy CSIOZ są przetrzymywane w postaci zaszyfrowanych plików XML w indywidualnej dla danego podmiotu chmurze.
Tak, w odpowiedzi na poprawne wykonanie usług zwracamy naszą generyczna odpowiedź oraz dodatkowo sekcję zawierającą oryginalną odpowiedź od usługodawcy.
Zwracamy dokumenty XML oraz na życzenie klientów dołączamy podpisany dokument XML wysyłany jako żądanie do usługodawcy.
W przypadku e-recept do wystawienia poprawnego dokumentu wymagane jest użycie poprawnych kodów EAN i nazw produktów. Jako jedną z usług udostępniamy bazę leków opartą o publiczne zasoby z csioz, gov.pl oraz o pozycje dodane przez nasz zespół analityczny. Użycie naszej bazy leków nie jest obowiązkowe. Do wytworzenia recepty mogą Państwo użyć własnej bazy lub dowolnej innej komercyjnej bazy która jest zgodna z polskim prawem oraz kompatybilna z CSIOZ.
Interfejs REST API umożliwia integrację w dowolnym języku programowania i technologii. Zarówno aplikacje mobilne jak i desktopowe mogą korzystać z naszych usług zdalnie.
W ramach uproszczenia integracji udostępniamy podmiotom interaktywną dokumentację która umożliwia testowanie i konwertowanie gotowych modeli to dowolnego języka dzięki użyciu standardu Open API.
Odpowiedzialność za prezentację interfejsu użytkownikom zintegrowanej aplikacji jest podmiot integrujący się z Medfile. Istnieje możliwość zlecenia nam implementacji interfejsu w aplikacjach webowych lub doradztwa w tym zakresie.
Obowiązują limity określone w umowie. Są one uzależnione od wielu czynników ocenianych podczas estymacji kosztów. Zależą głównie od szacowanej ilości użytkowników, długości umowy, ilości usług łącznie wykorzystywanych oraz potencjalnych planach rozwoju produktów należących do podmiotów integrujących się z Medfile.
Zapraszamy do kontaktu. [email protected]
Nie, nie udostępniamy kodu źródłowego podmiotom zewnętrznym. Umożliwiamy jednak podpięcie pod API własnego kontenera na pliki i bazę w chmurze.
Udostępniamy dokumentację interaktywną do szybkiego przetestowania wybranych usług.
Dokumentacja Interaktywna Swagger Open API 3.0.0
Do testowania potrzebujemy:
Procedura testowania wygląda następująco:
Nie. Dane wykorzystywane w ramach integracji nie są w żaden sposób połączone z Medfile®.
e‑Recepty, e‑Zwolnienia, e-Skierowania, e‑WUŚ oraz baza leków.
Wysyłanie recept w prosty i czytelny sposób przez pliki JSON. W odpowiedzi zwracamy przetworzoną odpowiedz CSIOZ ale też XML czysty który otrzymujemy.
Do autoryzacji używamy JSON Web Tokens i firewall. Do wymiany danych format JSON.
Uruchamiany zostaje prywatny kontener w chmurze do przechowywania certyfikatów ZUS oraz RPWDL (tls, wss). Usługi wymagające loginu i hasła przechowywane są w relacyjnej bazie.
Tak. Dane w bazie są zapisane w postaci zaszyfrowanej indywidualnym kluczem.
Tak, po wystawieniu konkretnego dokumentu API pozwala pobierać w dowolnym momencie XML bezpośrednio z CSIOZ.
Nie.Umożliwiamy podpięcie pod API własnego kontenera na pliki i bazę w chmurze.
Interfejs REST API umożliwia integrację w dowolnym języku programowania i technologii. Zarówno aplikacje mobilne jak i desktopowe mogą korzystać z usług zdalnie.
Nie ma limitów. Każdy użytkownik może wystawiać dokumenty bez limitu.
mowa może zostać zawarta na okres roku bądź czas nieokreślony.
Tak. Do integracji z medconnet (haloDoctor) udostępnione odrębne API, które obejmuje czat, wideo i audio.
Prosimy o kontakt pod adresem [email protected]. Oferujemy również odpłatne pakiety wsparcia zarówno w procesie integracji jak i utrzymania usługi po Państwa stronie.
Aktualna dokumentacja znajduje się na stronie: https://github.com/biostatteam/medfile-services-api-wiki