Interoperability Toolkit
Core

Sending a CDA Document to Two Recipients

Scenario

The "Anytown General Hospital" needs to send an ITK Discharge Summary for the now completed in-patient stay for Mrs. Smith. Mrs. Smith has been discharged from the care of the Oncology team in the hospital. The Discharge Summary needs to be delivered to Mrs. Smith's General Practice "The Surgery, Townville", and in particular to her regular General Practitioner Dr. Brown. It is the hospital's practice to request both an infrastructure acknowledgement and business acknowledgement from GP practices to show that Discharge Summaries have been received into the GP practice system. The document is also sent to the hospital's off-site document repository. Some metadata about the ITK Discharge Summary is also sent.

Codes used in this example

  • Anytown General Hospital has an Organisation Data Service (ODS) code of "R59"
  • Anytown General Hospital's off-site document repository ODS site code "R592"
  • The Surgery, Townville has an ODS code of "Y88764"
  • Dr. Brown has a General Medical Council code of "G1234567"
  • Mrs. Smith's NHS Number is "2345678901"
  • The discharge summary interaction id is "urn:nhs-itk:interaction:primaryRecipienteDischargeInpatientDischargeSummaryDocument-v1-0"

Acknowledgement related handling specifications

  • urn:nhs-itk:ns:201005:infackrequested set to "true"
  • urn:nhs-itk:ns:201005:ackrequested set to "true"
  • urn:nhs-itk:ns:201005:busresponserequested set to "false"

Creating the distribution envelope for a CDA document transmission (with metadata) requiring an acknowledgement

The CDA document has been created by an author working for the Oncology team for Anytown General Hospital, it has been attested to, and is ready for transmission to Mrs. Smith's General Practice (in particular Dr. Brown). Metadata has also been generated for the document.

Completing the Distribution Envelope

A description of the Distribution Envelope elements and attributes can be found here

Name Notes Value
header    
   @Service As Anytown General Hospital is sending a transmission over ITK, they must choose an appropriate service under which to send the transmission. "SendCDADocument-v2-0" is the service that should be used to transmit CDA documents. urn:nhs-itk:services:201005:SendCDADocument-v2-0
   @trackingid A UUID for the transmission 7D6D9D40-AE1A-11DB-97F8-B18E1E0994BB
   addresslist    
      address    
         @type The default address type is used in this example, so this attribute is omitted Intentionally blank
         @uri The ITK compliant address of Mrs Smith's GP (GMC number of G1234567), to whom the CDA document is destined. urn:nhs-uk:addressing:ods:Y88764:G1234567
      address    
         @type The default address type is used in this example, so this attribute is omitted Intentionally blank
         @uri The ITK compliant address of the hospital's document repository urn:nhs-uk:addressing:ods:R592:DocRepository
   auditIdentity    
      id    
         @type The default address type is used in this example, so this attribute is omitted Intentionally blank
         @uri The address on the Oncology team working for Anytown General Hospital (ODS code R59), who originated the document urn:nhs-uk:identity:ods:R59:oncology
   manifest    
      @count A count of the manifests. 2
      manifestitem    
         @id The identifier of the metadata payload uuid_7D73B7C0-AE1A-11DB-982C-B18E1E0994FF
         @mimetype The mime type of the metadata document. text/xml
         @profileid As no profile is available for this document type, this attribute is omitted Intentionally blank
         @metadata As this is a metadata payload, this attribute is set to "true" true
         @compressed As this payload isn't compressed, this attribute is defaulted to false and omitted Intentionally blank
         @base64 As this payload isn't in base64, this attribute is defaulted to false and omitted Intentionally blank
         @encrypted As this payload isn't encrypted, this attribute is defaulted to false and omitted Intentionally blank
      manifestitem    
         @id The identifier of the CDA payload uuid_7D73B7C0-AE1A-11DB-982C-B18E1E0994AB
         @mimetype The mime type of the CDA document text/xml
         @profileid Profile for the discharge summary urn:nhs-en:profile:eDischargeInpatientDischargeSummary-v1-0
         @metadata As this isn't a metadata payload, this attribute is defaulted to false and omitted Intentionally blank
         @compressed As this payload isn't compressed, this attribute is defaulted to false and omitted Intentionally blank
         @base64 As this payload isn't in base64, this attribute is defaulted to false and omitted Intentionally blank
         @encrypted As this payload isn't encrypted, this attribute is defaulted to false and omitted Intentionally blank
   senderAddress    
      @type The default address type is used in this example, so this attribute is omitted Intentionally blank
      @uri The address on the Oncology team working for Anytown General Hospital (ODS code R59), who originated the document urn:nhs-uk:addressing:ods:R59:oncology
   handlingSpecifications Handling specifications are required to send a business acknowledgement and for the Discharge summary interaction  
      spec    
         @key Key for Infrastructure ACK to be returned urn:nhs-itk:ns:201005:infackrequested
         @value Value for the key is True true
      spec    
         @key Key for Business ACK to be returned urn:nhs-itk:ns:201005:ackrequested
         @value Value for the key is True true
      spec    
         @key Key for Business Response to be returned urn:nhs-itk:ns:201005:busresponserequested
         @value Value for the key is False false
      spec    
         @key Key for the interaction urn:nhs-itk:ns:201005:interaction
         @value Value for the key is the interaction id urn:nhs-itk:interaction:primaryRecipienteDischargeInpatientDischargeSummaryDocument-v1-0
   payloads    
      @count The number of payloads is 2 2
      payload    
         @id The locally assigned UUID for the metadata payload (matches the manifest.id describing this payload) uuid_7D73B7C0-AE1A-11DB-982C-B18E1E0994FF
         @filename As filename is used for payloads such as images, it is omitted. Intentionally blank
      payload    
         @id The locally assigned UUID for the CDA payload (matches the manifest.id describing this payload) uuid_7D73B7C0-AE1A-11DB-982C-B18E1E0994AB
         @filename As filename is used for payloads such as images, it is omitted. Intentionally blank

Distribution Envelope Instance

The XML instance is shown below.

Item
The XML file for sending to two recipients View