RLServiceRequestRivalutazione

Descrizione

Il profilo RLServiceRequestRivalutazione è stato strutturato a partire dalla risorsa generica FHIR ServiceRequest ed è volto a notificare la necessità di una rivalutazione di un paziente attualmente in ricovero domiciliare.

Di seguito è presentato il contenuto del profilo in diversi formati. La corrispondente definizione è consultabile al seguente link: RLServiceRequestRivalutazione.


Snapshot View

idΣ1..1System.String
versionIdΣ1..1id
lastUpdatedΣ1..1instant
sourceΣ0..1uri
profileΣ1..1canonical(StructureDefinition)Fixed Value
securityΣ0..*CodingBinding
tagΣ0..*Coding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
instantiatesCanonicalΣ0..*canonical(ActivityDefinition | PlanDefinition)
instantiatesUriΣ0..*uri
basedOnΣ I1..1Reference(RLCarePlanProgettoIndividuale)
replacesΣ I0..*Reference(ServiceRequest)
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
statusΣ ?!1..1codeBindingFixed Value
intentΣ ?!1..1codeBindingFixed Value
categoryΣ0..*CodeableConcept
priorityΣ0..1codeBinding
doNotPerformΣ ?!0..1boolean
codeΣ0..1CodeableConcept
orderDetailΣ I0..*CodeableConcept
quantityQuantityQuantity
quantityRatioRatio
quantityRangeRange
subjectΣ I1..1Reference(RLPatientCittadino)
encounterΣ I0..1Reference(Encounter)
occurrenceDateTimedateTime
asNeededBooleanboolean
asNeededCodeableConceptCodeableConcept
authoredOnΣ0..1dateTime
requesterΣ I0..1Reference(Practitioner | PractitionerRole | Organization | Patient | RelatedPerson | Device)
performerTypeΣ0..1CodeableConcept
performerΣ I0..*Reference(Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService | Patient | Device | RelatedPerson)
locationCodeΣ0..*CodeableConcept
locationReferenceΣ I0..*Reference(Location)
reasonCodeΣ0..*CodeableConcept
reasonReferenceΣ I0..*Reference(Condition | Observation | DiagnosticReport | DocumentReference)
insuranceI0..*Reference(Coverage | ClaimResponse)
supportingInfoI0..*Reference(Resource)
specimenΣ I0..*Reference(Specimen)
bodySiteΣ0..*CodeableConcept
note0..1Annotation
patientInstructionΣ0..1string
relevantHistoryI0..*Reference(Provenance)

Differential View

idΣ1..1System.String
versionIdΣ1..1id
lastUpdatedΣ1..1instant
sourceΣ0..1uri
profileΣ1..1canonical(StructureDefinition)Fixed Value
securityΣ0..*CodingBinding
tagΣ0..*Coding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
instantiatesCanonicalΣ0..*canonical(ActivityDefinition | PlanDefinition)
instantiatesUriΣ0..*uri
basedOnΣ I1..1Reference(RLCarePlanProgettoIndividuale)
replacesΣ I0..*Reference(ServiceRequest)
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
statusΣ ?!1..1codeBindingFixed Value
intentΣ ?!1..1codeBindingFixed Value
categoryΣ0..*CodeableConcept
priorityΣ0..1codeBinding
doNotPerformΣ ?!0..1boolean
codeΣ0..1CodeableConcept
orderDetailΣ I0..*CodeableConcept
quantityQuantityQuantity
quantityRatioRatio
quantityRangeRange
subjectΣ I1..1Reference(RLPatientCittadino)
encounterΣ I0..1Reference(Encounter)
occurrenceDateTimedateTime
asNeededBooleanboolean
asNeededCodeableConceptCodeableConcept
authoredOnΣ0..1dateTime
requesterΣ I0..1Reference(Practitioner | PractitionerRole | Organization | Patient | RelatedPerson | Device)
performerTypeΣ0..1CodeableConcept
performerΣ I0..*Reference(Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService | Patient | Device | RelatedPerson)
locationCodeΣ0..*CodeableConcept
locationReferenceΣ I0..*Reference(Location)
reasonCodeΣ0..*CodeableConcept
reasonReferenceΣ I0..*Reference(Condition | Observation | DiagnosticReport | DocumentReference)
insuranceI0..*Reference(Coverage | ClaimResponse)
supportingInfoI0..*Reference(Resource)
specimenΣ I0..*Reference(Specimen)
bodySiteΣ0..*CodeableConcept
note0..1Annotation
patientInstructionΣ0..1string
relevantHistoryI0..*Reference(Provenance)

Hybrid View

idΣ1..1System.String
versionIdΣ1..1id
lastUpdatedΣ1..1instant
sourceΣ0..1uri
profileΣ1..1canonical(StructureDefinition)Fixed Value
securityΣ0..*CodingBinding
tagΣ0..*Coding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
instantiatesCanonicalΣ0..*canonical(ActivityDefinition | PlanDefinition)
instantiatesUriΣ0..*uri
basedOnΣ I1..1Reference(RLCarePlanProgettoIndividuale)
replacesΣ I0..*Reference(ServiceRequest)
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
statusΣ ?!1..1codeBindingFixed Value
intentΣ ?!1..1codeBindingFixed Value
categoryΣ0..*CodeableConcept
priorityΣ0..1codeBinding
doNotPerformΣ ?!0..1boolean
codeΣ0..1CodeableConcept
orderDetailΣ I0..*CodeableConcept
quantityQuantityQuantity
quantityRatioRatio
quantityRangeRange
subjectΣ I1..1Reference(RLPatientCittadino)
encounterΣ I0..1Reference(Encounter)
occurrenceDateTimedateTime
asNeededBooleanboolean
asNeededCodeableConceptCodeableConcept
authoredOnΣ0..1dateTime
requesterΣ I0..1Reference(Practitioner | PractitionerRole | Organization | Patient | RelatedPerson | Device)
performerTypeΣ0..1CodeableConcept
performerΣ I0..*Reference(Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService | Patient | Device | RelatedPerson)
locationCodeΣ0..*CodeableConcept
locationReferenceΣ I0..*Reference(Location)
reasonCodeΣ0..*CodeableConcept
reasonReferenceΣ I0..*Reference(Condition | Observation | DiagnosticReport | DocumentReference)
insuranceI0..*Reference(Coverage | ClaimResponse)
supportingInfoI0..*Reference(Resource)
specimenΣ I0..*Reference(Specimen)
bodySiteΣ0..*CodeableConcept
note0..1Annotation
patientInstructionΣ0..1string
relevantHistoryI0..*Reference(Provenance)

Table View

ServiceRequest..
ServiceRequest.id1..
ServiceRequest.meta1..
ServiceRequest.meta.versionId1..
ServiceRequest.meta.lastUpdated1..
ServiceRequest.meta.profile1..1
ServiceRequest.identifier1..1
ServiceRequest.identifier.system1..
ServiceRequest.identifier.value1..
ServiceRequest.basedOnReference(RLCarePlanProgettoIndividuale)1..1
ServiceRequest.requisition1..
ServiceRequest.requisition.system1..
ServiceRequest.requisition.value1..
ServiceRequest.status..
ServiceRequest.intent..
ServiceRequest.subjectReference(RLPatientCittadino)..
ServiceRequest.occurrence[x]dateTime1..
ServiceRequest.note..1


XML View

<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="UUID" />
    <url value="https://fhir.siss.regione.lombardia.it/StructureDefinition/RLServiceRequestRivalutazione" />
    <name value="RLServiceRequestRivalutazione" />
    <status value="active" />
    <description value="Profilo volto a notificare la necessit&#224; di una rivalutazione di un paziente in ricovero domiciliare" />
    <keyword>
        <system value="https://fhir.siss.regione.lombardia.it/CodeSystem/Tag" />
        <code value="C-DOM" />
    </keyword>
    <fhirVersion value="4.0.1" />
    <kind value="resource" />
    <abstract value="false" />
    <type value="ServiceRequest" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/ServiceRequest" />
    <derivation value="constraint" />
    <differential>
        <element id="ServiceRequest.id">
            <path value="ServiceRequest.id" />
            <short value="UUID prodotto dal server FHIR (applicativo) che detiente la risorsa" />
            <min value="1" />
        </element>
        <element id="ServiceRequest.meta">
            <path value="ServiceRequest.meta" />
            <short value="Metadati della risorsa" />
            <min value="1" />
        </element>
        <element id="ServiceRequest.meta.versionId">
            <path value="ServiceRequest.meta.versionId" />
            <short value="Versione della risorsa" />
            <min value="1" />
        </element>
        <element id="ServiceRequest.meta.lastUpdated">
            <path value="ServiceRequest.meta.lastUpdated" />
            <short value="Data e ora di ultimo aggiornamento della risorsa" />
            <definition value="Formato standard FHIR: YYY-MM-DDThh:mm:ss.sss+zz:zz" />
            <min value="1" />
        </element>
        <element id="ServiceRequest.meta.profile">
            <path value="ServiceRequest.meta.profile" />
            <short value="Profilo al quale la risorsa si riferisce" />
            <min value="1" />
            <max value="1" />
            <fixedCanonical value="https://fhir.siss.regione.lombardia.it/StructureDefinition/RLServiceRequestRivalutazione" />
        </element>
        <element id="ServiceRequest.identifier">
            <path value="ServiceRequest.identifier" />
            <short value="Codice identificativo della richiesta di rivalutazione del paziente" />
            <min value="1" />
            <max value="1" />
        </element>
        <element id="ServiceRequest.identifier.system">
            <path value="ServiceRequest.identifier.system" />
            <min value="1" />
            <fixedUri value="https://fhir.siss.regione.lombardia.it/sid/identificativoRichiestaRivalutazionePaziente" />
        </element>
        <element id="ServiceRequest.identifier.value">
            <path value="ServiceRequest.identifier.value" />
            <short value="Codice identificativo della richiesta di rivalutazione del paziente" />
            <definition value="{codiceL2}{numeroPratica}_R{progressivo a 6 cifre es.000001}" />
            <min value="1" />
        </element>
        <element id="ServiceRequest.basedOn">
            <path value="ServiceRequest.basedOn" />
            <short value="Riferimento al progetto individuale nel quale &#232; prevista l&#39;erogazione della prestazione" />
            <definition value="Reference al profilo RLCarePlanProgettoIndividuale contente il progetto individuale del paziente" />
            <min value="1" />
            <max value="1" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.siss.regione.lombardia.it/StructureDefinition/RLCarePlanProgettoIndividuale" />
            </type>
        </element>
        <element id="ServiceRequest.requisition">
            <path value="ServiceRequest.requisition" />
            <short value="Numero pratica del ricovero domiciliare" />
            <min value="1" />
        </element>
        <element id="ServiceRequest.requisition.system">
            <path value="ServiceRequest.requisition.system" />
            <min value="1" />
            <fixedUri value="https://fhir.siss.regione.lombardia.it/sid/numeroPraticaRicoveroDomiciliare" />
        </element>
        <element id="ServiceRequest.requisition.value">
            <path value="ServiceRequest.requisition.value" />
            <short value="Numero pratica del ricovero domiciliare" />
            <min value="1" />
        </element>
        <element id="ServiceRequest.status">
            <path value="ServiceRequest.status" />
            <short value="Stato del ricovero domiciliare" />
            <definition value="Valore fisso su &quot;active&quot;" />
            <fixedCode value="active" />
        </element>
        <element id="ServiceRequest.intent">
            <path value="ServiceRequest.intent" />
            <short value="Intento della richesta" />
            <definition value="Valore fisso su &quot;proposal&quot;" />
            <fixedCode value="proposal" />
        </element>
        <element id="ServiceRequest.subject">
            <path value="ServiceRequest.subject" />
            <short value="Paziente al quale deve essere erogata la prestazione" />
            <definition value="Reference alla risorsa RLPatientCittadino contenente i dettagli anagrafici del paziente" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.siss.regione.lombardia.it/StructureDefinition/RLPatientCittadino" />
            </type>
        </element>
        <element id="ServiceRequest.occurrence[x]">
            <path value="ServiceRequest.occurrence[x]" />
            <short value="Data (e ora, se disponibile) in cui &#232; stata ichiesta la rivalutazione la rivalutazione del paziente" />
            <definition value="Formato: YYYY-MM-DD secondo lo standard FHIR. \nNel caso in cui fosse disponibile anche l&#39;ora compilare con il formato: YYYY-MM-DDThh:mm:ss+zz:zz secondo lo standard FHIR" />
            <min value="1" />
            <type>
                <code value="dateTime" />
            </type>
        </element>
        <element id="ServiceRequest.note">
            <path value="ServiceRequest.note" />
            <short value="Note / commenti aggiuntivi" />
            <definition value="Stringa alfanumerica al pi&#249; di 1000 caratteri" />
            <max value="1" />
        </element>
    </differential>
</StructureDefinition>

JSON View

{
    "resourceType": "StructureDefinition",
    "id": "UUID",
    "url": "https://fhir.siss.regione.lombardia.it/StructureDefinition/RLServiceRequestRivalutazione",
    "name": "RLServiceRequestRivalutazione",
    "status": "active",
    "description": "Profilo volto a notificare la necessità di una rivalutazione di un paziente in ricovero domiciliare",
    "keyword":  [
        {
            "system": "https://fhir.siss.regione.lombardia.it/CodeSystem/Tag",
            "code": "C-DOM"
        }
    ],
    "fhirVersion": "4.0.1",
    "kind": "resource",
    "abstract": false,
    "type": "ServiceRequest",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/ServiceRequest",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "ServiceRequest.id",
                "path": "ServiceRequest.id",
                "short": "UUID prodotto dal server FHIR (applicativo) che detiente la risorsa",
                "min": 1
            },
            {
                "id": "ServiceRequest.meta",
                "path": "ServiceRequest.meta",
                "short": "Metadati della risorsa",
                "min": 1
            },
            {
                "id": "ServiceRequest.meta.versionId",
                "path": "ServiceRequest.meta.versionId",
                "short": "Versione della risorsa",
                "min": 1
            },
            {
                "id": "ServiceRequest.meta.lastUpdated",
                "path": "ServiceRequest.meta.lastUpdated",
                "short": "Data e ora di ultimo aggiornamento della risorsa",
                "definition": "Formato standard FHIR: YYY-MM-DDThh:mm:ss.sss+zz:zz",
                "min": 1
            },
            {
                "id": "ServiceRequest.meta.profile",
                "path": "ServiceRequest.meta.profile",
                "short": "Profilo al quale la risorsa si riferisce",
                "min": 1,
                "max": "1",
                "fixedCanonical": "https://fhir.siss.regione.lombardia.it/StructureDefinition/RLServiceRequestRivalutazione"
            },
            {
                "id": "ServiceRequest.identifier",
                "path": "ServiceRequest.identifier",
                "short": "Codice identificativo della richiesta di rivalutazione del paziente",
                "min": 1,
                "max": "1"
            },
            {
                "id": "ServiceRequest.identifier.system",
                "path": "ServiceRequest.identifier.system",
                "min": 1,
                "fixedUri": "https://fhir.siss.regione.lombardia.it/sid/identificativoRichiestaRivalutazionePaziente"
            },
            {
                "id": "ServiceRequest.identifier.value",
                "path": "ServiceRequest.identifier.value",
                "short": "Codice identificativo della richiesta di rivalutazione del paziente",
                "definition": "{codiceL2}{numeroPratica}_R{progressivo a 6 cifre es.000001}",
                "min": 1
            },
            {
                "id": "ServiceRequest.basedOn",
                "path": "ServiceRequest.basedOn",
                "short": "Riferimento al progetto individuale nel quale è prevista l'erogazione della prestazione",
                "definition": "Reference al profilo RLCarePlanProgettoIndividuale contente il progetto individuale del paziente",
                "min": 1,
                "max": "1",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.siss.regione.lombardia.it/StructureDefinition/RLCarePlanProgettoIndividuale"
                        ]
                    }
                ]
            },
            {
                "id": "ServiceRequest.requisition",
                "path": "ServiceRequest.requisition",
                "short": "Numero pratica del ricovero domiciliare",
                "min": 1
            },
            {
                "id": "ServiceRequest.requisition.system",
                "path": "ServiceRequest.requisition.system",
                "min": 1,
                "fixedUri": "https://fhir.siss.regione.lombardia.it/sid/numeroPraticaRicoveroDomiciliare"
            },
            {
                "id": "ServiceRequest.requisition.value",
                "path": "ServiceRequest.requisition.value",
                "short": "Numero pratica del ricovero domiciliare",
                "min": 1
            },
            {
                "id": "ServiceRequest.status",
                "path": "ServiceRequest.status",
                "short": "Stato del ricovero domiciliare",
                "definition": "Valore fisso su \"active\"",
                "fixedCode": "active"
            },
            {
                "id": "ServiceRequest.intent",
                "path": "ServiceRequest.intent",
                "short": "Intento della richesta",
                "definition": "Valore fisso su \"proposal\"",
                "fixedCode": "proposal"
            },
            {
                "id": "ServiceRequest.subject",
                "path": "ServiceRequest.subject",
                "short": "Paziente al quale deve essere erogata la prestazione",
                "definition": "Reference alla risorsa RLPatientCittadino contenente i dettagli anagrafici del paziente",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.siss.regione.lombardia.it/StructureDefinition/RLPatientCittadino"
                        ]
                    }
                ]
            },
            {
                "id": "ServiceRequest.occurrence[x]",
                "path": "ServiceRequest.occurrence[x]",
                "short": "Data (e ora, se disponibile) in cui è stata ichiesta la rivalutazione la rivalutazione del paziente",
                "definition": "Formato: YYYY-MM-DD secondo lo standard FHIR. \nNel caso in cui fosse disponibile anche l'ora compilare con il formato: YYYY-MM-DDThh:mm:ss+zz:zz secondo lo standard FHIR",
                "min": 1,
                "type":  [
                    {
                        "code": "dateTime"
                    }
                ]
            },
            {
                "id": "ServiceRequest.note",
                "path": "ServiceRequest.note",
                "short": "Note / commenti aggiuntivi",
                "definition": "Stringa alfanumerica al più di 1000 caratteri",
                "max": "1"
            }
        ]
    }
}

Tipologie di ricerca

Dettagli della necessità di rivalutazione del paziente

Questa ricerca deve essere utilizzata da un’ASST nel momento in cui deve essere appurato se un paziente attualmente in ricovero domiciliare necessita di una rivalutazione. Mediante il numero pratica del servizio e cure domiciliari viene definita l’associazione della prestazione erogata con l’assistito.

Il parametro da valorizzare obbligatoriamente per effettuare la ricerca sono:

  • requisition: numero pratica del servizio di cure domiciliari.

Nella tabella di seguito vengono riportati i dettagli tecnici per l’implementazione della ricerca:

SCOPE Dettagli della necessità di rivalutazione del paziente
VERB GET
BASE_APIMANAGER https://api.servizirl.it/c/operatori.siss/fhir/v1.0.0/npri
BASE_APISOURCE https://<nome_host_Ente>/<contesto_FHIR>/<codiceCudesL1>/<versione>/erogazione-adi
URL ServiceRequest?_profile=https://fhir.siss.regione.lombardia.it/StructureDefinition/RLServiceRequestRivalutazione
&requisition={numeroPratica}
&based-on:CarePlan.activity-reference:ServiceRequest.performer:Organization.identifier={codiceLivello2}

A titolo esemplificativo, la chiamate:

ServiceRequest?_profile=https://fhir.siss.regione.lombardia.it/StructureDefinition/RLServiceRequestRivalutazione&requisition=2022000001&based-on:CarePlan.activity-reference:ServiceRequest.performer:Organization.identifier=03014300

Restituirà, se presenti, tutte le rivalutazioni necessarie alla pratica numero "2022000001" afferente alla struttura "03014300".

Un esempio di Bundle di risposta può essere consultato qui: esempio-ricerca-rivalutazioni.

Poiché questa ricerca è di prassi utilizzata per ricavare anche i dettagli relativi alle sospensioni temporanee dei servizi di cure domiciliari del paziente, strutturati nel profilo RLServiceRequestSopensioneADI, vengono di seguito riportate le informazioni per effettuare la ricerca congiunta.

Il parametro da valorizzare obbligatoriamente per effettuare la ricerca per entrambi i profili interessati (RLServiceRequestSopensioneADI e RLServiceRequestRivalutazione) è:

  • requisition: numero pratica del servizio di cure domiciliari.

Nella tabella di seguito vengono riportati i dettagli tecnici per l’implementazione della ricerca:

SCOPE Dettagli della sospensione temporanea del ricovero domiciliare e necessità di rivalutazione del paziente
VERB GET
BASE_APIMANAGER https://api.servizirl.it/c/operatori.siss/fhir/v1.0.0/npri
BASE_APISOURCE https://<nome_host_Ente>/<contesto_FHIR>/<codiceCudesL1>/<versione>/erogazione-adi
URL ServiceRequest?_profile=https://fhir.siss.regione.lombardia.it/StructureDefinition/RLServiceRequestRivalutazione,
https://fhir.siss.regione.lombardia.it/StructureDefinition/RLServiceRequestSospensioneADI
&requisition={numeroPratica}
&based-on:CarePlan.activity-reference:ServiceRequest.performer:Organization.identifier={codiceLivello2}

La chiamata:

ServiceRequest?_profile=https://fhir.siss.regione.lombardia.it/StructureDefinition/RLServiceRequestRivalutazione,https://fhir.siss.regione.lombardia.it/StructureDefinition/RLServiceRequestSospensioneADI&requisition=2022000001&based-on:CarePlan.activity-reference:ServiceRequest.performer:Organization.identifier=03014300

Restituirà, se presenti, tutte le sospensioni temporanee e rivalutazioni relative pratica numero "2022000001" afferente alla struttura "03014300".

Un esempio di Bundle di risposta può essere consultato qui: esempio-ricerca-rivalutazioni-sospensioni.

Criterio di ricerca applicato per le funzionalità descritte nei documenti:

  • DC-COOP-FHIR#01 (Specifiche di cooperazione applicativa nell’ambito delle cure domiciliari).

Search parameter

Per questo profilo sono utilizzati i seguenti parametri di ricerca previsti dallo standard:

  • _profile
  • based-on
  • requisition

ValueSet

Attualmente non sono definiti value set specifici per il profilo RLServiceRequestRivalutazione.