Integrations & data · Practice guide

Preserve the document version a team has accepted

Illustrative situation

An integration sends a revised file and silently replaces the version another team already reviewed. Replacing a document can erase the context of an earlier review if versions are not distinguished. The receiving team should know whether it is seeing the accepted file or new material that needs attention.

Healthcare booking calendars on two connected screens with blue and orange appointment cards.
Make the handover between tools clear for the team using them.

What this means for your practice

Agree how versions are identified and when a receiving record should reference a new version. Preserve enough history to explain what was reviewed or acted upon.

An example to discuss with your team

Transfer a revised fictional file after the first version was accepted.

Healthcare data integration connecting two applications through a field-mapping board.
Agree what each field means and which system owns it.
Healthcare data validation separating matched records from an exception tray.
Make rejected or uncertain records visible for review.

Questions to take to your supplier

Send a revised fictional file after the first version has been accepted. Can staff identify both versions and the one the earlier decision used? Agree when the new version replaces a working reference and whether approval needs to be repeated.

Agree the working process

Decide how the business distinguishes a replacement, a new version and a correction. Different document types may need different handling, especially where an earlier version supported an approval or administrative decision. The responsible team should set those rules and the supplier should demonstrate how the receiving record shows them. Use a fictional document that has already been reviewed, then send a revision with a meaningful change. Can staff identify what was accepted earlier and what now needs attention?

Agree which version is linked from the current working view and whether earlier material remains available under the organisation's retention decisions. Keep document identity separate from a filename that somebody may edit casually. Ask what happens if revisions arrive out of order or the same version is sent twice. The goal is a history colleagues can explain without technical reconstruction. A newer arrival should not silently erase the basis of an earlier decision or make an unreviewed change appear approved.

How to check the result

Count unexplained document replacements.

Turn reading into a next step

Your action checklist

Work through these checks with your team or supplier. Tick the ones you have resolved and leave unknowns open.

Checks to discuss

Record what you know, what is still missing and the answer you need from your team or supplier.

Use project decisions only, without personal, patient or confidential details. Entries stay in this page and are not submitted to Kay & Co. Copy or download before leaving; this page does not save your notes.

Further reading

These sources provide background for the topic. The practice examples and checklist are illustrative planning suggestions from Kay & Co.

Related guides

Need help with this?

Tell us what is getting in the way. Kay & Co. can help you understand the options and turn the next step into something that works for your practice.

Explore integrations & data services or discuss your project.

Try the free Healthcare Digital Planner to find your starting priority.