Picture of Connecting and configuring TaxJar for Infigo | CI_TaxJar_001

Connecting and configuring TaxJar for Infigo | CI_TaxJar_001

TaxJar is a sales tax compliance software for which we have created an integration with Infigo. This allows our users to calculate sales tax rates during the ordering process. Traditionally, this functionality was only available to our US customers, who often have to deal with complex sales tax rates between states. However, we are now rolling out this functionality to all countries supported by the TaxJar API. This covers the EU, Canada, the US, Australia and the UK. If you'd like to take advantage the TaxJar integration then you will require the professional version of their product which then includes the API look ups. At the time of writing, TaxJar do offer a 30 day trial of their professional version, which does include API access. To sign up, please go to - https://taxjar.grsm.io/infigosoftware

Tutorial Video Transcript

A transcript of our tutorial video, ensuring you can find exactly what you need, when you need it.

You can search this page to find the relevant time-stamp in the video. Also, this text can be used as part of the tutorial search feature.

00:00:07:16 - 00:00:10:13
TaxJar is a sales tax compliance software

00:00:10:13 - 00:00:13:15
for which we've created an integration
with Infigo.

00:00:14:03 - 00:00:18:23
This allows our users to calculate sales
tax rates during the ordering process.

00:00:20:02 - 00:00:24:09
Now, traditionally, this functionality
was only available to our US customers

00:00:24:24 - 00:00:27:27
who often have to deal with complex sales
tax rates

00:00:27:27 - 00:00:30:01
between states.

00:00:30:01 - 00:00:32:10
However,
we're now rolling out this functionality

00:00:32:10 - 00:00:35:15
to all countries supported by the TaxJar API.

00:00:35:27 - 00:00:40:05
This covers the EU, Canada,
the US, Australia and the UK.

00:00:41:08 - 00:00:44:10
If you'd like to take advantage
of the TaxJar integration,

00:00:44:17 - 00:00:48:05
then you will require
the professional version of their product,

00:00:48:05 - 00:00:52:12
which then includes
the API lookups at the time of writing.

00:00:52:13 - 00:00:56:11
TaxJar do offer a 30 day
trial of their professional version,

00:00:56:21 - 00:00:58:16
which does include API access.

00:00:58:16 - 00:01:03:20
If you want to give this a try.

00:01:06:21 - 00:01:12:10
To begin, we're going to navigate
to our tax providers screen.

00:01:15:21 - 00:01:18:01
If enabled, a TaxJar

00:01:18:15 - 00:01:22:05
and entry will be displayed
on this tax provider screen.

00:01:22:21 - 00:01:26:05
If this is your first time
configuring TaxJar with Infigo,

00:01:26:14 - 00:01:28:28
you'll likely need to enable it
on your platform.

00:01:29:12 - 00:01:34:12
Please submit a support ticket
under a new module inquiry to request this

00:01:35:10 - 00:01:39:10
and then we'll let you know
once this has been enabled.

00:01:43:01 - 00:01:43:22
So we need to mark

00:01:43:22 - 00:01:47:01
the TaxJar
plug in as the primary tax provider.

00:01:47:09 - 00:01:50:08
We do this by clicking select
next to the relevant row.

00:01:50:23 - 00:01:53:11
So by default you'll likely have fixed tax

00:01:53:11 - 00:01:55:26
rate provider
marked as the primary provider.

00:01:56:17 - 00:01:59:29
Just locate the TaxJar row
when you've got it activated

00:02:00:22 - 00:02:03:10
and click on select.

00:02:05:07 - 00:02:07:09
Next, we need to actually configure

00:02:07:09 - 00:02:10:12
the TaxJar plugin
with a few additional bits of information.

00:02:10:27 - 00:02:13:29
So sticking on the same row
go across to the configure

00:02:13:29 - 00:02:22:07
icon.

00:02:23:29 - 00:02:26:25
So next
you're going to need to obtain your API

00:02:26:25 - 00:02:33:21
key from your TaxJar account.

00:02:33:21 - 00:02:37:03
so begin by navigating to TaxJar
and logging into your account.

00:02:37:14 - 00:02:41:24
And then you want to identify the TaxJar
API token page.

00:02:42:04 - 00:02:44:14
Now at the time of writing,
this is located

00:02:44:26 - 00:02:47:25
under the account section

00:02:47:25 - 00:02:49:08
and then tax your API.

00:02:49:08 - 00:02:52:22
But of course this is subject to move.

00:02:55:25 - 00:02:56:07
Once you've

00:02:56:07 - 00:03:00:15
access this page, you'll have access
to a live token along with the ability

00:03:00:15 - 00:03:05:18
to generate and use a sandbox token
which you can use for testing purposes.

00:03:06:16 - 00:03:08:23
So you want to copy the relevant token.

00:03:08:23 - 00:03:12:02
You can use this button
on the right hand side and then return

00:03:12:02 - 00:03:15:04
to the TaxJar
configuration page within Infigo

00:03:19:19 - 00:03:20:06
it and

00:03:20:06 - 00:03:23:25
put the copied token into the API
key field here.

00:03:23:25 - 00:03:26:15
So just copy and paste it

00:03:35:25 - 00:03:37:21
and then we can
look at some of the other options

00:03:37:21 - 00:03:40:23
that we have available.

00:03:43:26 - 00:03:44:29
So the next option down

00:03:44:29 - 00:03:47:19
is the default tax for invalid address.

00:03:48:03 - 00:03:53:26
So here you can specify a default
tax value for use if the address is

00:03:53:26 - 00:03:57:10
classified
as invalid and a price can not be obtained

00:03:57:10 - 00:04:00:05
from TaxJar itself.

00:04:02:03 - 00:04:05:26
Next time we have include city
in rates for location code.

00:04:06:11 - 00:04:09:22
So this allows further
refinement of the rates calculation

00:04:10:02 - 00:04:12:07
by including the city field.

00:04:13:01 - 00:04:16:27
So this field is drawn from either
the default customer address

00:04:17:05 - 00:04:20:28
or the taxed based on setting,
which I'll show in a few minutes,

00:04:21:20 - 00:04:23:18
which is under the tax settings.

00:04:23:18 - 00:04:26:09
And this setting allows
the selection of the billing,

00:04:26:09 - 00:04:33:10
shipping or a default address.

00:04:33:10 - 00:04:37:03
We then have include street floor
rates for location code.

00:04:37:15 - 00:04:40:10
This is the same
as the one above but is looking at the

00:04:41:09 - 00:04:43:27
address one field

00:04:43:27 - 00:04:46:10
rather than the city

00:04:49:26 - 00:04:51:04
and then scrolling down again.

00:04:51:04 - 00:04:53:16
This is where we have the ability
to select

00:04:54:08 - 00:04:56:16
the TaxJar, plug in to

00:04:57:25 - 00:05:00:08
be applicable to different countries.

00:05:00:08 - 00:05:03:23
So by default
we have applied for the United States

00:05:04:02 - 00:05:06:20
and in the case of my platform,
the United Kingdom,

00:05:07:04 - 00:05:12:04
you'll see that we have all of the other
available countries within the TaxJar API

00:05:12:17 - 00:05:15:25
and those can just be activated
by clicking the enable key

00:05:17:05 - 00:05:20:07
and then make sure we click
Save at the bottom to store

00:05:20:10 - 00:05:23:11
all of those settings.

00:05:26:16 - 00:05:27:04
So next

00:05:27:04 - 00:05:36:07
we want to navigate to our tax categories.

00:05:36:07 - 00:05:41:24
So products requiring tax calculation
by TaxJar require a tax category

00:05:41:26 - 00:05:46:01
to be specified so we can create these
on this particular screen.

00:05:47:13 - 00:05:50:16
So in this case,
make a brand new ones for go and add new

00:05:51:26 - 00:05:52:25
that I'm just going to type

00:05:52:25 - 00:06:00:22
in a tax category name.

00:06:00:22 - 00:06:02:01
So your tax categories

00:06:02:01 - 00:06:05:29
are the different bands of tax
that can be applied to products.

00:06:05:29 - 00:06:09:22
So on the tax category screen,
you are specifying

00:06:09:22 - 00:06:12:00
little more than a category name.

00:06:12:00 - 00:06:14:19
How this category is used,
such as its rate

00:06:15:12 - 00:06:17:18
is specified in other areas of Infigo

00:06:18:22 - 00:06:22:29
Depending on the scenario, a tax
category might relate to particular rates.

00:06:23:10 - 00:06:27:20
The behavior of a particular country,
or in this case we might simply

00:06:27:20 - 00:06:31:25
just create a category
specifically to be assigned for TaxJar

00:06:31:25 - 00:06:38:14
click on

00:06:38:14 - 00:06:43:01
save to store that tax category.

00:06:43:01 - 00:06:45:28
Next, I'm going to navigate
to my product management.

00:06:47:04 - 00:06:50:15
So we must assign a tax category

00:06:50:15 - 00:06:54:21
to the products we wish
to have the rate calculated by TaxJar

00:06:54:21 - 00:06:59:03
Joe So these options are defined
in the product variance settings.

00:06:59:15 - 00:07:02:29
The easiest way to access
these is by clicking on the plus icon

00:07:03:11 - 00:07:05:19
next to your product of interest.

00:07:06:13 - 00:07:09:04
And then the table that appears
is the product variance settings.

00:07:09:15 - 00:07:17:09
So we can click on edit
over on the right hand side of that table.

00:07:17:09 - 00:07:22:10
We then make sure we're on the info tab
and scrolling quite far down this list,

00:07:23:20 - 00:07:26:12
you'll see we have a tax section
available.

00:07:27:01 - 00:07:29:23
One is the options
just to make the product tax exempt.

00:07:29:29 - 00:07:31:24
So no tax at all.

00:07:31:24 - 00:07:35:11
Otherwise we can select
from the available list of tax categories.

00:07:36:07 - 00:07:40:14
So you can have multiple sites here
or you can just have one small select.

00:07:40:14 - 00:07:43:14
So our newly created tax category
in this case in this case

00:07:46:18 - 00:07:53:15
and click save.

00:07:53:15 - 00:07:56:15
Finally to complete this process,
we're going to go to our tax

00:07:56:15 - 00:08:04:28
settings.

00:08:04:28 - 00:08:06:14
So I mentioned this a little earlier on.

00:08:06:14 - 00:08:09:18
We do have this tax based on field here,

00:08:10:06 - 00:08:13:00
which allows you to choose
whether the billing or shipping

00:08:13:00 - 00:08:15:20
address of a customer is used for tax
purposes.

00:08:17:03 - 00:08:21:18
Defaults can also be selected
in this dropdown, at which point

00:08:21:18 - 00:08:25:09
the following series of default
tax address

00:08:25:09 - 00:08:29:05
details are utilized.

00:08:29:05 - 00:08:32:07
So these default details
also act as a fallback should

00:08:32:07 - 00:08:38:26
the primary option not be available.

00:08:38:26 - 00:08:42:14
So moving up a little bit,
we also have some tax display options.

00:08:42:20 - 00:08:45:26
Now, there's no requirement
to modify these for the TaxJar plugin.

00:08:45:26 - 00:08:50:21
However, it can be useful in order to see
that it's functioning correctly. So

00:08:51:22 - 00:08:53:27
in this selection, here are

00:08:53:28 - 00:08:57:18
a number of display options
which will impact how the tax is displayed

00:08:57:28 - 00:09:01:22
to the end user whilst navigating
the front end of your storefront.

00:09:02:07 - 00:09:04:17
So you can just select those
as you see necessary

00:09:05:04 - 00:09:11:22
and then make sure you click save.

00:09:11:22 - 00:09:14:05
So that's
how configuration completes in this stage.

00:09:14:11 - 00:09:17:07
We're now going to test
whether or not plug in is working

00:09:17:26 - 00:09:20:24
so I'm going to go first to my

00:09:20:24 - 00:09:23:16
customer management screen.

00:09:23:16 - 00:09:27:08
Now, what I've got in my case
is a few test uses which I've set up

00:09:28:19 - 00:09:30:10
and all I've done in these test uses.

00:09:30:10 - 00:09:32:22
So if I go into our California
one for example,

00:09:33:03 - 00:09:38:00
is I've made sure they've got addresses
specified in different locations.

00:09:38:00 - 00:09:41:29
In this case, I've done it in different US
states as that's the primary use case

00:09:42:09 - 00:09:57:08
for the TaxJar plug in up to this point.

00:09:57:08 - 00:10:00:18
So I'm going to impersonate
one of these users to view the frontend

00:10:01:06 - 00:10:03:03
of our storefront as they would

00:10:06:13 - 00:10:09:02
now. Depending on your tax settings,
updated tax

00:10:09:02 - 00:10:12:16
information will be displayed
as early as the home page itself.

00:10:13:03 - 00:10:16:15
So you see, for example, in this case,
I've got a few featured products

00:10:16:27 - 00:10:19:20
where I've got the price being displayed,
including the

00:10:20:06 - 00:10:28:22
OR including our tax.

00:10:28:22 - 00:10:33:09
The basket can also be configured
to display the amount of tax calculated

00:10:33:18 - 00:10:36:04
along with the rate drawn from TaxJar

00:10:37:07 - 00:10:40:17
So in this particular case, we can see
that I've got my individual products

00:10:40:17 - 00:10:43:22
in my basket with the VAT included
or the tax included.

00:10:44:07 - 00:10:47:07
And also on the right hand side,
you can see I've got different

00:10:48:04 - 00:10:50:10
tax rates
being brought in all two different

00:10:52:03 - 00:10:58:00
two different sections.

00:10:58:00 - 00:11:04:06
And in this case, we can see two tax fees
due to they've been different products

00:11:04:06 - 00:11:11:16
in the basket
being in different tax categories.

00:11:11:16 - 00:11:15:12
I'm now going to impersonate
to use a case in a different state

00:11:15:12 - 00:11:25:11
to see if we get a different tax rate
being brought through.

00:11:25:11 - 00:11:29:03
So I can see that already that I've got
some different prices being shown.

00:11:29:20 - 00:11:33:23
And if I go back to my basket here,
I can see that the rates of tax

00:11:33:23 - 00:11:36:26
being brought through differs
from what I previously saw.

00:11:37:16 - 00:11:41:18
That's because the different rates for
the different states are being brought

00:11:41:18 - 00:11:46:23
through from TaxJar.

 

Incomplete