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.
https://belajar-api.unama.ac.id/api/kasir
Autentikasi & peran
- Panggil
POST /auth/login(atau/auth/registeruntuk toko baru) → ambildata.token.access_token, format{id}|{acak}, berlaku 30 hari. - Kirim di setiap request:
Authorization: Bearer {token}danAccept: application/json. - Data otomatis dibatasi ke toko pemilik token (multi-tenant). ID milik toko lain selalu menghasilkan 404.
- Untuk request
POST/PUT/PATCH/DELETEtanpa data (mis. logout), tetap kirim body{}denganContent-Type: application/json— firewall server menolak POST dengan body kosong (HTTP 500 dari server, bukan dari aplikasi). - Pelanggan memakai token terpisah dari
POST /t/{slug}/customer/loginyang hanya berlaku untuk toko tersebut.
| Peran | Akses utama |
|---|---|
| superadmin | Statistik platform, daftar toko, aktif/nonaktifkan toko (/admin/*). |
| owner | Semua data tokonya: pengaturan, staff, master, produk, stok, pelanggan, transaksi (termasuk void), shift, laporan. |
| kasir | Baca produk & master, kelola pelanggan, buat transaksi, lihat transaksinya sendiri, buka/tutup shift. |
| pelanggan | Profil, poin, dan riwayat belanja sendiri di satu toko (/t/{slug}/customer/*). |
Format response
{
"success": true,
"message": "Berhasil",
"data": [ { "id": 1, "name": "Beras Premium 5kg", ... } ],
"meta": { "current_page": 1, "per_page": 15, "total": 25, "last_page": 2 }
}{
"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
| Kode | Arti | Contoh penyebab |
|---|---|---|
| 200 / 201 | Berhasil / data dibuat | — |
| 401 | Unauthenticated | Header Authorization tidak ada, token salah/kedaluwarsa, password salah saat login |
| 403 | Forbidden | Kasir memanggil endpoint owner, akun/toko dinonaktifkan, token pelanggan dipakai di toko lain |
| 404 | Tidak ditemukan | ID tidak ada atau milik toko lain, endpoint salah |
| 405 | Method tidak didukung | DELETE /auth/login |
| 422 | Validasi / aturan bisnis gagal | Stok tidak cukup, uang dibayar kurang, SKU duplikat, transaksi sudah dibatalkan |
| 429 | Terlalu banyak request | >120 request/menit per token, >10/menit untuk login/register |
| 500 | Kesalahan server | Laporkan ke admin |
Akun demo
Semua password: password. Data demo dapat direset sewaktu-waktu. Slug toko: toko-berkah-jaya dan kopi-senja.
| Peran | Toko | ||
|---|---|---|---|
| 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 https://belajar-api.unama.ac.id/api/kasir/Accept: application/json curl -X GET "https://belajar-api.unama.ac.id/api/kasir" \ -H "Accept: application/json"
{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/openapi.jsonAccept: application/json curl -X GET "https://belajar-api.unama.ac.id/api/kasir/openapi.json" \ -H "Accept: application/json"
File JSON (lihat tautan unduhan di atas)
GET https://belajar-api.unama.ac.id/api/kasir/postman.jsonAccept: application/json curl -X GET "https://belajar-api.unama.ac.id/api/kasir/postman.json" \ -H "Accept: application/json"
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.
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.
POST https://belajar-api.unama.ac.id/api/kasir/auth/registerAccept: application/json · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| store_name | string | wajib | Nama toko (3-120) | Warung Maju |
| name | string | wajib | Nama pemilik | Ahmad Fauzi |
| string | wajib | Email login (unik) | [email protected] | |
| password | string | wajib | Minimal 6 karakter | rahasia123 |
| password_confirmation | string | wajib | Ulangi password | rahasia123 |
| phone | string | opsional | Nomor HP/telepon toko | 081234567890 |
| address | string | opsional | Alamat toko | Jl. Merdeka No. 1, Jambi |
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"}'{
"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
}Tukar email & password dengan token. Akun demo: [email protected] / password.
POST https://belajar-api.unama.ac.id/api/kasir/auth/loginAccept: application/json · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| string | wajib | [email protected] | ||
| password | string | wajib | Password | password |
| device_name | string | opsional | Nama perangkat | postman |
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"}'{
"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
}Mengirim email berisi tautan reset (web) dan token reset (API). Respons selalu sama walau email tidak terdaftar.
POST https://belajar-api.unama.ac.id/api/kasir/auth/forgot-passwordAccept: application/json · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| string | wajib | Email akun | [email protected] |
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]"}'{
"success": true,
"message": "Jika email terdaftar, tautan & token reset password telah dikirim ke email tersebut (berlaku 60 menit).",
"data": null,
"meta": null
}Token dari email berlaku 60 menit. Semua token API user dicabut setelah berhasil.
POST https://belajar-api.unama.ac.id/api/kasir/auth/reset-passwordAccept: application/json · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| string | wajib | Email akun | [email protected] | |
| token | string | wajib | Token dari email | xxxxxxxx |
| password | string | wajib | Password baru | passwordbaru |
| password_confirmation | string | wajib | Ulangi password baru | passwordbaru |
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"}'{
"success": false,
"message": "Token reset tidak valid atau sudah kedaluwarsa",
"data": null,
"meta": null
}GET https://belajar-api.unama.ac.id/api/kasir/auth/meAccept: application/json · Authorization: Bearer {token} curl -X GET "https://belajar-api.unama.ac.id/api/kasir/auth/me" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}PUT https://belajar-api.unama.ac.id/api/kasir/auth/meAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | opsional | Nama | Budi Santoso |
| string | opsional | Email (unik) | ||
| phone | string | opsional | Nomor HP | 081299998888 |
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"}'{
"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
}Token lain milik user dicabut, token yang sedang dipakai tetap berlaku.
PUT https://belajar-api.unama.ac.id/api/kasir/auth/passwordAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| current_password | string | wajib | Password saat ini | password |
| password | string | wajib | Password baru (min 6) | passwordbaru |
| password_confirmation | string | wajib | Ulangi password baru | passwordbaru |
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"}'{
"success": true,
"message": "Password berhasil diganti. Token di perangkat lain telah dicabut.",
"data": null,
"meta": null
}POST https://belajar-api.unama.ac.id/api/kasir/auth/logoutAccept: application/json · Authorization: Bearer {token} 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 '{}'{
"success": true,
"message": "Logout berhasil",
"data": null,
"meta": null
}Toko & Staff
Pengaturan toko (pajak %, footer & lebar struk, poin) dan manajemen staff kasir oleh owner.
GET https://belajar-api.unama.ac.id/api/kasir/storeAccept: application/json · Authorization: Bearer {token} curl -X GET "https://belajar-api.unama.ac.id/api/kasir/store" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}PUT https://belajar-api.unama.ac.id/api/kasir/storeAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | opsional | Nama toko | Toko Berkah Jaya |
| address | string | opsional | Alamat | Jl. Kapten Pattimura No. 10, Jambi |
| phone | string | opsional | Telepon | 0741-123456 |
| string | opsional | Email toko | ||
| tax_percent | number | opsional | Pajak (%) yang otomatis ditambahkan ke setiap nota | 0 |
| point_rate | integer | opsional | 1 poin pelanggan per kelipatan Rp ini (0 = poin nonaktif) | 10000 |
| receipt_footer | string | opsional | Teks di bawah struk | Terima kasih! |
| receipt_width | integer | opsional | Lebar kertas struk: 58 atau 80 (mm) | 58 |
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}'{
"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
}POST https://belajar-api.unama.ac.id/api/kasir/store/logoAccept: application/json · Authorization: Bearer {token} · Content-Type: multipart/form-data| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| logo | file | wajib | Gambar jpg/png/webp maks 2MB |
curl -X POST "https://belajar-api.unama.ac.id/api/kasir/store/logo" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN" \ -F "logo=@/path/gambar.jpg"
{ "success": true, "message": "...", "data": { ... }, "meta": null }GET https://belajar-api.unama.ac.id/api/kasir/usersAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| q | string | opsional | Cari nama/email | |
| role | string | opsional | owner atau kasir | |
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}POST https://belajar-api.unama.ac.id/api/kasir/usersAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | wajib | Nama | Kasir Baru |
| string | wajib | Email login (unik) | [email protected] | |
| password | string | wajib | Password (min 6) | rahasia123 |
| phone | string | opsional | Nomor HP | |
| is_active | boolean | opsional | Aktif? | true |
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}'{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/users/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID user | 17 |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/users/17" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}Kirim field yang ingin diubah saja. password kosong = tidak diubah. Menonaktifkan atau mengganti password mencabut token user tersebut.
PUT https://belajar-api.unama.ac.id/api/kasir/users/{id}Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID user | 17 |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | opsional | Nama | |
| string | opsional | |||
| password | string | opsional | Password baru | |
| is_active | boolean | opsional | Aktif? | true |
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}'{
"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
}DELETE https://belajar-api.unama.ac.id/api/kasir/users/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID user | 17 |
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 '{}'{
"success": true,
"message": "User dihapus",
"data": null,
"meta": null
}Master Data
Kategori, satuan, dan supplier milik toko. Kasir hanya bisa membaca; owner bisa menambah/mengubah/menghapus.
GET https://belajar-api.unama.ac.id/api/kasir/categoriesAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| q | string | opsional | Kata kunci pencarian | |
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}GET https://belajar-api.unama.ac.id/api/kasir/categories/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID kategori | 25 |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/categories/25" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}POST https://belajar-api.unama.ac.id/api/kasir/categoriesAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | wajib | Nama kategori (unik per toko) | Frozen Food |
| description | string | opsional | Keterangan |
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"}'{
"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
}PUT https://belajar-api.unama.ac.id/api/kasir/categories/{id}Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID kategori | 25 |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | wajib | Nama kategori (unik per toko) | Frozen Food (ubah) |
| description | string | opsional | Keterangan |
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)"}'{
"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
}DELETE https://belajar-api.unama.ac.id/api/kasir/categories/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID kategori | 25 |
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 '{}'{
"success": true,
"message": "Kategori dihapus",
"data": null,
"meta": null
}GET https://belajar-api.unama.ac.id/api/kasir/unitsAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| q | string | opsional | Kata kunci pencarian | |
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}GET https://belajar-api.unama.ac.id/api/kasir/units/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID satuan | 32 |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/units/32" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}POST https://belajar-api.unama.ac.id/api/kasir/unitsAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | wajib | Nama satuan (unik per toko) | lusin |
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"}'{
"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
}PUT https://belajar-api.unama.ac.id/api/kasir/units/{id}Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID satuan | 32 |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | wajib | Nama satuan (unik per toko) | lusin (ubah) |
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)"}'{
"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
}DELETE https://belajar-api.unama.ac.id/api/kasir/units/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID satuan | 32 |
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 '{}'{
"success": true,
"message": "Satuan dihapus",
"data": null,
"meta": null
}GET https://belajar-api.unama.ac.id/api/kasir/suppliersAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| q | string | opsional | Kata kunci pencarian | |
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}GET https://belajar-api.unama.ac.id/api/kasir/suppliers/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID supplier | 10 |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/suppliers/10" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}POST https://belajar-api.unama.ac.id/api/kasir/suppliersAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | wajib | Nama supplier | UD Sejahtera |
| phone | string | opsional | Telepon | 0741-222333 |
| string | opsional | |||
| address | string | opsional | Alamat | Jambi |
| notes | string | opsional | Catatan |
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"}'{
"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
}PUT https://belajar-api.unama.ac.id/api/kasir/suppliers/{id}Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID supplier | 10 |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | wajib | Nama supplier | UD Sejahtera (ubah) |
| phone | string | opsional | Telepon | 0741-222333 |
| string | opsional | |||
| address | string | opsional | Alamat | Jambi |
| notes | string | opsional | Catatan |
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"}'{
"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
}DELETE https://belajar-api.unama.ac.id/api/kasir/suppliers/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID supplier | 10 |
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 '{}'{
"success": false,
"message": "Supplier sudah dipakai di data stok masuk, tidak dapat dihapus",
"data": null,
"meta": null
}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 https://belajar-api.unama.ac.id/api/kasir/productsAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| q | string | opsional | Cari nama / SKU / barcode | mi |
| category_id | integer | opsional | Filter kategori | |
| active | boolean | opsional | true / false | |
| low_stock | boolean | opsional | true = hanya stok menipis | |
| sort | string | opsional | name, -name, price, -price, stock, -stock, -created_at | name |
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}GET https://belajar-api.unama.ac.id/api/kasir/products/barcode/{code}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| code | string | wajib | Barcode atau SKU | 8990000007001 |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/products/barcode/8990000007001" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/products/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID produk | 45 |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/products/45" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}Bisa JSON atau multipart (bila menyertakan image). SKU kosong = dibuat otomatis (PRD00001). stock = stok awal (tercatat sebagai mutasi "Stok awal").
POST https://belajar-api.unama.ac.id/api/kasir/productsAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | wajib | Nama produk | Kopi Bubuk 200g |
| sku | string | opsional | Kode unik per toko (huruf/angka/-/_) | KOPI200 |
| barcode | string | opsional | Barcode (unik per toko) | 8991234567890 |
| category_id | integer | opsional | ID kategori | |
| unit_id | integer | opsional | ID satuan | |
| cost_price | number | wajib | Harga beli / HPP | 18000 |
| price | number | wajib | Harga jual | 24000 |
| stock | integer | opsional | Stok awal | 20 |
| min_stock | integer | opsional | Batas stok menipis | 5 |
| is_active | boolean | opsional | Dijual di POS? | true |
| description | string | opsional | Deskripsi | |
| image | file | opsional | Gambar jpg/png/webp maks 2MB (multipart) |
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}'{
"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
}Kirim field yang ingin diubah saja. Field stock ditolak (422) — gunakan penyesuaian stok.
PUT https://belajar-api.unama.ac.id/api/kasir/products/{id}Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID produk | 45 |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | opsional | Nama | |
| price | number | opsional | Harga jual | 73000 |
| cost_price | number | opsional | Harga beli | |
| min_stock | integer | opsional | Stok minimum | |
| is_active | boolean | opsional | Aktif? |
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}'{
"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
}POST https://belajar-api.unama.ac.id/api/kasir/products/{id}/imageAccept: application/json · Authorization: Bearer {token} · Content-Type: multipart/form-data| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID produk | 45 |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| image | file | wajib | Gambar jpg/png/webp maks 2MB |
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"
{ "success": true, "message": "...", "data": { ... }, "meta": null }Produk yang sudah pernah terjual tidak dapat dihapus (422); nonaktifkan dengan is_active: false.
DELETE https://belajar-api.unama.ac.id/api/kasir/products/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID produk | 45 |
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 '{}'{
"success": false,
"message": "Produk sudah pernah terjual sehingga tidak dapat dihapus. Nonaktifkan saja (is_active = false).",
"data": null,
"meta": null
}Stok
Stok masuk (pembelian dari supplier), penyesuaian/stock opname, riwayat mutasi, dan peringatan stok menipis. Khusus owner.
GET https://belajar-api.unama.ac.id/api/kasir/stock/purchasesAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| q | string | opsional | Cari nomor | |
| supplier_id | integer | opsional | Filter supplier | |
| from | date | opsional | Dari tanggal | |
| to | date | opsional | Sampai tanggal | |
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}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.
POST https://belajar-api.unama.ac.id/api/kasir/stock/purchasesAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| supplier_id | integer | opsional | ID supplier | |
| date | date | opsional | Tanggal (default hari ini) | |
| note | string | opsional | Catatan / no faktur supplier | Faktur #123 |
| update_cost | boolean | opsional | Perbarui harga beli produk | true |
| items | array | wajib | Daftar item: [{product_id, qty, cost_price?}] | [{"product_id":45,"qty":10,"cost_price":62000}] |
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}]}'{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/stock/purchases/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID stok masuk | 13 |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/stock/purchases/13" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}mode: set = jadikan stok sama dengan qty (hasil hitung fisik). mode: add = tambah/kurangi qty (boleh negatif, mis. barang rusak). Stok tidak boleh minus.
POST https://belajar-api.unama.ac.id/api/kasir/stock/adjustmentsAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| product_id | integer | wajib | ID produk | 45 |
| mode | string | wajib | set atau add | add |
| qty | integer | wajib | Jumlah | -1 |
| note | string | wajib | Alasan | Barang rusak |
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"}'{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/stock/movementsAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| product_id | integer | opsional | Filter produk | |
| type | string | opsional | initial, purchase, sale, adjustment, void | |
| from | date | opsional | Dari tanggal | |
| to | date | opsional | Sampai tanggal | |
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}Produk aktif dengan stock <= min_stock, diurutkan dari stok terkecil.
GET https://belajar-api.unama.ac.id/api/kasir/stock/lowAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}Pelanggan
Data pelanggan per toko beserta poin. Kasir dapat menambah & mengubah; menghapus khusus owner.
GET https://belajar-api.unama.ac.id/api/kasir/customersAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| q | string | opsional | Cari nama/kode/HP/email | |
| sort | string | opsional | name atau -points | |
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}Kode pelanggan dibuat otomatis (PLG00001).
POST https://belajar-api.unama.ac.id/api/kasir/customersAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | wajib | Nama | Pelanggan Baru |
| phone | string | opsional | Nomor HP | 081311112222 |
| string | opsional | Email (unik per toko) | ||
| address | string | opsional | Alamat |
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"}'{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/customers/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID pelanggan | 25 |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/customers/25" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}PUT https://belajar-api.unama.ac.id/api/kasir/customers/{id}Accept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID pelanggan | 25 |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | opsional | Nama | |
| phone | string | opsional | HP | |
| string | opsional | |||
| address | string | opsional | Alamat | Jl. Baru |
| is_active | boolean | opsional | Aktif? |
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"}'{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/customers/{id}/salesAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID pelanggan | 25 |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}Pelanggan yang sudah punya transaksi tidak dapat dihapus (422).
DELETE https://belajar-api.unama.ac.id/api/kasir/customers/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID pelanggan | 25 |
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 '{}'{
"success": false,
"message": "Pelanggan sudah memiliki transaksi, tidak dapat dihapus. Nonaktifkan saja.",
"data": null,
"meta": null
}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.
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.
POST https://belajar-api.unama.ac.id/api/kasir/salesAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| items | array | wajib | Item: [{product_id, qty, discount?}] — discount = potongan nominal per baris | [{"product_id":45,"qty":1},{"product_id":46,"qty":2,"discount":500}] |
| payment_method | string | wajib | cash, transfer, qris, ewallet | cash |
| paid | number | opsional | Uang dibayar (wajib untuk tunai) | 200000 |
| discount | number | opsional | Diskon nota (nominal) | 0 |
| customer_id | integer | opsional | ID pelanggan (dapat poin) | 25 |
| payment_ref | string | opsional | No. referensi transfer/QRIS | |
| note | string | opsional | Catatan |
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}'{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/salesAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| q | string | opsional | Cari nomor nota | |
| status | string | opsional | paid atau void | |
| payment_method | string | opsional | Filter metode bayar | |
| user_id | integer | opsional | Filter kasir (owner) | |
| customer_id | integer | opsional | Filter pelanggan | |
| from | date | opsional | Dari tanggal | |
| to | date | opsional | Sampai tanggal | |
| format | string | opsional | csv untuk unduh | |
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}
}receipt_url = halaman struk cetak (thermal 58/80mm) di web (butuh login web).
GET https://belajar-api.unama.ac.id/api/kasir/sales/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID transaksi | 2614 |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/sales/2614" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}Stok seluruh item dikembalikan (mutasi tipe void) dan poin pelanggan ditarik. Transaksi void tidak dihitung di laporan.
POST https://belajar-api.unama.ac.id/api/kasir/sales/{id}/voidAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID transaksi | 2614 |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| reason | string | wajib | Alasan pembatalan | Salah input |
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"}'{
"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
}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 https://belajar-api.unama.ac.id/api/kasir/shifts/currentAccept: application/json · Authorization: Bearer {token} curl -X GET "https://belajar-api.unama.ac.id/api/kasir/shifts/current" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"success": true,
"message": "Tidak ada shift terbuka",
"data": null,
"meta": null
}POST https://belajar-api.unama.ac.id/api/kasir/shifts/openAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| opening_cash | number | wajib | Saldo kas awal | 200000 |
| note | string | opsional | Catatan | Shift pagi |
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"}'{
"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
}POST https://belajar-api.unama.ac.id/api/kasir/shifts/closeAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| closing_cash | number | wajib | Uang di laci saat tutup | 850000 |
| note | string | opsional | Catatan |
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}'{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/shiftsAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| user_id | integer | opsional | Filter kasir (owner) | |
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}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 https://belajar-api.unama.ac.id/api/kasir/reports/dashboardAccept: application/json · Authorization: Bearer {token} curl -X GET "https://belajar-api.unama.ac.id/api/kasir/reports/dashboard" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/reports/summaryAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| from | date | opsional | Tanggal awal (YYYY-MM-DD). Default awal bulan ini | 2026-11-01 |
| to | date | opsional | Tanggal akhir (YYYY-MM-DD). Default hari ini | 2026-11-23 |
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"
{
"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"
}
}GET https://belajar-api.unama.ac.id/api/kasir/reports/dailyAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| from | date | opsional | Tanggal awal (YYYY-MM-DD). Default awal bulan ini | 2026-11-01 |
| to | date | opsional | Tanggal akhir (YYYY-MM-DD). Default hari ini | 2026-11-23 |
| format | string | opsional | json (default) atau csv untuk mengunduh file CSV | json |
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"
{
"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
}
}
}GET https://belajar-api.unama.ac.id/api/kasir/reports/productsAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| from | date | opsional | Tanggal awal (YYYY-MM-DD). Default awal bulan ini | 2026-11-01 |
| to | date | opsional | Tanggal akhir (YYYY-MM-DD). Default hari ini | 2026-11-23 |
| format | string | opsional | json (default) atau csv untuk mengunduh file CSV | json |
| sort | string | opsional | qty (default) atau revenue | qty |
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"
{
"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
}
}
}GET https://belajar-api.unama.ac.id/api/kasir/reports/cashiersAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| from | date | opsional | Tanggal awal (YYYY-MM-DD). Default awal bulan ini | 2026-11-01 |
| to | date | opsional | Tanggal akhir (YYYY-MM-DD). Default hari ini | 2026-11-23 |
| format | string | opsional | json (default) atau csv untuk mengunduh file CSV | json |
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"
{
"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
}
}
}GET https://belajar-api.unama.ac.id/api/kasir/reports/paymentsAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| from | date | opsional | Tanggal awal (YYYY-MM-DD). Default awal bulan ini | 2026-11-01 |
| to | date | opsional | Tanggal akhir (YYYY-MM-DD). Default hari ini | 2026-11-23 |
| format | string | opsional | json (default) atau csv untuk mengunduh file CSV | json |
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"
{
"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
}
}
}GET https://belajar-api.unama.ac.id/api/kasir/reports/profitAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| from | date | opsional | Tanggal awal (YYYY-MM-DD). Default awal bulan ini | 2026-11-01 |
| to | date | opsional | Tanggal akhir (YYYY-MM-DD). Default hari ini | 2026-11-23 |
| format | string | opsional | json (default) atau csv untuk mengunduh file CSV | json |
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"
{
"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
}
}
}GET https://belajar-api.unama.ac.id/api/kasir/reports/stockAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| filter | string | opsional | low (menipis) atau empty (habis) | |
| format | string | opsional | json atau csv |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/reports/stock" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}
}
}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 https://belajar-api.unama.ac.id/api/kasir/t/{slug}Accept: application/json | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| slug | string | wajib | Slug toko | toko-berkah-jaya |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/t/toko-berkah-jaya" \ -H "Accept: application/json"
{
"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
}POST https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/registerAccept: application/json · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| slug | string | wajib | Slug toko | toko-berkah-jaya |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| name | string | wajib | Nama | Pelanggan Setia |
| string | wajib | Email (unik per toko) | [email protected] | |
| phone | string | wajib | Nomor HP | 081377778888 |
| password | string | wajib | Password (min 6) | rahasia123 |
| password_confirmation | string | wajib | Ulangi password | rahasia123 |
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"}'{
"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
}POST https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/loginAccept: application/json · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| slug | string | wajib | Slug toko | toko-berkah-jaya |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| string | wajib | [email protected] | ||
| password | string | wajib | Password | password |
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"}'{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/meAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| slug | string | wajib | Slug toko | toko-berkah-jaya |
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"
{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/salesAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| slug | string | wajib | Slug toko | toko-berkah-jaya |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}GET https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/sales/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| slug | string | wajib | Slug toko | toko-berkah-jaya |
| id | integer | wajib | ID transaksi | 1867 |
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"
{
"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
}POST https://belajar-api.unama.ac.id/api/kasir/t/{slug}/customer/logoutAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| slug | string | wajib | Slug toko | toko-berkah-jaya |
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 '{}'{
"success": true,
"message": "Logout berhasil",
"data": null,
"meta": null
}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 https://belajar-api.unama.ac.id/api/kasir/admin/statsAccept: application/json · Authorization: Bearer {token} curl -X GET "https://belajar-api.unama.ac.id/api/kasir/admin/stats" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}GET https://belajar-api.unama.ac.id/api/kasir/admin/tenantsAccept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| q | string | opsional | Cari nama/slug | |
| status | string | opsional | active / inactive | |
| sort | string | opsional | -gmv = omzet terbesar | |
| page | integer | opsional | Nomor halaman | 1 |
| per_page | integer | opsional | Data per halaman (1-100) | 15 |
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"
{
"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
}
}GET https://belajar-api.unama.ac.id/api/kasir/admin/tenants/{id}Accept: application/json · Authorization: Bearer {token} | Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID toko | 7 |
curl -X GET "https://belajar-api.unama.ac.id/api/kasir/admin/tenants/7" \ -H "Accept: application/json" \ -H "Authorization: Bearer $TOKEN"
{
"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
}PATCH https://belajar-api.unama.ac.id/api/kasir/admin/tenants/{id}/statusAccept: application/json · Authorization: Bearer {token} · Content-Type: application/json| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| id | integer | wajib | ID toko | 7 |
| Nama | Tipe | Wajib | Keterangan | Contoh |
|---|---|---|---|---|
| status | string | wajib | active atau inactive | active |
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"}'{
"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
}Lihat juga: Panduan pengguna · Belajar API v2