# SALES_REPORT_EXPORT_EXCEL_REQUIRED

## Context

FE menambahkan fitur **Export Excel** pada Sales Report dengan format kolom:

- ITEM CODE
- BARCODE
- DESCRIPTION
- BRAND
- GENDER
- FUNCTION
- SIZE
- COLLECTION
- SELL PRICE
- QTY STOCK
- VALUE STOCK
- HARGA PROMO
- QTY SALE
- TOTAL SALES

Saat ini sebagian kolom masih bisa kosong jika API belum mengirim data master item + rekap penjualan per item.

## Required Backend Support

Sediakan endpoint khusus export rekap item terjual per periode.

### Endpoint suggestion

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

### Query params

- `start_date` (`YYYY-MM-DD`)
- `end_date` (`YYYY-MM-DD`)
- `search` (optional)
- `format` (optional: `json` / `xlsx`)

## Required Payload (JSON mode)

```json
{
  "items": [
    {
      "item_code": "BDPUC070010",
      "barcode": "9312299001004",
      "description": "ALEXANDER IRISH",
      "brand": "PALM LAGOON",
      "gender": "UNISEX",
      "function": "BANDANA",
      "size": "ALL SIZE",
      "collection": "2019 Q1",
      "sell_price": 50000,
      "qty_stock": 10,
      "value_stock": 500000,
      "harga_promo": 50000,
      "qty_sale": 1,
      "total_sales": 50000
    }
  ]
}
```

## Business Rule Clarification

- `qty_sale`: total unit terjual per item pada periode filter.
- `total_sales`: nilai penjualan item pada periode filter.
  - default rekomendasi: **gross** (`sum(qty * sell_price)`), atau
  - jika bisnis mau net, kirim field tambahan mis. `total_sales_net`.
- Jika tidak ada penjualan, kembalikan `0` bukan `null`.

## Acceptance Criteria

1. FE Export Excel menghasilkan data per item sesuai periode filter.
2. Kolom `QTY SALE` dan `TOTAL SALES` sesuai rekap transaksi.
3. Data master (item code/barcode/brand/dll) terisi konsisten.