Import katalogu z Shopify i Base do NavyFlame: kompletność i błędy

Co robi import katalogu, a czego nie

Import katalogu pobiera produkty z konta Shopify albo Base do Magazynu NavyFlame. Nowe produkty tworzy, a te, które już masz, rozpoznaje po SKU albo poprawnym kodzie EAN i tylko z nimi wiąże. Działa po stronie serwera, więc możesz zamknąć przeglądarkę w trakcie.

Import niczego nie zapisuje w systemie źródłowym. Nie zmienia produktów, cen ani treści w Base i nie włącza synchronizacji stanów. To osobna decyzja, opisana w instrukcji o przejęciu stanów ofert zaimportowanych z kanału i w części o włączaniu stanów ofert z importu w planie migracji z BaseLinkera.

Ta instrukcja dotyczy przeniesienia katalogu z innego systemu. Import z pliku CSV lub XLSX opisuje artykuł o imporcie produktów z plików, a przenoszenie starszych zamówień import historii zamówień. Nazwy pól i komunikatów podajemy według panelu z 11 listopada 2026 r.

Zanim zaczniesz

• Konto źródłowe podłączone i aktywne w Integracjach. Dla Base potrzebujesz tokenu API, który według podpowiedzi w panelu znajdziesz w BaseLinker → Moje konto → API.
• Uprawnienie do zapisu w Magazynie w roli Twojego użytkownika.
• Decyzja, który katalog, grupa cenowa i magazyn Base są źródłem prawdy. Przy kilku katalogach to najważniejsza decyzja całego importu.
• Jeśli konto Base ma służyć tylko do katalogu i stanów, odznacz w jego ustawieniach pole Pobieraj zamówienia z tego konta. NavyFlame nie będzie wtedy pobierać z niego zamówień.

Krok 1. Ustaw katalog, grupę cenową i magazyn w koncie Base

Otwórz Integracje i edytuj zapisane konto BaseLinker. Listy w polach Katalog produktów, Grupa cenowa i Magazyn stanów NavyFlame pobiera na bieżąco z Twojego konta Base.

Grupa i magazyn muszą należeć do wybranego katalogu. Produkt, który nie ma ceny w wybranej grupie, nie zostanie zaimportowany i pojawi się na liście błędów. Import zachowuje walutę z Base i niczego nie przelicza.

Pod tymi polami jest sekcja Import katalogu Base. Wszystkie jej opcje są domyślnie wyłączone, a ustawisz je dopiero po zapisaniu połączenia:

• Importuj średni koszt zakupu nowych produktów i wariantów. Wymaga podania głównej waluty konta Base, na przykład PLN. Dotyczy tylko produktów tworzonych przez import. Samo powiązanie z istniejącym produktem nie zmienia jego kosztu.
• Twórz zestawy z pełnym, jednoznacznym składem. Każdy składnik musi być wcześniej powiązany na tym samym koncie. Zestaw z brakującym składnikiem, wariantem w składzie albo zestawem zagnieżdżonym trafia do decyzji.
• Grupy cenowe Base → Cenniki NavyFlame. Przypisujesz dodatkowe grupy cenowe do istniejących Cenników w tej samej walucie. Panel przypomina, że ceny są brutto. Import uzupełnia brakujące wpisy i zachowuje istniejące ceny.

Zmiana katalogu, grupy, magazynu albo tych opcji wymaga nowego importu. Rozpoczęty import nie przejmie nowych ustawień w połowie.

Krok 1b. Shopify: bez wyboru katalogu

Sklep Shopify ma jeden katalog, więc niczego nie wybierasz. NavyFlame czyta produkty stronami w kolejności, którą wyznacza Shopify, i przed zapisem każdego produktu pobiera wszystkie jego warianty i zdjęcia. Koniec katalogu ustala na podstawie informacji Shopify o kolejnej stronie, a nie liczby pobranych produktów.

Pole kodu kreskowego w Shopify nie zawsze zawiera prawdziwy EAN. NavyFlame traktuje je jako EAN tylko wtedy, gdy jest poprawnym kodem GTIN albo ISBN z prawidłową cyfrą kontrolną. Inny tekst zachowuje jako informację o źródle, ale nie wpisuje go do pola, którego używa skaner.

Krok 2. Uruchom import

Otwórz Oferty / Marketplace'y i wybierz u góry konkretne konto. Przycisk importu pojawia się tylko przy jednym koncie, bo katalog należy do jednego sklepu. Kliknij Importuj cały katalog.

W trakcie zobaczysz liczniki, na przykład „Pobrano 400 pozycji. Dodano 312, odświeżono 0, bez zmian 0”. Panel nie pokazuje paska postępu, bo źródło nie podaje z góry, ile ma produktów, a wymyślony procent byłby gorszy od uczciwego licznika.

Krok 3. Odczytaj wynik

Po zakończeniu panel pokazuje jeden z czterech komunikatów:

Komunikat o niekompletnym imporcie ma trzy warianty. Gdy części zakresów nie udało się pobrać mimo ponowień, uruchom import jeszcze raz przyciskiem Odśwież produkty ze sklepu: znane produkty zostaną sprawdzone, a brakujące dodane. Gdy import zatrzymał się z powodu konfiguracji, uprawnień albo błędnej odpowiedzi, popraw konto i jego uprawnienia. Gdy odczyt kolejnych stron przestał postępować, import obejmuje tylko pobrany zakres i wtedy trzeba zgłosić problem do wsparcia. Lista zakresów, których nie pobrano, rozwija się pod komunikatem.

Liczniki wyniku sumują się do liczby przejrzanych pozycji: dodano, odświeżono, bez zmian, pominięto, nie udało się, powiązano, do decyzji, konflikty i wyłączono z importu. Jeśli suma się nie zgadza, zgłoś to do wsparcia razem z datą importu.

Jeden wadliwy produkt nie zatrzymuje importu

Produkt z Base bez nazwy albo bez ceny w wybranej grupie trafia do pozycji, których nie udało się dodać, a import czyta kolejne produkty. NavyFlame nie wymyśla nazwy, nie zastępuje brakującej ceny zerem ani ceną produktu nadrzędnego i nie nadpisuje istniejącego produktu w Magazynie danymi z wadliwego rekordu. Tak samo traktuje ujemną cenę w grupie, stawkę VAT spoza dopuszczalnego zakresu oraz ujemny koszt zakupu, gdy włączysz jego import.

Szczegóły zobaczysz pod przyciskiem Pokaż pozycje, których nie udało się dodać: nazwę albo identyfikator produktu i przyczynę. Lista ofert pokazuje też komunikat „Część produktów ma nieprawidłowe dane” z identyfikatorami. Popraw dane w Base i uruchom import ponownie.

Pozycje do decyzji i konflikty

Import łączy produkt z istniejącym tylko po jednoznacznym SKU albo poprawnym EAN. Nigdy po samej nazwie. Gdy podobna jest tylko nazwa, import tworzy osobny produkt. Powiązany produkt zachowuje Twoją cenę, treść i koszt.

Do decyzji trafiają między innymi konflikty SKU lub EAN, produkty, których miejsce zajmuje już inne powiązanie, oraz zestawy bez powiązanych składników. Rozpatrujesz je na tej samej stronie, w karcie Bezpieczne parowanie istniejących ofert, po kliknięciu Otwórz parowanie. W Kolejce ręcznej weryfikacji przy każdej ofercie możesz powiązać ją z istniejącym produktem, wybrać Utwórz nowy produkt albo Pomiń świadomie. Pominięte oferty możesz później zaimportować jako nowe produkty.

Historia importów

W Magazynie kliknij Importuj produkty. Na stronie Import produktów z pliku, w sekcji Historia importów, widać dziesięć ostatnich importów, także tych z kont sprzedaży. Przy imporcie z konta widać identyfikator konektora, na przykład baselinker albo shopify, status OK, Częściowo albo Błąd oraz liczniki: nowe, aktualizacje, bez zmian, powiązane, do decyzji, konflikty, pominięte, wyłączone i liczbę przejrzanych pozycji. Niekompletny odczyt ma dopisek „Odczyt katalogu niekompletny.”, a błędy danych rozwijają się jako Pozycje wymagające poprawy danych u dostawcy, z identyfikatorem i przyczyną.

Lista kontrolna kompletności

1. Komunikat końcowy nie mówi o niekompletnym imporcie ani o braku pozycji.
2. Suma liczników równa się liczbie przejrzanych pozycji.
3. Liczba przejrzanych pozycji zgadza się z liczbą produktów w źródle, w wybranym katalogu. Przy dużej różnicy sprawdź najpierw, czy obie liczby dotyczą produktów, a nie wariantów.
4. Lista pozycji, których nie udało się dodać, jest pusta albo każdą pozycję poprawiłeś w źródle i zaimportowałeś ponownie.
5. Kolejka ręcznej weryfikacji jest pusta albo każdą pozycję rozpatrzyłeś.
6. Na pięciu losowych produktach zgadzają się cena, waluta, warianty, zdjęcia i EAN.
7. Ponowny import przyciskiem Odśwież produkty ze sklepu nie dodaje nowych pozycji, jeśli w źródle nic się nie zmieniło.

Dopiero po tej kontroli planuj przełączenie stanów i zamówień. Kolejność kroków przy zmianie systemu opisuje artykuł o migracji integratora bez utraty sprzedaży, a pomoc w przeprowadzce zamówisz na stronie migracji.

Ponowny import i to, czego import nie robi

Ponowny import rozpoznaje produkt po koncie i identyfikatorze w źródle, więc nie tworzy kopii. Produkt utworzony importem z tego konta odświeża nazwę, cenę i zdjęcia, o ile nie zmieniałeś ich w NavyFlame. Powtórny import nie daje żadnemu kontu prawa do zmiany ilości w Magazynie. Stanami zarządza osobno ustawione źródło stanów.

Import nie:

• zapisuje do Base produktów, cen ani treści;
• włącza synchronizacji stanów ani automatyzacji;
• tworzy Cenników ani nie przelicza walut;
• łączy produktów po samej nazwie;
• tworzy zestawu z niepełnym składem.

Zakres funkcji w planach porównasz na stronie planów subskrypcyjnych.