Skip to content

Instantly share code, notes, and snippets.

@lucax88x
Created April 14, 2026 07:17
Show Gist options
  • Select an option

  • Save lucax88x/c2ffc395068c2cd5e68f48baad521cad to your computer and use it in GitHub Desktop.

Select an option

Save lucax88x/c2ffc395068c2cd5e68f48baad521cad to your computer and use it in GitHub Desktop.

In an ITI-57 Update Document Set transaction, only a restricted set of DocumentEntry attributes may be modified. Everything else is immutable.

Modifiable Attributes

┌────────────────────────────┬──────────────────────────────────────────────────────────────┐ │ Attribute │ ebXML Representation │ ├────────────────────────────┼──────────────────────────────────────────────────────────────┤ │ TypeCode │ Classification urn:uuid:f0306f51-975f-434e-a61c-c59651d33983 │ ├────────────────────────────┼──────────────────────────────────────────────────────────────┤ │ ClassCode │ Classification urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a │ ├────────────────────────────┼──────────────────────────────────────────────────────────────┤ │ ConfidentialityCode │ Classification urn:uuid:f4f85eac-e6cb-4883-b524-f2705394840f │ ├────────────────────────────┼──────────────────────────────────────────────────────────────┤ │ PracticeSettingCode │ Classification urn:uuid:cccf5598-8b07-4b77-a05e-ae952c785ead │ ├────────────────────────────┼──────────────────────────────────────────────────────────────┤ │ HealthcareFacilityTypeCode │ Classification urn:uuid:f33fb8ac-18af-42cc-ae0e-ed0b4e84f3ac │ ├────────────────────────────┼──────────────────────────────────────────────────────────────┤ │ LegalAuthenticator │ Slot legalAuthenticator │ ├────────────────────────────┼──────────────────────────────────────────────────────────────┤ │ Comments │ Slot comments │ └────────────────────────────┴──────────────────────────────────────────────────────────────┘

Immutable Attributes (SHALL NOT be changed)

┌────────────────────────────────┬───────────────────────────────────────────────────────┐ │ Attribute │ Reason │ ├────────────────────────────────┼───────────────────────────────────────────────────────┤ │ id (document UUID in registry) │ Primary key of the registry entry │ ├────────────────────────────────┼───────────────────────────────────────────────────────┤ │ uniqueId (ExternalIdentifier) │ Document identity — cannot change once assigned │ ├────────────────────────────────┼───────────────────────────────────────────────────────┤ │ patientId (ExternalIdentifier) │ Patient linkage (EPR-SPID binding) │ ├────────────────────────────────┼───────────────────────────────────────────────────────┤ │ repositoryUniqueId (Slot) │ Repository location of the binary │ ├────────────────────────────────┼───────────────────────────────────────────────────────┤ │ hash (Slot) │ Content integrity — tied to the unchanged binary │ ├────────────────────────────────┼───────────────────────────────────────────────────────┤ │ size (Slot) │ Content integrity — tied to the unchanged binary │ ├────────────────────────────────┼───────────────────────────────────────────────────────┤ │ mimeType (attribute) │ Content type of the document binary │ ├────────────────────────────────┼───────────────────────────────────────────────────────┤ │ creationTime (Slot) │ Provenance — when the document was originally created │ └────────────────────────────────┴───────────────────────────────────────────────────────┘

Important: The immutable ExternalIdentifiers (uniqueId, patientId) must still be present in the update request with their original values unchanged — omitting them is not allowed. Attempting to change any immutable attribute results in an UnmodifiableMetadataError. All updated code values must conform to the EPDV-EDI Annex 3 Swiss EPR value sets.

The FHIR equivalent of this operation is CH:MHD-1 (Update Document Metadata), which uses a PUT on DocumentReference/{id}.

-> [[iti-57]], [[ch-mhd-1]], [[rmu-supplement]]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment