canonical: https://jentic.com/apis/dynamics.com/bcgw-export # Dynamics BCGW Export The BCGW Export API returns purchase orders from a Dynamics 365 Business Central company through a single read-only endpoint. It is a custom Business Central API published through the Business Central gateway, serving purchase order records for a specific company and environment as JSON. The endpoint only reads data, so it suits exporting purchase orders into reporting, procurement, or reconciliation systems rather than creating or editing them. ## For AI agents Retrieve purchase orders from a Dynamics 365 Business Central company through a single read-only export endpoint, returned as JSON. A focused export API for pulling purchase order data out of Business Central. ## Scope Does not handle creating, approving, or editing purchase orders, invoices, or payments. Use for reading purchase order data exported from Business Central only. ## Capabilities - Retrieve purchase orders from a Dynamics 365 Business Central company - Export purchase order records for a specific Business Central company and environment - Pull purchase order data into reporting or procurement systems as JSON ## Use cases ### Agent-driven purchase order export An AI agent connected through Jentic can pull purchase orders out of Dynamics 365 Business Central on demand. It calls the single export endpoint and receives the purchase order records as JSON, so the agent can hand them to a user, a report, or a downstream system without opening the Business Central client. Example prompt: Call the purchase orders export endpoint for a company and return the list of purchase orders as structured data. ### Procurement reporting Because the endpoint returns the company's purchase orders as structured data, a reporting agent can summarize open purchase commitments without manual exports. It reads the purchase orders and aggregates them by vendor or status for a procurement dashboard. Example prompt: Read the purchase orders for a company and summarize the total value of open orders grouped by vendor. ### Sync purchase orders to another system The export endpoint provides a read source for keeping an external system aligned with Business Central's purchase orders. A sync agent can periodically pull the purchase orders and upsert them into a data warehouse or procurement tool, using the read-only export as the source of truth. Example prompt: Pull the purchase orders from the export endpoint and upsert any new or changed orders into an external store. ## Key resources - **Purchase Orders** — Read purchase order records exported from a Dynamics 365 Business Central company ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 0 / 100 - **Maturity:** Non-Ready - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 69 / 100 - AI-Readiness & Agent Experience: 41 / 100 - Agent Usability: 94 / 100 - Security: 90 / 100 - AI Discoverability: 0 / 100 - **View full report:** https://jentic.com/apis/dynamics.com/bcgw-export/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring BCGW Export by hand means registering an app in Microsoft's identity platform, running the oauth2 flow for the Business Central resource scope, and calling a long gateway URL that embeds the company and environment. Through Jentic you install once, import BCGW Export from the API Directory, store the credential once, and your agent calls it. - **Permission scoping:** The BCGW Export API exposes a single read-only purchase-orders export, so a rule grants your agent that one read operation and nothing more. There are no write operations to withhold, because the endpoint only returns data. - **Credential handling:** Your BCGW Export oauth2 token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'export purchase orders from Business Central', and Jentic returns the BCGW Export operation with its input schema so the agent calls it without hunting for the gateway URL. ## Related APIs - **Dynamics 365 Business Central** — The full Business Central API reads and writes the financial and sales records behind these purchase orders - **Xero Accounting** — Xero exposes purchase bills and accounting records as an alternative source of procurement data - **Zoho Inventory** — Zoho Inventory manages purchase orders and stock that can be reconciled against Business Central's ## FAQ ### What authentication does the BCGW Export API use? The BCGW Export API authenticates with oauth2 against Microsoft's identity platform, per its OpenAPI spec, using the Business Central resource scope. You obtain a token from the Microsoft login endpoint and send it as a bearer token on the request. Through Jentic the token is stored encrypted by your own Jentic One instance and injected at call time, so it never reaches the agent's context. ### Is there a BCGW Export MCP server? You don't need an MCP server to give your agent the BCGW Export API. Jentic connects it directly from the API Directory: import BCGW Export, store your oauth2 credential once, and your agent calls the export operation. The operation is discovered on demand, so no extra server's tool definitions are loaded into the agent's context. ### Can I limit what my agent is allowed to do with the BCGW Export API? Yes. The API exposes only a single read-only purchase-orders export, so a rule can allow that one operation and the agent can reach nothing else, and every call it makes is logged. There are no write or delete operations in this API for an agent to use. ### What data does the BCGW Export API return? It returns the purchase orders of a Dynamics 365 Business Central company as JSON through its single export endpoint. The endpoint is read-only, so it provides purchase order records for reporting or integration but does not create, approve, or modify them. ### What are the rate limits for the BCGW Export API? This OpenAPI spec does not state rate limits; Business Central enforces request throttling per environment and tenant set by Microsoft. Check the Microsoft Dynamics 365 Business Central API documentation for the limits that apply to your tenant. ### How do I export purchase orders with the BCGW Export API through Jentic? Install Jentic One, import BCGW Export from the API Directory, and store your oauth2 credential once. Your agent then searches by intent, for example 'export purchase orders from Business Central', and Jentic returns the export operation with its input schema. To run it on your own infrastructure, install Jentic One from its GitHub repo.