Glosarium

Istilah yang sering muncul di OtoSwitch dan Digiflazz, beserta artinya.

Buyer

Akun Digiflazz yang membeli produk dari supplier. OtoSwitch dipakai oleh buyer untuk otomasi pemilihan supplier. Akun di Digiflazz: member.digiflazz.com.

Supplier (Seller)

Penjual produk di Digiflazz. Buyer memilih supplier untuk setiap SKU produk yang dijual ulang.

SKU (Stock Keeping Unit)

Kode unik produk. Mis. AXIS5K untuk pulsa Axis 5.000.

Buyer Product / Product ID

Produk di sisi buyer. Field penting:

  • id — ID buyer product (untuk endpoint /seller/{id}).
  • product_id — ID produk dasar Digiflazz, dishare oleh sibling (untuk Zone Management).

Sibling

Produk-produk yang share product_id Digiflazz yang sama. Berbeda di sisi buyer (mis. dijual ke zona berbeda) tapi sumber supplier-nya sama.

Max Price

Harga maksimal yang diizinkan untuk produk ini. Kalau supplier kasih harga > max_price, produk ditandai PRICE_EXCEEDS_MAX.

Connection / Tipe Koneksi

Cara supplier menyediakan API:

  • IP — direct API. Cepat dan stabil. Default skor 100.
  • H2H (Host-to-Host) — bridge via gateway pihak ketiga. Sedikit lebih lambat. Default skor 70.

SLA (Service Level Agreement)

Janji waktu proses transaksi:

  • H+0 — proses real-time / hari yang sama. Default skor 100.
  • H+1 — proses besok. Default skor 60.
  • H+2 — proses lusa. Default skor 30.

Faktur Pajak

Supplier menyediakan faktur pajak (PPN). Ditandai ✓ di tab Penjual.

Status Produk

  • Aktif — dijual / available.
  • Nonaktif — di-disable buyer.

Status Supplier (status_sellerSku)

  • 1 — supplier aktif menjual produk ini.
  • 0 — supplier nonaktif. Akan ditandai sebagai gangguan.

Dry-run

Mode preview — OtoSwitch hanya simulasi tanpa apply perubahan ke Digiflazz. Aman untuk testing.

Auto-switch

Saat scan menemukan produk gangguan, OtoSwitch otomatis switch ke supplier terbaik berikutnya tanpa konfirmasi manual.

Kunci dari Otomasi (Exclusion)

Penanda manual agar sebuah produk dibekukan dari semua mekanisme otomatis — auto-switch, auto-update max price, dan proactive scan. Bisa di-set per produk, per brand, per kategori, atau per tipe (disimpan pakai id). Aksi manual tetap bisa dilakukan. Berbeda dari Blocked Seller yang membatasi supplier, kunci ini membatasi produk. Detail: Produk → Kunci dari Otomasi.

Aturan Seller per Produk (Criteria Override)

Kriteria pemilihan supplier (min rating, stok, faktur, multi) yang berbeda per produk/brand/kategori/tipe, menimpa kriteria global. Bersifat partial — hanya field yang di-set yang ditimpa, sisanya ikut global. Precedence dari spesifik ke umum: produk > tipe > brand > kategori. Berlaku di semua jalur otomasi (auto-switch, zone, proactive). Detail: Produk → Aturan Seller per Produk.

Scoring

Algoritma multi-faktor untuk meranking supplier kandidat. Detail: Algoritma Scoring.

Preferred Seller

Supplier yang ditandai preferred lokal di OtoSwitch. Dapat bonus +20 di scoring.

Blocked Seller

Supplier yang di-block di OtoSwitch. Tidak akan pernah dipilih otomatis.

Favorite Seller

Penanda di Digiflazz native (sync via API). Tidak mempengaruhi scoring OtoSwitch.

Zone (Zona)

Sistem untuk membagi supplier per region. Detail: Grup Produk.

Rule (di Zone)

Pattern matching deskripsi supplier. Mis. patterns ["sumatra", "all region"] cocok dengan supplier yang deskripsinya mengandung kedua kata.

Group (di Zone)

Kumpulan buyer products yang share product_id Digiflazz.

Assignment (di Zone)

Hubungan satu buyer product ke satu group + satu rule.

Change Detection

Sistem deteksi perubahan antar siklus scan. Detail: Change Detection.

Snapshot

Foto state produk di satu siklus scan. Disimpan untuk dibandingkan dengan snapshot berikutnya.

Smart Intervals

Kategori prioritas yang menentukan frekuensi scan:

  • critical — setiap cycle.
  • normal — setiap 2 cycle.
  • low — setiap 4 cycle.

Proactive Scan

Pencarian supplier lebih murah secara proaktif untuk produk sehat. Detail: Proactive Scan.

NO_SELLER

Penyebab gangguan: tidak ada supplier terpasang di produk.

PRICE_EXCEEDS_MAX

Penyebab gangguan: harga supplier melebihi max_price.

PRODUCT_INACTIVE

Penyebab gangguan: supplier valid tapi statusnya nonaktif.

Severity

Tingkat keparahan perubahan:

  • 🔴 critical — supplier mati, produk hilang.
  • 🟡 warning — harga naik signifikan, supplier ganti.
  • 🔵 info — harga turun, produk baru, status pulih.

Rate Limit

Batas request per menit. Server Digiflazz limit 120/menit. OtoSwitch default 100 (safety margin).

Token Bucket

Algoritma rate-limiting di OtoSwitch. Sliding window 60 detik dengan kapasitas tetap.

Webhook

Callback HTTP dari payment gateway saat status pembayaran berubah. OtoSwitch terima di endpoint /api/billing/callback/<gateway>.

ETag

Header HTTP untuk caching. Server kasih ETag untuk respons; client kirim balik di If-None-Match di request berikut. Kalau data sama, server return 304 (hemat bandwidth).

NDJSON (Newline-Delimited JSON)

Format streaming: satu objek JSON per baris. Cocok untuk processing baris-per-baris tanpa load semua ke memory.

JWT (JSON Web Token)

Token autentikasi yang dipakai OtoSwitch SaaS. Cookie jwt_access_token di browser.

CSRF / XSRF Token

Token anti-CSRF untuk request ke Digiflazz. Dibutuhkan di header request, diambil saat setup cookies.

Remember Me Cookie

Cookie remember_web_* dari Laravel (Digiflazz pakai Laravel). Berlaku 1 tahun, dipakai OtoSwitch untuk auto-refresh sesi tiap 2 hari.

Plan

Tier langganan: Trial / Basic / Pro. Detail: Langganan & Billing.

Prorate

Konversi sisa hari plan lama jadi bonus hari di plan baru saat upgrade. Tidak ada yang hangus.

Subscription

Status langganan user di OtoSwitch. Field utama: status (active/expired/cancelled), expires_at, plan_slug.

Invoice / Order

Catatan pembelian. Status: pending / paid / expired / cancelled / failed.

Gateway

Penyedia jasa pembayaran. OtoSwitch support 3:

  • DompetX — multi-method (VA, e-wallet).
  • Duitku — multi-method, butuh kode metode di order.
  • QRIS Static — QR statis dengan unique amount matching.

API Key

Kunci untuk akses endpoint server-to-server /api/v1/*. Format otsk_<43 chars>. Detail: API Keys.