> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Avalara AvaTax

The Avalara AvaTax connector lets your AI agent work with Avalara AvaTax. Scalekit handles authentication for every call, so your agent never handles credentials. It comes with 25 tools.

**Authentication:** Account ID and License Key
**Categories:** Accounting & Finance
**Tools:** 25: 16 read, 8 write, 1 destructive
**Users sign in with:** Username and password
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=AVALARA)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Avalara AvaTax connection

   In **AgentKit > Connections**, create an Avalara AvaTax connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'avalara_address_resolve',
  toolInput: {},
  connector: 'avalara',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="avalara_address_resolve",
    tool_input={},
    connection_name="avalara",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `avalara_address_resolve`

Resolve Address · Read-only

Validate and normalize a US or Canadian address against Avalara's address database.
Returns validatedAddresses with the normalized address, latitude and longitude, resolutionQuality, the tax jurisdictions that apply, and any messages if it could not be resolved.
Use avalara_address_resolve to clean an address before a transaction. Use avalara_tax_rates_by_address_get for an estimated rate.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `city` (`string`, optional): City. Example: Irvine
- `country` (`string`, optional): Two-letter ISO 3166 country code. Example: US
- `line1` (`string`, optional): Street address line 1. Example: 2000 Main Street
- `line2` (`string`, optional): Street address line 2. Example: Suite 200
- `line3` (`string`, optional): Street address line 3. Example: Building B
- `postal_code` (`string`, optional): Postal or ZIP code. Example: 92614
- `region` (`string`, optional): State, province or region, as a two-letter code or full name. Example: CA
- `text_case` (`string`, optional): Text case of the returned address: Default, Upper or Mixed. Example: Mixed. One of: `Default`, `Upper`, `Mixed`.

Example input: `{}`

### `avalara_companies_list`

List Companies · Read-only

List the companies in the AvaTax account, with filtering, sorting and paging.
Returns value[] with id, companyCode, name, isDefault, isActive, taxpayerIdNumber and defaultCountry, plus @recordsetCount.
Use avalara_companies_list to find a company's numeric id and companyCode. Use avalara_company_get for one company.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `filter` (`string`, optional): AvaTax filter expression on the record fields (eq, ne, gt, lt, contains, startswith, and, or). See https://developer.avalara.com/avatax/filtering-in-rest/. Example: isActive eq true
- `include` (`string`, optional): Comma-separated extra data to return: child objects such as Contacts, Items, Locations, Nexus, Settings, TaxCodes, TaxRules, UPCs. Example: Locations,Nexus
- `order_by` (`string`, optional): Sort order as 'field ASC|DESC', comma-separated for several. Example: companyCode ASC
- `skip` (`integer`, optional): Number of records to skip before returning results, for paging. Example: 100
- `top` (`integer`, optional): Maximum records to return (up to 1000). Use with skip to page. Example: 100

Example input: `{}`

### `avalara_company_get`

Get Company · Read-only

Get one AvaTax company by its numeric ID.
Returns the company's code, name, tax ID, default country, settings and, with include, its contacts, items, locations, nexus or tax codes.
Use avalara_company_get for a known ID. Use avalara_companies_list to find IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`integer`, required): Numeric ID of the company to get. Use avalara_companies_list to find it (the id field, not companyCode). Example: 12345
- `include` (`string`, optional): Comma-separated extra data to return: Contacts, FilingCalendars, Items, Locations, Nexus, TaxCodes. Example: Locations,Nexus

Example input: `{"company_id":12345}`

### `avalara_item_get`

Get Item · Read-only

Get one item from an AvaTax company's catalog.
Returns its itemCode, description, taxCode, group, category and, with include, parameters and classifications.
Use avalara_item_get before avalara_item_update to read the current values.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`integer`, required): Numeric ID of the company that owns the item. Use avalara_companies_list to find it (the id field, not companyCode). Example: 12345
- `item_id` (`integer`, required): Numeric ID of the item. Example: 1234567
- `include` (`string`, optional): Comma-separated extra data to return: Parameters, Classifications, Tags. Example: Parameters,Classifications

Example input: `{"company_id":12345,"item_id":1234567}`

### `avalara_items_list`

List Items · Read-only

List the items (products and services) in an AvaTax company's catalog, with filtering and paging.
Returns value[] with id, itemCode, description, taxCode, itemGroup and category.
Use avalara_items_list to find item IDs or check tax codes. Use avalara_item_get for one item.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`integer`, required): Numeric ID of the company that owns the records. Use avalara_companies_list to find it (the id field, not companyCode). Example: 12345
- `filter` (`string`, optional): AvaTax filter expression on the record fields (eq, ne, gt, lt, contains, startswith, and, or). See https://developer.avalara.com/avatax/filtering-in-rest/. Example: itemCode startswith 'SKU-'
- `include` (`string`, optional): Comma-separated extra data to return: Parameters, Classifications, Tags. Example: Parameters,Classifications
- `order_by` (`string`, optional): Sort order as 'field ASC|DESC', comma-separated for several. Example: itemCode ASC
- `skip` (`integer`, optional): Number of records to skip before returning results, for paging. Example: 100
- `tag_name` (`string`, optional): Only items with this tag. Example: seasonal
- `top` (`integer`, optional): Maximum records to return (up to 1000). Use with skip to page. Example: 100

Example input: `{"company_id":12345}`

### `avalara_location_get`

Get Location · Read-only

Get one business location of an AvaTax company.
Returns the location's code, description, address and settings.
Use avalara_location_get with an ID from avalara_locations_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`integer`, required): Numeric ID of the company that owns the location. Use avalara_companies_list to find it (the id field, not companyCode). Example: 12345
- `location_id` (`integer`, required): Numeric ID of the location. Example: 56789
- `include` (`string`, optional): Comma-separated extra data to return: Settings, Parameters. Example: Settings

Example input: `{"company_id":12345,"location_id":56789}`

### `avalara_locations_list`

List Locations · Read-only

List the business locations (stores, warehouses, offices) of an AvaTax company.
Returns value[] with id, locationCode, description, address fields and addressTypeId.
Use avalara_locations_list to find location IDs and codes. Use avalara_location_get for one location.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`integer`, required): Numeric ID of the company that owns the records. Use avalara_companies_list to find it (the id field, not companyCode). Example: 12345
- `filter` (`string`, optional): AvaTax filter expression on the record fields (eq, ne, gt, lt, contains, startswith, and, or). See https://developer.avalara.com/avatax/filtering-in-rest/. Example: region eq 'CA'
- `include` (`string`, optional): Comma-separated extra data to return: Settings, Parameters. Example: Settings
- `order_by` (`string`, optional): Sort order as 'field ASC|DESC', comma-separated for several. Example: locationCode ASC
- `skip` (`integer`, optional): Number of records to skip before returning results, for paging. Example: 100
- `top` (`integer`, optional): Maximum records to return (up to 1000). Use with skip to page. Example: 100

Example input: `{"company_id":12345}`

### `avalara_nexus_list`

List Company Nexus · Read-only

List the jurisdictions where an AvaTax company has declared nexus (an obligation to collect tax).
Returns value[] with id, country, region, jurisDname, jurisTypeId, nexusTypeId, effectiveDate and endDate.
Use avalara_nexus_list to check where a company collects tax.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`integer`, required): Numeric ID of the company that owns the records. Use avalara_companies_list to find it (the id field, not companyCode). Example: 12345
- `filter` (`string`, optional): AvaTax filter expression on the record fields (eq, ne, gt, lt, contains, startswith, and, or). See https://developer.avalara.com/avatax/filtering-in-rest/. Example: region eq 'WA'
- `include` (`string`, optional): Comma-separated extra data to return: Parameters. Example: Parameters
- `order_by` (`string`, optional): Sort order as 'field ASC|DESC', comma-separated for several. Example: region ASC
- `skip` (`integer`, optional): Number of records to skip before returning results, for paging. Example: 100
- `top` (`integer`, optional): Maximum records to return (up to 1000). Use with skip to page. Example: 100

Example input: `{"company_id":12345}`

### `avalara_ping`

Ping · Read-only

Test the connection to AvaTax and report whether the credentials authenticated.
Returns version, authenticated (true or false), authenticationType, userName, userId and accountId.
Use avalara_ping to check credentials. Use avalara_subscriptions_list to see which services the account has.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `avalara_subscriptions_list`

List Subscriptions · Read-only

List the Avalara services the authenticated account is subscribed to.
Returns subscriptions with subscriptionTypeId, subscriptionDescription, effectiveDate and endDate.
Use avalara_subscriptions_list to check whether a feature (for example AvaTaxPro or exemption certificates) is available.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `avalara_tax_codes_list`

List Tax Codes · Read-only

List the Avalara system tax codes that describe how products and services are taxed.
Returns value[] with taxCode (for example P0000000 or PC040100), description, taxCodeTypeId and parentTaxCode.
Use avalara_tax_codes_list to pick the taxCode for transaction lines or items.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `filter` (`string`, optional): AvaTax filter expression on the record fields (eq, ne, gt, lt, contains, startswith, and, or). See https://developer.avalara.com/avatax/filtering-in-rest/. Example: description contains 'clothing'
- `order_by` (`string`, optional): Sort order as 'field ASC|DESC', comma-separated for several. Example: taxCode ASC
- `skip` (`integer`, optional): Number of records to skip before returning results, for paging. Example: 100
- `top` (`integer`, optional): Maximum records to return (up to 1000). Use with skip to page. Example: 100

Example input: `{}`

### `avalara_tax_rates_by_address_get`

Get Tax Rates by Address · Read-only

Estimate the combined sales tax rate for a US street address, assuming general tangible goods sold at retail.
Returns totalRate and rates[] with each jurisdiction's rate, name and type.
Use avalara_tax_rates_by_address_get for a quick rate estimate. Use avalara_transaction_create for an exact tax calculation with nexus, product taxability and exemptions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `country` (`string`, required): Country code or name; only US is supported. Example: US
- `line1` (`string`, required): Street address of the location. Example: 2000 Main Street
- `postal_code` (`string`, required): ZIP code. Example: 92614
- `region` (`string`, required): State as a two-letter code or full name. Example: CA
- `city` (`string`, optional): City name. Example: Irvine
- `line2` (`string`, optional): Street address line 2. Example: Suite 200
- `line3` (`string`, optional): Street address line 3. Example: Building B

Example input: `{"country":"<country>","line1":"<line1>","postal_code":"<postal_code>","region":"<region>"}`

### `avalara_transaction_audit`

Audit Transaction · Read-only

Get the original API request and response that created a transaction, for debugging tax results.
Returns the original call's timestamp, server details, request body and response.
Use avalara_transaction_audit to see exactly what a client sent. Use avalara_transaction_get for the current transaction.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_code` (`string`, required): Company code of the company that recorded the transaction (companyCode from avalara_companies_list, often DEFAULT). Example: DEFAULT
- `transaction_code` (`string`, required): Code of the transaction to audit (the code you set, or the GUID AvaTax assigned). Example: INV-1001

Example input: `{"company_code":"<company_code>","transaction_code":"<transaction_code>"}`

### `avalara_transaction_get`

Get Transaction · Read-only

Get one transaction by company code and transaction code.
Returns the latest version with status, totals, addresses, lines and per-jurisdiction tax details.
Use avalara_transaction_get when you know the code. Use avalara_transaction_get_by_id for a numeric ID, including older versions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_code` (`string`, required): Company code of the company that recorded the transaction (companyCode from avalara_companies_list, often DEFAULT). Example: DEFAULT
- `transaction_code` (`string`, required): Code of the transaction to get (the code you set, or the GUID AvaTax assigned). Example: INV-1001
- `document_type` (`string`, optional): Document type of the transaction, when the same code exists for more than one type. Defaults to SalesInvoice. Example: SalesInvoice. One of: `SalesOrder`, `SalesInvoice`, `PurchaseOrder`, `PurchaseInvoice`, `ReturnOrder`, `ReturnInvoice`, `InventoryTransferOrder`, `InventoryTransferInvoice`, `ReverseChargeOrder`, `ReverseChargeInvoice`, `CustomsInvoice`, `CustomsOrder`, `InventoryTransferOutboundInvoice`, `InventoryTransferOutboundOrder`, `Any`.
- `include` (`string`, optional): Extra data in the response, comma-separated: Lines, Details, Summary, Addresses, SummaryOnly, LinesOnly, TaxDetailsByTaxType, ForceTimeout. Example: Summary,Addresses

Example input: `{"company_code":"<company_code>","transaction_code":"<transaction_code>"}`

### `avalara_transaction_get_by_id`

Get Transaction by ID · Read-only

Get one transaction by its numeric AvaTax ID.
Returns that exact version of the transaction with totals, lines and tax details; an adjusted transaction keeps its old versions under their own IDs.
Use avalara_transaction_get_by_id with an id from a list or create result. Use avalara_transaction_get to fetch by code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `transaction_id` (`integer`, required): Numeric transaction ID (the id field of a transaction). Example: 123456789
- `include` (`string`, optional): Extra data in the response, comma-separated: Lines, Details, Summary, Addresses, SummaryOnly, LinesOnly, TaxDetailsByTaxType, ForceTimeout. Example: Summary,Addresses

Example input: `{"transaction_id":123456789}`

### `avalara_transactions_list`

List Transactions · Read-only

List the transactions recorded for one AvaTax company, with filtering, sorting and paging; by default only the last 30 days.
Returns value[] with id, code, type, date, status, customerCode, totalAmount and totalTax, plus @recordsetCount.
Use avalara_transactions_list to search transactions (filter on date to see older ones). Use avalara_transaction_get for one transaction with lines.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_code` (`string`, required): Company code of the company that recorded the transaction (companyCode from avalara_companies_list, often DEFAULT). Example: DEFAULT
- `data_source_id` (`integer`, optional): Only transactions from this data source ID. Example: 12
- `filter` (`string`, optional): AvaTax filter expression on the record fields (eq, ne, gt, lt, contains, startswith, and, or). See https://developer.avalara.com/avatax/filtering-in-rest/. Example: date ge '2026-10-01' and status eq 'Committed'
- `include` (`string`, optional): Comma-separated extra data to return: Lines, Details, Summary, Addresses, SummaryOnly, LinesOnly. Example: Summary
- `order_by` (`string`, optional): Sort order as 'field ASC|DESC', comma-separated for several. Example: date DESC
- `skip` (`integer`, optional): Number of records to skip before returning results, for paging. Example: 100
- `top` (`integer`, optional): Maximum records to return (up to 1000). Use with skip to page. Example: 100

Example input: `{"company_code":"<company_code>"}`

### `avalara_item_create`

Create Item · Write

Add an item (product or service) with its tax code to an AvaTax company's catalog.
Returns an array with the created item, including its id.
Use avalara_item_create so transaction lines can send just itemCode. Use avalara_item_update to change an existing item.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `company_id` (`integer`, required): Numeric ID of the company to add the item to. Use avalara_companies_list to find it (the id field, not companyCode). Example: 12345
- `description` (`string`, required): Description of the item. Example: Cotton T-shirt
- `item_code` (`string`, required): Unique code for the item, usually the SKU. Example: SKU-1001
- `category` (`string`, optional): Product category path, with levels separated by ' > '. Example: Clothing > Shirts
- `item_group` (`string`, optional): Group for similar items. Example: Apparel
- `tax_code` (`string`, optional): Avalara tax code for the item, from avalara_tax_codes_list. Example: PC040100

Example input: `{"company_id":12345,"description":"<description>","item_code":"<item_code>"}`

### `avalara_item_update`

Update Item · Write

Replace an item in an AvaTax company's catalog; fields left empty are cleared.
Returns the updated item.
Use avalara_item_update to change an item's tax code or description; read it first with avalara_item_get and send every value you want to keep.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`integer`, required): Numeric ID of the company that owns the item. Use avalara_companies_list to find it (the id field, not companyCode). Example: 12345
- `description` (`string`, required): Description of the item. Example: Cotton T-shirt, organic
- `item_code` (`string`, required): Item code (SKU); send the current code to keep it. Example: SKU-1001
- `item_id` (`integer`, required): Numeric ID of the item to update. Example: 1234567
- `category` (`string`, optional): Product category path, with levels separated by ' > '. Example: Clothing > Shirts
- `item_group` (`string`, optional): Group for similar items. Example: Apparel
- `tax_code` (`string`, optional): Avalara tax code for the item, from avalara_tax_codes_list. Example: PC040100

Example input: `{"company_id":12345,"description":"<description>","item_code":"<item_code>","item_id":1234567}`

### `avalara_transaction_adjust`

Adjust Transaction · Write

Replace a saved or committed transaction with a corrected version, recording why it changed.
Returns the new version of the transaction; the old version stays under its own ID with status Adjusted.
Use avalara_transaction_adjust to correct amounts, lines or addresses. Use avalara_transaction_void to cancel it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `adjustment_reason` (`string`, required): Why the transaction is being adjusted. Example: PriceAdjusted. One of: `NotAdjusted`, `SourcingIssue`, `ReconciledWithGeneralLedger`, `ExemptCertApplied`, `PriceAdjusted`, `ProductReturned`, `ProductExchanged`, `BadDebt`, `Other`, `Offline`, `Offset`.
- `company_code` (`string`, required): Company code of the company that recorded the transaction (companyCode from avalara_companies_list, often DEFAULT). Example: DEFAULT
- `new_transaction` (`object`, required): The full corrected transaction, in the same shape as avalara_transaction_create's body (type, code, companyCode, date, customerCode, addresses, lines and so on). Example: {"type": "SalesInvoice", "code": "INV-1001", "companyCode": "DEFAULT", "date": "2026-11-15", "customerCode": "CUST-001", "addresses": {"singleLocation": {"line1": "2000 Main Street", "city": "Irvine", "region": "CA", "postalCode": "92614", "country": "US"}}, "lines": [{"amount": 120}]}
- `transaction_code` (`string`, required): Code of the transaction to adjust (the code you set, or the GUID AvaTax assigned). Example: INV-1001
- `adjustment_description` (`string`, optional): Free-text reason; required when adjustment_reason is Other. Example: Customer moved
- `document_type` (`string`, optional): Document type of the transaction, when the same code exists for more than one type. Defaults to SalesInvoice. Example: SalesInvoice. One of: `SalesOrder`, `SalesInvoice`, `PurchaseOrder`, `PurchaseInvoice`, `ReturnOrder`, `ReturnInvoice`, `InventoryTransferOrder`, `InventoryTransferInvoice`, `ReverseChargeOrder`, `ReverseChargeInvoice`, `CustomsInvoice`, `CustomsOrder`, `InventoryTransferOutboundInvoice`, `InventoryTransferOutboundOrder`, `Any`.
- `include` (`string`, optional): Extra data in the response, comma-separated: Lines, Details, Summary, Addresses, SummaryOnly, LinesOnly, TaxDetailsByTaxType, ForceTimeout. Example: Summary,Addresses

Example input: `{"adjustment_reason":"NotAdjusted","company_code":"<company_code>","new_transaction":{},"transaction_code":"<transaction_code>"}`

### `avalara_transaction_commit`

Commit Transaction · Write

Commit (or un-commit with commit false) a saved transaction so it is included in tax reporting.
Returns the transaction with status Committed.
Use avalara_transaction_commit after creating an uncommitted SalesInvoice. Use avalara_transaction_uncommit to move a committed one back to Saved.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `commit` (`boolean`, required): true to commit the transaction for reporting. Example: true. Default: `true`.
- `company_code` (`string`, required): Company code of the company that recorded the transaction (companyCode from avalara_companies_list, often DEFAULT). Example: DEFAULT
- `transaction_code` (`string`, required): Code of the transaction to commit (the code you set, or the GUID AvaTax assigned). Example: INV-1001
- `document_type` (`string`, optional): Document type of the transaction, when the same code exists for more than one type. Defaults to SalesInvoice. Example: SalesInvoice. One of: `SalesOrder`, `SalesInvoice`, `PurchaseOrder`, `PurchaseInvoice`, `ReturnOrder`, `ReturnInvoice`, `InventoryTransferOrder`, `InventoryTransferInvoice`, `ReverseChargeOrder`, `ReverseChargeInvoice`, `CustomsInvoice`, `CustomsOrder`, `InventoryTransferOutboundInvoice`, `InventoryTransferOutboundOrder`, `Any`.
- `include` (`string`, optional): Extra data in the response, comma-separated: Lines, Details, Summary, Addresses, SummaryOnly, LinesOnly, TaxDetailsByTaxType, ForceTimeout. Example: Summary,Addresses

Example input: `{"commit":true,"company_code":"<company_code>","transaction_code":"<transaction_code>"}`

### `avalara_transaction_create`

Create Transaction · Write

Calculate tax for a sale, purchase, return or transfer and, for Invoice document types, record it in AvaTax.
Returns the transaction with id, code, status, totalAmount, totalTax, and lines with per-jurisdiction tax details.
Use avalara_transaction_create with type SalesOrder for a quote that is not saved, or SalesInvoice to record a sale. Use avalara_transaction_create_or_adjust to update an existing code.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `customer_code` (`string`, required): Your code for the customer (case-sensitive). Example: CUST-001
- `date` (`string`, required): Transaction date (yyyy-MM-dd), used to find the tax rates in effect. Example: 2026-11-15
- `lines` (`array`, required): Line items. Each needs amount (the line's total, not unit price); add quantity, number, itemCode, taxCode (such as P0000000), description, discounted, taxIncluded or line-level addresses as needed. Example: [{"number": "1", "quantity": 1, "amount": 100, "taxCode": "PS081282", "itemCode": "Y0001", "description": "Yarn"}]
- `addresses` (`object`, optional): Addresses for the whole document. Use singleLocation for a point-of-sale sale, or shipFrom and shipTo for shipped goods; each address has line1, city, region, postalCode and country. Example: {"shipFrom": {"line1": "2000 Main Street", "city": "Irvine", "region": "CA", "postalCode": "92614", "country": "US"}, "shipTo": {"line1": "100 Ravine Lane NE", "city": "Bainbridge Island", "region": "WA", "postalCode": "98110", "country": "US"}}
- `code` (`string`, optional): Your reference code for the transaction, used later to get, commit, adjust or void it. AvaTax assigns a GUID if empty. Example: INV-1001
- `commit` (`boolean`, optional): true to commit the transaction so it is reported on tax returns. Only applies to Invoice types. Example: false
- `company_code` (`string`, optional): Company code to record the transaction under. Defaults to the account's default company. Example: DEFAULT
- `currency_code` (`string`, optional): Three-letter ISO 4217 invoice currency. Defaults to USD. Example: USD
- `description` (`string`, optional): Description of the transaction. Example: Online order 1001
- `discount` (`number`, optional): Document-level discount amount, applied to lines that have discounted true. Example: 10
- `email` (`string`, optional): Email address relevant to the transaction. Example: buyer@example.com
- `entity_use_code` (`string`, optional): Entity use code for exempt usage, such as A (federal government) or G (resale). Example: G
- `exemption_no` (`string`, optional): Exemption number; when set, the whole document is treated as exempt. Example: EX-12345
- `include` (`string`, optional): Extra data in the response, comma-separated: Lines, Details, Summary, Addresses, SummaryOnly, LinesOnly, TaxDetailsByTaxType, ForceTimeout. Example: Summary,Addresses
- `purchase_order_no` (`string`, optional): Purchase order number for the document. Example: PO-7781
- `reference_code` (`string`, optional): Your reference, for example the original invoice for a return. Example: ORIG-INV-1000
- `salesperson_code` (`string`, optional): Salesperson code. Example: SP-12
- `type` (`string`, optional): Document type. Types ending in Invoice are saved permanently; types ending in Order are estimates that are not saved. Defaults to SalesOrder. Example: SalesInvoice. One of: `SalesOrder`, `SalesInvoice`, `PurchaseOrder`, `PurchaseInvoice`, `ReturnOrder`, `ReturnInvoice`, `InventoryTransferOrder`, `InventoryTransferInvoice`, `ReverseChargeOrder`, `ReverseChargeInvoice`, `CustomsInvoice`, `CustomsOrder`, `InventoryTransferOutboundInvoice`, `InventoryTransferOutboundOrder`.

Example input: `{"customer_code":"<customer_code>","date":"<date>","lines":[{"number":"1","quantity":1,"amount":100,"taxCode":"PS081282","itemCode":"Y0001","description":"Yarn"}]}`

### `avalara_transaction_create_or_adjust`

Create or Adjust Transaction · Write

Create a transaction, or adjust it if one with the same code and type already exists and is not locked.
Returns the created or adjusted transaction with totals and line tax details.
Use avalara_transaction_create_or_adjust when re-sending an invoice that may already exist. Use avalara_transaction_adjust to correct a known transaction with a reason.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `customer_code` (`string`, required): Your code for the customer (case-sensitive). Example: CUST-001
- `date` (`string`, required): Transaction date (yyyy-MM-dd), used to find the tax rates in effect. Example: 2026-11-15
- `lines` (`array`, required): Line items. Each needs amount (the line's total, not unit price); add quantity, number, itemCode, taxCode (such as P0000000), description, discounted, taxIncluded or line-level addresses as needed. Example: [{"number": "1", "quantity": 1, "amount": 100, "taxCode": "PS081282", "itemCode": "Y0001", "description": "Yarn"}]
- `addresses` (`object`, optional): Addresses for the whole document. Use singleLocation for a point-of-sale sale, or shipFrom and shipTo for shipped goods; each address has line1, city, region, postalCode and country. Example: {"shipFrom": {"line1": "2000 Main Street", "city": "Irvine", "region": "CA", "postalCode": "92614", "country": "US"}, "shipTo": {"line1": "100 Ravine Lane NE", "city": "Bainbridge Island", "region": "WA", "postalCode": "98110", "country": "US"}}
- `adjustment_description` (`string`, optional): Free-text reason; required when adjustment_reason is Other. Example: Corrected shipping address
- `adjustment_reason` (`string`, optional): Reason recorded if an existing transaction is adjusted. Example: PriceAdjusted. One of: `NotAdjusted`, `SourcingIssue`, `ReconciledWithGeneralLedger`, `ExemptCertApplied`, `PriceAdjusted`, `ProductReturned`, `ProductExchanged`, `BadDebt`, `Other`, `Offline`, `Offset`.
- `code` (`string`, optional): Your reference code for the transaction, used later to get, commit, adjust or void it. AvaTax assigns a GUID if empty. Example: INV-1001
- `commit` (`boolean`, optional): true to commit the transaction so it is reported on tax returns. Only applies to Invoice types. Example: false
- `company_code` (`string`, optional): Company code to record the transaction under. Defaults to the account's default company. Example: DEFAULT
- `currency_code` (`string`, optional): Three-letter ISO 4217 invoice currency. Defaults to USD. Example: USD
- `description` (`string`, optional): Description of the transaction. Example: Online order 1001
- `discount` (`number`, optional): Document-level discount amount, applied to lines that have discounted true. Example: 10
- `email` (`string`, optional): Email address relevant to the transaction. Example: buyer@example.com
- `entity_use_code` (`string`, optional): Entity use code for exempt usage, such as A (federal government) or G (resale). Example: G
- `exemption_no` (`string`, optional): Exemption number; when set, the whole document is treated as exempt. Example: EX-12345
- `include` (`string`, optional): Extra data in the response, comma-separated: Lines, Details, Summary, Addresses, SummaryOnly, LinesOnly, TaxDetailsByTaxType, ForceTimeout. Example: Summary,Addresses
- `purchase_order_no` (`string`, optional): Purchase order number for the document. Example: PO-7781
- `reference_code` (`string`, optional): Your reference, for example the original invoice for a return. Example: ORIG-INV-1000
- `salesperson_code` (`string`, optional): Salesperson code. Example: SP-12
- `type` (`string`, optional): Document type. Types ending in Invoice are saved permanently; types ending in Order are estimates that are not saved. Defaults to SalesOrder. Example: SalesInvoice. One of: `SalesOrder`, `SalesInvoice`, `PurchaseOrder`, `PurchaseInvoice`, `ReturnOrder`, `ReturnInvoice`, `InventoryTransferOrder`, `InventoryTransferInvoice`, `ReverseChargeOrder`, `ReverseChargeInvoice`, `CustomsInvoice`, `CustomsOrder`, `InventoryTransferOutboundInvoice`, `InventoryTransferOutboundOrder`.

Example input: `{"customer_code":"<customer_code>","date":"<date>","lines":[{"number":"1","quantity":1,"amount":100,"taxCode":"PS081282","itemCode":"Y0001","description":"Yarn"}]}`

### `avalara_transaction_refund`

Refund Transaction · Write

Create a ReturnInvoice that refunds all or part of an earlier sale.
Returns the new refund transaction with negative amounts and tax.
Use avalara_transaction_refund for returns. Use avalara_transaction_void to cancel a sale that should never have been recorded.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `company_code` (`string`, required): Company code of the company that recorded the transaction (companyCode from avalara_companies_list, often DEFAULT). Example: DEFAULT
- `refund_date` (`string`, required): Date of the refund (yyyy-MM-dd); controls which filing period reports it. Example: 2026-11-20
- `transaction_code` (`string`, required): Code of the transaction to refund (the code you set, or the GUID AvaTax assigned). Example: INV-1001
- `document_type` (`string`, optional): Document type of the transaction, when the same code exists for more than one type. Defaults to SalesInvoice. Example: SalesInvoice. One of: `SalesOrder`, `SalesInvoice`, `PurchaseOrder`, `PurchaseInvoice`, `ReturnOrder`, `ReturnInvoice`, `InventoryTransferOrder`, `InventoryTransferInvoice`, `ReverseChargeOrder`, `ReverseChargeInvoice`, `CustomsInvoice`, `CustomsOrder`, `InventoryTransferOutboundInvoice`, `InventoryTransferOutboundOrder`, `Any`.
- `include` (`string`, optional): Extra data in the response, comma-separated: Lines, Details, Summary, Addresses, SummaryOnly, LinesOnly, TaxDetailsByTaxType, ForceTimeout. Example: Summary,Addresses
- `reference_code` (`string`, optional): Your reference for the refund. Example: RMA-5521
- `refund_lines` (`array`, optional): Line numbers of the original transaction to refund, for Partial refunds. Example: ["1", "2"]
- `refund_percentage` (`number`, optional): Percentage to refund, for Percentage or Partial refunds. Example: 50
- `refund_transaction_code` (`string`, optional): Code for the new ReturnInvoice. Example: REFUND-INV-1001
- `refund_type` (`string`, optional): Full, Partial (with refund_lines), TaxOnly or Percentage (with refund_percentage). Example: Full. One of: `Full`, `Partial`, `TaxOnly`, `Percentage`.
- `use_tax_date_override` (`boolean`, optional): true to process the refund with a tax date override instead of a tax amount override (required for SST states). Defaults to false. Example: false

Example input: `{"company_code":"<company_code>","refund_date":"<refund_date>","transaction_code":"<transaction_code>"}`

### `avalara_transaction_uncommit`

Uncommit Transaction · Write

Move a committed transaction back to Saved so it can be changed or voided before it is reported.
Returns the transaction with status Saved.
Use avalara_transaction_uncommit before editing a committed transaction. Use avalara_transaction_commit to commit it again.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_code` (`string`, required): Company code of the company that recorded the transaction (companyCode from avalara_companies_list, often DEFAULT). Example: DEFAULT
- `transaction_code` (`string`, required): Code of the transaction to uncommit (the code you set, or the GUID AvaTax assigned). Example: INV-1001
- `document_type` (`string`, optional): Document type of the transaction, when the same code exists for more than one type. Defaults to SalesInvoice. Example: SalesInvoice. One of: `SalesOrder`, `SalesInvoice`, `PurchaseOrder`, `PurchaseInvoice`, `ReturnOrder`, `ReturnInvoice`, `InventoryTransferOrder`, `InventoryTransferInvoice`, `ReverseChargeOrder`, `ReverseChargeInvoice`, `CustomsInvoice`, `CustomsOrder`, `InventoryTransferOutboundInvoice`, `InventoryTransferOutboundOrder`, `Any`.
- `include` (`string`, optional): Extra data in the response, comma-separated: Lines, Details, Summary, Addresses, SummaryOnly, LinesOnly, TaxDetailsByTaxType, ForceTimeout. Example: Summary,Addresses

Example input: `{"company_code":"<company_code>","transaction_code":"<transaction_code>"}`

### `avalara_transaction_void`

Void Transaction · Destructive

Void or cancel a transaction so it is no longer reported; a voided transaction keeps its record.
Returns the transaction with status Cancelled (or Voided).
Use avalara_transaction_void with code DocVoided to cancel an invoice. Use avalara_transaction_refund to record a return instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `code` (`string`, required): Reason for voiding. Use DocVoided to void a transaction; the others are for special cases (PostFailed, DocDeleted, AdjustmentCancelled). Example: DocVoided. One of: `Unspecified`, `PostFailed`, `DocDeleted`, `DocVoided`, `AdjustmentCancelled`.
- `company_code` (`string`, required): Company code of the company that recorded the transaction (companyCode from avalara_companies_list, often DEFAULT). Example: DEFAULT
- `transaction_code` (`string`, required): Code of the transaction to void (the code you set, or the GUID AvaTax assigned). Example: INV-1001
- `document_type` (`string`, optional): Document type of the transaction, when the same code exists for more than one type. Defaults to SalesInvoice. Example: SalesInvoice. One of: `SalesOrder`, `SalesInvoice`, `PurchaseOrder`, `PurchaseInvoice`, `ReturnOrder`, `ReturnInvoice`, `InventoryTransferOrder`, `InventoryTransferInvoice`, `ReverseChargeOrder`, `ReverseChargeInvoice`, `CustomsInvoice`, `CustomsOrder`, `InventoryTransferOutboundInvoice`, `InventoryTransferOutboundOrder`, `Any`.
- `include` (`string`, optional): Extra data in the response, comma-separated: Lines, Details, Summary, Addresses, SummaryOnly, LinesOnly, TaxDetailsByTaxType, ForceTimeout. Example: Summary,Addresses

Example input: `{"code":"Unspecified","company_code":"<company_code>","transaction_code":"<transaction_code>"}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
