### Summary

This guide explains how to identify and resolve processing errors that occur when you upload a transaction CSV file. Understanding these errors will help you quickly correct your file and re-upload it successfully.

### When to Use This

Use this guide when the status of your CSV upload shows "Processing Error" on the upload report page. This indicates that the system found issues in your file that prevented it from being processed.

[How to Troubleshoot CSV Upload Errors 1512x946](https://brainfish-storage-prod.s3-accelerate.amazonaws.com/uploads/9993d4f9-5181-4feb-b08d-b6a4f5dc86cd/50544243-b515-429f-807d-d4aeb332f732/GMT20251016-191633_Recording_as_1512x946.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAUPPN5IL37NWRBJ4M%2F20260408%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260408T145935Z&X-Amz-Expires=3000&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEDcaCXVzLWVhc3QtMiJHMEUCIQC7VxLvwFEvTqyUo8vlTgF2RRdUw9GZW1Mg3Z0E5k9XawIgNjkgvLMCpokcYCpdEqYyXHo7KT06%2F6EPf5hiJLkeW48q3QUIABACGgwzMDgxMjU5NzUyODciDEkpdoZ5D8uJhMG76Cq6BbCmOHEjvzL3ppfAgU9KKmSu0tz07TkXfAwF6765dzKfbfckSfNhhB%2ByacoOGPsu2D%2F6CQPWM3zYTCjpnBCp1DmyY250ZmgTn8ESgRgH6V%2BIIoKblrP%2FOSGs8N1WOqrDyudxnHHQnkXExCdP7nQvtmRUB04GeJIx9NQyTeAN24OHGA67roQh2gwizjgOphOqhVAS%2F%2BLlsDGO%2F67pwLpsiBaq4Yj7LoItLQV0fTTP9dNsQR%2B4PVfbj1fRPuhb7LGWPfyQdW15OG2oppsv5nRTj3bP92EQWy%2FqV09AqzjLm7KhfnX6%2BSLUjPXuqcEwZR%2FdvOwslBmEOtpoV6k7%2Bv8q4SfC6X3epaAIbfZHR%2FVkjRVkYQ5ml%2FvOH1BaDJ2%2FwjBP23tqLyK9aj0yL5nSHt2oyK3pKFSSiq6qaXgVv7Y%2FP1hWVsnaqCXAjtCltgwyZQH8X8sNb%2BlXSvGBG%2FD%2B73QSZyeAXSG%2BRDK9j7ETjy03Y7FoEIUJ727hINCSSaIJMYnC5h9EXqx3RZ23nKpB4ruwchN6nIXLZKNTa%2FznyZgZVSQs5%2Bw%2BPumSuhP6DcUVgeYqE%2F3KuDNovcWC3EoyV4FNfznORc7tD6DVmRP0ePAri1gE%2B%2ByfCGXMELZ0xixGbx0uRRoTp6OtTLv9TAxqfyu9WWh6tWVu8cs0CjoRYDgsYH%2BpEi2ojExSK6Ekr3H8zUX1eDLU0PAbMNmn3jU329YFINcH3qsQSL%2Fcl4mFPruBAJJsG2BykJuxh3shvqlhFe5Bfb5btAzA4tVpiZPFH25ABwTbBUEBI%2B1%2Bha5OnN4Z9t3yk364BtUDfJVoGK1X5VUXodccLrnU3I0AESq4AjwJv741jUY7%2F52KaiI9MlMSoPeBOy7dcMrkO1nX9b9XtDEsnAbXKJu0%2Ff5XznFxEK1QhYtqX6Db99DLM5SqMLXO2c4GOpABwWzx3grWBea53E2aiJsOgGjrWevuDsUiAMK9PY8aKRoX5wRHvVZlQnYokhP%2BPZfVQ6TarWzER9hIXseHsSHs7Hm%2FsasfBmIuhuW7dPYOfbfOIDbfBt6O3zamaRPZ8EsWGBwJ9reusfCBwOrwUc9Ylo3jyU7y4vzeWbhG7dSPQnQYYBJXN1IxBtYBb4qIOtxO&X-Amz-Signature=9a509a0d7ffa1339a46699e25c1d8c4759830e7ef08654c209d43a9c41e2d948&X-Amz-SignedHeaders=host&response-content-disposition=attachment&start=146&end=155)

### Step-by-Step Instructions


1. **Identify the Failed Upload**: Go to the transaction upload **Report** page. Locate the file that has a "Processing Error" status.
2. **View Error Details**: To the left of the file's creation date, click the red warning triangle icon.
3. **Analyze the Error Message**: A pop-up window titled "Upload Error Details" will appear. It will list the specific errors found in your file, often including the row number and a description of the problem (e.g., "Error on row 1: CartItem.TaxAmount is not 0 but has ExemptionCertificateID").
4. **Correct Your CSV File**: Open your original CSV file and navigate to the row mentioned in the error message. Correct the data based on the feedback provided.
5. **Re-upload the File**: Save the corrected CSV file and upload it again using the standard upload process.

### Common Questions (FAQs)

**1. What does the red triangle icon mean?** The red warning triangle indicates that your CSV file failed to process due to one or more errors in the data.

**2. Will the error message tell me exactly what to fix?** Yes, the error details typically specify the row number and the exact reason for the failure, making it easier to locate and fix the issue.

**3. If one row has an error, will the other rows be uploaded?** No, if the file has processing errors, the entire upload will fail. You must correct all listed errors and re-upload the entire file.

### Troubleshooting Tips

* **Unclear Error Message**: If an error message is difficult to understand, refer to the CSV formatting guide. The issue is often related to incorrect data types, missing required values, or data that exceeds the maximum length for a field.
* **Multiple Errors**: Some files may have multiple errors. It's best to fix all reported errors before re-uploading to avoid repeated failures.




How to Troubleshoot CSV Upload Errors

Navigating Your Tax Dashboard

Understanding the Dashboard in Your <PERSON> Account

Navigating the TaxCloud Portal

Uploading Historical and Marketplace Transactions via CSV

How to Import Partial Refunds via CSV

CSV Template Required Fields and Column Descriptions

What is TaxCloud's policy regarding Transaction import timing?

When is the deadline to upload my transactions to TaxCloud?

Why are exempt sales taxing in my import?

Uploading Transactions via CSV

How to Upload Transactions via CSV

Transactions: Import and Export

Can I edit a transaction?

How to Locate a Transaction URL in TaxCloud

Managing your transactions

Transaction Timestamp Policy

How to Filter Transactions with Advanced Search

How to manually return a transaction in TaxCloud?

Setting the Transaction Shipping Destination

How to Manually Add a Transaction

How to View and Share Transaction Details

Transactions: Overview

Using the Download Center for Reports

Does Washington B&O (excise) Tax Appear in Your TaxCloud Reporting?

Understanding the differences between TaxCloud Tax Reporting and Your Platform's Tax Reporting

When does TaxCloud pull my tax funding?

Understanding Tax Reports and Drilling Into Transaction Details

Reporting

Transactions and Reporting

What is TaxCloud's Premium Trial?

How to Take Your Integration Live

Preparing For Onboarding

TaxCloud Onboarding Webinars

How to Set Up and Manage Locations

Getting Started

How Payment Methods Are Used For Billing and Tax Funding

How can I get a copy of my TaxCloud invoice receipt?

How do I change my default payment method?

How to Add a Payment Method in TaxCloud

Billing and Payments

How to create a TaxCloud account?

Account Setup

TaxCloud Account Lockout Policy

I have a new EIN. How does that impact my TaxCloud account?

How to Close Your TaxCloud Account and Cancel Subscription

How to Use Multi-Account Login

How to add/remove a contact from your TaxCloud account.

Verify Your TaxCloud Account is Complete for Calculations

Video: How to complete your TaxCloud Business Profile

How do I reset my Password?

How to Enable & Disable Tax Collection in a State

How to Update My New Business Address With The States?

Best Practices for your TaxCloud Account

Account Management

Account and Billing

Changing your TaxCloud Subscription Plan

Fee Schedule: Understanding TaxCloud Fees

Understanding the difference between TaxCloud Starter and Premium Plans

Plans and Pricing

TaxCloud System Status

Where to Find Your API Key & Login ID

What are API calls and what do they do?

TaxCloud's APIs

Understanding Nexus Threshold Calculations

How do I confirm a rate with TaxCloud?

How do I find my Merchant Number?

Is TaxCloud collecting Illinois Retailer's Occupation Tax (ROT)?

What Services Does TaxCloud Provide?

What happens if I go over my allotment of orders?

What is a voluntary seller?

What is an order in TaxCloud?

Can TaxCloud help with my State Income Taxes?

How to Speak to a Member of Each State's Tax Authority or Department of Revenue

How to Speak to a member of each state's DOR

What are Home Rule States?

What is a multi-state id or sstid?

Does TaxCloud collect the Colorado Retail Delivery Fee (CO RDF)?

Understanding the Minnesota Delivery Fee

General

What is an Exemption Certificate?

How to Upload Exemption Certificates in Bulk

How to Add an Exemption Certificate to TaxCloud

Exemptions and Certificates

How to contact TaxCloud?

TaxCloud Audit Support Overview

Support and Resources

Michigan - Business Taxes Registration Summary of Changes

Rhode Island - Failure to Renew

Colorado SUTS Filing Reminder Notices

Texas - Notice of Tax/Fee Due

Texas - Sales & Use Tax Return Paper Form

Florida - Credit Memo

Florida Hunting, Fishing, and Camping Sales Tax Holiday (Sept 8 – Dec 31, 2025)

Arkansas - Excise, Waste Tire or Withholding Wage Tax

Louisiana State Sales Tax Rate Update

Does TaxCloud Handle Sales Tax License Renewals?

How to register in a new state and obtain my Sales Tax License

Indiana - Notice of Proposed Assessment

Nebraska - Enforcement of Lien Notice

New Jersey - Certificate of Registration

North Carolina - Certificate of Registration

Tennessee - Notice of Overpayment

When To Forward a State Notice to Taxcloud

Wyoming - License Certificate

Connecticut - Delinquency Notice

California - CDTFA Statement of Account

State Notices and Licenses

Managing Your Tax Thresholds

South Dakota - Sales & Use Tax Return Paper Form

Does TaxCloud File in Louisiana?

Filing: State-Specific Workflows

Enabling Filing in TaxCloud (via Thresholds Page)

How can TaxCloud assist with Filing?

How do I confirm my filings have been submitted in SST / Streamline member states?

How do I know if TaxCloud is filing for me in a state?

I just got a filing frequency change notice, what should I do?

Understanding TaxCloud's Filing Costs & Filing Subscription

Why might my Direct Filing ACH be less than what TaxCloud is saying I collected.

How to Request TaxCloud to Begin Filing Sales Tax Returns

How to Stop Filings with TaxCloud

Filing: Managing Filing in TaxCloud

Does TaxCloud file Withholding Tax?

Understanding Your Tax Reporting Page

What are TaxCloud Filing Fees?

What does it cost for TaxCloud to file for me in non-SST states?

Filing: General

Filing and Compliance

Is shipping taxable?

Managing Product TIC Mapping with Product Catalog

Sales Tax Holidays & Product Codes (TICs)

TaxCloud Taxability Information Codes (TIC)

Taxability and TICs

Calculating sales tax on Digital Goods

Calculating sales tax on P.O. Boxes

Does TaxCloud Calculate Sales Tax for International Orders?

Guidelines on When TaxCloud May Cover Penalties and Interest (P&I) for Sales Tax Fiilings

How does New York handle sales tax on apparel under \$110?

How does TaxCloud round sales tax?

Is the plus 4 zip code extension (9 digit zip) required to calculate sales tax?

Understanding the difference between sales tax and use tax

What is Sales Tax Sourcing?

What is Streamlined Sales Tax (SST) and do they cover TaxCloud services?

How do I know if I've reached Economic Nexus in a state?

What is Nexus?

What is Washington B&O Tax?

Tax Concepts

Building a custom API connection with TaxCloud

Building a direct API integration with TaxCloud

Reviewing and Submitting an Exemption Certificate

How to Add and Manage Integrations in TaxCloud

Video: How to add or disable an integration

General Integrations

How the QuickBooks Online Integration Works

Connecting TaxCloud to QuickBooks Online

Changing the Sales Tax Display Mode for QuickBooks Online

Managing Exempt Customers in TaxCloud for QuickBooks Online

Managing Invoices with Multiple Payments in Quickbooks (Real-Time Integration)

QuickBooks Online Integration: How to Resolve a Missing Account, Product Code, or Sales Tax Item Error