Logo ve Mikro kurulumu

Bu sayfa işletme ve operasyon kullanıcıları için özetlenmiştir. Teknik mimari ve geliştirici ayrıntıları docs/ERP_INTEGRATION.md dosyasında yer alır.

Genel akış

1. Dashboard → Muhasebe Entegrasyonları üzerinden Logo veya Mikro kaydı açıp Aktif edin; güvenli yazma modunu seçin (varsayılan: yalnızca manuel CSV).
2. Dashboard → ERP ürün eşlemeleri ekranında SKU → ERP stok kodu, birim ve KDV eşlemelerini tamamlayın (ürünlerden senkron veya satır ekleme).
3. Müşterilerde cari kod veya vergi numarası dolu olsun; sipariş oluşunca iş ERP sipariş kuyruğuna düşer.
4. Kuyruktan veya sipariş detayından CSV indirip ERP’ye import edin. Otomatik gönderimi yalnızca süreç oturduktan sonra açın.

Yollar: /dashboard/accounting · /dashboard/integration-mapping?provider=logo veya provider=mikro · /dashboard/integration-outbox.

Ortak hazırlıklar

ERP tarafında netleştirin

• Siparişin hangi yolla açılacağı: manuel CSV, izlenen import klasörü, saklı yordam / yerel ajan.
• Convord ürün / varyant SKU alanları ile ERP stok kodlarının uyumu (veya eşleme tablosu).
• Müşteri kaydının ERP’de nasıl bulunacağı (<strong>cari kod</strong> tercih edilir; yoksa vergi no).

Convord’da ürün ve varyant SKU

Her ürün için SKU doldurun. Gramaj/varyant kullanıyorsanız her varyantın kendi SKU’su olsun.

Eşleme paneli

ERP ürün eşlemeleri sayfasından aktif mapping set’inizi yönetirsiniz: SKU satırları ekleyin veya «ürünlerden senkron» kullanın; varsayılan birim ve KDV eşlemelerini kontrol edin. Kuyruk CSV’si için eşleme anlık görüntüsü (snapshot) gerekir.

Güvenli yazma ve otomasyon

Ayarlarda güvenli yazma modu: yalnızca manuel CSV, yalnızca import dosyası veya yalnızca saklı yordam. Otomatik ERP gönderimi varsayılan kapalıdır; açmadan önce en az ~20 başarılı aktarım ve doğru eşleme/müşteri verisi önerilir.

Logo — kullanıcı perspektifi

Convord siparişi önce outbox kuyruğuna yazar. Logo tarafında yaygın model: CSV ile elle import veya (ileri kurulum) SQL saklı yordam / yerel ajan. Paneldeki klasik «REST bağlantı testi» Logo için kullanılmaz; üretimde doğrudan Logo REST push kapalıdır.

Panelde

1. Muhasebe Entegrasyonları → Logo → Kuruluma Başla / Ayarlar.
2. Gerekirse köprü için API Endpoint / API Key; asıl operasyon için güvenli yazma modu ve entegrasyonu Aktif edin.
3. ERP ürün eşlemeleri (provider=logo) ile SKU eşlemesini tamamlayın.
4. Test sipariş verin → ERP sipariş kuyruğundan CSV indirin veya sipariş detayından Logo CSV alın.

Mikro — kullanıcı perspektifi

Yaygın model: ayırıcılı CSV’nin import klasörüne bırakılması. Alternatif: bridge ile ana veri çekme (müşteri/ürün/stok) ve isteğe bağlı yerel Convord ERP Agent. Sipariş push yine outbox üzerinden yürür.

Panelde

1. Muhasebe Entegrasyonları → Mikro → Ayarlar.
2. Transport seçin: dosya (import yolu + dosya öneki) veya bridge (URL). Varyant: Mikro Fly / Run / Jumbo vb.
3. Dosya modunda yazılabilir import yolunu girip Bağlantıyı Test Et; bridge modunda sağlık kontrolü ve çekme (sync) butonlarını kullanın.
4. Eşleme paneli (provider=mikro) + test sipariş → kuyruk / CSV.

Manuel CSV (önerilen başlangıç)

Varsayılan ve yedek yol:

• ERP sipariş kuyruğundan ilgili iş için CSV indirin (eşleme snapshot’ı dolu olmalı).
• Alternatif: sipariş detayından Logo / Mikro CSV indirin (/dashboard/orders/{id}/erp-manual-export/logo veya .../mikro).
• Ürün adı sütunları (PRODUCT_NAME / UrunAdi) Excel’de doğrulamayı kolaylaştırır; eşleme yoksa stok kodunda dahili SKU görünebilir.

Logo sütunları: ORDER_NO;STOCK_CODE;PRODUCT_NAME;QTY;UNIT;UNIT_PRICE
Mikro sütunları: BelgeNo;StokKodu;UrunAdi;Miktar;Birim
Biçim: UTF-8 (BOM), ayırıcı ;.

Kontrol listesi (özet)