AFD Postcode Integration Logo AFD Postcode Integration

Complete setup and usage guide for AFD Postcode Address Finder in Microsoft Business Central

5 min read
Last updated: February 2026
v2.0+

01 Overview

The AFD Postcode Integration is a powerful extension for Microsoft Business Central that provides instant UK address verification and lookup functionality directly within your ERP system.

Get it now

Key Benefits

  • • Eliminate address data entry errors
  • • Speed up customer/vendor entry
  • • Ensure accurate deliveries
  • • Comply with postal standards

Data Sources

  • • Royal Mail PAF database
  • • International addresses
  • • Postcode updates monthly

02 Prerequisites

Before installing the AFD Postcode Integration, ensure your system meets the following requirements:

Microsoft Business Central

Version 26 or higher GB

Free Evaluation Available

AFD Software provide a Free Evaluation which includes 10 free UK lookups

AFD Subscription

Active AFD Postcode subscription with API credentials

System Administrator Access

Permissions to install extensions and configure setup tables

Internet Connectivity

Business Central must have access to the internet for API calls

03 Installation

3.1 Open AppSource Gallery

In Business Central search for "Extension Management", then when the Installed Extensions list displays select "AppSource Gallery" from the ribbon.

In Business Central search for Extension Management, then select AppSource Gallery from the ribbon

3.2 Search for AFD

When the list opens, search for AFD. This can be viewed on AppSource to see more information about the app.

When the list opens, search for AFD on AppSource

3.3 Install App

Click on the app in the list and select "Install App".

Click on the app in the list and select Install App

3.4 Refresh Software

The app will be installed; the user will be directed to refresh the software before continuing to setup.

The app will be installed and the user will be directed to refresh the software

3.5 Verify Installation

After installation, verify the extension is active:

  • Go to Extension Management
  • Confirm "AFD Postcode Integration" shows as Installed
  • Look for the new AFD menu item in the navigation
AFD Postcode Integration installed in Business Central

3.6 User Permissions

Once the AFD Postcode Integration app has been downloaded from the AppSource Gallery or manually uploaded, users who are likely to use the postcode lookup service need the following permission added to their permission sets either directly or to a group assigned to them:

User Permissions

04 Setup

4.1 Find Postcode Provider Configuration

In Business Central use the search function to find "Postcode provider configuration page":

Postcode provider configuration page in Business Central Postcode provider configuration settings

4.2 Select AFD Provider

Once the page opens drill into the ellipsis:

Ellipsis menu in postcode configuration

Then select "AFD" and press OK.

AFD postcode provider selection

4.3 Allow Permissions

The below will display, select "Allow Always".

Allow Always permission prompt

4.4 Accept Terms and Conditions

The user cannot progress with installation until the Terms and Conditions have been viewed. If the button is not clicked then the below message displays:

Terms and Conditions message

Click the "Terms and Conditions" link to view them:

Terms and Conditions page

Evaluation Key: The service pre-installs an evaluation key which is limited to 10 free UK lookups. After this time, users will be prompted to contact AFD Software to obtain a commercial key which can be entered into the configuration page to continue working.

05 Configuration

5.1 Register for Full Access

Once the 10 free UK lookups have been used the following message will display, select "Register" to continue.

AFD Postcode Integration registration prompt

5.2 Enter Serial and Password

When the user selects "Register" the AFD Postcode configuration page will open where the serial and password can be entered to continue using the software.

AFD Postcode configuration page with serial and password

06 Usage Guide

Quick Start: Finding an Address

Or follow these steps:

1

Open a Customer, Vendor, or Contact Card

Navigate to the relevant page where you want to enter an address

2

Click the "Lookup address from Postcode" Button

Located in the Address section toolbar

3

Enter Search Criteria

You can search by:

  • • Postcode + House number
  • • Partial postcode
  • • Street name + town
  • • organisation name
4

Select from Results

Choose the correct address from the dropdown list

5

Address Auto-Fills

All address fields populate automatically with validated data

6.1 Using the Customer Card

The service will work in all areas of Business Central where the standard postcode provider functionality is supported.

Customer Card

AFD Postcode on Customer Card in Business Central

6.2 Lookup Address from Postcode

In the address section of the customer card select "Lookup address from Postcode", as below:

Lookup address from Postcode option in Business Central

6.3 Enter Postcode and Select Address

Enter the Post Code into the Postcode Search (or start typing the address) and a list of possible address matches will display, select the required address. Once the user presses OK the address fields on the contact card will be updated to match.

Postcode search with address matches Address fields populated on contact card

In addition to Customers, the same steps can be followed on the following Business Central entity cards:

Bank Account

Company Information

Contact

Contact Alt. Address

Customer Bank Account

Employee

Location

Resource

Ship-to Address

Vendor

6.4 Search Methods

Postcode Lookup

Enter a full postcode (e.g., "EC2A 4NE") to find all addresses at that postcode. Add house number/name for precise match.

Street Search

Enter street name and town to see all matching addresses. Useful when customer doesn't know their postcode.

Organisation Search

Search by company name to find their registered address. Great for business customers!

International Addresses

Search for addresses outside the UK. Select country first, then enter address details.

07 App Updates

How to Update the App

The AFD Postcode Integration app is regularly updated with new features and improvements. To update:

  1. Go to Admin Centre and Manage Apps
  2. Find the AFD Postcode Integration app in the list
  3. If an update is available, you'll see an "Update" option
  4. Click "Install Update" to install the latest version
  5. Refresh Business Central after the update completes

Automatic Update Notifications

Business Central will notify administrators when a new version of the AFD Postcode Integration is available. We recommend updating promptly to ensure you have the latest features and security updates.

Release Notes

For detailed information about each release, including new features, bug fixes, and improvements, visit our release notes page or check the Microsoft AppSource listing.

08 Troubleshooting

"You must choose the getAddress.io Service" Message

Cause: Conflicting postcode extension installed

Solution:

Uninstall the "GetAddress.io UK Postcodes" extension. This can be done in two ways:

  • Option 1: From Installed Extensions in Business Central
  • Option 2: From Admin Centre → Environments → Manage Apps

After uninstalling the conflicting extension, restart Business Central and try again.

"No Results Found" Error

Cause: Search criteria doesn't match any records

Solution:

  • • Check spelling of street/town name
  • • Try partial postcode (e.g., "EC2A" instead of "EC2A 4NE")
  • • Use the street search instead of postcode
  • • Try alternative spellings (e.g., "Rd" vs "Road")

"API Connection Failed" Error

Cause: Unable to connect to AFD servers

Solution:

  • • Verify your API credentials in AFD Setup
  • • Check internet connectivity from Business Central server
  • • Confirm your AFD subscription is active
  • • Check firewall allows outbound HTTPS to api.afd.co.uk

Button Not Visible

Cause: Page not configured for AFD lookup

Solution:

  • • Go to AFD → Setup → Page Configuration
  • • Enable the relevant page(s)
  • • Refresh the page in Business Central
  • • Ensure you have the necessary permissions

"Invalid API Key" Error

Cause: API credentials are incorrect or expired

Solution:

  • • Update credentials in AFD Setup page
  • • Contact AFD support if key is still not working

09 Frequently Asked Questions

Does AFD work with all versions of Business Central?

How often is the postcode data updated?

Can I use AFD for international addresses?

Is there a limit to how many lookups I can perform?

What happens if the AFD service is down?

Can multiple users use AFD simultaneously?

How do I get support if I have issues?