Kurulum

Kurulum ve bakım

Kurulum tek dosyadır ve yaklaşık on dakika sürer. Ürün hiçbir hesap ya da parola hazır getirmez; Sovos ve Yukato bilgileri kurulumdan sonra panelden girilir.

Gereksinimler

• Windows Server 2016+ veya Windows 10/11 (64 bit), yönetici hakkı.
• SQL Server 2016+ (Express yeterli). Ürün kendi veritabanını oluşturur; ERP veritabanına kurulacaksa tablolar ürün önekli açılır.
• Sovos e-İrsaliye web servisi kullanıcısı (en az okuma yetkili) — her gönderici firma için.
• Yukato External Shipper API hesabı (Test ve/veya Canlı): istemci kimliği, gizli anahtar, kullanıcı, gönderici firma ve adres kimlikleri.
• Giden HTTPS: Sovos servis adresi, Yukato API adresi ve lisans.erp.tr. Kurum vekil sunucu kullanıyorsa Yapılandırma'da tanımlanır.
• .NET kurmaya gerek yoktur; paket kendi çalışma ortamını taşır.

1. Paketi çalıştırın

Sovos2YukatoKurulum-1.0.0.exe dosyasını indirip sağ tık → Yönetici olarak çalıştır. Kurulum:

• uygulamayı C:\Program Files\ERP\Sovos2Yukato klasörüne açar (--klasor ile değişir),
• ERP Sovos2Yukato Windows servisini kurar ve 5191 portundan başlatır (--port ile değişir; dolu ise boş port önerir),
• servis açıklamasına erişim adresini (IP + port) yazar,
• kurulum sihirbazını Edge veya Chrome ile açar.

2. Kurulum sihirbazı (ilk açılış)

1. SQL Server bağlantısı: sunucu, kimlik türü ve veritabanı adı; Bağlantıyı test et yeşil olmadan ilerlenmez. Veritabanı yoksa oluşturulur, şema kendiliğinden kurulur.
2. Kurulum paketi (isteğe bağlı): başka bir kurulumdan alınmış parolalı ayar paketi önizlenip uygulanır; yeni kurulumda atlanır.
3. Windows servisi: servis durumu, port ve başlat/durdur.
4. Özet: bağlantı denetimi ve servis durumu tek ekranda; panel açılır.

İlk yönetici hesabı admin'dir. Parolasını sunucuda yönetici konsolunda Sovos2Yukato.App.exe reset-admin üretir; tek kullanımlıktır ve ilk girişte değiştirilir.

3. Yapılandırma

Panelde Yapılandırma ekranı adım adım ilerler. Sırlar (parola, gizli anahtar) veritabanında makine anahtarıyla şifreli saklanır, ekranda maskelenir.

1. Sovos hesapları — her gönderici firma için Sovos kullanıcısı, parolası ve VKN'si.
2. Sovos bağlantısı — servis adresi (test/canlı), sorgu aralığı; bağlantı testi.
3. Yukato — Test / Canlı ortam seçimi ve her ortamın API bilgileri, gönderici firma adı.
4. Eşleme ve zamanlama — mağaza kodu → Yukato adres eşlemesi, çekme/gönderme/izleme aralıkları.
5. Veritabanı bağlantısı — bağlantı dizesinin yapılandırılmış düzenlenmesi ve testi.
6. Perakende müşteriler — sevkiyata dönüşecek alıcıların VKN listesi.
7. Ağ / vekil sunucu — Otomatik, Yok veya Elle (Windows kimliğiyle); erişim testi DNS → TCP → TLS → HTTPS adımlarını ölçer.
8. Lisans — lisans künyesi; internet erişimi olmayan kurulumda çevrimdışı .erplic dosyası.
9. E-posta — SMTP sunucusu; geçici parola ve parola sıfırlama e-postaları için.

Önce Test ortamında birkaç irsaliyeyi uçtan uca gönderip doğrulayın, sonra Canlı'ya geçin.

Panele erişim

Panel http://<sunucu>:5191 adresinden açılır; adres Windows hizmetler listesinde servis açıklamasında da yazar. Ağ dışına açılacaksa önüne HTTPS ters vekil (IIS, Caddy) konmalıdır.

Güncelleme

Lisanslı kurulumlarda servis yeni sürümü ERP güncelleme kanalından imzalı olarak denetler; baytlar SHA-256 ile doğrulanır, takastan sonra sağlık denetimi geçmezse önceki sürüme geri dönülür. Elle güncellemek için yeni kurulum dosyasını çalıştırmak yeterlidir.

Kaldırma

Sovos2YukatoKurulum-1.0.0.exe kaldir servisi durdurup kaldırır. Dosyalar, ayarlar ve veritabanı yerinde kalır.

Kurtarma komutları

• Sovos2Yukato.App.exe reset-admin [kullanıcı] — yönetici parolasını sıfırlar (yönetici konsolu).
• Sovos2Yukato.App.exe lisans-istek — çevrimdışı lisans için cihaz bilgi dosyası üretir.