Szukasz API do Comarch Optima? Zobacz tutaj.
Wymagania
- Konto Windows z uprawnieniami administratora.
- Konto Windows z możliwością dodawania wpisów do Harmonogramu zadań i uruchamiania zadań.
- Aplikacja działa w Harmonogramie zadań, ponieważ API Comarch nie działa stabilnie jako usługa.
- Komunikacja odbywa się po HTTPS (można użyć własnego certyfikatu).
- Wymagany jest stały adres IP.
- Port wskazany w konfiguracji musi być otwarty na IP Futuriti (193.239.184.2).
- WebService instalowany jest na serwerze, na którym działa system ERP.
- Użytkownik SQL powinien mieć minimum uprawnienia w rolach CDN i CDNRaport na bazie firmowej i konfiguracyjnej.
- Wymagana wersja serwera SQL: SQL Server 2012 (11.x) lub nowsza.
- Uwaga: na czas instalacji użytkownik SQL musi mieć uprawnienia do wprowadzenia zmian opisanych poniżej.
Dobre praktyki
- Konto Windows powinno być dedykowane wyłącznie dla WebService (np. xSale), aby uniknąć „podkradania” sesji.
- Konto w Comarch Optima powinno być dedykowane wyłącznie dla WebService (np. xSale), aby dokumenty były wprowadzane na dedykowanym operatorze.
- Licencje Comarch Optima dla integracji warto wydzielić na osobny klucz i przypisać na wyłączność, aby uniknąć braku licencji podczas pracy.
Zmiany w bazie podczas instalacji
Dodawane funkcje
- [CDN].[ALPOL_GetDocumentByShipmentWaybill]
- [CDN].[ALPOL_GetDocumentByShipmentWaybillERP]
- [CDN].[ALPOL_GetSalesDocumentIdByDocumentId]
- [CDN].[ALPOL_fnTwrGrupyAtomStore]
- [CDN].[ALPOL_GetBaseSalesStocks]
- [CDN].[ALPOL_GetRecipeQuantity]
- [CDN].[ALPOL_GetRecipeQuantityInt]
Obiekty wymagające dostępu do modyfikacji
- [CDN].[TraNag] (tylko „TrN_NrListuPrzewozowego” – brak możliwości zmiany poprzez „CDN API”).
- [CDN].[DefAtrybuty] (ze względów wydajnościowych).
- [CDN].[DokAtrybuty] (ze względów wydajnościowych).
Obiekty wymagające dostępu do odczytu
- CDN.TwrGrupy
- CDN.Grupy
- CDN.TraNag
- CDN.TraElem
- CDN.DokAtrybuty
- CDN.TraNagRelacje
- CDN.Powiazania
- CDN.WdrPodlaczeniaZestawow
- CDN.WdrPodlaczeniaWydrukow
- CDN.Wydruki
- CDN.WdrZestawy
- CDN.DefAtrybuty
- CDN.TwrGrupyView
- CDN.DefCeny
- CDN.Magazyny
- CDN.DaneBinarneLinki
- CDN.TwrAtrybuty
- CDN.zamienniki
- CDN.towary
- CDN.twrkarty
- CDN.TwrGrupaPelnaNazwa(g.TwG_GrONumer)
- CDN.TwrJMZ
- CDN.ZstPromocje
- CDN.AtrybutyKlasy
- CDN.TwrPromocje
- CDN.Atrybuty
- CDN.KntPromocje
- CDN.KntGrupy
- CDN.PrmKarty
- CDN.FrsPromocje
- CDN.FrmStruktura
- CDN.AtrybutyHist
- CDN.TwrGrupyDom
- CDN.TwrIlosci
- CDN.ProdReceptury
- CDN.ProdSkladniki
- CDN.ALPOL_IntList
- CDN.ALPOL_GetRecipeQuantityInt()
- CDN.ALPOL_GetRecipeQuantity()
- CDN.Producenci
- CDN.ALPOL_fnTwrGrupyAtomStore()
- CDN.TwrCeny
- CDN.DaneKadMod
- CDN.DokRelacje
- CDN.Kontrahenci
- CDN.FromClarionDate
- CDN.KntAtrybuty
- CDN.SchematPlatnosci
- CDN.BnkNazwy
- CDN.DokAtrybuty
- CDN.KntOsoby
- CDN.PracEtaty
- CDN.Operatorzy
- CDN.BnkZdarzenia
- CDN.DokNagPliki
- CDN.DaneBinarne
- CDN.StanowiskaKomp
- CDN.FormyPlatnosci
- CDN.Zamienniki
- CDN.Powiazania
- CDN.TypDokumentu(TrN_TypDokumentu)
- CDN.BnkZapisy
- CDN.BnkRozRelacje
- CDN.BnkRozKwoty
- CDN.DokDefinicje
- CDN.ALPOL_GetDocumentByShipmentWaybill ()
- CDN.ALPOL_GetSalesDocumentIdByDocumentId ()
- CDN.Kategorie
- CDN.PodmiotyView
- CDN.KntOsoby
- CDN.PracKod
- CDN.Rabaty
Sposób pracy integracji z Comarch ERP Optima
- Obiekty są wprowadzane do systemu Comarch ERP Optima przez CDN API.
- Integracja dodaje do systemu m.in.: towary, kontrahentów, adresy, definicje atrybutów, atrybuty, płatności, rezerwacje odbiorcy, dokumenty handlowe i magazynowe.
- Synchronizacja obiektów odbywa się na podstawie daty ostatniej modyfikacji. Wyjątkiem są stany magazynowe synchronizowane na podstawie change-logów.
- Synchronizacja towarów i powiązanych elementów odbywa się po kodzie.
Lokalizacje
- Instalacja:
\!Futuriti_Programy\Futuriti Webservice Optima - Backup:
\!Futuriti_Backup
Wymagania minimalne serwera
- Takie same jak wymagania aktualnie zainstalowanej wersji Comarch ERP Optima, ale ze względu na skalę działania mogą być wielokrotnie wyższe.
- Serwer powinien pracować nieprzerwanie. Wyłączenie serwera „na noc” może powodować problemy z synchronizacją.
Obsługiwane wersje
- Integracja jest udostępniana dla trzech ostatnich wersji Comarch Optima.
Jeśli nie wiesz, czy Twoja wersja ERP jest obsługiwana przez xSale, skontaktuj się z pomocą techniczną lub handlowcem.
Przykładowy skrypt nadania uprawnień
USE [CDN_Futuriti_2021_4]
ALTER ROLE [CDN] ADD MEMBER [WebserviceOptima];
ALTER ROLE [CDNRaport] ADD MEMBER [WebserviceOptima];
USE [CDN_KNF_Konfiguracja_2021_4]
ALTER ROLE [CDN] ADD MEMBER [WebserviceOptima];
ALTER ROLE [CDNRaport] ADD MEMBER [WebserviceOptima];Można nadać także wyższe uprawnienia.
Uprawnienia można nadać lub zweryfikować z poziomu SQL Management Studio: wybierz bazę, przejdź do zakładki Security, a następnie na użytkowniku wejdź w Properties → Membership.
