Microsoft Dynamics 365 Business Central
Microsoft Dynamics 365 Business Central connector for managing customers, vendors, items, and the sales order and invoice cycle including posting, through the Business Central API v2.0.
What you can ask
- Create a sales order for customer
C00010and ship and invoice it once it is picked - List unposted purchase invoices from vendor
Fabrikam Inc.and post the approved ones - Add a general journal line for a month-end accrual and post the journal
Set up
Microsoft Dynamics 365 Business Central needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Microsoft Dynamics 365 Business Central. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Microsoft Dynamics 365 Business Central developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Microsoft Dynamics 365 Business Central login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (1)
Grant the scopes for the tools you plan to allow.
https://api.businesscentral.dynamics.com/Financials.ReadWrite.All
Tools
Microsoft Dynamics 365 Business Central offers 82 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (30)
View and search information without changing it.
| Tool | What it does |
|---|---|
discover_entity_metadata | Inspect one entity set's fields and expandable relations by sampling a real record. |
get_account | Get one general ledger account by GUID, including its category, type and net change. |
get_customer | Get one customer by its GUID, including its '@odata.etag' for safe updates. |
get_item | Get one item by its GUID, including its '@odata.etag' for safe updates. |
get_purchase_invoice | Get one purchase invoice header by GUID, including its '@odata.etag' for safe updates. |
get_purchase_order | Get one purchase order header by GUID, including its '@odata.etag' for safe updates. |
get_record | Get one record by GUID from any Business Central entity set, including its '@odata.etag' for safe updates. |
get_sales_invoice | Get one sales invoice header by GUID, including its '@odata.etag' for safe updates. |
get_sales_order | Get one sales order header by GUID, including its '@odata.etag' for safe updates. |
get_vendor | Get one vendor by its GUID, including its '@odata.etag' for safe updates. |
list_accounts | List the chart of accounts for a company. |
list_companies | List the companies in the connected Business Central environment. |
list_customers | List customers in a Business Central company. |
list_entities | List the API entity sets this Business Central environment exposes, such as customers or salesInvoices. |
list_items | List items in a Business Central company. |
list_journal_lines | List the unposted lines in one journal batch. |
list_journals | List general journal batches in a company. |
list_payment_journals | List customer or vendor payment journal batches, selected with the party parameter. |
list_payments | List customer or vendor payment lines from one payment journal batch, selected with the party parameter. |
list_purchase_invoice_lines | List the lines on one purchase invoice. |
list_purchase_invoices | List purchase invoices in a Business Central company. |
list_purchase_order_lines | List the lines on one purchase order. |
list_purchase_orders | List purchase orders in a Business Central company. |
list_records | List records from any Business Central entity set, for entities with no dedicated tool such as salesQuotes or dimensions. |
list_sales_invoice_lines | List the lines on one sales invoice. |
list_sales_invoices | List sales invoices in a Business Central company. |
list_sales_order_lines | List the lines on one sales order. |
list_sales_orders | List sales orders in a Business Central company. |
list_vendors | List vendors in a Business Central company. |
validate_credential | Validate Business Central credentials by listing the companies in the configured environment. |
Write (17)
Create or send data.
| Tool | What it does |
|---|---|
create_customer | Create a customer. |
create_item | Create an item in a Business Central company. |
create_journal_line | Add an unposted line to a journal batch. |
create_purchase_invoice | Create a draft purchase invoice header. |
create_purchase_invoice_line | Add a line to a draft purchase invoice. |
create_purchase_order | Create a purchase order header. |
create_purchase_order_line | Add a line to a purchase order. |
create_record | Create a record in any Business Central entity set. |
create_sales_invoice | Create a draft sales invoice header. |
create_sales_invoice_line | Add a line to a draft sales invoice. |
create_sales_order | Create a sales order header. |
create_sales_order_line | Add a line to a sales order. |
create_vendor | Create a vendor in a Business Central company. |
make_corrective_credit_memo | Create a draft corrective credit memo from a posted sales invoice. |
send_sales_credit_memo | Email a posted sales credit memo without posting or cancelling it. |
send_sales_invoice | Email a sales invoice Business Central permits to send; docs do not specify draft versus posted. |
send_sales_quote | Email a sales quote Business Central permits to send; the action docs do not specify a narrower status. |
Delete or overwrite (35)
Remove or replace existing data.
| Tool | What it does |
|---|---|
cancel_and_send_sales_credit_memo | Cancel and email only a posted corrective sales credit memo created by cancel_sales_invoice; standalone memos return 400. |
cancel_and_send_sales_invoice | Cancel a posted sales invoice and create its corrective credit memo, then email the cancellation. |
cancel_purchase_credit_memo | Cancel a posted corrective purchase credit memo created by cancelling a purchase invoice; a standalone memo returns 400. |
cancel_sales_credit_memo | Cancel only a posted corrective sales credit memo created by cancel_sales_invoice; standalone memos return 400. |
cancel_sales_invoice | Cancel a posted sales invoice by issuing a corrective credit memo. |
delete_customer | Delete a customer. |
delete_item | Delete an item. |
delete_journal_line | Delete an unposted journal line. |
delete_purchase_invoice | Delete a draft purchase invoice and its lines. |
delete_purchase_order | Delete a purchase order and its lines. |
delete_record | Delete a record from any Business Central entity set. |
delete_sales_invoice | Delete a draft sales invoice and its lines. |
delete_sales_order | Delete a sales order and its lines. |
delete_vendor | Delete a vendor. |
make_invoice_from_sales_quote | Convert an open sales quote that Business Central permits to convert into a sales invoice; the action page does not specify a narrower status. |
make_order_from_sales_quote | Convert an open sales quote that Business Central permits to convert into a sales order; the action page does not specify a narrower status. |
post_and_send_sales_credit_memo | Post and email a draft sales credit memo. |
post_and_send_sales_invoice | Post and email a draft sales invoice. |
post_journal | Post every line in a journal batch to the general ledger at once. |
post_purchase_credit_memo | Post a draft purchase credit memo to finalize the vendor credit. |
post_purchase_invoice | Post a draft purchase invoice to the general ledger. |
post_sales_credit_memo | Post a draft sales credit memo to finalize the customer credit. |
post_sales_invoice | Post a draft sales invoice to the general ledger. |
receive_and_invoice_purchase_order | Receive and invoice a purchase order, creating posted receipt and invoice documents. |
restart_job_queue_entry | Restart a failed job queue entry in a restartable state (typically Error); docs do not specify the exact status. |
ship_and_invoice_sales_order | Ship and invoice a sales order, creating posted shipment and invoice documents in the ledger. |
update_customer | Update fields on an existing customer. |
update_item | Update fields on an existing item. |
update_journal_line | Update an unposted journal line. |
update_purchase_invoice | Update header fields on a draft purchase invoice. |
update_purchase_order | Update header fields on a purchase order. |
update_record | Update a record in any Business Central entity set. |
update_sales_invoice | Update header fields on a draft sales invoice. |
update_sales_order | Update header fields on a sales order. |
update_vendor | Update fields on an existing vendor. |