Persediaan Logo & Mikro

Halaman ini ditujukan kepada pengguna perniagaan dan operasi. Seni bina teknikal dan butiran pembangun ada dalam docs/ERP_INTEGRATION.md.

Aliran keseluruhan

1. Buka rekod Logo atau Mikro di bawah Papan Pemuka → Integrasi perakaunan, tetapkan Aktif, dan pilih mod tulis selamat (lalai: CSV manual sahaja).
2. Di Papan Pemuka → Pemetaan produk ERP, lengkapkan pemetaan SKU → kod stok ERP, unit, dan SST (segerak dari produk atau tambah baris).
3. Pastikan pelanggan ada kod lejar/cari atau ID cukai; apabila pesanan dicipta, kerja masuk barisan pesanan ERP.
4. Muat turun CSV dari barisan atau butiran pesanan dan import ke ERP. Hidupkan penghantaran auto hanya selepas proses stabil.

Laluan: /dashboard/accounting · /dashboard/integration-mapping?provider=logo atau provider=mikro · /dashboard/integration-outbox.

Persediaan kongsi

Jelaskan di pihak ERP

• Cara pesanan dicipta: CSV manual, folder import dipantau, stored procedure / ejen tempatan.
• Sama ada medan SKU produk / varian Convord sepadan dengan kod stok ERP (atau gunakan jadual pemetaan).
• Cara pelanggan diselesaikan dalam ERP (<strong>kod cari/lejar</strong> diutamakan; jika tidak ID cukai).

Produk dan SKU varian dalam Convord

Isi SKU untuk setiap produk. Jika anda gunakan berat/varian, setiap varian patut ada SKU sendiri.

Panel pemetaan

Urus set pemetaan aktif anda di Pemetaan produk ERP: tambah baris SKU atau "segerak dari produk"; semak pemetaan unit dan SST lalai. Muat turun CSV barisan memerlukan snapshot pemetaan.

Tulis selamat dan automasi

Dalam tetapan, mod tulis selamat: CSV manual sahaja, fail import sahaja, atau prosedur sahaja. Penghantaran ERP auto dimatikan secara lalai; aktifkan hanya selepas ~20 pemindahan berjaya dan pemetaan/data pelanggan kukuh.

Logo — perspektif pengguna

Convord dahulu tulis pesanan ke barisan outbox. Laluan Logo biasa: import CSV manual atau (lanjutan) stored procedure SQL / ejen tempatan. Ujian sambungan "REST" klasik tidak digunakan untuk Logo; tolak REST Logo langsung dilumpuhkan dalam produksi.

Dalam papan pemuka

1. Integrasi perakaunan → Logo → Mulakan persediaan / Tetapan.
2. Pilihan endpoint API / kunci API untuk jambatan; untuk operasi tetapkan mod tulis selamat dan tandakan integrasi Aktif.
3. Lengkapkan pemetaan SKU di Pemetaan produk ERP (provider=logo).
4. Buat pesanan ujian → muat turun CSV dari barisan pesanan ERP atau dari butiran pesanan.

Mikro — perspektif pengguna

Corak biasa: letak CSV berpemisah ke folder import. Alternatif: tarikan data induk jambatan (pelanggan/produk/stok) dan Convord ERP Agent tempatan pilihan. Tolak pesanan masih melalui outbox.

Dalam papan pemuka

1. Integrasi perakaunan → Mikro → Tetapan.
2. Pilih transport: fail (laluan import + awalan fail) atau jambatan (URL). Varian: Mikro Fly / Run / Jumbo, dll.
3. Dalam mod fail, masukkan laluan import boleh tulis dan Uji sambungan; dalam mod jambatan gunakan semakan kesihatan dan butang segerak.
4. Panel pemetaan (provider=mikro) + pesanan ujian → barisan / CSV.

CSV manual (permulaan disyorkan)

Laluan lalai dan sandaran:

• Muat turun CSV untuk kerja dari barisan pesanan ERP (snapshot pemetaan mesti ada).
• Alternatif muat turun CSV Logo / Mikro dari butiran pesanan (/dashboard/orders/{id}/erp-manual-export/logo atau .../mikro).
• Lajur nama produk (PRODUCT_NAME / UrunAdi) membantu pengesahan dalam Excel; tanpa pemetaan, lajur stok mungkin menunjukkan SKU dalaman.

Lajur Logo: ORDER_NO;STOCK_CODE;PRODUCT_NAME;QTY;UNIT;UNIT_PRICE
Lajur Mikro: BelgeNo;StokKodu;UrunAdi;Miktar;Birim
Format: UTF-8 (BOM), pemisah ;.

Senarai semak (ringkasan)