| Package | hl7.fhir.us.pdmp |
| Resource Type | OperationDefinition |
| Id | pdmp-history |
| FHIR Version | R4 |
| Source | http://hl7.org/fhir/us/pdmp/https://build.fhir.org/ig/HL7/fhir-pdmp/OperationDefinition-pdmp-history.html |
| URL | http://hl7.org/fhir/us/pdmp/OperationDefinition/pdmp-history |
| Version | 1.0.0 |
| Status | active |
| Date | 2024-04-01T00:00:00-05:00 |
| Name | PdmpOperationGetPdmpHistory |
| Title | PDMP Operation PDMP History |
| Realm | us |
| Authority | hl7 |
| Description | Operation returning an individual patient's PDMP history |
| Type | false |
| Kind | operation |
| CapabilityStatement | |
| pdmp-client | PDMP_Client |
| pdmp-server | PDMP_Server |
No resources found
Note: links and images are rebased to the (stated) source
Generated Narrative: OperationDefinition pdmp-history
URL: [base]/$pdmp-history
Input parameters Profile:PDMP Parameters - Request
Output parameters Profile:PDMP Parameters - Response
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | patient | 1..1 | Patient (PDMP Patient) | The patient whose PDMP history is desired | ||
| IN | animal-owner | 0..1 | RelatedPerson (US Core RelatedPerson Profile) | If the patient is an animal, this parameter reflects its owner's information | ||
| IN | authorized-practitioner | 1..1 | Practitioner (US Core Practitioner Profile) | The Practitioner resource reflecting the provider who is authorized to view the returned PDMP information | ||
| IN | authorized-practitioner-role | 1..1 | PractitionerRole (US Core PractitionerRole Profile) | The PractitionerRole resource reflecting the authorized provider's practice information | ||
| IN | authorized-practitioner-organization | 0..1 | Organization (US Core Organization Profile) | An Organization resource reflecting the authorized provider's organization | ||
| IN | delegate-practitioner | 0..1 | Practitioner (US Core Practitioner Profile) | A Practitioner resource reflecting a provider who is requesting the PDMP information on behalf of another party | ||
| IN | delegate-practitioner-role | 0..1 | PractitionerRole (US Core PractitionerRole Profile) | A PractitionerRole resource reflecting the delegate's practice information | ||
| IN | delegate-organization | 0..1 | Organization (US Core Organization Profile) | An Organization resource reflecting the delegate's organization | ||
| IN | pre-stage-only | 0..1 | boolean | Indicates that the PDMP Responder is expected to gather the requested information and stage it for future retrieval (via a subsequent invocation of this operation) | ||
| IN | pre-stage-retrieval-key | 0..1 | string | The pre-stage-retrieval-key returned from a previous operation call in which the pre-stage-only parameter was set to true | ||
| OUT | pdmp-history-data | 0..1 | Bundle (PDMP Bundle - History Result) | A Bundle of type 'collection' that contains medication dispensation and administration information for the requested patient (if found) | ||
| OUT | pdmp-history-link | 0..1 | url | A URL to access an external report containing a PDMP history for the requested patient | ||
| OUT | pre-stage-retrieval-key | 0..1 | string | This parameter is used only when responding to an invocation in which the pre-stage-only parameter was set to true. This element may be populated with a string value that the requester is to submit in the pre-stage-retrieval-key parameter of the subsequent invocation that retrieves the staged information | ||
| OUT | outcome | 0..1 | OperationOutcome | An OperationOutcome resource containing processing information associated with the operation response, including error, warning and/or informational information |
{
"resourceType": "OperationDefinition",
"id": "pdmp-history",
"text": {
"status": "generated",
"div": "<!-- snip (see above) -->"
},
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
"valueCode": "phx"
}
],
"url": "http://hl7.org/fhir/us/pdmp/OperationDefinition/pdmp-history",
"version": "1.0.0",
"name": "PdmpOperationGetPdmpHistory",
"title": "PDMP Operation PDMP History",
"status": "active",
"kind": "operation",
"date": "2024-04-01T00:00:00-05:00",
"publisher": "HL7 International / Pharmacy",
"contact": [
{
"name": "HL7 International / Pharmacy",
"telecom": [
{
"system": "url",
"value": "http://www.hl7.org/Special/committees/medication"
}
]
},
{
"name": "Frank McKinney",
"telecom": [
{
"system": "email",
"value": "frank.mckinney@pocp.com"
},
{
"system": "email",
"value": "fm@frankmckinney.com"
}
]
},
{
"name": "Scott Robertson",
"telecom": [
{
"system": "email",
"value": "scott.robertson@pocp.com"
},
{
"system": "email",
"value": "scott@BearHealthTech.consulting"
}
]
}
],
"description": "Operation returning an individual patient's PDMP history",
"jurisdiction": [
{
"coding": [
{
"system": "urn:iso:std:iso:3166",
"code": "US",
"display": "United States of America"
}
]
}
],
"affectsState": false,
"code": "pdmp-history",
"system": true,
"type": false,
"instance": false,
"inputProfile": "http://hl7.org/fhir/us/pdmp/StructureDefinition/pdmp-parameters-request",
"outputProfile": "http://hl7.org/fhir/us/pdmp/StructureDefinition/pdmp-parameters-response",
"parameter": [
{
"name": "patient",
"use": "in",
"min": 1,
"max": "1",
"documentation": "The patient whose PDMP history is desired",
"type": "Patient",
"targetProfile": [
"http://hl7.org/fhir/us/pdmp/StructureDefinition/pdmp-patient"
]
},
{
"name": "animal-owner",
"use": "in",
"min": 0,
"max": "1",
"documentation": "If the patient is an animal, this parameter reflects its owner's information",
"type": "RelatedPerson",
"targetProfile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-relatedperson"
]
},
{
"name": "authorized-practitioner",
"use": "in",
"min": 1,
"max": "1",
"documentation": "The Practitioner resource reflecting the provider who is authorized to view the returned PDMP information",
"type": "Practitioner",
"targetProfile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner"
]
},
{
"name": "authorized-practitioner-role",
"use": "in",
"min": 1,
"max": "1",
"documentation": "The PractitionerRole resource reflecting the authorized provider's practice information",
"type": "PractitionerRole",
"targetProfile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole"
]
},
{
"name": "authorized-practitioner-organization",
"use": "in",
"min": 0,
"max": "1",
"documentation": "An Organization resource reflecting the authorized provider's organization",
"type": "Organization",
"targetProfile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization"
]
},
{
"name": "delegate-practitioner",
"use": "in",
"min": 0,
"max": "1",
"documentation": "A Practitioner resource reflecting a provider who is requesting the PDMP information on behalf of another party",
"type": "Practitioner",
"targetProfile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner"
]
},
{
"name": "delegate-practitioner-role",
"use": "in",
"min": 0,
"max": "1",
"documentation": "A PractitionerRole resource reflecting the delegate's practice information",
"type": "PractitionerRole",
"targetProfile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole"
]
},
{
"name": "delegate-organization",
"use": "in",
"min": 0,
"max": "1",
"documentation": "An Organization resource reflecting the delegate's organization",
"type": "Organization",
"targetProfile": [
"http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization"
]
},
{
"name": "pre-stage-only",
"use": "in",
"min": 0,
"max": "1",
"documentation": "Indicates that the PDMP Responder is expected to gather the requested information and stage it for future retrieval (via a subsequent invocation of this operation)",
"type": "boolean"
},
{
"name": "pre-stage-retrieval-key",
"use": "in",
"min": 0,
"max": "1",
"documentation": "The pre-stage-retrieval-key returned from a previous operation call in which the pre-stage-only parameter was set to true",
"type": "string"
},
{
"name": "pdmp-history-data",
"use": "out",
"min": 0,
"max": "1",
"documentation": "A Bundle of type 'collection' that contains medication dispensation and administration information for the requested patient (if found)",
"type": "Bundle",
"targetProfile": [
"http://hl7.org/fhir/us/pdmp/StructureDefinition/pdmp-bundle-history-result"
]
},
{
"name": "pdmp-history-link",
"use": "out",
"min": 0,
"max": "1",
"documentation": "A URL to access an external report containing a PDMP history for the requested patient",
"type": "url"
},
{
"name": "pre-stage-retrieval-key",
"use": "out",
"min": 0,
"max": "1",
"documentation": "This parameter is used only when responding to an invocation in which the pre-stage-only parameter was set to true. This element may be populated with a string value that the requester is to submit in the pre-stage-retrieval-key parameter of the subsequent invocation that retrieves the staged information",
"type": "string"
},
{
"name": "outcome",
"use": "out",
"min": 0,
"max": "1",
"documentation": "An OperationOutcome resource containing processing information associated with the operation response, including error, warning and/or informational information",
"type": "OperationOutcome"
}
]
}