# Sales Report Empty After Checkout (Realtime Fix)

## Gejala

- transaksi terlihat berhasil dari sisi kasir (sudah klik Save/print)
- tetapi halaman `Report Invoice & Return Sale` tetap kosong

## Analisa

Agar report realtime, data wajib:

1. **tersimpan saat checkout** (commit ke tabel sales + sales_items)
2. **muncul di endpoint report** (`GET /api/v1/reports/sales`) dengan filter tanggal yang sama

Jika salah satu tidak jalan, report akan kosong.

## Endpoint yang Harus Dipastikan

## 1) Checkout

`POST /api/v1/pos/checkout`

Wajib:

- insert header transaksi (bill_no, cashier, payment_method, paid_amount, totals)
- insert detail item
- response minimal berisi:
  - `sale_id`
  - `bill_no`
  - `created_at`
  - `subtotal`
  - `discount`
  - `total` / `grand_total`
  - `cash`, `card`, `qris` (sesuai method)

## 2) Sales Report

`GET /api/v1/reports/sales?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&type=all&page=1&limit=10`

Wajib:

- return transaksi terbaru yang baru di-checkout
- filter tanggal harus sesuai timezone operasional (disarankan `Asia/Jakarta`)
- kolom map ke FE:
  - `sale_id`, `bill_no`, `created_at`, `cashier_name`
  - `quantity`, `subtotal`, `discount`, `cashback`, `total`
  - `cash`, `card`, `return_sale`

## Checklist Verifikasi BE

1. lakukan checkout 1 transaksi
2. cek DB: record sales dan sales_items benar-benar masuk
3. hit endpoint report pada rentang tanggal transaksi
4. pastikan transaksi yang sama muncul di `items`
5. pastikan summary (`total_receipt`, `quantity`, `total`) ikut berubah

## Kemungkinan Akar Masalah

- checkout endpoint return sukses tapi tidak commit transaksi
- report query baca tabel/schema berbeda
- mismatch timezone pada filter `start_date/end_date`
- report endpoint belum include data pembayaran per method

## Catatan Sinkronisasi FE

FE sudah diset **strict realtime**:

- jika checkout gagal, FE tampilkan error dan transaksi tidak dianggap sukses
- report page membaca data dari API report BE

Jadi jika report tetap kosong, blocker utama ada di implementasi BE/report query.