Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# `$inquire`FHIR-Operation für HealthLake
<a name="reference-fhir-operations-inquire"></a>

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](https://hl7.org/fhir/us/davinci-pas/), der einen standardisierten FHIR-basierten Workflow zum Abrufen der aktuellen Autorisierungsentscheidung bietet.

## Funktionsweise
<a name="inquire-how-it-works"></a>
+ **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**  
`$inquire`ist ein **schreibgeschützter Vorgang, der den vorhandenen Autorisierungsstatus** abruft. Es werden keine Ressourcen in Ihrem Datenspeicher geändert oder aktualisiert.

## API-Endpunkt
<a name="inquire-api-endpoint"></a>

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

## Struktur der Anfrage
<a name="inquire-request-structure"></a>

### Anforderungen an das Paket
<a name="inquire-bundle-requirements"></a>

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
<a name="inquire-required-resources"></a>


| 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
<a name="inquire-search-criteria"></a>

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
<a name="inquire-example-request"></a>

```
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
<a name="inquire-response-format"></a>

### Erfolgreiche Antwort (200 OK)
<a name="inquire-success-response"></a>

Sie erhalten ein Paket mit Antworten auf Anfragen von PAS, das Folgendes enthält:
+ **ClaimResponse**mit 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
<a name="inquire-error-responses"></a>

### 400 Bad Request (400 Ungültige Anfrage)
<a name="inquire-400-error"></a>

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
<a name="inquire-401-error"></a>

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

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

### 403 Forbidden
<a name="inquire-403-error"></a>

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
<a name="inquire-400-none-found"></a>

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
<a name="inquire-415-error"></a>

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

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

### 429 Zu viele Anfragen
<a name="inquire-429-error"></a>

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
<a name="inquire-validation-rules"></a>

HealthLake führt eine umfassende Validierung Ihrer Anfrage durch:

### Validierung des Pakets
<a name="inquire-bundle-validation"></a>
+ Muss dem Profil des PAS Inquiry Request Bundle entsprechen
+ `Bundle.type`muss sein `"collection"`
+ Muss genau eine Claim-Ressource enthalten
+ Alle Ressourcen, auf die verwiesen wird, müssen im Paket enthalten sein

### Validierung des Antrags
<a name="inquire-claim-validation"></a>
+ Muss dem PAS-Anforderungsprofil entsprechen
+ `Claim.use`muss sein `"preauthorization"`
+ `Claim.status`muss sein `"active"`
+ Erforderliche Felder:`patient`,`insurer`,`provider`, `created`

### Validierung der Ressourcen
<a name="inquire-resource-validation"></a>
+ 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
<a name="inquire-performance-specs"></a>


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

## Erforderliche Berechtigungen
<a name="inquire-required-permissions"></a>

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
<a name="inquire-implementation-notes"></a>

### Suchverhalten
<a name="inquire-search-behavior"></a>

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
<a name="inquire-updated-claims"></a>

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
<a name="inquire-read-only"></a>

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
<a name="inquire-workflow-example"></a>

**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"
```

## Zugehörige -Vorgänge
<a name="inquire-related-operations"></a>
+ `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