מדריך למטמיע - טופס 17
1.0.0 - ci-build
This page is part of the T17 IG (v1.0.0: draft-1 Draft) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions
ישנן שלוש אינטראקציות שה- server (הקופה) מחוייב לתמוך בהן, בכדי לקיים את התהליך ואינטראקציה נוספת מומלצת (GET Patient).
POST [server]/CoverageEligibilityRequest/$submit
הפנייה מה- Client ל- Server נעשית באמצעות POST ל- Operation מסוג CoverageEligibilityRequest/$submit הפנייה הזו מאפשרת מספר פעולות בו זמנית:
• הזנקת פעולת עיבוד על ידי ה- Client וקבלת מענה מיידי מה- Server.
• תוכן הפנייה הינו Bundle, על פי פרופיל: t17-bundle-req
פעולת GET ל- CoverageEligibilityResponse על בסיס ה- id שלו, כפי שהתקבל במענה* הראשוני שהוחזר לביה"ח.
GET [server]/CoverageEligibilityResponse/id
* המענה הראשוני התקבל כ- Bundle, לכן יש לשלוף מתוך ה- Bundle את ה- id של entry שסוג הריסורס שלו הינו - CoverageEligibilityResponse: Bundle.entry[resource.resourceType=CoverageEligibilityResponse[.resource.id יש לשים לב: ה- id הינו ייחודי רק ברמת ה- Server, על כן יש לשמור את ה- id ביחד עם כתובת שרת המקור שלו (קופה).
דוגמה לקריאה: GET http://hapi-fhir.outburn.co.il/fhir/CoverageEligibilityResponse/4640
במידה והתקבל ב- response קישור להתחייבות (reference ל- Coverage), ניתן לבצע שליפה של ההתחייבות והמסמך שלה, כפי שמתואר בסעיף הבא.
פעולת GET ל- Coverage לקבלת פרטי ההתחייבות, על בסיס ה- id של ה- Coverage כפי שהתקבל בסעיף הקודם*:
GET [server]/Coverage?_id=[resource_id]&_revinclude=DocumentReference:related
* ה- Coverage.id מתקבל באלמנט: CoverageEligibilityResponse.insurance.coverage.reference
שהמבנה שלו הוא: Coverage/
דוגמה לקריאה: GET http://hapi-fhir.outburn.co.il/fhir/Coverage?_id=4639&_revinclude=DocumentReference:related
הסעיף רלוונטי רק במקרה שה-Client שולף מראש את ה- Patient באמצעות GET Patient. מבנה השאילתה:
GET [BaseURL]/Patient?identifier=http://fhir.health.gov.il/identifier/il-national-id
בתגובה יתקבל Bundle מסוג searchset על פי פרופיל: t17-bundle-search-pat, אשר יכיל את המטופל המבוקש. השליפה נעשית באמצעות GET למטופל, על פי מספר תעודת זהות. יש להשתמש בפרמטר החיפוש identifier, ובו לציין את מערכת הזיהוי ואחריה הסימן | אשר מפריד בינה לבין תעודת הזהות. שימו לב, תעודת זהות חייבת להכיל 9 ספרות בדיוק, ועל ה- Client להשלים אפסים מובילים במידת הצורך. לדוגמה:
GET http://hapi-fhir.outburn.co.il/fhir/Patient?identifier=http://fhir.health.gov.il/identifier/il-national-id|000000026
* ניתן להפעיל את הפניה הנ"ל בכדי לצפות במבנה ה- Bundle שחוזר.
בכדי לחלץ את ה- logical_id יש לשלוף את הערך שבנתיב הבא: entry.resource.id עבור כל תוצאה, כלומר שליפה על פי כמות האיברים המוחזרים ב- Bundle.
להלן ריכוז המתודות, בהתייחס לשלבי התהליך ולפרופיל הרלוונטי.
| שלב בתהליך | מתודה | פרופיל |
|---|---|---|
| שאילתת מטופלים | …<GET Patient?<params | SERVER ILCore Patient Profile t17-bundle-search-pat |
| שליחת בקשה להתחייבות | POST [server]/CoverageEligibilityRequest/$submit | CLIENT t17-request t17-requested-location t17-booked-appointment t17-visit-summary t17-response t17-bundle-req SERVER t17-response t17-obligation t17-obligation-doc |
| דגימת מענה לבקשה להתחייבות | <GET CoverageEligibilityResponse/ <id | SERVER t17-response |
| שליפת התחייבות מאושרת | …<GET Coverage?<params | SERVER t17-obligation t17-obligation-doc t17-bundle-search-obl |
* מבוצע באמצעות Conditional Update
להלן ריכוז SearchParameters, בהתייחס לשלב הרלוונטי בתהליך, לאיזה גורם מהווה Server באותו השלב והאם זה פרמטר שחובה לתמוך בו.
| Supports revinclude_ |
Supported Searches |
Supported Profiles |
Resource Type |
|---|---|---|---|
| - | identifier | ILCore Patient Profile |
Patient |
| Coverage:DocumentReference:related | id_ | t17-obligation | Coverage |