Modul Katalog Produk & Stok v1.0
Sinkronisasi Katalog Produk, Harga & Ketersediaan Stok
Integrasikan database katalog produk toko Anda ke e-commerce eksternal, marketplace, mesin POS kasir pihak ketiga, atau aplikasi mobile secara otomatis.
1. Tarik Daftar Katalog Produk (List)
GET
https://toko.rumren.id/api?action=external_products_list&limit=50&page=1
Parameter Query:
| Parameter | Tipe | Status | Keterangan |
|---|---|---|---|
| category_id | integer | Opsional | Filter ID Kategori produk. |
| is_available | integer | Opsional | Status aktif produk: 1 (Tersedia) atau 0 (Habis). |
| q | string | Opsional | Pencarian nama produk, barcode, atau SKU. |
| limit | integer | Opsional | Batas jumlah produk per halaman (default: 50, max: 100). |
| page | integer | Opsional | Nomor halaman paginasi (default: 1). |
Contoh Response Sukses (200 OK):
Status: 200 OK
{
"status": "success",
"total": 45,
"page": 1,
"limit": 50,
"products": [
{
"id": 12,
"name": "Signature Milk Tea with Boba",
"slug": "signature-milk-tea-boba",
"category_id": 2,
"category_name": "Signature Milk Tea",
"price": 28000,
"promo_price": 24000,
"wholesale_price": 22000,
"wholesale_min_qty": 10,
"barcode": "899123456001",
"sku": "TEA-BOBA-01",
"business_type": "fnb",
"image_url": "uploads/products/milk-tea-boba.webp",
"description": "Teh susu khas Taiwan dengan boba kenyal gula aren.",
"is_available": true,
"is_best_seller": true,
"is_new": false,
"custom_fields": null
}
]
}
2. Detail Lengkap Produk, Varian & Add-on
GET
https://toko.rumren.id/api?action=external_product_detail&id=12
Endpoint ini mengembalikan rincian komprehensif termasuk daftar pilihan kustomisasi (Sugar level, Ice level, dll) dan daftar Add-on / Topping terkait.
Parameter Query (Gunakan salah satu):
| Parameter | Tipe | Status | Keterangan |
|---|---|---|---|
| id | integer | Opsional | ID unik produk (contoh: 12). |
| slug | string | Opsional | Slug URL produk (contoh: signature-milk-tea-boba). |
| barcode | string | Opsional | Kode barcode fisik atau SKU produk. |
Contoh Response Sukses (200 OK):
Status: 200 OK
{
"status": "success",
"product": {
"id": 12,
"name": "Signature Milk Tea with Boba",
"slug": "signature-milk-tea-boba",
"category_id": 2,
"category_name": "Signature Milk Tea",
"price": 28000,
"promo_price": 24000,
"barcode": "899123456001",
"sku": "TEA-BOBA-01",
"business_type": "fnb",
"image_url": "uploads/products/milk-tea-boba.webp",
"description": "Teh susu khas Taiwan dengan boba kenyal gula aren.",
"is_available": true,
"is_best_seller": true,
"is_new": false,
"options": [
{
"group_name": "Sugar Level",
"option_name": "Less Sugar (50%)",
"extra_price": 0,
"is_default": 0
},
{
"group_name": "Sugar Level",
"option_name": "Normal Sugar (100%)",
"extra_price": 0,
"is_default": 1
}
],
"addons": [
{
"id": 1,
"name": "Extra Boba",
"price": 4000
},
{
"id": 2,
"name": "Egg Pudding",
"price": 5000
}
]
}
}
3. Perbarui Status Ketersediaan (Stok) & Harga Produk
POST
https://toko.rumren.id/api?action=external_product_update_stock
Parameter Payload JSON (Body):
| Field | Tipe | Status | Keterangan |
|---|---|---|---|
| id | integer | Wajib | ID produk yang akan diupdate. |
| is_available | integer | Opsional | Status stok: 1 (Tersedia) atau 0 (Habis). |
| price | number | Opsional | Perbarui harga reguler produk. |
| promo_price | number | Opsional | Perbarui harga promo (atau kirim null untuk hapus promo). |
Contoh Request Payload JSON:
Content-Type: application/json
{
"id": 12,
"is_available": 1,
"price": 28000,
"promo_price": 25000
}
Contoh Response Sukses (200 OK):
Status: 200 OK
{
"status": "success",
"message": "Status ketersediaan / data produk #12 (Signature Milk Tea with Boba) berhasil diperbarui.",
"product_id": 12
}