Funktionsweise API-Endpunkt Struktur der Anfrage Beispielanforderung Reaktionsformat Fehlermeldungen Regeln für die Validierung Leistungsspezifikationen Erforderliche Berechtigungen Wichtige Hinweise zur Implementierung Beispiel für einen Arbeitsablauf Zugehörige -Vorgänge

`$inquire`FHIR-Operation für HealthLake

Mit $inquire diesem Vorgang können Sie den Status einer zuvor eingereichten vorherigen Autorisierungsanfrage überprüfen. Dieser Vorgang implementiert den Da Vinci Prior Authorization Support (PAS) Implementation Guide, der einen standardisierten FHIR-basierten Workflow zum Abrufen der aktuellen Autorisierungsentscheidung bietet.

Funktionsweise

Anfrage einreichen: Sie senden ein FHIR-Paket, das den Antrag, den Sie überprüfen möchten, und unterstützende Informationen enthält
Suchen: HealthLake sucht ClaimResponse in Ihrem Datenspeicher nach dem entsprechenden
Abrufen: Der neueste Autorisierungsstatus wird abgerufen
Antworten: Sie erhalten sofort eine Antwort mit dem aktuellen Autorisierungsstatus (in der Warteschlange, genehmigt, verweigert usw.)

Anmerkung

$inquireist ein schreibgeschützter Vorgang, der den vorhandenen Autorisierungsstatus abruft. Es werden keine Ressourcen in Ihrem Datenspeicher geändert oder aktualisiert.

API-Endpunkt


POST /datastore/{datastoreId}/r4/Claim/$inquire  
Content-Type: application/fhir+json

Struktur der Anfrage

Anforderungen an das Paket

Bei Ihrer Anfrage muss es sich um eine FHIR-Bundle-Ressource handeln mit:

Bundle.type: Muss sein "collection"
bundle.entry: Muss genau eine Claim-Ressource enthalten mit:
- use = "preauthorization"
- status = "active"
Referenzierte Ressourcen: Alle Ressourcen, auf die im Antrag verwiesen wird, müssen im Paket enthalten sein

Beispielweise abfragen

Die Ressourcen in Ihrem Eingabepaket dienen als Suchvorlage. HealthLake verwendet die bereitgestellten Informationen, um das entsprechende zu finden ClaimResponse.

Erforderliche -Ressourcen

Ressource	Kardinalität	Profil	Description
Anspruch erheben	1	Anfrage zum PAS-Anspruch	Die vorherige Genehmigung, nach der Sie sich erkundigen
Patient	1	PAS-Begünstigter Patient	Demografische Informationen zum Patienten
Organisation (Versicherer)	1	PAS-Versichererorganisation	Versicherungsgesellschaft
Organisation (Anbieter)	1	PAS anfordernde Organisation	Gesundheitsdienstleister, der die Anfrage eingereicht hat

Wichtige Suchkriterien

HealthLake sucht nach der ClaimResponse Verwendung von:

Referenz des Patienten aus dem Antrag
Referenz des Versicherers aus dem Antrag
Referenz des Anbieters aus dem Antrag
Erstellungsdatum des Antrags (als Zeitfilter)

Nur patientenspezifische Anfragen

Alle Anfragen müssen sich auf einen bestimmten Patienten beziehen. Systemweite Abfragen ohne Patientenidentifikation sind nicht zulässig.

Beispielanforderung


POST /datastore/example-datastore/r4/Claim/$inquire  
Content-Type: application/fhir+json  
Authorization: Bearer <your-token>  
  
{  
  "resourceType": "Bundle",  
  "id": "PASClaimInquiryBundleExample",  
  "meta": {  
    "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-pas-inquiry-request-bundle"]  
  },  
  "identifier": {  
    "system": "http://example.org/SUBMITTER_TRANSACTION_IDENTIFIER",  
    "value": "5269368"  
  },  
  "type": "collection",  
  "timestamp": "2005-05-02T14:30:00+05:00",  
  "entry": [  
    {  
      "fullUrl": "http://example.org/fhir/Claim/MedicalServicesAuthorizationExample",  
      "resource": {  
        "resourceType": "Claim",  
        "id": "MedicalServicesAuthorizationExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-claim-inquiry"]  
        },  
        "status": "active",  
        "type": {  
          "coding": [{  
            "system": "http://terminology.hl7.org/CodeSystem/claim-type",  
            "code": "professional"  
          }]  
        },  
        "use": "preauthorization",  
        "patient": {  
          "reference": "Patient/SubscriberExample"  
        },  
        "created": "2005-05-02T11:01:00+05:00",  
        "insurer": {  
          "reference": "Organization/InsurerExample"  
        },  
        "provider": {  
          "reference": "Organization/UMOExample"  
        }  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Patient/SubscriberExample",  
      "resource": {  
        "resourceType": "Patient",  
        "id": "SubscriberExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-beneficiary"]  
        },  
        "name": [{  
          "family": "SMITH",  
          "given": ["JOE"]  
        }],  
        "gender": "male"  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Organization/UMOExample",  
      "resource": {  
        "resourceType": "Organization",  
        "id": "UMOExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-requestor"]  
        },  
        "name": "Provider Organization"  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Organization/InsurerExample",  
      "resource": {  
        "resourceType": "Organization",  
        "id": "InsurerExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-insurer"]  
        },  
        "name": "Insurance Company"  
      }  
    }  
  ]  
}

Reaktionsformat

Erfolgreiche Antwort (200 OK)

Sie erhalten ein Paket mit Antworten auf Anfragen von PAS, das Folgendes enthält:

ClaimResponsemit dem aktuellen Autorisierungsstatus; mehrere ClaimResponse, wenn er den Suchkriterien entspricht
Alle Originalressourcen aus Ihrer Anfrage (zurückgesendet)
Zeitstempel, zu dem die Antwort zusammengestellt wurde

Mögliche Ergebnisse ClaimResponse

Ergebnis	Description
`queued`	Die Prüfung der Autorisierungsanfrage steht noch aus
`complete`	Die Autorisierungsentscheidung wurde getroffen (auf `disposition` Genehmigt/Abgelehnt prüfen)
`error`	Bei der Verarbeitung ist ein Fehler aufgetreten
`partial`	Teilweise Autorisierung erteilt


{  
  "resourceType": "Bundle",  
  "identifier": {  
        "system": "http://example.org/SUBMITTER_TRANSACTION_IDENTIFIER",  
        "value": "5269367"  
  },  
  "type": "collection",  
  "timestamp": "2005-05-02T14:30:15+05:00",  
  "entry": [  
    {  
      "fullUrl": "http://example.org/fhir/ClaimResponse/InquiryResponseExample",  
      "resource": {  
        "resourceType": "ClaimResponse",  
        "id": "InquiryResponseExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-claimresponse-inquiry"]  
        },  
        "status": "active",  
        "type": {  
          "coding": [{  
            "system": "http://terminology.hl7.org/CodeSystem/claim-type",  
            "code": "professional"  
          }]  
        },  
        "use": "preauthorization",  
        "patient": {  
          "reference": "Patient/SubscriberExample"  
        },  
        "created": "2005-05-02T11:05:00+05:00",  
        "insurer": {  
          "reference": "Organization/InsurerExample"  
        },  
        "request": {  
          "reference": "Claim/MedicalServicesAuthorizationExample"  
        },  
        "outcome": "complete",  
        "disposition": "Approved",  
        "preAuthRef": "AUTH12345"  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Claim/MedicalServicesAuthorizationExample",  
      "resource": {  
        "resourceType": "Claim",  
        "id": "MedicalServicesAuthorizationExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-claim-inquiry"]  
        },  
        "status": "active",  
        "type": {  
          "coding": [{  
            "system": "http://terminology.hl7.org/CodeSystem/claim-type",  
            "code": "professional"  
          }]  
        },  
        "use": "preauthorization",  
        "patient": {  
          "reference": "Patient/SubscriberExample"  
        },  
        "created": "2005-05-02T11:01:00+05:00",  
        "insurer": {  
          "reference": "Organization/InsurerExample"  
        },  
        "provider": {  
          "reference": "Organization/UMOExample"  
        }  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Patient/SubscriberExample",  
      "resource": {  
        "resourceType": "Patient",  
        "id": "SubscriberExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-beneficiary"]  
        },  
        "name": [{  
          "family": "SMITH",  
          "given": ["JOE"]  
        }],  
        "gender": "male"  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Organization/UMOExample",  
      "resource": {  
        "resourceType": "Organization",  
        "id": "UMOExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-requestor"]  
        },  
        "name": "Provider Organization"  
      }  
    },  
    {  
      "fullUrl": "http://example.org/fhir/Organization/InsurerExample",  
      "resource": {  
        "resourceType": "Organization",  
        "id": "InsurerExample",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-insurer"]  
        },  
        "name": "Insurance Company"  
      }  
    }  
  ]  
}

Fehlermeldungen

400 Bad Request (400 Ungültige Anfrage)

Wird zurückgegeben, wenn das Anforderungsformat ungültig ist oder die Überprüfung fehlschlägt.


{  
    "resourceType": "OperationOutcome",  
    "issue": [  
        {  
            "severity": "error",  
            "code": "required",  
            "diagnostics": "Reference 'Patient/SubscriberExample' at path 'patient' for 'CLAIM' resource not found(at Bundle.entry[0].resource)"  
        }  
    ]  
}

401 Nicht autorisiert

Wird zurückgegeben, wenn Anmeldeinformationen fehlen oder ungültig sind.


{  
    "resourceType": "OperationOutcome",  
    "issue": [  
        {  
            "severity": "error",  
            "code": "forbidden",  
            "diagnostics": "Invalid authorization header"  
        }  
    ]  
}

403 Forbidden

Wird zurückgegeben, wenn der authentifizierte Benutzer nicht berechtigt ist, auf die angeforderte Ressource zuzugreifen.


{  
    "resourceType": "OperationOutcome",  
    "issue": [  
        {  
            "severity": "error",  
            "code": "exception",  
            "diagnostics": "Insufficient SMART scope permissions."  
        }  
    ]  
}

400 Wenn keine gefunden wurde

Wird zurückgegeben, wenn keine Übereinstimmung ClaimResponse für die Anfrage gefunden wurde.


{  
  "resourceType": "OperationOutcome",
  "issue": [{
    "severity": "error",
    "code": "not-found",
    "diagnostics": "Resource not found. No ClaimResponse found from the input Claim that matches the specified Claim properties patient, insurer, provider, and created(at Bundle.entry[0].resource)"
  }]
}

415 Medientyp wird nicht unterstützt

Wird zurückgegeben, wenn der Content-Type-Header nicht application/fhir+json lautet.


{  
  "resourceType": "OperationOutcome",  
  "issue": [{  
    "severity": "error",  
    "code": "value",  
    "diagnostics": "Incorrect MIME-type. Update request Content-Type header."  
  }]  
}

429 Zu viele Anfragen

Wird zurückgegeben, wenn die Ratenlimits überschritten werden.


{  
  "resourceType": "OperationOutcome",  
  "issue": [{  
    "severity": "error",  
    "code": "throttled",  
    "diagnostics": "Rate limit exceeded. Please retry after some time."  
  }]  
}

Regeln für die Validierung

HealthLake führt eine umfassende Validierung Ihrer Anfrage durch:

Validierung des Pakets

Muss dem Profil des PAS Inquiry Request Bundle entsprechen
Bundle.typemuss sein "collection"
Muss genau eine Claim-Ressource enthalten
Alle Ressourcen, auf die verwiesen wird, müssen im Paket enthalten sein

Validierung des Antrags

Muss dem PAS-Anforderungsprofil entsprechen
Claim.usemuss sein "preauthorization"
Claim.statusmuss sein "active"
Erforderliche Felder:patient,insurer,provider, created

Validierung der Ressourcen

Alle Ressourcen müssen ihren jeweiligen PAS-Anfrageprofilen entsprechen
Erforderliche unterstützende Ressourcen müssen vorhanden sein (Patient, Versichererorganisation, Anbieterorganisation)
Querverweise müssen gültig und innerhalb des Pakets lösbar sein

Leistungsspezifikationen

Metrik	Spezifikation
Limit für die Anzahl der Ressourcen	500 Ressourcen pro Paket
Größenbeschränkung für Pakete	Maximal 5 MB

Erforderliche Berechtigungen

Um den $inquire Vorgang verwenden zu können, stellen Sie sicher, dass Ihre IAM-Rolle über Folgendes verfügt:

healthlake:InquirePreAuthClaim- Um den Vorgang aufzurufen

SMART auf FHIR-Zielfernrohren

Erforderliche Mindestbereiche:

SMART Version 1: user/ClaimResponse.read
SMART v2: user/ClaimResponse.s

Wichtige Hinweise zur Implementierung

Suchverhalten

Wenn Sie eine Anfrage einreichen, HealthLake sucht nach der ClaimResponse Verwendung von:

Patientenreferenz aus dem eingegebenen Antrag
Referenz des Versicherers aus dem eingegebenen Anspruch
Anbieterreferenz aus dem Eingabeanspruch
Erstellungsdatum aus dem eingegebenen Claim (als Zeitfilter)

Mehrere Treffer: Wenn mehrere ClaimResponses Treffer Ihren Suchkriterien entsprechen, werden alle passenden Ergebnisse HealthLake zurückgegeben. Sie sollten den neuesten ClaimResponse.created Zeitstempel verwenden, um den neuesten Status zu ermitteln.

Aktualisierte Ansprüche

Wenn Sie mehrere Aktualisierungen für dieselbe vorherige Autorisierung eingereicht haben (z. B. Claim v1.1, v1.2, v1.3), ruft der $inquire Vorgang anhand der angegebenen Suchkriterien die der neuesten Version ClaimResponse zugeordnete Version ab.

Schreibgeschützter Vorgang

Die $inquire Operation:

Ruft den vorhandenen Autorisierungsstatus ab
Gibt den neuesten zurück ClaimResponse
Ändert oder aktualisiert keine Ressourcen
Erstellt keine neuen Ressourcen
Löst keine neue Autorisierungsverarbeitung aus

Beispiel für einen Arbeitsablauf

Typischer Arbeitsablauf für Anfragen zur vorherigen Autorisierung


1. Provider submits PA request  
   POST /Claim/$submit  
   → Returns ClaimResponse with outcome="queued"  
  
2. Payer reviews request (asynchronous)  
   → Updates ClaimResponse status internally  
  
3. Provider checks status  
   POST /Claim/$inquire  
   → Returns ClaimResponse with outcome="queued" (still pending)  
  
4. Provider checks status again later  
   POST /Claim/$inquire  
   → Returns ClaimResponse with outcome="complete", disposition="Approved"

Claim/$submit- Reichen Sie eine neue vorherige Autorisierungsanfrage ein oder aktualisieren Sie eine bestehende
Patient/$everything- Rufen Sie umfassende Patientendaten für den Kontext einer vorherigen Autorisierung ab

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

$export

$lookup

$inquireFHIR-Operation für HealthLake