KasirPro API v1

curl -H "Authorization: Bearer kp_live_..." https://api.kasirpro.com/v1/me

{
  "error": true,
  "code": "scope_required",
  "message": "API key ini tidak punya izin 'laporan'. Buat/ubah key di backoffice."
}

GET /v1/ping

Cek koneksi & validitas kunci.Check connectivity & key validity.

{ "ok": true, "waktu_server": "2026-08-26T14:05:11+07:00" }

GET /v1/me

Identitas kunci: akun, lisensi, toko, mode, dan izin. Mulailah dari sini.The key's identity: account, license, store, mode and scopes. Start here.

{
  "nama": "Budi Santoso",
  "lisensi": "MAX",
  "aktif_sampai": "2027-01-15",
  "toko": { "id": 12, "nama": "Kedai Kopi Melati" },
  "mode": "baca+tulis",
  "scopes": ["produk", "laporan", "order"]
}

GET /v1/toko

Profil toko milik kunci ini.The key's store profile.

{
  "data": {
    "id": 12, "nama": "Kedai Kopi Melati",
    "alamat": "Jl. Melati No. 5", "kota": "Bandung",
    "telp": "0227654321", "timezone": "Asia/Jakarta"
  }
}

GET /v1/produk produk

Daftar produk toko — tanpa HPP/biaya modal.The store's products — cost price never included.

curl -H "Authorization: Bearer kp_live_..." \
  "https://api.kasirpro.com/v1/produk?q=kopi&per=2"

{
  "page": 1, "per": 2,
  "data": [
    { "id": 345, "toko": 12, "nama": "Kopi Susu Gula Aren", "sku": "KSG-01",
      "satuan": "cup", "kategori": "Minuman", "harga": 22000, "aktif": true },
    { "id": 351, "toko": 12, "nama": "Kopi Tubruk", "sku": "",
      "satuan": "cup", "kategori": "Minuman", "harga": 15000, "aktif": true }
  ]
}

GET /v1/stok stok

Stok per produk (dijumlah lintas varian, mengikuti mode desimal toko). resep:true = produk berbahan: stok fisik lazim 0 — ketersediaan sebenarnya dari bahan, tidak dihitung endpoint ini. Stock per product (summed across variants, following the store's decimal mode). resep:true = recipe product: physical stock is usually 0 — real availability derives from ingredients, not computed here.

{
  "page": 1, "per": 50, "toko": 12,
  "data": [
    { "produk_id": 345, "nama": "Kopi Susu Gula Aren", "satuan": "cup", "stok": 0,  "resep": true },
    { "produk_id": 402, "nama": "Air Mineral 600ml",   "satuan": "btl", "stok": 47, "resep": false }
  ]
}

POST /v1/produk produk Baca+Tulis

Tambah produk baru. Tersinkron ke perangkat kasir ≤ 1 menit.Create a product. Syncs to cashier devices within ~1 minute.

curl -X POST https://api.kasirpro.com/v1/produk \
  -H "Authorization: Bearer kp_live_..." -H "Content-Type: application/json" \
  -d '{"nama":"Es Teh Manis","harga":8000,"satuan":"cup","stok":0}'

{
  "ok": true, "produk_id": 512,
  "catatan": "Perangkat kasir menerima produk ini lewat sinkronisasi (<=1 menit)."
}

POST /v1/produk/ubah produk Baca+Tulis

Ubah sebagian field produk — hanya field yang dikirim yang berubah. Bisa diubah: nama, harga, sku, satuan, deskripsi, kategori_id. HPP dan stok tidak bisa diubah lewat API.Partial update — only sent fields change. Editable: nama, harga, sku, satuan, deskripsi, kategori_id. Cost price and stock cannot be changed via the API.

curl -X POST https://api.kasirpro.com/v1/produk/ubah \
  -H "Authorization: Bearer kp_live_..." -H "Content-Type: application/json" \
  -d '{"id":512,"harga":9000}'

{ "ok": true, "produk_id": 512 }

GET /v1/pelanggan pelanggan

Daftar pelanggan toko. piutang = tagihan berjalan pelanggan (Rupiah).The store's customers. piutang = the customer's outstanding receivable (Rupiah).

{
  "page": 1, "per": 50,
  "data": [
    { "id": 88, "toko": 12, "nama": "Siti Rahma", "nohp": "081234567890",
      "alamat": "Jl. Anggrek 3", "piutang": 150000 }
  ]
}

POST /v1/pelanggan pelanggan Baca+Tulis

Tambah pelanggan baru ke toko ini.Create a customer in this store.

curl -X POST https://api.kasirpro.com/v1/pelanggan \
  -H "Authorization: Bearer kp_live_..." -H "Content-Type: application/json" \
  -d '{"nama":"Siti Rahma","nohp":"081234567890"}'

{ "ok": true, "pelanggan_id": 913 }

POST /v1/pelanggan/ubah pelanggan Baca+Tulis

Ubah sebagian data pelanggan: nama, nohp, alamat.Partial customer update: nama, nohp, alamat.

curl -X POST https://api.kasirpro.com/v1/pelanggan/ubah \
  -H "Authorization: Bearer kp_live_..." -H "Content-Type: application/json" \
  -d '{"id":913,"nohp":"081298765432"}'

{ "ok": true, "pelanggan_id": 913 }

GET /v1/laporan/ringkasan laporan

Omzet & jumlah transaksi per hari. Omzet = total − refund (NET), rumus yang sama dengan laporan backoffice.Daily revenue & transaction count. Revenue = total − refund (net), matching the backoffice reports.

curl -H "Authorization: Bearer kp_live_..." \
  "https://api.kasirpro.com/v1/laporan/ringkasan?from=2026-08-01&to=2026-08-07"

{
  "from": "2026-08-01", "to": "2026-08-07",
  "total": { "trx": 214, "omzet": 8425000 },
  "per_hari": [
    { "tanggal": "2026-08-01", "trx": 31, "omzet": 1180000 },
    { "tanggal": "2026-08-02", "trx": 28, "omzet": 1035000 }
  ]
}

GET /v1/laporan/produk laporan

Penjualan per produk, urut nilai terbesar — rumus identik Laporan Penjualan backoffice (qty ikut desimal & dikurangi retur; nota dibatalkan tidak dihitung).Per-product sales, ordered by value — the exact backoffice Sales Report formula (decimal qty, returns deducted; voided receipts excluded).

{
  "from": "2026-08-01", "to": "2026-08-07", "page": 1, "per": 50,
  "data": [
    { "produk_id": 345, "nama": "Kopi Susu Gula Aren", "qty": 182,  "nilai": 4004000 },
    { "produk_id": 402, "nama": "Air Mineral 600ml",   "qty": 95.5, "nilai": 477500 }
  ]
}

GET /v1/transaksi transaksi

Daftar nota, terbaru dulu. metode kosong ditampilkan sebagai "Tunai".Receipt list, newest first. Empty metode is shown as "Tunai" (cash).

{
  "from": "2026-08-01", "to": "2026-08-07", "page": 1, "per": 50,
  "data": [
    { "id": 26612345, "toko": 12, "tanggal": "2026-08-07", "waktu": "14:22:31",
      "nota": "KM26877102", "total": 57000, "refund": 0, "metode": "QrisToko", "piutang": 0 }
  ]
}

GET /v1/transaksi/detail transaksi

Satu nota lengkap dengan rincian biaya dan item. total_baris = harga total baris (sudah × qty, setelah diskon item).One receipt with charge breakdown and items. total_baris = the line total (already × qty, after item discount).

{
  "nota": {
    "id": 26612345, "toko": 12, "tanggal": "2026-08-07", "waktu": "14:22:31",
    "no": "KM26877102", "subtotal": 52000, "diskon": 0, "pajak": 5000,
    "layanan": 0, "ongkir": 0, "total": 57000, "refund": 0, "metode": "QrisToko"
  },
  "items": [
    { "nama": "Kopi Susu Gula Aren", "qty": 2, "qty_retur": 0, "total_baris": 44000, "nilai_retur": 0 },
    { "nama": "Es Teh Manis",        "qty": 1, "qty_retur": 0, "total_baris": 8000,  "nilai_retur": 0 }
  ]
}

POST /v1/order order Baca+Tulis

curl -X POST https://api.kasirpro.com/v1/order \
  -H "Authorization: Bearer kp_live_..." -H "Content-Type: application/json" \
  -d '{
    "nama": "Budi", "nohp": "081234567890",
    "items": [
      { "produk_id": 345, "qty": 2 },
      { "produk_id": 351, "qty": 1, "catatan": "tanpa gula" }
    ]
  }'

{
  "ok": true,
  "order_id": 9812,
  "savednota_id": 5541,
  "qris": {
    "qris_id": "qr_8f2f6c1e-2c3a-4f6d-9d21-7f1b2a9c0e55",
    "qr_string": "00020101021226670016ID.CO.XENDIT.WWW01189360091100...6304A1B2",
    "amount": 59000,
    "orderid": 77120,
    "expires_at": "2026-08-26T09:35:00.000Z"
  },
  "catatan": "Render qris.qr_string sebagai QR code utk dibayar. Cek pembayaran lewat GET /v1/order/status?id=9812. Pesanan tampil di aplikasi kasir sebagai pesanan online."
}

GET /v1/order/status order

Status pembayaran pesanan. Poll tiap 5–10 detik sampai paid:true atau ±30 menit (QRIS kedaluwarsa).Order payment status. Poll every 5–10 seconds until paid:true or ~30 minutes (QRIS expiry).

// belum dibayar / unpaid:
{ "order_id": 9812, "paid": false, "status": "pending", "total": 59000 }

// sudah dibayar / paid:
{ "order_id": 9812, "paid": true, "status": "settlement", "total": 59000 }