From 5997c42bf56efef4d8fcf2be4db7676795b2d0de Mon Sep 17 00:00:00 2001 From: Bryce Date: Sat, 15 Aug 2026 13:10:58 -0700 Subject: [PATCH] docs(sales-summaries): show line-level before and after for each repair MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The report asserted that the fixes work; it did not show what changed on the page. Replaces the worked-examples section with actual summary lines pulled from the restore, before and after, including debit and credit totals. NGLK 2026-08-04 is the clearest case. The day already carried a $60.00 card refund — the guest was given their money back, tip included — while the Tip line still credited $482.94, because the reversal sits on an order with no tender and get-tip only reached tips through tenders. Corrected to $422.94, matching the refund to the cent, and the day closes from -60.00 to 0.00. NTPT 2026-08-06 shows the other shape: $427.10 of service charge arrived inside a $4,975.89 card tender, so it landed on the debit side with nothing crediting it. Credits go 7,350.10 to 7,777.20 against unchanged debits of 7,777.20. Adds the six largest repairs of each kind with their real Tip and Service Charges figures, and NGNP 2026-06-25 where both fixes land on one day and pull in opposite directions — 301.40 credited, 1.80 removed, 299.60 closed — which is a useful check that the two are independent. Co-Authored-By: Claude Opus 5 --- .../2026-08-15-thirty-day-reconciliation.html | 100 +++++++++++++++--- 1 file changed, 83 insertions(+), 17 deletions(-) diff --git a/docs/2026-08-15-thirty-day-reconciliation.html b/docs/2026-08-15-thirty-day-reconciliation.html index b7e3dba0..29821e9a 100644 --- a/docs/2026-08-15-thirty-day-reconciliation.html +++ b/docs/2026-08-15-thirty-day-reconciliation.html @@ -229,42 +229,108 @@
-

Worked examples

+

What actually changed on the page

-

Each fix is easiest to check on a single order. In both cases the day's imbalance equals the fix amount exactly, which is what you would expect if the fix books something real that was previously booked nowhere.

+

Both fixes add a single credit line. Nothing else in a summary moves — no sales figure, no + tender, no tax. That is why they can only ever help a day that was already short, and it is + visible in the line items.

-

R1 — a tip reversal with no tender to hang it on

+

R1 — NGLK, 2026-08-04

- + - - - - - + + + + + +
FieldValue
LineBeforeAfterChange
Ordersquare/order/NGLK-SM-OxSX9gpXJV394qqT8mnBGypUwKNZY
:sales-order/tip−60.00
:sales-order/total−60.00
:sales-order/charges0 — no tender at all
NGLK 2026-08-04 imbalance−60.00 → 0.00
Tip (credit)482.94422.94−60.00
Card Refunds (credit)60.0060.00—
every other lineunchanged—
Total debits10,094.8110,094.81—
Total credits10,154.8110,094.81−60.00
Imbalance−60.000.00balanced
-

A guest's tip was handed back. The reversal is recorded on the order, but get-tip reaches tips by joining through :sales-order/charges, and a return-only order has no charge to join through — so the −$60.00 was invisible and the day credited a tip that no longer existed.

+

Read the two credit lines together and the story is complete: the day already carried a + $60.00 card refund — the guest was given their money back, tip included — but the + tip was still credited in full at $482.94, because the reversal lives on an order with no tender + and get-tip only reached tips through tenders. The books claimed $60 of tip income + that had been handed back. The corrected figure, $422.94, matches the refund exactly.

-

R2 — a service charge collected but credited nowhere

+

R2 — NTPT, 2026-08-06

- + - - - - + + + + + +
FieldValue
LineBeforeAfterChange
Ordersquare/order/NTPT-PT-KrMZzcon1cpQEJUyetErkBIpcdEZY
:sales-order/service-charge427.10
:sales-order/total3,198.78
NTPT 2026-08-06 imbalance+427.10 → 0.00
Service Charges (credit)absent427.10+427.10
Card Payments (debit)4,975.894,975.89—
every other lineunchanged—
Total debits7,777.207,777.20—
Total credits7,350.107,777.20+427.10
Imbalance+427.100.00balanced
-

The $427.10 sits inside the card tender the customer paid, so it lands on the debit side — but nothing credited it, leaving the day short by exactly that amount. R2 is the larger of the two fixes by an order of magnitude: $54,775.79 moved against R1's $3,623.44.

+

The customer paid $427.10 of service charge as part of a $4,975.89 card tender, so the money + arrived on the debit side. No line credited it, so the day showed $427.10 more collected than + earned. Adding the credit closes it exactly, and the single order responsible is + square/order/NTPT-PT-KrMZzcon1cpQEJUyetErkBIpcdEZY, carrying a + :sales-order/service-charge of 427.10 on a 3,198.78 order.

+
+ +

The largest tip repairs

+
+ + + + + + + + + + +
ClientDateTip beforeTip afterImbalance beforeAfter
NGFL2026-05-19238.4670.42−168.040.00
NGMI2026-07-09230.0180.01−150.000.00
NGVA2026-07-03152.6640.12−112.540.00
NGLK2026-08-04482.94422.94−60.000.00
NGPA2026-06-15383.70331.19−52.510.00
NGLK2026-06-09518.88467.69−51.190.00
+
+
+

Every one overstated tip income, and in every case the correction equals the imbalance to the + cent. NGFL was crediting $238.46 of tips on a day where $168.04 had been given back.

+
+ +

The largest service-charge repairs

+
+ + + + + + + + + +
ClientDateService charges beforeAfterImbalance beforeAfter
NGPA2026-06-04absent1,344.86+1,344.860.00
NTPT2026-08-06absent427.10+427.100.00
N-300032026-05-27absent405.83+405.830.00
NGPA2026-07-02absent348.45+348.450.00
NGA12026-06-04absent296.35+296.350.00
+
+
+

NGPA 2026-06-04 is the single largest repair in the ninety days: $1,344.86 of service charges + collected from customers and credited to no revenue account at all.

+
+ +

Where both fixes land on one day

+
+ + + + + + + +
NGNP, 2026-06-25BeforeAfterChange
Tip (credit)93.9092.10−1.80
Service Charges (credit)absent301.40+301.40
Imbalance+299.600.00301.40 − 1.80
+
+
+

The two corrections pull in opposite directions and still land on zero, which is a useful + check that they are independent and neither is compensating for the other.