# SALES_REPORT_MULTI_ITEM_BREAKDOWN_REQUIRED

## Issue

User melakukan transaksi dengan beberapa item berbeda, namun di Sales Report FE kolom Item dan hasil Export Excel belum selalu menampilkan breakdown item lengkap.

Saat ini FE sudah menambahkan fallback dengan memanggil endpoint receipt per transaksi, tetapi ini hanya solusi sementara dan tidak efisien untuk data periode besar.

## Required Backend Update

## 1) Report list perlu kirim item breakdown per transaksi

Endpoint:

- `GET /api/v1/reports/sales`

Setiap row transaksi minimal perlu:

```json
{
  "sale_id": "uuid",
  "bill_no": "BJ...",
  "quantity": 3,
  "total": 1048000,
  "items": [
    {
      "product_id": 101,
      "item_code": "SDRWC020003",
      "barcode": "92111069019504",
      "name": "SAPPHIRE TROPICAL",
      "qty": 1,
      "unit_price": 349000,
      "subtotal": 349000
    }
  ]
}
```

Jika payload ingin lebih ringan, minimal kirim:
- `item_names` (string ringkas multi item), dan
- endpoint agregasi export item terjual (poin 2).

## 2) Endpoint export item terjual per periode (recommended)

- `GET /api/v1/reports/sales/export-items`

Tujuan:
- mengembalikan rekap per item (`qty_sale`, `total_sales`) sesuai filter tanggal/type/search,
- tidak perlu FE memanggil receipt satu per satu.

## 3) Konsistensi data

- `quantity` transaksi harus sama dengan `sum(items.qty)`.
- `total_sales` per item harus sesuai data transaksi dalam periode filter.
- `barcode` dan `item_code` dikirim sebagai string.

## Acceptance Criteria

1. Transaksi multi-item terlihat benar di kolom item Sales Report.
2. Export Excel periode besar menampilkan semua item terjual, bukan hanya item tunggal.
3. Tidak perlu fallback massal ke endpoint receipt untuk mendapatkan item detail.