Troubleshooting

Common Issues

Issue	Cause	Solution
File Hash already existing!	Duplicate ZIP file upload	This file was already uploaded. Check existing records.
Validation fails with XML error	Corrupted or non-CVGo ZIP file	Verify the ZIP contains valid CVGo XML exports
Posting blocked: "MOPs are not configured"	New auto-created MOP account	Open each listed MOP, review settings, click Mark Configured
Reconciliation shows Unbalanced	Rounding differences > 1.00 or unposted transactions	Check Logs; verify all transactions were posted
Tax not applied to SO lines	No matching tax found on the branch	Confirm "12% CVGo (Incl.)" tax exists for that branch — see Taxes
_check_company error during posting	Tax/journal belongs to a different branch	Re-check the MOP account's sale_journal_id and payment_journal_id are scoped to the correct branch
Register Payments button missing	All invoices are already paid	No action needed — payments are up to date
Posting timeout	Too many transactions in detailed mode	System processes 50 at a time. Wait for cron or re-click Post.
Products not matched	Barcode/name mismatch	Check product master data. System auto-creates if no match found.
Skipped transactions > 0	Transaction marked posted but no SO created	Check Logs for errors during that transaction's posting
SO numbers overlap across branches	Per-branch sequences not loaded	See Sequences — verify ir.sequence records exist with company_id for each branch

Checking Logs

1. Open the CVGo POS Data record
2. Go to the Logs tab
3. Filter by level (Error, Warning, Info)
4. Error logs include the receipt identifier so you can trace which transaction failed

Multi-branch sanity checks

Quick SQL queries to verify the multi-branch setup is correct:

-- Verify Panville is the parent and 6 children exist
SELECT id, name, parent_id FROM res_company ORDER BY parent_path;

-- Verify each branch has its own SO sequence
SELECT s.name, s.code, s.prefix, c.name AS branch
FROM ir_sequence s
JOIN res_company c ON s.company_id = c.id
WHERE s.code = 'sale.order'
ORDER BY c.name;

-- Verify each branch has the CVGo VAT-inclusive tax
SELECT t.name, t.amount, c.name AS branch
FROM account_tax t
JOIN res_company c ON t.company_id = c.id
WHERE t.name = '12% CVGo (Incl.)'
ORDER BY c.name;