eLab posistemės integracijos dokumentacija - Local Development build (v0.3.13) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Dokumentų pasirašymo API

Yra 2 pasirašymo būdai: Registrų centro komponentu ir SPĮ IS priemonėmis. Daugiau informacijos apie dokumentų pasirašymą galima rasti ESPBI IS duomenų mainų ir integracijos projektavimo dokumentacija.docx, skyrius 2.6.23 Pasirašyti medicininį dokumentą.

Pasirašymas Registrų centro komponentu

Užklausos parametrai

Vienos kompozicijos pasirašymas

Užklausa

POST /fhir/Composition/{id}/$sign

Užklausos pavyzdžiai

Inicijuojamas vienos kompozicijos pasirašymas, kur paduodami compositionId (nurodomas URL kaip kompozijos resurso identifikatorius) ir callbackUrl (nurodomas užklausos kūne) parametrai.

pvz:

{
"resourceType": "Parameters",
"parameter": [
{
"name": "callbackUrl",
"valueString": "http://example.com"
}
]
}

Gaunamas atsakymas su šiomis reikšmėmis

• signingUrl - pasirašymo URL (čia atliksite pasirašymo veiksmus).
• transactionId - transakcijos id.

SVARBU! Gavus atsakymą būtina kreiptis į $confirm-sign

Pasirašymo patvirtinimo užklausa

Užklausa

POST /fhir/Composition/{id}/$confirm-sign

Užklausos pavyzdžiai

Po pasirašymo, būtina kreiptis į “$confirm-sign” kur id yra compositionId. Šis metodas išsaugo pasirašymo informaciją ELAB sistemoje ir gaunamas atsakymas su šiomis reikšmėmis:

• base64Content - Pasirašyto dokumento turinys
• status - pasirašymo baigties statusas
• fileName - pasirašyto dokumento PDF failo pavadinimas
• documentReference - Nuoroda į FHIR sistemoje sukurtą DocumentReference resursą, kuriame saugoma nuoroda į pasirašyto dokumento PDF failą

Kelių kompozicijų pasirašymas vienu metu

Užklausa

POST /fhir/Composition/$sign-multi

Užklausos pavyzdžiai

Inicijuojamas vienos arba daugiau kompozicijų pasirašymas, kur užklausos parametruose paduodami callbackUrl, ir kompozicijų identifikatoriai.

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "callbackUrl",
      "valueString": "http://example.com"
    },
    {
      "name": "compositionIds",
      "valueId": "c5562539-7e49-4a95-9129-847bdee9d060"
    },
    {
      "name": "compositionIds",
      "valueId": "69ca25a3-4f60-49ba-ac08-4d90e6aa5e93"
    }
  ]
}

Gaunamas atsakymas su šiomis reikšmėmis.

• signingUrl - pasirašymo komponento URL (čia atliksite pasirašymo veiksmus).
• transactionId - pasirašymo transakcijos id.

SVARBU! Gavus atsakymą būtina kreiptis į $confirm-multi-sign

Pasirašymo patvirtinimo užklausa

Užklausa

POST /fhir/Composition/$confirm-multi-sign

Užklausos pavyzdžiai

Po pasirašymo, būtina kreiptis į “$confirm-multi-sign”. Šis metodas išsaugo pasirašymo informaciją ELAB sistemoje.

Gaunamas atsakymas su šiomis reikšmėmis.

• base64Content - Pasirašyto dokumento turinys
• documents[] - Sąrašas dokumentų su parametrais:
  • compositionId
  • status
  • fileName
  • base64Content
• documentReferences[] - Sąrašas nuorodų į FHIR sistemoje sukurtus DocumentReference resursus, kuriuose saugomos nuorodos į pasirašytus PDF failus.

Pasirašymas SPĮ IS priemonėmis

Pasirašymui reikalingo dokumento turinio gavimas pagal kompozicijos identifikatorių

Užklausa

GET /fhir/DocumentReference/$get-pdf-document?compositionId={compositionId}

Atsakymo pavyzdžiai

Gaunamas Parameters resursas su dokumento turiniu.

Gaunamas atsakymas su šiomis reikšmėmis:

• documentReference - Nuoroda į DocumentReference resursą
• fileName - PDF failo pavadinimas
• data - Dokumento turinys užkoduotas Base64 formatu

Pavyzdys:

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "documentReference",
            "valueId": "DocumentReference/5e61540a-e664-494b-b94b-1b7769efdbb4/_history/1"
        },
        {
            "name": "fileName",
            "valueString": "e200-0b3c783e-1f04-496d-8cf1-57f15368d8bc.pdf"
        },
        {
            "name": "data",
            "valueString": "TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdC4gQ3VyYWJpdHVyIGVnZXQgYmxhbmRpdCBhbnRlLiBTZWQgYSBkaWFtIHZlbCBzZW0gZmFjaWxpc2lzIGltcGVyZGlldC4gTnVuYyBuZWMgdG9ydG9yIG5lYyBzYXBpZW4gYWxpcXVldCBncmF2aWRhIGV1IG5vbiB2ZWxpdC4gRHVpcyBmZXJtZW50dW0gc29kYWxlcyByaG9uY3VzLiBDcmFzIHZlbCBtZXR1cyBhbGlxdWFtLCBwdWx2aW5hciBvcmNpIHNhZ2l0dGlzLCBncmF2aWRhIG51bGxhLiBPcmNpIHZhcml1cyBuYXRvcXVlIHBlbmF0aWJ1cyBldCBtYWduaXMgZGlzIHBhcnR1cmllbnQgbW9udGVzLCBuYXNjZXR1ciByaWRpY3VsdXMgbXVzLg=="
        }
    ]
}

SPĮ pusėje pasirašyto dokumento įkėlimas:

Užklausa

POST /fhir/DocumentReference/$upload-pdf-document

Siunčiamas Parameters resursas su dokumento turiniu.

Užklausos pavyzdžiai

Užklausoje pateikiamos šios reikšmės:

• compositionId - Composition resurso id
• data - Dokumento turinys užkoduotas Base64 formatu

Pavyzdys:

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "compositionId",
            "valueId": "3b79ecf2-645a-4754-92cd-5cf1e220103e"
        },
        {
            "name": "data",
            "valueString": "TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdC4gQ3VyYWJpdHVyIGVnZXQgYmxhbmRpdCBhbnRlLiBTZWQgYSBkaWFtIHZlbCBzZW0gZmFjaWxpc2lzIGltcGVyZGlldC4gTnVuYyBuZWMgdG9ydG9yIG5lYyBzYXBpZW4gYWxpcXVldCBncmF2aWRhIGV1IG5vbiB2ZWxpdC4gRHVpcyBmZXJtZW50dW0gc29kYWxlcyByaG9uY3VzLiBDcmFzIHZlbCBtZXR1cyBhbGlxdWFtLCBwdWx2aW5hciBvcmNpIHNhZ2l0dGlzLCBncmF2aWRhIG51bGxhLiBPcmNpIHZhcml1cyBuYXRvcXVlIHBlbmF0aWJ1cyBldCBtYWduaXMgZGlzIHBhcnR1cmllbnQgbW9udGVzLCBuYXNjZXR1ciByaWRpY3VsdXMgbXVzLg=="
        }
    ]
}