1. Overview

This article describes how to safely uninstall the PS Finance APIs extension from a Business Central environment, upgrade that environment to version 28 (v28), and then deploy the replacement, PS APIs PTE. Following these steps in the correct order prevents dependency conflicts and ensures the new PTE installs cleanly.

2. Prerequisites

Before beginning, confirm the following:

• You have Business Central Admin Center access (either as a delegated admin or an internal admin with the correct role).
• You have the PS APIs PTE .app file attached at the bottom of this article.
• All users have been notified of the planned maintenance window — the environment will be unavailable during the upgrade.
  
  

3. Step 1 — Uninstall PS Finance APIs

Follow these steps to remove the PS Finance APIs extension from the Business Central environment.

3.1 Open Extension Management

1. Sign in to Business Central as an administrator.
2. Use the search bar and type Extension Management, then open the page.

3.2 Locate PS Finance APIs

1. In the Extension Management list, find PS Finance APIs.
2. Confirm the publisher is Sparkrock to ensure you are uninstalling the correct extension.
   
   

3.3 Uninstall the Extension

1. Select the row for PS Finance APIs, then choose Manage > Uninstall from the action bar.
2. In the Uninstall Extension dialog, leave the Delete extension data option disabled
3. Click Uninstall to confirm. The extension will be removed from the environment.
4. Verify the extension no longer appears in the Extension Management list, or that its status shows as Uninstalled.

4. Step 2 — Upgrade the Environment to v28

With PS Finance APIs removed, you can now upgrade the Business Central environment to version 28.

4.1 Access the Business Central Admin Center

1. Navigate to the Microsoft Dynamics 365 Business Central Admin Center at https://businesscentral.dynamics.com/<tenant>/admin.
2. In the left navigation, select Environments and click on the environment you want to upgrade.

4.2 Schedule or Initiate the Upgrade

1. On the environment details page, look for the Version section.
2. If v28 is available and the environment is not yet on it, click Schedule Update or Update Now, depending on your Admin Center version.
3. Select Version 28 from the available target versions.
4. Choose a maintenance window or select Update now if you are ready to proceed immediately.
5. Confirm by clicking Schedule or Update. The environment will enter an updating state.

4.3 Monitor the Upgrade

1. In the Admin Center, monitor the Operations log for the environment to track progress.
2. Wait until the environment status returns to Active and the version shows as v28 before continuing to Step 3.
3. If the upgrade fails, review the Operations log for error details.