Pertama, Tahu Di Mana Hendak Melihat

  • Keadaan sambungan — ⚙️ Tetapan → Integrasi. Jika kad QuickBooks Online menunjukkan Reconnect required, mulakan dengan itu (di bawah) — tiada apa yang disegerakkan sehingga sambungan dipulihkan.

  • Keputusan penyegerakan manual — kad QuickBooks Online → Sync membuka halaman QuickBooks Sync. Setiap permintaan penyegerakan menunjukkan kemajuannya sebagai ralat / disegerakkan / jumlah, dengan pautan View Details untuk kegagalan.

Gangguan sementara — respons QuickBooks yang perlahan, had kadar — akan dicuba semula secara automatik beberapa kali dengan selang masa yang semakin panjang. Anda hanya perlu bertindak jika ralat berterusan.


"Dipadam atau dinyahaktifkan dalam QuickBooks"

Mesej penuh: "A record referenced by this sync was deleted or made inactive in QuickBooks — fix it in QuickBooks or re-run the sync." Sesuatu yang bergantung kepada penyegerakan ini telah dipadam di pihak QuickBooks. Tindakan yang perlu bergantung kepada apa yang dipadam:

  • Invois itu sendiri telah dipadam dalam QuickBooks. Ini akan pulih sendiri: EasyBiz memadam pautan yang rosak dan mencipta invois baharu semasa penyegerakan seterusnya bagi pesanan itu. Jalankan penyegerakan manual untuk julat tarikh yang terlibat dan sahkan invois itu muncul semula.

  • Pelanggan, item, akaun atau kod cukai telah dinyahaktifkan. QuickBooks menolak rujukan kepada rekod yang tidak aktif. Aktifkan semula rekod itu dalam QuickBooks (atau tukar pemetaan EasyBiz anda supaya menunjuk kepada yang aktif), kemudian jalankan semula penyegerakan untuk tarikh yang terlibat.


"Duplicate DocNumber"

QuickBooks menolak dua invois dengan nombor invois yang sama. Apabila ini berlaku, EasyBiz mula-mula menyemak sama ada invois QuickBooks sedia ada itu sebenarnya milik pesanan yang sama — jika ya, ia terus menggunakannya dan meneruskan. Jika invois sedia ada itu milik pesanan yang berbeza, penyegerakan berhenti dan meminta semakan manual.

Cara betulkan: pastikan format nombor invois anda unik bagi setiap pesanan dalam QuickBooks Sync Settings → Field Format Settings (templat Sales Order Invoice Number menjadi QuickBooks DocNumber). Kemudian jalankan semula penyegerakan. Jika dua pesanan berbeza benar-benar bertembung pada satu nombor, selesaikan penomboran dalam QuickBooks dahulu.


"Reconnect required"

Kebenaran QuickBooks anda telah tamat tempoh atau dibatalkan — ini berlaku sekali-sekala (pertukaran kata laluan, semakan keselamatan di pihak QuickBooks, atau tamat tempoh token).

  1. Buka ⚙️ Tetapan → Integrasi.

  2. Pada kad QuickBooks Online, klik Reconnect dan log masuk ke QuickBooks semula.

  3. Pemetaan anda dikekalkan — tiada apa yang perlu disediakan semula.

Pesanan yang diambil semasa terputus sambungan tidak hilang; hantarkannya dengan penyegerakan manual untuk julat tarikh itu selepas sambungan dipulihkan.


Pesanan Tidak Muncul dalam QuickBooks Langsung

Tiada ralat, cuma tiada apa yang masuk? Semak perkara ini mengikut urutan:

  1. Laluan Pelanggan — saluran jualan pesanan mesti mempunyai laluan pelanggan. Saluran tanpa laluan tidak disegerakkan langsung. Lihat Menyediakan Pemetaan QuickBooks Anda.

  2. Kedua-dua Xero dan QuickBooks dipetakan — jika saluran jualan yang sama sepadan dengan pemetaan dalam kedua-dua integrasi, EasyBiz melangkauinya dan tidak memasukkan jualan anda dua kali. Pastikan setiap saluran jualan dihalakan kepada satu sistem perakaunan sahaja.

  3. Pesanan lama — penyegerakan automatik meliputi pesanan dari masa pemetaan disediakan. Pesanan lama memerlukan penyegerakan manual: kad QuickBooks Online → Sync → Add Sync Request dengan julat tarikh.


Penyegerakan Manual Tidak Bermula atau Terhenti

  • QuickBooks mengehadkan bilangan permintaan API yang diterima setiap hari. Penyegerakan manual hanya bermula apabila kuota harian yang mencukupi masih ada — cuba semula kemudian, atau bahagikan penyegerakan susulan yang besar kepada julat tarikh yang lebih kecil.

  • Permintaan yang sedang berjalan menunjukkan kemajuan pada halaman QuickBooks Sync; anda boleh Cancel penyegerakan yang beratur dan hantar semula julat yang lebih sempit.


Bila Hendak Hubungi Sokongan

Hubungi sokongan EasyBiz apabila:

  • Ralat yang sama muncul semula selepas anda membetulkan rekod di pihak QuickBooks dan menjalankan semula penyegerakan.

  • "Duplicate DocNumber conflict" meminta semakan manual dan invois sedia ada itu tidak kelihatan seperti invois anda.

  • Bayaran atau invois kelihatan telah disegerakkan tetapi nombor tidak sepadan antara kedua-dua sistem.

Sertakan nombor pesanan, mesej ralat tepat dari View Details, dan anggaran masa penyegerakan dijalankan — itu sahaja yang sokongan perlukan untuk menjejakinya.


Soalan Lazim

Adakah penyegerakan yang gagal dicuba semula sendiri?

Kegagalan sementara (tamat masa, had kadar) dicuba semula secara automatik beberapa kali. Kegagalan yang memerlukan pembetulan di pihak anda — rekod dipadam, nombor berganda — kekal gagal sehingga anda menyelesaikan punca dan menjalankan semula penyegerakan.

Adakah menjalankan semula penyegerakan akan menggandakan invois yang sudah disegerakkan?

Tidak. Pesanan yang sudah dipautkan kepada invois QuickBooks akan dikemas kini, bukan dicipta semula. Menjalankan semula julat tarikh adalah selamat.

Kami sengaja memadam invois yang salah dalam QuickBooks. Apa seterusnya?

Biasanya tiada apa — EasyBiz memadam pautan lama dan mencipta semula invois semasa penyegerakan seterusnya bagi pesanan itu. Jika anda memadamnya kerana jualan itu sendiri salah, batalkan pesanan dalam EasyBiz sebaliknya, supaya ia berhenti disegerakkan.


Langkah Seterusnya

Untuk butiran pemetaan harian di sebalik kebanyakan ralat ini, lihat Menyediakan Pemetaan QuickBooks Anda. Untuk bayaran yang direkodkan dalam QuickBooks dan dipindahkan kembali ke EasyBiz, lihat Menyegerakkan Bayaran dari QuickBooks ke EasyBiz.