Healthcare integration guidance

Technical guides

Practical explanations for common HL7 v2, FHIR, CDA, XML security and certificate problems. Each guide uses synthetic examples and links to a browser-based tool where one is available.

9 practical guidesPrimary sourcesSynthetic examplesFree to read
Technical guidance only. Local implementation guides, trading-partner agreements and receiving-system rules still determine what a specific interface accepts.

HL7 v2 and transport

Message structure, acknowledgement behaviour and TCP framing.

10 min read · HL7 v2 and transport

HL7 ACK Codes Explained

Distinguish AA, AE, AR, CA, CE and CR, then trace acknowledgement errors through MSA and ERR.

Read guide

11 min read · HL7 v2 and transport

MLLP Framing Explained

Inspect VT, FS and CR framing, incomplete payloads, multiple messages and missing acknowledgements.

Read guide

10 min read · HL7 v2

HL7 v2 Delimiters and Escape Sequences

Understand MSH-1, MSH-2, non-default separators and escaped data that breaks field parsing.

Read guide

11 min read · HL7 v2

HL7 v2 Timestamps Explained

Check DTM precision, UTC offsets, daylight-saving behaviour and double-conversion errors.

Read guide

FHIR

Reference resolution, extensions and safe resource processing.

12 min read · FHIR

FHIR References Explained

Resolve relative, absolute, contained, logical and urn:uuid references safely in resources and Bundles.

Read guide

10 min read · FHIR

FHIR Extensions Explained

Process extension URLs, typed value[x] properties and modifierExtension without losing meaning.

Read guide

CDA and XML

Namespace-aware processing for CDA and clinical XML.

9 min read · CDA and XML

CDA XML Namespaces Explained

Diagnose XPath queries that return no CDA nodes because the default namespace was not mapped.

Read guide

PKI and XML security

Certificate chains, trust boundaries, canonicalisation and digest verification.

10 min read · PKI and XML security

PEM and X.509 Certificate Chains

Identify certificate blocks, order chains and separate trust, hostname and private-key checks.

Read guide

11 min read · PKI and XML security

XML Signature Digest Mismatch

Compare referenced XML, transforms and canonicalised bytes before changing keys or certificates.

Read guide