Integrasi Desty — Harga Online & Auto-Pricing

Terakhir diperbarui / Last updated: 21 September 2026 · Versi / Version: 1.5

---

Ringkasan / Overview

Integrasi Desty menghitung otomatis Harga Online untuk marketplace (Shopee, Tokopedia, TikTok Shop, Lazada) dari Harga Jual Offline produk Anda di FirstJournal, lalu mengirimkannya ke akun Desty Anda. Ada dua mode:

• Mode Manual — Anda mendaftarkan produk yang ingin ikut, meninjau harga hasil hitungan, lalu menekan tombol "Sync ke Marketplace" sendiri setiap kali harga berubah.
• Mode Otomatis (Auto-Pricing) — sekali diaktifkan, setiap perubahan Harga Jual Offline pada produk yang terdaftar dihitung ulang dan dikirim ke Desty secara otomatis dalam beberapa menit, tanpa perlu klik manual. Perubahan harga yang jauh dari kewajaran (misalnya salah ketik harga) tidak langsung dikirim — ditahan dulu di Antrian Menunggu Konfirmasi untuk Anda tinjau.

Untuk siapa: Owner/Admin yang menjual produk yang sama di toko fisik/offline dan di marketplace, dan ingin harga di kedua tempat selalu selaras tanpa harus mengubah manual di dua sistem.

Ambil 3 informasi berikut dari dashboard Desty Anda sendiri (menu "Apply Authorization" atau sejenisnya), lalu masukkan ke form di halaman Integrasi Desty:

• Apply ID
• Username
• Nomor HP

Setelah disimpan, sistem langsung meminta access token ke Desty. Kalau berhasil, status berubah menjadi "Terhubung" dengan tanggal token berlaku.

Penting: kredensial ini bersifat rahasia dan langsung dienkripsi begitu disimpan — jangan bagikan Apply ID/Username Anda ke pihak lain.

Di bagian Formula Harga Online, atur:

• Mode — Markup % (persentase dari Harga Jual Offline) atau Markup Rp (nominal tetap).
• Nilai — angka markup-nya (contoh: 40 untuk +40%).
• Bulatkan ke — kelipatan pembulatan hasil akhir (contoh: Rp100, Rp500, Rp1.000) supaya harga di marketplace terlihat rapi (mis. Rp114.100 dibulatkan, bukan angka ganjil hasil kalkulasi mentah).

HPP (harga pokok penjualan) TIDAK pernah dipakai sebagai input formula ini — hanya ditampilkan sebagai referensi margin di beberapa laporan. Formula murni: Harga Online = Harga Jual Offline + markup.

Tekan "Simpan Formula" untuk menyimpan.

1. Cari produk lewat kotak "Cari nama produk atau SKU..." di bagian Produk & Status Sync.
2. Daftarkan produk yang ingin ikut — preview Harga Online langsung muncul di baris produk itu.
3. Centang satu atau beberapa produk terdaftar, lalu tekan "Sync ke Marketplace".
4. Modal hasil menampilkan "✓ berhasil / ✗ gagal" per produk beserta alasannya jika gagal, plus tombol "Coba Sync Ulang yang Gagal" khusus untuk yang error.

Batas per klik: maksimal 50 produk (Desty tidak punya endpoint kirim massal — setiap produk dikirim satu per satu). Produk lebih dari itu perlu diklik ulang.

Fitur Auto-Pricing Policy membuat Harga Online selalu mengikuti Harga Jual Offline tanpa Anda perlu klik sync manual lagi.

1. Aktifkan toggle "Otomatis" di halaman Integrasi Desty. Karena ini menyangkut SEMUA produk sekaligus (termasuk yang belum pernah terdaftar), akan muncul jendela konfirmasi dengan pratinjau dampak — misalnya "342 produk akan disesuaikan: 298 naik rata-rata +12%, 44 turun rata-rata -4%. 9 produk di luar batas wajar akan masuk antrian konfirmasi dulu." Tinjau angka ini sebelum menekan "Ya, Aktifkan".
2. Setelah aktif, setiap kali Harga Jual Offline sebuah produk terdaftar berubah (baik diedit satu-satu maupun lewat import Excel/CSV), harga barunya dihitung ulang dan dikirim ke Desty secara otomatis dalam 2–5 menit, tanpa perlu klik apa pun.
3. Produk baru otomatis ikut mode Auto-Pricing begitu dibuat — kecuali Anda tandai "Jangan jual di marketplace" di halaman edit produk tersebut.

Jaring pengaman (Circuit-Breaker): kalau perubahan harga baru menyimpang jauh (lebih dari 30%) dari harga terakhir yang berhasil dikirim, sistem TIDAK langsung mengirimnya — produk itu masuk ke zona "Perlu Perhatian" dan Anda diberi notifikasi. Ini mencegah kesalahan input harga (misalnya salah ketik Rp150.000 jadi Rp15.000) langsung tayang di Shopee untuk banyak produk sekaligus.

Di zona Perlu Perhatian, produk yang ditahan dikelompokkan begini — (update 21 September 2026) setiap kelompok sekarang punya judul sendiri dengan jumlah asli (mis. "Menunggu Konfirmasi Harga — 1.837"), jadi tombol "Setujui Semua..." selalu jelas mengacu ke baris di bawahnya, bukan tercampur dengan kelompok lain:

• Belum Pernah Sync — ini BUKAN kasus harga aneh, cuma produk yang belum pernah dikonfirmasi sama sekali (paling sering muncul BANYAK sekaligus tepat setelah Anda pertama kali mengaktifkan Auto-Pricing — bisa ribuan produk dalam satu waktu, karena belum ada harga pembanding untuk dibandingkan). Ada tombol "Setujui Semua yang Belum Pernah Sync" untuk menyetujui semuanya sekaligus dalam satu klik — sistem akan memprosesnya bertahap di belakang layar (bukan langsung push semua serentak), biasanya selesai dalam beberapa menit. (Baru 2026-09-18) Kalau di antara produk itu ada yang harga hitungannya ternyata DI BAWAH HPP (misalnya karena harga jual lama yang belum pernah diupdate), produk itu TIDAK ikut disetujui — tetap ditahan menunggu review manual satu per satu, dan jumlahnya akan disebutkan di notifikasi setelah klik ("X produk tidak ikut disetujui karena harganya di bawah HPP").
• Dekat Batas Wajar — produk yang SUDAH pernah tersinkron sebelumnya, dengan deviasi harga baru yang masih relatif kecil — ada tombol "Setujui Semua" terpisah untuk menyetujui sekaligus.
• Jauh dari Batas — produk yang sudah pernah tersinkron tapi harga barunya menyimpang besar dari harga terakhir — kemungkinan besar salah input, wajib ditinjau dan disetujui/ditolak satu per satu.

Halaman "Produk & Status Sync" — ringkasan dulu, bukan tabel ribuan baris (update 2 September 2026): karena produk terdaftar bisa mencapai ribuan, halaman ini TIDAK langsung menampilkan tabel semua produk. Yang tampil duluan adalah Health Bar — 4 angka ringkas: Tersinkron, Dalam Antrean, Gagal, dan Ditahan (klik salah satu angka untuk memfilter tabel ke status itu). Kalau semua sehat, zona Perlu Perhatian otomatis hilang dari layar — itu sengaja, bukan bug, tandanya semuanya baik-baik saja. Kalau ingin melihat/mencari produk tertentu, klik "Lihat Semua Produk" untuk membuka tabel lengkap (bisa dicari & difilter, dimuat 50 produk per halaman).

Gagal & dicoba ulang otomatis, maksimal 3 kali: kalau pengiriman ke Desty gagal (misalnya rate limit sementara), sistem otomatis mencoba lagi di siklus berikutnya — sampai maksimal 3 kali percobaan. Selama masih di bawah 3x, status produk itu "Gagal — dicoba lagi" (warna netral, tidak perlu tindakan apa pun dari Anda). Kalau percobaan ke-3 tetap gagal, sistem BERHENTI mencoba otomatis dan statusnya jadi "Gagal permanen" (warna merah) — Anda perlu klik tombol "Coba Lagi" secara manual.

Tombol "Push Semua Sekarang": kalau Anda tidak mau menunggu siklus otomatis 2-5 menit (misalnya baru saja mengubah banyak harga sekaligus dan ingin segera tayang), tekan tombol ini untuk memproses antrean langsung. Aman ditekan berkali-kali — ada penguncian internal supaya tidak terjadi proses ganda.

Override manual tetap berfungsi: kalau Anda mengatur harga marketplace secara manual lewat halaman Laporan → Analytics Marketplace untuk 1 produk tertentu, harga otomatis TIDAK akan menimpanya sampai override tersebut Anda hapus sendiri.

Q: Apakah Auto-Pricing langsung menyapu semua produk lama saya begitu diaktifkan? A: Ya, sekali — saat pertama kali diaktifkan, sistem mendaftarkan semua produk yang memenuhi syarat (aktif, punya SKU, harga jual > Rp0, bukan produk pesanan khusus) secara otomatis, tapi Anda akan melihat pratinjau dampaknya dulu sebelum benar-benar dieksekusi.

Q: Bagaimana kalau saya tidak mau satu produk tertentu ikut Auto-Pricing? A: Ada 2 cara — aktifkan toggle "Jangan jual di marketplace" di halaman edit produk tersebut, atau klik tombol "Kecualikan" langsung di tabel "Lihat Semua Produk" (keduanya sama, cuma 2 pintu masuk berbeda). Produk itu tidak akan pernah didaftarkan/disinkronkan otomatis lagi, walau Auto-Pricing aktif — dan harga terakhir yang sudah tayang di Desty dibiarkan apa adanya, tidak dihapus.

Q: Kenapa harga sebuah produk saya "ditahan", bukan langsung tayang? A: Karena perubahan harganya menyimpang lebih dari 30% dari harga terakhir yang berhasil dikirim ke Desty — sistem sengaja menahannya di zona "Perlu Perhatian" untuk Anda tinjau dulu, mencegah kesalahan input tayang otomatis.

Q: Kenapa halaman ini tidak langsung menampilkan semua produk saya? A: Kalau produk terdaftar sudah ribuan, menampilkan semuanya sekaligus akan membuat halaman sangat berat. Yang tampil duluan adalah ringkasan (Health Bar) — klik "Lihat Semua Produk" untuk membuka tabel lengkap yang bisa dicari & difilter, dimuat 50 produk per halaman.

Q: Apa bedanya status "Gagal — dicoba lagi" dan "Gagal permanen"? A: "Gagal — dicoba lagi" artinya sistem masih mencoba otomatis (percobaan ke-1 atau ke-2 dari maksimal 3) — tidak perlu tindakan apa pun. "Gagal permanen" artinya sudah 3x dicoba dan tetap gagal, sistem berhenti mencoba otomatis — Anda perlu klik "Coba Lagi" secara manual.

Q: Apakah HPP (harga pokok) ikut memengaruhi Harga Online? A: Tidak. Harga Online murni dihitung dari Harga Jual Offline + markup. HPP hanya referensi margin, tidak pernah jadi bagian rumus ini.

Q: Siapa yang bisa mengatur integrasi Desty ini? A: Owner/Admin. Menyetujui harga yang ditahan di zona Perlu Perhatian punya izin tersendiri (terpisah dari izin sync biasa) agar tetap ada jejak siapa yang menyetujui perubahan harga ekstrem.