QUANTUM ERP WEB API — KURULUM

Bu dosya yayın (publish) paketinin içindedir. Kurulumdan önce okuyun.


1) SUNUCUDA OLMASI GEREKENLER
------------------------------
- Windows Server (veya Windows 10/11)
- IIS (Internet Information Services)
- ASP.NET 4.8 / .NET Framework 4.8
- IIS özelliklerinden: ASP.NET 4.8, ISAPI Extensions, ISAPI Filters
- SQL Server (ERP veritabanının bulunduğu sunucu; API sunucusuyla aynı olmak zorunda değil)
- SQL kullanıcısının ERP veritabanına okuma/yazma yetkisi


2) IIS KURULUMU
---------------
1. Publish klasörünü sunucuya kopyalayın:C:\inetpub\wwwroot\MobilErpRest
2. IIS’te Site ekleyin.
   Fiziksel yol: C:\inetpub\wwwroot\MobilErpRest
   Binding: http, port 8081.
3. App_Data klasörüne yazma yetkisi verin (log için).
4. C klasörüne yazma yetkisi verin (log için).


2b) DEVEXPRESS DLL (ZORUNLU)
----------------------------
Aşağıdaki dosyayı indirip bin klasörüne koyun:

  https://webftp.quantumyazilim.com/Quantum%20Erp%20Mobil%20Rest%C2%A0api/DevExpress.Data.v24.1.dll

Hedef:

  C:\inetpub\wwwroot\MobilErpRest\bin\DevExpress.Data.v24.1.dll

Bu DLL yoksa API açılmaz / DevExpress hatası verir.


2c) DIZAYNLAR KLASÖRÜ (ZORUNLU)
-------------------------------
Aşağıdaki dosyalar Dizaynlar içinde olmalı (e-fatura / e-irsaliye / lisans):

  C:\inetpub\wwwroot\MobilErpRest\Dizaynlar\settings.cfg
  C:\inetpub\wwwroot\MobilErpRest\Dizaynlar\SettingsLicanseNew.dll
  C:\inetpub\wwwroot\MobilErpRest\Dizaynlar\general.xslt
  C:\inetpub\wwwroot\MobilErpRest\Dizaynlar\generaldespatc.xslt

  general.xslt        = e-fatura görünümü
  generaldespatc.xslt = e-irsaliye görünümü
  settings.cfg + SettingsLicanseNew.dll = lisans ayarı

  SettingsLicanseNew.dll yoksa Quantum ERP Dizaynlar klasöründen kopyalayın.


3) WEB.CONFIG AYARLARI (ZORUNLU)
--------------------------------
Dosya: Web.config

A) Connection string — Erp_EntitiyEntities

   Quantum ERP’deki connection string’i olduğu gibi kopyalayıp
   Web.config içindeki Erp_EntitiyEntities satırına yapıştırın.

   (data source, initial catalog, user id, password ERP’dekiyle aynı olmalı.)

B) appSettings

   ServisVersion = API sürüm numarası (ör. 1.0.3).
   Mobil / GetSystemInfo bu değeri kullanır. Gerekirse güncelleyin.

   Diğer appSettings satırlarına dokunmayın.


4) KONTROL
----------
Tarayıcı veya Postman:

  GET  http://SUNUCU:8081/api/System/GetSystemInfo
       → Versiyon dönmeli.

  POST http://SUNUCU:8081/api/RestLogin/Login
       → kullanıcı adı / şifre ile token alınır.

Sonraki isteklerde header:

  Auth: <token>


5) HATA DURUMUNDA LOG
---------------------
HATA OLURSA LOG DOSYASINI OKUYUN:

  C:\ERPRESTLOG.TXT

  C:\INETPUB\WWWROOT\MOBILERPREST\APP_DATA\LOGS\API-LOG-YYYYMMDD.TXT


6) SIK KARŞILAŞILAN SORUNLAR
----------------------------
- 500 / Entity Framework: connection string ERP’den kopyalanmamış veya yanlış.

- VERİTABANI GÜNCEL DEĞİL
  Quantum ERP son model.dbm ile sunucudaki tüm DB’leri güncelleyin.

- SERVİSVERSION GÜNCEL DEĞİL
  Web.config içindeki ServisVersion’ı yeni sürüme çekin.


Quantum Yazılım