К основному содержанию
скилл CX Codex

sales-tax-nexus — скилл для Claude Code: налог с продаж по штатам

Считает выручку и число сделок по штатам и показывает, где у вас возникла обязанность собирать sales tax.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add openaccountant/skills --skill sales-tax-nexus -a claude-code
Открыть на GitHub

Что делает sales-tax-nexus

Скилл разбирает доходные транзакции и группирует их по штату покупателя. Дальше он сравнивает суммы с порогами экономического присутствия и помечает штаты, где порог превышен. Работает через инструменты Wilson: transaction_search тянет транзакции, spending_summary суммирует выручку и считает сделки, export_transactions собирает отчёт для налогового консультанта или программы вроде TaxJar и Avalara.

Пороги в США разные, и это главная причина ошибок. В большинстве штатов хватает 100 000 долларов выручки или 200 сделок, но в Калифорнии и Техасе порог 500 000 долларов без счёта сделок, а в Нью-Йорке нужно набрать и 500 000 долларов, и 100 сделок одновременно. Нет sales tax в Аляске, Делавэре, Монтане, Нью-Гэмпшире и Орегоне, хотя местные налоги на Аляске всё равно есть. Физическое присутствие — офис, склад, сотрудник, товарный запас — создаёт обязанность независимо от выручки, поэтому скилл тут не поможет.

Без Wilson придётся выгружать транзакции из Stripe, PayPal или Shopify, добавлять колонку со штатом покупателя и сводить всё в сводную таблицу. Скилл не даёт налоговых консультаций: решения о регистрации и подаче остаются за CPA.

Какие задачи решает

  • определить, в каких штатах возникла обязанность собирать sales tax
  • сравнить выручку по штатам с порогами экономического присутствия
  • посчитать число сделок по каждому штату за год
  • выгрузить отчёт по штатам для налогового консультанта
  • отделить штаты без sales tax от тех, где налог есть

Примеры запросов агенту

  • посчитай мою выручку по штатам и скажи, где я превысил порог nexus
  • проверь, есть ли у меня обязанность собирать sales tax в Нью-Йорке
  • сделай отчёт по выручке и сделкам по штатам за прошлый год

Как установить sales-tax-nexus

1Через Skills CLI (Vercel)

npx skills add openaccountant/skills --skill sales-tax-nexus -a claude-code

2Вручную: положить файлы

~/.claude/skills/sales-tax-nexus/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/sales-tax-nexus/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о sales-tax-nexus

Как установить sales-tax-nexus в Claude?

Выполните npx skills add openaccountant/skills --skill sales-tax-nexus -a claude-code. Скилл встанет в ~/.claude/skills/sales-tax-nexus/SKILL.md.

Что делает sales-tax-nexus?

Считает выручку и количество транзакций по штатам, сравнивает их с порогами экономического присутствия и помечает штаты, где нужно регистрироваться и собирать налог.

Какие пороги учитывает скилл?

В большинстве штатов это 100 000 долларов выручки или 200 сделок. В Калифорнии и Техасе порог 500 000 долларов, в Нью-Йорке — 500 000 долларов и 100 сделок одновременно.

Исходный текст

SKILL.md · MIT
---
name: sales-tax-nexus
description: >
  Determine sales tax obligations by state based on economic nexus thresholds.
---

# Sales Tax Nexus Analysis

## Overview

Analyzes your revenue and transaction volume by state to determine where you have economic nexus and are required to collect and remit sales tax. After the 2018 Supreme Court decision in South Dakota v. Wayfair, most states impose sales tax obligations on remote sellers exceeding certain thresholds.

## Wilson Tools Used

- `transaction_search` — Find revenue transactions and identify customer locations by state
- `spending_summary` — Summarize total revenue by state for threshold comparison
- `export_transactions` — Export state-by-state revenue data for filing or advisor review

## Workflow

1. Use `transaction_search` to pull all revenue (income) transactions for the current or prior calendar year.
2. Group revenue by customer state (based on transaction descriptions, merchant data, or notes).
3. Use `spending_summary` to total revenue and count transactions per state.
4. Compare each state's totals against that state's economic nexus thresholds.
5. Flag any state where you exceed the threshold -- you likely have a collection obligation.
6. Use `export_transactions` to generate a report for your tax advisor or sales tax software.

### Common Economic Nexus Thresholds

Most states use one or both of these triggers (exceed **either** to create nexus):

| Threshold Type | Most Common Level | Notes |
|---------------|-------------------|-------|
| Revenue | $100,000 in sales | Some states use $500K (CA, NY, TX) |
| Transactions | 200 transactions | Not all states use a transaction count |

**States with no sales tax:** AK (no state tax, but local taxes exist), DE, MT, NH, OR.

**Notable exceptions to the $100K / 200 threshold:**
- California: $500,000 revenue only (no transaction count)
- New York: $500,000 revenue AND 100 transactions (must meet both)
- Texas: $500,000 revenue only

### Key Dates

- Nexus is typically measured on a rolling 12-month or prior calendar year basis.
- Once nexus is established, you must register, collect, and remit until you fall below the threshold for a specified period (varies by state).

## Without Wilson

1. Export all revenue transactions from your payment processor (Stripe, PayPal, Shopify, etc.).
2. Add a "Customer State" column based on shipping address or billing address.
3. Create a pivot table: State vs. Sum of Revenue and Count of Transactions.
4. Download the current nexus threshold table from your state's Department of Revenue or a resource like the Sales Tax Institute.
5. Compare each state's revenue and transaction count to the threshold.
6. For any state where you exceed the threshold, register for a sales tax permit and begin collecting.
7. Consider using automated sales tax software (e.g., TaxJar, Avalara) if you have nexus in multiple states.

## Important Notes

- Physical presence (office, warehouse, employee, inventory) still creates nexus regardless of revenue thresholds.
- SaaS and digital goods have different taxability rules by state. Some states tax them, others do not.
- Marketplace facilitators (Amazon, Etsy, eBay) typically collect and remit sales tax on your behalf for sales through their platforms. Those sales may still count toward your nexus threshold in some states.
- Filing frequency (monthly, quarterly, annually) depends on the state and your volume.
- Penalties for not collecting sales tax can include back taxes, interest, and fines. Some states offer voluntary disclosure agreements (VDAs) to limit lookback periods.
- This is not tax advice. Consult a CPA or tax professional for filing decisions.

© openaccountant · MIT · openaccountant/skills

Похожие скиллы

Всё по теме «Финансы и бизнес» →
tax-prep официальный anthropics Готовит квартальные расчёты и список 1099-NEC для бухгалтера. Сначала закрывает книги, потом считает — чтобы цифра опиралась на сверенные данные. CX Codex +1 1 800установок tax-season-organizer официальный anthropics Готовит материалы по квартальным налогам и 1099 для бухгалтера. Работает с закрытыми книгами и ориентирован на федеральные налоги США. CX Codex +1 1 700установок tax-efficiency JoelLewis Скилл для ИИ-агента, который разбирает размещение активов по счетам, выбор лотов и очерёдность снятия денег с учётом налогов. CX Codex +1 690установок tax-loss-harvesting JoelLewis Ведёт скилл по всему циклу налогового харвестинга: поиск кандидатов, бюджет прибылей и убытков, подбор замены, контроль wash-sale. CX Codex +1 683установок tax-strategy-optimizer OneWave-AI Скилл для разбора вариантов pre-tax и Roth, благотворительных взносов, сроков продажи активов и вычетов. Помогает прикинуть налоговую картину до похода к CPA. CX Codex +1 339установок netsuite-finance-analyst Oracle NetSuite Скилл анализирует финансовые данные NetSuite, помогает закрывать отчётные периоды и готовить сводки для руководства. Пригодится финансовым аналитикам и контролёрам. CX Codex +1 416установок

Из того же набора28

smart-split Разбивает одну транзакцию на несколько категорий с заданными суммами. Пригодится, когда чек смешанный: продукты, бытовая химия и электроника в одной покупке. CX Codex +1 387установок revenue-concentration Считает долю каждого клиента в выручке и индекс Херфиндаля-Хиршмана, чтобы показать, насколько бизнес зависит от нескольких заказчиков. CX Codex +1 382установок runway-calculator Считает, на сколько месяцев хватит денег при текущем расходе, и показывает дату обнуления счёта. Пригодится, когда нужно быстро понять запас до следующего раунда. CX Codex +1 378установок seasonal-patterns Скилл ищет сезонные колебания выручки и расходов по 12 и более месяцам. Пригодится, когда нужно понять, какие месяцы проседают и почему. CX Codex +1 381установок paypal-import Разбирает выгрузку транзакций PayPal и превращает её в проводки: платежи, комиссии, возвраты, конвертация валют. Пригодится, если ведёте учёт в Open Accountant. CX Codex +1 364установок state-tax-estimator Считает примерный налог штата по доходу и месту жительства. Пригодится для квартальных платежей и планирования. CX Codex +1 366установок tax-penalty-calc Считает пеню за недоплату квартальных налогов по Form 2210: берёт недоплату за квартал, ставку IRS и число дней просрочки. CX Codex +1 364установок stripe-import Переносит выгрузки Stripe в учёт: платежи, комиссии и возвраты отдельными строками. Пригодится, когда надо свести выручку с банковской выпиской. CX Codex +1 363установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой