# Custodian of medication catalog - Order Catalog Implementation Guide v1.0.0

* [**Table Content**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Custodian of medication catalog**

## CapabilityStatement: Custodian of medication catalog 

| | | |
| :--- | :--- | :--- |
| *Official URL*:http://hl7.org/fhir/uv/order-catalog/CapabilityStatement/cs-drug-custodian | *Version*:1.0.0 | |
| * Standards status: *[Trial-use](http://hl7.org/fhir/R5/versions.html#std-process) | [Maturity Level](http://hl7.org/fhir/versions.html#maturity): 2 | *Computable Name*:CapabilityStatement4DrugCustodian |
| *Other Identifiers:*OID:2.16.840.1.113883.4.642.40.55.13.2 | | |

 
This Section describes the expected capabilities of the Custodian of a catalog of medications. This role is responsible for providing responses to the queries submitted by the catalog consumers. 
The MedicationKnowledge Resource is the focal Resource gathering all knowledge and information details about a medication in the catalog. 

 [Raw OpenAPI-Swagger Definition file](cs-drug-custodian.openapi.json) | [Download](cs-drug-custodian.openapi.json) 



## Resource Content

```json
{
  "resourceType" : "CapabilityStatement",
  "id" : "cs-drug-custodian",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "oo"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 2,
    "_valueInteger" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/uv/order-catalog/ImplementationGuide/ig-uv-order-catalog"
      }]
    }
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "trial-use",
    "_valueCode" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/uv/order-catalog/ImplementationGuide/ig-uv-order-catalog"
      }]
    }
  }],
  "url" : "http://hl7.org/fhir/uv/order-catalog/CapabilityStatement/cs-drug-custodian",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.40.55.13.2"
  }],
  "version" : "1.0.0",
  "name" : "CapabilityStatement4DrugCustodian",
  "title" : "CapabilityStatement for custodian of catalog of medications",
  "status" : "active",
  "experimental" : false,
  "date" : "2022-09-16",
  "publisher" : "HL7 International / Orders and Observations",
  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/orders"
    }]
  }],
  "description" : "This Section describes the expected capabilities of the Custodian of a catalog of medications. This role is responsible for providing responses to the queries submitted by the catalog consumers. \n\nThe MedicationKnowledge Resource is the focal Resource gathering all knowledge and information details about a medication in the catalog.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "001"
    }]
  }],
  "kind" : "requirements",
  "fhirVersion" : "5.0.0",
  "format" : ["xml", "json"],
  "implementationGuide" : ["http://hl7.org/fhir/uv/order-catalog/ImplementationGuide/ig-uv-order-catalog"],
  "rest" : [{
    "mode" : "server",
    "documentation" : "The Custodian of a catalog of medications **SHALL**:\n\n1. Support profiles CatalogHeader, DrugKnowledge, DrugPackage defined in this Implementation Guide..\n2.  Implement the RESTful behavior according to the FHIR specification.\n3. Return the following response classes:\n   - (Status 400): invalid parameter\n   - (Status 401/4xx): unauthorized request\n   - (Status 403): insufficient scope\n   - (Status 404): unknown resource\n   - (Status 410): deleted resource.\n4. Support json source formats for all order-catalog interactions.\n5. Identify the order-catalog  profiles supported as part of the FHIR `meta.profile` attribute for each instance.\n6. Support the searchParameters on each profile  individually and in combination.\n\nThe Custodian of a catalog of medications **SHOULD**:\n\n1. Support xml source formats for all order-catalog interactions.\n2. support the Catalog profile of the Composition Resource in the core standard\n",
    "security" : {
      "description" : "1. A custodian **SHALL** reject any unauthorized requests by returning an HTTP 401 \"Unauthorized\", HTTP 403 \"Forbidden\", or HTTP 404 \"Not Found\" ."
    },
    "resource" : [{
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
        "valueCode" : "SHALL"
      }],
      "type" : "MedicationKnowledge",
      "supportedProfile" : ["http://hl7.org/fhir/uv/order-catalog/StructureDefinition/DrugKnowledge"],
      "interaction" : [{
        "extension" : [{
          "url" : "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode" : "SHALL"
        }],
        "code" : "search-type"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode" : "SHALL"
        }],
        "code" : "read"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode" : "SHOULD"
        }],
        "code" : "vread"
      }],
      "referencePolicy" : ["enforced"],
      "searchInclude" : ["iterate=*"],
      "searchParam" : [{
        "extension" : [{
          "url" : "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode" : "SHALL"
        }],
        "name" : "_id",
        "type" : "token",
        "documentation" : "http://hl7.org/fhir/2022Sep/search.html#id"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode" : "SHALL"
        }],
        "name" : "_lastUpdated",
        "type" : "date",
        "documentation" : "http://hl7.org/fhir/2022Sep/search.html#lastUpdated"
      }]
    }]
  }]
}

```
