1. Strona główna
  2. Dokumentacja
  3. Integracja z Comarch ERP ...
  4. Opis integracji
  5. Techniczny opis integracji z Comarch ERP XL

Techniczny opis integracji z Comarch ERP XL

Szukasz API do Comarch XL? Zobacz tutaj

Wymagania:

  • Konto Windows z uprawnieniami administratora.
  • Konto Windows musi posiadać dostęp do dodawania wpisów do Harmonogramu zadań.
  • Konto Windows musi mieć możliwość uruchomienia zadania w harmonogramie zadań.
  • Aplikacja działa w harmonogramie ponieważ API Comarch nie zapewnia bezbłędnego działania jako usługa.
  • Aplikacja komunikuje się po protokole HTTPS (można użyć własnego certyfikatu).
  • Wymagane jest stałe IP.
  • Port wskazany w konfiguracji musi być otwarty na nasze IP.
  • Webservice instalowany jest na serwerze, na którym zainstalowany jest system ERP.
  • Do działania wymagana jest wolna licencja na Comarch ERP XL.
  • Użytkownik SQL na którym działa aplikacja powinien posiadać minimum uprawnienia w roli cdnKNF, cdRaport i db_owner.

Dobre praktyki:

  • Konto Windows powinno być dedykowanym wyłącznie dla WebService, np.: xSale, dzięki temu unikamy “podkradania” sesji,
  • Konto w Comarch XL powinno być dedykowanym wyłącznie dla WebService np. xSale, dzięki temu dokumenty wprowadzane do Comarch ERP XL są zawsze na dedykowanym operatorze,
  • Licencje Comarch XL dla integracji powinny być wydzielone na osobny klucz i przypisane na wyłączność dla ww. użytkownika XL, dzięki temu unikamy braku licencji podczas pracy, który powoduje m.in. brak synchronizacji dokumentów.

Zmiany pod bazą danych wprowadzane podczas instalacji:

  • dodanie tabeli:
    • [CDN].[ALPOL_ArticleStock]
    • [CDN].[ALPOL_SyncObjectsTypes]
    • [CDN].[ALPOL_SyncObjectsVersion]
    • [CDN].[ALPOL_SyncObjects]
  • dodanie funkcji:
    • [CDN].[ALPOL_GetDocumentByShipmentWaybillERP]
    • [CDN].[ALPOL_GetDocumentByShipmentWaybill]
    • [CDN].[ALPOL_GetSalesDocumentIdByDocumentId]
    • AlpolWF.SplitString
    • AlpolWF.SplitStringIndex
    • AlpolWF.GetStockQuantityWithReservation
  • Inne skrypty i operacje wykonywane na bazie:
    • ALTER DATABASE [@DatabaseName] set change_tracking = on (change_retention = 5 days, auto_cleanup = on)
    • ALTER TABLE [CDN].[TwrZasoby] ENABLE CHANGE_TRACKING WITH (TRACK_COLUMNS_UPDATED = ON)
    • ALTER TABLE [CDN].[Rezerwacje] ENABLE CHANGE_TRACKING WITH (TRACK_COLUMNS_UPDATED = ON)
    • CREATE SCHEMA [AlpolWF]

Obiekty do których użytkownik SQL musi mieć dostęp modyfikacji:

  • [CDN].[ZamNag]

Sposób pracy integracji z Comarch ERP XL:

  • obiekty do systemu Comarch ERP XL są wprowadzane poprzez CDN API
  • integracja dodaje do systemu:
    • Towary
    • Kontrahenci
    • Adresy
    • Definicje atrybutów
    • Atrybuty
    • Płatności
    • Zamówienia
    • Inne dokumenty handlowe
    • Inne dokumenty magazynowe
  • Synchronizacja obiektów jest przeprowadzona na podstawie daty ostatniej modyfikacji. Wyjątkiem są stany magazynowe które są synchronizowane na podstawie change-logów.
  • Synchronizacja towarów i wszystkich powiązanych elementów jest realizowana po kodzie.

Lokalizacja instalacji: \!Futuriti_Programy\Futuriti Webservice XL

Lokalizacja backupu: \!Futuriti_Backup

Wymagania minimalne serwera: 

  • Takie same jak wymagania aktualnie zainstalowanej wersji Comarch ERP XL, natomiast ze względu na skalę działania wymagania dotyczące zasobów mogą być wielokrotnie wyższe.
  • Serwer powinien pracować nieprzerwanie. Wyłączenie serwera „na noc” może powodować problemy z synchronizacją. 

Wersje:

  • Możliwość instalacji do trzech ostatnich najpopularniejszych wersji Comarch ERP XL.

Jeśli nie wiesz czy Twoja wersja ERP jest obsługiwana przez xSale, skontaktuj się z pomocą techniczną lub handlowcem.