Ingin menghubungkan sistem akuntansi atau situs web brand Anda, atau memungkinkan AI menganalisis data bisnis BigSeller Anda? Panduan ini menjelaskan skenario yang relevan, langkah-langkah onboarding, hal-hal yang perlu dipersiapkan, serta cara menghubungi kami.

Data bisnis Anda di BigSeller — seperti pesanan, inventaris, penagihan, saldo wallet, dan lainnya — dapat dihubungkan sesuai kebutuhan melalui OPEN API untuk:

• Sistem akuntansi — sinkronisasi data bisnis

• Situs web brand sendiri — koordinasi pesanan

• AI Agent — analisis bisnis

Interface dan field akan ditentukan berdasarkan kebutuhan Anda, sedangkan koneksi data aktual dilakukan melalui program integrasi.

---

1. Apa yang Dapat Dilakukan API untuk Anda

API memindahkan data bisnis yang sudah ada di BigSeller ke sistem dan alur kerja yang Anda perlukan. Nilai utamanya meliputi:

Menghubungkan sistem dan mengurangi pekerjaan berulang

Mengambil data bisnis secara terprogram, kemudian mengubah dan memetakan data tersebut sesuai dengan kebutuhan sistem tujuan.

Mengkoordinasikan operasional pesanan dan inventaris

Merancang alur kerja yang terintegrasi berdasarkan kebutuhan seperti memasukkan pesanan dan mengambil data inventaris.

Mendukung analisis dengan laporan Anda sendiri

Menggabungkan API dengan tools BI atau AI Agent untuk menghasilkan analisis bisnis yang disesuaikan dengan kebutuhan tim Anda.

Apa itu BigSeller API dan siapa yang dapat menggunakannya?

API adalah interface yang memungkinkan program eksternal mengakses kemampuan dan data bisnis berdasarkan ketentuan yang telah disepakati.

API cocok untuk pengguna yang ingin menghubungkan BigSeller dengan:

• Software akuntansi

• Situs web brand sendiri

• Sistem internal perusahaan

• Dashboard data

• AI Agent

Jika Anda hanya perlu memeriksa data sesekali, sebaiknya mulai dengan meninjau fitur dan opsi ekspor data yang sudah tersedia.

Pertimbangkan integrasi API jika Anda membutuhkan sinkronisasi berkelanjutan, pemrosesan lintas sistem, atau analisis terjadwal.

---

2. Skenario dan Contoh Penggunaan

Contoh berikut hanya bertujuan membantu Anda menjelaskan kebutuhan integrasi. Contoh tersebut bukan merupakan kasus pelanggan yang telah diterapkan maupun fitur bawaan yang siap digunakan.

Kasus 1 (Koordinasi Situs Web): Situs Web Brand Sendiri — Pemrosesan Pesanan dan Inventaris Tersedia

Kebutuhan Umum

Pesanan dibuat melalui situs web brand dan perlu diproses secara terpusat di BigSeller, sementara situs web menerima informasi jumlah inventaris yang tersedia dari gudang yang telah disepakati.

Alur Data

Pesanan situs web → program integrasi → pemrosesan pesanan di BigSeller

Situs web atau layanan perantara → secara aktif mengambil data inventaris BigSeller → memperbarui jumlah yang tersedia di situs web

Contoh

Setelah pelanggan melakukan pemesanan di situs web, program integrasi memvalidasi detail produk dan pesanan sebelum memasukkannya ke BigSeller.

Situs web mengambil data inventaris pada frekuensi yang telah disepakati dan menyesuaikan jumlah yang ditampilkan berdasarkan aturan safety stock.

Konfirmasi Sebelum Integrasi

• Permission untuk interface pembuatan pesanan

• Pemetaan SKU dan gudang

• Identifikasi pesanan duplikat

• Alur pembatalan dan refund

• Aturan yang memicu penguncian dan pelepasan inventaris

Kriteria Penerimaan

Pengiriman ulang pesanan yang sama tidak boleh membuat pesanan duplikat; SKU yang tidak valid harus dapat dilacak; anomali inventaris harus memicu peringatan.

Penguncian inventaris, pengiriman, dan callback status mengikuti interface dan aturan bisnis yang sebenarnya. Sinkronisasi terjadwal mungkin tetap mengalami keterlambatan, sehingga tidak dapat menjamin tidak akan terjadi overselling sama sekali.

---

Kasus 2 (Koordinasi Akuntansi): Integrasi Kingdee — Mengubah Data Bisnis Menjadi Data yang Siap Digunakan untuk Keuangan

Kebutuhan Umum

Data operasional tersimpan di BigSeller, sedangkan pencatatan dan analisis keuangan dilakukan di Kingdee. Tujuannya adalah mengurangi ekspor manual, pembersihan data, dan input data secara berulang.

Alur Data

Kingdee atau layanan perantara mengambil data dari BigSeller → pembersihan dan pemetaan field → membuat atau mengimpor voucher sesuai aturan Kingdee → rekonsiliasi keuangan

Contoh

Setiap hari, ambil data pesanan, penagihan, dan wallet sesuai cakupan yang telah disepakati.

Kemudian kelompokkan berdasarkan toko, mata uang, dan tanggal bisnis, lalu buat data checklist dan laporan selisih untuk proses rekonsiliasi.

Konfirmasi Sebelum Integrasi

• Versi Kingdee dan kemampuan open API yang tersedia

• Jenis voucher dan pemetaan akun

• Penanganan mata uang dan nilai tukar

• Definisi refund dan biaya

• Pendapatan penjualan, penerimaan pembayaran, dan keuntungan harus didefinisikan secara terpisah dan tidak boleh dicampur

Kriteria Penerimaan

Data sumber harus dapat dilacak, jumlah dan total transaksi harus sesuai setelah rekonsiliasi, dan eksekusi berulang tidak boleh menghasilkan voucher duplikat.

Jika Anda membutuhkan data piutang pada tingkat SKU, konfirmasikan terlebih dahulu kepada Customer Service apakah data tersebut tersedia dan cakupannya.

---

Kasus 3 (Analisis AI Agent): Asisten Analisis Bisnis — Dari Pertanyaan Menjadi Laporan Harian yang Dapat Dilacak

Saat ini Anda dapat menghubungkan tools dan Agent AI seperti Codex, WorkBuddy, Claude, dan Doubao ke data bisnis BigSeller untuk membantu menghasilkan analisis dan laporan bisnis.

Untuk tools yang mendukung MCP, kami juga menyarankan koneksi melalui MCP agar Agent dapat mengambil data bisnis sesuai kebutuhan.

Metode koneksi spesifik bergantung pada kemampuan API dan lingkungan runtime dari masing-masing tool.

Untuk mempelajari cara menghubungkan melalui MCP, lihat “MCP Integration”.

Kebutuhan Umum

Penanggung jawab ingin mendapatkan gambaran harian mengenai perubahan pesanan, performa utama setiap toko, dan risiko inventaris — tanpa harus berulang kali menggabungkan banyak spreadsheet.

Alur Data

Ajukan pertanyaan bisnis → API mengambil data → program membersihkan dan menghitung data → AI menjelaskan perubahan → peninjauan manusia atau pembagian data yang telah diotorisasi

Contoh

Setiap hari, rangkum pesanan pada hari sebelumnya, bandingkan performa terbaru berdasarkan toko dan mata uang, serta tandai toko yang mengalami perubahan volume pesanan secara signifikan.

Gabungkan inventaris yang tersedia dengan data penjualan untuk membuat daftar SKU yang perlu diperhatikan.

Konfirmasi Sebelum Integrasi

• Field yang tersedia dan zona waktu laporan

• Status pesanan, mata uang, dan penanganan refund

• Saluran pengiriman laporan serta bagaimana platform analitik dapat menggunakan data tersebut

Kriteria Penerimaan

Angka harus dihitung oleh program, dan laporan harus mencantumkan rentang waktu serta definisi data yang digunakan.

Jika pengambilan data gagal, laporan harus dengan jelas menunjukkan adanya data yang tidak tersedia — data yang hilang tidak boleh ditampilkan sebagai penjualan nol.

Pembagian laporan otomatis ke grup chat memerlukan konfigurasi tambahan untuk channel pesan dan permission.

---

3. Cara Mengajukan Integrasi dan Memulai

Dari konfirmasi kebutuhan hingga aktivasi resmi, proses integrasi terdiri dari lima tahap:

Tahap	Proses
STEP 1 — Konfirmasi kebutuhan	Jenis interface, jumlah field, frekuensi pemanggilan API, dan tujuan bisnis
STEP 2 — Kirim informasi akun	Berikan akun BigSeller Anda; pihak integrasi akan membuat App Key sesuai dengan proses yang berlaku
STEP 3 — Dapatkan dokumentasi integrasi	Dapatkan dokumentasi API untuk akun Anda dan berikan kepada tim implementasi
STEP 4 — Pengujian oleh pelanggan	Melakukan pengujian berdasarkan dokumentasi, menjalankan sistem secara berkelanjutan, serta memverifikasi akurasi dan stabilitas data
STEP 5 — Konfirmasi dan pembayaran	Setelah memastikan semuanya berjalan sesuai harapan, lakukan pembayaran sesuai kesepakatan dan selesaikan aktivasi

---

4. Harga dan Pertanyaan Integrasi

Untuk mengetahui lebih lanjut mengenai integrasi API, hubungi Account Manager BigSeller atau Customer Service resmi BigSeller secara langsung dan jelaskan:

• Sistem yang ingin Anda integrasikan

• Skenario bisnis Anda

• Data yang Anda perlukan

Sampaikan detail kebutuhan integrasi Anda kepada Customer Service. Interface akan disesuaikan dengan kebutuhan Anda.

Harga akhir, mata uang, pajak, isi paket, dan masa berlaku mengikuti quotation resmi.

Anda dapat melihat detail API yang didukung melalui link Feishu berikut:

• English Version — BigSeller API

• Chinese Version — BigSeller API

---

5. FAQ

Q01. Apa yang perlu saya persiapkan saat pertama kali mengajukan pertanyaan?

Tujuan bisnis

Masalah yang ingin diselesaikan dan hasil yang ingin dicapai.

Sistem tujuan

Nama sistem, versi, pihak yang melakukan implementasi, serta apakah sistem tersebut menyediakan API.

Cakupan data

Toko, gudang, status pesanan, rentang waktu historis, dan field yang diperlukan.

Arah data

Apakah hanya membutuhkan akses read-only, atau juga perlu mengirim pesanan maupun melakukan operasi write lainnya.

Volume sinkronisasi

Volume data harian, frekuensi eksekusi, latensi yang dapat diterima, dan kebutuhan pada periode puncak.

Pengaturan proyek

Kontak teknis, target tanggal peluncuran, dan kriteria penerimaan saat trial.

Anda dapat langsung memberikan informasi tersebut kepada Account Manager BigSeller atau Customer Service resmi untuk membantu mengevaluasi rencana integrasi.

---

Q02. Apakah saya perlu memberikan password login BigSeller saat mengajukan integrasi?

Saat mengajukan integrasi, Anda perlu memberikan informasi akun BigSeller yang digunakan untuk mengidentifikasi akun yang akan diaktifkan.

Jangan menyertakan password login, verification code, atau App Key dalam materi inquiry rutin.

Cara penyampaian informasi identifikasi akun dan key akan dijelaskan oleh kontak resmi integrasi.

Setelah menerima key, simpan key tersebut dalam konfigurasi sisi server yang terkontrol atau secrets management tool.

Jangan menyimpannya di kode web yang dapat diakses client, repository publik, atau screenshot grup chat.

---

Q03. Berapa lama waktu yang dibutuhkan dari pengajuan hingga integrasi dapat digunakan?

Durasi bergantung pada cakupan interface, kondisi sistem tujuan, kompleksitas pemetaan field, dan hasil pengujian.

Durasi yang tepat akan dikonfirmasi setelah kebutuhan dievaluasi.

Proyek read-only reporting dan proyek yang melibatkan order write atau accounting mapping biasanya memiliki tingkat effort implementasi yang berbeda.

Setelah kebutuhan dikonfirmasi, kami menyarankan untuk menyepakati empat milestone berikut:

1. Pengiriman dokumentasi

2. Pengujian bersama pertama

3. Trial run

4. Acceptance

---

Q04. Selama trial, bagaimana saya mengetahui bahwa integrasi “berfungsi”?

Satu request yang berhasil saja belum cukup.

Kami menyarankan untuk memverifikasi bahwa:

• Semua field yang diperlukan tersedia

• Data hasil pagination lengkap

• Data sampel sesuai dengan BigSeller

• Eksekusi berulang tidak menghasilkan data duplikat

• Sistem dapat pulih setelah terjadi error

• Sistem tetap stabil pada frekuensi pemanggilan API yang telah disepakati

Jika integrasi melibatkan order ingestion atau accounting voucher, verifikasi juga:

• Status bisnis

• Definisi jumlah/nominal

• Idempotency dan deduplication

• Callback/receipt

Durasi trial, kuota, dan cakupan pengujian harus dikonfirmasi terlebih dahulu.

---

Disclaimer

Use case dan saran teknis di atas ditujukan untuk membantu Anda mengevaluasi rencana integrasi.

Kemampuan interface aktual, permission yang diberikan, cakupan layanan, dan biaya mengikuti dokumentasi API resmi, service agreement, dan quotation.