# Cloud

#### URL

Finding the actual SOAP address in Business Central Cloud is quite easy. The base is always the same, the only addition is the unique ID for your organization (Azure AD tenant) and the name of the environment. 

{% code title="Base URL" %}

```
https://api.businesscentral.dynamics.com/v2.0/
```

{% endcode %}

The unique ID for your organization can be found under "Help and support", which can be found by clicking the big "?" (question mark) up to the left, right next to your user icon. In the picture below the ID is the text marked in yellow and the environment name is marked in pink.

![The Azure AD tenant and the environment name.](/files/-MKJnfR44CyEXDPqcXaT)

Adding these two to the end of the address ending with "/WS", as shown below, gives you the full SOAP address as required by Golden EDI.

{% code title="Full URL" %}

```
https://api.businesscentral.dynamics.com/v2.0/7f894e1f-44ae-4264-a99b-000000000000/Sandbox/WS
```

{% endcode %}

### Credentials

The Golden EDI cloud service will communicate with your Business Central instance over the SOAP web service. To do this Golden EDI cloud service need to authenticate with a user account. Please create a specific user for the Golden EDI cloud service and then generate a **Web Service Access Key** with the **Key Never Expires** option.

The user can be a **Full User** or a **Limited User**. The **Limited User** is has a cheaper license fee and is therefor the preferred choice. 

**Permissions**

You can limit the tables the user has access to protect the wider system. To do this you can set so that the user only has access to the following tables. 

* 70019007 - GEDI Class Information - Read and Write
* 70019002 - GEDI Message Queue - Read and Write
* 70019001 - GEDI Message Line - Read and Write
* 70019013 - GEDI Class Setup - Read
* 70019005 - GEDI Message Code - Read
* 70019003 - GEDI Profiles - Read

### Information to send to Golden EDI

When the configuration is done you need to send the following information to Golden EDI or if you set up your own organization in our Cloud Service this is the information you need access to.

* **URL**, The full SOAP address as found above.
* **Company Name**, Example: My Company Ltd
* **Username**, The username for authentication to SOAP.
* **Password or Web Service Access Key,** The password for the above username.

### How to test the configuration

It is a good idea to test the configuration before sending us the configuration information. Open up a web browser and try to access the full URL including company name for the SOAP web service. The URL looks like this:

{% code title="Example URL" %}

```
https://api.businesscentral.dynamics.com/v2.0/7f894e1f-44ae-4264-a99b-000000000000/Sandbox/WS/My%20Company%20Ltd/services
```

{% endcode %}

When asked for credentials enter the credentials for the user you created for Golden EDI. The result could look like this if everything is ok (The result is from Google Chrome web browser):

![Example of a successful configuration when browsing the SOAP web service with Chrome](/files/-LVboP45h_t4Pvsl7nWz)


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.goldenedi.com/business-central/installation/soap-configuration/cloud.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.