From wix-ecom-cowork
Manages Wix tax configuration via Billing APIs: query tax groups/regions/calculators/manual mappings, assign groups to products. For e-commerce tax compliance.
How this skill is triggered — by the user, by Claude, or both
Slash command
/wix-ecom-cowork:tax-managementThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Comprehensive tax management using Wix Tax APIs including tax groups, regions, calculations, and manual mappings for full tax compliance.
Comprehensive tax management using Wix Tax APIs including tax groups, regions, calculations, and manual mappings for full tax compliance.
df7c18eb-009b-4868-9891-15e19dddbe67${API_KEY}${SITE_ID}Endpoint: POST https://www.wixapis.com/billing/v1/tax-groups/query
curl -X POST "https://www.wixapis.com/billing/v1/tax-groups/query" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d '{
"query": {}
}'
Response:
{
"taxGroups": [
{
"id": "tax-group-123",
"name": "Standard Tax",
"rate": 0.08,
"description": "Standard sales tax",
"default": true
}
],
"metadata": {
"count": 1,
"total": 5
}
}
Endpoint: GET https://www.wixapis.com/billing/v1/tax-groups/default-tax-groups
curl -X GET "https://www.wixapis.com/billing/v1/tax-groups/default-tax-groups" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}"
Endpoint: POST https://www.wixapis.com/billing/v1/tax-regions/query
curl -X POST "https://www.wixapis.com/billing/v1/tax-regions/query" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d '{
"query": {}
}'
Response:
{
"taxRegions": [
{
"id": "region-123",
"name": "California",
"code": "CA",
"country": "US",
"rate": 0.0725,
"active": true
}
]
}
Endpoint: GET https://www.wixapis.com/billing/v1/list-tax-calculators
curl -X GET "https://www.wixapis.com/billing/v1/list-tax-calculators" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}"
Response:
{
"calculators": [
{
"id": "wix-auto-tax",
"name": "Wix Automatic Tax",
"type": "AUTOMATIC",
"active": true,
"provider": "wix"
}
]
}
Endpoint: GET https://www.wixapis.com/_api/manual-tax-mappings/v1/manual-tax-mappings
curl -X GET "https://www.wixapis.com/_api/manual-tax-mappings/v1/manual-tax-mappings" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}"
Response:
{
"mappings": [
{
"id": "mapping-123",
"region": "CA",
"taxRate": 0.0875,
"productIds": ["product-1", "product-2"]
}
]
}
PRODUCT_ID="product-123"
TAX_GROUP_ID="tax-group-456"
curl -X PATCH "https://www.wixapis.com/stores/v1/products/${PRODUCT_ID}" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d '{
"product": {
"id": "'"${PRODUCT_ID}"'",
"taxGroupId": "'"${TAX_GROUP_ID}"'"
}
}'
Endpoint: GET https://www.wixapis.com/premium-features-manager-service/v1/features/avalara_tax_calculation/is-eligible
curl -X GET "https://www.wixapis.com/premium-features-manager-service/v1/features/avalara_tax_calculation/is-eligible" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}"
Use Case: Check if site is eligible for Avalara premium tax calculation
calculators=$(curl -s -X GET "https://www.wixapis.com/billing/v1/list-tax-calculators" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}")
active_calculator=$(echo "$calculators" | jq -r '.calculators[] | select(.active == true) | .name')
calc_type=$(echo "$calculators" | jq -r '.calculators[] | select(.active == true) | .type')
echo "Active Tax Calculator: ${active_calculator} (${calc_type})"
tax_groups=$(curl -s -X POST "https://www.wixapis.com/billing/v1/tax-groups/query" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d '{"query": {}}')
echo "$tax_groups" | jq '[.taxGroups[] | {id, name, rate, default}]'
default_groups=$(curl -s -X GET "https://www.wixapis.com/billing/v1/tax-groups/default-tax-groups" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}")
DEFAULT_TAX_ID=$(echo "$default_groups" | jq -r '.taxGroups[0].id')
echo "Default tax group ID: ${DEFAULT_TAX_ID}"
regions=$(curl -s -X POST "https://www.wixapis.com/billing/v1/tax-regions/query" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d '{"query": {}}')
echo "$regions" | jq '[.taxRegions[] | {id, name, code, country, rate}]'
# Find products without tax
products_no_tax=$(curl -s -X POST "https://www.wixapis.com/stores/v1/products/query" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d '{"query": {"filter": "{\"taxGroupId\": null}", "paging": {"limit": 100}}}')
# Assign default tax to all
echo "$products_no_tax" | jq -r '.products[].id' | while read -r pid; do
curl -s -X PATCH "https://www.wixapis.com/stores/v1/products/${pid}" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d "{\"product\": {\"id\": \"${pid}\", \"taxGroupId\": \"${DEFAULT_TAX_ID}\"}}" > /dev/null
echo "✅ Assigned tax to product ${pid}"
sleep 0.2
done
Actual Working Endpoints (from UI capture):
POST /billing/v1/tax-groups/query (Query tax groups)
GET /billing/v1/tax-groups/default-tax-groups (Get defaults)
POST /billing/v1/tax-regions/query (Query regions)
GET /billing/v1/list-tax-calculators (List calculators)
GET /_api/manual-tax-mappings/v1/manual-tax-mappings (Manual mappings)
Documented Endpoints (may also work):
GET /tax-groups/v1/tax-groups (Query)
POST /tax-groups/v1/tax-groups (Create)
PATCH /tax-groups/v1/tax-groups/{id} (Update)
DELETE /tax-groups/v1/tax-groups/{id} (Delete)
/billing/v1/ endpoints - These are what the UI usesnpx claudepluginhub wix/wix-ecom-cowork --plugin wix-ecom-coworkManages Wix tax groups via API: query all/groups by ID/defaults, create, update, delete for defining product/customer tax rates and exemptions.
Manages Wix business solutions via REST API: app installation, blog posts, bookings staff & policies, and site setup.
Automates Taxjar operations via Composio's Taxjar toolkit through Rube MCP. Discovers tools, manages connections, and executes workflows.