Bookrecon

Command

python3 scripts/bookrecon.py \
  --company-dir companies/example \
  --period 2024-01

For local review against scratch normalization output, pass the normalized file explicitly:

python3 scripts/bookrecon.py \
  --period 2023-01 \
  --normalized /tmp/bookprep-2023-01.json \
  --output /tmp/bookrecon-2023-01.json

Current Checks

Implemented deterministic checks:

• Woo sales totals vs processor gross sales
• processor payouts vs bank receipts
• processor settlement bridge across sales, refunds, fees, and payouts
• fulfillment expense totals vs bank debits when partner signals are present
• inventory quantity evidence when quantity-bearing records exist
• continuity with the previous period

Guardrails

• Import blocking bookprep exceptions directly into recon output.
• Block the month when bank receipts indicate processor activity but no processor-side export was normalized.
• Keep same-month settlement checks conservative because payout timing can cross month boundaries.
• Do not promote a month to bookbuilder when deterministic checks fail.

References

• Read references/bookrecon.md for the concrete check semantics and current limits.