Login dengan username/email dan password. Mengembalikan access token. Throttle: 5 attempt/menit per identifier, 60 request/menit per IP.

{
  "success": true,
  "message": "Login successful.",
  "data": {
    "user": {
      "id":         "uuid",
      "name":       "string",
      "username":   "string|null",
      "initials":   "string|null",
      "email":      "string",
      "role":       1,
      "role_label": "Cashier",
      "phone":      "string|null",
      "is_active":  true
    },
    "token":         "1|accessToken...",
    "refresh_token": "2|refreshToken..." // hanya jika remember_me
  }
}

Merotasi pasangan token. Kirim refresh_token sebagai Bearer. Menghapus semua token sesi lama dan menerbitkan pasangan baru.

{
  "success": true,
  "data": {
    "token":         "new_access_token",
    "refresh_token": "new_refresh_token"
  }
}

Mencabut semua token aktif milik user yang sedang login.

{ "success": true, "message": "Logout successful." }

Mengambil data user yang sedang login.

{
  "id": "uuid", "name": "string", "username": "string",
  "initials": "string", "email": "string",
  "role": 1, "role_label": "Cashier",
  "phone": "string|null", "is_active": true
}

Update profil user yang sedang login.

Ganti password. Setelah berhasil, semua token dicabut — user harus login ulang.

Daftar penjualan dengan filter dan ringkasan statistik (hari ini / minggu ini / bulan ini).

{
  "items": [ /* Sale objects */ ],
  "summary": {
    "today_revenue":  0, "today_orders":  0,
    "week_revenue":   0, "week_orders":   0,
    "month_revenue":  0, "month_orders":  0
  }
}

Catat transaksi penjualan baru. Harga diambil otomatis dari selling_price produk. Stok dipotong otomatis untuk status non-cancelled.

payment_method: cash | qris | transfer
status:         paid | pending | cancelled

{
  "success": false,
  "message": "Insufficient stock...",
  "errors": {
    "stock": [
      { "product": "Kue Coklat",
        "available": 2,
        "requested": 5 }
    ]
  }
}

Detail satu transaksi. Menggunakan route model binding (id = UUID). Memuat relasi items.product.category dan user.

Update metadata atau status penjualan. Transisi status secara otomatis mengelola stok dan Cash Book.

Hapus transaksi. Stok dikembalikan (jika bukan cancelled). Entri Cash Book dihapus (jika paid).

Daftar pre-order diurutkan berdasarkan tanggal dan waktu jatuh tempo.

Buat pre-order baru. Item dapat berisi produk custom (tanpa product_id) atau produk dari catalog. Harga diinput manual.

fulfillment: ambil | antar  (default: ambil)

status (awal): baru

{
  "id":             "uuid",
  "order_number":   "ORD-001",
  "customer_name":  "string",
  "due_date":       "YYYY-MM-DD",
  "due_time":       "HH:MM|null",
  "status":         "baru",
  "payment_status": "belum_bayar",
  "total_amount":   150000,
  "amount_paid":    0,
  "remaining":      150000,
  "fulfillment":    "ambil",
  "items":          []
}

Update status, pembayaran, atau data order. Jika amount_paid ≥ total_amount, payment_status otomatis di-set ke lunas.

Hapus pre-order.

Daftar events/pengingat (hari besar, promo, produksi, dll). Query: from, to, type, per_page (default 30).

type: hari_besar | promo | produksi | lainnya

CRUD standar. PUT menggunakan body yang sama dengan POST.

Buat produk baru beserta data inventory awal. Gunakan multipart/form-data jika menyertakan gambar. Dijalankan dalam satu transaksi DB.

Detail produk beserta relasi category dan inventory.

Update data produk. Gambar lama dihapus otomatis jika ada upload baru. Semua field bersifat sometimes.

category_id // sometimes|string (uuid)
name          // sometimes|string|max:120
image         // nullable|file — mengganti gambar lama
description   // nullable|string
selling_price // sometimes|integer
cost_price    // sometimes|integer
status        // sometimes|active|inactive

Hapus produk (soft delete).

Daftar semua kategori, diurutkan alfabetis. Setiap item menyertakan product_count.

Buat kategori baru. Slug di-generate otomatis dari nama. Gunakan multipart/form-data jika ada gambar.

Data profil user yang sedang login.

Seluruh data stok produk, disertai ringkasan valuasi dan outflow 30 hari terakhir.

{
  "items": [
    {
      "id":              "uuid",
      "product_id":     "uuid",
      "product_name":   "string",
      "product_image":  "path|null",
      "category":       "string",
      "current_stock":  50,
      "min_stock":      10,
      "unit":           "pcs",
      "stock_status":   "ok | low | critical",
      "stock_pct":      80,
      "cost_value":     500000,
      "retail_value":   750000,
      "outgoing_30d":   24,
      "last_updated_at": "datetime"
    }
  ],
  "summary": {
    "total": 30, "ok": 25, "low": 3, "critical": 2,
    "total_units": 1200,
    "total_cost_value": 12000000,
    "total_retail_value": 18000000
  }
}

Daftar produk dengan stok low dan critical, digabung dalam satu array. Berguna untuk notifikasi.

Adjust stok produk. {productId} adalah UUID produk.

action: add    // tambah stok
        remove // kurangi stok
        set    // set langsung

Daftar resep. Query: search, category, include_inactive (boolean, default false), per_page (default 50).

Buat resep baru beserta daftar bahan. HPP dihitung otomatis dari bahan.

{
  "total_cost":   85000,    // total biaya bahan
  "hpp_per_unit": 8500,     // HPP per yield unit
  "margin_pct":   40.5,     // margin vs harga jual produk
  "selling_price": 14000,   // dari produk terkait
  "ingredients": [
    {
      "id": "uuid", "name": "Tepung",
      "qty": 0.5, "unit": "kg",
      "cost_per_unit": 12000,
      "line_cost": 6000
    }
  ]
}

Update resep. Seluruh daftar bahan diganti (replace, bukan merge). Field tambahan: is_active (boolean).

Daftar pengeluaran dengan statistik bulan ini per kategori.

{
  "items":       [ /* paginated Expense objects */ ],
  "month_total": 3500000,
  "by_category": {
    "ingredients": { "total": 2000000, "count": 5 },
    "packaging":  { "total": 500000,  "count": 2 }
    // ... kategori lain
  }
}

Update pengeluaran. Jika details[] dikirim, seluruh detail lama diganti. Cash Book entry disinkronisasi otomatis dan balance di-recalculate.

Hapus pengeluaran dan entri Cash Book yang terkait. Balance di-recalculate.

Ringkasan saldo dan statistik Cash Book bulan ini.

{
  "current_balance": 5000000,
  "total_credit":    8000000,  // pemasukan bulan ini
  "total_debit":     3000000,  // pengeluaran bulan ini
  "total_entries":   45,
  "opening_balance": 0,
  "updated_at":      "ISO8601"
}

Daftar entri Cash Book per bulan, diurutkan terbaru ke lama.

Buat entri manual di Cash Book.

type: credit // pemasukan | debit // pengeluaran

Data analitik lengkap: KPI, grafik harian, breakdown per kategori, dan top sellers — dengan perbandingan periode sebelumnya.

{
  "period": 30, "date_from": "YYYY-MM-DD", "date_to": "YYYY-MM-DD",
  "revenue_change": 12.5,  // % vs periode sebelumnya
  "expense_change": -3.2,
  "kpi": {
    "revenue": 0, "expenses": 0, "orders": 0,
    "net_profit": 0, "gross_margin": 0.0,
    "avg_daily_orders": 0.0,
    "best_day": { "date": "YYYY-MM-DD", "label": "Monday", "revenue": 0 },
    "avg_order_value": 0,
    "busiest_hour": "10:00",
    "expense_ratio": 0.0
  },
  "daily_revenue": [
    { "date": "YYYY-MM-DD", "label": "Mon",
      "total": 0, "expenses": 0, "orders": 0 }
  ],
  "by_category": [
    { "category": "Roti", "total": 0, "pct": 45.2 }
  ],
  "top_sellers": [
    { "name": "string", "qty": 0, "revenue": 0, "bar_pct": 100 }
  ]
}

Riwayat 25 laporan yang pernah di-generate.

Generate laporan. Format json mengembalikan data. Format csv, excel, pdf mengembalikan file download.

type:
  sales      // daftar transaksi penjualan
  expenses   // daftar pengeluaran
  cashbook   // buku kas
  inventory  // snapshot stok saat ini
  profit     // laba/rugi per periode
  summary    // ringkasan + top produk

format: json | csv | excel | pdf

group_by: day | week | month

Update data user. Tidak bisa menarget diri sendiri. Jika role berubah, semua token user dicabut.

Aktifkan atau nonaktifkan akun user. Jika dinonaktifkan, semua token dicabut.

Hapus user permanen. Hanya superuser. Token dicabut sebelum dihapus. Tidak bisa menghapus diri sendiri.

Ambil seluruh konfigurasi sistem (StoreSetting singleton).

Update setting. Body berisi key-value sesuai field fillable StoreSetting. Field yang tidak dikenali diabaikan.