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

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

## Logical Model: Procedure Occurrence OMOP Table 

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

 
This table contains records of activities or processes ordered by, or carried out by, a healthcare provider on the patient with a diagnostic or therapeutic purpose. 

**Usages:**

* This Logical Model is not used by any profiles in this Implementation Guide

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

### 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-OMOPProcedureOccurrence.csv), [Excel](StructureDefinition-OMOPProcedureOccurrence.xlsx) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "OMOPProcedureOccurrence",
  "extension" : [
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics",
      "valueCode" : "can-be-target"
    }
  ],
  "url" : "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPProcedureOccurrence",
  "version" : "0.1.0",
  "name" : "OMOPProcedureOccurrence",
  "title" : "Procedure 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 records of activities or processes ordered by, or carried out by, a healthcare provider on the patient with a diagnostic or therapeutic purpose.",
  "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/OMOPProcedureOccurrence",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Base",
  "derivation" : "specialization",
  "differential" : {
    "element" : [
      {
        "id" : "OMOPProcedureOccurrence",
        "path" : "OMOPProcedureOccurrence",
        "short" : "Procedure Occurrence OMOP Table",
        "definition" : "This table contains records of activities or processes ordered by, or carried out by, a healthcare provider on the patient with a diagnostic or therapeutic purpose."
      },
      {
        "id" : "OMOPProcedureOccurrence.procedure-occurrence-id",
        "path" : "OMOPProcedureOccurrence.procedure_occurrence_id",
        "short" : "Procedure Occurrence Identifier",
        "definition" : "The unique key given to a procedure record for a person. Refer to the ETL for how duplicate procedures during the same visit were handled.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "integer"
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.person-id",
        "path" : "OMOPProcedureOccurrence.person_id",
        "short" : "Person",
        "definition" : "The PERSON_ID of the PERSON for whom the procedure is recorded. This may be a system generated code.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPPerson"
            ]
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.procedure-concept-id",
        "path" : "OMOPProcedureOccurrence.procedure_concept_id",
        "short" : "Procedure",
        "definition" : "The PROCEDURE_CONCEPT_ID field is recommended for primary use in analyses, and must be used for network studies. This is the standard concept mapped from the source value which represents a procedure",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.procedure-date",
        "path" : "OMOPProcedureOccurrence.procedure_date",
        "short" : "Procedure Date",
        "definition" : "Use this date to determine the date the procedure started.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "date"
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.procedure-datetime",
        "path" : "OMOPProcedureOccurrence.procedure_datetime",
        "short" : "Procedure Datetime",
        "definition" : "Procedure Datetime",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "dateTime"
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.procedure-end-date",
        "path" : "OMOPProcedureOccurrence.procedure_end_date",
        "short" : "Procedure End Date",
        "definition" : "Use this field to house the date that the procedure ended.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "date"
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.procedure-end-datetime",
        "path" : "OMOPProcedureOccurrence.procedure_end_datetime",
        "short" : "procedure_end_datetime",
        "definition" : "Use this field to house the datetime that the procedure ended.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "dateTime"
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.procedure-type-concept-id",
        "path" : "OMOPProcedureOccurrence.procedure_type_concept_id",
        "short" : "Procedure Type",
        "definition" : "This field can be used to determine the provenance of the Procedure record, as in whether the procedure was from an EHR system, insurance claim, registry, or other sources.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.modifier-concept-id",
        "path" : "OMOPProcedureOccurrence.modifier_concept_id",
        "short" : "Modifier",
        "definition" : "The modifiers are intended to give additional information about the procedure but as of now the vocabulary is under review.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.quantity",
        "path" : "OMOPProcedureOccurrence.quantity",
        "short" : "Quantity",
        "definition" : "If the quantity value is omitted, a single procedure is assumed.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "integer"
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.provider-id",
        "path" : "OMOPProcedureOccurrence.provider_id",
        "short" : "Provider",
        "definition" : "The provider associated with the procedure record, e.g. the provider who performed the Procedure.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPProvider"
            ]
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.visit-occurrence-id",
        "path" : "OMOPProcedureOccurrence.visit_occurrence_id",
        "short" : "VisitOccurrence",
        "definition" : "The visit during which the procedure occurred.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPVisitOccurrence"
            ]
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.visit-detail-id",
        "path" : "OMOPProcedureOccurrence.visit_detail_id",
        "short" : "Visit Detail",
        "definition" : "The VISIT_DETAIL record during which the Procedure occurred. For example, if the Person was in the ICU at the time of the Procedure the VISIT_OCCURRENCE record would reflect the overall hospital stay and the VISIT_DETAIL record would reflect the ICU stay during the hospital visit.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPVisitDetail"
            ]
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.procedure-source-value",
        "path" : "OMOPProcedureOccurrence.procedure_source_value",
        "short" : "Procedure Source Value",
        "definition" : "This field houses the verbatim value from the source data representing the procedure that occurred. For example, this could be an CPT4 or OPCS4 code.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.procedure-source-concept-id",
        "path" : "OMOPProcedureOccurrence.procedure_source_concept_id",
        "short" : "Procedure Source Concept",
        "definition" : "This is the concept representing the procedure source value and may not necessarily be standard. This field is discouraged from use in analysis because it is not required to contain Standard Concepts that are used across the OHDSI community, and should only be used when Standard Concepts do not adequately represent the source detail for the Procedure necessary for a given analytic use case. Consider using PROCEDURE_CONCEPT_ID instead to enable standardized analytics that can be consistent across the network.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPProcedureOccurrence.modifier-source-value",
        "path" : "OMOPProcedureOccurrence.modifier_source_value",
        "short" : "Modifier Source Value",
        "definition" : "Modifier Source Value",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      }
    ]
  }
}

```
