amazon-taxes

Process Amazon sales tax reports and generate per-state filing summaries.

Why

Amazon sellers registered in multiple states must file returns even when Amazon collects all tax as a marketplace facilitator. This tool processes Amazon tax reports to generate per-state summaries showing gross sales, marketplace-collected tax, and tax owed — ready for filing on state portals or handing to an accountant.

Quick Start

# Install dependencies
uv sync

# Option A: Import a CSV downloaded from Seller Central
uv run amazon-taxes import report.csv --quarter Q1-2026

# Option B: Fetch via SP-API (requires .env credentials)
cp .env.example .env   # fill in SP-API credentials
uv run amazon-taxes pull --quarter Q1-2026

# Generate filing reports for specific states
uv run amazon-taxes report --states WA,NC --quarter Q1-2026

# Single state, annual period
uv run amazon-taxes report --states GA --year 2025

# Export as CSV
uv run amazon-taxes report --states WA --quarter Q1-2026 --format csv --output wa-q1.csv

Output

Terminal table showing gross sales, marketplace-collected tax, and tax owed per state. Export to CSV for use when filing on state portals.

Documentation

• Product Requirements
• Implementation Roadmap
• Research (TaxJar analysis, SP-API, tax complexity)