Skip to content

State Tax Configuration Documentation

Menu Location: Payments > Taxes > State Tax

Access Level: Administrator and above

Last Updated: 2026-03-01

Overview

The State Tax page manages sales tax rates at the state level. Configure state-wide tax rates that automatically apply to all orders shipping to addresses in that state.

Primary Functions:

  • Add states with tax rates
  • Edit state tax rates
  • View all configured state taxes
  • Delete state tax configurations
  • Automatically apply base state tax to all orders

Page Layout

Header Section

  • Page Title: State Tax configuration
  • Add New Button: Create new state tax entry

Main Content Table

List of all states with configured tax rates

Table Columns:

  • State Name/Abbreviation
  • Tax Rate (percentage)
  • Effective Date (if tracked)
  • Actions (Edit/Delete)

State Tax Fields

Required Fields

State:

  • Two-letter state abbreviation (preferred)
  • Or full state name
  • Example: MI, California, TX
  • Must match customer address format

Tax Rate:

  • Percentage as decimal number
  • Example: 6.0 for 6% state tax
  • Do not include % symbol
  • Accepts decimals (6.25, 6.875, etc.)

Optional Fields

Notes:

  • Internal documentation
  • Rate change history
  • Special considerations
  • Effective dates

Managing State Taxes

Adding a New State

Steps:

  1. Click "Add New" button
  2. Enter state abbreviation (MI, CA, etc.)
  3. Enter tax rate as decimal
  4. Add notes if desired
  5. Click "Save"
  6. State tax now applies to all orders in that state

Example:

  • State: MI
  • Rate: 6.0
  • Notes: Michigan 6% state sales tax
  • Result: 6% tax on all MI orders (plus any county/city/zip taxes)

Editing a State Tax

Steps:

  1. Find state in table
  2. Click "Edit" icon
  3. Update tax rate
  4. Update notes with change reason
  5. Click "Save"
  6. New rate applies immediately to all new orders

Important: State tax changes affect ALL customers in that state.

Deleting a State Tax

Steps:

  1. Find state in table
  2. Click "Delete" icon
  3. Confirm deletion
  4. State tax removed (0% tax for that state)

Warning: Only delete if state has eliminated sales tax entirely. Most states require sales tax collection.

How State Tax Works

Automatic Application

Process:

  1. Customer enters shipping address
  2. System reads state from address
  3. System looks up state in tax configuration
  4. State tax rate applied to taxable items
  5. State tax combines with local taxes

Example Order:

  • Customer State: MI
  • State Tax: 6.0%
  • County Tax: 0.25%
  • City Tax: 1.5%
  • Order Subtotal: $100
  • Total Tax: 7.75% = $7.75

Tax Hierarchy

State tax is the BASE tax level:

  1. State: Applies to entire state
  2. County: Adds to state tax for county
  3. City: Adds to state+county for city
  4. Zip: Additional zip-specific tax
  5. Product: Item-specific taxes

Total = State + County + City + Zip + Product taxes

Common Use Cases

Use Case 1: Add Tax for New State

Goal: Begin collecting sales tax in new state

Steps:

  1. Research state's sales tax requirements
  2. Determine exact state tax rate
  3. Note effective date (often registration date)
  4. Go to State Tax page
  5. Click "Add New"
  6. Enter state: "TX"
  7. Enter rate: 6.25
  8. Notes: "Texas state sales tax, effective 3/1/2026"
  9. Click "Save"
  10. Test with Texas address order

Verification:

  • Create test order to TX address
  • Confirm 6.25% state tax appears
  • Check Tax Reports show TX separately

Use Case 2: Update State Tax Rate

Goal: Change rate after state legislation

Steps:

  1. Receive notice of state rate change
  2. Note exact effective date
  3. On effective date morning:
  4. Go to State Tax page
  5. Find state, click "Edit"
  6. Update rate to new percentage
  7. Update notes: "Rate changed from X% to Y% per [law/bill]"
  8. Click "Save"
  9. Notify accounting and finance teams
  10. Monitor first few orders for correct tax

Tips:

  • Schedule change for midnight or early AM
  • Keep documentation of rate change notice
  • Update on exact effective date
  • Communicate to all relevant teams

Use Case 3: Set Up Multi-State Tax

Goal: Configure tax for all states you ship to

Steps:

  1. List all states you ship to
  2. Research each state's tax rate
  3. Determine nexus requirements
  4. For each state:
    • Click "Add New"
    • Enter state abbreviation
    • Enter current rate
    • Add notes with source/date
  5. Save each state
  6. Test order in each state
  7. Verify correct rates applying

States to Research:

  • States with physical presence
  • States with economic nexus
  • States where registered for sales tax

Use Case 4: Audit State Tax Rates

Goal: Verify all rates are current and accurate

Steps:

  1. Export current state tax configuration
  2. Visit authoritative source (state revenue departments)
  3. Compare configured rates to official rates
  4. Note any discrepancies
  5. Research effective dates of any changes
  6. Update incorrect rates
  7. Document audit date and sources
  8. Schedule next audit (quarterly recommended)

Resources:

  • State department of revenue websites
  • Tax software providers (Avalara, TaxJar)
  • Accounting firm tax rate tables
  • Sales tax associations

Use Case 5: Prepare for Tax Season

Goal: Ensure accurate tax configuration before busy season

Steps:

  1. Review all configured states
  2. Verify rates match current law
  3. Check for recent rate changes
  4. Test orders in each state
  5. Run Tax Reports for recent period
  6. Reconcile with payment processor
  7. Document any corrections made
  8. Brief accounting team on configuration

Troubleshooting

State Tax Not Applying to Orders

Symptoms:

  • Order to state address
  • No state tax calculated
  • Other taxes (county/city) may be working

Check:

  1. Verify state is in configuration table
  2. Confirm state abbreviation matches address
  3. Check rate is non-zero
  4. Verify customer state field populated
  5. Review order details for tax breakdown

Common Causes:

  • State not added to configuration
  • State abbreviation mismatch (MI vs Michigan)
  • Customer address missing state
  • State tax rate set to zero

Solutions:

  • Add missing state
  • Standardize state format (use abbreviations)
  • Require state in customer addresses

Wrong State Tax Rate

Symptoms:

  • State tax appears
  • Amount doesn't match configuration
  • Rate calculation incorrect

Investigation:

  1. Check configured rate in table
  2. Verify rate format (6.0 not 0.06)
  3. Review order tax breakdown
  4. Confirm correct state detected
  5. Check for recent rate changes

Solutions:

  • Correct rate in configuration (use 6.0 for 6%)
  • Clear cache if rate was recently updated
  • Verify decimal format

Orders Missing Tax Entirely

Symptoms:

  • No tax on any order
  • State, county, city all missing
  • Items should be taxable

Check:

  1. Verify tax feature enabled globally
  2. Check if products marked non-taxable
  3. Confirm customer address has state
  4. Review state tax configuration
  5. Check for system-wide tax disable

Common Causes:

  • Products marked as non-taxable
  • Customer account tax-exempt
  • State not configured
  • System tax calculation disabled
  • County Tax - County-level tax configuration
  • City Tax - City-level tax configuration
  • Zip Code Tax - Zip-level tax configuration
  • Tax Reports - View collected state taxes
  • Products - Set product taxability

Workflow:

  1. Configure state taxes (base rate)
  2. Add county taxes for local areas
  3. Add city taxes where applicable
  4. Add zip taxes for specific zips
  5. Taxes auto-calculate on orders
  6. Review Tax Reports monthly

Permissions & Access

Required Access Level: Administrator or higher

Access Level Capabilities:

  • Administrator: Add, edit, delete state taxes
  • Kiva Admin: All features + bulk import

Critical: Only Administrators can modify state tax rates due to legal compliance requirements.

Best Practices

Configuration Management

  1. Use two-letter state abbreviations for consistency
  2. Document all rate changes with dates and sources
  3. Keep notes on legislative changes
  4. Test after every rate change
  5. Maintain audit trail

Rate Updates

  1. Subscribe to state revenue department notifications
  2. Monitor tax legislation in your states
  3. Update rates on exact effective dates
  4. Coordinate with accounting team
  5. Verify first orders after changes

Compliance

  1. Register for sales tax in states with nexus
  2. Research economic nexus thresholds
  3. File tax returns on schedule
  4. Keep records of all rate changes
  5. Consult tax professional annually

Multi-State Operations

  • Track nexus status for each state
  • Monitor sales thresholds for economic nexus
  • Register proactively before thresholds
  • Maintain state-by-state tax records
  • Use Tax Reports for state-specific filing

Data Quality

  • Verify rates against official sources
  • Audit configuration quarterly
  • Document all changes
  • Test orders in each state
  • Keep historical rate records

Quick Reference Card

Task Action/Location
Add new state Click "Add New", enter state and rate
Edit state rate Find state, click "Edit", update rate
Delete state Find state, click "Delete", confirm
Search for state Use table search box
Verify state tax Check Tax Reports for state breakdown
Test state tax Create test order with state address
Sort by rate Click "Rate" column header
Export state list Use table export function

FAQs

Do I need to collect sales tax in every state?

No, only in states where you have nexus (physical presence or economic nexus). Research each state's nexus requirements. Many states have economic nexus thresholds (e.g., $100,000 in sales or 200 transactions).

What if a state doesn't have sales tax?

States without sales tax (AK, DE, MT, NH, OR) don't need entries in the configuration. Leave them out or add with 0% rate for documentation.

How do I know if state tax rates changed?

Subscribe to state department of revenue email alerts. Use tax software services that track rate changes. Join sales tax associations. Consult with tax accountant quarterly.

Should I enter rates as 6% or 0.06?

Enter as 6.0 (or 6). The system expects percentages as whole numbers (6.0 = 6%, not 0.06 = 0.06%). Test after entering to confirm correct calculation.

What if customer is tax-exempt?

Tax-exempt status is handled at the customer account level, not in tax configuration. Mark customer accounts as tax-exempt; system will skip tax calculation regardless of these rates.

Can I have different state rates for different products?

State tax rate is uniform across all taxable products in the state. Product-specific taxes are handled separately. All taxable items get the same state tax rate.

What about shipping to military addresses (APO/FPO)?

Military addresses are generally not subject to state sales tax. Consult your tax advisor about handling APO/FPO addresses in your system.

End of Documentation

For additional help, contact your system administrator or Kiva Logic support.