This guide lists the most common errors encountered in SynkriaOps, organized by module. For each error, you will find the exact cause and the steps to resolve it in under two minutes.
Error message Module Cause Solution ”Debit ≠ Credit” Accounting entry Total debit and credit amounts are not equal — violation of the fundamental SYSCOHADA rule Check each line of the entry; adjust amounts or add the missing line to balance ”Fiscal year closed” Accounting entry Attempting to enter data on a fiscal year that has been closed Open a new fiscal year or request reopening from the ADMIN (minimum 10-character reason required) “Account does not exist in chart of accounts” Accounting entry The account number entered does not exist in your SYSCOHADA plan Check the number in Accounting → Chart of accounts; create the account if necessary ”Validated entry — modification impossible” Accounting entry Attempting to modify an already validated entry Create a reversal entry from the validated entry (click “Reverse”) “Unbalanced balance sheet” Fiscal year closure Unbalanced entries exist in the fiscal year Identify and correct unbalanced entries from General ledger → Filter by DRAFT status ”Inconsistent opening balances” Accounting carry-forward Beginning-of-year balances do not match the previous fiscal year’s closing balances Re-run the carry-forward from Accounting → Carry forward; verify amounts against fiscal year N-1 ”Reconciliation impossible — different amounts” Reconciliation Selected debits and credits for reconciliation do not balance Check the selected amounts; reconciliation requires a residual of 0 on both sides
Error message Module Cause Solution ”Contact not found” Invoice, quote The selected customer or supplier has been archived Search for the contact in Contacts → [type] → Archived filter; reactivate if needed ”Invalid NIU” Contact creation The NIU format does not match the Cameroonian fiscal standard Check the exact format: letter + 12 digits + letter (e.g. M123456789012A); leave blank if unavailable ”Name already in use” Contact creation A contact with this exact name already exists Check the existing contacts list; if unintended duplicate, slightly modify the name
Error message Module Cause Solution ”Expiry date in the past” Quote The expiry date is on or before today Edit the expiry date by choosing a future date ”VAT rate not configured for this country” Quote, invoice The applicable VAT rate is not set up for the file’s country Configure the rate in Settings → VAT before returning to the document ”Expired or refused quote — conversion impossible” Quote → Invoice Attempting to convert an unaccepted quote Duplicate the quote, update the date, resend it, and wait for acceptance
Error message Module Cause Solution ”Unrecognized file format” Statement import, OCR The uploaded file is not in a supported format Check accepted formats: bank statement (OFX, CSV, MT940), OCR invoice (PDF ≤ 50 MB, JPEG, PNG) “PDF too large” OCR The PDF file exceeds 50 MB Compress the PDF with an online tool or split it into multiple files ”Duplicate detected — X transactions” Statement import Transactions with the same identifier or date/amount already exist Review the import report; skip duplicates or verify this is not a genuine double import ”Missing column in CSV” Contact, product import The CSV file does not match the expected format Download the CSV template from the import page and re-export your data in that format ”Transaction direction reversed” Mobile Money import The wallet account identifiers are misconfigured, reversing expenses and income Check the Mobile Money configuration in Settings → Mobile Money → review the account identifier
Error message Module Cause Solution ”OCR duplicate detected” OCR import An invoice with the same number or amount has already been imported Check Purchases → Supplier invoices to see if the invoice exists; skip the duplicate if it’s the same document ”Read failed — insufficient quality” OCR Scan too blurry, low resolution, or rotated document Rescan at ≥ 300 dpi in black and white; if not possible, enter the information manually
Error message Module Cause Solution ”Session expired” Global The JWT token has expired (15 minutes of inactivity) Reload the page — you will be automatically reconnected via the refresh cookie (valid 30 days) “Insufficient permission” Global Your role does not allow this action Contact the file ADMIN to verify or change your role ”Account locked” Sign in Too many failed sign-in attempts (anti-brute force protection) Wait 15 minutes or contact support for immediate unlocking
Error message Module Cause Solution ”Invalid webhook signature” Mobile Money The HMAC signature of the callback does not match the configured key Check the Mobile Money secret key in Settings → Mobile Money; never share this key ”Insufficient balance for reimbursement” Expense reports The reimbursement amount exceeds the available balance in the selected account Select a different account or check the bank balance
If an error persists after applying the indicated solution, note the exact
message, the module concerned, and the approximate time, then contact support
via Contact support .
Fiscal year errors are among the most common at the start and end of the accounting year. They typically occur in three situations: attempting to post to a closed fiscal year, inconsistent opening balances during a carry-forward, or no fiscal year yet open for the new period.
Situation Error displayed Solution Posting to a closed year ”Fiscal year closed” Open a new fiscal year or request reopening (ADMIN only, reason required) Inconsistent carry-forward ”Inconsistent opening balances” Re-run carry-forward from Accounting → Carry forward; verify N-1 balances No active fiscal year ”No active fiscal year” Create and open a fiscal year from Accounting → Fiscal years → Open
