> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chift.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# a3ERP

# 🚨 PREREQUISITES

Technical requirements

* **.NET Framework 4.8** must be installed on the server where **a3ERP** is installed.
* The **local agent** must be installed **on the same server as a3ERP**.\
  → Installation on another machine is **not supported**.

### Access & credentials required

* **a3ERP username** with access to the target company
* **Password** for the above a3ERP user
* A **Windows admin account** to perform the installation
* **Network Drive Access for a3ERP**

  When the a3ERP data is stored on a network/shared drive (e.g. W:), the A3ERPService Windows service must run under a **Windows user account that has access to that drive**.

  The default **Local System** account does not have access to mapped network drives, which will cause a login issue.

  **To fix this:**

  1. Open services.msc
  2. Find A3ERPService, right-click → **Properties**
  3. Go to the **Log On** tab
  4. Switch from *Local System account* to a domain/local user account that has access to the network/shared drive (e.g. W:)
  5. Restart the service

### Supported a3ERP versions

* **14.5.2 → ...**

# 📋**️** FILLING THE FORM

## ❶ Connect

<img src="https://mintcdn.com/chift/6SQIYPF6eM7HJsfP/images/help/a3erp/a3erp-1.png?fit=max&auto=format&n=6SQIYPF6eM7HJsfP&q=85&s=500a0fd1cf65234cb574173c30fa739c" alt="image.png" width="962" height="1436" data-path="images/help/a3erp/a3erp-1.png" />

**Step 1:** Choose a name for your connection. (If this field isn’t visible, simply skip this step and continue)

<img src="https://mintcdn.com/chift/6SQIYPF6eM7HJsfP/images/help/a3erp/a3erp-2.png?fit=max&auto=format&n=6SQIYPF6eM7HJsfP&q=85&s=b457e36c19baf9514073b9d0b77b9cb8" alt="image.png" width="878" height="172" data-path="images/help/a3erp/a3erp-2.png" />

**Step 2:** Select the **default analytic plan**. (If this field isn’t visible, simply skip this step and continue)

<img src="https://mintcdn.com/chift/6SQIYPF6eM7HJsfP/images/help/a3erp/a3erp-3.png?fit=max&auto=format&n=6SQIYPF6eM7HJsfP&q=85&s=43cc9a87fdb527b7045e0b911fc2621a" alt="image.png" width="848" height="164" data-path="images/help/a3erp/a3erp-3.png" />

**Step 3:** Choose the **invoice creation type.** (If this field isn’t visible, simply skip this step and continue)

2 types of invoices can be created in a3ERP:

* Normal invoices
* Accounting invoices

Accounting invoices cannot be sent or printed using a3ERP. Choose the type of invoice you want the integration to create.

<img src="https://mintcdn.com/chift/6SQIYPF6eM7HJsfP/images/help/a3erp/a3erp-4.png?fit=max&auto=format&n=6SQIYPF6eM7HJsfP&q=85&s=f7af2736f71298a0f840ec37d044ddcc" alt="image.png" width="852" height="192" data-path="images/help/a3erp/a3erp-4.png" />

**Step 4:** Enter the **a3ERP username and password**.

<img src="https://mintcdn.com/chift/6SQIYPF6eM7HJsfP/images/help/a3erp/a3erp-5.png?fit=max&auto=format&n=6SQIYPF6eM7HJsfP&q=85&s=1e5ff5c594ddb5ca8b749e32ce7301ae" alt="image.png" width="852" height="332" data-path="images/help/a3erp/a3erp-5.png" />

**Step 5:** Click "Connect" to finalise the form filling.

<img src="https://mintcdn.com/chift/6SQIYPF6eM7HJsfP/images/help/a3erp/a3erp-6.png?fit=max&auto=format&n=6SQIYPF6eM7HJsfP&q=85&s=06da5d52f3d07e3f828befb5f09cd97d" alt="image.png" width="192" height="88" data-path="images/help/a3erp/a3erp-6.png" />

👉 **Two options will be displayed :**

<img src="https://mintcdn.com/chift/6SQIYPF6eM7HJsfP/images/help/a3erp/a3erp-7.png?fit=max&auto=format&n=6SQIYPF6eM7HJsfP&q=85&s=88ce520ea64338a38cd59e2f624c95a2" alt="image.png" width="950" height="568" data-path="images/help/a3erp/a3erp-7.png" />

1. If you are filling the form on the server, click **Download** to get the installation file.
2. If someone else will perform the installation, click **Send by Email** and provide their email address.

# ❷ Configure

<img src="https://mintcdn.com/chift/6SQIYPF6eM7HJsfP/images/help/a3erp/a3erp-8.png?fit=max&auto=format&n=6SQIYPF6eM7HJsfP&q=85&s=157e23b1032dc859cd39b5d07d89a4fb" alt="image.png" width="970" height="836" data-path="images/help/a3erp/a3erp-8.png" />

Once the installer has been downloaded or received, **and before starting the installation**, you must specify the **company code** of the entity in your a3ERP instance you are connecting to.

This step **must be completed prior to the installation process**.

The company code can be found on the **company selection page**, which is the **first screen displayed when launching a3ERP**.

In the example illustrated, the company code is **“ZDEMO”**.

<img src="https://mintcdn.com/chift/6SQIYPF6eM7HJsfP/images/help/a3erp/a3erp-9.png?fit=max&auto=format&n=6SQIYPF6eM7HJsfP&q=85&s=fe9ca411fe2dbbfb58afda17ed0c8d0c" alt="image.png" width="808" height="516" data-path="images/help/a3erp/a3erp-9.png" />

# 💿 Installation process

**Recommendation:** Perform the installation directly on the server running your a3ERP instance.

Perform the installation **directly on the server hosting the a3ERP instance**.

After completing the form and downloading the ZIP archive:

1. Copy the archive to the **a3ERP server**.
2. Extract the contents of `Setup.zip`.
3. Run the executable.
4. Follow the on-screen installation steps to complete the setup.
