Taxjar | Composio Docs

Overview

SLUG: TAXJAR

Description

Template description for Taxjar

Authentication Details

API Key

api_key

stringRequired

Connecting to Taxjar

Create an auth config

Use the dashboard to create an auth config for the Taxjar toolkit. This allows you to connect multiple Taxjar accounts to Composio for agents to use.

Select App

Navigate to Taxjar.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Taxjar Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 taxjar_auth_config_id = "ac_YOUR_TAXJAR_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Taxjar for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, taxjar_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Taxjar toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["TAXJAR"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

TAXJAR_CALCULATE_SALES_TAX_FOR_AN_ORDER

Tool Name: Calculate Sales Tax For An Order

Description

Tool to calculate sales tax for an order. use when you need an accurate tax calculation including nexus addresses, line items, shipping, and exemptions.

Action Parameters

amount

numberRequired

customer_id

string

exemption_type

string

from_city

string

from_country

stringRequired

from_state

stringRequired

from_street

string

from_zip

stringRequired

line_items

array

nexus_addresses

array

shipping

numberRequired

to_city

string

to_country

stringRequired

to_state

stringRequired

to_street

string

to_zip

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_CREATE_ORDER_TRANSACTION

Tool Name: Create Order Transaction

Description

Tool to create a new order transaction. use after preparing transaction details.

Action Parameters

amount

numberRequired

exemption_type

string

line_items

array

nexus_addresses

array

sales_tax

number

shipping

numberRequired

to_city

string

to_country

stringRequired

to_lat

number

to_lng

number

to_state

stringRequired

to_street

string

to_zip

stringRequired

transaction_date

stringRequired

transaction_id

stringRequired

user_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_CREATE_REFUND_TRANSACTION

Tool Name: Create Refund Transaction

Description

Tool to create a new refund transaction. use after confirming refund details.

Action Parameters

amount

numberRequired

line_items

array

provider

string

sales_tax

number

shipping

number

to_city

string

to_country

stringRequired

to_state

stringRequired

to_street

string

to_zip

stringRequired

transaction_date

stringRequired

transaction_id

stringRequired

transaction_reference_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_DELETE_CUSTOMER

Tool Name: Delete Customer

Description

Tool to delete an existing customer. use when you need to remove a previously created customer by its id. example: "delete customer cust 12345".

Action Parameters

customer_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_DELETE_ORDER_TRANSACTION

Tool Name: Delete Order Transaction

Description

Tool to delete an existing order transaction. use when you need to remove a previously created order transaction by its id. example: "delete transaction abc123".

Action Parameters

transaction_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_DELETE_REFUND_TRANSACTION

Tool Name: Delete Refund Transaction

Description

Tool to delete an existing refund transaction. use when you need to remove a previously created refund transaction by its id. example: "delete refund 243345".

Action Parameters

transaction_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_LIST_CUSTOMERS

Tool Name: List Customers

Description

Tool to list existing customers. use when you need to retrieve customer records after they are created.

Action Parameters

page

integerDefaults to 1

per_page

integerDefaults to 30

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_LIST_NEXUS_REGIONS

Tool Name: List Nexus Regions

Description

Tool to list existing nexus regions for an account. use after authenticating your account to discover where you have nexus for sales tax purposes.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_LIST_ORDER_TRANSACTIONS

Tool Name: List Order Transactions

Description

Tool to list existing order transactions. use when you need to retrieve created orders for reporting or analysis.

Action Parameters

from_transaction_date

string

page

integerDefaults to 1

per_page

integerDefaults to 20

provider

string

to_transaction_date

string

transaction_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_LIST_REFUND_TRANSACTIONS

Tool Name: List refund transactions

Description

Tool to list refund transactions. use when you need to retrieve refunds created through the taxjar api.

Action Parameters

page

integerDefaults to 1

per_page

integerDefaults to 20

provider

string

transaction_date

string

transaction_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_LIST_TAX_CATEGORIES

Tool Name: List Tax Categories

Description

Tool to list all product tax categories and their codes. use when you need to discover available tax categories before assigning them to products.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_SHOW_CUSTOMER

Tool Name: Show Customer

Description

Tool to show an existing customer. use when you need to retrieve details of a specific customer via taxjar api.

Action Parameters

customer_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_SHOW_ORDER_TRANSACTION

Tool Name: Show Order Transaction

Description

Tool to show an existing order transaction by id. use when you need to retrieve full details of a specific order transaction after creation or listing.

Action Parameters

transaction_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_SHOW_REFUND_TRANSACTION

Tool Name: Show Refund Transaction

Description

Tool to show a refund transaction. use when you need to retrieve details of an existing refund transaction via taxjar api.

Action Parameters

transaction_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_SHOW_TAX_RATES_FOR_A_LOCATION

Tool Name: Show Tax Rates for a Location

Description

Tool to show sales tax rates for a location. use when you need to retrieve sales tax rates for a specific zip code with optional address details (city, state, country, street).

Action Parameters

city

string

country

string

state

string

street

string

zip

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_SUMMARIZE_TAX_RATES_FOR_ALL_REGIONS

Tool Name: Summarize Tax Rates for All Regions

Description

Tool to retrieve minimum and average sales tax rates by region. use when you need a backup of regional tax summary rates.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_UPDATE_ORDER_TRANSACTION

Tool Name: Update Order Transaction

Description

Tool to update an existing order transaction. use when adjusting order details such as amount, shipping, or line items after creation.

Action Parameters

amount

number

line_items

array

provider

string

sales_tax

number

shipping

number

to_city

string

to_country

string

to_state

string

to_street

string

to_zip

string

transaction_date

string

transaction_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TAXJAR_VALIDATE_VAT_NUMBER

Tool Name: Validate VAT Number

Description

Tool to validate a vat number for tax-exempt status. use when you need to confirm a vat number's validity and existence before applying tax exemptions.

Action Parameters

vat_number

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired