International Patient Summary Implementation Guide
2.0.0 - STU 2

International Patient Summary Implementation Guide, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 2.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-ips/ and changes regularly. See the Directory of published versions

## Changes

Page standards status: Informative

### STU 2.0.0 Final Publication

This change list provides an overview and detail of changes from the STU 2.0 Ballot to the final publication. For details on the 2.0 IPS publication changes from 1.1, refer to the ballot changes in the next section.

- Non-compatible
  - Require Composition.section.code cardinality and add MS and obligations (FHIR-51231)
  - Restrict MedicationRequest.doNotPerform (FHIR-51483 & FHIR-47263)
- Compatible, Substantive Changes
  - Loosen Social History Smoking Status & Valueset Binding (FHIR-40804 )
  - Add guidance on national adaptations to IPS (FHIR-40839)
  - Apply obligations on IPS CodeableConcept (FHIR-42873 & FHIR-51233)
  - Provide guidance on text linking using new extension (FHIR-43316)
  - Redefine MustSupport by adding obligations (FHIR-44963)
  - Redefine narrative description of Must Support to align with future use of obligations (FHIR-46499 )
  - Add MustSupport to Composition.section(s).emptyReason (FHIR-47195 and FHIR-47261)
  - IPS Server Capability Statement: missing list of resource types (FHIR-47312)
  - Add producer actor with server capability (FHIR-47320)
  - Dosage route terminology binding is not SNOMED-CT (FHIR-47325)
  - Medication form terminology binding is not SNOMED-CT (FHIR-47327) Include Must Support obligations on the resource profiles (FHIR-47511)
  - IPS should include Gender Harmony defined elements, specifically Gender Identity (FHIR-47779)
  - IPS should include exchange of Pronouns (FHIR-47780)
  - IPS should provide clear guidance on exchange of Name To Use (FHIR-47781) add address and telecom elements to OrganizationIPS with mustSupport/obligation (FHIR-47929)
  - Include Results with a pending status in the IPS (FHIR-48336)
  - Relax DiagnosticReport.category constraints (FHIR-49901) section-note: relax max cardinality to * (FHIR-50271)
  - Remove MustSupport/obligations from Composition.section[results] DiagnosticReport (FHIR-50366)
  - Consolidate entry slice for MedicationRequest/MedicationStatement (FHIR-50367)
  - Use SHALL:populate for required sections , SHOULD:populate-if-known for recommended sections (FHIR-50368) Remove display obligations for Bundle profile items marked with MustSupport (FHIR-50370)
  - Remove uneeded IPS datatypes (FHIR-50888 & FHIR-51260 & FHIR-51235)
  - IPS will not align to MustSupport/Obligations from IPA (FHIR-51065)
  - Flag AllergyIntolerance clinicalStatus as MS with obligations (FHIR-51103)
  - Allow ImmunizationRecommendation in plan of care section (FHIR-51141)
  - Remove CodingIps.display MS to avoid cross border language validation issues (FHIR-51232)
  - Device profile should not have constraints on patient element (FHIR-51239)
  - Remove use of CodableConceptIps profile on elements that are not MS (FHIR-51257)
  - Reconsider Extensible bindings for Observation (Radiology) and ImagingStudy (FHIR-51463)
- Non-substantive Changes
  - Discuss relationship of IPA-IPS (FHIR-39889 & FHIR-47523)
  - The IPS should include a section about identifier usage (FHIR-41259)
  - Code "165747007" with display of "RhD Positive" omitted from value set (FHIR-42695)
  - Improve examples throughout guide (FHIR-42702 & FHIR-47293 & FHIR-47414 & FHIR-47936 )
  - Reference to Medication in Medications section should be clarified (FHIR-42937)
  - There should be a section about narrative (FHIR-43317)
  - Allow not only UCUM as code system for units (FHIR-44765)
  - Clarify IPS $summary operation parameters (FHIR-45949)
  - Add logical model / mapping to IPS (FHIR-46083 & FHIR-47527)
  - Update healthcare professionals value set definition (FHIR-46623)
  - Typo in Design Conventions (FHIR-46679 & FHIR-47912)
  - Relax IPS Medication Template (FHIR-47025)
  - Discuss alignment to FHIR Clinical Documents profile (FHIR-47189 & FHIR-47514)
  - Remove wording of condition from allergies or intolerances (FHIR-47260)
  - Update count of sections in multiple places (FHIR-47268)
  - Remove undefined acronyms (FHIR-47274)
  - CapabilityStatement should be accessible from FHIR Artefacts drop down (FHIR-47310)
  - IPS Server Capability Statement: missing supported Observation profiles (FHIR-47311)
  - IPS Server Capability Statement: resource conformance should match The “IPS” (FHIR-47313)
  - Break out new sections for Must Support & Obligations and Empty Sections (FHIR-47315)
  - Clarify guidance on representation of person names (FHIR-47316)
  - Condition and Procedure profiled bodySite binding is too weak (FHIR-47328)
  - Link to external page on process of document generation (FHIR-47346)
  - Wording improvements to Home page (FHIR-47488)
  - Usage of quotation marks consistency (FHIR-47491)
  - Introduction in Datatypes page (FHIR-47500)
  - Use SHALL rather than "must" (FHIR-47507 & FHIR-47512)
  - Bold select text (FHIR-47519)
  - Add .meta.version obligation to Compostion (FHIR-47521)
  - Improve link to IHE Sharing of IPS (FHIR-47522)
  - Sections of page to follow the same name of the picture (FHIR-47524)
  - Plain Language Summary about HL7 and this Guide to the Home Page. (FHIR-47564)
  - Should support UDI for all Devices listed in Device List (FHIR-47601)
  - IPS should include Sex Parameter for Clinical Use (SPCU) (FHIR-47782)
  - Addition of change log (FHIR-47854)
  - Adjust title of IPS and Its Structure (FHIR-47913)
  - Adjust title/description of some profiles (FHIR-47915)
  - Remove "summary" wording from pregnancy profile (FHIR-47916)
  - Adjust title of examples for consistency (FHIR-47923)
  - Add better description for Composition.title (FHIR-47926)
  - Move the "IG analysis" sub-sections from the Home page to another location (FHIR-48290)
  - Clarify that $summary may also be GET (FHIR-48351)
  - Results Laboratory/Pathology Observation - IPS ValueSet CLD incorrect (FHIR-48662)
  - Add provenance narrative for patient generated and for multi-source (FHIR-48878)
  - Clarify scope and role of IPS (FHIR-48880)
  - Typo in CapabilityStatement (FHIR-49006)
  - Clarify problem list vs. past problems section (FHIR-49213)
  - Move MustSupport/obligations from onset[x] or effective[x] to relevant timing datatype across profiles (FHIR-50369)
  - Rename AllergyIntolerance valueset (FHIR-50371)
  - Add context that IPS is informative not actionable (FHIR-50832)
  - Add a narrative section on patient safety (FHIR-50833)
  - Explicit modelling of DAR missing on required data elements with Must Support/Obligations (FHIR-50862) Add IPS Patient and Composition obligations of SHALL:populate (FHIR-50890)
  - Remove Bundle.entry MustSupport and Obligations (FHIR-51027)
  - Patient Story section - additional context requested (FHIR-51059)
  - Procedure performedDateTime and Immunization occurrenceDateTime obligations SHOULD:able-to-populate (FHIR-51114)
  - Remove MS and obligations from Bundle.entry and add MS and able-to-populate and handle obligations to entry:composition (FHIR-51136)
  - Remove display obligations from composition technical elements (FHIR-51258)
  - Promote obligations of Composition section all slices elements to SHALL:populate (FHIR-51259)
  - Change IPS Actor title from Producer to Creator (FHIR-51417)
  - Clarify patient name guidance for alphabetic representation and family name (FHIR-51419)
  - Place all "Considered for Future Use" Issues on "Known Issues and Future Development Page" (FHIR-51514)
  - Typo when referring to 'an Creator (IPS)' FHIR-51745
  - Typographic and word clarity corrections FHIR-51766
  - Typos and narrative consistency (Structure of IPS) FHIR-51774
  - Missing Resources in CapabilityStatement FHIR-51795
  - Adjustments to examples (Allergy and Procedure) FHIR-51797
  - Remove details on CDA IPS specification FHIR-51798
  - Add/adjust author names FHIR-51799
  - Backticks for path expressions FHIR-51851
  - Adjust results status label FHIR-51966
  - Correct CapabilityStatement-uv-ips operation definition for IPA $docref FHIR-51968
  - Various general principles pages grammar and typos FHIR-51971
  - Mandatory Composition elements obligation SHALL:populate FHIR-51972
  - Mandatory BundleUvIps elements obligation SHALL:populate FHIR-51973
  - MS on SpecimenUvIps type, subject and subject.reference FHIR-51974
  - Consistent use of normative verbs FHIR-52013

### STU 2.0.0-ballot Update

This change list provides an overview and detail of changes in STU 2.0 Ballot. The major categories of revision include:

- Sending "empty" sections allowed (no section.entry with use of emptyReason)
- Add Alerts Section
- Add Patient Story Section
- Clarifications on the $summary operation
- Rework of Observation profiles
- Updates for IPS-IPA Alignment
- Transition to SNOMED IPS Terminology and Terminology Consolidation

Detailed change list for 2.0.0-ballot since 1.1.0 includes:

- Non-compatible
  - AllergyIntolerance.code should have min cardinality of 1.. (FHIR-39530 )
  - Allow sections with emptyReason and no entries (FHIR-41529 )
  - Relax cardinality on composition.section.entries to allow for section.text to be used in isolate (FHIR-42872 )
  - Revision to absent-unknown valueset setup in IPS (FHIR-45004 )
  - Combine lab/path profiles and remove base results observation profile (FHIR-45294 )
- Compatible, Substantive Changes
  - Remove "Target Site - IPS" value set (FHIR-32809)
  - Modification profile input definition of $summary (FHIR-40240 )
  - Transition the absent-unknown codesystem to SNOMED valueset (FHIR-40456 )
  - Add a section for Patient commentary / Patient Story (FHIR-41260 )
  - Revise invariant ips-2 for Lab Observation (FHIR-41554 )
  - Remove old constraint for radiology Observation that requires valueString or component (FHIR-42870 )
  - Remove all required LOINC bindings on observation value[x] elements (FHIR-42972 )
  - Relax cardinality on Condition.clinicalStatus - exception given Required ValueSet deficiency (FHIR-43299 ) remove invariant pat-cnt-2or3-char (Patient country code) (FHIR-43370 )
  - Remove Allergy Abatement Extension and use base extension (FHIR-44847 )
  - Resolve SNOMED Version challenge with value set (FHIR-44904 )
  - Remove IPS Bundle.link 0..0 constraint (FHIR-45973 )
  - Add Alerts section to IPS based on ISO 27269 (FHIR-46289 )
  - Consolidate SNOMED terminology valuesets and make definitions consistent (FHIR-46365 )
  - Remove Media profile (FHIR-46401 )
  - Add reference to new FHIR Clinical Documents profile (FHIR-46458 )
  - Reinstate revised ResultsSpecimenCollectionMethodUvIps value set (FHIR-46500 )
  - Reinstate revised ResultsSpecimenCollectionMethodUvIps value set (FHIR-46500)
  - Add additional status codes to Result Observation (FHIR-46502 )
- Non-substantive Changes
  - Composition-uv-ips profile, changes to clinicaldocument profile reference (FHIR-15995 )
  - Distinct tabs for Differential View, Snapshot View and Examples (FHIR-16149 )
  - Profiles used in the entries are not always made explicit (FHIR-16159 )
  - Add links for downloading this guide and the specified resources (FHIR-16160 )
  - Rename the observation-uv-ips profile (FHIR-16281 )
  - Clarify intended use of vital signs (FHIR-37837 )
  - Addition of change log to IG (FHIR-39449 )
  - Improve details of IPS Generation and Data Inclusion (FHIR-39598 )
  - Remove graph parameter from $summary operation (FHIR-40223 )
  - Text for 6.2.1 Medication Summary is no longer correct (FHIR-41556 )
  - Update $summary to update identifier param/provide guidance on supply of system (FHIR-43029 )
  - Display mismatch between value set and code system (FHIR-44806 )
  - Composition profile restrictions on codes can be improved (FHIR-45197 )
  - Modify Patient/$summary identifier definition to allow as a query param (FHIR-45441 )
  - Add guidance for minimal expectations of Composition.text (FHIR-45975 )
  - Fix example bundle reference errors ( FHIR-45979 )
  - Add pointer to note extension at Composition.section (FHIR-46084 )
  - Relax the valueset code binding in Radiology profile (FHIR-46286 )
  - Add section/narrative on data redaction/confidentiality/security (FHIR-46457 )
  - Remove ordinalValue extension from the current-smoking-status-uv-ips value set (FHIR-46471 )
  - Remove IPS ConceptMap instances (FHIR-46474 )
  - Narrative updates - update STU notes, update images, update authors, design and other narrative updates (FHIR-46488 )
  - Consider changing example instances to follow best practice for UCUM and avoid using curly braces (FHIR-46501 )

### STU 1.1.0 Update

This change list provides an overview and detail of changes in STU 1.1. This publication is an unballoted STU 1.1 update which incorporates implementation feedback, terminology updates and publication cleanup. The major categories of revision include:

- Addition of Bundle Profile
- Addition of MedicationRequest Profile
- Addition of a $summary operation (Github Branch: https://github.com/HL7/fhir-ips/pull/17)
- Reduction of Must Support (Github Branch: https://github.com/HL7/fhir-ips/pull/22)
- Additional narrative guidance (Github Branch: https://github.com/HL7/fhir-ips/pull/27)
- Terminology Updates (Github Branch: https://github.com/HL7/fhir-ips/pull/30)
- Publication clean-up (Github Branch: https://github.com/HL7/fhir-ips/pull/23 and commits in Sept/Oct 2022)

Detailed change list for 1.1.0 since 1.0.0 includes:

- Compatible, Substantive Changes
  - Condition.category shouldn't be fixed to a particular code (FHIR-23740)
  - Remove unneeded PractitionerRole.code slice and replace with preferred binding. (FHIR-39310)
  - Remove unneeded profile elements from DeviceUseStatement.bodySite (FHIR-39296)
  - Update SNOMED CT based value set definitions and add an extensionally-defined value set from the IPS free set as an additional binding (FHIR-37834)
  - Revise the invariant for the patient name (FHIR-31558)
  - Patient.contact relationship bound to v2 values (extensible in R4) but v3 values in IPS (FHIR-34817)
  - IPS Practitioner Role ValueSet missing WHO/ISCO codes (FHIR-32156)
  - ResultsSpecimenCollectionMethodGpsUvIps ValueSet identical to FHIR Core ValueSet (FHIR-32814)
  - Clarify Target Site - IPS value set (FHIR-32809)
  - Update and rename microorganism value set due to inactivation of SNOMED Microorganism concept (FHIR-26548)
  - DiagnosticReport: refer patient and specimen ips profiles (FHIR-26665)
  - Observation Performer : relax constraints (FHIR-26668)
  - IPS binding on Patient.contact does not allow specifying an emergency contact (FHIR-29963)
  - Must Support should require population if known (FHIR-30077)
  - Align the performer cardinality to the base resource (FHIR-31049)
  - Change the cardinality of the gender (FHIR-31557)
  - Allow for ingredient.itemReference in the Medication resource (FHIR-31561)
  - Make Patient contact relationship binding extensible (FHIR-32131)
  - Personal Relationship ValueSet missing important relationships (FHIR-32813)
  - First element is value set for https://build.fhir.org/ig/HL7/fhir-ips/ValueSet-allergy-reaction-gps-uv-ips.html is for 1985009 Vomitus (substance) and it should be 422400008 Vomiting (disorder) (FHIR-34018)
  - 0..1 constraint on protocolApplied.targetedDisease too strict (FHIR-34030)
  - Replace terminology slices with a base "preferred" binding and "additional binding" extensions. (FHIR-37833)
  - Add missing extension sliceName elements and adjust ids for data-absent-reason extension slices (FHIR-37855)
  - Comprehensive Review of Must Support (FHIR-38622)
  - Addition of Medication Request Profile (FHIR-38624)
  - Addition of Bundle profile (FHIR-38625)
  - Addition of $summary operation (FHIR-38626)
  - Slicing on Immunization.protocolApplied.targetDisease to strict? (FHIR-35876)
  - Wrong SNOMED code for vomiting in value set allergy reaction (code from wrong semantic hierarchy) (FHIR-34319)
  - ips-1 constraint should only apply to Observation.effectiveDateTime (FHIR-25473)
- Non-substantive Changes
  - Composition.subject is 0..1 (FHIR-33984)
  - Add Maturity level (FMM) and Standards status for the IG (FHIR-39315)
  - Update the system value for the Belgian CNK code system to the URL (instead of the OID, which is likely unreliable), and update the display string. (FHIR-39313)
  - Fix allergy-intolerance-uv-ips value set name and title (FHIR-39299)
  - Remove code system fragments used only in examples (FHIR-39295)
  - Typo on IPS Structure Page (FHIR-39292)
  - Missing MedicationRequest example from examples page (FHIR-39291)
  - Add ip-statements, cross-version-analysis, dependency-table and globals-table fragments to IG index page. (FHIR-39281)
  - Add R4 and R4B specific packages to Downloads page (FHIR-39284)
  - Change list xhtml fragments to 'list-simple-name-' for alphabetical ordering (FHIR-39283)
  - Add Composition profile example (FHIR-39272)
  - Remove commented out code from example (FHIR-39263)
  - Remove declaration of 'global' profiles from IG resource (FHIR-39097)
  - Modify profile and value set titles to allow proper Jira spec file generation. (FHIR-38996)
  - Fix broken links caused by ConceptMaps (FHIR-38945)
  - Remove extra Immunization examples added for testing (FHIR-38944)
  - Fix incorrect ICD-11-MMS code system url (FHIR-38916)
  - Remove incorrect and unneeded structuredefinition-display-hint extensions (FHIR-38915)
  - Remove unneeded DICOM ImagingStudy value sets and ICD-11-MMS and ICD-O-3 code systems (FHIR-38914)
  - Add missing 'experimental' elements (FHIR-38913)
  - Update IG to version 1.1.0 (FHIR-38910)
  - Patient.birthDate should have min cardinality of 0 (FHIR-35092)
  - Update Licence Note for Value Sets based on SNOMED GPS (FHIR-25207)
  - Fix additional-binding publisher (FHIR-38847)
  - Update IG to the new template framework (FHIR-26834)
  - Fix incorrect Observation.specimen type constraints (FHIR-27799)
  - Should mention joint work with IHE on transport (FHIR-30076)
  - please specify how to use doc-ref to access an IPS document (FHIR-34123)
  - Remove CodeableConcept.text comment (FHIR-34824)
  - What does it mean to support Coding.display.translation (FHIR-36672)
  - Broken link in section 1.2 (FHIR-35112)
  - Apparent contradiction in IPS Medication example (FHIR-32902)
  - Section 1.2 Project Background broken link (FHIR-31396)