Why doesn't an uncommitted Avalara transaction show up on my sales tax return?
AvaTax only reports committed transactions. Commit status is a flag that determines whether a transaction appears on your compliance reports and gets remitted — uncommitted transactions are treated as provisional and are excluded from liability calculations and filings until someone explicitly commits them.
Part of the finance integrations guide.
| Symptom | A real sale is missing from the AvaTax compliance/liability report |
|---|---|
| Root cause | The transaction was created but never committed |
| Default commit value on CreateTransaction | false, unless explicitly set to true |
| Ways to commit | commit: true at creation, the CommitTransaction API, or manually in AvaTax |
| Deadline that matters | Commit status must be correct before the filing period's reconciliation, not in real time |
Committed is a status, not a synonym for "created"
Creating a transaction in AvaTax and having it count toward your tax liability are two separate steps. Avalara's own developer documentation describes commit status as "a simple flag that determines if a transaction should appear on your compliance reports for remittance to the Department of Revenue at the end of your filing period." A transaction created without that flag set defaults to uncommitted — it exists in AvaTax, it can be retrieved and calculated against, but Avalara's reportable-transactions documentation is explicit that uncommitted transactions "are considered provisional — they are subject to review and will generally not appear in reports or liability calculations."
Why this is easy to miss
Nothing about an uncommitted transaction looks broken from inside AvaTax. It has a status of Saved or Posted, it calculated tax correctly, and it's fully visible if you look it up directly by document code. The gap only shows up when someone reconciles what accounting believes was sold in a period against what AvaTax actually reports — and by design, that reconciliation usually happens close to the filing deadline, which is the worst time to discover a batch of real transactions was silently excluded.
How transactions end up stuck uncommitted
Three patterns account for most cases. First, an integration calls CreateTransaction without ever setting commit to true, and nothing downstream calls CommitTransaction either — the integration was built to calculate tax, not to finalize it, and nobody added the second step. Second, a batch commit job that's supposed to run on a schedule fails silently for a subset of transactions — a validation error on one record can leave others in the same batch uncommitted without an obvious alert. Third, someone manually reviewing transactions in the AvaTax UI intends to commit a batch after checking it, and the review step gets deferred past the point it should have, leaving transactions in limbo through the filing deadline.
How to find and fix it before a filing deadline
Query for transactions in the period with a status other than committed, rather than trusting that everything created was committed. If you find real, finalized sales sitting uncommitted, the fix is to commit them explicitly — either through the CommitTransaction API or manually — before the filing period's reconciliation runs. Avalara's documentation also notes a hard constraint worth planning around: committed document codes lock on the first day of the following calendar month, so a transaction that should have been committed for last month's filing needs to be caught and corrected before that window closes, not after.
Next step
Map the finance workflow with the most exposure and prove the automation path.
Bring the invoice, contract, payment reconciliation, or customer finance workflow you have to defend at audit. Loopfour can map the trigger, controls, integrations, and approval loop.
Worked example
A month-end reconciliation that comes up $11,400 short
Accounting closes the month showing $412,000 in taxable sales for the period, sourced from the billing system. The AvaTax compliance report for the same period totals $400,600 — an $11,400 gap. Pulling every transaction for the period by status (not just by date) shows six invoices sitting as Saved rather than Committed, all created through a code path added the prior month that calls CreateTransaction without ever calling Commit or passing commit: true. Each of the six is a real, valid sale; none has an accounting problem. The fix: commit all six manually before the filing deadline, and patch the new code path to pass commit: true at creation (or add a scheduled commit job) so the same six-invoice gap doesn't recur next month.
Frequently Asked Questions
Sources
Related
Topic
Integrations
Every finance automation vendor publishes an integrations page: a grid of logos, a claim of "seamless" connectivity, and not much else. That page answers a marketing question — does this vendor touch…
Read moreDiagnostic
Why is Avalara rejecting a sales invoice with a DocumentCodeConflict error?
A DocumentCodeConflict means the document code you sent already belongs to a committed transaction in AvaTax. The fix is not a fresh code — retrying with a new code every time is exactly what creates duplicate tax transactions on a real network retry. Keep the code stable, derived from the source invoice, and call the adjust or void endpoint if the original genuinely needs to change.
Read moreHow-to
How do I sync a Rillet contract amendment into my revenue recognition schedule?
Call Rillet's amend-a-contract endpoint with an amendment_date, an amendment_reason, and the changed items, choosing whether each item takes effect as of the amendment date or at the end of the current billing cycle. Rillet regenerates the affected revenue schedule and journal impact for review before anything posts.
Read more