# Visit Occurrence OMOP Table - Data Management with FHIR v0.1.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Visit Occurrence OMOP Table**

## Logical Model: Visit Occurrence OMOP Table 

| | |
| :--- | :--- |
| *Official URL*:https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPVisitOccurrence | *Version*:0.1.0 |
| Draft as of 2025-10-23 | *Computable Name*:OMOPVisitOccurrence |

 
This table contains Events where Persons engage with the healthcare system for a duration of time. They are often also called "Encounters". Visits are defined by a configuration of circumstances under which they occur, such as (i) whether the patient comes to a healthcare institution, the other way around, or the interaction is remote, (ii) whether and what kind of trained medical staff is delivering the service during the Visit, and (iii) whether the Visit is transient or for a longer period involving a stay in bed. 

**Usages:**

* Refer to this Logical Model: [Condition Occurrence OMOP Table](StructureDefinition-OMOPConditionOccurrence.md), [Device Exposure OMOP Table](StructureDefinition-OMOPDeviceExposure.md), [Drug Occurrence OMOP Table](StructureDefinition-OMOPDrugExposure.md), [Measurement OMOP Table](StructureDefinition-OMOPMeasurement.md)...Show 5 more,[Note OMOP Table](StructureDefinition-OMOPNote.md),[Observation OMOP Table](StructureDefinition-OMOPObservation.md),[Procedure Occurrence OMOP Table](StructureDefinition-OMOPProcedureOccurrence.md),[Visit Detail OMOP Table](StructureDefinition-OMOPVisitDetail.md)and[Visit Occurrence OMOP Table](StructureDefinition-OMOPVisitOccurrence.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/aphp.fhir.fr.dm|current/StructureDefinition/OMOPVisitOccurrence)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-OMOPVisitOccurrence.csv), [Excel](StructureDefinition-OMOPVisitOccurrence.xlsx) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "OMOPVisitOccurrence",
  "extension" : [
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics",
      "valueCode" : "can-be-target"
    }
  ],
  "url" : "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPVisitOccurrence",
  "version" : "0.1.0",
  "name" : "OMOPVisitOccurrence",
  "title" : "Visit Occurrence OMOP Table",
  "status" : "draft",
  "date" : "2025-10-23T20:49:03+00:00",
  "publisher" : "AP-HP",
  "contact" : [
    {
      "name" : "AP-HP",
      "telecom" : [
        {
          "system" : "url",
          "value" : "https://aphp.fr"
        }
      ]
    }
  ],
  "description" : "This table contains Events where Persons engage with the healthcare system for a duration of time. They are often also called \"Encounters\". Visits are defined by a configuration of circumstances under which they occur, such as (i) whether the patient comes to a healthcare institution, the other way around, or the interaction is remote, (ii) whether and what kind of trained medical staff is delivering the service during the Visit, and (iii) whether the Visit is transient or for a longer period involving a stay in bed.",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "urn:iso:std:iso:3166",
          "code" : "FR",
          "display" : "France"
        }
      ]
    }
  ],
  "fhirVersion" : "4.0.1",
  "kind" : "logical",
  "abstract" : false,
  "type" : "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPVisitOccurrence",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Base",
  "derivation" : "specialization",
  "differential" : {
    "element" : [
      {
        "id" : "OMOPVisitOccurrence",
        "path" : "OMOPVisitOccurrence",
        "short" : "Visit Occurrence OMOP Table",
        "definition" : "This table contains Events where Persons engage with the healthcare system for a duration of time. They are often also called \"Encounters\". Visits are defined by a configuration of circumstances under which they occur, such as (i) whether the patient comes to a healthcare institution, the other way around, or the interaction is remote, (ii) whether and what kind of trained medical staff is delivering the service during the Visit, and (iii) whether the Visit is transient or for a longer period involving a stay in bed."
      },
      {
        "id" : "OMOPVisitOccurrence.visit-occurrence-id",
        "path" : "OMOPVisitOccurrence.visit_occurrence_id",
        "short" : "Visit Occurrence Identifier",
        "definition" : "Use this to identify unique interactions between a person and the health care system. This identifier links across the other CDM event tables to associate events with a visit.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "integer"
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.person-id",
        "path" : "OMOPVisitOccurrence.person_id",
        "short" : "Person",
        "definition" : "Person",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPPerson"
            ]
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.visit-concept-id",
        "path" : "OMOPVisitOccurrence.visit_concept_id",
        "short" : "Visit",
        "definition" : "This field contains a concept id representing the kind of visit, like inpatient or outpatient. All concepts in this field should be standard and belong to the Visit domain.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.visit-start-date",
        "path" : "OMOPVisitOccurrence.visit_start_date",
        "short" : "Start Date",
        "definition" : "For inpatient visits, the start date is typically the admission date. For outpatient visits the start date and end date will be the same.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "date"
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.visit-start-datetime",
        "path" : "OMOPVisitOccurrence.visit_start_datetime",
        "short" : "Start Datetime",
        "definition" : "Start Datetime",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "dateTime"
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.visit-end-date",
        "path" : "OMOPVisitOccurrence.visit_end_date",
        "short" : "End Date",
        "definition" : "For inpatient visits the end date is typically the discharge date.  If a Person is still an inpatient in the hospital at the time of the data extract and does not have a visit_end_date, then set the visit_end_date to the date of the data pull.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "date"
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.visit-end-datetime",
        "path" : "OMOPVisitOccurrence.visit_end_datetime",
        "short" : "End Datetime",
        "definition" : "End Datetime",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "dateTime"
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.visit-type-concept-id",
        "path" : "OMOPVisitOccurrence.visit_type_concept_id",
        "short" : "Visit Type",
        "definition" : "Use this field to understand the provenance of the visit record, or where the record comes from.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.provider-id",
        "path" : "OMOPVisitOccurrence.provider_id",
        "short" : "Provider",
        "definition" : "There will only be one provider per visit record and the ETL document should clearly state how they were chosen (attending, admitting, etc.). If there are multiple providers associated with a visit in the source, this can be reflected in the event tables (CONDITION_OCCURRENCE, PROCEDURE_OCCURRENCE, etc.) or in the VISIT_DETAIL table.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPProvider"
            ]
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.care-site-id",
        "path" : "OMOPVisitOccurrence.care_site_id",
        "short" : "Care Site",
        "definition" : "This field provides information about the Care Site where the Visit took place.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPCareSite"
            ]
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.visit-source-value",
        "path" : "OMOPVisitOccurrence.visit_source_value",
        "short" : "Visit Source Value",
        "definition" : "This field houses the verbatim value from the source data representing the kind of visit that took place (inpatient, outpatient, emergency, etc.)",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.visit-source-concept-id",
        "path" : "OMOPVisitOccurrence.visit_source_concept_id",
        "short" : "Visit Source Concept",
        "definition" : "Visit Source Concept",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.admitted-from-concept-id",
        "path" : "OMOPVisitOccurrence.admitted_from_concept_id",
        "short" : "Admitted From Concept",
        "definition" : "Use this field to determine where the patient was admitted from. This concept is part of the visit domain and can indicate if a patient was admitted to the hospital from a long-term care facility, for example.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.admitted-from-source-value",
        "path" : "OMOPVisitOccurrence.admitted_from_source_value",
        "short" : "Admitted From Source Value",
        "definition" : "Admitted From Source Value",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.discharged-to-concept-id",
        "path" : "OMOPVisitOccurrence.discharged_to_concept_id",
        "short" : "Discharged To Concept",
        "definition" : "Discharged To Concept",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.discharged-to-source-value",
        "path" : "OMOPVisitOccurrence.discharged_to_source_value",
        "short" : "Discharged To Source Value",
        "definition" : "Discharged To Source Value",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPVisitOccurrence.preceding-visit-occurrence-id",
        "path" : "OMOPVisitOccurrence.preceding_visit_occurrence_id",
        "short" : "Preceding Visit Occurrence",
        "definition" : "Use this field to find the visit that occurred for the person prior to the given visit. There could be a few days or a few years in between.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPVisitOccurrence"
            ]
          }
        ]
      }
    ]
  }
}

```
