Scenari d'uso

Flussi principali del CUP Regionale Lazio e integrazione con IRT.

Scenario 1 — Prenotazione SSN con impegnativa

Flusso tipico: il MMG emette l'impegnativa, l'assistito prenota al CUP.

MMG emette impegnativa (ServiceRequest)
        ↓
Assistito contatta il CUP Regionale Lazio (sportello / telefono / web)
        ↓
CUP cerca slot liberi → Schedule → Slot[status=free]
        ↓
CUP crea Appointment collegato a Slot e ServiceRequest
        ↓
Slot.status diventa busy
        ↓
Assistito riceve codice prenotazione

Istanze di esempio

Impegnativa SSN:

{
"resourceType": "ServiceRequest",
"id": "esempio-impegnativa-ssn",
"meta": {
"profile": [
"https://www.fhir.laziocrea.it/StructureDefinition/lccup-service-request"
]
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/classe-priorita",
"coding": [
{
"system": "https://www.fhir.laziocrea.it/CodeSystem/cs-classe-priorita",
"code": "B"
}
]
}
}
],
{
"system": "https://sistemats.sanita.finanze.it/NRE",
"value": "1200A1234567890"
}
],
"status": "active",
"intent": "order",
"priority": "urgent",
"code": {
"concept": {
"coding": [
{
"system": "https://www.salute.gov.it/NomenclatoreTariffario",
"code": "89.7",
"display": "Visita medica generale / cardiologica"
}
]
}
},
"subject": {
"reference": "LcCupPatient/paziente-mario-rossi"
},
"authoredOn": "2025-04-08",
"reference": "LcCupPractitioner/mmg-dr-bianchi"
},
"reason": [
{
"concept": {
"text": "Ipertensione arteriosa in scompenso"
}
}
]
}

Prenotazione:

{
"resourceType": "Appointment",
"id": "esempio-prenotazione-visita",
"meta": {
"profile": [
"https://www.fhir.laziocrea.it/StructureDefinition/lccup-appointment"
]
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/codice-prenotazione",
"valueString": "CUP-2025-00123456"
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/canale-prenotazione",
"coding": [
{
"system": "https://www.fhir.laziocrea.it/CodeSystem/cs-canale-prenotazione",
"code": "TELEFONO"
}
]
}
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/modalita-erogazione",
"coding": [
{
"system": "https://www.fhir.laziocrea.it/CodeSystem/cs-modalita-erogazione",
"code": "IN_PRESENZA"
}
]
}
}
],
{
"system": "https://cup.regione.lazio.it/prenotazioni",
"value": "PRN-2025-00123456"
}
],
"status": "booked",
{
"concept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "408471009",
"display": "Visita cardiologica"
}
]
}
}
],
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394579002"
}
]
}
],
"start": "2025-04-15T09:00:00+01:00",
"end": "2025-04-15T09:20:00+01:00",
"slot": [
{
"reference": "Slot/esempio-slot-libero"
}
],
"created": "2025-04-09T11:32:00+01:00",
"basedOn": [
{
"reference": "ServiceRequest/esempio-impegnativa-ssn"
}
],
"subject": {
"reference": "LcCupPatient/paziente-mario-rossi"
},
{
"actor": {
"reference": "LcCupPatient/paziente-mario-rossi"
},
"status": "accepted"
},
{
"actor": {
"reference": "LcCupPractitioner/dr-verdi-cardiologo"
},
"status": "accepted"
},
{
"actor": {
"reference": "Location/ambulatorio-cardio-sandrini"
},
"status": "accepted"
}
]
}


Scenario 2 — Teleconsulto con IRT

  1. Slot liberi sull'agenda equipe (actor = CareTeam); Slot.serviceType → HealthcareService piattaforma (PIATTAFORMA_TELEVISITA).
  2. Prenotazione con modalita-erogazione = TELE_CONSULTO sull'Appointment.
  3. Sessione video in virtualService (R5).
  4. Metadati IRT come estensioni (event-status, pathology, …).

{
"resourceType": "Appointment",
"id": "esempio-prenotazione-teleconsulto",
"meta": {
"profile": [
"https://www.fhir.laziocrea.it/StructureDefinition/lccup-appointment"
]
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/codice-prenotazione",
"valueString": "CUP-2025-00789012"
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/canale-prenotazione",
"coding": [
{
"system": "https://www.fhir.laziocrea.it/CodeSystem/cs-canale-prenotazione",
"code": "TELEMEDICINA"
}
]
}
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/modalita-erogazione",
"coding": [
{
"system": "https://www.fhir.laziocrea.it/CodeSystem/cs-modalita-erogazione",
"code": "TELE_CONSULTO"
}
]
}
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/classe-priorita",
"coding": [
{
"system": "https://www.fhir.laziocrea.it/CodeSystem/cs-classe-priorita",
"code": "B"
}
]
}
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/appointment-organization",
"reference": "Organization/esempio-irt-organization"
}
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/documents-deleted",
"valueBoolean": false
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/event-status",
"coding": [
{
"system": "https://www.fhir.laziocrea.it/CodeSystem/cs-event-status",
"code": "IN_ATTESA"
}
]
}
}
],
{
"system": "https://cup.regione.lazio.it/prenotazioni",
"value": "PRN-2025-00789012"
}
],
"status": "booked",
{
"text": "healthcare-service"
}
],
{
"reference": "HealthcareService/esempio-irt-hs-piattaforma-televisita"
}
}
],
{
"system": "https://www.fhir.laziocrea.it/CodeSystem/cs-canale-virtuale",
"code": "VIDEO_CALL"
},
"addressUrl": "https://telemedicina.laziocrea.it/sessione/abc123xyz"
}
],
{
"reference": "HealthcareService/esempio-irt-hs-prestazione"
}
],
"start": "2025-04-17T10:00:00+01:00",
"end": "2025-04-17T10:30:00+01:00",
"slot": [
{
"reference": "Slot/esempio-slot-teleconsulto"
}
],
"created": "2025-04-10T14:15:00+01:00",
"basedOn": [
{
"reference": "ServiceRequest/esempio-impegnativa-teleconsulto"
}
],
"subject": {
"reference": "LcCupPatient/paziente-mario-rossi"
},
{
"actor": {
"reference": "LcCupPatient/paziente-mario-rossi"
},
"status": "accepted"
},
{
"actor": {
"reference": "CareTeam/esempio-irt-careteam"
},
"status": "needs-action"
}
]
}


Scenario 3 — Agende teleconsulto verso IRT

Il CUP Regionale Lazio espone le agende teleconsulto (LcCup-Schedule + LcCup-Slot) affinché IRT conosca la disponibilità.

La direzione dello scambio (invio dal CUP o richiesta da IRT) è in fase di definizione; le risorse FHIR restano le stesse.

{
"resourceType": "Schedule",
"id": "esempio-agenda-teleconsulto",
"meta": {
"profile": [
"https://www.fhir.laziocrea.it/StructureDefinition/lccup-schedule"
]
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/tipo-agenda",
"coding": [
{
"system": "https://www.fhir.laziocrea.it/CodeSystem/cs-tipo-agenda",
"code": "SSN"
}
]
}
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/created-by",
"reference": "LcCupPractitioner/dr-verdi-cardiologo"
}
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/managing-organization",
"reference": "Organization/esempio-irt-organization"
}
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/time-quantum",
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/visible",
"valueBoolean": true
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/draft",
"valueBoolean": false
},
{
"url": "https://www.fhir.laziocrea.it/StructureDefinition/slot-initialized",
"valueBoolean": true
}
],
{
"type": {
"coding": [
{
"system": "https://www.fhir.laziocrea.it/CodeSystem/cs-tipo-identificatore",
"code": "99INV"
}
]
},
"value": "AGN-TELE-EQUIPE-001"
}
],
"active": true,
"name": "Agenda ReCup CUP",
"actor": [
{
"reference": "CareTeam/esempio-irt-careteam"
}
],
"start": "2025-01-01T00:00:00+01:00"
},
"comment": "Equipe teleconsulto — modalità da Slot (piattaforma Televisita) e da Appointment in prenotazione"
}


Scenario 4 — Disdetta

Appointment.status: booked → cancelled
Slot.status: busy → free   (slot torna disponibile)

Scenario 5 — Mancata presentazione (No-show)

Appointment.status: booked → noshow

I no-show vengono tracciati per il monitoraggio delle liste d'attesa (PNLA).