> For the complete documentation index, see [llms.txt](https://docs.dynalogic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dynalogic.com/birds-document-warehouse-product-overview/d365-business-central/ex-arte-raptor-api-call-setup-list.md).

# Ex Arte Raptor API Call Setup List

In this form we specify the API endpoints that Raptor can use to fetch table data.

The list will be prefilled with the default api endpoints.\
Additional (custom) API's can be added by a BC technical consultant.

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-53151fdb285c97a27dca5fcc5ba0760a4cc7f776%2Fimage%20(512).png?alt=media" alt=""><figcaption></figcaption></figure>

Column 2 : Filter Field functionality is not working at this moment. This field also has no added value

Column 3: The checkmark Custom API specifies If the data should be fetched from the default API endpoint: /api/v1.0/(before BC21) or /api/v2.0/(bc21 and onwards) (If unchecked) or from the custom Raptor api endpoint: api/raptor/custom/v1.0/ (If checked).

## Raptor On-Prem Configuration:

### Setup

You can access the Jobs in Raptor if you use this path:\
Raptor> Configuration> Job

### Authentication

Select the D365BCTaxonomy with the right Leagal Entity (Company)

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-46b7e859f03e6e7655a61ba1dbfa04bc79951fe3%2Fimage%20(573).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Document Warehouse taxonomy synchronization supports OAuth2.0 for connecting to D365 Business Central. Business Central 21 and later require OAuth2.0; earlier versions can also use Basic Authentication.
{% endhint %}

You have to make sure that the User you choose, exists in your Company (Legal Entity)

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-5ec1de83dde6a2db53173a534ae411ff8078fbe2%2Fimage%20(421).png?alt=media" alt=""><figcaption></figcaption></figure>

### Delta Fetch Settings

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-38dfe65ebb91c2a3ae6c4164bbcc38b3977be346%2Fimage%20(568).png?alt=media" alt=""><figcaption></figcaption></figure>

The Package ID field will be explained In the next section

The URL will be the URL of the Business Central environment.

Raptor Base Path Is: /api/raptor/custom/v1.0/

Entity Path: /api/v1.0/

Company ID: Search to Companies (Table 2000000006) en press Cntrl+Alt+F1 and search for ID. Enter this ID In Company ID.

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-7147cc20d2d4b67af254b6afa712a80f77b61921%2Fimage%20(416).png?alt=media" alt=""><figcaption></figcaption></figure>

## Raptor Cloud Configuration:

### **Setup**

You can access the Jobs in Raptor if you use this path:\
Raptor> Configuration> Job

### **Authentication**

Select the D365BCTaxonomy with the right Leagal Entity (Company)

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-2889a3fc3b1493700c705661b525fc4b5f200002%2Fimage%20(510).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Document Warehouse taxonomy synchronization supports OAuth2.0 for connecting to D365 Business Central. Business Central 21 and later require OAuth2.0; earlier versions can also use Basic Authentication.
{% endhint %}

The Active Directory Tenant, Client app Id and Client app secret should be provided by the customer.\
Azure resource will always be: <https://api.businesscentral.dynamics.com>

It's important to Enable the Azure Active Directory & give the right permissions (SUPER(DATA))

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-fd82a95487f08c61b79d952b4d7e54b97e63e6cf%2Fimage%20(335).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-38b2d172a7f559731d1f78cea6828038ef994c09%2Fimage%20(499).png?alt=media" alt=""><figcaption></figcaption></figure>

### **Delta Fetch Settings**

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-265804c235f0912b1e81d5750059aea12721c861%2Fimage%20(536).png?alt=media" alt=""><figcaption></figcaption></figure>

The Package ID field will be explained In the next section

The URL will be the URL of the Business Central environment.

Raptor Base Path Is: /api/raptor/custom/v1.0/

Entity Path: /api/v2.0/

Company ID: Search to Companies (Table 2000000006) en press Cntrl+Alt+F1 and search for ID. Enter this ID In Company ID.

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-7147cc20d2d4b67af254b6afa712a80f77b61921%2Fimage%20(552).png?alt=media" alt=""><figcaption></figcaption></figure>

You might have a problem with the Taxonomy Job of Items, but you can solve this by using this parameters:

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-5e85857ebd271fec53babf82688e54e2f0a24854%2Fimage%20(558).png?alt=media" alt=""><figcaption></figcaption></figure>

You don't need the vendorItemNumber or vendorNumber for the Taxonomy job.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dynalogic.com/birds-document-warehouse-product-overview/d365-business-central/ex-arte-raptor-api-call-setup-list.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
