Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Error messages explained

Every error message ZeraBooks shows, grouped by screen, with what it means and how to fix it. Search this page for the words you see on screen.


Closed periods (any screen)

These messages appear when you try to add or change something dated on or before the date your books are closed through.

MessageWhat it meansHow to fix it
"Jun 15, 2025 is in a closed period: the books are closed through Dec 31, 2025. Reopen the books from Reconciliations, or use a date after Dec 31, 2025."The date you're saving is in a closed period. Nothing was saved.Use a later date, or reopen the books in Reconciliations, make the change and close them again. See Close and reopen the books.
"This month is closed. The books are locked through {date}. Reopen from Reconciliations to change it."Shown in Banks & Cards Edit mode on a closed monthReopen the books to change categories in that month
"This date is in a closed period. Reopen the books from Reconciliations to change it."A category change in Banks & Cards fell in a closed monthReopen the books, then save again
"That date is in a closed period. Reopen the books from Reconciliations first."An Autopilot answer or undo would change a closed monthReopen the books, then answer or undo again
"This period is closed. Reopen the books from Reconciliations to link these, then close them again."Suggested vendor links fall in a closed periodReopen the books, click Link, then close them again
"Invoice date is in a closed period"The invoice is dated on or before the closing dateChange the invoice date, or reopen the books

Uploading a bank or card statement

MessageWhat it meansHow to fix it
"Choose one bank or credit card statement as a PDF, CSV or Excel file."The file isn't a PDF, CSV or Excel fileDownload the statement again as a PDF or CSV
"Upload one account's statement at a time."You dropped more than one fileUpload each statement on its own, into its own account
"File too large: ~12 MB (max 10 MB)."The file is over 10 MBDownload a shorter period, or split the statement into two date ranges
"This statement has already been imported into this account." (shown as Statement already imported)The same file was uploaded beforeNothing to do. To replace it, remove the earlier statement first.
"This statement repeats N transactions already owned by another statement. Nothing was imported. …"Some rows are already in your books from another statementRemove the earlier statement first, or upload a statement for a date range that doesn't overlap
"This statement contains more than 10,000 readable rows. Split the source into non-overlapping periods before importing it."The statement is too long to read in one goUpload it as several shorter periods
"This is a … statement (…), but … is a …. Nothing was imported. …"A credit-card statement was uploaded into a bank account, or the reverseChoose the matching account under Bank or credit card and upload again
"This statement identifies its currency as … but … is declared …. Nothing was imported. …"The statement's currency doesn't match the account'sUpload into an account with that currency. See Add bank and credit-card accounts.
"Exchange rates for … could not be resolved (…). Nothing was imported …"A foreign-currency statement couldn't get its exchange ratesTry the upload again in a few minutes
"Statement does not tie: opening + transactions − closing = X. Imported anyway — compare the register against the document…"A warning, not an error. The statement's printed balances don't add up.Open the month in Reconciliations. See Fix a month that doesn't tie.
"Choose your starting point first"The company's setup isn't finishedClick Continue company setup
"Bring in your opening balances first"Opening books are unfinishedClick Continue opening books. See Move your books to ZeraBooks.
"We couldn't check this business's starting point. Try again before uploading."ZeraBooks couldn't check the company's setupClick Try again

Banks & Cards register

MessageWhat it meansHow to fix it
"Could not load the register. Retry before relying on these balances."The register didn't load, so balances may be out of dateCheck your connection and retry
"Category changed since this register loaded"Someone or something changed the category after the page loadedClick Reload saved categories, then make your change again
"No transactions in {period}."No statement covers this period for the accountChange the period, or upload the missing statement
"No transactions match your filter."Nothing matches what you typedClear the filter

Reconciliations

MessageWhat it meansHow to fix it
"Balances must be numbers — enter them exactly as printed."A balance in Fix statement details isn't a numberEnter digits only, for example 9830.22
"Could not load reconciliation records and sign-offs. Displayed records may be out of date. Check your connection and try again."The page couldn't loadClick Retry reconciliation
"No accounts match this filter."A stat card filter hides every accountClick Clear filter
"Statement coverage is incomplete for {months}. A tied statement does not mean the whole month is covered."Part of a month isn't covered by any statementUpload the statement for the missing days
"Enter the closing password for this business."The books are protected with a closing passwordEnter it in Closing password
"No document-backed fix found."AI verification found no fix in the documentFix the month by hand. See Verify a statement with AI.
"5 of 12 finalized. …"Finalize all stopped partwayRead the reason, fix that month, and click Finalize all again

Autopilot

MessageWhat it meansHow to fix it
"Could not load the autopilot."The page didn't loadClick Retry
"Your session ended. Sign in again."You were signed outSign in again
"The autopilot could not run."The pass didn't completeClick Run now again
"That answer could not be applied."The answer failedTry again. The list refreshes to show what's still open.
"That question was already answered."It was answered elsewhereRefresh the page
"That is not one of the offered answers."The answer no longer matches the questionRefresh the page and answer again
"This question can no longer be answered here."The item changed since the question was askedNothing to do; the question is withdrawn
"That action could not be undone."The undo failedCheck for a closed period, then try again
"That action was already undone."It's already undoneNothing to do
"This action cannot be undone. Merged records stay merged."Merges can't be undoneFix the vendor or customer by hand
"Nothing to undo — …" (for example "…this document was voided since.")The action's result was already changed outside AutopilotNothing to do
"The setting could not be saved."A mode or switch change didn't saveTry again

Ledger and manual transactions

MessageWhat it meansHow to fix it
"Debits and credits differ by {amount}."The entry doesn't balanceAdjust the lines until Difference is zero
"A transaction needs between 2 and 200 accounting lines."Too few or too many linesAdd or remove lines
"Every line needs a category."A line has no categoryPick a category on every line
"Every amount must be nonzero and have no more than two decimal places."An amount is zero or has too many decimalsCorrect the amount
"A transfer needs two different bank or card accounts, with money leaving one and entering the other."The same account is on both sidesChoose a different To account
"Use the bill or invoice payment action to settle a customer or vendor balance."Pay In or Pay Out can't post straight to what customers owe you or what you owe vendorsRecord the payment from the bill or invoice
"Choose {dimension} for every line."A required field is empty on a lineFill it in on every line
"Couldn't save this transaction"The server refused the saveRead the message under it; your changes are still there
"A statement confirms this transaction. Unmatch it before changing its accounting."A statement line has cleared this entryClick Review match and unmatch it first
"Choose how this company will start before adding activity. Open Company settings to finish setup."Company setup isn't finishedFinish setup in Settings
"Finish bringing in the previous books before adding new activity…"Opening books are unfinishedFinish your opening books first
"Could not load the ledger. Check your connection and try again."The page didn't loadClick Retry ledger
"Could not load this transaction."The transaction didn't openClose it and open it again

Importing journal entries

MessageWhat it meansHow to fix it
"Row N: enter one positive debit or credit, with no more than two decimal places."A row has both, neither, or a bad amountFix that row in your file
"Row N: "{x}" must identify one active category by number or exact name."The category isn't found or isn't activeUse the category number, or its exact name from the Category Manager
"Import up to 100 journals at a time."The file has more than 100 journalsSplit the file
"This file includes journals already imported into this company…"Some journals were imported beforeRemove them from the file

If any entry fails, none are posted. See Import journal entries.


Category Manager

MessageWhat it meansHow to fix it
"This number is already taken"Another category uses that numberChoose another number, or leave it blank to assign one
"No importable rows — every row was missing a Category Name or had an unrecognized Type."The file doesn't match the templateDownload the CSV format template and use its columns
"Couldn't find any categories in that file…"The file isn't a chart of accountsExport the chart of accounts list, not a balance sheet or P&L
"That PDF is too large (max 10 MB)"The PDF is over 10 MBExport a smaller file or use CSV
"{name} has activity and can't be removed here."A bank or card account with transactions can't be removedRemove its statements first in Banks & Cards
"Keep the account name within 100 characters (now {n})."The account name is too longShorten it
"Categories couldn't be loaded"The page didn't load. Your saved chart hasn't changed.Check your connection and try again

Financials and reports

MessageWhat it meansHow to fix it
"Could not load the financials. Check your connection and try again."The page didn't loadClick Retry financials
"Finish this business's starting setup before downloading financials."Setup isn't finishedFinish setup first
"Could not build the PDF." / "Could not build the workbook." / "Could not build the package."The download failedTry again
"Could not verify and export the report. Please retry."The export couldn't be checkedTry again
"Enter at least one recipient email address."To is emptyAdd an email address
"Send to no more than 10 recipients at a time." / "Use no more than 10 recipient addresses, including CC."Too many addressesUse 10 or fewer, To and CC combined
"Enter an email subject." / "Use a subject of 200 characters or fewer on one line."The subject is missing or too longFix the subject
"Use a message of 10,000 characters or fewer."The message is too longShorten it
"Select at least one attachment to send."No report is tickedTick at least one attachment
"The attachments are too large to email — deselect some and try again."Attachments are over 25 MB togetherUntick some attachments

Custom Reports

MessageWhat it meansHow to fix it
"Could not load the reports."The list didn't loadRefresh the page
"Could not run the report. Check your connection and try again."The report wasn't createdClick Retry report
"Your changes could not be saved. Check your connection and try again."Autosave failedClick Retry save, or Download my text to keep a copy
"The report figures could not be loaded. Your saved text and files are safe. Retry to continue."Figures didn't loadClick Retry figures
"This report already has 20 attachments. Remove or replace a file first."The 20-file limit is reachedRemove or replace a file
"Add one file at a time so each upload can be checked."More than one file was addedAdd files one by one
"Add at least one section before publishing."The report is emptyAdd a section with Add

Bills and invoices

MessageWhat it meansHow to fix it
"This file is empty. Export the document again before uploading it."The file has no contentExport or download it again
"This document is larger than 14 MB. Choose a smaller document."The file is over 14 MBUse a smaller file
"Choose a PDF, PNG, JPG, WEBP or HEIC document."The file type isn't supportedSave it as PDF or an image
"{file} is already in ZeraBooks."The same document was uploaded beforeClick Open existing
"N documents could not be read. Open it to type the amounts by hand, or upload a clearer copy."The reader couldn't read the documentEnter the details by hand, or upload a clearer copy
"Could not refresh bills. Check your connection and try again."The board didn't loadClick Retry loading
"Choose a customer before saving."The invoice has no customerPick a Customer
"Choose a due date on or after the invoice date before saving."The due date is too earlyFix the Due Date
"Add at least one line item."The invoice has no linesClick Add Line Item
"Replace Uncategorized Income on line N before saving."A line has no real categoryPick a category on that line
"Invoice retainage cannot exceed the invoice total."The holdback is too bigLower the holdback
"Quantities can't be negative. For a credit, keep the quantity and enter a negative price."A negative quantity was enteredEnter a negative price instead. See Credit memos.
"Declare this client's books currency before approving invoices — open Manage Clients and edit the client to set it."The company has no books currencySet the currency on All Clients › Edit
"Invoices could not be verified"The board didn't load. Your invoices are still saved.Click Retry

Vendors, customers and products

MessageWhat it meansHow to fix it
"Could not load vendors. Check your connection and try again." (or customers)The page didn't loadClick Retry loading
"“{name}” already exists. Open that one instead, or merge the two below…"A vendor or customer with that name existsOpen the existing one, or merge them
"Could not load the catalog."Products & Services didn't loadClick Retry catalog

MessageWhat it meansHow to fix it
"Enter the business name."The name is emptyType the business name
"You already have a business called "{x}". Give this one its own name."The name is taken in your accountUse a different name
"Could not verify completed onboarding."ZeraBooks couldn't check your setupRefresh the page
"Choose a nonempty PDF, CSV or Excel (.xlsx) export no larger than 10 MiB."A closing report file isn't acceptedExport it again as PDF, CSV or .xlsx under 10 MiB
"This company already has statements, journals or documents…"Opening books can only be brought into a company with no activityUse a new company for the opening books
"Undo is unavailable after subsequent bookkeeping, payment history or a period close."The opening-books import can't be undone any moreCorrect individual balances instead
"Couldn't load your clients."All Clients didn't loadClick Retry
"Company list could not be refreshed. Open All Clients to retry."The company list in search is out of dateOpen All Clients
"Could not search vendors and customers. Check your connection and retry."Search couldn't load vendors and customersClick Retry search
"Could not confirm completion. Please try Finish again."The walkthrough's last step didn't saveClick Check completion
"Something went wrong loading your account."The trial page didn't loadClick Try again, or Sign out and back in
"Could not load the dashboard. Check your connection and try again."Dashboards didn't loadClick Retry dashboard
"Could not load this analysis. Check your connection and try again."Expenses, Revenue or Cost of Revenue didn't loadClick Retry analysis

Frequently Asked Questions

What does "is in a closed period" mean?

The date you're saving is on or before the date your books are closed through, so nothing was saved. Reopen the books in Reconciliations, or use a later date. See Close and reopen the books.

Why was my statement refused with "Nothing was imported"?

ZeraBooks refuses the whole file when it repeats rows already in your books, or when its account type or currency doesn't match the account you chose. The message says which; fix that and upload again.

My statement imported with "Statement does not tie". Is that an error?

No, it's a warning. The transactions were imported, but the printed balances don't add up. See Fix a month that doesn't tie.

What should I do when a page says "Check your connection and try again"?

Check that you're online, then click the retry button on the message. Your saved data isn't affected by a failed load.

I see an error that isn't on this page. What now?

Contact ZeraBooks Support with the exact message and the page you were on. A real person reads every message.


Still stuck? A real person reads every message—come say hello.