Aktualizacja pola dodatkowego towaru z pliku CSV

Dostawca udostępnia plik ze swoimi stanami? AB Connect potrafi go regularnie pobierać i wpisywać liczby do wybranego pola dodatkowego towaru w Subiekcie GT — bez Twojego udziału.

1. Do czego to służy

   Program cyklicznie pobiera plik CSV spod podanego adresu i dla każdego wiersza szuka w Subiekcie kartoteki o takim symbolu. Gdy ją znajdzie, wpisuje wartość z pliku do wskazanego pola dodatkowego towaru.

   Najczęstsze zastosowanie: dostawca publikuje swoje stany, Ty wrzucasz je do pola dodatkowego, a stamtąd doliczasz je do stanu wysyłanego do OMS — patrz Doliczanie zapasu dostawcy z pola dodatkowego towaru.

   Czego ta funkcja nie robi: nie zakłada kartotek, nie zmienia stanu magazynowego w Subiekcie, nie zmienia cen. Wpisuje wyłącznie liczbę do jednego, wybranego pola. Funkcja działa w pełnej wersji programu.

2. Znajdź sekcję w konfiguratorze

   Sekcja nazywa się Aktualizacja pola dodatkowego z CSV i jest na samym dole konfiguratora — nie ma jej w menu po lewej. Najszybciej trafisz do niej, wpisując CSV w wyszukiwarkę ustawień na górze ekranu.

   Włącz przełącznik Włącz moduł aktualizacji pola dodatkowego. Reszta ustawień pojawi się dopiero po jego włączeniu.

   

   Główny przełącznik modułu aktualizacji pola dodatkowego z pliku CSV.

3. Przygotuj plik w odpowiednim formacie

   Plik musi być zwykłym plikiem tekstowym CSV z kolumnami rozdzielonymi przecinkiem, w kolejności:

   sku,ean,stan,cena_brutto

   Program używa tylko dwóch kolumn: pierwszej (symbol towaru) i trzeciej (wartość do wpisania). Pozostałe mogą być puste, ale muszą być na swoim miejscu.

   Przykład poprawnego pliku — pierwszy wiersz to nagłówek, kolejne to towary:

   • sku,ean,stan,cena_brutto
   • LIZAK-01,5901234567890,12,4.90
   • LIZAK-02,5901234567891,0,4.90

   Trzy rzeczy, które psują ten mechanizm najczęściej:

   • Brak wiersza nagłówka. Pierwsza linia pliku jest zawsze pomijana. Plik bez nagłówka straci pierwszy produkt.
   • Przecinek jako separator dziesiętny. Liczby zapisuj z kropką: 12.5, nie 12,5 — przecinek zostanie potraktowany jako podział kolumn i cały wiersz się rozjedzie.
   • Zbyt mało kolumn. Wiersze mające mniej niż trzy kolumny są pomijane bez komunikatu.

4. Wskaż pole dodatkowe do aktualizacji

   W wierszu Pole dodatkowe do aktualizacji kliknij Pobierz dane z subiekta i wybierz z listy pole, do którego mają trafiać wartości. Na liście są wyłącznie pola dodatkowe towaru.

   Bez wybranego pola moduł nie zadziała. Nie zobaczysz błędu w konfiguratorze — po prostu nic się nie stanie, a informacja o braku pola zostanie odnotowana w logach.

   Jeśli tę samą wartość chcesz doliczać do stanu wysyłanego do OMS, wybierz tutaj dokładnie to samo pole, które wskazałeś w Pole dodatkowe z dodatkowym stanem towaru.

   

   Wybór pola dodatkowego towaru, które będzie zapełniane danymi z pliku.

5. Podaj adres pliku

   W polu URL do pliku CSV wpisz pełny adres, pod którym plik jest dostępny, na przykład https://dostawca.pl/stany.csv.

   Plik musi być pobieralny bez logowania — adres wymagający hasła albo strona z przyciskiem do pobrania nie zadziała. Najprościej sprawdzić to, wklejając adres do przeglądarki w trybie prywatnym: jeśli plik zaczyna się pobierać albo wyświetla jako tekst, wszystko jest w porządku.

   

   Pole na adres pliku CSV udostępnianego przez dostawcę.

6. Ustaw częstotliwość

   W polu Interwał aktualizacji (minuty) wpisz, co ile minut plik ma być pobierany. Dopasuj to do tego, jak często dostawca aktualizuje swoje dane — pobieranie co 5 minut pliku odświeżanego raz dziennie nie ma sensu i tylko obciąża Subiekta.

   Wartość 0 wyłącza moduł — praca zostanie przerwana od razu po starcie.

   

   Pole częstotliwości pobierania pliku, w minutach.

7. Zapisz i sprawdź efekt

   Kliknij Zapisz zmiany i potwierdź Zapisz i uruchom ponownie.

   Żeby zobaczyć, co program robi, włącz w sekcji Stany magazynowe i ceny w OMS opcję Włącz logi z aktualizacji stanów — to ona odpowiada też za zapisy z tego modułu. W logach zobaczysz wpisy o zmianie wartości dla konkretnych symboli.

   Sprawdź potem w Subiekcie kartotekę jednego z towarów z pliku i zobacz, czy pole ma nową wartość. Jeśli nie: najczęstsze przyczyny to symbol z pliku, który nie odpowiada żadnej kartotece, oraz kartoteka zablokowana — takich program nie rusza. Wartość zapisywana jest tylko wtedy, gdy różni się od tej, która już jest w polu.

8. Sprawdź również

   • Doliczanie zapasu dostawcy z pola dodatkowego towaru — jak zamienić zawartość tego pola na stan widoczny w OMS.
   • Dlaczego stan w OMS różni się od stanu w Subiekcie — gdzie w całym wyliczeniu ląduje ta wartość.
   • Logi aplikacji — gdzie szukać i jak czytać — tam trafiają komunikaty o pobieraniu pliku.