What problem does it solve?
The Google Sheets Hybrid System bridges operations between Google Sheets (used by the ops team) and the ERP database. It handles three core flows: Move Shipped → Outward, Ingest Buffer Tabs, Write Balances Back. The system is designed so that ingestion never changes the displayed balance due to the combined view formula.
Core Features & Use Cases
- Ingest Inward (Live): Reads Inward (Live) and creates ERP InventoryTransaction records, then updates balances and deletes ingested rows.
- Move Shipped → Outward: Copies shipped rows from the Orders from COH tab to Outward (Live) for ERP ingestion.
- Ingest Outward & Balance Sync: Reads Outward (Live), creates OUTWARD transactions, links to OrderLines, and updates both Inventory and Balance Final sheets.
- Use Case: Ops teams maintain inventory buffers across Sheets and ERP with a single source of truth, enabling automatic reconciliation and reduced manual data handling.
Quick Start
Enable the Sheet Offload feature, configure your Mastersheet IDs and tab mappings in server/config/sync/sheets.ts, and start the offload scheduler. Then monitor the OffloadMonitor UI for status and buffer counts.