title: “POS Reports” description: “Pusat laporan POS — 10 jenis laporan (per_item, per_category, per_brand, per_customer, per_cashier, per_location, per_payment, per_hour, daily_summary, profit_analysis) dengan export Excel/PDF.”

POS Reports

POS Reports (POSReports.jsx — 2.061 baris) adalah pusat analitik dan pelaporan untuk seluruh aktivitas POS. Komponen ini menghasilkan 10 jenis laporan berbeda yang mencakup setiap dimensi bisnis — dari per-item hingga profit analysis — dengan filter multi-dimensional, grafik interaktif, dan export ke Excel/PDF/CSV. Semua data diambil dari CompanyPOSTransaction yang sudah terintegrasi dengan inventory, finance, dan CRM, sehingga laporan POS bukan hanya angka penjualan mentah melainkan sudah mencakup HPP, margin, dan kontribusi pelanggan.

Arsitektur Laporan

10 Jenis Laporan

#	Report Type	Group By	Metrik Utama	Use Case
1	per_item	Product SKU	qty_sold, revenue, avg_price	Produk terlaris
2	per_category	Category	total_revenue, transaction_count	Kategori paling profitable
3	per_brand	Brand	revenue, market_share %	Analisis brand performance
4	per_customer	Customer/Members	total_spent, visit_count, avg_order	Top customers & loyalty
5	per_cashier	Kasir/User	transactions, revenue, avg_order	Performance per kasir
6	per_location	Location/Outlet	revenue, transactions, top_product	Perbandingan outlet
7	per_payment	Payment Method	count, total, percentage	Distribusi metode bayar
8	per_hour	Hour of Day	transactions, revenue	Peak hours analysis
9	daily_summary	Date	revenue, transactions, avg_order, refund	Tren harian
10	profit_analysis	Product/Category	revenue, COGS, gross_margin %	Profitability deep-dive

Komponen Laporan

1. Ringkasan Penjualan

Metrik	Deskripsi	Sumber Data
Total Omzet	Total pendapatan dalam periode	`SUM(transaction.total_amount)`
Jumlah Transaksi	Total transaksi yang terjadi	`COUNT(transaction.id)`
Average Order Value	Rata-rata nilai per transaksi	`AVG(transaction.total_amount)`
Refund	Total refund yang diproses	`SUM(voided_transaction.total_amount)`
Net Revenue	Omzet - Refund	Calculated
Gross Margin	Revenue - HPP	`SUM(item.price - item.unit_cost)`

2. Grafik Tren

Grafik	Tipe	Deskripsi	Library
Penjualan Harian	Line chart	Tren revenue per hari	Recharts `<LineChart>`
Penjualan per Jam	Bar chart	Distribusi transaksi per jam	Recharts `<BarChart>`
Per Channel	Pie chart	Proporsi penjualan per channel	Recharts `<PieChart>`
Per Metode Pembayaran	Donut chart	Distribusi metode pembayaran	Recharts `<PieChart>`
Top 10 Products	Horizontal bar	Produk dengan revenue tertinggi	Recharts `<BarChart>`
Profit Margin Trend	Area chart	Margin % per hari	Recharts `<AreaChart>`

3. Top Products

Rank	Informasi	Metrik
Produk	Nama produk + SKU	—
Qty Terjual	Jumlah unit terjual	`SUM(item.quantity)`
Revenue	Total pendapatan dari produk	`SUM(item.subtotal)`
COGS	Harga pokok (dari snapshot)	`SUM(item.unit_cost × item.quantity)`
Margin	Revenue - COGS	Calculated
Persentase	Kontribusi terhadap total revenue	`revenue / total_revenue × 100`

4. Shift Report

Metrik	Deskripsi	Sumber
Kasir	Nama kasir yang bertugas	`transaction.cashier_id`
Shift	Waktu mulai dan selesai shift	`transaction.created_at` grouping
Transaksi	Jumlah transaksi yang diproses	`COUNT(*)`
Total Penjualan	Total omzet shift	`SUM(total_amount)`
Cash	Total pembayaran tunai	`WHERE payment_method = 'cash'`
Non-Cash	Total pembayaran non-tunai	`WHERE payment_method != 'cash'`
Expected Cash	Uang yang seharusnya ada di laci	`opening_balance + cash_sales`
Variance	Selisih expected vs actual	`actual_cash - expected_cash`

5. Profit Analysis

Metrik Profit	Formula	Insight
Gross Profit	`SUM(price - unit_cost) × qty`	Profit sebelum overhead
Gross Margin %	`gross_profit / revenue × 100`	Efisiensi pricing
COGS Ratio	`total_cogs / revenue × 100`	Proporsi HPP terhadap revenue
Revenue per Item	`total_revenue / total_items`	Rata-rata revenue per item
Profit per Transaction	`gross_profit / transaction_count`	Rata-rata profit per transaksi

6. Rekap Metode Pembayaran

Metode	Count	Total	Persentase
Cash	XX	Rp XXX	XX%
QRIS	XX	Rp XXX	XX%
Transfer	XX	Rp XXX	XX%
Debit	XX	Rp XXX	XX%
E-Wallet	XX	Rp XXX	XX%
Split Payment	XX	Rp XXX	XX%

Filter Laporan

Filter	Opsi	Deskripsi
Outlet	Semua outlet, atau pilih outlet spesifik	Filter per lokasi
Periode	Hari ini, Kemarin, Minggu ini, Bulan ini, Custom	Date range picker
Kasir	Semua kasir, atau pilih kasir spesifik	Filter per user
Channel	Semua channel, atau pilih channel spesifik	8 channel tersedia
Kategori	Semua kategori produk	Filter per kategori
Brand	Semua brand	Filter per brand
Payment Method	Semua metode, atau pilih metode spesifik	Filter per payment

Export

Format	Kegunaan	Library
Excel (.xlsx)	Analisis lebih lanjut dengan pivot table	SheetJS / xlsx
PDF	Presentasi ke manajemen, arsip	jsPDF / html2canvas
CSV	Import ke sistem akuntansi	Native CSV generator

Cara Akses

Metode	Detail
URL	`/pos/pos-reports`
Sidebar	Menu POS → Reports

Flow Penggunaan

COGS & Profit Tracking

Laporan profit menggunakan unit_cost snapshot dari CompanyPOSTransaction.items[] — bukan harga beli terkini. Ini memastikan margin yang dihitung mencerminkan HPP pada saat transaksi terjadi, bukan HPP saat laporan dibuat.

Aspek	Implementasi
Snapshot Timing	Saat transaksi di-finalize
Source	`CompanyPOSInventory.avg_cost` (FIFO weighted)
Storage	`transaction_item.unit_cost`
Accuracy	Mencerminkan HPP aktual saat penjualan
Finance Sync	HPP total → transfer ke reserve fund via jurnal GL

Tips

Gunakan shift report setiap akhir shift untuk mencocokkan uang tunai di laci kasir dengan total penjualan yang tercatat
Laporan profit analysis adalah yang paling penting untuk keputusan pricing — identifikasi produk dengan margin < 30% dan pertimbangkan penyesuaian harga
Export ke Excel untuk analisis mendalam dengan pivot table dan chart kustom
Bandingkan performa antar kasir menggunakan shift report untuk mengidentifikasi training needs
Monitor peak hours dari laporan per_hour untuk mengatur jadwal shift yang optimal
Review laporan per_customer bersama tim CRM untuk mengidentifikasi pelanggan yang perlu di-reengage

Entity Relationship Diagram — Report Entities

Tabel Schema — Entitas Laporan

CompanyPOSTransaction — Field untuk Reporting

Field	Tipe	Deskripsi	Digunakan di Laporan
`company_id`	`string`	ID perusahaan (multi-tenant)	Filter multi-outlet
`location_id`	`string`	ID lokasi toko/gudang	Report: per_location
`location_name`	`string`	Nama lokasi (denormalized)	Display label
`transaction_number`	`string`	Nomor transaksi unik (UK)	Referensi silang
`invoice_number`	`string`	Nomor invoice cetak	Receipt & PDF export
`transaction_date`	`date-time`	Tanggal & waktu transaksi	Filter periode, grouping harian/jam
`items`	`array<object>`	Daftar item yang dibeli	Report: per_item, per_category, per_brand, profit_analysis
`items[].product_id`	`string`	ID produk	Join ke master produk
`items[].product_name`	`string`	Nama produk (snapshot)	Display & grouping
`items[].sku`	`string`	Stock Keeping Unit	Identifikasi produk
`items[].quantity`	`number`	Jumlah unit dibeli	Agregasi qty terjual
`items[].price`	`number`	Harga jual satuan	Kalkulasi revenue
`items[].discount`	`number`	Diskon per-baris	Kalkulasi net revenue
`items[].subtotal`	`number`	Subtotal per-baris	Revenue per item
`items[].unit_cost`	`number`	HPP snapshot saat transaksi	COGS & profit analysis
`items[].total_cost`	`number`	Total HPP baris (`unit_cost × qty`)	COGS agregat
`subtotal`	`number`	Subtotal sebelum diskon & pajak	Ringkasan omzet
`discount_amount`	`number`	Total diskon (nominal)	Kalkulasi net revenue
`discount_percentage`	`number`	Persentase diskon	Kalkulasi diskon
`tax_amount`	`number`	PPN transaksi	Laporan pajak
`total` / `total_amount`	`number`	Total akhir transaksi	Metrik utama semua laporan
`payment_method`	`enum`	Metode pembayaran (cash, card, transfer, ewallet, qris, dll.)	Report: per_payment
`payment_status`	`enum`	Status pembayaran (pending, paid, refunded, dll.)	Filter transaksi valid
`payments`	`array<object>`	Detail split payment (multi-tender)	Report: per_payment (detail)
`customer_id`	`string`	ID member pelanggan	Report: per_customer
`customer_name`	`string`	Nama pelanggan	Display label
`cashier_id`	`string`	ID kasir yang melayani	Report: per_cashier
`cashier_name`	`string`	Nama kasir (denormalized)	Display label
`source`	`enum`	Sumber transaksi (pos, online_catalog, marketplace, dll.)	Report: per_channel
`sales_channel`	`enum`	Channel penjualan ternormalisasi	Report: per_channel (canonical)
`status`	`enum`	Status transaksi (completed, refunded, cancelled, dll.)	Filter validitas
`points_earned`	`number`	Poin loyalitas didapat	Integrasi CRM report
`points_used`	`number`	Poin loyalitas dipakai	Integrasi CRM report

FinancialReportSnapshot — Schema Lengkap

Field	Tipe	Wajib	Deskripsi
`company_id`	`string`	Ya	ID perusahaan pemilik laporan
`report_type`	`enum`	Ya	Jenis laporan: `profit_loss`, `balance_sheet`, `cash_flow`, `budget_vs_actual`, `trial_balance`, `custom`
`report_name`	`string`	Ya	Nama laporan yang di-generate
`start_date`	`date`	Ya	Tanggal awal periode laporan
`end_date`	`date`	Ya	Tanggal akhir periode laporan
`generated_by_user_id`	`string`	Ya	ID user yang men-generate laporan
`generated_date`	`date-time`	Ya	Timestamp waktu laporan dibuat
`report_data`	`object`	Ya	JSON berisi data hasil agregasi laporan
`template_id`	`string`	Tidak	ID ReportTemplate yang digunakan (jika ada)
`notes`	`string`	Tidak	Catatan tambahan pada snapshot

FinancialRecord — Schema Lengkap

Field	Tipe	Wajib	Deskripsi
`user_id`	`string`	Ya	ID pengguna yang mencatat
`company_id`	`string`	Tidak	ID perusahaan (null untuk personal)
`account_id`	`string`	Tidak	ID rekening/kantong sumber dana
`type`	`enum`	Ya	Jenis: `income`, `expense`, `transfer`
`amount`	`number`	Ya	Nominal transaksi
`category`	`string`	Tidak	Kategori transaksi
`description`	`string`	Tidak	Deskripsi singkat
`date`	`date-time`	Ya	Tanggal transaksi
`attachment_url`	`string`	Tidak	URL bukti transaksi
`source`	`enum`	Tidak	Sumber: `manual`, `ai_text`, `ai_scan`, `pos`, `manufacturing`, `distribution`, `recall`, `stock_opname`
`mode`	`enum`	Tidak	Mode: `personal` atau `business`
`reference_id`	`string`	Tidak	ID referensi ke entitas sumber (invoice, POS transaction, expense)
`reference_type`	`enum`	Tidak	Tipe referensi: `pos_transaction`, `invoice_payment`, `expense`, `transfer`, dll.
`cogs_amount`	`number`	Tidak	HPP/COGS yang dibekukan saat transaksi POS — digunakan P&L untuk laba kotor
`tax_amount`	`number`	Tidak	Pajak (PPN keluaran) yang termasuk dalam amount
`channel_fee`	`number`	Tidak	Potongan biaya marketplace/platform
`idempotency_key`	`string`	Tidak	Kunci idempoten untuk mencegah duplikasi

Account — Schema Lengkap

Field	Tipe	Wajib	Deskripsi
`user_id`	`string`	Ya	ID pemilik rekening
`company_id`	`string`	Tidak	ID perusahaan (null untuk personal)
`name`	`string`	Ya	Nama rekening (mis: Kas, BCA, Mandiri, Dompet)
`type`	`enum`	Ya	Jenis: `cash`, `bank`, `e-wallet`, `other`
`account_number`	`string`	Tidak	Nomor rekening
`bank_name`	`string`	Tidak	Nama bank (untuk type=bank)
`initial_balance`	`number`	Tidak	Saldo awal (default: 0)
`current_balance`	`number`	Tidak	Saldo terkini (dikelola server; diupdate oleh POS sales, invoice payment, expense, void)
`currency`	`string`	Tidak	Mata uang (default: IDR)
`is_active`	`boolean`	Tidak	Status aktif rekening (default: true)
`is_default_pos`	`boolean`	Tidak	Rekening default untuk kasir POS (default: false)
`mode`	`enum`	Tidak	Mode: `personal` atau `business`

State Machine — Siklus Hidup Pembuatan Laporan

Sequence Diagram — Pembuatan Laporan Harian

Sequence Diagram — Shift Closeout (Tutup Kasir)

Sequence Diagram — Agregasi Penjualan ke Laporan Keuangan

Enum Tables — Nilai yang Diizinkan

`report_type` (FinancialReportSnapshot)

Nilai	Deskripsi
`profit_loss`	Laporan laba rugi — revenue, COGS, gross profit, net income
`balance_sheet`	Neraca keuangan — aset, liabilitas, ekuitas
`cash_flow`	Arus kas — masuk, keluar, saldo
`budget_vs_actual`	Perbandingan anggaran vs realisasi
`trial_balance`	Neraca saldo — daftar semua akun dan saldonya
`custom`	Laporan kustom (shift report, laporan khusus, dll.)

`period_type` (ReportTemplate.date_range)

Nilai	Deskripsi
`custom`	Rentang tanggal kustom (start_date — end_date)
`last_7_days`	7 hari terakhir dari hari ini
`last_30_days`	30 hari terakhir dari hari ini
`this_month`	Bulan berjalan (tanggal 1 s/d akhir bulan)
`this_quarter`	Kuartal berjalan
`this_year`	Tahun berjalan (1 Januari s/d 31 Desember)

`sales_channel` (CompanyPOSTransaction)

Nilai	Deskripsi	Digunakan di Laporan
`offline_pos`	Transaksi langsung di kasir (default POS)	per_location, daily_summary
`offline`	Penjualan offline non-POS	per_location
`website`	Pesanan via website perusahaan	per_channel
`online_catalog`	Katalog online (digital lookbook)	per_channel
`marketplace`	Tokopedia, Shopee, TikTok Shop, dll.	per_channel
`landing_page`	Pesanan via landing page	per_channel
`whatsapp`	Pesanan via WhatsApp Business	per_channel
`reseller`	Pesanan via reseller/dropshipper	per_channel
`b2b`	Penjualan bisnis-ke-bisnis	per_channel
`grab`	Pesanan via GrabFood/GrabMart	per_channel
`social_media`	Pesanan via Instagram, Facebook, dll.	per_channel

`payment_method` (CompanyPOSTransaction)

Nilai	Deskripsi
`cash`	Pembayaran tunai di kasir
`card`	Kartu kredit/debit
`transfer`	Transfer bank manual
`ewallet`	GoPay, OVO, DANA, ShopeePay, dll.
`qris`	Pembayaran via QRIS
`saldo`	Bayar pakai saldo member/loyalty
`mayar`	via Mayar payment gateway
`debt`	Hutang / tempo
`manual_transfer`	Transfer manual (dengan verifikasi)
`midtrans`	via Midtrans payment gateway
`tripay`	via Tripay payment gateway
`stripe`	via Stripe payment gateway
`paypal`	via PayPal

`payment_status` (CompanyPOSTransaction)

Nilai	Deskripsi
`pending`	Menunggu pembayaran
`pending_verification`	Pembayaran dikirim, menunggu verifikasi
`partially_paid`	Baru dibayar sebagian (split payment)
`paid`	Lunas / terbayar penuh
`failed`	Pembayaran gagal
`refunded`	Dana dikembalikan ke pelanggan
`rejected`	Pembayaran ditolak

`type` (FinancialRecord)

Nilai	Deskripsi
`income`	Pemasukan (penjualan POS, invoice, dll.)
`expense`	Pengeluaran (operasional, bahan baku, dll.)
`transfer`	Transfer antar rekening/kantong

`source` (FinancialRecord)

Nilai	Deskripsi
`manual`	Dicatat manual oleh user
`ai_text`	Dicatat via AI text input
`ai_scan`	Dicatat via AI scan struk
`pos`	Otomatis dari transaksi POS
`manufacturing`	Dari modul manufaktur/produksi
`distribution`	Dari modul distribusi
`recall`	Dari proses recall produk
`stock_opname`	Dari stock opname

`reference_type` (FinancialRecord)

Nilai	Deskripsi
`pos_transaction`	Referensi ke CompanyPOSTransaction
`invoice_payment`	Referensi ke Invoice
`expense`	Referensi ke Expense
`manual`	Tidak ada referensi otomatis
`transfer`	Referensi ke transfer antar akun
`production_order`	Referensi ke production order
`distribution_shipment`	Referensi ke pengiriman distribusi
`distribution_return`	Referensi ke retur distribusi
`batch_recall`	Referensi ke batch recall
`stock_opname`	Referensi ke stock opname

`type` (Account)

Nilai	Deskripsi
`cash`	Kas / uang tunai
`bank`	Rekening bank (BCA, Mandiri, BNI, dll.)
`e-wallet`	Dompet digital (GoPay, OVO, DANA)
`other`	Lainnya (piutang, kantong virtual, dll.)

RBAC — Hak Akses Laporan POS

Role	Lihat Laporan	Export Laporan	Generate Snapshot	Hapus Snapshot	Kelola Template
Super Admin	✅	✅	✅	✅	✅
Admin	✅	✅	✅	✅	✅
Manager / Owner	✅	✅	✅	❌	✅
Supervisor	✅	✅	✅	❌	❌
Kasir	✅ (shift sendiri)	✅ (shift sendiri)	❌	❌	❌
Staff / Viewer	✅ (read-only)	❌	❌	❌	❌

Aturan RLS (Row-Level Security)

Operasi	Kondisi
Create	`company_id` = `user.active_company_id` DAN `company_id` tidak null/empty, ATAU `created_by_id` = `user.id`, ATAU `user.role` = `admin`
Read	`company_id` = `user.active_company_id` DAN `company_id` tidak null/empty, ATAU `created_by_id` = `user.id`, ATAU `user.role` = `admin`
Update	`company_id` = `user.active_company_id` DAN `company_id` tidak null/empty, ATAU `created_by_id` = `user.id`, ATAU `user.role` = `admin`
Delete	`company_id` = `user.active_company_id` DAN `company_id` tidak null/empty, ATAU `created_by_id` = `user.id`, ATAU `user.role` = `admin`

Catatan: RLS berlaku identik untuk keempat operasi (CRUD) pada entitas CompanyPOSTransaction, FinancialRecord, dan Account. Entitas FinancialReportSnapshot dan ReportTemplate menggunakan RLS kosong (default: semua role terautentikasi memiliki akses penuh dalam scope company).

​title: “POS Reports” description: “Pusat laporan POS — 10 jenis laporan (per_item, per_category, per_brand, per_customer, per_cashier, per_location, per_payment, per_hour, daily_summary, profit_analysis) dengan export Excel/PDF.”

​POS Reports

​Arsitektur Laporan

​10 Jenis Laporan

​Komponen Laporan

​1. Ringkasan Penjualan

​2. Grafik Tren

​3. Top Products

​4. Shift Report

​5. Profit Analysis

​6. Rekap Metode Pembayaran

​Filter Laporan

​Export

​Cara Akses

​Flow Penggunaan

​COGS & Profit Tracking

​Tips

​Entity Relationship Diagram — Report Entities

​Tabel Schema — Entitas Laporan

​CompanyPOSTransaction — Field untuk Reporting

​FinancialReportSnapshot — Schema Lengkap

​FinancialRecord — Schema Lengkap

​Account — Schema Lengkap

​State Machine — Siklus Hidup Pembuatan Laporan

​Sequence Diagram — Pembuatan Laporan Harian

​Sequence Diagram — Shift Closeout (Tutup Kasir)

​Sequence Diagram — Agregasi Penjualan ke Laporan Keuangan

​Enum Tables — Nilai yang Diizinkan

​report_type (FinancialReportSnapshot)

​period_type (ReportTemplate.date_range)

​sales_channel (CompanyPOSTransaction)

​payment_method (CompanyPOSTransaction)

​payment_status (CompanyPOSTransaction)

​type (FinancialRecord)

​source (FinancialRecord)

​reference_type (FinancialRecord)

​type (Account)

​RBAC — Hak Akses Laporan POS

​Aturan RLS (Row-Level Security)