Wymagania integracji ERP

​

Komputer dla agenta

​

Sieć

​

Miejsce na dysku

​

Login SQL Server

• konto domenowe komputera agenta, <DOMENA>\<KOMPUTER>$, gdy SQL Server działa na innym komputerze. Oba komputery muszą należeć do tej samej domeny albo do domen, które sobie ufają.
• NT AUTHORITY\SYSTEM, gdy SQL Server działa na samym komputerze agenta.

• odczytu czterech tabel: ARTYKUL, MAGAZYN, CENA i CENA_ARTYKULU. Daje go członkostwo w roli db_datareader;
• EXECUTE na własnej procedurze Wapro dbo.Api_ProductPriceModify, którą instaluje aktualny Wapro Mag. Test połączenia agenta to sprawdza (Procedura cen Wapro zainstalowana) i bez tego nie przechodzi. SQL Server ukrywa procedurę przed loginem, który nie może jej wykonać, więc brak uprawnienia i brak procedury wyglądają tak samo;
• opcjonalnie odczytu dwóch dalszych tabel: JEDNOSTKA (jednostka produktu) i KOD_KRESKOWY (jego dodatkowe kody kreskowe). Bez nich produkty nadal docierają, ale bez jednostki i bez dodatkowych kodów kreskowych, a agent zapisuje w logu ostrzeżenie;
• opcjonalnie odczytu trzech dalszych tabel: ARTYKUL_CENA_IE, POZYCJAKONFIG i INTERFIRMAPOZYCJA. Pozwalają one tylko agentowi sprawdzić, czy Wapro utrzymuje równe ceny w magazynach firmy (sprawdzenie Te same ceny we wszystkich magazynach, zobacz Wapro). Bez nich ceny są odczytywane i wysyłane jak zwykle, a sprawdzenie pokazuje swoją podpowiedź;
• opcjonalnie odczytu tabeli WFM_INT_SYSTEM. Pozwala ona tylko agentowi ostrzec o starej rejestracji śledzenia zmian (zobacz Wapro); bez niej to ostrzeżenie jest pomijane;
• opcjonalnie odczytu tabeli ARTYKUL_BLOB ze zdjęciami towarów Wapro oraz tabeli WAPROERP_KONFIGURACJA. Są potrzebne tylko do odczytu zdjęć produktów; bez ARTYKUL_BLOB wyłącza się tylko odczyt zdjęć, a cała reszta działa dalej.

-- Odczyt
ALTER ROLE db_datareader ADD MEMBER [<agent-login>];
-- albo tabela po tabeli:
-- GRANT SELECT ON dbo.ARTYKUL TO [<agent-login>];
-- GRANT SELECT ON dbo.MAGAZYN TO [<agent-login>];
-- GRANT SELECT ON dbo.CENA TO [<agent-login>];
-- GRANT SELECT ON dbo.CENA_ARTYKULU TO [<agent-login>];
-- GRANT SELECT ON dbo.JEDNOSTKA TO [<agent-login>];
-- GRANT SELECT ON dbo.KOD_KRESKOWY TO [<agent-login>];
-- GRANT SELECT ON dbo.ARTYKUL_CENA_IE TO [<agent-login>];
-- GRANT SELECT ON dbo.POZYCJAKONFIG TO [<agent-login>];
-- GRANT SELECT ON dbo.INTERFIRMAPOZYCJA TO [<agent-login>];
-- GRANT SELECT ON dbo.WFM_INT_SYSTEM TO [<agent-login>];
-- GRANT SELECT ON dbo.ARTYKUL_BLOB TO [<agent-login>];
-- GRANT SELECT ON dbo.WAPROERP_KONFIGURACJA TO [<agent-login>];

GRANT EXECUTE ON dbo.Api_ProductPriceModify TO [<agent-login>];

​

Uprawnienia do zamówień i klientów

• EXECUTE na własnych procedurach Wapro, które zakładają, zatwierdzają i anulują zamówienia oraz zakładają klientów: dbo.Api_OrderDocumentHeaderAdd, dbo.Api_OrderDocumentPositionAdd, dbo.Api_OrderDocumentAccept, dbo.Api_CustomerAddOrModify, dbo.Api_DocumentDeliveryAddressessAddOrUpdate, dbo.RM_ZatwierdzStatusZamowienia i dbo.RM_DodajZestawNaZam_Server (dodaje do zamówienia pozycję będącą zestawem). Ostatnie jest wymagane także wtedy, gdy nie sprzedajesz zestawów: bez niego sprawdzenie kończy się błędem i stają wszystkie zamówienia i wszyscy klienci. Jeśli login założono przed 2026-10-20, dodaj to uprawnienie;
• EXECUTE na trzech funkcjach, których te procedury używają: dbo.AP_Func_PobierzParamKonf, dbo.RM_Func_PodajTypZamowienia i dbo.WAPROERP_Func_DateTimeToClarionDate;
• INSERT na MIEJSCE_DOSTAWY, aby dodać własne miejsce dostawy zamówienia (domyślne miejsce klienta nigdy się nie zmienia);
• UPDATE na kolumnie ZAMOWIENIE_INTERNETOWE_ID tabeli ZAMOWIENIE, gdzie Omnilinker zapisuje swój odnośnik do zamówienia;
• UPDATE na kolumnach wolnych pól POLE1 do POLE10 tabel KONTRAHENT, ZAMOWIENIE i POZYCJA_ZAMOWIENIA. Procedury Wapro zapisują te pola dynamicznym SQL, który działa z uprawnieniami wywołującego, więc login potrzebuje ich, choć Omnilinker używa najwyżej jednego z tych pól;
• SELECT na ZAMOWIENIE, POZYCJA_ZAMOWIENIA, KONTRAHENT, MIEJSCE_DOSTAWY, DOSTAWA, KRAJE, ARTYKUL, MAGAZYN, JEDNOSTKA, STAWKA_VAT, STAWKA_VAT_UE, FIRMA_VAT_UE, WALUTY, FORMA_PLATNOSCI i widoku Api_V_CurrencyRates. Obejmuje je db_datareader;
• opcjonalnie EXECUTE na dbo.Api_CurrencyImport, aby agent mógł poprosić Wapro o pobranie kursów NBP przed zamówieniem w obcej walucie. Pobranie wymaga też, by SQL Server zezwalał na CLR i miał dostęp do strony NBP przez HTTPS; bez któregokolwiek z tych warunków zamówienie i tak zostanie wysłane, z ostrzeżeniem. Pomiń to uprawnienie, jeśli zostawisz wyłączone Pobieraj kursy NBP.

-- Zamówienia i klienci (oprócz uprawnień wyżej)
GRANT EXECUTE ON dbo.Api_OrderDocumentHeaderAdd TO [<agent-login>];
GRANT EXECUTE ON dbo.Api_OrderDocumentPositionAdd TO [<agent-login>];
GRANT EXECUTE ON dbo.Api_OrderDocumentAccept TO [<agent-login>];
GRANT EXECUTE ON dbo.Api_CustomerAddOrModify TO [<agent-login>];
GRANT EXECUTE ON dbo.Api_DocumentDeliveryAddressessAddOrUpdate TO [<agent-login>];
GRANT EXECUTE ON dbo.RM_ZatwierdzStatusZamowienia TO [<agent-login>];
GRANT EXECUTE ON dbo.RM_DodajZestawNaZam_Server TO [<agent-login>];
GRANT EXECUTE ON dbo.AP_Func_PobierzParamKonf TO [<agent-login>];
GRANT EXECUTE ON dbo.RM_Func_PodajTypZamowienia TO [<agent-login>];
GRANT EXECUTE ON dbo.WAPROERP_Func_DateTimeToClarionDate TO [<agent-login>];

GRANT INSERT ON dbo.MIEJSCE_DOSTAWY TO [<agent-login>];
GRANT UPDATE ON dbo.ZAMOWIENIE (ZAMOWIENIE_INTERNETOWE_ID) TO [<agent-login>];

-- Dziesięć wolnych pól klientów, zamówień i pozycji zamówień
GRANT UPDATE ON dbo.KONTRAHENT (POLE1, POLE2, POLE3, POLE4, POLE5, POLE6, POLE7, POLE8, POLE9, POLE10) TO [<agent-login>];
GRANT UPDATE ON dbo.ZAMOWIENIE (POLE1, POLE2, POLE3, POLE4, POLE5, POLE6, POLE7, POLE8, POLE9, POLE10) TO [<agent-login>];
GRANT UPDATE ON dbo.POZYCJA_ZAMOWIENIA (POLE1, POLE2, POLE3, POLE4, POLE5, POLE6, POLE7, POLE8, POLE9, POLE10) TO [<agent-login>];

-- Odczyt (jeśli nadajesz uprawnienia tabela po tabeli zamiast db_datareader)
-- GRANT SELECT ON dbo.ZAMOWIENIE TO [<agent-login>];
-- GRANT SELECT ON dbo.POZYCJA_ZAMOWIENIA TO [<agent-login>];
-- GRANT SELECT ON dbo.KONTRAHENT TO [<agent-login>];
-- GRANT SELECT ON dbo.MIEJSCE_DOSTAWY TO [<agent-login>];
-- GRANT SELECT ON dbo.DOSTAWA TO [<agent-login>];
-- GRANT SELECT ON dbo.KRAJE TO [<agent-login>];
-- GRANT SELECT ON dbo.STAWKA_VAT TO [<agent-login>];
-- GRANT SELECT ON dbo.STAWKA_VAT_UE TO [<agent-login>];
-- GRANT SELECT ON dbo.FIRMA_VAT_UE TO [<agent-login>];
-- GRANT SELECT ON dbo.WALUTY TO [<agent-login>];
-- GRANT SELECT ON dbo.FORMA_PLATNOSCI TO [<agent-login>];
-- GRANT SELECT ON dbo.Api_V_CurrencyRates TO [<agent-login>];
-- (ARTYKUL, MAGAZYN i JEDNOSTKA są w pierwszym bloku)

-- Opcjonalnie: pobieranie kursów NBP
-- GRANT EXECUTE ON dbo.Api_CurrencyImport TO [<agent-login>];

​

Uprawnienia do odczytu zamówień

• ZAMOWIENIE i POZYCJA_ZAMOWIENIA: zamówienia i ich pozycje;
• POZYCJA_DOKUMENTU_MAGAZYNOWEGO i DOKUMENT_MAGAZYNOWY: dokumenty magazynowe, które realizują zamówienie;
• DOKUMENT_HANDLOWY, razem z kolumną KSEF_ID: faktury i ich numery KSeF;
• TYP_DOKUMENTU_HANDLOWEGO: typy tych dokumentów, po których odróżnia się fakturę sprzedaży od innych dokumentów;
• opcjonalnie MAG_SLOWNIK_STATUSOW_DOKUMENTOW: nazwy statusów zamówień w Wapro. Bez niego odczyt działa, ale karta nie może pokazać własnej nazwy statusu z Wapro.

-- Odczyt zamówień z powrotem (jeśli nadajesz uprawnienia tabela po tabeli zamiast db_datareader)
-- GRANT SELECT ON dbo.ZAMOWIENIE TO [<agent-login>];
-- GRANT SELECT ON dbo.POZYCJA_ZAMOWIENIA TO [<agent-login>];
-- GRANT SELECT ON dbo.POZYCJA_DOKUMENTU_MAGAZYNOWEGO TO [<agent-login>];
-- GRANT SELECT ON dbo.DOKUMENT_MAGAZYNOWY TO [<agent-login>];
-- GRANT SELECT ON dbo.DOKUMENT_HANDLOWY TO [<agent-login>];
-- GRANT SELECT ON dbo.TYP_DOKUMENTU_HANDLOWEGO TO [<agent-login>];

-- Opcjonalnie: nazwy statusów zamówień w Wapro
-- GRANT SELECT ON dbo.MAG_SLOWNIK_STATUSOW_DOKUMENTOW TO [<agent-login>];

​

Uprawnienia do zmiany zamówień

• EXECUTE na własnych procedurach Wapro, które przygotowują zamówienie do zmiany oraz zmieniają lub usuwają pozycję: dbo.Api_OrderDocumentPrepareForModify, dbo.Api_OrderDocumentPositionModify i dbo.Api_OrderDocumentPositionDelete. Dodanie pozycji i zatwierdzenie zamówienia używają procedur z uprawnień do wysyłania zamówień;
• SELECT na POZYCJA_ZAMOWIENIA_SPRZEDAZ_TRANSGRANICZNA (wiersze transgraniczne pozycji) oraz na czterech tabelach z odczytu zamówień (POZYCJA_DOKUMENTU_MAGAZYNOWEGO, DOKUMENT_MAGAZYNOWY, DOKUMENT_HANDLOWY i TYP_DOKUMENTU_HANDLOWEGO), bo Omnilinker sprawdza, czy Wapro nie zrealizowało ani nie zafakturowało zamówienia, zanim cokolwiek zmieni. Obejmuje je db_datareader.

-- Zmiana zamówień (oprócz uprawnień wyżej)
GRANT EXECUTE ON dbo.Api_OrderDocumentPrepareForModify TO [<agent-login>];
GRANT EXECUTE ON dbo.Api_OrderDocumentPositionModify TO [<agent-login>];
GRANT EXECUTE ON dbo.Api_OrderDocumentPositionDelete TO [<agent-login>];

-- Odczyt (jeśli nadajesz uprawnienia tabela po tabeli zamiast db_datareader)
-- GRANT SELECT ON dbo.POZYCJA_ZAMOWIENIA_SPRZEDAZ_TRANSGRANICZNA TO [<agent-login>];
-- GRANT SELECT ON dbo.POZYCJA_DOKUMENTU_MAGAZYNOWEGO TO [<agent-login>];
-- GRANT SELECT ON dbo.DOKUMENT_MAGAZYNOWY TO [<agent-login>];
-- GRANT SELECT ON dbo.DOKUMENT_HANDLOWY TO [<agent-login>];
-- GRANT SELECT ON dbo.TYP_DOKUMENTU_HANDLOWEGO TO [<agent-login>];

​

Dostęp do Omnilinkera

​

Funkcja integracji ERP

​

Uprawnienia administratora organizacji

​

Dostęp samego agenta

​

Lista kontrolna

• Omnilinker włączył integrację ERP dla Twojej organizacji.
• Administrator organizacji ma wymienione wyżej uprawnienia.
• Jest 64-bitowy komputer z Windows, który pozostaje włączony i ma dostęp do serwera bazy danych ERP.
• Na tym komputerze jest konto lokalnego administratora do instalacji.
• Znasz konta Windows osób, które będą konfigurować agenta, żeby dodać je do grupy Omnilinker ERP Sync Operators.
• Z tego komputera jest wychodzący dostęp HTTPS (port 443) do omnilinker.pl i releases.omnilinker.com.
• Z tego komputera jest dostęp sieciowy do portu SQL Server bazy danych ERP.
• Jest login SQL Server z odczytem czterech tabel i uprawnieniem EXECUTE na dbo.Api_ProductPriceModify, a do wysyłania zamówień także uprawnienia do zamówień i klientów, a do odczytu ich statusu i faktur uprawnienia do odczytu zamówień, a do zmiany zamówień, które są już w Wapro, uprawnienia do zmiany zamówień. Przy uwierzytelnianiu Windows: login dla konta komputera agenta.
• Znasz nazwę serwera bazy danych ERP, nazwę bazy danych i numer firmy.