Panduan Penggunaan

Bot ini secara otomatis memperbarui harga produkmu di Itemku agar selalu lebih murah dari kompetitor, dengan selisih yang bisa kamu tentukan sendiri.

🔍 Ambil harga top 1

→

➖ Kurangi mines

→

✅ Update harga

→

⏱ Tunggu interval

→

🔄 Ulangi

Contoh Top 1 menjual 568 Diamonds @ Rp 140.699 · Mines = 5 · Harga kamu jadi Rp 140.694

Yang perlu disiapkan sebelum mulai

Pilih salah satu mode di Pengaturan: API Key atau Cookie. Kedua mode dibuat eksklusif; saat Cookie aktif, Produk API tidak dipakai, dan saat API aktif, Produk Cookie tidak dipakai.

API Key & Secret dari dashboard seller Itemku — isi di menu Pengaturan
product_id untuk setiap produk yang ingin diupdate — isi di menu Produk
Aktifkan toggle pada produk yang mau dimonitor
Klik Mulai Auto di topbar

Produk API vs Produk Cookie

Produk API adalah daftar acuan manual. item_info_id dipakai untuk market/top seller, sedangkan product_id dipakai untuk update produkmu.
Produk Cookie diambil dari akun lewat tombol Import Produk.
Produk cookie hanya disimpan jika item_info_id-nya sudah ada di Produk API.
Jika import menampilkan modal produk dilewati, tambahkan dulu item_info_id itu secara manual di Produk API, lalu import ulang.
Produk hasil import default nonaktif. Aktifkan toggle produk yang ingin diproses.

Kelola Produk

Setiap produk Diamond perlu dikonfigurasi sebelum bisa diupdate otomatis.

Field	Keterangan
Toggle	Aktif/nonaktif. Produk yang nonaktif dilewati setiap siklus.
product_id	ID produk milikmu di Itemku. Lihat di URL halaman edit produk kamu: `tokoku.itemku.com/dagangan/1018873/edit`
Mines	Selisih harga dari top 1. Harga kamu = harga top1 − mines
Min harga	Batas bawah harga. Bot skip produk ini jika hasil kalkulasi lebih rendah. Kosongkan = tidak ada batas.

product_id harus milikmu sendiri, bukan ID produk kompetitor. Salah isi → error INVALID_PRODUCT.

Mode Cookie

Pilih Cookie di Pengaturan Autentikasi.
Paste cookie lengkap dari request tokoku-gateway, lalu klik Simpan.
Klik Import Produk untuk mengambil produk langsung dari akun Itemku.
Produk cookie hanya disimpan jika item_info_id-nya sudah ada di Produk API.
Aktifkan produk di tab Produk Cookie sebelum klik Mulai Auto.

API dan Cookie tidak bisa dipakai bersamaan. Saat mode Cookie aktif, Produk API tidak diproses; saat mode API aktif, Produk Cookie tidak diproses.

Mines & Min Harga

Mines

Selisih harga yang dipotong dari harga top 1 kompetitor. Bisa diset berbeda per produk, atau gunakan nilai default dari Pengaturan.

Contoh mines = 100 Top 1 @ Rp 145.000 → harga kamu = Rp 144.900

Min Harga

Pelindung agar hargamu tidak turun terlalu jauh. Berguna saat kompetitor "perang harga" ekstrem.

Contoh min harga = 130.000 Top 1 @ Rp 130.003, mines = 5 → hasil = Rp 129.998 → lebih rendah dari min → produk diskip

Mines minimal 1 poin. Min harga boleh dikosongkan jika tidak ingin ada batas bawah.

Monitor Kompetitor

Lihat semua seller yang menjual produk yang sama, beserta harga, rating, stok, dan waktu delivery mereka.

Pilih produk dari tab di atas tabel (hanya produk aktif yang muncul)
Klik Refresh untuk ambil data terbaru
Sortir berdasarkan harga, rating, atau pesanan terbanyak
Cari nama toko tertentu di kolom pencarian

Label di tabel

Target — Seller pertama yang valid, harga ini dijadikan acuan
Toko saya — Masuk daftar whitelist toko sendiri
Skip — Masuk daftar kompetitor yang tidak mau disalip

Tombol aksi per seller

Skip — Tambahkan ke daftar kompetitor yang dilewati
Milikku — Tandai sebagai toko sendiri

Setelah klik Skip atau Milikku dari tabel, buka halaman Whitelist Toko dan klik Simpan Whitelist agar perubahan tersimpan.

Order API

Menu Order API memakai Tokoku Open API resmi dari API Key dan API Secret. Fitur ini khusus mode API Key, bukan mode Cookie.

Kalau Pengaturan sedang memakai mode Cookie, endpoint order akan ditolak. Pindahkan dulu ke mode API Key dan isi API Key/Secret.

Get Order

Dipakai untuk mengambil daftar order dari akun seller.

Field	Wajib	Keterangan
`date_start`	Ya	Format `YYYY-MM-DD`. Maksimal sekitar 2 bulan ke belakang.
`order_id`	Tidak	Isi jika ingin mencari order tertentu.
`order_status`	Tidak	`REQUIRE_PROCESS`, `DELIVERED`, atau `REFUNDED`.
`limit`	Tidak	Jumlah data 1 sampai 30, default 10.

Order Action

Dipakai untuk memproses order dari hasil Get Order.

Field	Wajib	Keterangan
`order_id`	Ya	ID order yang mau diproses.
`action`	Ya	`DELIVER` untuk kirim pesanan, `REJECT` untuk refund/tolak.
`refund_reason`	Saat REJECT	Alasan refund, misalnya `NO_STOCK`, `SERVER_ERROR`, atau `PRICE_CHANGED`.
`delivery_info`	Saat diperlukan	JSON untuk data pengiriman. Voucher bisa berupa `["CODE1","CODE2"]`; akun bisa berupa array object seperti `[{"email":"a@b.com","password":"secret"}]`.

Untuk topup tertentu, delivery_info bisa kosong. Untuk voucher atau akun, isi sesuai field yang diminta order dari Itemku.

Order Callback

Itemku bisa mengirim notifikasi order ke endpoint callback seller saat order dibayar buyer. Di panel ini, URL callback lokalnya adalah /api/order/callback; saat dipasang ke Itemku, gunakan URL publik server kamu yang mengarah ke endpoint itu.

Request method: POST
Header dari Itemku: X-itemku: {shop_id}
Body utama: {"data":[...]} berisi order dengan status seperti REQUIRE_PROCESS
Callback disimpan idempotent memakai order_id, jadi retry dari Itemku tidak membuat data dobel.
Itemku membutuhkan DNS TXT v-api-itemku-{SHOPNAME}=1 untuk verifikasi domain callback.

Auto Deliver

Auto deliver bisa diaktifkan dari Pengaturan Scheduler. Setelah callback order masuk, sistem menunggu sesuai delay ms lalu mengirim Order Action: DELIVER ke Itemku.

Auto deliver hanya memproses order REQUIRE_PROCESS yang tidak membutuhkan delivery_info. Order voucher/akun yang butuh kode, email, password, atau data lain tetap ditandai butuh proses di tabel Order List.

Whitelist Toko

Dua daftar toko yang menentukan siapa yang diabaikan saat bot mencari harga acuan.

🏠 Toko Milikku

Toko akunmu sendiri. Bot tidak akan "bersaing dengan diri sendiri" — toko ini dilewati saat mencari target.

🚫 Kompetitor Tidak Mau Disalip

Seller tertentu yang ingin kamu biarkan tetap lebih murah dari kamu. Bot melewati mereka dan menggunakan seller valid berikutnya sebagai acuan.

Contoh skenario Seller urutan: A (Rp 140.000) · B (Rp 141.000) · C (Rp 142.000)
→ A = toko sendiri → dilewati
→ B = di skip list → dilewati
→ C jadi target → harga kamu = Rp 141.995 (mines 5)

Cara menambah toko

Ketik nama toko di kotak input → tekan Enter
Nama harus persis seperti di Itemku (tidak case-sensitive)
Klik × pada tag untuk hapus

Wajib klik "Simpan Whitelist" setelah mengubah daftar. Perubahan tidak tersimpan otomatis.

Price Log

Riwayat semua aktivitas update harga. Setiap entri mencatat: waktu, nama produk, nama toko top 1, harga acuan, harga baru yang dikirim, dan status hasilnya.

Klik Refresh untuk memuat entri terbaru
Gunakan tombol Sebelumnya, angka halaman, dan Berikutnya untuk pindah halaman
Pilih 10/page, 20/page, 25/page, 50/page, atau 100/page untuk mengatur jumlah baris
Klik Hapus semua untuk bersihkan seluruh riwayat

API & Cookie

Diperlukan agar bot bisa mengirim update harga ke Itemku. Tanpa ini, tombol Mulai Auto tidak akan berfungsi.

Cara mendapatkan

Login ke Itemku sebagai seller
Masuk ke Pengaturan Toko → Integrasi API
Salin API Key dan API Secret

Cara mengisi

Buka menu Pengaturan di sidebar
Paste API Key dan API Secret di kolom yang tersedia
Klik Simpan Credentials

Setelah tersimpan, status berubah jadi ✓ API Key dan Secret sudah ada dan auto update siap digunakan.

Mode Cookie

Pilih Cookie di Pengaturan Autentikasi.
Paste cookie lengkap dari request tokoku-gateway, lalu klik Simpan.
Klik Import Produk untuk mengambil produk langsung dari akun Itemku.
Produk cookie hanya disimpan jika item_info_id-nya sudah ada di Produk API.
Aktifkan produk di tab Produk Cookie sebelum klik Mulai Auto.

API dan Cookie tidak bisa dipakai bersamaan. Saat mode Cookie aktif, Produk API tidak diproses; saat mode API aktif, Produk Cookie tidak diproses.

Interval & Jeda

Setting	Default	Keterangan
Interval	`600` detik	Jeda antar siklus update (10 menit). Jangan terlalu kecil — Itemku punya batas update harga per hari.
Default mines	`5`	Mines yang dipakai jika produk tidak punya mines sendiri.
Jeda antar produk	`1200` ms	Waktu tunggu antar produk dalam satu siklus. Jangan terlalu kecil.

Itemku membatasi jumlah perubahan harga per produk per hari. Terlalu sering update → error TOO_MANY_PRICE_CHANGE. Disarankan interval minimal 10 menit.

Ganti Password

Tersedia di Pengaturan → Login Admin Panel.

Isi username baru (boleh sama jika tidak ingin ganti)
Isi password saat ini sebagai verifikasi — wajib diisi
Isi password baru, atau kosongkan jika tidak ingin ganti
Setelah simpan, semua sesi aktif langsung logout — login ulang diperlukan

Status & Badge

Badge	Arti
Proses...	Sedang fetch harga atau mengirim update
Berhasil	Harga berhasil diperbarui di Itemku
Error	Terjadi kesalahan — cek Price Log untuk detail
Limit!	Batas update harian tercapai, otomatis coba lagi besok
Dilewati	product_id kosong, di bawah min harga, atau semua seller di-whitelist
Menunggu	Belum pernah diproses sejak terakhir kali dijalankan

Error Codes

Error	Penyebab & Solusi
`TOO_MANY_PRICE_CHANGE`	Batas update harian produk ini sudah habis. Tunggu hingga esok hari, atau perbesar interval.
`INVALID_PRODUCT`	product_id salah atau bukan milik akunmu. Pastikan mengisi ID produkmu sendiri, bukan ID kompetitor.
API Key/Secret belum diisi	Credentials belum dikonfigurasi di menu Pengaturan.
market kosong	Tidak ada data seller (kemungkinan timeout jaringan). Bot otomatis coba lagi di siklus berikutnya.
semua seller di-skip	Semua seller masuk whitelist/skip. Tinjau ulang daftar di Whitelist Toko.
di bawah batas min	Harga hasil kalkulasi lebih rendah dari Min harga. Naikkan nilai Min harga atau kosongkan.