$submitFHIR-Operation für HealthLake - AWS HealthLake

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, der einen standardisierten FHIR-basierten Workflow für vorherige Autorisierungsanträge bietet.

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/HCPCS​ReleaseCodeSets", "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" und status: "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/HCPCS​ReleaseCodeSets", "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

  • 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