Bulk create patient records

As a team coordinator, as an initial onboarding step, you might want to create multiple patients records in one go. The ‘Add many patients’ feature allows you to upload a CSV file with a list of patients. PKB will then create records for all patients and carers and add them to your team.

How do I create the CSV file to upload?

Do not change the layout or remove the header row or the upload will fail

Add one row per patient. All cells should be text - if you have identifiers beginning with 0 please ensure the cells in these columns are not being treated numerically as the 0 will automatically be removed. Make sure to save as a CSV file e.g. not Excel format. CSV files will have a file extension of .csv whereas excel files normally have a file extension of .xlsx

Please also perform a data cleanse to account for special characters that could throw off standard CSV parsing such as , " '.

Include up to 200,000 patients in each file. You can upload at any time of day, and you do not have to wait for one upload to finish before starting the next one. Let PKB support know if you are planning a large upload so we can avoid system downtime during your upload.

Mandatory columns:

First name

Last name

and at least one type of id: National Identifier, Organisation Identifier, Team Identifier

Optional columns:

Demographic details

Title - patient's title e.g. Mr

E-mail - e-mail address of the patient. If provided an invitation to register will be sent to the patient.

DoB (DD, MM, YYYY ) e.g. 21, 04, 1999 - recommended

Address1 - first line of the postal address

Address2 - second line of the postal address

City

State/Province/County

Post code

Carer1 first name

Carer1 last name

Carer1 E-mail - an email address of a carer of the patient. If provided an invitation to register will be sent to the carer. <XX: are all 3 of these carer fields not mandatory if a carer is to be added?)

Carer2 first name

Carer2 last name

Carer2 E-mail - If provided an invitation to register will be sent to the carer.

How do I start the upload?

Select the privacy labels that your team requires access to provide care for these patients (your team’s default access will be pre-selected). Click on ‘Register patients’ button to start the patient creation.

If you get an error indicating that the file format is incorrect (see example below), please check you are using the correct template supplied, and that neither the format (CSV) or the header has been modified in any way. Click 'Cancel' and start the upload process again.

How can I monitor the progress of the upload?

Once the upload has begun you will see an entry on the 'Reports' sub tab. When the upload completes you will receive an email notification and the entry on the 'Reports' tab will have a download link.

You can download the report to see detailed status of each patient record. It will contain your original data with three additional columns showing whether the patient on each row (and carers if included) have been successfully invited/created, with supporting information where relevant.

Success - <Existing patient added to your team> - this patient record already existed in your organisation, the patient has been added to your team.

Success - <Existing patient has been invited to share records with your team> - this patient record already existed outside your organisation. They have been sent an invitation to your team and will be added once they acknowledge.

Failure - <Details: This account belongs to existing user XXXXX with Dob XXXX-XX-XX> - patient record exists with this National Identifier or Organisation ID and has no email address added

Failure - <Must have at least one type of id (national, org level or team level id)> You must provide an ID for this patient.

Failure - <Unable to invite patient as existing account without email - Please contact St Elsewhere Hospital for access>. A patient record exists in another organisation but there is no email added for this record. For more details and how to action this see Patient records created in another organisation

Unable to invite carer 'bill.individual@pkbtest.com': Unexpected error happened: email bill.individual@pkbtest.com is associated with multiple persons! - This email address is already in use by a PKB user. The patient account will be created but the carer will not be added to this patient record.

What is sent to the patient when their account is created?

When your patients have had their accounts successfully created via the CSV upload, PKB will send an email to them to ask them to complete registration.

Which email is sent to them depends on whether they already had an existing record, or belonged to another team within your organisation etc, but we have added some examples below.

Scenario 1 - Patient record created successfully and added to your team

If the patient does not already have a PKB record, we create one for them and send the following email:

Scenario 2 - Patient already has a PKB record and is already in your team

If the patient is already part of your team, we will resend the invitation email (if they have not completed registration). If the patient has registered, we will not send any additional email.

Scenario 3 - the patient record already existed in your organisation and has now been added to your team

If the patient already has a PKB record, and that record already existed in your organisation we send the following email:

Scenario 4 - the patient already has a PKB record but it is outside of your organisation

The email template differs depending on which privacy labels have been requested for access. If you have requested no privacy labels the email will read:

If you have requested some privacy labels, the email will be slightly different. For example, if you request general and mental health, the email will read: