Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.numeral.com/llms.txt

Use this file to discover all available pages before exploring further.

Many of our eCommerce clients use Shopify as their primary sales platform, and our team has broad experience troubleshooting common issues and preventing problems before they arise. As part of your onboarding, you’ll grant us Partner Access (also called collaborator access) to your Shopify store so we can better support you. Connecting your store to Numeral allows us to pull the data needed to manage filings and monitor your company’s nexus. However, this connection alone does not give us the ability to adjust your tax settings. For tasks like product categorization or troubleshooting more complex issues, Partner Access is required. This article covers:
  • How our team can assist you
  • Key actions you can take and tax settings you can manage in Shopify
  • Common issues we’ve seen with the Shopify Tax Engine
We do not need full access. Our partner requests are limited to the permissions necessary to troubleshoot and ensure accurate tax collection.

How Shopify Partner Access Helps Us Support You

With Partner Access, Numeral can view specific areas of your Shopify admin dashboard to better support your store:
  • Viewing analytics & troubleshooting discrepancies: Reviewing reports, identifying issues, and creating custom reports to simplify reconciliation.
  • Product categorization: Verifying or assisting with categorization to ensure taxes are calculated correctly (note: this is separate from SKUs).
  • Managing tax collection settings: Enabling or disabling tax collection for accounts that are newly opened or closed.
Numeral does not set tax rates. Shopify’s Tax Engine determines rates based on shipping location and product category. As a result, we cannot investigate tax engine failures or advanced Shopify settings beyond what affects your filings. Our support is limited to the services outlined above.

How to Grant Numeral Shopify Partner Access

Most stores require a Shopify collaborator code. Here’s how it works:
  1. Go to Settings > Users and Permissions > Collaborators in your Shopify admin.
  2. Locate your 4-digit collaborator code and share it with our team so we can submit the request.
  3. We’ll request access using your collaborator code. You’ll then receive:
    • An email with a link to accept the request
    • A request in your Users and Permissions section in Shopify from Numeral (concierge@numeralhq.com)
Can’t find your Shopify collaborator code or grant access?This usually occurs when the person trying to grant access doesn’t have the necessary permissions. If you’re not the Shopify store owner, ask the owner to provide the collaborator code and grant access.
If we need to send a new access request and there are existing @numeralhq.com emails listed under Users, please remove them first — otherwise we won’t be able to submit the request.

Product Categorization

During onboarding, we perform a one-time review of your product categories. After that, most clients handle product categorization themselves, though we’re happy to assist if you reach out. Shopify calculates sales tax based on product categories and the customer’s shipping address. Adding new products without proper categorization can lead to inaccurate tax collection — review your store regularly to ensure everything is set up correctly. How to review product categorization in your Numeral dashboard:
  1. Go to Connections > Manage (under Settings) > Products.
  2. Click All Products to view everything, or Uncategorized to see uncategorized items.
All products must be categorized to ensure accurate tax collection.

Shopify Product and Variant Settings

Sometimes newly added products or variants may default to not charging tax. Our team doesn’t have access to change these settings directly, but here’s how you can review and update them yourself:
  1. From your Shopify admin, go to Products.
  2. Click the product you want to edit.
  3. In the Pricing section, check or uncheck Charge taxes on this product.
  4. Click Save.
  1. From your Shopify admin, go to Products.
  2. Select the products you want to update using the checkboxes.
  3. Click Bulk edit.
  4. If the Charge taxes column isn’t visible, click Columns and select Charge taxes.
  5. Check or uncheck the box for each product as needed.
  6. Click Save.
  1. From your Shopify admin, go to Products.
  2. Click the product containing the variant.
  3. In the Variants section, click the variant you want to edit.
  4. In the Pricing section, check or uncheck Charge tax on this variant.
  5. Click Save.
  1. From your Shopify admin, go to Products.
  2. Select the product you want to edit.
  3. In the Variants section, select the variants using the checkboxes.
  4. Click Bulk edit and update the Charge tax on this variant setting as needed.
  5. Click Save.

Common Tax Engine Issues in Shopify

Even with proper settings, Shopify tax collection may occasionally be inaccurate. Shopify has confirmed these issues can happen due to:
  • Fallback tax engine: If Shopify Tax is unavailable due to latency or downtime, the system defaults to a less accurate engine that only uses ZIP codes.
  • Incomplete customer addresses: Missing address details can cause incorrect calculations.
  • Unsupported payment methods: Deferred payments or express checkouts (e.g., Apple Pay, PayPal Express) may not always trigger Shopify Tax correctly.
If you encounter issues like these, you will need to contact Shopify directly for in-depth troubleshooting, as these cases are outside our support scope.

Additional resources: