Panduan Mokapen

Shopify

Hubungkan Anda Shopify simpan ke Mokapen untuk dibawa pelanggan (kontak), produk (dengan varian dan jumlah), dan simpan pesanan ke dalam CRM, dan mengekspor produk yang dibuat atau diperbarui di Mokapen ke Shopify jika arah sinkronisasi memungkinkan. Ini membantu menyatukan e-commerce dan manajemen penjualan: data master, katalog, dan riwayat pembelian di ruang kerja yang sama.

Gambaran umum: Integrasi. Pesanan impor menjadi pesanan penjualan di Mokapen (modul Pesanan), bukan peluang saluran pipa.

Persyaratan

• Aktif Shopify toko (URL diakhiri dengan .myshopify.com).
• Izin untuk mengotorisasi aplikasi Mokapen di Shopify (OAuth) dengan akun admin toko.
• Sebuah Premi yang sesuai Rencana Mokapen untuk integrasi e-commerce. Tanpa rencana, tombol sambungkan membuka layar peningkatan; di beberapa aliran Shopify, biaya berulang yang terkait dengan aplikasi juga mungkin ditawarkan.
• Izin Mokapen pada kontak, produk, dan pesanan di organisasi Anda (lihat Peran dan izin).
• Akses ke Integrasi (anggota/admin bergantung pada label putih dan peran organisasi).

Hubungkan toko Shopify

1. Menu pengguna → Integrasi → Shopify.
2. Masukkan nama toko (seperti di Admin Shopify; URL lengkap diakhiri dengan myshopify.com). Jika tidak yakin, buka dashboard Shopify dan periksa bilah alamat browser.
3. Mulai otorisasi: Anda diarahkan ke Shopify untuk menerima izin.
4. Terima cakupan yang diminta (baca/tulis pelanggan dan produk, baca pesanan — lihat di bawah).
5. Kembali ke Mokapen: toko muncul terhubung. Jika Anda datang dari Shopify App Store, Anda mungkin perlu melakukannya memilih organisasi Mokapen untuk memasang koneksi.

Jika Anda tidak menerima di Shopify, tidak ada data yang disinkronkan. Setelah terhubung, Mokapen mendaftar webhook di toko: sehingga pembaruan kepada pelanggan, produk, dan pesanan dapat tiba secara real-time, selain sinkronisasi massal yang Anda luncurkan sendiri.

Apa yang diminta Mokapen dari Shopify

Selama otorisasi OAuth, Mokapen biasanya meminta:

• baca_pelanggan / tulis_pelanggan — membaca (dan berpotensi menulis) pelanggan Shopify.
• produk_baca / produk_tulis — membaca dan memperbarui produk/varian.
• baca_pesanan — membaca pesanan toko.

Mokapen tidak menggantikan panel Shopify untuk checkout, tema, atau pembayaran: panel ini menyelaraskan data ke (dan, untuk produk, dari) CRM. Jika Anda mencabut aplikasi dari Shopify atau masa berlaku token habis, putuskan sambungan dan sambungkan kembali dari Mokapen. Shopify juga memerlukan titik akhir GDPR (permintaan/penyusunan data): Mokapen menanganinya melalui webhook.

Apa yang disinkronkan

Menuju Mokapen (impor/webhook)

• Pelanggan → Kontak — Data master Shopify memasuki buku alamat; jika data perusahaan ada, perusahaan juga dapat dibuat/ditautkan. Webhook pada pembuatan/perbarui/penghapusan pelanggan.
• Produk dan varian → Produk — katalog dengan varian; Kuantitas inventaris varian Shopify dipetakan ke kolom kuantitas varian Mokapen (bukan modul gudang terpisah).
• Pesanan → Pesanan — Pesanan Shopify menjadi pesanan penjualan di Mokapen (dengan item baris), bukan kesepakatan saluran. Webhook tentang pembaruan pesanan.
• Checkout terbengkalai — sinkronisasi mungkin menyertakan jalur untuk mengimpor pembayaran Shopify yang ditinggalkan (sebagai pesanan/data terkait). Berdedikasi laporan untuk troli yang ditinggalkan / analisis e-commerce pada halaman masih ditampilkan sebagai Segera hadir: jangan menganggapnya sebagai fitur aktif.

Menuju Shopify (ekspor)

• Produk — dengan arah sinkronisasi «menuju Shopify» atau «keduanya», Mokapen dapat mengekspor/memperbarui produk di toko (sinkronisasi massal dan sinkronisasi saat Anda menyimpan produk tertaut, jika integrasi aktif).
• Kontak keluar dan pesanan - meskipun tulis_pelanggan cakupannya, ekspor «sinkronisasi» otomatis yang diterapkan saat ini juga berlaku dalam praktiknya produk. Jangan berasumsi ekspor kontak atau pesanan dua arah penuh: sebagian besar pelanggan datang dari Shopify hingga Mokapen (impor + webhook). Jika teks pemasaran menyebutkan "hanya kontak dua arah", verifikasi di lingkungan Anda apa yang sebenarnya dilakukan sinkronisasi setelah tersambung.

Dalam konfigurasi, integrasi juga mencantumkan layanan, tetapi tidak ada sinkronisasi layanan e-niaga khusus seperti untuk produk: gunakan Produk untuk katalog toko.

Pengaturan setelah terhubung

Di halaman Shopify, dengan toko terhubung, Anda biasanya mengonfigurasi:

Sinkronisasi arah

• Menuju Mokapen saja — data mengalir dari Shopify ke CRM.
• Keduanya — impor + ekspor (jika didukung; saat ini sebagian besar produk keluar).
• Hanya menuju Shopify — dorong dari Mokapen ke toko (produk).

Entitas

Kontak, pesanan, dan produk muncul sebagai cakupan sinkronisasi (seringkali sudah dipilih dan tidak dapat diedit dari UI). Sinkronisasi historis dan webhook mencakup tiga blok ini.

Bagikan sinkronisasi

Siapa pun yang menghubungkan toko dapat mengizinkan anggota lain menggunakan koneksi yang sama (seluruh organisasi atau pengguna tertentu), jadi tidak semua orang harus mengulangi OAuth.

Duplikat dan konflik

• Hindari duplikat — opsi tipikal: kontak dikenali melalui email, untuk menghindari duplikat di buku alamat.
• Jika terjadi konflik — pilih apakah Shopify atau Mokapen menang ketika rekor yang sama diubah di kedua sisi.

Sinkronisasi otomatis vs manual

Dengan sinkronisasi otomatis aktif, pembaruan (dan webhook) menjaga keselarasan data; Anda masih dapat meluncurkan manual sinkronisasi untuk muatan sejarah awal. Sebelum menyinkronkan, periksa pemrosesan/pembagian data otorisasi diperlukan pada halaman tersebut.

Aliran yang direkomendasikan

1. Hubungkan toko dan verifikasi akun Terhubung.
2. Tetapkan arah sinkronisasi (untuk sebagian besar kasus: Menuju Mokapen saja atau Keduanya jika Anda ingin mengupdate produk Shopify dari Mokapen).
3. Konfigurasikan duplikat/konflik dan berbagi.
4. Otorisasi dan luncurkan sinkronisasi pertama (mungkin memerlukan waktu untuk katalog besar).
5. Cek di Mokapen: Kontak, Produk (varian/kuantitas), Pesanan.
6. Jaga agar webhook tetap aktif: pesanan baru dan pembaruan pelanggan/produk akan tiba tanpa meluncurkan ulang semuanya setiap saat.

Memutuskan

Dari Integrasi → Shopify → putuskan sambungan. Dalam modal Anda dapat memilih apakah akan melakukannya menyimpan kontak, pesanan, dan produk yang sudah diimpor di Mokapen, atau tangani sesuai opsi yang ditawarkan. Setelah sambungan terputus, webhook berhenti memperbarui; data yang sudah ada di CRM tetap ada jika Anda memilih untuk menyimpannya. Anda juga dapat mencabut aplikasi dari panel Shopify.

Masalah umum

• Nama toko tidak valid — gunakan *.myshopify.com subdomain, bukan hanya domain etalase khusus.
• Tombol diblokir / ditingkatkan — diperlukan paket Premium yang sesuai untuk e-niaga.
• Pesanan tidak ada di Peluang — itu benar: mereka masuk Pesanan. Buka Penjualan → Pesanan.
• Kuantitas produk — berasal dari kuantitas varian Shopify; bukan WMS penuh.
• Laporan / analitik keranjang — jika mereka menampilkan «Segera hadir» di halaman, berarti mereka belum beroperasi.
• Token yang kedaluwarsa/sinkronisasi dihentikan — putuskan dan sambungkan kembali; verifikasi bahwa aplikasi tidak dihapus dari Shopify.

Pertanyaan yang sering diajukan

T: Di mana saya dapat menemukan URL toko?

J: Di bilah alamat dasbor Admin Shopify: diakhiri dengan myshopify.com.

T: Apakah pesanan Shopify menjadi peluang?

A: Tidak. Di Mokapen mereka jadinya pesanan penjualan (dengan item baris). Teks apa pun yang mengacu pada “peluang” tidak akurat dibandingkan dengan perilaku saat ini.

Q: Bisakah saya mengupdate produk Shopify dari Mokapen?

A: Ya, dengan arah sinkronisasi yang mencakup ekspor dan integrasi aktif: produk (varian) dapat dikirim/diperbarui di toko.

Q: Apakah kontak juga diperbarui dari Mokapen ke Shopify?

J: Impor dan webhook membawa pelanggan Shopify ke dalam CRM. Ekspor kontak otomatis bukanlah jalur utama saat ini (tidak seperti produk): verifikasi paket/lingkungan Anda setelah terhubung.

T: Apakah saya memerlukan WooCommerce bersama Shopify?

J: Tidak: keduanya merupakan alternatif integrasi e-commerce. Gunakan Shopify jika toko Anda ada di Shopify; lihat Panduan WooCommerce jika Anda menggunakan WordPress/Woo.