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.
$submitFHIR-Operation für HealthLake
Dieser $submit Vorgang ermöglicht es Ihnen, vorherige Autorisierungsanträge elektronisch zur Genehmigung an die Zahler einzureichen. Dieser Vorgang implementiert den Da Vinci Prior Authorization Support (PAS) Implementation Guide
Funktionsweise
-
Einreichen: Sie senden ein FHIR-Paket, das Ihre vorherige Autorisierungsanfrage und unterstützende klinische Daten enthält
-
Bestätigen: HealthLake validiert die Einreichung anhand der PAS-Anforderungen
-
Fortbestehen: Alle Ressourcen werden in Ihrem HealthLake Datenspeicher gespeichert
-
Antworten: Sie erhalten sofort eine Antwort mit dem Status „In der Warteschlange“
-
Prozess: Die Autorisierungsentscheidung wird vom Zahler asynchron verarbeitet
API-Endpunkt
POST /datastore/{datastoreId}/r4/Claim/$submit 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" -
Referenzierte Ressourcen: Alle Ressourcen, auf die der Anspruch verweist, müssen im Paket enthalten sein
Erforderliche -Ressourcen
| Ressource | Kardinalität | Profil | Description |
|---|---|---|---|
| Anspruch erheben | 1 | PAS-Anspruch | Die vorherige Autorisierungsanfrage |
| Patientin | 1 | PAS-Patient | Demografische Informationen zum Patienten |
| Organisation (Versicherer) | 1 | PAS-Versicherer | Versicherungsgesellschaft |
| Organisation (Anbieter) | 1 | PAS-Anforderer | Gesundheitsdienstleister, der die Anfrage einreicht |
| Deckung | 1 oder mehr | PAS-Abdeckung | Einzelheiten zum Versicherungsschutz |
Optionale Ressourcen
| Ressource | Kardinalität | Profil | Description |
|---|---|---|---|
| Praktiker | 0 oder mehr | PAS-Praktiker | Praktiker im Gesundheitswesen |
| PractitionerRole | 0 oder mehr | PAS PractitionerRole | Rollen von Praktikern |
| ServiceRequest | 0 oder mehr | PAS ServiceRequest | Angeforderte medizinische Leistungen |
| DeviceRequest | 0 oder mehr | PAS DeviceRequest | Angeforderte medizinische Geräte |
| MedicationRequest | 0 oder mehr | PAS MedicationRequest | Angeforderte Medikamente |
| DocumentReference | 0 oder mehr | PAS DocumentReference | Unterstützung der klinischen Dokumentation |
Beispielanforderung
POST /datastore/example-datastore/r4/Claim/$submit Content-Type: application/fhir+json Authorization: Bearer <your-token> { "resourceType" : "Bundle", "id" : "MedicalServicesAuthorizationBundleExample", "meta" : { "profile" : ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-pas-request-bundle"] }, "identifier" : { "system" : "http://example.org/SUBMITTER_TRANSACTION_IDENTIFIER", "value" : "5269367" }, "type" : "collection", "timestamp" : "2005-05-02T11:01: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"] }, "identifier" : [{ "system" : "http://example.org/PATIENT_EVENT_TRACE_NUMBER", "value" : "111099" }], "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" }, "priority" : { "coding" : [{ "system" : "http://terminology.hl7.org/CodeSystem/processpriority", "code" : "normal" }] }, "insurance" : [{ "sequence" : 1, "focal" : true, "coverage" : { "reference" : "Coverage/InsuranceExample" } }], "item" : [{ "extension" : [{ "url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-serviceItemRequestType", "valueCodeableConcept" : { "coding" : [{ "system" : "https://codesystem.x12.org/005010/1525", "code" : "IN", "display" : "Initial Medical Services Reservation" }] } }, { "url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-certificationType", "valueCodeableConcept" : { "coding" : [{ "system" : "https://codesystem.x12.org/005010/1322", "code" : "I", "display" : "Initial" }] } }, { "url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-authorizationNumber", "valueString" : "1122344" }, { "url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-administrationReferenceNumber", "valueString" : "33441122" }], "sequence" : 1, "category" : { "coding" : [{ "system" : "https://codesystem.x12.org/005010/1365", "code" : "1", "display" : "Medical Care" }] }, "productOrService" : { "coding" : [{ "system" : "http://www.cms.gov/Medicare/Coding/HCPCSReleaseCodeSets", "code" : "99212", "display" : "Established Office Visit" }] }, "servicedDate" : "2005-05-10", "locationCodeableConcept" : { "coding" : [{ "system" : "https://www.cms.gov/Medicare/Coding/place-of-service-codes/Place_of_Service_Code_Set", "code" : "11" }] } }] } }, { "fullUrl" : "http://example.org/fhir/Organization/UMOExample", "resource" : { "resourceType" : "Organization", "id" : "UMOExample", "meta" : { "profile" : ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-requestor"] }, "identifier" : [{ "system" : "http://hl7.org/fhir/sid/us-npi", "value" : "8189991234" }], "active" : true, "type" : [{ "coding" : [{ "system" : "https://codesystem.x12.org/005010/98", "code" : "X3" }] }], "name" : "DR. JOE SMITH CORPORATION", "address" : [{ "line" : ["111 1ST STREET"], "city" : "SAN DIEGO", "state" : "CA", "postalCode" : "92101", "country" : "US" }] } }, { "fullUrl" : "http://example.org/fhir/Organization/InsurerExample", "resource" : { "resourceType" : "Organization", "id" : "InsurerExample", "meta" : { "profile" : ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-insurer"] }, "identifier" : [{ "system" : "http://hl7.org/fhir/sid/us-npi", "value" : "1234567893" }], "active" : true, "type" : [{ "coding" : [{ "system" : "https://codesystem.x12.org/005010/98", "code" : "PR" }] }], "name" : "MARYLAND CAPITAL INSURANCE COMPANY" } }, { "fullUrl" : "http://example.org/fhir/Coverage/InsuranceExample", "resource" : { "resourceType" : "Coverage", "id" : "InsuranceExample", "meta" : { "profile" : ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-coverage"] }, "status" : "active", "subscriberId" : "1122334455", "beneficiary" : { "reference" : "Patient/SubscriberExample" }, "relationship" : { "coding" : [{ "system" : "http://terminology.hl7.org/CodeSystem/subscriber-relationship", "code" : "self" }, { "system" : "https://codesystem.x12.org/005010/1069", "code" : "18" }] }, "payor" : [{ "reference" : "Organization/InsurerExample" }] } }, { "fullUrl" : "http://example.org/fhir/Patient/SubscriberExample", "resource" : { "resourceType" : "Patient", "id" : "SubscriberExample", "meta" : { "profile" : ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-subscriber"] }, "extension" : [{ "url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-militaryStatus", "valueCodeableConcept" : { "coding" : [{ "system" : "https://codesystem.x12.org/005010/584", "code" : "RU" }] } }], "identifier" : [{ "type" : { "coding" : [{ "system" : "http://terminology.hl7.org/CodeSystem/v2-0203", "code" : "MB" }] }, "system" : "http://example.org/MIN", "value" : "12345678901" }], "name" : [{ "family" : "SMITH", "given" : ["JOE"] }], "gender" : "male" } }] }
Reaktionsformat
Erfolgreiche Antwort (200 OK)
Sie erhalten ein PAS-Antwortpaket mit:
-
ClaimResponsemit
outcome: "queued"undstatus: "active" -
Alle Originalressourcen aus Ihrer Anfrage
-
Zeitstempel zur Bestätigung des Empfangs
{ "resourceType" : "Bundle", "identifier": { "system": "http://example.org/SUBMITTER_TRANSACTION_IDENTIFIER", "value": "5269367" }, "type" : "collection", "timestamp" : "2005-05-02T11:02:00+05:00", "entry" : [{ "fullUrl" : "http://example.org/fhir/ClaimResponse/PractitionerRequestorPendingResponseExample", "resource" : { "resourceType" : "ClaimResponse", "id" : "PractitionerRequestorPendingResponseExample", "meta" : { "profile" : ["http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-claimresponse"] }, "identifier" : [{ "system" : "http://example.org/PATIENT_EVENT_TRACE_NUMBER", "value" : "111099" }], "status" : "active", "type" : { "coding" : [{ "system" : "http://terminology.hl7.org/CodeSystem/claim-type", "code" : "professional" }] }, "use" : "preauthorization", "patient" : { "reference" : "Patient/SubscriberExample" }, "created" : "2005-05-02T11:02:00+05:00", "insurer" : { "reference" : "Organization/InsurerExample" }, "requestor" : { "reference" : "PractitionerRole/ReferralPractitionerRoleExample" }, "request" : { "reference" : "Claim/MedicalServicesAuthorizationExample" }, "outcome" : "queued" } }, { "fullUrl" : "http://example.org/fhir/Claim/MedicalServicesAuthorizationExample", "resource" : { "resourceType" : "Claim", "id" : "MedicalServicesAuthorizationExample", "meta" : { "profile": [ "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-claim", "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-claim|2.1.0" ] }, "identifier" : [{ "system" : "http://example.org/PATIENT_EVENT_TRACE_NUMBER", "value" : "111099" } }], "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" }, "priority" : { "coding" : [{ "system" : "http://terminology.hl7.org/CodeSystem/processpriority", "code" : "normal" }] }, "insurance" : [{ "sequence" : 1, "focal" : true, "coverage" : { "reference" : "Coverage/InsuranceExample" } }], "item" : [{ "extension" : [{ "url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-serviceItemRequestType", "valueCodeableConcept" : { "coding" : [{ "system" : "https://codesystem.x12.org/005010/1525", "code" : "IN", "display" : "Initial Medical Services Reservation" }] } }, { "url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-certificationType", "valueCodeableConcept" : { "coding" : [{ "system" : "https://codesystem.x12.org/005010/1322", "code" : "I", "display" : "Initial" }] } }, { "url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-authorizationNumber", "valueString" : "1122344" }, { "url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-administrationReferenceNumber", "valueString" : "33441122" }], "sequence" : 1, "category" : { "coding" : [{ "system" : "https://codesystem.x12.org/005010/1365", "code" : "1", "display" : "Medical Care" }] }, "productOrService" : { "coding" : [{ "system" : "http://www.cms.gov/Medicare/Coding/HCPCSReleaseCodeSets", "code" : "99212", "display" : "Established Office Visit" }] }, "servicedDate" : "2005-05-10", "locationCodeableConcept" : { "coding" : [{ "system" : "https://www.cms.gov/Medicare/Coding/place-of-service-codes/Place_of_Service_Code_Set", "code" : "11" }] } }] } }, { "fullUrl" : "http://example.org/fhir/Organization/UMOExample", "resource" : { "resourceType" : "Organization", "id" : "UMOExample", "meta" : { "profile": [ "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-requestor", "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-requestor|2.1.0" ] }, "identifier" : [{ "system" : "http://hl7.org/fhir/sid/us-npi", "value" : "8189991234" }], "active" : true, "type" : [{ "coding" : [{ "system" : "https://codesystem.x12.org/005010/98", "code" : "X3" }] }], "name" : "DR. JOE SMITH CORPORATION", "address" : [{ "line" : ["111 1ST STREET"], "city" : "SAN DIEGO", "state" : "CA", "postalCode" : "92101", "country" : "US" }] } }, { "fullUrl" : "http://example.org/fhir/Organization/InsurerExample", "resource" : { "resourceType" : "Organization", "id" : "InsurerExample", "meta" : { "profile": [ "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-insurer", "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-insurer|2.1.0" ] }, "identifier" : [{ "system" : "http://hl7.org/fhir/sid/us-npi", "value" : "1234567893" }], "active" : true, "type" : [{ "coding" : [{ "system" : "https://codesystem.x12.org/005010/98", "code" : "PR" }] }], "name" : "MARYLAND CAPITAL INSURANCE COMPANY" } }, { "fullUrl" : "http://example.org/fhir/Coverage/InsuranceExample", "resource" : { "resourceType" : "Coverage", "id" : "InsuranceExample", "meta": { "profile": [ "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-coverage", "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-coverage|2.1.0" ] }, "status" : "active", "subscriberId" : "1122334455", "beneficiary" : { "reference" : "Patient/SubscriberExample" }, "relationship" : { "coding" : [{ "system" : "http://terminology.hl7.org/CodeSystem/subscriber-relationship", "code" : "self" }, { "system" : "https://codesystem.x12.org/005010/1069", "code" : "18" }] }, "payor" : [{ "reference" : "Organization/InsurerExample" }] } }, { "fullUrl" : "http://example.org/fhir/Patient/SubscriberExample", "resource" : { "resourceType" : "Patient", "id" : "SubscriberExample", "meta": { "profile": [ "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-subscriber", "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-beneficiary", "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-beneficiary|2.1.0" ] }, "extension" : [{ "url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-militaryStatus", "valueCodeableConcept" : { "coding" : [{ "system" : "https://codesystem.x12.org/005010/584", "code" : "RU" }] } }], "identifier" : [{ "type" : { "coding" : [{ "system" : "http://terminology.hl7.org/CodeSystem/v2-0203", "code" : "MB" }] }, "system" : "http://example.org/MIN", "value" : "12345678901" }], "name" : [{ "family" : "SMITH", "given" : ["JOE"] }], "gender" : "male" } }] }
Fehlermeldungen
400 Bad Request (400 Ungültige Anfrage)
Wird zurückgegeben, wenn das Anforderungsformat ungültig oder falsch formatiert ist.
{ "resourceType": "OperationOutcome", "issue": [{ "severity": "error", "code": "invalid", "diagnostics": "The provided payload was invalid and could not be parsed correctly." }] }
412 Precondition Failed (412 Vorbedingung fehlgeschlagen)
Wird zurückgegeben, wenn dieselbe vorherige Autorisierungsanfrage bereits eingereicht wurde (doppelte Einreichung erkannt).
{ "resourceType": "OperationOutcome", "issue": [{ "severity": "error", "code": "processing", "diagnostics": "PreAuth Claim already exists" }] }
Idempotenz
Die $submit Operation ist idempotent. Wenn Sie dieselbe Anfrage mehrmals einreichen, werden keine doppelten vorherigen Autorisierungsanfragen erstellt. Stattdessen erhalten Sie eine 412-Fehlermeldung, in der Sie aufgefordert werden, den Status Ihrer ursprünglichen Einreichung $inquire zu überprüfen.
4.2.2 Unverarbeitbare Entität
Wird zurückgegeben, wenn die FHIR-Validierung fehlschlägt.
{ "resourceType": "OperationOutcome", "issue": [{ "severity": "error", "code": "required", "diagnostics": "Bundle contains more than one preauthorization claim" }] }
Regeln für die Validierung
HealthLake führt eine umfassende Validierung Ihrer Einreichung durch:
Validierung des Pakets
-
Muss dem PAS Request Bundle-Profil entsprechen
-
Bundle.typemuss sein"collection" -
Kann mehrere Claim-Ressourcen enthalten
-
Muss jedoch genau eine Claim-Ressource mit Vorautorisierung enthalten
-
Und diese Claim-Ressource muss der erste Eintrag im Paket sein
-
-
Alle Ressourcen, auf die verwiesen wird, müssen im Paket enthalten sein
Validierung des Anspruchs
-
Muss dem PAS-Antragsprofil entsprechen
-
Claim.usemuss sein"preauthorization" -
Erforderliche Felder:
patient,insurer,provider,created,priority -
Geschäftskennungen müssen vorhanden und gültig sein
Validierung der Ressourcen
-
Alle Ressourcen müssen ihren jeweiligen PAS-Profilen entsprechen
-
Erforderliche unterstützende Ressourcen müssen vorhanden sein (Patient, Versicherungsschutz, Organisation)
-
Querverweise müssen gültig und innerhalb des Pakets lösbar sein
Leistungsspezifikationen
| Metrik | Spezifikation |
|---|---|
| Größenbeschränkung für Pakete | Maximal 5 MB |
| Limit für die Anzahl der Ressourcen | 500 Ressourcen pro Paket |
Erforderliche Berechtigungen
Um den $submit Vorgang zu verwenden, kann man entweder AWS Sigv4 oder SMART auf FHIR verwenden:
-
Stellen Sie sicher, dass Ihre IAM-Rolle Folgendes hat:
healthlake:SubmitPreAuthClaim- Um den Vorgang aufzurufen
SMART auf FHIR-Zielfernrohren
Erforderliche Mindestumfänge:
-
SMART Version 1:
user/Claim.write & <all_resourceTypes_in_Bundle>.write -
SMART v2:
user/Claim.c & <all_resourceTypes_in_Bundle>.c or system/*.*
Wichtige Hinweise zur Implementierung
Persistenz der Ressourcen
-
Alle Bundle-Einträge werden als einzelne FHIR-Ressourcen in Ihrem Datenspeicher gespeichert
-
Vom Kunden bereitgestellte Daten bleiben erhalten, wenn IDs sie bereitgestellt werden
-
Der Versionsverlauf wird zu Prüfungszwecken aufbewahrt
-
Die Erkennung von Duplikaten verhindert Ressourcenkonflikte
Verhalten bei der Verarbeitung
-
Jede gültige Einreichung führt zu genau einer ClaimResponse mit
"queued"Ergebnis -
Bei ungültigen Einsendungen werden die Statuscodes 400 oder 422 mit detaillierten Fehlerinformationen zurückgegeben
-
Bei Systemfehlern werden die entsprechenden 5xx-Statuscodes zurückgegeben
-
Alle erfolgreichen Einsendungen geben den Status 200 zurück und geben den Status „Ausstehend“ zurück ClaimResponse
Anforderungen für das Paket
-
Bundle.entry.fullUrlDie Werte müssen entweder REST URLs oder"urn:uuid:[guid]"Format sein -
Alle GUIDs müssen bei allen Einsendungen eindeutig sein (mit Ausnahme derselben Ressourceninstanzen)
-
Ressourcen, auf die verwiesen wird, müssen im Paket vorhanden sein oder auflösbar sein
Zugehörige -Vorgänge
-
Claim/$inquire- Fragen Sie den Status einer zuvor eingereichten Autorisierungsanfrage ab -
Patient/$everything- Rufen Sie umfassende Patientendaten für den Kontext einer vorherigen Autorisierung ab