REST API Kasir Toko (POS)

API SaaS kasir multi-toko: registrasi toko, produk & stok, transaksi POS, pelanggan & poin, shift kasir, laporan penjualan & laba, serta panel superadmin. Semua fitur di aplikasi web /kasir tersedia juga lewat API ini.

Base URLhttps://belajar-api.unama.ac.id/api/kasir
80endpoint
Bearertoken SHA-256
120/mntrate limit
JSON{success, message, data, meta}

Autentikasi & peran

  1. Panggil POST /auth/login (atau /auth/register untuk toko baru) → ambil data.token.access_token, format {id}|{acak}, berlaku 30 hari.
  2. Kirim di setiap request: Authorization: Bearer {token} dan Accept: application/json.
  3. Data otomatis dibatasi ke toko pemilik token (multi-tenant). ID milik toko lain selalu menghasilkan 404.
  4. Untuk request POST/PUT/PATCH/DELETE tanpa data (mis. logout), tetap kirim body {} dengan Content-Type: application/json — firewall server menolak POST dengan body kosong (HTTP 500 dari server, bukan dari aplikasi).
  5. Pelanggan memakai token terpisah dari POST /t/{slug}/customer/login yang hanya berlaku untuk toko tersebut.
PeranAkses utama
superadminStatistik platform, daftar toko, aktif/nonaktifkan toko (/admin/*).
ownerSemua data tokonya: pengaturan, staff, master, produk, stok, pelanggan, transaksi (termasuk void), shift, laporan.
kasirBaca produk & master, kelola pelanggan, buat transaksi, lihat transaksinya sendiri, buka/tutup shift.
pelangganProfil, poin, dan riwayat belanja sendiri di satu toko (/t/{slug}/customer/*).

Format response

Berhasil (daftar berhalaman)
{
  "success": true,
  "message": "Berhasil",
  "data": [ { "id": 1, "name": "Beras Premium 5kg", ... } ],
  "meta": { "current_page": 1, "per_page": 15, "total": 25, "last_page": 2 }
}
Gagal validasi (422)
{
  "success": false,
  "message": "Data yang dikirim tidak valid",
  "data": null,
  "meta": null,
  "errors": { "email": ["Surel wajib diisi."] }
}

Paginasi: ?page=2&per_page=20 (maks 100). Pencarian: ?q=kata. Tanggal: ?from=2026-11-01&to=2026-11-30. Angka uang dikirim sebagai number (rupiah, tanpa desimal). Waktu ISO-8601 zona Asia/Jakarta.

Kode status & error

KodeArtiContoh penyebab
200 / 201Berhasil / data dibuat—
401UnauthenticatedHeader Authorization tidak ada, token salah/kedaluwarsa, password salah saat login
403ForbiddenKasir memanggil endpoint owner, akun/toko dinonaktifkan, token pelanggan dipakai di toko lain
404Tidak ditemukanID tidak ada atau milik toko lain, endpoint salah
405Method tidak didukungDELETE /auth/login
422Validasi / aturan bisnis gagalStok tidak cukup, uang dibayar kurang, SKU duplikat, transaksi sudah dibatalkan
429Terlalu banyak request>120 request/menit per token, >10/menit untuk login/register
500Kesalahan serverLaporkan ke admin

Akun demo

Semua password: password. Data demo dapat direset sewaktu-waktu. Slug toko: toko-berkah-jaya dan kopi-senja.

PeranEmailToko
Superadmin[email protected]-
Owner[email protected]Toko Berkah Jaya
Kasir[email protected]Toko Berkah Jaya
Pelanggan[email protected]Toko Berkah Jaya
Owner[email protected]Kopi Senja
Kasir[email protected]Kopi Senja
Pelanggan[email protected]Kopi Senja

OpenAPI & Postman

Juga tersedia: GET /api/kasir/openapi.json (spesifikasi) dan salinan statis /kasir/openapi.json. Di Postman: Import → file, lalu jalankan request "Login" — token otomatis tersimpan di variabel {{token}}.

Info API

Endpoint publik berisi info API, spesifikasi OpenAPI 3, dan koleksi Postman.

GET /Info & daftar grup endpoint Publik
URL: GET https://belajar-api.unama.ac.id/api/kasir/
Header: Accept: application/json
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir" \
  -H "Accept: application/json"
Contoh response 200
{
    "success": true,
    "message": "Selamat datang di API Kasir Toko",
    "data": {
        "name": "API Kasir Toko (POS) UNAMA",
        "version": "1.0.0",
        "base_url": "http://localhost/api/kasir",
        "docs": "http://localhost/kasir/docs",
        "openapi": "http://localhost/api/kasir/openapi",
        "openapi_static": "http://localhost/kasir/openapi.json",
        "postman": "http://localhost/api/kasir/postman",
        "endpoints": 80,
        "groups": [
            {
                "id": "meta",
                "title": "Info API",
                "endpoints": 3
            },
            {
                "id": "auth",
                "title": "Autentikasi",
                "endpoints": 8
            }
        ]
    },
    "meta": null
}
Coba langsung

                                
GET /openapi.jsonSpesifikasi OpenAPI 3 Publik
URL: GET https://belajar-api.unama.ac.id/api/kasir/openapi.json
Header: Accept: application/json
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/openapi.json" \
  -H "Accept: application/json"
Contoh response
File JSON (lihat tautan unduhan di atas)
GET /postman.jsonUnduh koleksi Postman Publik
URL: GET https://belajar-api.unama.ac.id/api/kasir/postman.json
Header: Accept: application/json
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/postman.json" \
  -H "Accept: application/json"
Contoh response
File JSON (lihat tautan unduhan di atas)

Autentikasi

Registrasi toko, login, dan akun. Login mengembalikan data.token.access_token (berlaku 30 hari). Kirim di setiap request sebagai header Authorization: Bearer {token}. Endpoint register/login/lupa password dibatasi 10 request/menit.

POST /auth/registerRegistrasi toko baru (owner + toko) Publik

Membuat toko beserta akun pemiliknya sekaligus. Slug toko dibuat otomatis dari nama toko. Kategori (Umum, Makanan, Minuman) dan satuan (pcs, box, kg, liter, pack) awal ikut dibuat. Langsung mengembalikan token.

URL: POST https://belajar-api.unama.ac.id/api/kasir/auth/register
Header: Accept: application/json · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
store_namestringwajib Nama toko (3-120)Warung Maju
namestringwajib Nama pemilikAhmad Fauzi
emailstringwajib Email login (unik)[email protected]
passwordstringwajib Minimal 6 karakterrahasia123
password_confirmationstringwajib Ulangi passwordrahasia123
phonestringopsional Nomor HP/telepon toko081234567890
addressstringopsional Alamat tokoJl. Merdeka No. 1, Jambi
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/auth/register" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"store_name":"Warung Maju","name":"Ahmad Fauzi","email":"[email protected]","password":"rahasia123","password_confirmation":"rahasia123","phone":"081234567890","address":"Jl. Merdeka No. 1, Jambi"}'
Contoh response 201
{
    "success": true,
    "message": "Registrasi toko berhasil",
    "data": {
        "user": {
            "id": 26,
            "name": "Ahmad Fauzi",
            "email": "[email protected]",
            "phone": "081234567890",
            "role": "owner",
            "is_active": true,
            "tenant_id": 12,
            "last_login_at": "2026-11-13T07:18:33+07:00",
            "created_at": "2026-11-13T07:18:33+07:00"
        },
        "store": {
            "id": 12,
            "name": "Warung Maju",
            "slug": "warung-maju",
            "status": "active",
            "store_url": "http://localhost/kasir/t/warung-maju"
        },
        "token": {
            "access_token": "50|OzhxpPTZAD6L6AInu651srNIkXeAh7NuZChCbJYhpZyWS8I1",
            "token_type": "Bearer",
            "expires_at": "2026-12-13T07:18:34+07:00"
        }
    },
    "meta": null
}
Coba langsung

                                
POST /auth/loginLogin (superadmin, owner, kasir) Publik

Tukar email & password dengan token. Akun demo: [email protected] / password.

URL: POST https://belajar-api.unama.ac.id/api/kasir/auth/login
Header: Accept: application/json · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
emailstringwajib Email[email protected]
passwordstringwajib Passwordpassword
device_namestringopsional Nama perangkatpostman
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/auth/login" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"password","device_name":"postman"}'
Contoh response 200
{
    "success": true,
    "message": "Login berhasil",
    "data": {
        "user": {
            "id": 15,
            "name": "Budi Santoso",
            "email": "[email protected]",
            "phone": "081234567890",
            "role": "owner",
            "is_active": true,
            "tenant_id": 7,
            "last_login_at": "2026-11-13T07:18:34+07:00",
            "created_at": "2026-11-13T06:12:12+07:00"
        },
        "store": {
            "id": 7,
            "name": "Toko Berkah Jaya",
            "slug": "toko-berkah-jaya",
            "status": "active",
            "store_url": "http://localhost/kasir/t/toko-berkah-jaya"
        },
        "token": {
            "access_token": "51|heOSenGhSJwowEZJjaFy6UrFbcsY4ieVlOiQ7QAYgeymteLQ",
            "token_type": "Bearer",
            "expires_at": "2026-12-13T07:18:34+07:00"
        }
    },
    "meta": null
}
Coba langsung

                                
POST /auth/forgot-passwordLupa password Publik

Mengirim email berisi tautan reset (web) dan token reset (API). Respons selalu sama walau email tidak terdaftar.

URL: POST https://belajar-api.unama.ac.id/api/kasir/auth/forgot-password
Header: Accept: application/json · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
emailstringwajib Email akun[email protected]
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/auth/forgot-password" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'
Contoh response 200
{
    "success": true,
    "message": "Jika email terdaftar, tautan & token reset password telah dikirim ke email tersebut (berlaku 60 menit).",
    "data": null,
    "meta": null
}
Coba langsung

                                
POST /auth/reset-passwordReset password dengan token Publik

Token dari email berlaku 60 menit. Semua token API user dicabut setelah berhasil.

URL: POST https://belajar-api.unama.ac.id/api/kasir/auth/reset-password
Header: Accept: application/json · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
emailstringwajib Email akun[email protected]
tokenstringwajib Token dari emailxxxxxxxx
passwordstringwajib Password barupasswordbaru
password_confirmationstringwajib Ulangi password barupasswordbaru
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/auth/reset-password" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","token":"xxxxxxxx","password":"passwordbaru","password_confirmation":"passwordbaru"}'
Contoh response 422
{
    "success": false,
    "message": "Token reset tidak valid atau sudah kedaluwarsa",
    "data": null,
    "meta": null
}
Coba langsung

                                
GET /auth/meProfil user yang login SuperadminOwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/auth/me
Header: Accept: application/json · Authorization: Bearer {token}
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/auth/me" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "user": {
            "id": 1,
            "name": "Admin Platform",
            "email": "[email protected]",
            "phone": null,
            "role": "superadmin",
            "is_active": true,
            "tenant_id": null,
            "last_login_at": "2026-11-13T07:18:33+07:00",
            "created_at": "2026-11-13T05:46:59+07:00"
        }
    },
    "meta": null
}
Coba langsung

                                
PUT /auth/meUbah profil SuperadminOwnerKasir
URL: PUT https://belajar-api.unama.ac.id/api/kasir/auth/me
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
namestringopsional NamaBudi Santoso
emailstringopsional Email (unik)
phonestringopsional Nomor HP081299998888
Contoh request (curl)
curl -X PUT "https://belajar-api.unama.ac.id/api/kasir/auth/me" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Budi Santoso","phone":"081299998888"}'
Contoh response 200
{
    "success": true,
    "message": "Profil diperbarui",
    "data": {
        "user": {
            "id": 1,
            "name": "Budi Santoso",
            "email": "[email protected]",
            "phone": "081299998888",
            "role": "superadmin",
            "is_active": true,
            "tenant_id": null,
            "last_login_at": "2026-11-13T07:18:33+07:00",
            "created_at": "2026-11-13T05:46:59+07:00"
        }
    },
    "meta": null
}
Coba langsung

                                
PUT /auth/passwordGanti password SuperadminOwnerKasir

Token lain milik user dicabut, token yang sedang dipakai tetap berlaku.

URL: PUT https://belajar-api.unama.ac.id/api/kasir/auth/password
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
current_passwordstringwajib Password saat inipassword
passwordstringwajib Password baru (min 6)passwordbaru
password_confirmationstringwajib Ulangi password barupasswordbaru
Contoh request (curl)
curl -X PUT "https://belajar-api.unama.ac.id/api/kasir/auth/password" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"current_password":"password","password":"passwordbaru","password_confirmation":"passwordbaru"}'
Contoh response 200
{
    "success": true,
    "message": "Password berhasil diganti. Token di perangkat lain telah dicabut.",
    "data": null,
    "meta": null
}
Coba langsung

                                
POST /auth/logoutLogout (cabut token ini) SuperadminOwnerKasir
URL: POST https://belajar-api.unama.ac.id/api/kasir/auth/logout
Header: Accept: application/json · Authorization: Bearer {token}
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/auth/logout" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Contoh response 200
{
    "success": true,
    "message": "Logout berhasil",
    "data": null,
    "meta": null
}
Coba langsung

                                

Toko & Staff

Pengaturan toko (pajak %, footer & lebar struk, poin) dan manajemen staff kasir oleh owner.

GET /storeData toko OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/store
Header: Accept: application/json · Authorization: Bearer {token}
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/store" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 7,
        "name": "Toko Berkah Jaya",
        "slug": "toko-berkah-jaya",
        "address": "Jl. Kapten Pattimura No. 10, Jambi",
        "phone": "0741-123456",
        "email": "[email protected]",
        "logo": "demo/toko-berkah-jaya/logo.png",
        "tax_percent": 0,
        "point_rate": 10000,
        "receipt_footer": "Terima kasih telah berbelanja di Toko Berkah Jaya!",
        "receipt_width": 58,
        "status": "active",
        "created_at": "2026-09-29T06:12:12+07:00",
        "updated_at": "2026-11-13T06:12:12+07:00",
        "logo_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/logo.png",
        "store_url": "http://localhost/kasir/t/toko-berkah-jaya"
    },
    "meta": null
}
Coba langsung

                                
PUT /storeUbah pengaturan toko Owner
URL: PUT https://belajar-api.unama.ac.id/api/kasir/store
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
namestringopsional Nama tokoToko Berkah Jaya
addressstringopsional AlamatJl. Kapten Pattimura No. 10, Jambi
phonestringopsional Telepon0741-123456
emailstringopsional Email toko
tax_percentnumberopsional Pajak (%) yang otomatis ditambahkan ke setiap nota0
point_rateintegeropsional 1 poin pelanggan per kelipatan Rp ini (0 = poin nonaktif)10000
receipt_footerstringopsional Teks di bawah strukTerima kasih!
receipt_widthintegeropsional Lebar kertas struk: 58 atau 80 (mm)58
Contoh request (curl)
curl -X PUT "https://belajar-api.unama.ac.id/api/kasir/store" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Toko Berkah Jaya","address":"Jl. Kapten Pattimura No. 10, Jambi","phone":"0741-123456","tax_percent":0,"point_rate":10000,"receipt_footer":"Terima kasih!","receipt_width":58}'
Contoh response 200
{
    "success": true,
    "message": "Pengaturan toko disimpan",
    "data": {
        "id": 7,
        "name": "Toko Berkah Jaya",
        "slug": "toko-berkah-jaya",
        "address": "Jl. Kapten Pattimura No. 10, Jambi",
        "phone": "0741-123456",
        "email": "[email protected]",
        "logo": "demo/toko-berkah-jaya/logo.png",
        "tax_percent": 0,
        "point_rate": 10000,
        "receipt_footer": "Terima kasih!",
        "receipt_width": 58,
        "status": "active",
        "created_at": "2026-09-29T06:12:12+07:00",
        "updated_at": "2026-11-13T07:18:34+07:00",
        "logo_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/logo.png",
        "store_url": "http://localhost/kasir/t/toko-berkah-jaya"
    },
    "meta": null
}
Coba langsung

                                
GET /usersDaftar user toko Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/users
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
qstringopsional Cari nama/email
rolestringopsional owner atau kasir
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/users?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 17,
            "name": "Rudi Hartono",
            "email": "[email protected]",
            "phone": null,
            "role": "kasir",
            "is_active": true,
            "tenant_id": 7,
            "last_login_at": null,
            "created_at": "2026-11-13T06:12:12+07:00"
        },
        {
            "id": 16,
            "name": "Siti Aminah",
            "email": "[email protected]",
            "phone": null,
            "role": "kasir",
            "is_active": true,
            "tenant_id": 7,
            "last_login_at": null,
            "created_at": "2026-11-13T06:12:12+07:00"
        },
        {
            "id": 15,
            "name": "Budi Santoso",
            "email": "[email protected]",
            "phone": "081234567890",
            "role": "owner",
            "is_active": true,
            "tenant_id": 7,
            "last_login_at": "2026-11-13T07:18:34+07:00",
            "created_at": "2026-11-13T06:12:12+07:00"
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 3,
        "last_page": 1
    }
}
Coba langsung

                                
POST /usersTambah staff kasir Owner
URL: POST https://belajar-api.unama.ac.id/api/kasir/users
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
namestringwajib NamaKasir Baru
emailstringwajib Email login (unik)[email protected]
passwordstringwajib Password (min 6)rahasia123
phonestringopsional Nomor HP
is_activebooleanopsional Aktif?true
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/users" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Kasir Baru","email":"[email protected]","password":"rahasia123","is_active":true}'
Contoh response 201
{
    "success": true,
    "message": "Kasir berhasil ditambahkan",
    "data": {
        "id": 27,
        "name": "Kasir Baru",
        "email": "[email protected]",
        "phone": null,
        "role": "kasir",
        "is_active": true,
        "tenant_id": 7,
        "last_login_at": null,
        "created_at": "2026-11-13T07:18:34+07:00"
    },
    "meta": null
}
Coba langsung

                                
GET /users/{id}Detail user Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/users/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID user17
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/users/17" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 17,
        "name": "Rudi Hartono",
        "email": "[email protected]",
        "phone": null,
        "role": "kasir",
        "is_active": true,
        "tenant_id": 7,
        "last_login_at": null,
        "created_at": "2026-11-13T06:12:12+07:00"
    },
    "meta": null
}
Coba langsung

                                
PUT /users/{id}Ubah user / reset password / nonaktifkan Owner

Kirim field yang ingin diubah saja. password kosong = tidak diubah. Menonaktifkan atau mengganti password mencabut token user tersebut.

URL: PUT https://belajar-api.unama.ac.id/api/kasir/users/{id}
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID user17
Body
NamaTipeWajibKeteranganContoh
namestringopsional Nama
emailstringopsional Email
passwordstringopsional Password baru
is_activebooleanopsional Aktif?true
Contoh request (curl)
curl -X PUT "https://belajar-api.unama.ac.id/api/kasir/users/17" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"is_active":true}'
Contoh response 200
{
    "success": true,
    "message": "User diperbarui",
    "data": {
        "id": 17,
        "name": "Rudi Hartono",
        "email": "[email protected]",
        "phone": null,
        "role": "kasir",
        "is_active": true,
        "tenant_id": 7,
        "last_login_at": null,
        "created_at": "2026-11-13T06:12:12+07:00"
    },
    "meta": null
}
Coba langsung

                                
DELETE /users/{id}Hapus staff Owner
URL: DELETE https://belajar-api.unama.ac.id/api/kasir/users/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID user17
Contoh request (curl)
curl -X DELETE "https://belajar-api.unama.ac.id/api/kasir/users/17" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Contoh response 200
{
    "success": true,
    "message": "User dihapus",
    "data": null,
    "meta": null
}
Coba langsung

                                

Master Data

Kategori, satuan, dan supplier milik toko. Kasir hanya bisa membaca; owner bisa menambah/mengubah/menghapus.

GET /categoriesDaftar kategori OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/categories
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
qstringopsional Kata kunci pencarian
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/categories?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 28,
            "name": "Kebutuhan Rumah",
            "description": null,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:12+07:00",
            "products_count": 5
        },
        {
            "id": 27,
            "name": "Makanan Ringan",
            "description": null,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:12+07:00",
            "products_count": 4
        },
        {
            "id": 29,
            "name": "Mi Instan",
            "description": null,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:12+07:00",
            "products_count": 3
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 5,
        "last_page": 1
    }
}
Coba langsung

                                
GET /categories/{id}Detail kategori OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/categories/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID kategori25
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/categories/25" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 25,
        "name": "Sembako",
        "description": null,
        "created_at": "2026-11-13T06:12:12+07:00",
        "updated_at": "2026-11-13T06:12:12+07:00",
        "products_count": 6
    },
    "meta": null
}
Coba langsung

                                
POST /categoriesTambah kategori Owner
URL: POST https://belajar-api.unama.ac.id/api/kasir/categories
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
namestringwajib Nama kategori (unik per toko)Frozen Food
descriptionstringopsional Keterangan
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/categories" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Frozen Food"}'
Contoh response 201
{
    "success": true,
    "message": "Kategori berhasil ditambahkan",
    "data": {
        "name": "Frozen Food",
        "updated_at": "2026-11-13T07:18:34+07:00",
        "created_at": "2026-11-13T07:18:34+07:00",
        "id": 48
    },
    "meta": null
}
Coba langsung

                                
PUT /categories/{id}Ubah kategori Owner
URL: PUT https://belajar-api.unama.ac.id/api/kasir/categories/{id}
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID kategori25
Body
NamaTipeWajibKeteranganContoh
namestringwajib Nama kategori (unik per toko)Frozen Food (ubah)
descriptionstringopsional Keterangan
Contoh request (curl)
curl -X PUT "https://belajar-api.unama.ac.id/api/kasir/categories/25" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Frozen Food (ubah)"}'
Contoh response 200
{
    "success": true,
    "message": "Kategori diperbarui",
    "data": {
        "id": 25,
        "name": "Frozen Food (ubah)",
        "description": null,
        "created_at": "2026-11-13T06:12:12+07:00",
        "updated_at": "2026-11-13T07:18:34+07:00"
    },
    "meta": null
}
Coba langsung

                                
DELETE /categories/{id}Hapus kategori Owner
URL: DELETE https://belajar-api.unama.ac.id/api/kasir/categories/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID kategori25
Contoh request (curl)
curl -X DELETE "https://belajar-api.unama.ac.id/api/kasir/categories/25" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Contoh response 200
{
    "success": true,
    "message": "Kategori dihapus",
    "data": null,
    "meta": null
}
Coba langsung

                                
GET /unitsDaftar satuan OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/units
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
qstringopsional Kata kunci pencarian
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/units?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 35,
            "name": "box",
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:12+07:00",
            "products_count": 1
        },
        {
            "id": 34,
            "name": "kg",
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:12+07:00",
            "products_count": 3
        },
        {
            "id": 32,
            "name": "pack",
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:12+07:00",
            "products_count": 1
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 4,
        "last_page": 1
    }
}
Coba langsung

                                
GET /units/{id}Detail satuan OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/units/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID satuan32
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/units/32" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 32,
        "name": "pack",
        "created_at": "2026-11-13T06:12:12+07:00",
        "updated_at": "2026-11-13T06:12:12+07:00",
        "products_count": 1
    },
    "meta": null
}
Coba langsung

                                
POST /unitsTambah satuan Owner
URL: POST https://belajar-api.unama.ac.id/api/kasir/units
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
namestringwajib Nama satuan (unik per toko)lusin
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/units" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"lusin"}'
Contoh response 201
{
    "success": true,
    "message": "Satuan berhasil ditambahkan",
    "data": {
        "name": "lusin",
        "updated_at": "2026-11-13T07:18:34+07:00",
        "created_at": "2026-11-13T07:18:34+07:00",
        "id": 62
    },
    "meta": null
}
Coba langsung

                                
PUT /units/{id}Ubah satuan Owner
URL: PUT https://belajar-api.unama.ac.id/api/kasir/units/{id}
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID satuan32
Body
NamaTipeWajibKeteranganContoh
namestringwajib Nama satuan (unik per toko)lusin (ubah)
Contoh request (curl)
curl -X PUT "https://belajar-api.unama.ac.id/api/kasir/units/32" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"lusin (ubah)"}'
Contoh response 200
{
    "success": true,
    "message": "Satuan diperbarui",
    "data": {
        "id": 32,
        "name": "lusin (ubah)",
        "created_at": "2026-11-13T06:12:12+07:00",
        "updated_at": "2026-11-13T07:18:34+07:00"
    },
    "meta": null
}
Coba langsung

                                
DELETE /units/{id}Hapus satuan Owner
URL: DELETE https://belajar-api.unama.ac.id/api/kasir/units/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID satuan32
Contoh request (curl)
curl -X DELETE "https://belajar-api.unama.ac.id/api/kasir/units/32" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Contoh response 200
{
    "success": true,
    "message": "Satuan dihapus",
    "data": null,
    "meta": null
}
Coba langsung

                                
GET /suppliersDaftar supplier OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/suppliers
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
qstringopsional Kata kunci pencarian
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/suppliers?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 11,
            "name": "CV Indo Grosir",
            "phone": "0741-550001",
            "email": null,
            "address": "Jambi",
            "notes": null,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:12+07:00",
            "purchases_count": 0
        },
        {
            "id": 12,
            "name": "Distributor Sinar Jambi",
            "phone": "0741-550002",
            "email": null,
            "address": "Jambi",
            "notes": null,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:12+07:00",
            "purchases_count": 1
        },
        {
            "id": 10,
            "name": "PT Sumber Makmur",
            "phone": "0741-550000",
            "email": null,
            "address": "Jambi",
            "notes": null,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:12+07:00",
            "purchases_count": 3
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 3,
        "last_page": 1
    }
}
Coba langsung

                                
GET /suppliers/{id}Detail supplier OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/suppliers/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID supplier10
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/suppliers/10" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 10,
        "name": "PT Sumber Makmur",
        "phone": "0741-550000",
        "email": null,
        "address": "Jambi",
        "notes": null,
        "created_at": "2026-11-13T06:12:12+07:00",
        "updated_at": "2026-11-13T06:12:12+07:00",
        "purchases_count": 3
    },
    "meta": null
}
Coba langsung

                                
POST /suppliersTambah supplier Owner
URL: POST https://belajar-api.unama.ac.id/api/kasir/suppliers
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
namestringwajib Nama supplierUD Sejahtera
phonestringopsional Telepon0741-222333
emailstringopsional Email
addressstringopsional AlamatJambi
notesstringopsional Catatan
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/suppliers" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"UD Sejahtera","phone":"0741-222333","address":"Jambi"}'
Contoh response 201
{
    "success": true,
    "message": "Supplier berhasil ditambahkan",
    "data": {
        "name": "UD Sejahtera",
        "phone": "0741-222333",
        "address": "Jambi",
        "updated_at": "2026-11-13T07:18:34+07:00",
        "created_at": "2026-11-13T07:18:34+07:00",
        "id": 18
    },
    "meta": null
}
Coba langsung

                                
PUT /suppliers/{id}Ubah supplier Owner
URL: PUT https://belajar-api.unama.ac.id/api/kasir/suppliers/{id}
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID supplier10
Body
NamaTipeWajibKeteranganContoh
namestringwajib Nama supplierUD Sejahtera (ubah)
phonestringopsional Telepon0741-222333
emailstringopsional Email
addressstringopsional AlamatJambi
notesstringopsional Catatan
Contoh request (curl)
curl -X PUT "https://belajar-api.unama.ac.id/api/kasir/suppliers/10" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"UD Sejahtera (ubah)","phone":"0741-222333","address":"Jambi"}'
Contoh response 200
{
    "success": true,
    "message": "Supplier diperbarui",
    "data": {
        "id": 10,
        "name": "UD Sejahtera (ubah)",
        "phone": "0741-222333",
        "email": null,
        "address": "Jambi",
        "notes": null,
        "created_at": "2026-11-13T06:12:12+07:00",
        "updated_at": "2026-11-13T07:18:34+07:00"
    },
    "meta": null
}
Coba langsung

                                
DELETE /suppliers/{id}Hapus supplier Owner
URL: DELETE https://belajar-api.unama.ac.id/api/kasir/suppliers/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID supplier10
Contoh request (curl)
curl -X DELETE "https://belajar-api.unama.ac.id/api/kasir/suppliers/10" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Contoh response 422
{
    "success": false,
    "message": "Supplier sudah dipakai di data stok masuk, tidak dapat dihapus",
    "data": null,
    "meta": null
}
Coba langsung

                                

Produk

Produk dengan SKU/barcode, harga beli (HPP), harga jual, stok & stok minimum. Stok tidak diubah lewat endpoint produk, tetapi lewat Stok Masuk atau Penyesuaian agar tercatat di riwayat mutasi.

GET /productsDaftar & cari produk OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/products
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
qstringopsional Cari nama / SKU / barcodemi
category_idintegeropsional Filter kategori
activebooleanopsional true / false
low_stockbooleanopsional true = hanya stok menipis
sortstringopsional name, -name, price, -price, stock, -stock, -created_atname
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/products?q=mi&sort=name&page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 51,
            "category_id": 26,
            "unit_id": 33,
            "sku": "TOK0007",
            "barcode": "8990000007007",
            "name": "Air Mineral 600ml",
            "description": null,
            "cost_price": 2500,
            "price": 4000,
            "stock": 119,
            "min_stock": 9,
            "image": "demo/toko-berkah-jaya/TOK0007.jpg",
            "is_active": true,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T03:40:20+07:00",
            "image_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/TOK0007.jpg",
            "is_low_stock": false,
            "category": {
                "id": 26,
                "name": "Minuman"
            },
            "unit": {
                "id": 33,
                "name": "pcs"
            }
        },
        {
            "id": 45,
            "category_id": 25,
            "unit_id": 32,
            "sku": "TOK0001",
            "barcode": "8990000007001",
            "name": "Beras Premium 5kg",
            "description": null,
            "cost_price": 62000,
            "price": 72000,
            "stock": 110,
            "min_stock": 15,
            "image": "demo/toko-berkah-jaya/TOK0001.jpg",
            "is_active": true,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T01:28:18+07:00",
            "image_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/TOK0001.jpg",
            "is_low_stock": false,
            "category": {
                "id": 25,
                "name": "Frozen Food (ubah)"
            },
            "unit": {
                "id": 32,
                "name": "lusin (ubah)"
            }
        },
        {
            "id": 67,
            "category_id": 29,
            "unit_id": 33,
            "sku": "TOK0023",
            "barcode": "8990000007023",
            "name": "Mi Cup",
            "description": null,
            "cost_price": 4500,
            "price": 6000,
            "stock": 265,
            "min_stock": 8,
            "image": "demo/toko-berkah-jaya/TOK0023.jpg",
            "is_active": true,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T01:28:18+07:00",
            "image_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/TOK0023.jpg",
            "is_low_stock": false,
            "category": {
                "id": 29,
                "name": "Mi Instan"
            },
            "unit": {
                "id": 33,
                "name": "pcs"
            }
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 7,
        "last_page": 1
    }
}
Coba langsung

                                
GET /products/barcode/{code}Cari produk dari barcode / SKU (scan) OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/products/barcode/{code}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
codestringwajib Barcode atau SKU8990000007001
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/products/barcode/8990000007001" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 45,
        "category_id": 25,
        "unit_id": 32,
        "sku": "TOK0001",
        "barcode": "8990000007001",
        "name": "Beras Premium 5kg",
        "description": null,
        "cost_price": 62000,
        "price": 72000,
        "stock": 110,
        "min_stock": 15,
        "image": "demo/toko-berkah-jaya/TOK0001.jpg",
        "is_active": true,
        "created_at": "2026-11-13T06:12:12+07:00",
        "updated_at": "2026-11-13T01:28:18+07:00",
        "image_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/TOK0001.jpg",
        "is_low_stock": false,
        "category": {
            "id": 25,
            "name": "Frozen Food (ubah)"
        },
        "unit": {
            "id": 32,
            "name": "lusin (ubah)"
        }
    },
    "meta": null
}
Coba langsung

                                
GET /products/{id}Detail produk OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/products/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID produk45
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/products/45" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 45,
        "category_id": 25,
        "unit_id": 32,
        "sku": "TOK0001",
        "barcode": "8990000007001",
        "name": "Beras Premium 5kg",
        "description": null,
        "cost_price": 62000,
        "price": 72000,
        "stock": 110,
        "min_stock": 15,
        "image": "demo/toko-berkah-jaya/TOK0001.jpg",
        "is_active": true,
        "created_at": "2026-11-13T06:12:12+07:00",
        "updated_at": "2026-11-13T01:28:18+07:00",
        "image_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/TOK0001.jpg",
        "is_low_stock": false,
        "category": {
            "id": 25,
            "name": "Frozen Food (ubah)"
        },
        "unit": {
            "id": 32,
            "name": "lusin (ubah)"
        }
    },
    "meta": null
}
Coba langsung

                                
POST /productsTambah produk Owner

Bisa JSON atau multipart (bila menyertakan image). SKU kosong = dibuat otomatis (PRD00001). stock = stok awal (tercatat sebagai mutasi "Stok awal").

URL: POST https://belajar-api.unama.ac.id/api/kasir/products
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
namestringwajib Nama produkKopi Bubuk 200g
skustringopsional Kode unik per toko (huruf/angka/-/_)KOPI200
barcodestringopsional Barcode (unik per toko)8991234567890
category_idintegeropsional ID kategori
unit_idintegeropsional ID satuan
cost_pricenumberwajib Harga beli / HPP18000
pricenumberwajib Harga jual24000
stockintegeropsional Stok awal20
min_stockintegeropsional Batas stok menipis5
is_activebooleanopsional Dijual di POS?true
descriptionstringopsional Deskripsi
imagefileopsional Gambar jpg/png/webp maks 2MB (multipart)
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/products" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Kopi Bubuk 200g","sku":"KOPI200","barcode":"8991234567890","cost_price":18000,"price":24000,"stock":20,"min_stock":5,"is_active":true}'
Contoh response 201
{
    "success": true,
    "message": "Produk berhasil ditambahkan",
    "data": {
        "id": 87,
        "category_id": null,
        "unit_id": null,
        "sku": "KOPI200",
        "barcode": "8991234567890",
        "name": "Kopi Bubuk 200g",
        "description": null,
        "cost_price": 18000,
        "price": 24000,
        "stock": 20,
        "min_stock": 5,
        "image": null,
        "is_active": true,
        "created_at": "2026-11-13T07:18:34+07:00",
        "updated_at": "2026-11-13T07:18:34+07:00",
        "image_url": null,
        "is_low_stock": false,
        "category": null,
        "unit": null
    },
    "meta": null
}
Coba langsung

                                
PUT /products/{id}Ubah produk Owner

Kirim field yang ingin diubah saja. Field stock ditolak (422) — gunakan penyesuaian stok.

URL: PUT https://belajar-api.unama.ac.id/api/kasir/products/{id}
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID produk45
Body
NamaTipeWajibKeteranganContoh
namestringopsional Nama
pricenumberopsional Harga jual73000
cost_pricenumberopsional Harga beli
min_stockintegeropsional Stok minimum
is_activebooleanopsional Aktif?
Contoh request (curl)
curl -X PUT "https://belajar-api.unama.ac.id/api/kasir/products/45" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"price":73000}'
Contoh response 200
{
    "success": true,
    "message": "Produk diperbarui",
    "data": {
        "id": 45,
        "category_id": 25,
        "unit_id": 32,
        "sku": "TOK0001",
        "barcode": "8990000007001",
        "name": "Beras Premium 5kg",
        "description": null,
        "cost_price": 62000,
        "price": 73000,
        "stock": 110,
        "min_stock": 15,
        "image": "demo/toko-berkah-jaya/TOK0001.jpg",
        "is_active": true,
        "created_at": "2026-11-13T06:12:12+07:00",
        "updated_at": "2026-11-13T07:18:34+07:00",
        "image_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/TOK0001.jpg",
        "is_low_stock": false,
        "category": {
            "id": 25,
            "name": "Frozen Food (ubah)"
        },
        "unit": {
            "id": 32,
            "name": "lusin (ubah)"
        }
    },
    "meta": null
}
Coba langsung

                                
POST /products/{id}/imageUpload gambar produk Owner
URL: POST https://belajar-api.unama.ac.id/api/kasir/products/{id}/image
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: multipart/form-data
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID produk45
Body
NamaTipeWajibKeteranganContoh
imagefilewajib Gambar jpg/png/webp maks 2MB
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/products/45/image" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -F "image=@/path/gambar.jpg"
Contoh response
{ "success": true, "message": "...", "data": { ... }, "meta": null }
DELETE /products/{id}Hapus produk Owner

Produk yang sudah pernah terjual tidak dapat dihapus (422); nonaktifkan dengan is_active: false.

URL: DELETE https://belajar-api.unama.ac.id/api/kasir/products/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID produk45
Contoh request (curl)
curl -X DELETE "https://belajar-api.unama.ac.id/api/kasir/products/45" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Contoh response 422
{
    "success": false,
    "message": "Produk sudah pernah terjual sehingga tidak dapat dihapus. Nonaktifkan saja (is_active = false).",
    "data": null,
    "meta": null
}
Coba langsung

                                

Stok

Stok masuk (pembelian dari supplier), penyesuaian/stock opname, riwayat mutasi, dan peringatan stok menipis. Khusus owner.

GET /stock/purchasesDaftar stok masuk Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/stock/purchases
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
qstringopsional Cari nomor
supplier_idintegeropsional Filter supplier
fromdateopsional Dari tanggal
todateopsional Sampai tanggal
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/stock/purchases?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 16,
            "number": "PB-261108-0001",
            "supplier_id": 12,
            "user_id": 15,
            "date": "2026-11-08",
            "total": 1626600,
            "note": "Restock mingguan",
            "created_at": "2026-11-08T07:30:00+07:00",
            "updated_at": "2026-11-08T07:30:00+07:00",
            "items_count": 6,
            "supplier": {
                "id": 12,
                "name": "Distributor Sinar Jambi"
            },
            "user": {
                "id": 15,
                "name": "Budi Santoso"
            }
        },
        {
            "id": 15,
            "number": "PB-261029-0001",
            "supplier_id": 10,
            "user_id": 15,
            "date": "2026-10-29",
            "total": 2986000,
            "note": "Restock mingguan",
            "created_at": "2026-10-29T07:30:00+07:00",
            "updated_at": "2026-10-29T07:30:00+07:00",
            "items_count": 6,
            "supplier": {
                "id": 10,
                "name": "UD Sejahtera (ubah)"
            },
            "user": {
                "id": 15,
                "name": "Budi Santoso"
            }
        },
        {
            "id": 14,
            "number": "PB-261019-0001",
            "supplier_id": 10,
            "user_id": 15,
            "date": "2026-10-19",
            "total": 4929500,
            "note": "Restock mingguan",
            "created_at": "2026-10-19T07:30:00+07:00",
            "updated_at": "2026-10-19T07:30:00+07:00",
            "items_count": 6,
            "supplier": {
                "id": 10,
                "name": "UD Sejahtera (ubah)"
            },
            "user": {
                "id": 15,
                "name": "Budi Santoso"
            }
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 4,
        "last_page": 1
    }
}
Coba langsung

                                
POST /stock/purchasesCatat stok masuk Owner

Menambah stok semua item dalam satu transaksi DB. update_cost (default true) memperbarui harga beli produk ke cost_price terbaru. Nomor otomatis PB-yymmdd-0001.

URL: POST https://belajar-api.unama.ac.id/api/kasir/stock/purchases
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
supplier_idintegeropsional ID supplier
datedateopsional Tanggal (default hari ini)
notestringopsional Catatan / no faktur supplierFaktur #123
update_costbooleanopsional Perbarui harga beli produktrue
itemsarraywajib Daftar item: [{product_id, qty, cost_price?}][{"product_id":45,"qty":10,"cost_price":62000}]
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/stock/purchases" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"note":"Faktur #123","update_cost":true,"items":[{"product_id":45,"qty":10,"cost_price":62000}]}'
Contoh response 201
{
    "success": true,
    "message": "Stok masuk berhasil dicatat",
    "data": {
        "number": "PB-261113-0001",
        "supplier_id": null,
        "user_id": 15,
        "date": "2026-11-13",
        "note": "Faktur #123",
        "total": 620000,
        "updated_at": "2026-11-13T07:18:34+07:00",
        "created_at": "2026-11-13T07:18:34+07:00",
        "id": 24,
        "items": [
            {
                "id": 159,
                "purchase_id": 24,
                "product_id": 45,
                "qty": 10,
                "cost_price": 62000,
                "subtotal": 620000,
                "product": {
                    "id": 45,
                    "category_id": 25,
                    "unit_id": 32,
                    "sku": "TOK0001",
                    "barcode": "8990000007001",
                    "name": "Beras Premium 5kg",
                    "description": null,
                    "cost_price": 62000,
                    "price": 73000,
                    "stock": 120,
                    "min_stock": 15,
                    "image": "demo/toko-berkah-jaya/TOK0001.jpg",
                    "is_active": true,
                    "created_at": "2026-11-13T06:12:12+07:00",
                    "updated_at": "2026-11-13T07:18:34+07:00",
                    "image_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/TOK0001.jpg",
                    "is_low_stock": false
                }
            }
        ],
        "supplier": null
    },
    "meta": null
}
Coba langsung

                                
GET /stock/purchases/{id}Detail stok masuk Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/stock/purchases/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID stok masuk13
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/stock/purchases/13" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 13,
        "number": "PB-261013-0001",
        "supplier_id": 10,
        "user_id": 15,
        "date": "2026-10-13",
        "total": 58633200,
        "note": "Stok awal toko",
        "created_at": "2026-10-13T08:00:00+07:00",
        "updated_at": "2026-10-13T08:00:00+07:00",
        "items": [
            {
                "id": 81,
                "purchase_id": 13,
                "product_id": 45,
                "qty": 249,
                "cost_price": 62000,
                "subtotal": 15438000,
                "product": {
                    "id": 45,
                    "name": "Beras Premium 5kg",
                    "sku": "TOK0001",
                    "image_url": null,
                    "is_low_stock": true
                }
            },
            {
                "id": 82,
                "purchase_id": 13,
                "product_id": 46,
                "qty": 297,
                "cost_price": 31000,
                "subtotal": 9207000,
                "product": {
                    "id": 46,
                    "name": "Minyak Goreng 2L",
                    "sku": "TOK0002",
                    "image_url": null,
                    "is_low_stock": true
                }
            }
        ],
        "supplier": {
            "id": 10,
            "name": "UD Sejahtera (ubah)",
            "phone": "0741-222333",
            "email": null,
            "address": "Jambi",
            "notes": null,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T07:18:34+07:00"
        },
        "user": {
            "id": 15,
            "name": "Budi Santoso"
        }
    },
    "meta": null
}
Coba langsung

                                
POST /stock/adjustmentsPenyesuaian stok (stock opname) Owner

mode: set = jadikan stok sama dengan qty (hasil hitung fisik). mode: add = tambah/kurangi qty (boleh negatif, mis. barang rusak). Stok tidak boleh minus.

URL: POST https://belajar-api.unama.ac.id/api/kasir/stock/adjustments
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
product_idintegerwajib ID produk45
modestringwajib set atau addadd
qtyintegerwajib Jumlah-1
notestringwajib AlasanBarang rusak
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/stock/adjustments" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"product_id":45,"mode":"add","qty":-1,"note":"Barang rusak"}'
Contoh response 201
{
    "success": true,
    "message": "Stok berhasil disesuaikan",
    "data": {
        "product_id": 45,
        "type": "adjustment",
        "qty": -1,
        "stock_before": 120,
        "stock_after": 119,
        "reference": "ADJ",
        "note": "Barang rusak",
        "user_id": 15,
        "created_at": "2026-11-13T07:18:34+07:00",
        "id": 6515,
        "product": {
            "id": 45,
            "name": "Beras Premium 5kg",
            "sku": "TOK0001",
            "image_url": null,
            "is_low_stock": true
        }
    },
    "meta": null
}
Coba langsung

                                
GET /stock/movementsRiwayat mutasi stok Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/stock/movements
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
product_idintegeropsional Filter produk
typestringopsional initial, purchase, sale, adjustment, void
fromdateopsional Dari tanggal
todateopsional Sampai tanggal
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/stock/movements?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 6515,
            "product_id": 45,
            "type": "adjustment",
            "qty": -1,
            "stock_before": 120,
            "stock_after": 119,
            "reference": "ADJ",
            "note": "Barang rusak",
            "user_id": 15,
            "created_at": "2026-11-13T07:18:34+07:00",
            "product": {
                "id": 45,
                "name": "Beras Premium 5kg",
                "sku": "TOK0001",
                "image_url": null,
                "is_low_stock": true
            },
            "user": {
                "id": 15,
                "name": "Budi Santoso"
            }
        },
        {
            "id": 6514,
            "product_id": 45,
            "type": "purchase",
            "qty": 10,
            "stock_before": 110,
            "stock_after": 120,
            "reference": "PB-261113-0001",
            "note": "Faktur #123",
            "user_id": 15,
            "created_at": "2026-11-13T07:18:34+07:00",
            "product": {
                "id": 45,
                "name": "Beras Premium 5kg",
                "sku": "TOK0001",
                "image_url": null,
                "is_low_stock": true
            },
            "user": {
                "id": 15,
                "name": "Budi Santoso"
            }
        },
        {
            "id": 6513,
            "product_id": 87,
            "type": "initial",
            "qty": 20,
            "stock_before": 0,
            "stock_after": 20,
            "reference": "AWAL",
            "note": "Stok awal produk",
            "user_id": 15,
            "created_at": "2026-11-13T07:18:34+07:00",
            "product": {
                "id": 87,
                "name": "Kopi Bubuk 200g",
                "sku": "KOPI200",
                "image_url": null,
                "is_low_stock": true
            },
            "user": {
                "id": 15,
                "name": "Budi Santoso"
            }
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 1499,
        "last_page": 100
    }
}
Coba langsung

                                
GET /stock/lowProduk stok menipis Owner

Produk aktif dengan stock <= min_stock, diurutkan dari stok terkecil.

URL: GET https://belajar-api.unama.ac.id/api/kasir/stock/low
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/stock/low?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Produk dengan stok di bawah atau sama dengan stok minimum",
    "data": [
        {
            "id": 62,
            "category_id": 28,
            "unit_id": 33,
            "sku": "TOK0018",
            "barcode": "8990000007018",
            "name": "Deterjen 800g",
            "description": null,
            "cost_price": 17000,
            "price": 21000,
            "stock": 3,
            "min_stock": 11,
            "image": "demo/toko-berkah-jaya/TOK0018.jpg",
            "is_active": true,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:31+07:00",
            "image_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/TOK0018.jpg",
            "is_low_stock": true,
            "unit": {
                "id": 33,
                "name": "pcs"
            }
        },
        {
            "id": 58,
            "category_id": 27,
            "unit_id": 33,
            "sku": "TOK0014",
            "barcode": "8990000007014",
            "name": "Wafer Coklat",
            "description": null,
            "cost_price": 4000,
            "price": 6000,
            "stock": 4,
            "min_stock": 11,
            "image": "demo/toko-berkah-jaya/TOK0014.jpg",
            "is_active": true,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:31+07:00",
            "image_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/TOK0014.jpg",
            "is_low_stock": true,
            "unit": {
                "id": 33,
                "name": "pcs"
            }
        },
        {
            "id": 60,
            "category_id": 28,
            "unit_id": 33,
            "sku": "TOK0016",
            "barcode": "8990000007016",
            "name": "Sabun Mandi",
            "description": null,
            "cost_price": 3000,
            "price": 4500,
            "stock": 10,
            "min_stock": 12,
            "image": "demo/toko-berkah-jaya/TOK0016.jpg",
            "is_active": true,
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T06:12:31+07:00",
            "image_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/TOK0016.jpg",
            "is_low_stock": true,
            "unit": {
                "id": 33,
                "name": "pcs"
            }
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 3,
        "last_page": 1
    }
}
Coba langsung

                                

Pelanggan

Data pelanggan per toko beserta poin. Kasir dapat menambah & mengubah; menghapus khusus owner.

GET /customersDaftar & cari pelanggan OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/customers
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
qstringopsional Cari nama/kode/HP/email
sortstringopsional name atau -points
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/customers?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 25,
            "code": "PLG00001",
            "name": "Andi Pratama",
            "phone": "081200000001",
            "email": "[email protected]",
            "address": "Jambi",
            "points": 172,
            "is_active": true,
            "created_at": "2026-11-13T06:12:13+07:00",
            "updated_at": "2026-11-13T03:13:07+07:00",
            "sales_count": 30,
            "has_account": true
        },
        {
            "id": 26,
            "code": "PLG00026",
            "name": "Bambang Wijaya",
            "phone": "081300000700",
            "email": null,
            "address": null,
            "points": 172,
            "is_active": true,
            "created_at": "2026-11-13T06:12:13+07:00",
            "updated_at": "2026-11-12T19:02:42+07:00",
            "sales_count": 26,
            "has_account": false
        },
        {
            "id": 27,
            "code": "PLG00027",
            "name": "Citra Kirana",
            "phone": "081300000701",
            "email": null,
            "address": null,
            "points": 219,
            "is_active": true,
            "created_at": "2026-11-13T06:12:13+07:00",
            "updated_at": "2026-11-12T12:16:36+07:00",
            "sales_count": 28,
            "has_account": false
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 9,
        "last_page": 1
    }
}
Coba langsung

                                
POST /customersTambah pelanggan OwnerKasir

Kode pelanggan dibuat otomatis (PLG00001).

URL: POST https://belajar-api.unama.ac.id/api/kasir/customers
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
namestringwajib NamaPelanggan Baru
phonestringopsional Nomor HP081311112222
emailstringopsional Email (unik per toko)
addressstringopsional Alamat
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/customers" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Pelanggan Baru","phone":"081311112222"}'
Contoh response 201
{
    "success": true,
    "message": "Pelanggan berhasil ditambahkan",
    "data": {
        "id": 48,
        "code": "PLG00034",
        "name": "Pelanggan Baru",
        "phone": "081311112222",
        "email": null,
        "address": null,
        "points": 0,
        "is_active": true,
        "created_at": "2026-11-13T07:18:35+07:00",
        "updated_at": "2026-11-13T07:18:35+07:00",
        "has_account": false
    },
    "meta": null
}
Coba langsung

                                
GET /customers/{id}Detail pelanggan (+ total belanja) OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/customers/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID pelanggan25
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/customers/25" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 25,
        "code": "PLG00001",
        "name": "Andi Pratama",
        "phone": "081200000001",
        "email": "[email protected]",
        "address": "Jambi",
        "points": 172,
        "is_active": true,
        "created_at": "2026-11-13T06:12:13+07:00",
        "updated_at": "2026-11-13T03:13:07+07:00",
        "sales_count": 30,
        "total_spent": 1878000,
        "has_account": true
    },
    "meta": null
}
Coba langsung

                                
PUT /customers/{id}Ubah pelanggan OwnerKasir
URL: PUT https://belajar-api.unama.ac.id/api/kasir/customers/{id}
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID pelanggan25
Body
NamaTipeWajibKeteranganContoh
namestringopsional Nama
phonestringopsional HP
emailstringopsional Email
addressstringopsional AlamatJl. Baru
is_activebooleanopsional Aktif?
Contoh request (curl)
curl -X PUT "https://belajar-api.unama.ac.id/api/kasir/customers/25" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"address":"Jl. Baru"}'
Contoh response 200
{
    "success": true,
    "message": "Pelanggan diperbarui",
    "data": {
        "id": 25,
        "code": "PLG00001",
        "name": "Andi Pratama",
        "phone": "081200000001",
        "email": "[email protected]",
        "address": "Jl. Baru",
        "points": 172,
        "is_active": true,
        "created_at": "2026-11-13T06:12:13+07:00",
        "updated_at": "2026-11-13T07:18:35+07:00",
        "has_account": true
    },
    "meta": null
}
Coba langsung

                                
GET /customers/{id}/salesRiwayat belanja pelanggan OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/customers/{id}/sales
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID pelanggan25
Query string
NamaTipeWajibKeteranganContoh
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/customers/25/sales?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 1867,
            "number": "INV-261113-0008",
            "status": "paid",
            "sold_at": "2026-11-13T04:35:45+07:00",
            "cashier": {
                "id": 17,
                "name": "Rudi Hartono"
            },
            "customer": null,
            "subtotal": 3500,
            "item_discount": 0,
            "discount": 0,
            "tax_percent": 0,
            "tax": 0,
            "total": 3500,
            "paid": 5000,
            "change": 1500,
            "payment_method": "cash",
            "payment_ref": null,
            "points_earned": 0,
            "note": null,
            "void_reason": null,
            "voided_at": null
        },
        {
            "id": 1865,
            "number": "INV-261113-0006",
            "status": "paid",
            "sold_at": "2026-11-13T03:13:07+07:00",
            "cashier": {
                "id": 17,
                "name": "Rudi Hartono"
            },
            "customer": null,
            "subtotal": 80500,
            "item_discount": 0,
            "discount": 0,
            "tax_percent": 0,
            "tax": 0,
            "total": 80500,
            "paid": 85000,
            "change": 4500,
            "payment_method": "cash",
            "payment_ref": null,
            "points_earned": 8,
            "note": null,
            "void_reason": null,
            "voided_at": null
        },
        {
            "id": 1854,
            "number": "INV-261112-0016",
            "status": "paid",
            "sold_at": "2026-11-12T18:39:04+07:00",
            "cashier": {
                "id": 15,
                "name": "Budi Santoso"
            },
            "customer": null,
            "subtotal": 37500,
            "item_discount": 0,
            "discount": 0,
            "tax_percent": 0,
            "tax": 0,
            "total": 37500,
            "paid": 37500,
            "change": 0,
            "payment_method": "transfer",
            "payment_ref": "TRANSFER-190411",
            "points_earned": 3,
            "note": null,
            "void_reason": null,
            "voided_at": null
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 30,
        "last_page": 2
    }
}
Coba langsung

                                
DELETE /customers/{id}Hapus pelanggan Owner

Pelanggan yang sudah punya transaksi tidak dapat dihapus (422).

URL: DELETE https://belajar-api.unama.ac.id/api/kasir/customers/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID pelanggan25
Contoh request (curl)
curl -X DELETE "https://belajar-api.unama.ac.id/api/kasir/customers/25" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Contoh response 422
{
    "success": false,
    "message": "Pelanggan sudah memiliki transaksi, tidak dapat dihapus. Nonaktifkan saja.",
    "data": null,
    "meta": null
}
Coba langsung

                                

Transaksi (POS)

Penjualan kasir. Disimpan dalam satu DB transaction dengan baris produk dikunci (SELECT ... FOR UPDATE) sehingga stok tidak bisa minus walau dua kasir menjual bersamaan. Nomor nota otomatis per toko: INV-yymmdd-0001. Kasir hanya melihat transaksinya sendiri.

POST /salesSimpan transaksi OwnerKasir

Perhitungan: subtotal = Σ harga×qty; dikurangi diskon item & discount nota; lalu tax = pajak toko (%); total = setelah pajak. Tunai wajib paid ≥ total (kembalian dihitung). Non-tunai: paid boleh kosong (= total). Pelanggan mendapat poin floor(total / point_rate). Transaksi otomatis masuk ke shift kasir yang sedang terbuka.

URL: POST https://belajar-api.unama.ac.id/api/kasir/sales
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
itemsarraywajib Item: [{product_id, qty, discount?}] — discount = potongan nominal per baris[{"product_id":45,"qty":1},{"product_id":46,"qty":2,"discount":500}]
payment_methodstringwajib cash, transfer, qris, ewalletcash
paidnumberopsional Uang dibayar (wajib untuk tunai)200000
discountnumberopsional Diskon nota (nominal)0
customer_idintegeropsional ID pelanggan (dapat poin)25
payment_refstringopsional No. referensi transfer/QRIS
notestringopsional Catatan
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/sales" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"product_id":45,"qty":1},{"product_id":46,"qty":2,"discount":500}],"payment_method":"cash","paid":200000,"discount":0,"customer_id":25}'
Contoh response 201
{
    "success": true,
    "message": "Transaksi berhasil disimpan",
    "data": {
        "id": 2610,
        "number": "INV-261113-0011",
        "status": "paid",
        "sold_at": "2026-11-13T07:18:35+07:00",
        "cashier": {
            "id": 15,
            "name": "Budi Santoso"
        },
        "customer": {
            "id": 25,
            "code": "PLG00001",
            "name": "Andi Pratama"
        },
        "subtotal": 146000,
        "item_discount": 500,
        "discount": 0,
        "tax_percent": 0,
        "tax": 0,
        "total": 145500,
        "paid": 200000,
        "change": 54500,
        "payment_method": "cash",
        "payment_ref": null,
        "points_earned": 14,
        "note": null,
        "void_reason": null,
        "voided_at": null,
        "items": [
            {
                "product_id": 45,
                "sku": "TOK0001",
                "name": "Beras Premium 5kg",
                "qty": 1,
                "price": 73000,
                "discount": 0,
                "subtotal": 73000
            },
            {
                "product_id": 46,
                "sku": "TOK0002",
                "name": "Minyak Goreng 2L",
                "qty": 2,
                "price": 36500,
                "discount": 500,
                "subtotal": 72500
            }
        ],
        "receipt_url": "http://localhost/kasir/penjualan/2610/struk"
    },
    "meta": null
}
Coba langsung

                                
GET /salesDaftar transaksi OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/sales
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
qstringopsional Cari nomor nota
statusstringopsional paid atau void
payment_methodstringopsional Filter metode bayar
user_idintegeropsional Filter kasir (owner)
customer_idintegeropsional Filter pelanggan
fromdateopsional Dari tanggal
todateopsional Sampai tanggal
formatstringopsional csv untuk unduh
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/sales?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 2610,
            "number": "INV-261113-0011",
            "status": "paid",
            "sold_at": "2026-11-13T07:18:35+07:00",
            "cashier": {
                "id": 15,
                "name": "Budi Santoso"
            },
            "customer": {
                "id": 25,
                "code": "PLG00001",
                "name": "Andi Pratama"
            },
            "subtotal": 146000,
            "item_discount": 500,
            "discount": 0,
            "tax_percent": 0,
            "tax": 0,
            "total": 145500,
            "paid": 200000,
            "change": 54500,
            "payment_method": "cash",
            "payment_ref": null,
            "points_earned": 14,
            "note": null,
            "void_reason": null,
            "voided_at": null
        },
        {
            "id": 1869,
            "number": "INV-261113-0010",
            "status": "paid",
            "sold_at": "2026-11-13T05:55:24+07:00",
            "cashier": {
                "id": 16,
                "name": "Siti Aminah"
            },
            "customer": null,
            "subtotal": 51000,
            "item_discount": 0,
            "discount": 0,
            "tax_percent": 0,
            "tax": 0,
            "total": 51000,
            "paid": 55000,
            "change": 4000,
            "payment_method": "cash",
            "payment_ref": null,
            "points_earned": 0,
            "note": null,
            "void_reason": null,
            "voided_at": null
        },
        {
            "id": 1868,
            "number": "INV-261113-0009",
            "status": "paid",
            "sold_at": "2026-11-13T05:28:10+07:00",
            "cashier": {
                "id": 15,
                "name": "Budi Santoso"
            },
            "customer": null,
            "subtotal": 53500,
            "item_discount": 0,
            "discount": 0,
            "tax_percent": 0,
            "tax": 0,
            "total": 53500,
            "paid": 55000,
            "change": 1500,
            "payment_method": "cash",
            "payment_ref": null,
            "points_earned": 0,
            "note": null,
            "void_reason": null,
            "voided_at": null
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 607,
        "last_page": 41,
        "summary": {
            "paid_transactions": 605,
            "paid_total": 38429700
        }
    }
}
Coba langsung

                                
GET /sales/{id}Detail transaksi + item OwnerKasir

receipt_url = halaman struk cetak (thermal 58/80mm) di web (butuh login web).

URL: GET https://belajar-api.unama.ac.id/api/kasir/sales/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID transaksi2614
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/sales/2614" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 1869,
        "number": "INV-261113-0010",
        "status": "paid",
        "sold_at": "2026-11-13T05:55:24+07:00",
        "cashier": {
            "id": 16,
            "name": "Siti Aminah"
        },
        "customer": null,
        "subtotal": 51000,
        "item_discount": 0,
        "discount": 0,
        "tax_percent": 0,
        "tax": 0,
        "total": 51000,
        "paid": 55000,
        "change": 4000,
        "payment_method": "cash",
        "payment_ref": null,
        "points_earned": 0,
        "note": null,
        "void_reason": null,
        "voided_at": null,
        "items": [
            {
                "product_id": 47,
                "sku": "TOK0003",
                "name": "Gula Pasir 1kg",
                "qty": 3,
                "price": 17000,
                "discount": 0,
                "subtotal": 51000
            }
        ],
        "receipt_url": "http://localhost/kasir/penjualan/1869/struk"
    },
    "meta": null
}
Coba langsung

                                
POST /sales/{id}/voidBatalkan (void) transaksi Owner

Stok seluruh item dikembalikan (mutasi tipe void) dan poin pelanggan ditarik. Transaksi void tidak dihitung di laporan.

URL: POST https://belajar-api.unama.ac.id/api/kasir/sales/{id}/void
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID transaksi2614
Body
NamaTipeWajibKeteranganContoh
reasonstringwajib Alasan pembatalanSalah input
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/sales/2614/void" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Salah input"}'
Contoh response 200
{
    "success": true,
    "message": "Transaksi dibatalkan, stok dikembalikan",
    "data": {
        "id": 1869,
        "number": "INV-261113-0010",
        "status": "void",
        "sold_at": "2026-11-13T05:55:24+07:00",
        "cashier": {
            "id": 16,
            "name": "Siti Aminah"
        },
        "customer": null,
        "subtotal": 51000,
        "item_discount": 0,
        "discount": 0,
        "tax_percent": 0,
        "tax": 0,
        "total": 51000,
        "paid": 55000,
        "change": 4000,
        "payment_method": "cash",
        "payment_ref": null,
        "points_earned": 0,
        "note": null,
        "void_reason": "Salah input",
        "voided_at": "2026-11-13T07:18:35+07:00",
        "items": [
            {
                "product_id": 47,
                "sku": "TOK0003",
                "name": "Gula Pasir 1kg",
                "qty": 3,
                "price": 17000,
                "discount": 0,
                "subtotal": 51000
            }
        ],
        "receipt_url": "http://localhost/kasir/penjualan/1869/struk"
    },
    "meta": null
}
Coba langsung

                                

Shift Kasir

Opsional: buka kas dengan saldo awal, lalu tutup kas dengan saldo akhir. Sistem menghitung kas seharusnya (saldo awal + penjualan tunai pada shift) dan selisihnya.

GET /shifts/currentShift yang sedang terbuka + ringkasan OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/shifts/current
Header: Accept: application/json · Authorization: Bearer {token}
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/shifts/current" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Tidak ada shift terbuka",
    "data": null,
    "meta": null
}
Coba langsung

                                
POST /shifts/openBuka shift OwnerKasir
URL: POST https://belajar-api.unama.ac.id/api/kasir/shifts/open
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
opening_cashnumberwajib Saldo kas awal200000
notestringopsional CatatanShift pagi
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/shifts/open" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"opening_cash":200000,"note":"Shift pagi"}'
Contoh response 201
{
    "success": true,
    "message": "Shift dibuka",
    "data": {
        "user_id": 15,
        "opened_at": "2026-11-13T07:18:35+07:00",
        "opening_cash": 200000,
        "note": "Shift pagi",
        "status": "open",
        "updated_at": "2026-11-13T07:18:35+07:00",
        "created_at": "2026-11-13T07:18:35+07:00",
        "id": 12
    },
    "meta": null
}
Coba langsung

                                
POST /shifts/closeTutup shift OwnerKasir
URL: POST https://belajar-api.unama.ac.id/api/kasir/shifts/close
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Body
NamaTipeWajibKeteranganContoh
closing_cashnumberwajib Uang di laci saat tutup850000
notestringopsional Catatan
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/shifts/close" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"closing_cash":850000}'
Contoh response 200
{
    "success": true,
    "message": "Shift ditutup",
    "data": {
        "id": 12,
        "user_id": 15,
        "opened_at": "2026-11-13T07:18:35+07:00",
        "closed_at": "2026-11-13T07:18:35+07:00",
        "opening_cash": 200000,
        "cash_sales": 0,
        "expected_cash": 200000,
        "closing_cash": 850000,
        "difference": 650000,
        "note": "Shift pagi",
        "status": "closed",
        "created_at": "2026-11-13T07:18:35+07:00",
        "updated_at": "2026-11-13T07:18:35+07:00",
        "user": {
            "id": 15,
            "tenant_id": 7,
            "name": "Budi Santoso",
            "email": "[email protected]",
            "phone": "081234567890",
            "role": "owner",
            "is_active": true,
            "last_login_at": "2026-11-13T07:18:34+07:00",
            "created_at": "2026-11-13T06:12:12+07:00",
            "updated_at": "2026-11-13T07:18:34+07:00"
        }
    },
    "meta": null
}
Coba langsung

                                
GET /shiftsRiwayat shift OwnerKasir
URL: GET https://belajar-api.unama.ac.id/api/kasir/shifts
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
user_idintegeropsional Filter kasir (owner)
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/shifts?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 12,
            "user_id": 15,
            "opened_at": "2026-11-13T07:18:35+07:00",
            "closed_at": "2026-11-13T07:18:35+07:00",
            "opening_cash": 200000,
            "cash_sales": 0,
            "expected_cash": 200000,
            "closing_cash": 850000,
            "difference": 650000,
            "note": "Shift pagi",
            "status": "closed",
            "created_at": "2026-11-13T07:18:35+07:00",
            "updated_at": "2026-11-13T07:18:35+07:00",
            "user": {
                "id": 15,
                "name": "Budi Santoso"
            }
        },
        {
            "id": 7,
            "user_id": 16,
            "opened_at": "2026-11-13T06:12:31+07:00",
            "closed_at": null,
            "opening_cash": 200000,
            "cash_sales": 0,
            "expected_cash": 0,
            "closing_cash": null,
            "difference": null,
            "note": "Shift pagi (data demo)",
            "status": "open",
            "created_at": "2026-11-13T06:12:31+07:00",
            "updated_at": "2026-11-13T06:12:31+07:00",
            "user": {
                "id": 16,
                "name": "Siti Aminah"
            }
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 2,
        "last_page": 1
    }
}
Coba langsung

                                

Laporan

Laporan khusus owner. Hanya transaksi berstatus paid. Laba kotor = penjualan bersih (setelah diskon, sebelum pajak) − HPP (harga beli saat transaksi). Tambahkan format=csv untuk mengunduh CSV (pemisah ;, siap dibuka Excel).

GET /reports/dashboardDashboard (hari ini, bulan ini, grafik 7/30 hari, terlaris) Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/reports/dashboard
Header: Accept: application/json · Authorization: Bearer {token}
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/reports/dashboard" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "today": {
            "from": "2026-11-13",
            "to": "2026-11-13",
            "transactions": 10,
            "items_sold": 39,
            "gross_sales": 617500,
            "discount": 500,
            "net_sales": 617000,
            "tax": 0,
            "omzet": 617000,
            "cost": 505100,
            "gross_profit": 111900,
            "margin_percent": 18.1,
            "average_ticket": 61700,
            "void_count": 1
        },
        "yesterday": {
            "from": "2026-11-12",
            "to": "2026-11-12",
            "transactions": 21,
            "items_sold": 104,
            "gross_sales": 1319500,
            "discount": 2500,
            "net_sales": 1317000,
            "tax": 0,
            "omzet": 1317000,
            "cost": 1059300,
            "gross_profit": 257700,
            "margin_percent": 19.6,
            "average_ticket": 62714,
            "void_count": 0
        },
        "month": {
            "from": "2026-11-01",
            "to": "2026-11-13",
            "transactions": 256,
            "items_sold": 1211,
            "gross_sales": 15281500,
            "discount": 48000,
            "net_sales": 15233500,
            "tax": 0,
            "omzet": 15233500,
            "cost": 12243400,
            "gross_profit": 2990100,
            "margin_percent": 19.6,
            "average_ticket": 59506,
            "void_count": 2
        },
        "last_7_days": [
            {
                "date": "2026-11-07",
                "transactions": 28,
                "omzet": 2272600,
                "net_sales": 2272600,
                "cost": 1807700,
                "gross_profit": 464900
            },
            {
                "date": "2026-11-08",
                "transactions": 28,
                "omzet": 1324300,
                "net_sales": 1324300,
                "cost": 1069700,
                "gross_profit": 254600
            }
        ],
        "last_30_days": [
            {
                "date": "2026-10-15",
                "transactions": 22,
                "omzet": 1387500,
                "net_sales": 1387500,
                "cost": 1129300,
                "gross_profit": 258200
            },
            {
                "date": "2026-10-16",
                "transactions": 21,
                "omzet": 1202100,
                "net_sales": 1202100,
                "cost": 961600,
                "gross_profit": 240500
            }
        ],
        "top_products": [
            {
                "product_id": 62,
                "sku": "TOK0018",
                "name": "Deterjen 800g",
                "qty": 158,
                "transactions": 80,
                "revenue": 3313000,
                "cost": 2686000,
                "gross_profit": 627000
            },
            {
                "product_id": 60,
                "sku": "TOK0016",
                "name": "Sabun Mandi",
                "qty": 155,
                "transactions": 75,
                "revenue": 692500,
                "cost": 465000,
                "gross_profit": 227500
            }
        ],
        "low_stock": [
            {
                "id": 62,
                "sku": "TOK0018",
                "name": "Deterjen 800g",
                "stock": 3,
                "min_stock": 11,
                "image_url": null,
                "is_low_stock": true
            },
            {
                "id": 58,
                "sku": "TOK0014",
                "name": "Wafer Coklat",
                "stock": 4,
                "min_stock": 11,
                "image_url": null,
                "is_low_stock": true
            },
            {
                "id": 60,
                "sku": "TOK0016",
                "name": "Sabun Mandi",
                "stock": 10,
                "min_stock": 12,
                "image_url": null,
                "is_low_stock": true
            }
        ],
        "low_stock_count": 3
    },
    "meta": null
}
Coba langsung

                                
GET /reports/summaryRingkasan periode Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/reports/summary
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
fromdateopsional Tanggal awal (YYYY-MM-DD). Default awal bulan ini2026-11-01
todateopsional Tanggal akhir (YYYY-MM-DD). Default hari ini2026-11-23
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/reports/summary?from=2026-11-01&to=2026-11-23" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Ringkasan penjualan",
    "data": {
        "from": "2026-11-01",
        "to": "2026-11-13",
        "transactions": 256,
        "items_sold": 1211,
        "gross_sales": 15281500,
        "discount": 48000,
        "net_sales": 15233500,
        "tax": 0,
        "omzet": 15233500,
        "cost": 12243400,
        "gross_profit": 2990100,
        "margin_percent": 19.6,
        "average_ticket": 59506,
        "void_count": 2
    },
    "meta": {
        "from": "2026-11-01",
        "to": "2026-11-13"
    }
}
Coba langsung

                                
GET /reports/dailyPenjualan & laba per hari Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/reports/daily
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
fromdateopsional Tanggal awal (YYYY-MM-DD). Default awal bulan ini2026-11-01
todateopsional Tanggal akhir (YYYY-MM-DD). Default hari ini2026-11-23
formatstringopsional json (default) atau csv untuk mengunduh file CSVjson
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/reports/daily?from=2026-11-01&to=2026-11-23&format=json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "date": "2026-11-01",
            "transactions": 22,
            "omzet": 774500,
            "net_sales": 774500,
            "cost": 617200,
            "gross_profit": 157300
        },
        {
            "date": "2026-11-02",
            "transactions": 21,
            "omzet": 1708500,
            "net_sales": 1708500,
            "cost": 1413200,
            "gross_profit": 295300
        },
        {
            "date": "2026-11-03",
            "transactions": 19,
            "omzet": 918700,
            "net_sales": 918700,
            "cost": 719800,
            "gross_profit": 198900
        }
    ],
    "meta": {
        "from": "2026-11-01",
        "to": "2026-11-13",
        "summary": {
            "from": "2026-11-01",
            "to": "2026-11-13",
            "transactions": 256,
            "items_sold": 1211,
            "gross_sales": 15281500,
            "discount": 48000,
            "net_sales": 15233500,
            "tax": 0,
            "omzet": 15233500,
            "cost": 12243400,
            "gross_profit": 2990100,
            "margin_percent": 19.6,
            "average_ticket": 59506,
            "void_count": 2
        }
    }
}
Coba langsung

                                
GET /reports/productsPenjualan per produk Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/reports/products
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
fromdateopsional Tanggal awal (YYYY-MM-DD). Default awal bulan ini2026-11-01
todateopsional Tanggal akhir (YYYY-MM-DD). Default hari ini2026-11-23
formatstringopsional json (default) atau csv untuk mengunduh file CSVjson
sortstringopsional qty (default) atau revenueqty
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/reports/products?from=2026-11-01&to=2026-11-23&format=json&sort=qty" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "product_id": 59,
            "sku": "TOK0015",
            "name": "Kacang Atom",
            "qty": 81,
            "transactions": 39,
            "revenue": 768500,
            "cost": 567000,
            "gross_profit": 201500
        },
        {
            "product_id": 60,
            "sku": "TOK0016",
            "name": "Sabun Mandi",
            "qty": 70,
            "transactions": 33,
            "revenue": 311500,
            "cost": 210000,
            "gross_profit": 101500
        },
        {
            "product_id": 53,
            "sku": "TOK0009",
            "name": "Kopi Sachet",
            "qty": 68,
            "transactions": 35,
            "revenue": 134000,
            "cost": 81600,
            "gross_profit": 52400
        }
    ],
    "meta": {
        "from": "2026-11-01",
        "to": "2026-11-13",
        "summary": {
            "from": "2026-11-01",
            "to": "2026-11-13",
            "transactions": 256,
            "items_sold": 1211,
            "gross_sales": 15281500,
            "discount": 48000,
            "net_sales": 15233500,
            "tax": 0,
            "omzet": 15233500,
            "cost": 12243400,
            "gross_profit": 2990100,
            "margin_percent": 19.6,
            "average_ticket": 59506,
            "void_count": 2
        }
    }
}
Coba langsung

                                
GET /reports/cashiersPenjualan per kasir Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/reports/cashiers
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
fromdateopsional Tanggal awal (YYYY-MM-DD). Default awal bulan ini2026-11-01
todateopsional Tanggal akhir (YYYY-MM-DD). Default hari ini2026-11-23
formatstringopsional json (default) atau csv untuk mengunduh file CSVjson
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/reports/cashiers?from=2026-11-01&to=2026-11-23&format=json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "user_id": 15,
            "name": "Budi Santoso",
            "transactions": 95,
            "omzet": 5715400,
            "gross_profit": 1114800,
            "average_ticket": 60162
        },
        {
            "user_id": 16,
            "name": "Siti Aminah",
            "transactions": 86,
            "omzet": 4972200,
            "gross_profit": 993400,
            "average_ticket": 57816
        },
        {
            "user_id": 17,
            "name": "Rudi Hartono",
            "transactions": 75,
            "omzet": 4545900,
            "gross_profit": 881900,
            "average_ticket": 60612
        }
    ],
    "meta": {
        "from": "2026-11-01",
        "to": "2026-11-13",
        "summary": {
            "from": "2026-11-01",
            "to": "2026-11-13",
            "transactions": 256,
            "items_sold": 1211,
            "gross_sales": 15281500,
            "discount": 48000,
            "net_sales": 15233500,
            "tax": 0,
            "omzet": 15233500,
            "cost": 12243400,
            "gross_profit": 2990100,
            "margin_percent": 19.6,
            "average_ticket": 59506,
            "void_count": 2
        }
    }
}
Coba langsung

                                
GET /reports/paymentsPenjualan per metode bayar Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/reports/payments
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
fromdateopsional Tanggal awal (YYYY-MM-DD). Default awal bulan ini2026-11-01
todateopsional Tanggal akhir (YYYY-MM-DD). Default hari ini2026-11-23
formatstringopsional json (default) atau csv untuk mengunduh file CSVjson
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/reports/payments?from=2026-11-01&to=2026-11-23&format=json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "method": "cash",
            "label": "Tunai",
            "transactions": 125,
            "omzet": 7319300,
            "percent": 48
        },
        {
            "method": "transfer",
            "label": "Transfer",
            "transactions": 30,
            "omzet": 1858000,
            "percent": 12.2
        },
        {
            "method": "qris",
            "label": "QRIS",
            "transactions": 82,
            "omzet": 4877000,
            "percent": 32
        }
    ],
    "meta": {
        "from": "2026-11-01",
        "to": "2026-11-13",
        "summary": {
            "from": "2026-11-01",
            "to": "2026-11-13",
            "transactions": 256,
            "items_sold": 1211,
            "gross_sales": 15281500,
            "discount": 48000,
            "net_sales": 15233500,
            "tax": 0,
            "omzet": 15233500,
            "cost": 12243400,
            "gross_profit": 2990100,
            "margin_percent": 19.6,
            "average_ticket": 59506,
            "void_count": 2
        }
    }
}
Coba langsung

                                
GET /reports/profitLaba kotor per hari Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/reports/profit
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
fromdateopsional Tanggal awal (YYYY-MM-DD). Default awal bulan ini2026-11-01
todateopsional Tanggal akhir (YYYY-MM-DD). Default hari ini2026-11-23
formatstringopsional json (default) atau csv untuk mengunduh file CSVjson
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/reports/profit?from=2026-11-01&to=2026-11-23&format=json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "date": "2026-11-01",
            "transactions": 22,
            "omzet": 774500,
            "net_sales": 774500,
            "cost": 617200,
            "gross_profit": 157300
        },
        {
            "date": "2026-11-02",
            "transactions": 21,
            "omzet": 1708500,
            "net_sales": 1708500,
            "cost": 1413200,
            "gross_profit": 295300
        },
        {
            "date": "2026-11-03",
            "transactions": 19,
            "omzet": 918700,
            "net_sales": 918700,
            "cost": 719800,
            "gross_profit": 198900
        }
    ],
    "meta": {
        "from": "2026-11-01",
        "to": "2026-11-13",
        "summary": {
            "from": "2026-11-01",
            "to": "2026-11-13",
            "transactions": 256,
            "items_sold": 1211,
            "gross_sales": 15281500,
            "discount": 48000,
            "net_sales": 15233500,
            "tax": 0,
            "omzet": 15233500,
            "cost": 12243400,
            "gross_profit": 2990100,
            "margin_percent": 19.6,
            "average_ticket": 59506,
            "void_count": 2
        }
    }
}
Coba langsung

                                
GET /reports/stockLaporan stok & nilai persediaan Owner
URL: GET https://belajar-api.unama.ac.id/api/kasir/reports/stock
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
filterstringopsional low (menipis) atau empty (habis)
formatstringopsional json atau csv
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/reports/stock" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 51,
            "sku": "TOK0007",
            "name": "Air Mineral 600ml",
            "category": "Minuman",
            "unit": "pcs",
            "stock": 119,
            "min_stock": 9,
            "is_low_stock": false,
            "cost_price": 2500,
            "price": 4000,
            "stock_value_cost": 297500,
            "stock_value_price": 476000
        },
        {
            "id": 45,
            "sku": "TOK0001",
            "name": "Beras Premium 5kg",
            "category": "Frozen Food (ubah)",
            "unit": "lusin (ubah)",
            "stock": 118,
            "min_stock": 15,
            "is_low_stock": false,
            "cost_price": 62000,
            "price": 73000,
            "stock_value_cost": 7316000,
            "stock_value_price": 8614000
        },
        {
            "id": 57,
            "sku": "TOK0013",
            "name": "Biskuit Kelapa",
            "category": "Makanan Ringan",
            "unit": "pcs",
            "stock": 286,
            "min_stock": 11,
            "is_low_stock": false,
            "cost_price": 6000,
            "price": 8500,
            "stock_value_cost": 1716000,
            "stock_value_price": 2431000
        }
    ],
    "meta": {
        "from": "2026-11-01",
        "to": "2026-11-13",
        "totals": {
            "products": 24,
            "units": 3056,
            "low_stock": 3,
            "stock_value_cost": 33316600,
            "stock_value_price": 41684100
        }
    }
}
Coba langsung

                                

Portal Pelanggan

Pelanggan mendaftar sendiri di toko tertentu (berdasarkan slug) lalu melihat riwayat belanja & poin. Token pelanggan hanya berlaku untuk toko tersebut. Jika email & nomor HP sama dengan data yang sudah dicatat kasir, akun dihubungkan ke data itu.

GET /t/{slug}Info publik toko Publik
URL: GET https://belajar-api.unama.ac.id/api/kasir/t/{slug}
Header: Accept: application/json
Parameter path
NamaTipeWajibKeteranganContoh
slugstringwajib Slug tokotoko-berkah-jaya
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/t/toko-berkah-jaya" \
  -H "Accept: application/json"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "name": "Toko Berkah Jaya",
        "slug": "toko-berkah-jaya",
        "address": "Jl. Kapten Pattimura No. 10, Jambi",
        "phone": "0741-123456",
        "email": "[email protected]",
        "logo_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/logo.png",
        "store_url": "http://localhost/kasir/t/toko-berkah-jaya",
        "point_rate": 10000
    },
    "meta": null
}
Coba langsung

                                
POST /t/{slug}/customer/registerDaftar akun pelanggan Publik
URL: POST https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/register
Header: Accept: application/json · Content-Type: application/json
Parameter path
NamaTipeWajibKeteranganContoh
slugstringwajib Slug tokotoko-berkah-jaya
Body
NamaTipeWajibKeteranganContoh
namestringwajib NamaPelanggan Setia
emailstringwajib Email (unik per toko)[email protected]
phonestringwajib Nomor HP081377778888
passwordstringwajib Password (min 6)rahasia123
password_confirmationstringwajib Ulangi passwordrahasia123
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/t/toko-berkah-jaya/customer/register" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":"Pelanggan Setia","email":"[email protected]","phone":"081377778888","password":"rahasia123","password_confirmation":"rahasia123"}'
Contoh response 201
{
    "success": true,
    "message": "Pendaftaran pelanggan berhasil",
    "data": {
        "customer": {
            "id": 49,
            "code": "PLG00049",
            "name": "Pelanggan Setia",
            "email": "[email protected]",
            "phone": "081377778888",
            "address": null,
            "points": null,
            "transactions": 0,
            "total_spent": 0
        },
        "token": {
            "access_token": "52|EOOLRFsnRe4ZD0TLkGmYrueBc3B6gnvMPfqiQLpbJY9nGX3v",
            "token_type": "Bearer",
            "expires_at": "2026-12-13T07:18:35+07:00"
        }
    },
    "meta": null
}
Coba langsung

                                
POST /t/{slug}/customer/loginLogin pelanggan Publik
URL: POST https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/login
Header: Accept: application/json · Content-Type: application/json
Parameter path
NamaTipeWajibKeteranganContoh
slugstringwajib Slug tokotoko-berkah-jaya
Body
NamaTipeWajibKeteranganContoh
emailstringwajib Email[email protected]
passwordstringwajib Passwordpassword
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/t/toko-berkah-jaya/customer/login" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"password"}'
Contoh response 200
{
    "success": true,
    "message": "Login berhasil",
    "data": {
        "customer": {
            "id": 25,
            "code": "PLG00001",
            "name": "Andi Pratama",
            "email": "[email protected]",
            "phone": "081200000001",
            "address": "Jl. Baru",
            "points": 186,
            "transactions": 31,
            "total_spent": 2023500
        },
        "token": {
            "access_token": "53|4tnMeuYzJeV4EkOLiwnYt6bOaCTVXjnEvakx9vzEyXMI8eb2",
            "token_type": "Bearer",
            "expires_at": "2026-12-13T07:18:36+07:00"
        }
    },
    "meta": null
}
Coba langsung

                                
GET /t/{slug}/customer/meProfil & poin pelanggan Pelanggan
URL: GET https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/me
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
slugstringwajib Slug tokotoko-berkah-jaya
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/t/toko-berkah-jaya/customer/me" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 25,
        "code": "PLG00001",
        "name": "Andi Pratama",
        "email": "[email protected]",
        "phone": "081200000001",
        "address": "Jl. Baru",
        "points": 186,
        "transactions": 31,
        "total_spent": 2023500
    },
    "meta": null
}
Coba langsung

                                
GET /t/{slug}/customer/salesRiwayat belanja Pelanggan
URL: GET https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/sales
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
slugstringwajib Slug tokotoko-berkah-jaya
Query string
NamaTipeWajibKeteranganContoh
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/t/toko-berkah-jaya/customer/sales?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 2610,
            "number": "INV-261113-0011",
            "status": "paid",
            "sold_at": "2026-11-13T07:18:35+07:00",
            "cashier": null,
            "customer": null,
            "subtotal": 146000,
            "item_discount": 500,
            "discount": 0,
            "tax_percent": 0,
            "tax": 0,
            "total": 145500,
            "paid": 200000,
            "change": 54500,
            "payment_method": "cash",
            "payment_ref": null,
            "points_earned": 14,
            "note": null,
            "void_reason": null,
            "voided_at": null
        },
        {
            "id": 1867,
            "number": "INV-261113-0008",
            "status": "paid",
            "sold_at": "2026-11-13T04:35:45+07:00",
            "cashier": null,
            "customer": null,
            "subtotal": 3500,
            "item_discount": 0,
            "discount": 0,
            "tax_percent": 0,
            "tax": 0,
            "total": 3500,
            "paid": 5000,
            "change": 1500,
            "payment_method": "cash",
            "payment_ref": null,
            "points_earned": 0,
            "note": null,
            "void_reason": null,
            "voided_at": null
        },
        {
            "id": 1865,
            "number": "INV-261113-0006",
            "status": "paid",
            "sold_at": "2026-11-13T03:13:07+07:00",
            "cashier": null,
            "customer": null,
            "subtotal": 80500,
            "item_discount": 0,
            "discount": 0,
            "tax_percent": 0,
            "tax": 0,
            "total": 80500,
            "paid": 85000,
            "change": 4500,
            "payment_method": "cash",
            "payment_ref": null,
            "points_earned": 8,
            "note": null,
            "void_reason": null,
            "voided_at": null
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 31,
        "last_page": 3
    }
}
Coba langsung

                                
GET /t/{slug}/customer/sales/{id}Detail belanja Pelanggan
URL: GET https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/sales/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
slugstringwajib Slug tokotoko-berkah-jaya
idintegerwajib ID transaksi1867
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/t/toko-berkah-jaya/customer/sales/1867" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 1867,
        "number": "INV-261113-0008",
        "status": "paid",
        "sold_at": "2026-11-13T04:35:45+07:00",
        "cashier": null,
        "customer": null,
        "subtotal": 3500,
        "item_discount": 0,
        "discount": 0,
        "tax_percent": 0,
        "tax": 0,
        "total": 3500,
        "paid": 5000,
        "change": 1500,
        "payment_method": "cash",
        "payment_ref": null,
        "points_earned": 0,
        "note": null,
        "void_reason": null,
        "voided_at": null,
        "items": [
            {
                "product_id": 65,
                "sku": "TOK0021",
                "name": "Mi Goreng",
                "qty": 1,
                "price": 3500,
                "discount": 0,
                "subtotal": 3500
            }
        ]
    },
    "meta": null
}
Coba langsung

                                
POST /t/{slug}/customer/logoutLogout pelanggan Pelanggan
URL: POST https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/logout
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
slugstringwajib Slug tokotoko-berkah-jaya
Contoh request (curl)
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/t/toko-berkah-jaya/customer/logout" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Contoh response 200
{
    "success": true,
    "message": "Logout berhasil",
    "data": null,
    "meta": null
}
Coba langsung

                                

Superadmin Platform

Khusus superadmin: statistik seluruh platform, daftar toko, dan aktif/nonaktifkan toko. Toko nonaktif tidak bisa login (web & API) dan halaman tokonya ditutup.

GET /admin/statsStatistik platform Superadmin
URL: GET https://belajar-api.unama.ac.id/api/kasir/admin/stats
Header: Accept: application/json · Authorization: Bearer {token}
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/admin/stats" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "tenants": 3,
        "tenants_active": 3,
        "tenants_new_30_days": 1,
        "users": 7,
        "customers": 20,
        "products": 39,
        "transactions": 1339,
        "gmv": 117514350,
        "transactions_today": 20,
        "gmv_today": 1426600,
        "last_30_days": [
            {
                "date": "2026-10-15",
                "transactions": 54,
                "omzet": 4878350
            },
            {
                "date": "2026-10-16",
                "transactions": 46,
                "omzet": 3403200
            }
        ],
        "top_tenants": [
            {
                "id": 8,
                "name": "Kopi Senja",
                "slug": "kopi-senja",
                "address": "Jl. Sultan Thaha No. 5, Jambi",
                "phone": "0812-7777-8888",
                "email": "[email protected]",
                "logo": "demo/kopi-senja/logo.png",
                "tax_percent": 10,
                "point_rate": 10000,
                "receipt_footer": "Terima kasih telah berbelanja di Kopi Senja!",
                "receipt_width": 80,
                "status": "active",
                "created_at": "2026-09-29T06:12:31+07:00",
                "updated_at": "2026-11-13T06:12:31+07:00",
                "users_count": 2,
                "cashiers_count": 1,
                "transactions_count": 735,
                "gmv": "79135650.00",
                "products_count": 15,
                "owner_email": "[email protected]",
                "logo_url": "http://localhost/kasir/uploads/demo/kopi-senja/logo.png",
                "store_url": "http://localhost/kasir/t/kopi-senja"
            },
            {
                "id": 7,
                "name": "Toko Berkah Jaya",
                "slug": "toko-berkah-jaya",
                "address": "Jl. Kapten Pattimura No. 10, Jambi",
                "phone": "0741-123456",
                "email": "[email protected]",
                "logo": "demo/toko-berkah-jaya/logo.png",
                "tax_percent": 0,
                "point_rate": 10000,
                "receipt_footer": "Terima kasih!",
                "receipt_width": 58,
                "status": "active",
                "created_at": "2026-09-29T06:12:12+07:00",
                "updated_at": "2026-11-13T07:18:34+07:00",
                "users_count": 4,
                "cashiers_count": 3,
                "transactions_count": 604,
                "gmv": "38378700.00",
                "products_count": 24,
                "owner_email": "[email protected]",
                "logo_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/logo.png",
                "store_url": "http://localhost/kasir/t/toko-berkah-jaya"
            },
            {
                "id": 12,
                "name": "Warung Maju",
                "slug": "warung-maju",
                "address": "Jl. Merdeka No. 1, Jambi",
                "phone": "081234567890",
                "email": "[email protected]",
                "logo": null,
                "tax_percent": 0,
                "point_rate": 10000,
                "receipt_footer": "Terima kasih telah berbelanja!",
                "receipt_width": 58,
                "status": "active",
                "created_at": "2026-11-13T07:18:33+07:00",
                "updated_at": "2026-11-13T07:18:33+07:00",
                "users_count": 1,
                "cashiers_count": 0,
                "transactions_count": 0,
                "gmv": "0.00",
                "products_count": 0,
                "owner_email": "[email protected]",
                "logo_url": null,
                "store_url": "http://localhost/kasir/t/warung-maju"
            }
        ]
    },
    "meta": null
}
Coba langsung

                                
GET /admin/tenantsDaftar toko Superadmin
URL: GET https://belajar-api.unama.ac.id/api/kasir/admin/tenants
Header: Accept: application/json · Authorization: Bearer {token}
Query string
NamaTipeWajibKeteranganContoh
qstringopsional Cari nama/slug
statusstringopsional active / inactive
sortstringopsional -gmv = omzet terbesar
pageintegeropsional Nomor halaman1
per_pageintegeropsional Data per halaman (1-100)15
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/admin/tenants?page=1&per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": [
        {
            "id": 12,
            "name": "Warung Maju",
            "slug": "warung-maju",
            "address": "Jl. Merdeka No. 1, Jambi",
            "phone": "081234567890",
            "email": "[email protected]",
            "logo": null,
            "tax_percent": 0,
            "point_rate": 10000,
            "receipt_footer": "Terima kasih telah berbelanja!",
            "receipt_width": 58,
            "status": "active",
            "created_at": "2026-11-13T07:18:33+07:00",
            "updated_at": "2026-11-13T07:18:33+07:00",
            "users_count": 1,
            "cashiers_count": 0,
            "transactions_count": 0,
            "gmv": "0.00",
            "products_count": 0,
            "owner_email": "[email protected]",
            "logo_url": null,
            "store_url": "http://localhost/kasir/t/warung-maju"
        },
        {
            "id": 8,
            "name": "Kopi Senja",
            "slug": "kopi-senja",
            "address": "Jl. Sultan Thaha No. 5, Jambi",
            "phone": "0812-7777-8888",
            "email": "[email protected]",
            "logo": "demo/kopi-senja/logo.png",
            "tax_percent": 10,
            "point_rate": 10000,
            "receipt_footer": "Terima kasih telah berbelanja di Kopi Senja!",
            "receipt_width": 80,
            "status": "active",
            "created_at": "2026-09-29T06:12:31+07:00",
            "updated_at": "2026-11-13T06:12:31+07:00",
            "users_count": 2,
            "cashiers_count": 1,
            "transactions_count": 735,
            "gmv": "79135650.00",
            "products_count": 15,
            "owner_email": "[email protected]",
            "logo_url": "http://localhost/kasir/uploads/demo/kopi-senja/logo.png",
            "store_url": "http://localhost/kasir/t/kopi-senja"
        },
        {
            "id": 7,
            "name": "Toko Berkah Jaya",
            "slug": "toko-berkah-jaya",
            "address": "Jl. Kapten Pattimura No. 10, Jambi",
            "phone": "0741-123456",
            "email": "[email protected]",
            "logo": "demo/toko-berkah-jaya/logo.png",
            "tax_percent": 0,
            "point_rate": 10000,
            "receipt_footer": "Terima kasih!",
            "receipt_width": 58,
            "status": "active",
            "created_at": "2026-09-29T06:12:12+07:00",
            "updated_at": "2026-11-13T07:18:34+07:00",
            "users_count": 4,
            "cashiers_count": 3,
            "transactions_count": 604,
            "gmv": "38378700.00",
            "products_count": 24,
            "owner_email": "[email protected]",
            "logo_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/logo.png",
            "store_url": "http://localhost/kasir/t/toko-berkah-jaya"
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 15,
        "total": 3,
        "last_page": 1
    }
}
Coba langsung

                                
GET /admin/tenants/{id}Detail toko Superadmin
URL: GET https://belajar-api.unama.ac.id/api/kasir/admin/tenants/{id}
Header: Accept: application/json · Authorization: Bearer {token}
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID toko7
Contoh request (curl)
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/admin/tenants/7" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"
Contoh response 200
{
    "success": true,
    "message": "Berhasil",
    "data": {
        "id": 7,
        "name": "Toko Berkah Jaya",
        "slug": "toko-berkah-jaya",
        "address": "Jl. Kapten Pattimura No. 10, Jambi",
        "phone": "0741-123456",
        "email": "[email protected]",
        "logo": "demo/toko-berkah-jaya/logo.png",
        "tax_percent": 0,
        "point_rate": 10000,
        "receipt_footer": "Terima kasih!",
        "receipt_width": 58,
        "status": "active",
        "created_at": "2026-09-29T06:12:12+07:00",
        "updated_at": "2026-11-13T07:18:34+07:00",
        "logo_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/logo.png",
        "store_url": "http://localhost/kasir/t/toko-berkah-jaya",
        "owner": {
            "id": 15,
            "name": "Budi Santoso",
            "email": "[email protected]",
            "phone": "081234567890",
            "role": "owner",
            "is_active": true,
            "tenant_id": 7,
            "last_login_at": "2026-11-13T07:18:34+07:00",
            "created_at": "2026-11-13T06:12:12+07:00"
        },
        "users": [
            {
                "id": 16,
                "name": "Siti Aminah",
                "email": "[email protected]",
                "phone": null,
                "role": "kasir",
                "is_active": true,
                "tenant_id": 7,
                "last_login_at": null,
                "created_at": "2026-11-13T06:12:12+07:00"
            },
            {
                "id": 17,
                "name": "Rudi Hartono",
                "email": "[email protected]",
                "phone": null,
                "role": "kasir",
                "is_active": true,
                "tenant_id": 7,
                "last_login_at": null,
                "created_at": "2026-11-13T06:12:12+07:00"
            }
        ],
        "summary_30_days": {
            "from": "2026-10-15",
            "to": "2026-11-13",
            "transactions": 604,
            "items_sold": 2926,
            "gross_sales": 38492200,
            "discount": 113500,
            "net_sales": 38378700,
            "tax": 0,
            "omzet": 38378700,
            "cost": 30979700,
            "gross_profit": 7399000,
            "margin_percent": 19.3,
            "average_ticket": 63541,
            "void_count": 3
        },
        "summary_all_time": {
            "from": "2000-01-01",
            "to": "2026-11-13",
            "transactions": 604,
            "items_sold": 2926,
            "gross_sales": 38492200,
            "discount": 113500,
            "net_sales": 38378700,
            "tax": 0,
            "omzet": 38378700,
            "cost": 30979700,
            "gross_profit": 7399000,
            "margin_percent": 19.3,
            "average_ticket": 63541,
            "void_count": 3
        }
    },
    "meta": null
}
Coba langsung

                                
PATCH /admin/tenants/{id}/statusAktif / nonaktifkan toko Superadmin
URL: PATCH https://belajar-api.unama.ac.id/api/kasir/admin/tenants/{id}/status
Header: Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json
Parameter path
NamaTipeWajibKeteranganContoh
idintegerwajib ID toko7
Body
NamaTipeWajibKeteranganContoh
statusstringwajib active atau inactiveactive
Contoh request (curl)
curl -X PATCH "https://belajar-api.unama.ac.id/api/kasir/admin/tenants/7/status" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"active"}'
Contoh response 200
{
    "success": true,
    "message": "Toko diaktifkan",
    "data": {
        "id": 7,
        "name": "Toko Berkah Jaya",
        "slug": "toko-berkah-jaya",
        "address": "Jl. Kapten Pattimura No. 10, Jambi",
        "phone": "0741-123456",
        "email": "[email protected]",
        "logo": "demo/toko-berkah-jaya/logo.png",
        "tax_percent": 0,
        "point_rate": 10000,
        "receipt_footer": "Terima kasih!",
        "receipt_width": 58,
        "status": "active",
        "created_at": "2026-09-29T06:12:12+07:00",
        "updated_at": "2026-11-13T07:18:34+07:00",
        "logo_url": "http://localhost/kasir/uploads/demo/toko-berkah-jaya/logo.png",
        "store_url": "http://localhost/kasir/t/toko-berkah-jaya"
    },
    "meta": null
}
Coba langsung

                                

Lihat juga: Panduan pengguna · Belajar API v2