Amazon Punchout Integration for Dynamics 365 Business Central User Guide

Installation Guide

Pre-Requisites

Here are the prerequisites required to get started. Use the listed information for reference during installation.

1. The version of the Business Central Environment must be 25.0 and above.
2. We will need Client ID, Client Secret ID, Tenant ID, which we will get when we register Business Central on portal (there are steps below to get client id, client secret id).
3. We will need the Identity and the shared secret from Amazon Business.
4. We will need Punchout URL for test and production from Amazon Business.
5. No. Series for Punchout Requisition.
6. Amazon as a Vendor in Business Central (all posting setup on vendor card must be filled in).
7. Item Template – This will be used for any items which is not in item master but is procured for the first time, system will generate the new item based on the setups mentioned in the item template.
8. The Gen. Prod. Posting group used on item must have a valid Gen. Posting Setup.
9. Location Code where the orders are received (all inventory posting setup must be completed for the location code).
10. The punchout works for type = item. If we want to expense out everything then the item template must be setup as type = non – inventory.

Getting Started

Here is how to perform the installation of the Amazon Punchout extension in Business Central.

1. In Business Central, search for Microsoft AppSource App (i.e. Microsoft Marketplace).

2. Search for Amazon Punchout Integration for Business Central.

Click on View on AppSource and on that page click on Get it Now. This will install the extension in the selected environment of Business Central.

Registering the Business Central Application on Azure

Registering the Business Central application on Azure is required when configuring OAuth authentication. Follow the steps below to register the Dynamics 365 Business Central app in the Azure Portal.

1. Log in to the Azure Portal and select App registrations under Azure services.
2. Click on the New registration button.
3. On the Register an application page enter the following details and click on the Register button.

• Name: Name of your application.
• Supported account types: Select Accounts in any organizational directory (Any Azure AD directory – Multitenant) if you want to allow access to your app from any Azure AD tenant, or Accounts in this organizational directory only (Single tenant) if you want to limit access to your app to a specific Azure AD tenant.
• Redirect URI (optional). Select Web and enter the redirect URL for your BC app. This is the URL where your app will receive the authentication response. Add the URL as: https://businesscentral.dynamics.com/  for the Business Central Cloud version.

4. Under Certificates & secrets click the New client secret button to create a new secret.

5. Enter a description for the secret, select an expiration period, and click the Add button.

6. Note down the value of the client secret, as you will need it later and it is visible only for the first time.

7. Click on the API permissions tab, then click the Add a permission button to add permission to the registered Business Central app.

8. Select Dynamics 365 Business Central from the list of available APIs:

9. Here you can select two types of permission (Delegated permissions and Application permissions). Check the required permissions and click on Add permissions.

10. Click on Grant admin consent and click on Yes.

The Business Central app is now registered in the Azure Portal and you can use it when accessing web services with OAuth authentication.