> ## Documentation Index
> Fetch the complete documentation index at: https://portaldocs.peartelco.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Best Practice Integration

> Connect Bp Premier to the Pear Portal: what you need, how to approve Pear in Best Practice, and what to send to Pear Support

## Overview

The Pear Portal can connect to your practice's Bp Premier database. Once connected, features such as [filing faxes to Best Practice](https://portaldocs.peartelco.app/messaging/fax-best-practice.md) work straight from the portal, with no downloading and re-uploading.

Setting up the connection takes about five minutes in Bp Premier, followed by one email to Pear Support. You approve Pear inside Bp Premier, Bp Premier gives you a **Site ID** and a **Pairing Code**, and you send those two values to us. We do the rest.

## Before you start

* **A supported version of Bp Premier.** You need **Bp Premier Spectra SP1 Revision 3 (build 1.13.1.1096)** or later. The latest version is **Bp Premier Oxford SP1 (build 1.14.1.1129)**.
* **The October 2026 Data Update.** This must be installed as well as the software update. It is what adds Pear Australia (via Halo Connect) to the list of integrations in Bp Premier.
* **Access to Bp Premier configuration.** You need to be able to open **Setup > Configuration** in Bp Premier. This is usually the practice manager or your IT provider.

If you need to update Bp Premier or install the data update, both are available from the [Best Practice downloads page](https://bestpracticesoftware.com/bp-prem-downloads/).

## Check your Bp Premier version

1. Open Bp Premier.
2. Go to **Help > About Bp Premier**.
3. Check the **Version** and **Build No**. The build number must be **1.13.1.1096** or higher.
4. Check **Last drug update**. It must show **October 2026** or later.
5. Click **Close**.

![About Bp Premier window showing Version: Oxford SP1 Edition, Build No 1.14.1.1129, and Last drug update: October 2026](https://mintcdn.com/pearaustralia/RVQXCo7uSCUDzu3z/images/bp-integration-about.png?fit=max\&auto=format\&n=RVQXCo7uSCUDzu3z\&q=85\&s=7488435c80068ff4fa6eca18ee95a31d)

If either value is older than this, update Bp Premier first using the [Best Practice downloads page](https://bestpracticesoftware.com/bp-prem-downloads/), then come back to this guide.

## Approve Pear in Bp Premier

These steps follow Best Practice's own guide, [Approve a third-party integration](https://kb.bpsoftware.net/bppremier/Spectra/Integrations/DatabaseIntegration/ApproveThirdPartyIntegration.htm).

1. From the main Bp Premier screen, go to **Setup > Configuration**.
2. In the left menu of the Configuration window, click **Database**.
3. Click **Setup third party integrations**.
4. In the **Search for** box, type `pear`.
5. Tick **Pear Australia (via Halo Connect)**.

![Setup third party integrations window with pear in the search box, Pear Australia (via Halo Connect) ticked, and the Generate pairing code button highlighted](https://mintcdn.com/pearaustralia/RVQXCo7uSCUDzu3z/images/bp-integration-select-pear.png?fit=max\&auto=format\&n=RVQXCo7uSCUDzu3z\&q=85\&s=8cd1b98e4eb794aff0bd85fad477056a)

> [!WARNING]
>
> The provider you must tick is **Pear Australia (via Halo Connect)**. Check the name carefully before you continue.

6. Bp Premier asks **Would you like to enable Pear Australia (via Halo Connect) and allow integration to the Bp Premier Database?** Click **Yes**.

![Enable Pear Australia (via Halo Connect) confirmation box with the Yes button highlighted](https://mintcdn.com/pearaustralia/RVQXCo7uSCUDzu3z/images/bp-integration-enable-confirm.png?fit=max\&auto=format\&n=RVQXCo7uSCUDzu3z\&q=85\&s=57b57d1150e6645f941aa1864ed2c1fc)

7. With **Pear Australia (via Halo Connect)** still selected, click **Generate pairing code**.
8. The **Pairing Code** window opens, showing your **Site ID**, **Pairing Code** and **Expiry**. Leave this window open while you complete the next section.

![Pairing Code window showing the Site ID, Pairing Code and Expiry fields, each with a Copy button highlighted](https://mintcdn.com/pearaustralia/RVQXCo7uSCUDzu3z/images/bp-integration-pairing-code.png?fit=max\&auto=format\&n=RVQXCo7uSCUDzu3z\&q=85\&s=eaadd63dc25d93cb35354bc70636e91a)

## Send your Site ID and Pairing Code to Pear Support

Pear needs both values to finish connecting your practice. Without them, we cannot complete the setup.

1. In the **Pairing Code** window, click **Copy** next to **Site ID** and paste it into your message.
2. Click **Copy** next to **Pairing Code** and paste it into the same message.
3. Send it to Pear Support in either of these ways:
   * Email [support@peartelco.com.au](mailto:support@peartelco.com.au)
   * Create a new support ticket at [portal.peartelco.app/support](https://portal.peartelco.app/support)
4. Back in Bp Premier, click **Close** on the Pairing Code window, then **Close** on the third party integrations window, then **Save** in the Configuration window.

> [!NOTE]
>
> You **must** include both the **Site ID** and the **Pairing Code** in your email or ticket. Copying them with the **Copy** buttons avoids typing mistakes, since a single wrong character stops the pairing from working.

A message like this is all we need:

```text theme={null}
Subject: Best Practice integration for [your practice name]

Hi Pear Support,

We have enabled Pear Australia (via Halo Connect) in Bp Premier.

Practice name: [your practice name]
Site ID: [paste Site ID]
Pairing Code: [paste Pairing Code]

Thanks,
[your name and phone number]
```

We will let you know as soon as the connection is live.

## Frequently asked questions

**What if my pairing code expires before Pear uses it?**

Pairing codes are only valid until the date and time shown in **Expiry**. If yours runs out, go back to **Setup > Configuration > Database > Setup third party integrations**, select **Pear Australia (via Halo Connect)**, click **Generate pairing code** again, and send us the new code.

**I can't find Pear Australia (via Halo Connect) in the list.**

Check that you typed `pear` in the **Search for** box. If it still doesn't appear, the October 2026 Data Update has not been installed. Pear Australia (via Halo Connect) is added to the list by that data update. Check **Last drug update** using the steps in [Check your Bp Premier version](#check-your-bp-premier-version), and install the data update from the [Best Practice downloads page](https://bestpracticesoftware.com/bp-prem-downloads/) if needed.

**Do I need to do this on every computer in the practice?**

No. Approving Pear is a practice-wide setting in your Bp Premier database, so it only needs to be done once.

**Is the Site ID a secret?**

The Site ID on its own is not, but the Pairing Code is what allows Pear to connect to your Bp Premier data. Only send it to Pear Support using the email address or support page above, and don't share it anywhere else.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.