HL7 and FHIR are how hospitals and other clinical systems exchange records. ClinyPal exports and imports both for the sources that have a standard mapping; this is which ones.
When to use them
CSV is right for a spreadsheet or an accountant. HL7 v2 and FHIR are the formats other clinical systems, hospitals and health networks read, so an export in one of them can be loaded into the new system without re-keying, and a file from another system can be imported into ClinyPal the same way. Both are chosen as the Format on the Data Exports and Data Imports pages.
What each source supports
| Data source | CSV | HL7 v2 | FHIR |
|---|---|---|---|
| Patients | Yes | Yes: one ADT A28 message per patient | Yes: Patient |
| Contacts | Yes | No | Yes: RelatedPerson |
| Appointments | Yes | Yes: one SIU S12 message per appointment | Yes: Appointment |
| Invoices | Yes | No | Yes: Invoice |
| Payments | Yes | No | Yes: PaymentReconciliation |
| Cases | Yes | No | Yes: EpisodeOfCare |
| Body Charts, Patient Files | ZIP with manifest | No | Yes: DocumentReference with a download link |
| Expenses, Products, Services, invoice details, credit notes | Yes | No | No |
A patient export with HL7 v2 chosen; for Invoices the format list offers only CSV and FHIR.
Not every source has an HL7 or FHIR mapping. Only the rows marked Yes in the table can be exported in those formats; the rest are CSV only.
Details worth knowing
- HL7 messages are version 2.5, sent as ClinyPal, with a control ID built from the record's ClinyPal number. Appointment times are written in the location's time zone.
- A FHIR export is one Bundle holding the resources, with the clinic as Organization and practitioners as Practitioner. A FHIR Questionnaire file from another system can be imported as a patient form template; forms built in ClinyPal aren't exported as Questionnaires.
- Importing HL7 or FHIR follows the same three steps as CSV; the mapping step matches the message or resource fields instead of columns.
- A system that needs a profile ClinyPal doesn't produce, such as a national extension, will need the file adjusted; support can tell you what's in the file.