![Logo|350](./vertex/vertex-logo.png)

## Overview

Our Vertex integration allows you to automatically generate your tax rates from Vertex and apply them to your ChargeOver invoices.

ChargeOver can utilize Vertex's robust tax configurations to calculate taxes for your invoices. Just configure the connection in ChargeOver and we'll make sure everything is accurate for every line item!

## Calculating Taxes

Before ChargeOver can start sending invoices to Vertex for tax calculations, you need to make sure your Vertex account is configured to calculate things as expected. Sign in to your Vertex account [here](https://community.vertexinc.com/) to view documentation.

Once you have configured Vertex taxes and the connection in ChargeOver, you are ready to start sending invoices for tax calculation.

Whenever you create or edit an invoice, we will send it to Vertex to calculate taxes and will automatically apply it to the invoice.

After saving, you'll see the tax reflected automatically.

Just set it and forget it, ChargeOver and Vertex will handle all your taxes for you!

![](./vertex/tax-example.png)

## Steps to Connect

### In Vertex 

1. Log in to your `Vertex` portal
2. From the left-side navigation menu, choose `Settings` and then `View All Credentials` 
3. Click the ==Create a Credential== button to get started
   * For the `API this credential will map to` choose `Rest API for O Series Calculation`
   * Choose the correct `Partition` (ask Vertex support if you don't know)
   * Enter `ChargeOver` for the `Credential description` 
   * Click the ==Save the Credential== button 

![](./vertex/vertex-setup-1.png)

4. You will be shown a page with your `Client ID`, `Client Secret`, and `OAuth Token URL`. Don't leave this page - you will copy these values from this page into ChargeOver on the next step.

![](./vertex/vertex-setup-2.png)

### In ChargeOver

1. Go to your settings, then select ==Integrations== then search ==Vertex== and click ==Get Started==

![](./vertex/vertex-integration-page.png)

2. Fill in required information

- `Seller Company Code` (Vertex will supply you with this)
- `Client ID` (Copy/paste this from the previous steps in Vertex)
- `Client Secret` (Copy/paste this from the previous steps in Vertex) 
- `Company Address`

![](./vertex/vertex-setup-3.png)

3. Click ==Save==

:::note

If you need to change the endpoints, please reach out to support to get that information updated.

:::



**You're ready to calculate taxes!**

## Tax calculations with Vertex 

### Data sent to Vertex 

When ChargeOver needs to calculate sales tax, ChargeOver sends a number of pieces of data to Vertex so that tax can be 
calculated accurately. 

This data includes: 

* Seller address (your business address) 
* Destination address (the customer's billing address) 
* ChargeOver's integer customer ID (sent as the Vertex `customerCode` attribute)
* Each invoice line item, with...
   * The product name (or, if you have a QuickBooks or Xero SKU set, that SKU instead)
   * The quantity, rate, and subtotal for the line 
* The invoice date 

There are some pieces of data that ChargeOver does _not_ send to Vertex currently: 

* a Vertex product `productClass`
* a Vertex customer `classCode`
* a Vertex `locationCode`


:::note

Interested in `productClass`, `classCode`, `locationCode`, or other attributes? !

:::

### Tax exempt customers

Tax-exempt customers (for example: schools, government agencies, hospitals, etc.) are handled _within Vertex_. You will 
mark the customer as exempt from sales tax within Vertex. 

When setting up tax-exempt customers, it is important that you:

1. Choose `Code` for the Vertex `Customer Type` field 
2. Put the ChargeOver `Customer ID #` in the `Customer Code/Class` field in Vertex 

![](./vertex/customer-exempt.png)

### Product mappings

You can map ChargeOver products to particular hats or categories of products within Vertex. 

When mapping products, it is important that you: 

1. Choose `Product Code` for the Vertex `Type` field 
2. Put the ChargeOver product `Name` or `QuickBooks or Xero SKU` field for the `Code/Class` field in Vertex 

![](./vertex/product-example.png)

### Processing fees / surcharges

Due to technical limitations, ChargeOver always sends credit card processing fees and merchant surcharges to Vertex as 
non-taxable products.