Pertama, Ketahui Tempat Melihatnya

  • Status koneksi — ⚙️ Pengaturan → Integrasi. Jika kartu QuickBooks Online menampilkan Reconnect required, mulailah dari situ (lihat di bawah) — tidak ada yang bisa disinkronkan sebelum koneksi dipulihkan.

  • Hasil sinkronisasi manual — kartu QuickBooks Online → Sync membuka halaman QuickBooks Sync. Setiap permintaan sinkronisasi menampilkan progresnya sebagai error / tersinkron / total, dengan tautan View Details untuk melihat kegagalannya.

Gangguan sementara — respons QuickBooks yang lambat, atau pembatasan permintaan — dicoba ulang otomatis beberapa kali dengan jeda yang makin lama. Anda hanya perlu bertindak jika error terus berlanjut.


"Dihapus atau dinonaktifkan di QuickBooks"

Pesan lengkapnya: "A record referenced by this sync was deleted or made inactive in QuickBooks — fix it in QuickBooks or re-run the sync." Sesuatu yang dibutuhkan sinkronisasi ini telah dihapus di sisi QuickBooks. Yang harus Anda lakukan bergantung pada apa yang dihapus:

  • Fakturnya sendiri dihapus di QuickBooks. Ini pulih sendiri: EasyBiz menghapus tautan yang rusak dan membuat faktur baru pada sinkronisasi berikutnya untuk pesanan tersebut. Jalankan sinkronisasi manual untuk rentang tanggal terkait dan pastikan fakturnya muncul kembali.

  • Pelanggan, item, akun, atau kode pajak dinonaktifkan. QuickBooks menolak referensi ke catatan yang nonaktif. Aktifkan kembali catatan tersebut di QuickBooks (atau ubah pemetaan EasyBiz Anda agar menunjuk ke yang aktif), lalu jalankan ulang sinkronisasi untuk tanggal terkait.


"Duplicate DocNumber"

QuickBooks menolak dua faktur dengan nomor faktur yang sama. Saat ini terjadi, EasyBiz terlebih dulu memeriksa apakah faktur QuickBooks yang sudah ada memang milik pesanan yang sama — jika ya, EasyBiz langsung memakainya dan melanjutkan. Jika faktur yang ada ternyata milik pesanan lain, sinkronisasi berhenti dan meminta peninjauan manual.

Cara memperbaiki: buat format nomor faktur Anda unik per pesanan di Pengaturan Sinkronisasi QuickBooks → Pengaturan Format Kolom (templat Sales Order Invoice Number menjadi DocNumber QuickBooks). Lalu jalankan ulang sinkronisasi. Jika dua pesanan berbeda benar-benar memakai nomor yang sama, selesaikan dulu penomorannya di QuickBooks.


"Reconnect required"

Otorisasi QuickBooks Anda kedaluwarsa atau dicabut — ini kadang terjadi (karena perubahan kata sandi, peninjauan keamanan di sisi QuickBooks, atau sekadar token yang habis masa berlakunya).

  1. Buka ⚙️ Pengaturan → Integrasi.

  2. Pada kartu QuickBooks Online, klik Reconnect dan masuk lagi ke QuickBooks.

  3. Pemetaan Anda tetap tersimpan — tidak perlu diatur ulang.

Pesanan yang masuk saat koneksi terputus tidak hilang; kirimkan dengan sinkronisasi manual untuk rentang tanggal tersebut setelah tersambung kembali.


Pesanan Sama Sekali Tidak Muncul di QuickBooks

Tidak ada error, tetapi tidak ada yang masuk? Periksa hal-hal berikut secara berurutan:

  1. Routing Pelanggan — saluran penjualan pesanan harus memiliki rute pelanggan. Saluran tanpa rute tidak akan disinkronkan sama sekali. Lihat Mengatur Pemetaan QuickBooks Anda.

  2. Xero dan QuickBooks sama-sama dipetakan — jika saluran penjualan yang sama cocok dengan pemetaan di kedua integrasi, EasyBiz akan melewatinya daripada mencatat penjualan Anda dua kali. Pastikan setiap saluran penjualan hanya diarahkan ke satu sistem akuntansi.

  3. Pesanan lama — sinkronisasi otomatis mencakup pesanan sejak pemetaan diatur. Pesanan yang lebih lama memerlukan sinkronisasi manual: kartu QuickBooks Online → Sync → Add Sync Request dengan rentang tanggal.


Sinkronisasi Manual Tidak Bisa Dimulai atau Macet

  • QuickBooks membatasi jumlah permintaan API yang diterima per hari. Sinkronisasi manual hanya dimulai jika kuota harian yang tersisa masih cukup — coba lagi nanti, atau pecah pengisian ulang yang besar menjadi rentang tanggal yang lebih kecil.

  • Permintaan yang sedang berjalan menampilkan progres di halaman QuickBooks Sync; Anda dapat Cancel sinkronisasi yang masih antre dan mengirim ulang dengan rentang yang lebih sempit.


Kapan Menghubungi Dukungan

Hubungi dukungan EasyBiz jika:

  • Error yang sama muncul lagi setelah Anda memperbaiki catatan di sisi QuickBooks dan menjalankan ulang sinkronisasi.

  • "Duplicate DocNumber conflict" meminta peninjauan manual dan faktur yang ada tampaknya bukan milik Anda.

  • Pembayaran atau faktur terlihat sudah tersinkron, tetapi angkanya tidak cocok antara kedua sistem.

Sertakan nomor pesanan, pesan error persis dari View Details, dan kira-kira kapan sinkronisasi dijalankan — itu sudah cukup bagi dukungan untuk menelusurinya.


Pertanyaan Umum

Apakah sinkronisasi yang gagal dicoba ulang sendiri?

Kegagalan sementara (timeout, pembatasan permintaan) dicoba ulang otomatis beberapa kali. Kegagalan yang memerlukan perbaikan dari pihak Anda — catatan yang dihapus, nomor ganda — tetap gagal sampai Anda mengatasi penyebabnya dan menjalankan ulang sinkronisasi.

Apakah menjalankan ulang sinkronisasi akan menggandakan faktur yang sudah tersinkron?

Tidak. Pesanan yang sudah terhubung dengan faktur QuickBooks akan diperbarui, bukan dibuat ulang. Menjalankan ulang rentang tanggal aman dilakukan.

Kami sengaja menghapus faktur yang salah di QuickBooks. Bagaimana sekarang?

Biasanya tidak perlu tindakan apa pun — EasyBiz menghapus tautan lama dan membuat ulang faktur pada sinkronisasi berikutnya untuk pesanan tersebut. Jika Anda menghapusnya karena penjualannya sendiri salah, batalkan pesanan di EasyBiz agar tidak lagi disinkronkan.


Langkah Selanjutnya

Untuk detail pemetaan sehari-hari di balik sebagian besar error ini, lihat Mengatur Pemetaan QuickBooks Anda. Untuk pembayaran yang dicatat di QuickBooks dan masuk kembali ke EasyBiz, lihat Sinkronisasi Pembayaran dari QuickBooks ke EasyBiz.