Moving from Beta to v1.0
With the April 2019 release of Business Central, the standard APIs were released in version 1.0.
API version numbers are managed in the URI https://api.businesscentral.dynamics.com/v2.0/{environment name}/api/{API VERSION}/
. For example, for v1.0 of the API the URI is https://api.businesscentral.dynamics.com/v2.0/production/api/v1.0/
.
Important
The beta API will remain live until April 2020. It's recommended to move to v1.0 as soon as possible. When moving from beta to v1.0, pay attention to changes related to URIs of the document APIs, and to the customer APIs where balance, overdueAmount, and totalSalesExcludingTax have moved to the customerFinancialDetails API. Other changes are additive.
Comparing Business Central beta API, to Business Central v1.0 APIs have the following changes.
Entity | Changes |
---|---|
customer | Properties balance, overdueAmount, totalSalesExcludingTax have moved to a new entity customerFinancialDetails, which has a relation to the customer entity. |
customerFinancialDetails | Entity added. |
companyInformation | businessProfileId has been removed. |
salesInvoice, salesOrder, salesQuote | Billing, shipping and selling postal addresses are added. |
purchaseInvoice | buyFrom, payTo and shipTp addresses added. |
salesInvoiceLine, salesOrderLine, salesQuoteLine, salesCreditMemoLine, purchaseInvoiceLine | Key changed from multipart key, to a single key. Type has changed from Guid to String. |
salesCreditMemo | Billing and selling addresses added, and properties phoneNumber and email. |
journalLine | Added attachment, so attachments can be added to journalLine". |
timeRegistrationEntry | New entity. Makes it possible to add employee time registrations. |
salesQuote | Properties phoneNumber and email have been added. |
For a full comparison of API versions, compare the metadata of the APIs. Using OAuth, tenant ID is not needed in the URI when querying:
GET https://api.businesscentral.dynamics.com/v2.0/{environment}/api/beta/$metadata
GET https://api.businesscentral.dynamics.com/v2.0/{environment}/api/v1.0/$metadata
Using Basic Auth:
GET https://api.businesscentral.dynamics.com/v2.0/{tenant Id}/{environment}/api/v1.0/$metadata
See Also
Welcome to the API(v1.0) for Dynamics 365 Business Central
Endpoints for the APIs