Langkau ke kandungan utama

Cara menyambungkan Xero ke QashierHQ (penyegerakan jualan harian)

Selaraskan data jualan dan lancarkan proses perakaunan dan pengurusan kewangan anda dalam beberapa langkah sahaja.

Sambungkan Xero ke QashierHQ dan Qashier akan menghantar satu invois bagi setiap kedai ke Xero setiap hari untuk jualan hari sebelumnya, yang sudah ditandakan sebagai telah dibayar. Penyegerakan ini sehala (dari Qashier ke Xero) dan meliputi jualan yang dibuat selepas anda menyambung. Jualan yang dibuat sebelum sambungan tidak disegerakkan.

Terpakai untuk: Singapura, Malaysia, Filipina dan Thailand · QashierHQ · Ciri Xero Integration (Integrasi Xero) daripada Qashier Marketplace · Log masuk QashierHQ dengan akses Tetapan.

Sebelum anda bermula

  • Dalam QashierHQ, buka Pasaran Qashier (Qashier Marketplace) dan aktifkan Xero Integration untuk setiap kedai yang ingin anda segerakkan. Xero Settings (Tetapan Xero) hanya dipaparkan selepas langkah ini dilakukan untuk sekurang-kurangnya satu kedai. Lihat Cara Menambah Ciri dan Mengurus Pelan Anda dalam Qashier Marketplace (QashierHQ).

  • Anda memerlukan log masuk Xero yang mempunyai akses ke organisasi yang ingin anda hantar jualan.

  • Anggap Client Secret Xero anda seperti kata laluan. Jangan kongsikannya dengan sesiapa pun, termasuk Sokongan Qashier.

Bahagian 1: Cipta aplikasi dalam Xero

  1. Log masuk ke Xero, kemudian pergi ke developer.xero.com/app/manage.

  2. Pilih New app (Aplikasi baharu).

  3. Isikan borang:

    • App name (Nama aplikasi): nama pilihan anda, contohnya QashierApp

    • Integration type (Jenis integrasi): Web app

    • Company or application URL (URL syarikat atau aplikasi): https://hq.qashier.com/

    • Redirect URI: https://api.qashier.com/v1/xeroCallback — salin dengan tepat, tanpa garis condong di hujung. Ini ialah nilai untuk ditampal, bukan halaman untuk dibuka.

  4. Baca dan terima terma dan syarat, kemudian pilih Create app (Cipta aplikasi).

  5. Dalam menu aplikasi di sebelah kiri, pilih Configuration (Konfigurasi).

  6. Salin Client id. Anda akan menampalnya ke dalam QashierHQ.

  7. Pilih Generate a secret (Jana rahsia), kemudian salin rahsia itu dengan segera. Xero hanya memaparkannya sekali. Jika anda kehilangannya, jana yang baharu.

Bahagian 2: Sambungkan Xero dalam QashierHQ

  1. Log masuk ke QashierHQ.

  2. Klik ikon gear (Tetapan) di bahagian atas sebelah kanan. Pada telefon, buka menu profil anda dan ketik Tetapan.

  3. Dalam panel kiri, di bawah Integrations (Integrasi), pilih Xero Settings.

  4. Tampal Client id daripada Xero ke dalam Client ID.

  5. Tampal rahsia daripada Xero ke dalam Client Secret.

  6. Klik Submit (Hantar). Anda dibawa ke Xero untuk log masuk.

  7. Dalam Xero, pilih organisasi yang ingin anda sambungkan dan pilih Allow access (Benarkan akses). Anda dibawa kembali ke Xero Settings dalam QashierHQ.

Bahagian 3: Petakan setiap kedai ke Xero

  1. Dalam Xero Settings, pilih kedai dalam senarai juntai bawah Store (Kedai). Hanya kedai yang mengaktifkan Xero Integration disenaraikan.

  2. Pilih organisasi Xero dalam Organization (Organisasi).

  3. Di bawah Accounts for Products (Akaun untuk Produk), pilih Default Sales Account (Akaun Jualan Lalai) anda. Ini ialah akaun hasil dalam Xero, contohnya 200 - Sales. Ia terpakai untuk jualan semua produk.

  4. Pilih Default Payment Account (Akaun Pembayaran Lalai) anda. Jualan harian dimasukkan ke dalam akaun ini. Jika senarai kosong, lihat bahagian di bawah.

  5. Jika kedai anda mengenakan cukai, bahagian Sales Tax (Cukai Jualan) dipaparkan. Dalam medan berlabel GST (labelnya sama di setiap pasaran), pilih kadar cukai Xero yang sepadan: kadar SST anda di Malaysia, kadar VAT anda di Thailand atau Filipina. Kedai yang tidak mengenakan cukai tidak melihat bahagian ini.

  6. Klik SAVE (Simpan). Ulangi untuk setiap kedai.

Jika Default Payment Account tidak memaparkan apa-apa

QashierHQ hanya menyenaraikan akaun Current Asset (Aset Semasa) yang aktif dalam Xero dan mempunyai pembayaran didayakan. Cipta satu akaun:

  1. Log masuk ke Xero dan pilih Accounting (Perakaunan) daripada menu atas, kemudian Chart of accounts (Carta akaun).

  2. Pilih + Add Account (Tambah Akaun).

  3. Tetapkan Account type (Jenis akaun) kepada Current Asset. Masukkan Code (Kod) dan Name (Nama) pilihan anda, penerangan jika anda mahu, dan tetapan cukai.

  4. Tandakan Enable payments to this account (Dayakan pembayaran ke akaun ini) dan pilih Save (Simpan).

  5. Muat semula QashierHQ, kembali ke Xero Settings dan pilih Default Payment Account sekali lagi.

Panduan animasi: menambah akaun pembayaran dalam Xero.

Apa yang sepatutnya anda lihat dalam Xero

Setiap hari sejurus selepas tengah malam (waktu Singapura), Qashier menghantar satu invois bagi setiap kedai ke Xero untuk jualan lengkap hari sebelumnya dan merekodkan bayaran ke dalam Default Payment Account anda. Invois dicipta dengan status Authorised dengan penerangan YYYY-MM-DD Daily Sales, kenalan QashierPOS - nama kedai anda dan rujukan QashierPOS Sales. Transaksi yang dibayar balik, dibatalkan dan tambah nilai kredit tidak termasuk. Hari tanpa jualan tidak menghasilkan invois.

Contoh invois yang dicipta dalam Xero.

Urus sambungan anda

  • Pautkan organisasi Xero yang lain: dalam Xero Settings, pilih Don't see your organization? (Tidak nampak organisasi anda?) dan ikut arahan yang dipaparkan.

  • Putuskan sambungan: dalam Xero Settings, pilih Disconnect from Xero (Putuskan sambungan daripada Xero) dan sahkan dengan Disconnect (Putuskan sambungan). Anda boleh menyambung semula pada bila-bila masa dengan memasukkan Client ID dan Client Secret anda sekali lagi.

Jika berlaku masalah

Simptom

Punca

Penyelesaian

Xero memaparkan ralat invalid redirect_uri selepas anda mengklik Submit

Redirect URI pada aplikasi Xero anda tidak sepadan dengan tepat

Dalam portal pembangun Xero, buka Configuration aplikasi anda dan tetapkan Redirect URI kepada https://api.qashier.com/v1/xeroCallback tanpa garis condong di hujung. Kemudian hantar semula dalam QashierHQ.

Xero Settings tiada dalam panel Tetapan

Xero Integration tidak diaktifkan untuk mana-mana kedai

Aktifkannya dalam Pasaran Qashier, kemudian muat semula QashierHQ.

Sesebuah kedai tiada dalam senarai juntai bawah Store

Xero Integration tidak diaktifkan untuk kedai itu, atau kedai itu dipautkan ke cawangan lain

Aktifkan Xero Integration untuk kedai tersebut. Kedai yang dipautkan ke kedai lain tidak disenaraikan; hubungi Sokongan Qashier jika anda memerlukan jualannya dalam Xero.

SAVE gagal dengan mesej Please select a tax rate (Sila pilih kadar cukai)

Kedai anda mengenakan cukai dan medan Sales Tax kosong

Pilih kadar cukai Xero yang sepadan dalam medan GST dan simpan semula.

Tiada invois dipaparkan dalam Xero

Pemetaan kedai tidak lengkap, sambungan Xero telah tamat tempoh atau telah dialih keluar, atau kedai tiada jualan pada hari itu

Buka Xero Settings, pilih kedai dan semak bahawa Organization, Default Sales Account, Default Payment Account dan, jika bercukai, medan GST semuanya telah disimpan. Jika sambungan telah dialih keluar dalam Xero, sambung semula dari Bahagian 2. Hari tanpa jualan tidak menghasilkan invois.

Jualan sebelum sambungan tiada

Hanya jualan yang dibuat selepas anda menyambung disegerakkan

Masukkan hari-hari sebelumnya dalam Xero secara manual, atau hubungi Sokongan Qashier jika anda memerlukan bantuan.

Masih tersekat? Hubungi Sokongan Qashier.

Artikel berkaitan

Disahkan terakhir: 25 Sep 2026 · Pasaran: SG, MY, PH, TH

Adakah ini menjawab soalan anda?