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

# Installation Guide

> Follow along with your hands-on installation of the Zamp integration in your Business Central account with this guide.

# Overview

<Note>
  Zamp will assist with every part of the installation on your Business Central account. You can follow along with the steps here, but you will always have a Zamp Integrations Implementation expert on a live call handling the installation.
</Note>

# Prerequisites

| Item                                                                  | Where to Obtain                                                                 |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| A Microsoft Business Central Account with Extension Management Access | Check with your company's admin                                                 |
| An extra Business Central Access Seat                                 | Not required, but check with your company's admin                               |
| Your Zamp API Key for Sandbox or Production                           | The **Integrations** page within your Zamp account, or your Zamp representative |

# Installation Process

<Steps>
  <Step title="Installing the Zamp Extension">
    1. In the Business Central search bar, look for\*\* Microsoft AppSource Apps.\*\*
    2. Search for **Zamp**, and click **Acumens Zamp API for D365 BC.**
    3. Click **Install** and accept the permissions access request.

    <Note>
      The installation may take about 5-minutes. 
    </Note>
  </Step>

  <Step title="Changing to the Acumens User Role">
    1. Click the <Icon icon="gear" /> icon at the top-right of Business Central.
    2. Under **Role**, update the role to **Acumens e-Tax**. 
  </Step>

  <Step title="Entering your API Key">
    1. Search for **Zamp APIs** and allow the configuration to load (\~15-seconds).
    2. Click **ZAMP01**.
    3. Under **API TOKEN**, enter your Sandbox or Production API Key.
  </Step>

  <Step title="Syncing Nexus States and Testing the Connection">
    1. Search for **Nexus States**.
    2. Click **Home**.
    3. Click **Sync Zamp Registrations.**
    4. Once the sync is complete, you will see the following.

    <Frame>
      <img src="https://mintcdn.com/zamp/4aBQjdcHeBAHsZiu/images/i-Synch-is-complete-1.png?fit=max&auto=format&n=4aBQjdcHeBAHsZiu&q=85&s=472bb8faf6601605302adc0c694248a4" alt="I Synch Is Complete 1" width="517" height="187" data-path="images/i-Synch-is-complete-1.png" />
    </Frame>
  </Step>

  <Step title="Configuring Transaction Posting Behavior">
    The integration allows for the flexibility to post transactions in real-time, or on a cadence. It also allows for every invoice to be uploaded as an individual transaction, or invoices for the same customer to be batched together.

    1. Search for **Acumens e-Tax Enterprise Setup**.
    2. Scroll down to **Uploads (Auto-File)**.
    3. Toggle between **Upload Individual Documents** or **Upload Summarized Documents**.
       1. **Upload Individual Documents**: Every invoice is a transaction in Zamp. Not batched.
       2. **Upload Summarized Documents:** Invoices for the same customer will be aggregated to be a single transaction in Zamp each time an upload is attempted.
    4. Under **Background Uploads**, enable **Upload on Post** to post transactions when invoices are posted (i.e. Real-time).
  </Step>
</Steps>

<Card title="Tax Codes and Exemptions" type="tip">
  Once the above steps are completed, Zamp is enabled to calculate and post transactions! To ensure all taxability scenarios are handled, see the\*\* **[Microsoft Business Central](https://support.zamp.com/en/collections/19724189-microsoft-business-central) support** \*\*guides to review mapping product tax codes, customer exemptions, and managing multi-channel sales.
</Card>