Summary
You're being migrated to Procurify's newer Dynamics 365 Business Central integration. This article covers what's changing, what stays the same, and the steps to take on both the Procurify and Business Central sides. The new integration runs on Merge and keeps the same accounts payable workflow you use today.
Prerequisites
Required Permissions: Access to Settings > Integrations in Procurify. This is usually limited to Procurify Admins (Superuser).
Business Central Access: A Business Central admin account that can see the company Procurify syncs with today. If you aren't an admin, have your admin available during the migration.
Before the migration starts: Record your current integration settings (see Step 1: Record your current settings below), and have your Business Central Tenant ID and environment name ready.
What’s staying the same
Syncing approved bills from Procurify to Business Central, with attachments
Syncing vendors and account codes from Business Central to Procurify
Pulling bill payment status from Business Central into Procurify
Auto Bill Sync
Custom field mapping
Tax handling
What’s new
Posted or unposted bills: choose whether bills arrive in Business Central as posted or unposted purchase invoices.
Expense and Credit Card bills: Expense and Credit Card bills now sync to Business Central, in addition to Order bills.
What’s changing
Here’s how specific settings compare between your current integration and the new one.
Area | Current integration | New integration |
Company selection | Chosen during the connection setup | Chosen in Procurify after connecting, under Company mapping |
Default bill status | Not available as a setting | Bills sync as unposted by default. Change the setting after migrating if your bills synced as posted before. |
Tax setting | Are you using Microsoft Dynamics' Auto Tax Calculation feature? | Same behavior, new name: Send tax amounts as |
Payments | Payments tab: push payments to Business Central, or pull bill payment status | Paid bills tab: pull paid status only. Pushing payments is not available yet. |
Custom field mapping destination | CODE-Name format (for example, DIV-Division) | Dimension code only (for example, DIV) |
Procurify Actions
Step 1: Record your current settings
Reconnecting resets your integration settings, so record your current setup before you disconnect anything. Go to Settings > Integrations and open Microsoft Dynamics 365 Business Central, then note the following:
Setting | Where to find the setting today | What to record |
Tax setting | Account details panel, Are you using Microsoft Dynamics' Auto Tax Calculation feature? | Yes or No |
Auto Bill Sync | Bills tab, Auto Bill Sync | On or Off |
Custom field mapping | Bills tab > Advanced custom field mapping > View advanced custom fields | Every Procurify field and the Business Central field it maps to |
Payment sync | Payments tab, Sync payments or bill payment status | Which option is selected: Sync payments from Procurify to Microsoft Business Central or Sync bill payment status from Microsoft Business Central to Procurify |
Account code sync | Chart of accounts tab, Schedule sync | Yes or No |
Vendor sync | Vendors tab, Schedule sync | Yes or No |
Didn't record your settings before disconnecting? Contact your Procurify representative. Procurify can help recover your previous settings.
Step 2: Disconnect and reconnect
Important: Do not delete the existing integration. Reconnecting keeps your bill, vendor, and payment sync history, so bills that already synced to Business Central are not sent again.
In Procurify, go to Settings > Integrations and open Microsoft Dynamics 365 Business Central.
Click Disconnect.
Click Reconnect on the same page. The Merge connection window opens.
Step 3: Connect to Business Central
Confirm admin access
When the Administrator role required screen appears, click I am an admin if you are a Business Central admin.
If you are not an admin, copy the URL shown on the screen and send the URL to your Business Central admin so they can complete the connection.
Enter your Microsoft Tenant ID
In Business Central, go to Settings > Admin Center.
Copy the Tenant ID from your browser's address bar. The Tenant ID is the string of letters and numbers between businesscentral.dynamics.com/ and /admin.
Paste the Tenant ID into the Merge window and click Next.
Enter your environment name
In the Business Central Admin Center, under Environments, click the name of the environment Procurify syncs with today.
Copy the full environment name exactly as shown, including capital letters, underscores, and hyphens.
Paste the environment name into the Merge window and click Next.
Important: Enter the environment Procurify synced with before migrating, which is usually your Production environment. Entering a sandbox environment connects Procurify to test data instead of your live books.
Sign in to Business Central
Sign in with a Business Central admin account that can see the company Procurify syncs with.
Keep the window open until the connection finishes.
After connecting, the Connection status in Procurify shows Processing for up to 15 minutes while your data transfers over. When the status changes to Connected, continue to the next step.
Step 4: Select your company
On the Dynamics 365 Business Central setup page, find the Company mapping section.
Click Map to a Business Central company.
Select the Business Central company Procurify synced with before migrating.
Bills do not sync until a company is selected. Select the company before you turn on Schedule sync for vendors, account codes, or paid bills, so Procurify pulls data from the correct Business Central company.
Step 5: Restore your settings
Re-enter the settings you recorded before migrating:
Setting | Where to find the setting now | What to select |
Send tax amounts as | Account details panel | If the Auto Tax Calculation answer was Yes, select Pre-tax amounts. If No, select Line item totals with tax included. |
Sync bills as unposted or posted | Bills tab | Match how bills arrived in Business Central before: Sync bills as unposted purchase invoices or Sync bills as posted purchase invoices |
Custom field mapping | Bills tab > Advanced custom field mapping > Edit | Add each mapping you recorded, using the Business Central dimension code only as the destination |
Auto Bill Sync | Bills tab | Turn on if Auto Bill Sync was on before |
Account code sync | Chart of accounts tab > Schedule sync | Select Yes if account code sync was on before |
Vendor sync | Vendors tab > Schedule sync | Select Yes if vendor sync was on before |
Paid bill sync | Paid bills tab > Schedule sync | Select Yes if Sync bill payment status from Microsoft Business Central to Procurify was selected before |
Turning on Schedule sync on the Vendors and Chart of accounts tabs for the first time starts the initial sync of vendors and account codes from your selected Business Central company.
Important: The new default is unposted. If bills arrived in Business Central as posted purchase invoices before migrating, select Sync bills as posted purchase invoices to keep the same behavior.
Updating custom field mappings
The destination for each custom field mapping is now the Business Central dimension code only, which is the part before the first hyphen in your old mapping. For example, DIV-Division becomes DIV, and COSTCATEGORY-Cost Category becomes COSTCATEGORY. If your old mapping wasn't in CODE-Name format, find the dimension code in Business Central under Dimensions.
You don't need to change your custom field or department values in Procurify. Values match on the Business Central display name or on the exact CODE-Name format.
Step 6: Check that everything is working
After the initial sync finishes, open the Vendors and Chart of accounts tabs and spot-check a few vendors and account codes against your Business Central company.
Sync one approved bill for a vendor that synced to Business Central before the migration.
In Business Central, open the purchase invoice and check the vendor, account codes, dimension values, and attachment, and whether the purchase invoice is posted or unposted as expected.
Current Limitations
Bill payments: Pushing bill payments from Procurify to Business Central is not available yet. You can still pull paid status from Business Central into Procurify on the Paid bills tab.
Paid status for bills synced before migrating: If you use Paid bill sync, bills that synced to Business Central before the migration and are paid in Business Central afterward are not marked as paid in Procurify automatically. Mark those bills as paid manually in Procurify. Bills synced after the migration are not affected.
One company per domain: Each Procurify domain connects to one Business Central company.
Card transaction sync: Syncing card transactions to Business Central as journal entries is not available.
Older Expense and Credit Card bills: Expense and Credit Card bills become available to sync after migrating. If you already entered older Expense or Credit Card bills in Business Central manually, mark those bills as synced in Procurify instead of syncing them, to avoid duplicates.
Dimension value format: Dimension values must match the Business Central display name or use the exact CODE-Name format with a single hyphen. Values with spaces around the hyphen (for example, FIELDSTATE - SP) or with an en dash do not match, so update those values in Procurify.
Troubleshooting
If you see We couldn't load this setting or the Company mapping section doesn't appear, wait for the Connection status to show Connected, then do a hard refresh of the page: Cmd + Shift + R on Mac or Ctrl + Shift + R on Windows.
Running into anything unexpected? Contact Procurify Support and we'll help you sort it out.


