Cloud Hub API

Cloud Hub API menyediakan endpoint untuk mengelola data pusat, termasuk master data, keuangan, procurement, HR, dan laporan.

Base URL

https://cloud.retailos.internal/api

Endpoint Utama

Master Data

Method	Endpoint	Keterangan
GET	/products	Daftar produk
GET	/products/:sku	Detail produk
POST	/products	Tambah produk
PUT	/products/:sku	Update produk
GET	/categories	Daftar kategori
GET	/stores	Daftar toko
GET	/suppliers	Daftar supplier

Keuangan

Method	Endpoint	Keterangan
GET	/finance/coa	Chart of Accounts
GET	/finance/journals	Daftar jurnal
POST	/finance/journals	Buat jurnal manual
GET	/finance/settlement	Daftar settlement toko
POST	/finance/settlement/:id/acknowledge	Acknowledge settlement

Procurement

Method	Endpoint	Keterangan
GET	/procurement/po	Daftar PO
POST	/procurement/po	Buat PO
PUT	/procurement/po/:id	Update PO
POST	/procurement/po/:id/approve	Approve PO
POST	/procurement/receiving	Catat penerimaan barang

HR

Method	Endpoint	Keterangan
GET	/hr/employees	Daftar karyawan
POST	/hr/employees	Tambah karyawan
GET	/hr/attendance	Data absensi
POST	/hr/payroll/generate	Generate payroll

Laporan

Method	Endpoint	Keterangan
GET	/reports/sales	Laporan penjualan
GET	/reports/inventory	Laporan inventori
GET	/reports/financial	Laporan keuangan

Monitoring

Method	Endpoint	Keterangan
GET	/monitoring/stores	Status semua toko
GET	/monitoring/sync	Status sinkronisasi
GET	/health	Health check

Contoh Request

Mendapatkan Daftar Produk

GET /api/products?category=minuman&page=1&per_page=20
Authorization: Bearer eyJhbGci...

Response:

{
  "success": true,
  "data": [
    {
      "sku": "8997654321098",
      "name": "Teh Botol Sosro 450ml",
      "category": "Minuman",
      "price": 5000,
      "cost": 3500,
      "stock": {
        "STORE-001": 50,
        "STORE-003": 30,
        "DC-001": 500
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 80
  }
}

Webhook

Cloud Hub bisa mengirim webhook ke sistem eksternal saat event tertentu terjadi:

Event	Keterangan
settlement.submitted	Toko mengirim settlement
po.approved	PO disetujui
stock.low	Stok di bawah minimum
sync.error	Error sinkronisasi