Medfile API Index / Medfile Services API

Medfile Services API

Wersja API: 2.3.10

Kontakt: integracja@medfile.pl

Spis treści

1. Wprowadzenie do API
   • Jak uzyskać dostęp do API?
   • Najczęściej zadawane pytania
2. Usługi P1
   • e-Recepta
     • Dawkowanie sekwencyjne - Przykłady dawkowania dla recept 365
     • Recepta na Wyroby Medyczne
     • Recepta na import docelowy
   • e-Skierowanie
     • e-Skierowanie do uzdrowiska
   • e-Zgody
   • Zdarzenia Medyczne
   • Index EDM
   • Podpis XaDES
3. Usługi NFZ
   • eWUŚ
     • uwierzytelnianie wieloskładnikowe MFA
   • eZWM
4. Usługi ZUS
   • eZLA
5. Repozytorium XDS.b
6. Usługi dodatkowe
   • Baza leków
   • Słowniki dla eZWM
   • Słownik ICD 10
   • Słownik ICD 9
   • Snomed GPS (wkrótce)
7. Informacje dodatkowe
   • Interaktywna dokumentacja Swagger Open API 3.0.0
   • Dodatkowe słowniki
8. Asynchroniczna komunikacja

Changelog

Zmiany w 2.3.10 z dnia 01.12.2025

1. Na leku recepturowym wprowadzono obsługę przekroczenia dopuszczalnej dawki dobowej

Zmiany w 2.3.9 z dnia 17.11.2025

1. Wprowadzono obsługę recepty na recepturę opisową (niewymagający użycia składników)

Zmiany w 2.3.8 z dnia 15.10.2025

1. Wprowadzono zmiany w ramach obsługi MFA w usłudze eWUŚ

Zmiany w 2.3.7 z dnia 15.09.2025

1. Opracowano receptę na import docelowy, dodano nową sekcję: Recepta na import docelowy
2. Zaktualizowano skierowanie do uzdrowiska o nowe elementy wymagane przez e-zdrowie:
   • Tryb realizacji
   • Wskazanie Uzasadnienie skierowania
   • Wskazanie dla trybu ambulatoryjnego miejscowości oraz terminu
3. Rozszerzono obsługę recepty o receptę pielęgniarki/położnej wraz z typem "pro auctore" oraz "pro familiae"

Zmiany w 2.3.6 z dnia 20.01.2025

1. W ramach obsługi e-recepty dodano przekazywanie danych dodatkowych (receptaDaneDodatkoweMT):
   • dodano element attributes w JSON

Zmiany w 2.3.5 z dnia 06.09.2024

1. Rozszerzono szablony dawkowania (opis w sekcji Schematy dawkowania recept):
   • dodano obsługę przerw
   • dodano obsługę cykli
   • umożliwiono przekazanie "Informacji dla pacjenta"
   • rozszerzono obsługę "Kategorii dostępności leku"
2. Nowa sekcja: Recepta na Wyroby Medyczne

Zmiany w 2.3.4 z dnia 22.04.2024

1. Nowa sekcja: Dawkowanie sekwencyjne - Przykłady dawkowania dla recept 365

Zmiany w 2.3.3 z dnia 04.10.2022

1. Nowa sekcja: e-Zgody

Zmiany w 2.3.2 z dnia 20.09.2022

1. Repozytorium XDS.b ITI-43 - pobieranie dokumentów z innego repozytorium
2. Repozytorium XDS.b - pobieranie plików bezpośrednio z magazynu

Zmiany w 2.3.1 z dnia 05.09.2022

1. Nowa sekcja: Jak uzyskać dostęp do API?
2. Nowa sekcja: Najczęściej zadawane pytania
3. Nowa sekcja: Materiały dodatkowe: Narzędzie do testowania integracji (Swagger Open API 3.0.0)

Zmiany w 2.3.0 z dnia 28.08.2022

1. Reorganizacja dokumentacji oraz spis treści.
2. Poprawienie dokumentacji XDS.b

Zmiany w 2.2.0 z dnia 28.01.2022

1. Dokumentacja Zdarzeń Medycznych
2. Dokumentacja bazy leków
3. Wprowadzono trasę do tworzenia organizacji
4. Poprawiono przykład z wysyłaniem i weryfikacją erecepty ("erecepta": ...)

Zmiany w 2.0.3 z dnia 26.11.2020

1. Dla recept i skierowań dodano parametry pacjentów transgranicznych lub nieletnich bez numeru PESEL.
2. Dokumentacja eZLA została przebudowana i zawiera teraz przykładowe odpowiedzi.
3. W dokumentacji eZLA zmodyfikowano punkt 8.1. o instrukcje na temat uruchomienia środowiska testowego.

Zmiany w 2.0.2 z dnia 12.10.2020

1. W tokenie JWT wymagamy dodatkowego pola organization (uuid) aby obsłużyć np. anulowanie recept oraz pobieranie recept.
2. Nowy kod odpowiedzi: 406 gdy wynik operacji jest błędny np. nie uda się zweryfikować recepty.
3. Anulowanie pakietu recept
4. Drukowanie pakietu recept
5. Pobieranie pakietu recept
6. Określenie kodów odpowiedzi dla wysyłania i weryfikacji recept

Zmiany w 2.0.1 z dnia 05.10.2020

1. Numeracja sekcji w dokumentacji.
2. Poprawka w obiekcie telecom - wymagana składnia to

   [{"value":"+48600600600"}]

3. W obiektach practitioner oraz organization zmiana z liczby mnogiej na pojedynczą listy identifiers. Po zmianie składnia wygląda następująco:

   "identifier": [
      {
        "type": "rpwdl",
        "value": "000000792087"
      }
   ]