Lewati ke konten

Endpoint API

Basis URL: https://navv-ci-core.navvigasi.workers.dev. Semua respons memakai amplop { data, requestId } atau { error, requestId }.

Kolom Akses: D = token perangkat (POS), A = sesi owner/manajer (backoffice), M = manajer atau owner (token backoffice, atau perangkat + X-Staff-Token manajer), P = publik, T = D atau A dengan tenant.

Endpoint Akses Fungsi
POST /v1/devices/bootstrap P Mode demo: buat toko anonim + perangkat
GET /v1/devices/me D Identitas perangkat (dipakai saat pairing)
POST /v1/owner/pairings A Buat kode pairing perangkat
GET /v1/owner/devices A Daftar perangkat
POST /v1/owner/devices/:id/revoke A Putuskan perangkat
GET /v1/staff/roster D Staf aktif untuk layar PIN
POST /v1/staff/login D Login PIN → staffToken
POST /v1/staff/logout D Cabut sesi staf
GET/POST /v1/staff, PATCH /v1/staff/:id A Kelola staf
GET /v1/shifts/current D Shift terbuka perangkat
POST /v1/shifts/open, POST /v1/shifts/:id/close D Buka/tutup shift
GET /v1/shifts T Riwayat shift
GET /v1/outlet/settings T Pajak, service, struk, slug
PUT /v1/outlet/settings M Ubah pengaturan outlet
Endpoint Akses Fungsi
POST /v1/auth/owner/register P Daftar bisnis + owner
POST /v1/auth/owner/login P Login owner/manajer
GET /v1/auth/me A Profil sesi, tenant, outlet
POST /v1/auth/logout A Cabut sesi
Endpoint Akses Fungsi
POST /v1/sales/sync D (+staf) Kirim penjualan (maks 50, idempoten)
GET /v1/sales, GET /v1/sales/:id T Daftar dan detail
POST /v1/sales/:id/void M Batalkan penjualan
POST /v1/orders/sync D (+staf) Kirim pesanan F&B
GET /v1/orders?kitchen=&source=&from=&to=&lines=1 T Daftar pesanan
GET /v1/orders/:id T Detail
PATCH /v1/orders/:id/kitchen T Ubah status dapur
POST /v1/orders/:id/pay D Bayar order belum lunas
POST /v1/orders/:id/accept / reject D Terima/tolak self-order
POST /v1/orders/:id/void M Batalkan pesanan
Endpoint Akses Fungsi
GET /v1/store-products, /low-stock, /:id T Daftar jual toko
PUT /v1/store-products/:id, DELETE T Upsert, arsip
POST /v1/store-products/:id/stock-adjust M Penyesuaian stok
GET /v1/store-products/:id/stock-movements T Riwayat stok
POST /v1/lookup, POST /v1/lookup/photo D Cari di katalog bersama
POST /v1/matches/products, POST /v1/mappings D Cocokkan produk toko ke katalog
GET /v1/menu-items D Menu aktif (POS F&B)
POST /v1/matches/menu D Cocokkan satu nama menu
POST /v1/menu/parse, POST /v1/menu/voice D Parser teks dan suara
GET/POST /v1/menus, GET/POST /v1/menus/:id/items, PATCH/DELETE .../items/:itemId, POST .../publish A Kelola menu
GET/POST /v1/customers T Pelanggan sederhana
Endpoint Akses Fungsi
GET /v1/tables, POST, PATCH /:id T / M Meja
GET /v1/tables/:id/qr M Token + path QR meja
GET /v1/reports/sales?from=&to= A Laporan penjualan
GET /v1/public/outlets/:slug/menu P Menu self-order
GET /v1/public/qr/resolve?t= P Validasi QR meja
POST /v1/public/orders P (+Idempotency-Key) Buat pesanan pelanggan
GET /v1/public/orders/:id?token= P Status pesanan
Header Dipakai untuk
Authorization: Bearer ... Token perangkat atau sesi backoffice
X-Staff-Token Sesi PIN kasir pada request POS
Idempotency-Key Wajib pada POST /v1/public/orders (8–80 karakter)