### Summary

This article explains how to download the official CSV template and format your data correctly. Following these steps is crucial for a successful bulk transaction upload and helps prevent common processing errors.

### When to Use This

Always refer to this guide before creating or editing a CSV file for transaction uploads. Proper formatting is the most important step to ensure your data is processed quickly and accurately.

[How to Format Your CSV File for Transaction Uploads 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-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=ASIAUPPN5IL32JOOD5PZ%2F20260523%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260523T172711Z&X-Amz-Expires=3000&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEG4aCXVzLWVhc3QtMiJGMEQCIBr5fqzXOf5tKqxLX7%2BHka82ZowPlYuZv1%2BIugKSJ2FBAiBVaDEcBXQvyHA4VvaEil8GPi1Tv1RF2exephugzKlv5SrdBQg3EAIaDDMwODEyNTk3NTI4NyIM%2BujX88GXRlEaw9pnKroFHwiThrGI%2FgJaGMAxB1akjilff%2FoSDMWUKNxIw1l01MRndOopcPPkjcQGzO4z%2BeuUqZHLyqo0XV5V7UNRJQ2bOE8%2FhScyz4kHJBhU8BdvrL0uOr0sBx7qQrXtJ6gx%2BKNSQH7ly7VEWBS2X6JPfPkaKkp5L3VY2FYzBoOf%2Fg6sfWBCe0Qdye7SJunLp0zJ0e6UpC6QwCzDRvhEfCx3gecdAIeEcTz18yRYv6wzegTd1cJSLY1J0SbLT%2B%2BU1p7myCBqqRCnVHiIBJ2gfPhFfyaZTfIc9tQhd2c06A6jmaqRyqzTq8AVVUnY7sf7i%2FJOAjdrDIWJli2xaX1kszF5wmPOeQzkic3FfBSHWokq0DmRk%2BjU4gdOchjupAcRzzWfwX5oOnPa2t0FtdhtixRNYZ%2F%2BsJzgEcGgy2u3SHCJLrJzSeIdt4qAOK3%2BU6iyyVyWUoVK5Pyptl8PNRkYDHJuKA%2F7oPEYGessTR3Dv4mG6yTPyEZBOmzY9Him8dv13NkSrCjDQMqdMqAsIyImrUQ1dAV8G6rSZTo3YB09IGzxSJP9Gx5gr6Dj71FGzyD0rn8NtFgJSLXdgVswql7WyBFrIM1Az31dKrYEwCWovmtnokedi1qSWyP859IJAKn4uYFybcUS9TO28JRb%2BzY6L7FXlhJ74ASTWXwp6o54BpqAZcxLXRd0%2BopeSLIqPFjmojo8veXhxuTtj%2F3Q74TxcpeiICKuq14zYbENuG65HE0YWOUfIgjYxtr%2FPusip1oAGvNX5IuvbeHftOj%2FR%2BXkt6jn0%2FKxMsovrROolxet%2BwcincD5mbxWmOMw3oMcLfDFemMlD2og%2BP10mShs1%2BppwOruYpdtrAcuKCP4otMwZnoOp7ajWqV4mUyHaKo%2FB25kTr789TPTJV5UfD1A2P9AtS76uO6%2FLWZdVZbXj4iO6Fkw2uvG0AY6kQEVog5WkaDwWd0exhWO9UkdQatHjad9%2FkAtX4M0UKbNCayZNt31pyIVJvDw%2BnZHB%2FbHj%2B8iocu2tn7oRQYBzEBulcHP2n9p8FXlNeQFnfeDujYsMYB4s37Ig6dpOMSAP%2Bk9DdOC8MR7Ub6Q%2FUF9szy7cnaHEHuKzafvNTHvkyqAfu8R1qKugk2PEULEFLCM9YPb&X-Amz-Signature=e1348f0fe78015047834120cdeba9227f7b33b5229749139f9364f6fb4c8b8f5&X-Amz-SignedHeaders=host&response-content-disposition=attachment&x-amz-checksum-mode=ENABLED&x-id=GetObject#t=32,61)

### Step-by-Step Instructions


1. **Access the Documentation**: From the main menu, navigate to the transaction upload section and click the **Upload a CSV file** button.
2. **Open the Documentation Dropdown**: On the upload page, locate and click the **Documentation** dropdown menu.
3. **Download the Template**: Click the **Download Example** button within the documentation section. This will download a sample CSV file with all the necessary headers.
4. **Review Column Requirements**: The Documentation section provides a detailed table of all possible columns. It explains what each column is for, provides an example, and specifies the data type (e.g., string, date, number), whether the field is required (`is nullable` = false), and the maximum length.
5. **Populate Your Data**: Open the downloaded template and fill in your transaction data under the appropriate columns. Ensure that all required fields are filled and that the data matches the specified format (e.g., dates are `YYYY/MM/DD`).

### Common Questions (FAQs)

**1. Where can I find the CSV template?** You can download the template by clicking "Upload a CSV file," opening the "Documentation" dropdown, and then clicking "Download Example."

**2. What is the difference between required and optional columns?** Required columns must contain data for every transaction row to be processed successfully. Optional columns can be left blank if the information is not applicable or available.

**3. Do I need to include all the columns from the template in my file?** No, you only need to include the columns you are using. However, you must include all required columns for the upload to be successful. The column names must exactly match those in the documentation.

### Troubleshooting Tips

* **Can't Find Download Button**: The "Download Example" button is located within the "Documentation" dropdown on the CSV File upload page. If you don't see it, ensure you have clicked on the documentation section to expand it.
* **Data Formatting Issues**: Carefully check the "Type" and "Max Value" fields in the documentation table to ensure your data conforms to the required structure. For example, ensure dates are in the correct format and zip codes do not exceed the maximum length.




How to Format Your CSV File for Transaction Uploads

When does TaxCloud pull my tax funding?

Understanding Tax Reports and Drilling Into Transaction Details

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

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

Using the Download Center for Reports

Reporting

How to Import Partial Refunds via CSV

CSV Template Required Fields and Column Descriptions

When is the deadline to upload my transactions to TaxCloud?

Why are exempt sales taxing in my import?

What is TaxCloud's policy regarding Transaction import timing?

Upload Standalone Returns via CSV

How to Upload Transactions via CSV

How to Troubleshoot CSV Upload Errors

Uploading Transactions via CSV

Uploading Historical and Marketplace Transactions via CSV

Transactions: Import and Export

Setting the Transaction Shipping Destination

How to Manually Add a Transaction

Transaction Timestamp Policy

How to Filter Transactions with Advanced Search

Managing your transactions

How to manually return a transaction in TaxCloud?

Can I edit a transaction?

How to View and Share Transaction Details

How to Locate a Transaction URL in TaxCloud

Transactions: Overview

Navigating Your Tax Dashboard

Transactions and Reporting

TaxCloud Onboarding Webinars

What is TaxCloud's Premium Trial?

How to Set Up and Manage Locations

How to Take Your Integration Live

Preparing For Onboarding

**How to Download Debug Logs in TaxCloud for WooCommerce**

Getting Started

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

How to Update My New Business Address With The States?

Best Practices for your TaxCloud Account

Verify Your TaxCloud Account is Complete for Calculations

How to Enable & Disable Tax Collection in a State

How do I reset my Password?

Video: How to complete your TaxCloud Business Profile

How to Use Multi-Account Login

How to Close Your TaxCloud Account and Cancel Subscription

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

TaxCloud Account Lockout Policy

Account Management

How to create a TaxCloud account?

Account Setup

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

How Payment Methods Are Used For Billing and Tax Funding

How do I change my default payment method?

How to Add a Payment Method in TaxCloud

Billing and Payments

Account and Billing

Understanding the difference between TaxCloud Starter and Premium Plans

Changing your TaxCloud Subscription Plan

Fee Schedule: Understanding TaxCloud Fees

Plans and Pricing

What are API calls and what do they do?

Where to Find Your API Credentials

TaxCloud System Status

TaxCloud's APIs

What happens if I go over my allotment of orders?

What is an order in TaxCloud?

Understanding the Minnesota Delivery Fee

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

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

How do I find my Merchant Number?

What Services Does TaxCloud Provide?

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

What is a multi-state id or sstid?

How do I confirm a rate with TaxCloud?

What is a voluntary seller?

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

Can TaxCloud help with my State Income Taxes?

What are Home Rule States?

Understanding Nexus Threshold Calculations

General

How to Add an Exemption Certificate to TaxCloud

How to Upload Exemption Certificates in Bulk

What is an Exemption Certificate?

Exemptions and Certificates

TaxCloud Audit Support Overview

How to contact TaxCloud?

Support and Resources

Does TaxCloud Handle Sales Tax License Renewals?

Nebraska - Enforcement of Lien Notice

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

Louisiana State Sales Tax Rate Update

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

When To Forward a State Notice to Taxcloud

Arkansas - Excise, Waste Tire or Withholding Wage Tax

California - CDTFA Statement of Account

Colorado SUTS Filing Reminder Notices

Connecticut - Delinquency Notice

Florida - Credit Memo

Indiana - Notice of Proposed Assessment

Michigan - Business Taxes Registration Summary of Changes

New Jersey - Certificate of Registration

North Carolina - Certificate of Registration

Rhode Island - Failure to Renew

Tennessee - Notice of Overpayment

Texas - Notice of Tax/Fee Due

Texas - Sales & Use Tax Return Paper Form

Wyoming - License Certificate

State Notices and Licenses

Understanding TaxCloud's Filing Costs & Filing Subscription

What are TaxCloud Filing Fees?

Understanding Your Tax Reporting Page

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

Does TaxCloud file Withholding Tax?

Filing: General

How to Request TaxCloud to Begin Filing Sales Tax Returns

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

How to Stop Filings with TaxCloud

How can TaxCloud assist with Filing?

Enabling Filing in TaxCloud (via Thresholds Page)

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

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

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

Filing: Managing Filing in TaxCloud

Does TaxCloud File in Louisiana?

South Dakota - Sales & Use Tax Return Paper Form

Filing: State-Specific Workflows

Managing Your Tax Thresholds

Filing and Compliance

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

What is Sales Tax Sourcing?

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

Understanding the difference between sales tax and use tax

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

What is Nexus?

What is Washington B&O Tax?

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

Calculating sales tax on Digital Goods

Calculating sales tax on P.O. Boxes

Does TaxCloud Calculate Sales Tax for International Orders?

How does TaxCloud round sales tax?

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

Is shipping taxable?

Managing Product TIC Mapping with Product Catalog

Sales Tax Holidays & Product Codes (TICs)

TaxCloud Taxability Information Codes (TIC)

Taxability and TICs

Tax Concepts

Updating to TaxCloud's new Shopify App (June 2024)

Shopify Reporting FAQ

Connecting TaxCloud to Shopify

How to Mark Customers Tax Exempt in Shopify

Shopify

Why do my TaxCloud orders have Fallback rates in BigCommerce?

Connecting TaxCloud to BigCommerce

Marking a Customer Exempt in BigCommerce

Upgrading from the Legacy BigCommerce Integration

BigCommerce

How to connect my Odoo store to TaxCloud

How to Connect my TaxCloud Account to Odoo Sale (Loyalty)

How To Connect my TaxCloud Account to Odoo Sale (Loyalty) - Delivery

How to Connect my TaxCloud Account to Odoo eCommerce

How to Connect my TaxCloud Account to Odoo Sale

How to Connect my TaxCloud Account to Odoo Amazon/TaxCloud Bridge

How to Connect my TaxCloud Account to Odoo TaxCloud & Subscriptions

Upgrading TaxCloud Modules in Odoo

Odoo

Connecting TaxCloud to WooCommerce

Enabling Exemptions In TaxCloud for WooCommerce

How to Configure WooCommerce Order Capture Behavior with TaxCloud

Understanding WooCommerce Integration Modes

How to Download Debug Logs in TaxCloud for WooCommerce

How to Enable Rate Limiting in TaxCloud for WooCommerce

WooCommerce

Troubleshooting QuickBooks Online Tax Calculation Errors

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