Wapro

​

Co odczytuje konektor

​

Szczegóły produktów

​

Które produkty są tworzone automatycznie

​

Jak odczytywane są stany

• Kiedy. Gdy zmapowany jest choć jeden magazyn połączenia (zobacz Listy i mapowania), agent odczytuje cały stan co 5 minut, licząc od końca poprzedniego odczytu. Gdy żaden magazyn nie jest zmapowany, odczytuje go raz dziennie.
• Jak mało przeszkadza Wapro. Agent czyta krótkimi stronami i zwalnia, gdy Wapro jest zajęte: strona, która trwa dłużej niż około 2 sekund, sprawia, że następna jest mniejsza, a po niej jest przerwa. Na blokadę czeka najwyżej 5 sekund, a potem próbuje później, i nigdy nie czyta niezatwierdzonych danych.
• Co wysyła. Porównuje każdy odczyt z ostatnim wysłanym i przesyła tylko produkty i magazyny, których liczby się zmieniły, więc spokojne Wapro wysyła prawie nic. Wiersz stanu, który zniknął z Wapro, jest wysyłany jako 0. Raz dziennie wysyłany jest pełny zestaw, który poprawia też to, co mogło umknąć.
• Stan, którego Wapro nie wymienia. Produkt, którego nie ma w ostatnim pełnym zestawie Wapro w danym magazynie, ma tam 0 z oznaczeniem „brak na ostatniej liście z ERP”.
• Wstrzymanie i aktualizacja. Wstrzymany agent nie odczytuje stanów; zobacz aplikację w zasobniku.

​

Numer firmy

​

Jak identyfikowane są produkty

• Spacje na początku i na końcu indeksu są pomijane. Nic więcej: abc-1 i ABC-1 to dwa produkty.
• Artykuł, którego indeks jest pusty albo zawiera same spacje lub inne białe znaki, nie jest produktem i zostaje pominięty.
• Kodem produktu w Omnilinkerze jest jego indeks. Domyślnie Omnilinker wiąże produkt z ERP z produktem w katalogu, którego SKU jest równe temu kodowi; połączenie może też wiązać po EAN. Zobacz Wiązanie produktów.
• Klucz ERP produktu to najniższy identyfikator artykułu (ID_ARTYKULU) wśród jego wierszy, także usuniętych. Nie zmienia się, gdy zmienisz indeks we wszystkich wierszach produktu na taki, którego nie ma żaden inny produkt, wyłączysz lub usuniesz wiersz albo dodasz magazyn, więc powiązanie przetrwa te zmiany.
• Produkt jest aktywny, gdy co najmniej jeden z jego wierszy jest aktywny dla systemów zewnętrznych (AKTYWNY_DLA_SYS_ZEW = 1) i nie jest oznaczony jako usunięty (FLAGA_STANU = 5).

• Jeśli wśród zmienionych wierszy jest ten, który przechowuje klucz, powiązanie idzie za zmienionymi wierszami. Dostaje ich nowy kod, a wiersze, które zachowały stary indeks, pojawiają się jako nowy produkt bez powiązania.
• Jeśli zmieniony nie jest ten wiersz, powiązanie zostaje tam, gdzie było, a zmienione wiersze pojawiają się jako nowy produkt.

• Powiązanie, którego klucz nadal jest na liście, zostaje przy produkcie wymienionym pod tym kluczem i przyjmuje indeks tego produktu jako kod.
• Powiązanie, którego klucza nie ma już na liście, przechodzi na produkt z listy, który ma jego kod, ale tylko wtedy, gdy dokładnie jeden produkt go ma i nie ma jeszcze powiązania. W przeciwnym razie powiązanie zostaje i pokazuje się w sekcji Powiązania z produktami, których nie ma już na liście produktów ERP, dopóki nie usuniesz tego powiązania (Usuń powiązanie; zobacz Produkty, których nie ma już w ERP).

​

Jak odczytywane są ceny

• Który wiersz. Artykuł ma po jednym wierszu na magazyn (zobacz Jak identyfikowane są produkty). Konektor odczytuje cenę z głównego wiersza produktu: jego aktywnego wiersza w magazynie źródłowym połączenia albo aktywnego wiersza o najniższym numerze, gdy magazyn źródłowy go nie ma. Ceny z pozostałych wierszy magazynowych artykułu pomija. To też wiersz, do którego trafia wysłana przez Ciebie cena. Zobacz Magazyn źródłowy.
• Co wysyła. Cenę netto i brutto tak, jak trzyma je Wapro, z czterema miejscami po przecinku, razem z walutą wiersza. Wapro zostawia walutę ceny w PLN pustą, a konektor wysyła dla niej PLN. Cena w innej walucie jest wysyłana w tej walucie: Wapro przelicza ją dopiero na dokumencie, po kursie z danego dnia, więc Omnilinker niczego nie przelicza.
• Co pomija. Wiersz, w którym netto i brutto wynoszą 0, wiersz z brakującą kwotą i produkt bez aktywnego wiersza. Pominiętą cenę Omnilinker odczytuje jako brak ceny, nigdy jako 0.
• Która jednostka. Cena jednostki podstawowej artykułu. Sprzedaż w innej jednostce kosztuje cenę razy przelicznik jednostki w Wapro, czego konektor nie stosuje; ceny dla innych jednostek i progów ilościowych nie są odczytywane.
• Jak mało przeszkadza Wapro. Tak samo jak przy stanach: krótkie strony, przerwa, gdy Wapro zwalnia, oczekiwanie na blokadę najwyżej 5 sekund i nigdy niezatwierdzone dane. Porównuje każdy odczyt z ostatnim wysłanym i przesyła tylko ceny, które się zmieniły. Cena, która znika z Wapro, jest oznaczana jako zniknięta, a nie ustawiana na 0.
• Wstrzymanie i aktualizacja. Wstrzymany agent nie odczytuje cen; zobacz aplikację w zasobniku.

​

Wysyłanie cen do Wapro

• Użytkownik ERP do zapisu ustawiony w połączeniu (zobacz Karta Przegląd). Wapro sprawdza jego prawo zmiany cen sprzedaży (ArtykCenSprz) w magazynie zapisywanego wiersza. Wybierz użytkownika z tym prawem i bez większych uprawnień, niż potrzebuje zapis, a nie administratora Wapro.
• Prawo wykonania dbo.Api_ProductPriceModify i odczytu wierszy cen (CENA_ARTYKULU) dla loginu SQL agenta; zobacz Login SQL Server.

• W jednym wierszu produktu opisanym w sekcji Jak identyfikowane są produkty, netto albo brutto, tak jak ją wysłano; drugą kwotę Wapro wylicza ze stawki VAT sprzedaży produktu. Produkt musi już mieć wiersz ceny na tym poziomie: procedura zmienia cenę, a nigdy jej nie tworzy.
• Nie na poziomie, który Wapro wylicza z innego poziomu: Omnilinker odrzuca go przed wysłaniem.
• Nie dla jednostki innej niż podstawowa ani z minimalną ilością.
• W walucie wiersza; Wapro niczego nie przelicza.
• Znacznik Cena domyślna artykułu nigdy się nie przesuwa.

​

Jak odczytywane są zdjęcia produktów

• Które zdjęcia. Zdjęcia produktu to wiersze ARTYKUL_BLOB, których indeks katalogowy (INDEKS_KATALOGOWY) jest równy indeksowi jednego z wierszy produktu w Twojej firmie, bez względu na wielkość liter, tak jak pokazuje je samo Wapro. Dwa produkty, których indeksy różnią się tylko wielkością liter, mają więc wspólne zdjęcia. Zdjęcie innej firmy nigdy nie jest odczytywane.
• Zdjęcie główne to zdjęcie oznaczone jako domyślne (DOMYSLNE). Jeśli oznaczonych jest kilka, najstarsze z nich; jeśli żadne, najstarsze zdjęcie. Pozostałe idą w kolejności dodania, nigdy według nazwy. Nazwa zdjęcia (NAZWA) staje się nazwą jego pliku w Omnilinkerze.
• Znaczniki sklepu i aukcji (DOSTEPNE_ABSTORE, DOSTEPNE_AUKCJE) są odczytywane, ale jeszcze niczego nie filtrują: brane są wszystkie zdjęcia produktu.
• Zmiany. Agent porównuje zdjęcia mniej więcej co godzinę i raz dziennie odczytuje je w całości. Nowe, podmienione albo usunięte zdjęcie, nowa nazwa albo przeniesione oznaczenie zdjęcia głównego są zauważane przy następnym porównaniu. Edytor zdjęć w samym Wapro potrafi podmienić zawartość zdjęcia z zachowaniem jego identyfikatora, a czasem i dokładnego rozmiaru; taką zmianę wykrywa codzienne sprawdzenie o 2:00 w nocy (czas komputera agenta), które oblicza odciski zdjęć na serwerze SQL. To sprawdzenie wymaga SQL Server 2016 lub nowszego: na starszym serwerze okno Rozwiązywanie problemów w aplikacji w zasobniku pokazuje ostrzeżenie Codzienne sprawdzanie zawartości zdjęć: Wyłączone (SQL Server starszy niż 2016), a niezauważone zostaje tylko zdjęcie o dokładnie tym samym rozmiarze.
• Zdjęcia w folderze. Wapro może trzymać zdjęcia dodane w programie w folderze zamiast w bazie danych (tryb dyskowy). Omnilinker nie odczytuje tego folderu: te zdjęcia nie trafiają do Omnilinkera, nigdy nie są traktowane jak usunięte, a okno Rozwiązywanie problemów pokazuje ostrzeżenie Gdzie Wapro przechowuje zdjęcia towarów: W folderze zdjęć (tryb dyskowy). Zdjęcia zapisane w bazie danych trafiają dalej, w każdym trybie. Aby poznać tryb, konektor odczytuje WAPROERP_KONFIGURACJA (albo INTERFIRMAPOZYCJA i POZYCJAKONFIG); bez dostępu do nich przyjmuje tryb bazy danych.
• Zdjęcia bez danych. Funkcja Wapro zmniejszająca rozmiar bazy czyści dane zdjęć, ale zostawia ich wiersze. Takie zdjęcie jest na liście bez danych, a Omnilinker zachowuje zdjęcie, które już ma, bez zmian.
• Obciążenie. Dane zdjęć są odczytywane po jednym zdjęciu, w częściach, i domyślnie przesyłane z prędkością najwyżej 30 MB na minutę, więc pierwszy odczyt dużego katalogu trwa godziny. Gdy agent jest wstrzymany, nic nie jest odczytywane. Co 50 zdjęć, jeśli agent właśnie zapisuje w Wapro cenę albo zamówienie, przesyłanie czeka, aż skończy, najwyżej 30 sekund.

​

Co zapisuje w Twojej bazie

• Zamówienie to zamówienie od klienta, zakładane przez Api_OrderDocumentHeaderAdd, Api_OrderDocumentPositionAdd i Api_OrderDocumentAccept (a dla pozycji będącej zestawem RM_DodajZestawNaZam_Server), w jednej transakcji: zapisuje się całe zamówienie albo nic. Przy włączonym Rezerwuj w ‹połączenie› (domyślnie) rezerwuje towar w magazynie źródła zamówienia. Odnośnik Omnilinkera do zamówienia (OMNI-…) trafia do internetowego numeru zamówienia, a numer zamówienia z kanału i login kupującego do wolnego pola wybranego na zakładce Zamówienia.
• Klient jest zakładany przez Api_CustomerAddOrModify tylko wtedy, gdy żaden istniejący nie pasuje. Klucz Omnilinkera trafia do wybranego wolnego pola. Konektor nigdy nie zmienia istniejącego klienta.
• Miejsce dostawy. Adres dostawy zamówienia jest dodawany do miejsc dostawy klienta jako osobne miejsce przez Api_DocumentDeliveryAddressessAddOrUpdate, po jednym zwykłym INSERT do MIEJSCE_DOSTAWY; pasujące miejsce jest używane ponownie. Domyślne miejsce dostawy klienta nigdy się nie zmienia. Dla paczkomatu miejsce ma własny adres paczkomatu, z operatorem InPost SHIPX, jeśli Allegro podało adres.
• Anulowanie idzie przez RM_ZatwierdzStatusZamowienia, które zwalnia też rezerwację.
• Zmiana produktów zamówienia, które jest już w Wapro (zobacz Zmiana zamówienia, które jest w ERP), idzie przez Api_OrderDocumentPrepareForModify, Api_OrderDocumentPositionDelete, Api_OrderDocumentPositionModify, Api_OrderDocumentPositionAdd i Api_OrderDocumentAccept, wszystkie w jednej transakcji. Samo Wapro niczego nie odmawia dla zamówienia zrealizowanego, zafakturowanego ani zamkniętego, więc konektor najpierw czyta zamówienie i odrzuca zmianę, niczego nie zapisując, gdy zamówienie jest zrealizowane, częściowo zrealizowane, zafakturowane, zamknięte lub anulowane, gdy ktoś zmienił jego pozycje w Wapro od ostatniej wysyłki z Omnilinkera albo gdy ma pozycję będącą zestawem. Pozycji będącej zestawem nigdy nie edytuje, a pozycję dostawy i pozostałe dane zamówienia zostawia bez zmian.
• Kursy walut, jeśli zostawisz włączone Pobieraj kursy NBP: przed zamówieniem w obcej walucie konektor wywołuje własną procedurę Wapro Api_CurrencyImport, która pobiera tabele Narodowego Banku Polskiego tak, jak robi to Wapro. Sam nigdy nie zapisuje kursu. Pobranie wymaga, by SQL Server zezwalał na CLR, ufał komponentowi pobierania Wapro i miał dostęp do api.nbp.pl przez HTTPS. Gdy czegoś brakuje, pobranie kończy się ostrzeżeniem w potwierdzeniu zamówienia (Integracja ERP > Polecenia), a zamówienie jest zakładane na tabelach, które Wapro już ma, jeśli są dość świeże (zobacz Zamówienia do ERP).
• Wolne pola. POLE1 do POLE10 Wapro zapisuje dynamicznym SQL; konektor wypełnia klucz klienta i numer zamówienia z kanału, a pozostałe Twoje pola zostawia bez zmian. Pól 6 i 7 nigdy nie używa, bo Wapro zapisuje je nieprawidłowo.

​

Usuwanie starej rejestracji

-- Removes the change-tracking registration an earlier Omnilinker agent left in a Wapro database: the WFM_INT_SYSTEM
-- row whose Opis is OMNILINKER, its subscriptions and its unread change rows. Nothing else: another system's rows are
-- never touched, and no table, trigger or column is changed. Run it once, in the Wapro database, as a login that may
-- delete from the WFM_INT tables. It removes everything or nothing: if it finds no such registration, or more than
-- one, it stops with an error and changes nothing. While it runs, saves in Wapro wait (its triggers read the
-- subscription rows this script deletes), so run it when nobody works in Wapro, for example after hours.

SET XACT_ABORT ON;
SET NOCOUNT ON;

BEGIN TRANSACTION;

DECLARE @found TABLE (Id_Systemu bigint NOT NULL);

INSERT INTO @found (Id_Systemu)
SELECT Id_Systemu
FROM dbo.WFM_INT_SYSTEM WITH (UPDLOCK, HOLDLOCK)
WHERE CAST(RTRIM(LTRIM(Opis)) AS nvarchar(50)) COLLATE Latin1_General_BIN2 = N'OMNILINKER';

IF (SELECT COUNT(*) FROM @found) <> 1
BEGIN
    ROLLBACK TRANSACTION;
    THROW 50000, N'Expected exactly one Omnilinker registration (WFM_INT_SYSTEM.Opis = ''OMNILINKER''); found none or more than one. Nothing was removed.', 1;
END;

DECLARE @id bigint = (SELECT Id_Systemu FROM @found);

-- The tables whose changes it was subscribed to, and the ones earlier agents subscribed, in case a subscription was
-- already removed while its change rows were left behind.
DECLARE @tables TABLE (NazwaTablicy varchar(100) NOT NULL PRIMARY KEY);

INSERT INTO @tables (NazwaTablicy)
SELECT DISTINCT NazwaTablicy
FROM dbo.WFM_INT_SYSTEM_TABLICE
WHERE Id_Systemu = @id;

INSERT INTO @tables (NazwaTablicy)
SELECT t.NazwaTablicy
FROM (VALUES ('ARTYKUL'), ('CENA'), ('CENA_ARTYKULU'), ('MAGAZYN'), ('KOD_KRESKOWY'),
             ('KATEGORIA_ARTYKULU'), ('KATEGORIA_ARTYKULU_TREE')) t (NazwaTablicy)
WHERE NOT EXISTS (SELECT 1 FROM @tables x WHERE x.NazwaTablicy = t.NazwaTablicy);

-- 1. Its subscriptions first: from here on Wapro's triggers write no more change rows for it.
DELETE FROM dbo.WFM_INT_SYSTEM_TABLICE
WHERE Id_Systemu = @id;

-- 2. Its change rows, in each WFM_INT_<table> that exists.
DECLARE @table varchar(100), @sql nvarchar(max);

DECLARE subscribed CURSOR LOCAL FAST_FORWARD FOR
    SELECT NazwaTablicy FROM @tables ORDER BY NazwaTablicy;

OPEN subscribed;
FETCH NEXT FROM subscribed INTO @table;
WHILE @@FETCH_STATUS = 0
BEGIN
    IF OBJECT_ID(N'dbo.' + QUOTENAME(N'WFM_INT_' + @table), N'U') IS NOT NULL
    BEGIN
        SET @sql = N'DELETE FROM dbo.' + QUOTENAME(N'WFM_INT_' + @table) + N' WHERE Id_Systemu = @id;';
        EXEC sys.sp_executesql @sql, N'@id bigint', @id = @id;
    END;

    FETCH NEXT FROM subscribed INTO @table;
END;
CLOSE subscribed;
DEALLOCATE subscribed;

-- 3. The registration itself.
DELETE FROM dbo.WFM_INT_SYSTEM
WHERE Id_Systemu = @id;

COMMIT TRANSACTION;

​

Login SQL Server

• SELECT na ARTYKUL, MAGAZYN, CENA i CENA_ARTYKULU albo członkostwa w roli db_datareader (CENA_ARTYKULU zawiera wiersze cen; konektor czyta ją, by odczytywać ceny i by sprawdzić wysyłaną cenę),
• EXECUTE na dbo.Api_ProductPriceModify. Test połączenia agenta to sprawdza (Procedura cen Wapro zainstalowana) i bez tego nie przechodzi.

• EXECUTE na procedurach zamówień, klientów, miejsc dostawy i anulowania oraz na trzech funkcjach, których używają;
• INSERT na MIEJSCE_DOSTAWY;
• UPDATE na ZAMOWIENIE_INTERNETOWE_ID i na wolnych polach POLE1 do POLE10 klientów, zamówień i pozycji zamówień, bo Wapro zapisuje te pola dynamicznym SQL, który działa z uprawnieniami wywołującego;
• SELECT na tabelach zamówień, klientów, dostaw, krajów, VAT, walut i form płatności;
• opcjonalnie EXECUTE na Api_CurrencyImport do pobierania kursów walut.

​

Znane ograniczenia

• Omnilinker bierze z Wapro powyższe listy i szczegóły produktów z tabeli. Stany trafiają do magazynu Omnilinkera tylko wtedy, gdy zarządza nim Wapro; w pozostałych są odczytywane do porównania. Ceny sprzedaży są odczytywane, by porównać je z Twoimi, i trafiają do katalogu tylko na poziomie cen, który pozwolisz ustalać Wapro; kategorie i zestawy nie są importowane.
• Ceny są porównywane, a importowane tylko na poziomie cen, który pozwolisz ustalać Wapro. Odczytywana jest tylko cena głównego wiersza produktu i jego jednostki podstawowej; cena tego samego artykułu w innym magazynie, w innej jednostce albo na progu ilościowym nie jest.
• Produkty są odczytywane jako pełna lista, mniej więcej raz dziennie albo po kliknięciu Odśwież listy, więc zmiana w Wapro widoczna jest w Omnilinkerze po następnej liście. Stany są szybsze: zwykle w ciągu kilku minut od zmiany.
• Produkt, którego indeks różni się od innego tylko wielkością liter, jest w Omnilinkerze osobnym produktem. Ich zdjęcia są wspólne: oba produkty dostają te same zdjęcia.
• Zdjęcia produktów trzymane w folderze zdjęć Wapro (tryb dyskowy) nie są odczytywane, a znaczniki sklepu i aukcji przy zdjęciach niczego nie filtrują. Zdjęcia WMF i EMF, które Wapro przyjmuje, nie są brane.
• Klucz produktu zmienia się, gdy wiersz artykułu, który go przechowuje, zostanie całkowicie usunięty albo jego indeks zostanie wyczyszczony, a nowy indeks tylko w części wierszy produktu może przenieść jego powiązanie na te wiersze. Nadanie wierszom indeksu, który ma już inny produkt, łączy te wiersze z tym produktem i może zostawić powiązanie bez produktu (zobacz wyżej).
• Omnilinker odczytuje z powrotem status zamówienia, jego faktury sprzedaży i ich numery KSeF i tylko je pokazuje. Zmiana pozycji zamówienia w Omnilinkerze jest wysyłana do Wapro po Twoim potwierdzeniu, ale zmiana pozycji w Wapro nie wraca do Omnilinkera (kolejna zmiana z Omnilinkera jest wtedy odrzucana, dopóki nie sprawdzisz zamówienia), podobnie jak zamówienie utworzone w Wapro.
• Zmiana zamówienia nie przenosi kosztu dostawy, danych kupującego, adresów, notatek, płatności ani statusu, a pozycji będącej zestawem (Zestaw) nie można zmienić. Zobacz Zmiana zamówienia, które jest w ERP.
• Zamówienie nie jest wysyłane z pozycją własną lub rabatową, z pozycjami z więcej niż jednego magazynu, z więcej niż 150 pozycjami ani jako sprzedaż wewnątrzwspólnotowa firmie lub eksport. Sprzedaż transgraniczna konsumentowi (OSS) jest wysyłana tylko dla towarów w stawce 23%. Zobacz Zamówienia do ERP.

​

Powiązane strony