A cashier rings up sales, the day closes, and the POS Closing Entry reconciles the shift — except a handful of invoices aren't in it. They were created before anyone opened the POS shift for the day, so ERPNext left them out of the Closing entirely. They never became consolidated Sales Invoices, so the revenue, the tax and the payment never posted to your accounts. The cash is in the drawer; the sale is nowhere in the ledger. This post shows how to find those orphaned invoices, the release that stops new ones, and how to bring the old ones back into the books.
A missing error is more dangerous than a loud one: nobody investigates a sale that simply isn't there. I am Manoj, and I lead ERPNext and Frappe implementations at MithTech, a team of Frappe specialists in Bengaluru. This is the POS fault that shows up as a gap between the till and the books that nobody can explain.
What actually breaks
ERPNext's POS runs in shifts. A POS Opening Entry starts the shift and records the opening float; cashiers create POS Invoices through it; a POS Closing Entry ends the shift, reconciles the payments and consolidates the shift's invoices into Sales Invoices that post the accounting. The Closing Entry finds the invoices to consolidate by looking in the window between the Opening and Closing times.
The defect fixed by PR #46907 is that ERPNext let a POS Invoice be created before a POS Opening Entry existed for that profile. Such an invoice has a timestamp earlier than the Opening, so it falls outside the consolidation window, and the Closing Entry never sweeps it in. The sale is captured as a POS Invoice — the customer paid, the cash is real — but it never becomes a consolidated Sales Invoice, so no revenue, tax or payment entry posts. It simply sits outside every closing, indefinitely.
The v15.56.0 fix adds a validation: a POS Invoice cannot be created unless a POS Opening Entry exists for the POS Profile. That prevents the orphan at source. It does nothing for invoices already stranded — those you have to find and reconcile.
Interactive
POS Closing Gap Checker
Toggle whether the shift was opened first, whether an invoice landed at the close, and your version to see whether the shift will consolidate fully.
Other POS closing faults with the same symptom
Several separate issues read as "a sale is missing from the close". They have different causes and fixes.
Interactive
POS Closing Symptom Decider
Select the POS closing symptom you are seeing to identify the underlying cause, the tracking issue, and the fix path.
The before-opening orphan is the one v15.56.0 fixes. Others reported on GitHub: POS Invoices that seemed to be skipped during a close on v14 (#41036, closed after an explanation that the close merges the day's invoices into one Sales Invoice), a fix to the invoice-merge step in December 2024 (PR #44772), and, in multi-company setups, the change-amount account picked from the wrong company (#40866). They share a symptom, a sale that should be in the accounts and isn't, and each needs its own check. The common defence is the same reconciliation: after every close, the count of POS Invoices in the shift must equal the consolidated Sales Invoices.
How do you fix it?
Code recipe
Find · Upgrade · Reconcile · Prevent
Copy-paste the orphan report, the bench upgrade to v15.56.0, the reconciliation steps for historical orphans, and the shift discipline that prevents recurrence.
0 of 5 steps done
Tick a step’s number when it is done; the ticks stay on this device.
Find the orphans and price them
Build a Report Builder view on POS Invoice filtered to Consolidated = No. Every row is a POS Invoice that never made it into a Closing. Sum the grand totals — that is the sales value currently missing from your consolidated accounts, and it is the number that makes this a priority rather than a curiosity.
Classify each one
Compare each orphan's posting time against the POS Opening and Closing times for its profile and date. Invoices timed before the Opening are the orphans this fix addresses. Anything else has another cause, so the upgrade alone won't stop it coming back.
Upgrade to v15.56.0 or later
Back up with files, update the erpnext app on the version-15 branch, and confirm you are on 15.56.0 or later. On staging, try to create a POS Invoice with no Opening Entry for that profile — it should now be blocked. This stops new orphans; it does not touch the ones you just found.
Reconcile the historical orphans
For each orphan, create the missing consolidated Sales Invoice so the revenue, tax and payment post, dated in the correct open period with a narration referencing the original POS Invoice. If the period is closed, post in the current open period referencing the original date rather than reopening a closed period without accounts' approval — the same discipline that governs the asset-scrap closed-period case.
Reconcile the tender and re-check
Match the POS payment already banked — cash or card — against the entry you posted, so the money that was physically taken lines up with the accounting. Then re-run the orphan report and confirm the count and value have dropped to zero. This ties into your routine bank reconciliation, where the till takings finally meet the ledger.
When the cashier, the manager and the accountant are three people
The cashier who made the pre-opening invoice did nothing obviously wrong: they rang up a sale before opening the shift, and the system let them. The floor manager who runs the close sees a Closing Entry that looks complete. The accountant who eventually spots the shortfall is a month downstream and cannot tell which shift, which till, or which cashier it came from.
No single person in that chain sees the orphan, which is why it survives. The control that works is a reconciliation nobody has to remember: after each close, the POS Invoice count for the shift must equal the consolidated Sales Invoices, and any mismatch is escalated the same day. Pair it with the shift-order rule — open the shift before the first sale — which on v15.56.0 the system now enforces, but which floor staff should understand as a rule rather than a system quirk, so they follow it on any till still awaiting the upgrade.
Draft policy for your retail and finance leads to ratify. A POS shift is opened (POS Opening Entry) before the first sale of the day, on every till. After each Closing Entry, the number of POS Invoices in the shift is reconciled against the consolidated Sales Invoices, and any difference is escalated to finance the same day. Orphaned POS Invoices are reconciled into the current open period, referencing the original date, with the banked tender matched to the posted entry; closed periods are not reopened for a historical orphan without the accounts owner's approval. Tills below ERPNext v15.56.0 are prioritised for upgrade because the shift-order rule is unenforced there. Confirm the period treatment with your auditor before this enters an SOP.
Upgrade first, or reconcile first?
| Orphans are still being created daily | The orphan set is historical and bounded |
| Staff can't be relied on to open the shift first | One disciplined operator runs every till |
| A GST return or bank rec is already short | The books currently balance and you're being thorough |
| You run multiple tills or companies | A single till, single company |
| You want the shift-order rule enforced by the system | You'll enforce it by procedure until the upgrade lands |
At a glance
| What to know | |
|---|---|
| Symptom | Till takings exceed booked revenue; POS Invoices with Consolidated = No |
| Cause | POS Invoice created before the shift's POS Opening Entry, outside the Closing window |
| Fixed in | ERPNext v15.56.0 (8 April 2025), PR #46910 |
| What the upgrade does not do | Reconcile invoices already stranded |
| Standing control | After each close, every POS Invoice in the shift is consolidated |
Frequently asked questions
Why are some POS invoices missing from the closing entry in ERPNext?
Because they were created before a POS Opening Entry existed for that shift. The Closing Entry only consolidates invoices in the window between the Opening and Closing times, so a pre-opening invoice falls outside it and is never swept in. It is fixed in v15.56.0 by PR #46907.
Which ERPNext version fixes the POS opening entry bug?
How do I find POS invoices that were never consolidated?
Use Report Builder on POS Invoice filtered to Consolidated = No. Every row is an invoice that never entered a POS Closing Entry. Compare each one's posting time to the Opening and Closing times for its profile and date to see whether it predates the Opening or lands at the Close.
Does upgrading fix the sales that are already missing?
No. The v15.56.0 fix prevents new orphans by blocking invoice creation before the Opening Entry, but it does not reconcile invoices already stranded. You must find those with the orphan report and create the missing consolidated Sales Invoices yourself, in the correct period.
What happens to my accounts if I leave the orphans?
Real sales stay outside your revenue, tax and payment postings, so your accounts understate income and GST while the cash sits reconciled at the till. It usually surfaces as an unexplained gap between till takings and booked revenue, or a GST return short against the payment gateway — and the longer it runs, the harder it is to attribute each orphan to its shift.
Can an invoice still be missed after upgrading?
Yes, through other faults with the same symptom, such as a failed merge during the close or the wrong company's account in a multi-company setup (#40866). Keep the post-close check, every POS Invoice in the shift consolidated, as a standing control.
What related issues might you also hit?
- POS Invoices that seem skipped during the close (#41036), and a fix to the merge step (PR #44772).
- Wrong company's account in a multi-company POS close (#40866).
- ERPNext asset scrap triggers depreciation on a closed period — the same closed-period discipline for corrections.
- ERPNext GST return filing — where missing POS revenue shows up as a shortfall.
What is the bottom line?
The fault is fixed in a point release, but the sales it stranded don't come back on their own. Run the orphan report, put a number on what's outside your accounts, upgrade the tills so the shift-order rule is enforced, and reconcile the historical orphans with your accountant. Then make the post-close invoice-count reconciliation routine — it is the control that would have caught this on day one.
Comments & ratings
No comments yet. Start a new discussion.
Manoj · Published on 30 July 2026
Worked with us? Leave a Google review