Dynamics 365

Overview

The Dynamics 365 Business Central integration enables you to connect Bumblebee with Microsoft's cloud-based ERP solution. Automate financial processes, manage customers and vendors, and streamline business operations directly from your Bumblebee workflows.

Prerequisites & Setup

Before setting up the Dynamics 365 Business Central integration, you need:

• A Microsoft 365 tenant with Dynamics 365 Business Central
• An Azure AD (Microsoft Entra) application registered as a single-tenant app
• The application must use the redirect URI: https://businesscentral.dynamics.com/OAuthLanding.htm
• Application (client) credentials (client ID, client secret, and tenant ID)
• The application registered inside Business Central with appropriate permissions

Phase 1: Register the Application in Microsoft Entra (Azure AD)

1. Sign in to the Azure Portal
2. Navigate to Microsoft Entra ID > App registrations
3. Click New registration
4. Configure the application:
   • Name: "BumblebeeDynamics365Integration"
   • Supported account types: Select Single tenant only
   • Redirect URI: Select "Web" and enter https://businesscentral.dynamics.com/OAuthLanding.htm
5. Click Register
6. Note the Application (client) ID and Directory (tenant) ID

Configure API Permissions

1. In your app registration, go to API permissions
2. Click Add a permission > Dynamics 365 Business Central > Application permissions
3. Select all available permissions:
   • API.ReadWrite.All — Full access to web services API
   • Automation.ReadWrite.All — Full access to automation
   • AdminCenter.ReadWrite.All — Full access to Admin Center API
   • app_access — Access according to the application's permissions in Business Central
4. Click Add permissions
5. Click Grant admin consent for your organization

Create a Client Secret

1. Go to Certificates & secrets
2. Click New client secret
3. Add a description: "Bumblebee Dynamics 365 Integration"
4. Select an expiration period (recommended: 24 months)
5. Click Add
6. Copy the Value immediately (shown only once — save it securely)

Phase 2: Add the Application User in Business Central

1. Log in to Business Central
2. Use the search icon (Alt+Q) and search for Microsoft Entra Applications
3. Click + New to create a new entry
4. Enter the Client ID from your Entra app registration
5. Set a Description (e.g., "BumblebeeDynamicsIntegration")
6. Set State to Enabled
7. Under User Permission Sets, add D365 FULL ACCESS
8. Click Grant Consent and accept the permissions dialog

Configure in Bumblebee

1. Go to the Integrations page in Bumblebee
2. Select Dynamics 365 Business Central
3. Enter your credentials:
   • App Client ID
   • App Client Secret
   • Tenant ID
4. Click Save to store the configuration

Available Tools

Companies

• list_companies - List all companies in the Business Central environment. Required: tenant_id (str)

Customers

• list_customers - List customers with optional filtering. Required: tenant_id (str), company_id (str). Optional: filter (str, OData filter), top (int)
• get_customer - Get a customer by ID. Required: tenant_id (str), company_id (str), customer_id (str)
• create_customer - Create a new customer record. Required: tenant_id (str), company_id (str), display_name (str). Optional: email, phone, address
• update_customer - Update an existing customer. Required: tenant_id (str), company_id (str), customer_id (str). Optional: display_name, email, phone, address

Vendors

• list_vendors - List vendors with optional filtering. Required: tenant_id (str), company_id (str). Optional: filter (str), top (int)
• get_vendor - Get a vendor by ID. Required: tenant_id (str), company_id (str), vendor_id (str)

Items

• list_items - List inventory items. Required: tenant_id (str), company_id (str). Optional: filter (str), top (int)
• get_item - Get an item by ID. Required: tenant_id (str), company_id (str), item_id (str)

Sales Orders

• list_sales_orders - List sales orders. Required: tenant_id (str), company_id (str). Optional: filter (str), top (int)
• get_sales_order - Get a sales order by ID. Required: tenant_id (str), company_id (str), order_id (str)

Sales Invoices

• list_sales_invoices - List sales invoices. Required: tenant_id (str), company_id (str). Optional: filter (str), top (int)
• get_sales_invoice - Get a sales invoice by ID. Required: tenant_id (str), company_id (str), invoice_id (str)