api.preskryptor.pl

1. Obszar Autoryzacji

        USERID=2
        USERPASSWD=YTRGHJKHGVFRTYUIKJHGFTYUIiuytgfhjkiuyhgtfgyuikjhy0987654567890
        

curl -s "https://api.preskryptor.pl/cmd" --data-urlencode 'cmd={"rev":"2.0","customCmd":{"getToken":'2'}}'

        {"token":{"token":{"id":27219,"token":"3946ec4424d7e5cd82267a9d62959a58","created":"2024-04-12 09:24:09.250281"}}}
        

        MD5 ( $token + '#hash#' + $USERPASSWD )
        

        MD5 ( '3946ec4424d7e5cd82267a9d62959a58#hash#YTRGHJKHGVFRTYUIKJHGFTYUIiuytgfhjkiuyhgtfgyuikjhy0987654567890' ) = 2961c9d416f0d10c561e504766eee242
        

        token#27219#2961c9d416f0d10c561e504766eee242
        

        "auth=token#27219#2961c9d416f0d10c561e504766eee242"
        

3. Obszar logowania zdarzeń.

Koncepcje wstępne.

1. id : int – identyfikator (numeryczny, długi int) wizyty – UWAGA → patrz opis zarządzania identyfikatorami poniżej.
2. date : string – data wizyty w formacie RRRR-MM-DD.
3. state : string – stan wizyty – pole do wykorzystania w zależności od funkcjonalności oprogramowania, system nie narzuca żadnej semantyki dla tego pola, semantyka do ustalenia, tu można wrzucić np. rozróżnienie „NFZ”, „prywatna” lub „zakończona”, „anulowana”, „nierozliczona”, lub jakąkolwiek inną semantykę wg ustaleń.
4. kind : string – pole jw. semantyka do ustalenia
5. doctor – powiązanie do lekarza realizującego wizytę
6. patient – powiązanie do pacjenta realizującego wizytę
7. icd10s – kolekcją kodów ICD10 w ramach wizyty
8. recipies – kolekcja recept przypisanych do wizyty

refId : int

LogDoctor = record {
  id : int – identyfikator (numeryczny, długi int) lekarza – to jest identyfikator z wnętrza systemu, to NIE jest i NIE MOŻE BYĆ PWZ lekarza
  facility – powiązanie do placówki
}

refId : int,

LogFacility = record {
  id : int, - identyfikator (numeryczny, długi int) placówki – to jest identyfikator z wnętrza systemu, to nie może być żaden numer referencyjny, rejestrowy, pozwalający jakkolwiek zidentyfikować placówkę
  zip : string, - pole kod pocztowy placówki → patrz komentarz poniżej.
  city : string – pole miasto placówki → patrz komentarz poniżej.
}

refId : int,

LogPatient = record {
  id : int, - identyfikator (numeryczny, długi int) placówki – to jest identyfikator z wnętrza systemu, to nie może być żaden numer referencyjny, PESEL, ani żaden inny numer pozwalające na identyfikację pacjenta
  monthOfBirth : string, - miesiąc urodzenia w formacie RRRR-MM – do szacunkowego wyliczania wieku, w celu prowadzenia analiz związanych z wiekiem pacjentów
  sex : LogSex = variant { male | female | other } - płeć pacjenta
}

LogVisitIcd10 = record {
  id : int, - identyfikator przypisany do rekordu w systemie źródłowym
  main : bool, - bool, czy rozpoznanie główne przy wizycie czy nie
  permenent : bool, - bool czy rozpoznanie przewlekłe, czy nie
  icd10 : string – kod ICD10 w formie tekstowej – generalnie kody ICD10 muszą być w jednym z następujących formatów – A, A00, A00.0 – walidacja przebiega następująco – system najpierw usuwa z teksu wszystkie znaki, które nie są A-Z, a-z, 0-9. (znak . też jest usuwany). Następnie napis jest zamieniany na wielkie litery. I teraz jest sprawdzany format, czyli A lub A00 lub A000. Jeśli napis nie spełnia założeń jest odrzucany (uwaga, odrzucenie kodu icd10 oznacza tylko odrzucenie przypisania kodu do wizyty – nie wpływa na import danych wizyty i innych danych powiązanych). Następnie następuje sprawdzenie czy kod ICD10 istnieje w bazie leków. Jeśli nie istnieje jest odrzucany.
}

LogVisitRecipe = record {
  id : int, - identyfikator przypisany do rekordu w systemie źródłowym, to jest identyfikator wewnętrzny i nie może to być żadna referencja do recepty o znaczeniu zewnętrznym, 
              w szczególności to nie może być numer recepty
  type : string, - pole tekstowe ogólnego przeznaczenia, bez nadanej semantyki, do wykorzystania w zależności od potrzeb i możliwości
  state : string, - pole tekstowe ogólnego przeznaczenia, bez nadanej semantyki, do wykorzystania w zależności od potrzeb i możliwości
  drugs – kolekcja danych leków przypisanych do danej recepty
}

LogVisitRecipeDrug = record {
  id : int,          – identyfikator przypisany do rekordu w systemie źródłowym, to jest identyfikator wewnętrzny i nie może to być żadna referencja do recepty 
                       lub e-recepty o znaczeniu zewnętrznym
  dosation : string, – pole testowe zawierające informację o tym co lekarz wpisać na recepcie – to jest pole, które standardowo powinno zawierać liczbę sztuk, 
                       które przypisał lekarz, ale formalnie nie ma żadnych wytycznych ograniczających lekarza w tym, co może tu wpisać, dlatego pole jest tekstowe. 
                       Strategia powinna być taka, że w tym polu umieszczamy to co wpisał lekarz „jak leci”, czyli np. „2 op.” albo „3 szt.” albo „10 amp.”. 
                       Jeśli system źródłowy posiada bardziej szczegółowe informacje na temat tego co lekarz wybrał, wpisał, to należy te informacje przekazać w polu dosation_number.
  dosation_number : LogDosationNumber = variant { – to pole powinno zawierać szczegółowe informacja na temat liczby leku przypisanej przez lekarza – o ile takie informacje są 
                                                    dostępne w systemie źródłowym
              piecies : int      – to jest wariant, który zawiera liczbę sztuk, opakowań, elementów, które przypisał lekarz.
            | other              – to jest wariant, który powinien być przekazany jeśli nie wiadomo jaką wartość wpisał lekarz
           }, - uwaga jest taka, że program źródłowy nie powinien próbować w magiczny sposób odgadywać, co lekarz miał na myśli – jeśli system źródłowy obiektywnie nie posiada informacji 
                ile sztuk przypisał lekarz, to nie powinien tej informacji umieszczać.
   source : string,  – to jest pole, które powinno zawierać informację, w jaki sposób dany lek trafił na receptę – zawartość tego pola zależy od specyfiki programu źródłowego
                       i powinno zostać ustalone w ramach integracji. Zawartość tego pola standardowo może zależeć od tego, jak działa program i w jaki sposób pozwala na utworzenie recepty. 
                       Chyba w każdym programie standardową opcją jest jakaś forma wyszukiwarki leków i tworzenie recepty przez lekarza poprzez wyszukiwanie leków za pomocą wyszukiwarki. 
                       Można jednak sobie wyobrazić inne możliwości jak np. kopiowanie poprzednich recept lub dodawanie leków na receptę z leków stałych pacjenta, leków poprzednich pacjenta. 
                       Można sobie też wyobrazić, że pacjenta zamawia recepty przez internet lub innym tego typu kanałem. Reasumując, semantyka pola powinna zostać ustalone w fazie integracji.
   searchPhase : string, - intencją tego pola jest przekazywanie informacji, jaka była fraza szukana przez lekarza w momencie jak wybrał dany lek na receptę. 
   drug – dane przypisanego leku
}

refId : int,

drug : LogDrug = record {
  id : int, - wewnętrzny identyfikator leku po stronie systemu źródłowego
  name : string, - nazwa leku – pełnotekstowo (np. Apap)
  kind : string, - postać leku, pełnotekstowo (np. tabl.)
  dose : string, - dawka leku, pełnotekstowo (np. 100 mg)
  box : string, - zawartość opakowania (np. 28 szt.)
  ean : string – EAN leku – to pole jest kluczowe i koniecznie powinno być wypełnione
}

Przykłady.

curl -s https://api.preskryptor.pl/cmd --cookie 'auth=token#27219#2961c9d416f0d10c561e504766eee242' --data-urlencode cmd={"rev":"2.0","customCmd":{
"log":{"visits":[ (...) ] }}}

{
  "visits": [
    {
      "id": 10000,
      "date": "2024-02-05",
      "state": "State",
      "kind": "Kind",
      "doctor": {
        "doctor": {
          "id": 2000,
          "facility": {
            "facility": {
              "id": 30000,
              "zip": "00-123",
              "city": "Warszawa"
            }
          }
        }
      },
      "patient": {
        "patient": {
          "id": 4000,
          "monthOfBirth": "1990-01",
          "sex": { "other": "" }
        }
      },
      "icd10s": [
        {
          "id": 1,
          "main": 0,
          "permenent": 0,
          "icd10": "A"
        },
        {
          "id": 2,
          "main": 0,
          "permenent": 1,
          "icd10": "A00"
        },
        {
          "id": 3,
          "main": 1,
          "permenent": 0,
          "icd10": "A00.0"
        },
        {
          "id": 4,
          "main": 1,
          "permenent": 1,
          "icd10": "Z"
        }
      ],
      "recipies": [
        {
          "id": 90000,
          "type": "Recepta",
          "state": "Gotowa",
          "drugs": [
            {
              "id": 88000,
              "dosation": "3 op",
              "dosation_number": { "piecies": 3 },
              "source": "P",
              "searchPhase": "",
              "drug": { "refId": 981937 }
            },
            {
              "id": 88001,
              "dosation": "1 op",
              "dosation_number": { "other": "" },
              "source": "R",
              "searchPhase": "",
              "drug": {
                "drug": {
                  "id": 99,
                  "name": "Apap",
                  "kind": "tabl.",
                  "dose": "100 mg",
                  "box": "28 szt",
                  "ean": "05909990296026"
                }
              }
            },
            {
              "id": 88002,
              "dosation": "2 op",
              "dosation_number": { "piecies": 2 },
              "source": "S",
              "searchPhase": "",
              "drug": { "refId": 1 }
            }
          ]
        },
        {
          "id": 90001,
          "type": "Recepta",
          "state": "Robocza",
          "drugs": [
            {
              "id": 88010,
              "dosation": "3 op",
              "dosation_number": { "piecies": 3 },
              "source": "P",
              "searchPhase": "",
              "drug": { "refId": 26039970 }
            },
            {
              "id": 88011,
              "dosation": "1 op",
              "dosation_number": { "other": "" },
              "source": "R",
              "searchPhase": "",
              "drug": {
                "drug": {
                  "id": 99,
                  "name": "Ibufen® Baby",
                  "kind": "czopki doodbytnicze",
                  "dose": "60 mg",
                  "box": "5 szt",
                  "ean": "5909990922550"
                }
              }
            }
          ]
        },
        {
          "id": 90002,
          "type": "Receptura",
          "state": "Robocza",
          "drugs": []
        }
      ]
    },{
      "id": 10001,
      "date": "2024-03-05",
      "state": "State",
      "kind": "Kind",
      "doctor": {
        "refId": 2000
      },
      "patient": {
        "refId": 4000
      },
      "icd10s": [
        {
          "id": 1,
          "main": 0,
          "permenent": 0,
          "icd10": "A"
        }
      ],
      "recipies": [
        {
          "id": 90010,
          "type": "Recepta",
          "state": "Gotowa",
          "drugs": []
        }
      ]
    }
  ]
}