Master data and authentication

Master data is what information has been set up in Wisefish on items, lots and more. The external production system can query items from Wisefish using GET requests.

This API is built into Microsoft Dynamics Business Central (BC). A typical installation will have the Wisefish system set up in the Microsoft SAAS environment so authentication needs to be implemented with OAuth 2.0 and App registration with a client secret.

Key concepts in BC are.

SAAS URL example from a Wisefish development tenant: https://businesscentral.dynamics.com/b9559d9b-8fc8-4233-b617-00a14ef0a761/SalesAndConsulting?company=MyCompany

This URL is built up like this: https://businesscentral.dynamics.com/{TenantId}/{Environment}?company={Company}

TenantId is the tenant for the company that is using the BC and Wisefish system, in the example above the tenant owner is Wisefish and it is intended for development.

Environment, there can be multiple environments, typically this could be to separate Live, Staging and Dev environments.

Company, there can be multiple companies in each tenant and environment

Authentication with OAuth2.0 requires the following information

Here is documentation of some of the endpoints that are available, refer to the Token and Companies sections for code examples.