Endpoint

Semua path relatif terhadap https://api.bakasir.com. Kirim Authorization: Bearer bak_kunci_anda di setiap permintaan. Daftar menerima limit, cursor, dan order, lihat Paginasi.

Informasi kunciSalin tautan

curl https://api.bakasir.com/v1/me -H "Authorization: Bearer bak_kunci_anda"

Mengembalikan id, nama, prefiks, scope kunci, dan jumlah permintaan per menit yang diizinkan.

ProdukSalin tautan

Filter daftar: category_id, type (standard, variant, digital, service, bundle), status (active atau inactive), dan search (nama atau kode).

Buat produk. name dan type wajib. Harga dalam satuan terkecil mata uang:

curl https://api.bakasir.com/v1/products \
  -H "Authorization: Bearer bak_kunci_anda" \
  -H "Idempotency-Key: sku-1001" \
  -H "Content-Type: application/json" \
  -d '{"name": "Es Kopi Susu", "type": "standard", "code": "KOPI-001", "price": 22000, "cost": 9000}'

PATCH hanya mengubah kolom yang Anda kirim. Aturan harga sama dengan Portal. Produk yang punya stok atau riwayat penjualan tidak bisa dihapus, jadi atur "status": false untuk menyembunyikannya. Produk standar yang dibuat dengan opening_stock dimulai dengan stok itu di outlet pertama, atau di store_id jika Anda mengirimnya.

KategoriSalin tautan

curl https://api.bakasir.com/v1/categories \
  -H "Authorization: Bearer bak_kunci_anda" \
  -H "Content-Type: application/json" \
  -d '{"name": "Minuman"}'

Outlet dan stokSalin tautan

/v1/stock mengembalikan satu baris per outlet, produk, dan varian dengan qty dan avg_cost. Filter dengan store_id dan product_id.

Penyesuaian menambah atau mengurangi stok dan langsung diposting, sama seperti penyesuaian stok yang dikirim di Portal. type adalah addition (bawaan) atau subtraction, dan qty selalu positif. Kosongkan store_id untuk memakai outlet pertama Anda.

curl https://api.bakasir.com/v1/stock/adjustments \
  -H "Authorization: Bearer bak_kunci_anda" \
  -H "Idempotency-Key: adj-2026-11-04-001" \
  -H "Content-Type: application/json" \
  -d '{
    "store_id": "01K9ZT6Q2X3M8N4V7B5C1D0STO",
    "reason": "correction",
    "note": "Hitung gudang",
    "items": [
      {"product_id": "01K9ZT6Q2X3M8N4V7B5C1D0EFG", "qty": 12, "type": "addition"},
      {"product_id": "01K9ZT6Q2X3M8N4V7B5C1D0HIJ", "qty": 2, "type": "subtraction"}
    ]
  }'

Maksimal 200 baris per permintaan. Outlet atau produk yang tidak dikenal mengembalikan 422.

PelangganSalin tautan

Filter daftar dengan search (nama, email, atau telepon). name wajib untuk membuat pelanggan. Poin loyalitas, tier, dan saldo awal tidak bisa diatur lewat API.

PenjualanSalin tautan

Setiap penjualan menyertakan items dan payments. Filter: status (satu atau daftar dipisah koma seperti completed,partially_refunded), customer_id, store_id, serta from dan to pada waktu penjualan.

curl "https://api.bakasir.com/v1/sales?status=completed&from=2026-11-01&to=2026-11-05&limit=100" \
  -H "Authorization: Bearer bak_kunci_anda"

Penjualan di outlet Demo tidak pernah dikembalikan.

Pesanan onlineSalin tautan

Pesanan yang masuk dari toko online Anda. Filter: status (ordered, processing, delivering, completed, canceled), payment (status pembayaran), from, dan to. Pesanan tunggal juga mengembalikan lines. Pakai sale_id untuk mencocokkan pesanan dengan /v1/sales/{id}.