Eksport Data Keluar daripada Niagawan: Panduan Lengkap Migrasi CSV ke Lejar Am Awan

Apakah cara paling selamat untuk mengeksport data keluar daripada Niagawan?

Eksport data keluar daripada Niagawan dalam tiga lapisan: arkib sumber yang tidak diubah, ruang kerja penukaran, dan lejar sasaran yang telah disahkan. Jangan sesekali membersihkan satu-satunya salinan fail CSV.

Urutan kerja yang praktikal ialah:

1. Bekukan catatan baharu dalam Niagawan pada tarikh dan masa yang dipersetujui.
2. Senaraikan semua modul yang pernah digunakan, termasuk dokumen yang tidak mengubah lejar.
3. Eksport setiap CSV atau laporan perakaunan yang tersedia dan simpan fail asal sebagai baca sahaja.
4. Simpan PDF dokumen dan lampiran secara berasingan, bersama manifes yang menghubungkan setiap fail kepada rujukan sumber.
5. Catat bilangan rekod, julat tarikh, rujukan unik dan jumlah kawalan sebelum sebarang penukaran.
6. Tukar salinan fail kepada skema sistem sasaran.
7. Jalankan ujian kering, semak pengecualian, kemudian barulah tulis ke lejar awan.
8. Padankan nilai dan baki sebelum kakitangan mula memasukkan transaksi baharu dalam sistem sasaran.

Panduan rasmi Niagawan menyebut fungsi eksport untuk invois jualan, pelanggan, produk, inventori, invois belian, pembekal, bayaran belian, bayaran invois, untung rugi, imbangan duga, kunci kira-kira, lejar am dan penyata buku tunai. Senarai itu ialah titik mula, bukannya bukti bahawa akaun anda sudah disandarkan sepenuhnya. Akaun sebenar mungkin turut mempunyai pesanan penghantaran, baucar bayaran, sebut harga, dokumen kredit, lampiran atau sejarah operasi lain yang perlu disenaraikan berasingan.

Apakah yang perlu ada dalam buku kerja kawalan migrasi?

Buku kerja kawalan migrasi ialah jejak bukti antara “fail sudah dimuat turun” dengan “akaun dalam sistem baharu sudah lengkap.” Gunakan satu baris bagi setiap modul sumber dan tahun kewangan.

Medan kawalan	Maklumat yang direkodkan
Modul sumber	Invois jualan, resit, pelanggan, produk, buku tunai, lejar am, pesanan penghantaran, baucar bayaran atau modul lain
Tempoh sumber	Tahun kalendar dan tahun kewangan sebenar perniagaan
Fail mentah	Nama fail asal, tarikh eksport dan checksum jika tersedia
Kawalan rekod	Bilangan baris, rujukan sumber unik, tarikh terawal dan tarikh terakhir
Kawalan nilai	Amaun kasar, amaun bayaran, jumlah debit, jumlah kredit atau jumlah yang sesuai dengan modul
Objek sasaran	customers, invoices, invoice_payments, bank_transactions, journal_entries atau arkib dokumen
Keputusan import	Bilangan dimasukkan, dipadankan, dilangkau, ditolak dan dikenal pasti sebagai pendua
Penyemak	Individu yang menyemak fail pengecualian dan sampel nilai

Sediakan tiga direktori: raw/ untuk eksport asal yang tidak boleh diubah, working/ untuk fail yang telah diseragamkan, dan evidence/ untuk jumlah kawalan, laporan pengecualian, tangkap layar serta pengesahan. Jika penukaran gagal, jana semula daripada raw/; jangan baiki fail asal secara terus.

Disiplin ini terbukti penting dalam migrasi GetPay sendiri pada Julai 2026. Projek tersebut memindahkan 578 invois dan 568 resit, kemudian menutup jurang operasi dengan memindahkan 333 pesanan penghantaran dan 514 baucar bayaran. Angka ini bukan penanda aras untuk syarikat lain. Ia menunjukkan bahawa eksport jualan dan resit sahaja masih boleh meninggalkan sejarah audit dan operasi yang penting.

Bagaimanakah medan Niagawan dipetakan kepada lejar am awan?

Petakan maksud medan, bukan sekadar kedudukan lajur. Susun atur CSV boleh berubah, dan dua lajur yang kelihatan serupa mungkin membawa maksud berbeza.

Bagi setiap pelanggan, kekalkan identiti sumber yang stabil, nama, nama syarikat, maklumat hubungan, pengenalan cukai jika memang wujud secara sah, serta nilai mentah apabila penyeragaman tidak pasti. Jangan “membaiki” nombor telefon yang meragukan atau menggabungkan dua nama serupa secara automatik. Hantar kes tidak pasti ke senarai semakan.

Bagi setiap invois jualan, seragamkan sekurang-kurangnya:

• rujukan sumber kepada invoice_number;
• tarikh transaksi kepada issue_date;
• tarikh bayaran kontrak kepada due_date;
• pautan pelanggan kepada customer_id;
• perihal baris, kuantiti, harga unit, diskaun, layanan cukai dan jumlah baris;
• jumlah kecil dokumen, amaun cukai dan jumlah keseluruhan;
• status sumber dan baki tertunggak;
• nota asal serta provenans; dan
• idempotency_key yang stabil, contohnya niagawan:{source_ref}.

Bagi setiap resit, simpan receipt_number, payment_date, amount, rujukan invois berkaitan, kaedah bayaran jika tersedia, dan kunci idempotensinya sendiri. Pautkan resit kepada invois yang telah diimport; jangan memadan berdasarkan nama pelanggan dan amaun sahaja.

Niagawan boleh memaparkan status Paid, Unpaid atau Partial. Sistem sasaran mungkin menggunakan model status yang berbeza. Sebagai contoh, laluan migrasi GetPay tidak menyimpan status invois PARTIAL secara manual. Bayaran sebenar direkodkan dalam invoice_payments; invois yang telah dilangsaikan menjadi PAID, manakala baki belum bayar diterangkan oleh jumlah bayaran serta status ISSUED atau OVERDUE. Kekalkan status sumber dalam nota atau metadata migrasi supaya penukaran itu boleh diaudit.

Patutkah dokumen sejarah dicatat ke dalam lejar am baharu?

Pilih satu asas perakaunan sebelum mengimport:

Kaedah	Kesan dalam lejar sasaran	Keadaan yang sesuai
Bina semula sejarah penuh	Satu kesan jurnal seimbang bagi setiap transaksi sejarah	Sistem sasaran akan menjadi lejar transaksi lengkap untuk semua tahun yang dipindahkan
Peralihan melalui baki awal	Satu jurnal baki awal terkawal, diikuti transaksi baharu selepas peralihan	Dokumen lama disimpan untuk rujukan, manakala baki tempoh terdahulu dibawa ke hadapan
Lapisan dokumen atas lejar sedia ada	Tiada kesan GL baharu bagi sejarah dokumen yang sudah diwakili dalam sistem sasaran	Sistem sasaran sudah mempunyai jurnal diaudit atau diselaraskan dan hanya memerlukan dokumen yang belum ada

Jangan gabungkan kaedah pertama dan kedua untuk amaun yang sama. Jika invois sejarah yang belum dibayar dicatat sebagai Dr Akaun Belum Terima / Cr Hasil Jualan, kemudian amaun belum terima yang sama dimasukkan lagi dalam baki awal, aset dan hasil akan terlebih nyata.

Migrasi Niagawan milik GetPay menggunakan kaedah ketiga bagi invois yang dipindahkan. Dokumen dikekalkan dengan nilai idempotency_key yang sepadan dengan niagawan:%, kekal sebagai dokumen sahaja, dan dilindungi daripada catatan jualan, bayaran, nota kredit, hapus kira serta isian semula automatik. Ini sempadan perakaunan yang disengajakan, bukannya kekurangan pengimport.

Jualan baharu biasa dalam lejar yang telah dipos boleh menghasilkan:

Dr Akaun Belum Terima
  Cr Hasil Jualan
  Cr Cukai Belum Bayar, jika berkenaan

Bayaran pelanggan pula boleh menghasilkan:

Dr Bank
  Cr Akaun Belum Terima

Catatan tersebut menerangkan kesan perakaunan sasaran, tetapi tidak boleh dijana sekali lagi bagi dokumen yang kesannya sudah terkandung dalam baki awal atau jurnal sedia ada.

Bagaimanakah baki awal disediakan tanpa catatan berganda?

Pilih masa peralihan yang tepat, tutup semua catatan sumber sehingga masa itu, kemudian hasilkan imbangan duga muktamad bersama jadual sokongan. Baki awal mesti datang daripada kedudukan akhir yang telah disemak, bukan daripada jumlah lajur CSV yang mudah dicapai.

Jurnal baki awal yang seimbang lazimnya mengandungi:

Dr Baki bank dan tunai
Dr Akaun Belum Terima daripada jadual invois terbuka
Dr Inventori, aset tetap, deposit dan baki debit lain
  Cr Akaun Belum Bayar daripada jadual bil terbuka
  Cr Pinjaman, liabiliti cukai dan baki kredit lain
  Cr Modal atau pendapatan tertahan berdasarkan akaun penutup

Jumlah debit mesti sama tepat dengan jumlah kredit. Jangan wujudkan amaun “akaun tergantung migrasi” yang tidak dapat dijelaskan semata-mata untuk memaksa imbangan. Jika masih terdapat perbezaan, berhenti dan kesan semula kepada imbangan duga sumber, peta akaun, tanda positif atau negatif, modul yang tertinggal, atau transaksi pendua.

Import invois dan bil terbuka sebagai dokumen sublejar supaya jadual pelanggan dan pembekal masih boleh digunakan. Tandakan sebagai dokumen sahaja jika nilai akaun kawalannya sudah terkandung dalam jurnal baki awal. Akaun Belum Terima dalam jurnal baki awal mesti sama dengan jumlah invois pelanggan tertunggak pada masa yang sama; Akaun Belum Bayar pula mesti sama dengan jadual pembekal terbuka.

Apakah turutan import yang mengelakkan pautan rosak?

Gunakan turutan berdasarkan kebergantungan:

1. Bina peta carta akaun sasaran dan luluskan setiap akaun yang belum dipetakan.
2. Import pelanggan, pembekal, produk, tetapan cukai, akaun bank dan data induk lain.
3. Import invois jualan, invois belian, sebut harga, pesanan penghantaran dan baucar bayaran.
4. Import resit invois dan bayaran pembekal hanya selepas dokumen induknya wujud.
5. Import transaksi bank dan pasangkan pindahan antara bank tanpa menganggap kedua-dua kaki sebagai hasil atau belanja.
6. Catat jurnal baki awal atau jurnal sejarah yang diluluskan, mengikut asas yang dipilih.
7. Pautkan lampiran selepas ID dokumen sasaran menjadi stabil.
8. Jalankan semua padanan kawalan dan pengesahan nilai.

Setiap kelompok perlu gagal secara tertutup. Resit tanpa invois padanan, dokumen dengan dua calon pelanggan, atau baris lejar tanpa peta akaun yang diluluskan mesti masuk ke fail pengecualian. Penggunaan LIMIT 1, padanan berdasarkan nama pertama, atau nilai sandaran senyap akan menukarkan masalah migrasi yang boleh dilihat kepada kesilapan akaun tersembunyi.

Penghurai migrasi GetPay mengikuti pemisahan tugas yang sama: ia membaca dan mengesahkan fail, menghasilkan bukti ujian kering, serta mengeluarkan kelompok yang boleh disemak tanpa memegang kelayakan pangkalan data. Seorang operator yang diberi kuasa melakukan penulisan langsung selepas semakan sampel.

Bagaimanakah idempotensi patut dilaksanakan?

Setiap rekod yang diimport memerlukan identiti berasaskan sumber yang kekal sama apabila proses dicuba semula. Bagi satu dokumen, coraknya boleh jadi:

niagawan:{document_reference}

Bagi keluarga dokumen berbeza, masukkan jenis dokumen:

niagawan:invoice:{reference}
niagawan:receipt:{reference}
niagawan:do:{reference}

Kuatkuasakan keunikan dalam syarikat atau penyewa, bukannya secara global merentasi perniagaan yang tidak berkaitan. Apabila dijalankan semula, pengimport mesti memulangkan rekod sedia ada atau tidak melakukan perubahan secara sengaja. Ia tidak boleh menghasilkan invois kedua hanya kerana jawapan rangkaian sebelumnya tidak diterima.

Uji juga ketekalan dokumen induk. Penggunaan semula kunci idempotensi resit untuk invois lain mesti gagal, bukannya “berjaya” dengan memulangkan rekod lama yang tidak berkaitan. Selepas import pertama berjaya, jalankan kelompok yang sama sekali lagi dan buktikan bilangan rekod baharu kekal sifar serta semua rujukan sumber menunjuk kepada ID sasaran yang sama.

Bagaimanakah migrasi Niagawan disahkan?

Pengesahan perlu dibuat dalam empat lapisan.

1. Banci

Bagi setiap modul dan tempoh, bandingkan bilangan baris sumber, rujukan unik, julat tarikh dan rekod sasaran. Siasat jurang dan pendua satu demi satu. Bilangan rekod diperlukan tetapi belum mencukupi.

2. Sampel nilai

Pilih rekod daripada tempoh awal, pertengahan dan akhir, serta kes berbayar, belum bayar, separa bayar, dibatalkan, banyak baris, bercukai dan nama luar biasa. Bandingkan sumber dengan sasaran medan demi medan: rujukan, tarikh, pihak, teks item, kuantiti, harga, cukai, jumlah, agihan bayaran, status dan nota.

3. Penyesuaian perakaunan

Bagi setiap tahun kewangan:

• jumlah debit imbangan duga sasaran mesti sama dengan jumlah kredit;
• setiap akaun dipetakan mesti sepadan dengan baki sumber yang diluluskan atau layanan peralihan yang didokumenkan;
• Akaun Belum Terima mesti sepadan dengan jadual pelanggan terbuka;
• Akaun Belum Bayar mesti sepadan dengan jadual pembekal terbuka;
• baki bank mesti sepadan dengan penyata bank, bukan sekadar laporan perisian; dan
• pendapatan tertahan mesti dibawa ke hadapan secara konsisten daripada untung atau rugi penutup.

4. Kawalan negatif

Buktikan tiada rekod import berada dalam penyewa yang salah, tiada rujukan sumber pendua, tiada resit tanpa induk, tiada dokumen induk hilang dan tiada jurnal terikat kepada rekod yang ditetapkan sebagai dokumen sahaja. Jalankan semula import untuk membuktikan idempotensi. Sahkan lampiran melalui nama fail, saiz bait dan checksum jika boleh.

Imbangan duga yang sepadan tidak membenarkan nama, tarikh atau perihal yang rosak. Bilangan yang sepadan pula tidak membuktikan nilai terselamat. Jumlah perakaunan dan sampel nilai sebenar mesti lulus bersama.

Bilakah selamat untuk berhenti menggunakan Niagawan?

Beralih hanya selepas petikan beku, arkib mentah, import sasaran, padanan imbangan duga, padanan sublejar, penyesuaian bank, kelulusan pengecualian dan ujian aliran kerja kakitangan selesai.

Kekalkan Niagawan sebagai baca sahaja untuk tempoh jaminan yang ditetapkan jika akses masih tersedia. Simpan salinan luar talian bagi eksport mentah dan lampiran secara bebas daripada kedua-dua penyedia sistem. Persetujui tempoh penyimpanan rekod dan bukti berkanun dengan akauntan atau ejen cukai berdasarkan peraturan yang terpakai kepada entiti anda; jangan jadikan langganan SaaS sebagai satu-satunya arkib.

Akhir sekali, catat sempadan autoriti: sistem lama ialah bukti sejarah sehingga masa peralihan, manakala lejar am awan ialah satu-satunya tempat untuk catatan baharu selepas itu. Tanpa peraturan tersebut, kakitangan boleh membuka semula dua set buku walaupun migrasi teknikal telah dilaksanakan dengan sempurna.