Shopee FBS Decision Desk
Decision queue
Clear outcome first; every recommendation remains auditable.
| SKU / Product | Store | ADO | Price | FBS class | FBS cost | FBS profit/order | % of cost | Monthly impact | Qty | Score | Recommendation | Approval |
|---|
What this is
This dashboard is only as fresh as the last real import. Cost/price/stock refresh live from Supabase automatically, but sales velocity (ADO), dimensions, and the fragile flag stay frozen at whatever was last imported. Refresh periodically using the steps below — once imported, every browser sees the same real data, not just yours.
04/09/2026 — now covers 4 stores: SBC (Bintang Store), SBH (BabyHoshi), SBSU (Bargain Store Utara), SDC (DeChef / BigSeller nickname "Dapoq.Chef"). FBS stock is one shared pool across all four; each store keeps its own price/ADO and its own SEND/PILOT/DO NOT SEND call.
1. Get the files
| File | Where to get it | Save to |
|---|---|---|
| Inventory List (3 parts, shared — one pull covers all 4 stores) | BigSeller → Inventory Management → Inventory List → Export | FBS/input/ |
| Shelf Stock (3 parts, shared) | BigSeller → Inventory Management → Shelf Stock → Export | FBS/input/shelf_stock/ |
| Online Products (once per store — 4 exports) | BigSeller → Products → Active → Store filter (single-select — one store at a time) → set page size to 300 → select-all → Import & Export → Export Selected, repeat per page if over 300 rows | FBS/input/online_products/<STORE_CODE>/ (SBC / SBH / SBSU / SDC) |
| Sales Report – Export by SKU + Date (one combined export — all 4 stores at once) | BigSeller → Report → Business Analysis → Stores filter (multi-select checkboxes — tick all 4) → Last 30 days → Item Sales Information's download icon → Export by SKU + Date | FBS/input/sales_report/ |
| FBS x Bintang Cekal | Google Sheet (maintained by the Shopee RM, covers all 4 stores) → File → Download → Microsoft Excel (.xlsx). Must be .xlsx, not CSV — the refresh reads four separate tabs (Data, New SOH …, Dashboard, Seller SKUs), and a Google CSV export contains only one sheet. A .csv here is silently ignored by the glob (*FBS x Bintang Cekal*.xlsx) and the run reports the workbook as not supplied. | FBS/input/ |
Filenames just need to start with the same prefix BigSeller generates (e.g. Inventory_List..., Online_products_...) — no manual renaming needed, the refresh script matches by pattern regardless of folder.
Resolved 08/09/2026: the FBS x Bintang Cekal workbook is supplied and wired in. FBS penetration reads 16.98% and 25 SKUs / 97 pooled units now net off the recommended transfer quantity. It changed 84 rows in one field (fbs_stock) and moved no SEND/PILOT decision — fbs_stock only feeds transfer quantity and storage ageing, never the decision gate. The SOH tab is re-dated by the RM every refresh (New SOH 15.06 → New SOH 8/9); the script now resolves it by New SOH prefix and reads the refresh date from Data!B2, so no code edit is needed next time.
Resolved 04/09/2026: the classic "Report → Sales Report" menu now redirects into Business Analysis — same destination, one combined multi-store export replaces what used to be a per-store pull. See LEARN.md for the full export-flow gotchas (single-select vs multi-select store filters, "Export by Page" silently doing nothing, re-screenshotting before clicking a completion modal).
Corrected 08/09/2026 (supersedes an earlier note here that said to download this one as CSV — that instruction produced a file the pipeline discarded without error): it still needs a logged-in BC Chrome session, and the fastest path is to open …/export?format=xlsx on the sheet id, which downloads the whole workbook straight to Downloads in one hop. Save it into FBS/input/ like the other exports.
Resolved 25/08/2026: the Shopee shipping-info ZIP → measurements conversion is now a real script (scripts/build_shopee_measurements.py), tested against a real fresh export. It also works around a real Shopee export bug — the file's worksheet XML writes an invalid bottom_left pane value that crashes a plain-openpyxl read; the script patches it in memory. This step is BC-only (Bintang Store), used for the mass-update measurement/fragile-title proposals, not the SEND/PILOT decision itself.
2. Run the refresh
- Drop the files above into
FBS/input/, one subfolder per store for Online Products (online_products/SBC/,SBH/,SBSU/,SDC/), plusshelf_stock/andsales_report/. - Optional, BC-only: the Shopee shipping-info export (Seller Centre → Products → My Products → Mass Function → Mass Update → Shipping Info → Generate → Download, extract
1.xlsx+2.xlsx), then ask Claude to runpython scripts/build_shopee_measurements.py <folder>— writeswork/shopee_product_measurements.json. Skip this and the pipeline still runs on BigSeller Inventory measurements alone. - Run
python scripts/prepare_bc_fbs_data.py— joins everything intowork/bc_fbs_prepared_data.json, one row per (SKU, store). - Then
python scripts/build_dashboard_import.py— converts it intooutput/FBS_Dashboard_Import.json, the exact shape this dashboard needs. - Review it for any SKUs confirmed deleted/discontinued in BigSeller — no script checks that, it's still a human call.
- Click Import JSON / CSV above and select that file. It becomes the shared live dataset for every viewer automatically — Claude can also push it straight to Supabase directly, without this manual click.
Fulfilment fee reference
What Shopee would charge to fulfil each SKU, by size class — a lookup for deciding what to push into FBS, not a profitability call (see Decision queue for that).
| SKU / Product | Weight | Source | Size class | Flat fee/order | Tiered fee/unit |
|---|