Błąd 2: kodowanie i separator w pliku CSV
Hurtownie najczęściej eksportują CSV w kodowaniu UTF-8 i z przecinkiem jako separatorem. Import do Magazynu produktów w EasyUploaderze wymaga - według pomocy producenta - pliku CSV z kodowaniem Windows-1250 i średnikiem jako separatorem. Skutki niezgodności są dwa: polskie znaki w nazwach zamieniają się w krzaki albo cały wiersz trafia do jednej kolumny i import nie rozpoznaje pól.
zapisz plik w arkuszu jako CSV ze średnikiem i sprawdź kodowanie w oknie zapisu (w LibreOffice Calc wybierzesz je wprost),
jeśli opisy lub nazwy zawierają średniki, upewnij się, że pola tekstowe są ujęte w cudzysłów,
przy generatorze ofert możesz ominąć problem, zapisując plik jako XLS lub XLSX, w których kodowanie nie ma znaczenia,
po imporcie otwórz kilka produktów z polskimi znakami w nazwie i sprawdź, czy wyglądają poprawnie.
Excel i kolumna ID na pierwszej pozycji
Producent zwraca uwagę na pułapkę Excela: program błędnie zapisuje plik CSV, jeśli pierwsza kolumna nazywa się „ID”. Rozwiązanie jest proste - przenieś kolumnę ID na drugą pozycję. Według pomocy nie wpływa to na działanie importu. Problem dotyczy zarówno aktualizacji produktów w magazynie, jak i edycji ofert przez plik CSV.
Błąd 3: niestabilne kody produktów i duplikaty w magazynie
Skoro import dopasowuje produkty po kodzie, a nowy kod tworzy nowy produkt, każda zmiana kodu u hurtowni kończy się duplikatem. Stary produkt zostaje w magazynie z ostatnim znanym stanem i nadal jest powiązany z ofertą na Allegro. Nowy produkt dostaje aktualny stan, ale nie ma oferty. Efekt: oferta sprzedaje towar, którego hurtownia już nie ma w tej pozycji.
Ten sam problem pojawia się przy dwóch hurtowniach z nakładającymi się kodami albo gdy dostawca dopisuje do kodu spacje lub zmienia wielkość liter. Kilka zasad, które ograniczają ryzyko:
używaj jako kodu stałego identyfikatora dostawcy, a nie nazwy czy EAN, który bywa pusty,
przy kilku hurtowniach dodawaj prefiks dostawcy, np. H1- i H2-, w kolumnie Kod,
przed importem usuń spacje na początku i końcu kodów,
po każdym imporcie sprawdź, ile produktów zostało utworzonych - przy aktualizacji tej samej listy liczba nowych powinna być bliska zeru.
[#uwaga] W kolumnie Katalog nie wpisuj 0 i nie podawaj identyfikatora katalogu, którego nie ma w magazynie. Według pomocy producenta wartość 0 oznacza brak katalogu i powoduje błąd importu.
Błąd 4: stan sumowany zamiast zastąpiony
Kolumna Stan ma w imporcie dwa tryby. Według pomocy producenta znak plus przed liczbą sumuje stan z pliku ze stanem zapisanym w programie, a minus go zmniejsza. Liczba bez znaku zastępuje dotychczasowy stan. Jeśli plik hurtowni z aktualną dostępnością zawiera wartości ze znakiem plus - np. po formule w arkuszu - każdy import podnosi stany, aż w ofertach pojawiają się setki sztuk towaru, którego nie ma.
Zasada jest prosta: plus i minus stosuj tylko przy przyjęciu lub wydaniu konkretnej dostawy do własnego magazynu. Przy pliku z dostępnością hurtowni zawsze podawaj stan bez znaku. Jeśli w jednym obiegu masz oba przypadki, prowadź dwa osobne szablony arkusza, żeby ich nie pomylić.
Błąd 5: produkty, które zniknęły z pliku hurtowni
Import aktualizuje produkty, które są w pliku. Pomoc producenta nie opisuje, żeby brak produktu w pliku zerował jego stan, więc przyjmij, że produkt usunięty przez hurtownię zostaje w magazynie z ostatnim stanem. To typowa przyczyna sprzedaży towaru wycofanego przez dostawcę. Poprawka: przed importem porównaj listę kodów z poprzedniego i bieżącego pliku, a produkty, których brakuje, dopisz do pliku ze stanem 0.
Błąd 6: zmiana w magazynie, która nie dociera do ofert
Zdarza się, że import przebiegł poprawnie, stany w magazynie są aktualne, a oferty na Allegro pokazują stare ilości. Najczęstsze przyczyny są dwie. Pierwsza to brak powiązania oferty z produktem - wtedy magazyn nie ma czego aktualizować. Druga to wyłączony automat synchronizacji stanów. Według pomocy producenta synchronizacja działa w tle podczas pobierania transakcji, więc bez niej zmiana zostaje tylko w magazynie.
Sprawdź w Magazynie produktów, czy produkty z pliku mają powiązane oferty, i czy kody w ofertach odpowiadają kodom z hurtowni. Jeśli oferty powstały wcześniej, z innymi kodami, program nie połączy ich automatycznie. Według pomocy producenta, gdy automat jest wyłączony, a stan produktu spadnie do zera, program zapyta, czy zakończyć trwające oferty - to sygnał, że synchronizacja nie pracuje w tle.
Ręczne poprawki w ofertach po imporcie
Częsty odruch po błędnym imporcie to poprawienie ilości bezpośrednio w ofercie. Przy włączonej synchronizacji to nie działa - według pomocy producenta ilość wpisana przy ofercie zostanie nadpisana stanem z magazynu. Poprawkę zawsze wprowadzaj w magazynie albo kolejnym importem pliku. Tak samo z cenami: jeśli ceny ofert aktualizujesz plikiem CSV, nie zmieniaj ich równolegle w panelu Allegro, bo przy następnej aktualizacji z programu zmiana zniknie.
Gdy błędny import już się wydarzył, nie próbuj go odkręcać ręcznie produkt po produkcie. Popraw plik w szablonie i zaimportuj go ponownie - przy stanie podanym bez znaku nowa wartość zastąpi błędną. Jeśli import utworzył duplikaty, najpierw ustal, które produkty są powiązane z ofertami, a dopiero potem porządkuj pozostałe. Przed większymi poprawkami upewnij się, że masz aktualną kopię zapasową bazy, którą program wykonuje automatycznie - lokalna baza to Twoja odpowiedzialność.
Liczby w pliku hurtowni
Hurtownie zapisują liczby na różne sposoby: z kropką albo przecinkiem dziesiętnym, ze spacją jako separatorem tysięcy, z jednostką w tej samej komórce, np. „12 szt.”. Arkusz może takie wartości potraktować jak tekst, a import - wczytać je błędnie. Przed zapisem pliku sprawdź, czy kolumny Stan i Cena zakupu zawierają wyłącznie liczby, a przykładowe wartości porównaj z tym, co widać w magazynie po imporcie. Zwróć też uwagę, czy hurtownia podaje ceny netto, czy brutto - pomyłka w tym miejscu przenosi się na wyliczenie ceny sprzedaży.
Jak bezpiecznie importować pliki z hurtowni do EasyUploadera?
Większość opisanych błędów eliminuje stała procedura importu. Proponujemy pięć kroków, które warto zapisać jako instrukcję dla osoby obsługującej integrację:
[#chart:int85b]
Ostatni krok, czyli kontrola po imporcie, najlepiej działa z prostym wskaźnikiem. Policz, ile wierszy pliku wymagało ręcznej poprawki albo dało nieoczekiwany wynik, i odnieś to do liczby wszystkich wierszy. Jeśli wskaźnik rośnie z tygodnia na tydzień, szablon pliku albo dane dostawcy wymagają poprawy:
[#chart:int85c]
Kiedy błędy z importem są sygnałem do zmiany integratora?
Jeśli większość czasu przy obsłudze sprzedaży zajmuje Ci poprawianie plików od kilku hurtowni, problemem może nie być plik, tylko model integracji. Integrator z gotowymi połączeniami z hurtowniami, taki jak Base, pobiera dane dostawców automatycznie. Różnice między programami omawiamy w porównaniu Sello czy EasyUploader dla małego sprzedawcy Allegro, a błędy na etapie samych ofert w tekście o tym, jakie są najczęstsze błędy przy wystawianiu ofert z EasyUploadera.
| Błąd | Objaw | Poprawka |
|---|
| Feed XML w imporcie ofert | Import nie działa lub tworzy niepełne dane | Przenieś XML do arkusza CSV lub XLSX |
| Kodowanie UTF-8 zamiast Windows-1250 | Krzaki w nazwach | Zapisz CSV w Windows-1250 lub użyj XLSX w generatorze |
| Przecinek zamiast średnika | Cały wiersz w jednej kolumnie | Zapisz CSV ze średnikiem |
| Zmieniony kod produktu | Duplikaty, stare produkty z nieaktualnym stanem | Stały kod i prefiks dostawcy |
| Plus w kolumnie Stan | Stany rosną z każdym importem | Stan bez znaku przy dostępności hurtowni |
| Produkt usunięty z pliku | Sprzedaż wycofanego towaru | Dopisz brakujące kody ze stanem 0 |
Jak Vinson pomaga z importem z hurtowni?
Vinson to agencja e-commerce z Bochni działająca od 2021 r., certyfikowany partner Base, Allegro Ads Partner+, Google Partner, Meta Business Partner, partner Empik Place i autoryzowany partner Shoper. Obsłużyliśmy ponad 500 firm i mamy ocenę 4,9/5 ze 171 opinii. Nie jesteśmy partnerem producenta EasyUploadera. Pomagamy sprzedawcom dobrać integrator i poukładać obieg danych między hurtownią, magazynem, Allegro i sklepem:
przeglądamy pliki od hurtowni i przygotowujemy szablon arkusza z mapowaniem kolumn,
ustalamy zasady kodów produktów przy kilku dostawcach,
rozpisujemy procedurę importu i kontroli po imporcie,
gdy hurtowni jest wiele, wdrażamy Base z automatycznymi integracjami i przenosimy oferty.
Jeśli import z hurtowni sprawia Ci problemy, umów bezpłatną konsultację z Vinson. Gdy rozważasz automatyczne połączenia z dostawcami, zobacz, jak wygląda wdrożenie Base z Vinson.
Najczęściej zadawane pytania
Czy EasyUploader importuje plik XML z hurtowni?
Według pomocy producenta funkcja „Import aukcji z pliku XML” służy do wczytywania ofert wyeksportowanych z EasyUploadera. Feed XML hurtowni trzeba najpierw przenieść do arkusza z kolumnami magazynu lub generatora i zapisać jako CSV lub XLSX.
Jakie kodowanie musi mieć plik CSV do EasyUploadera?
Producent wymaga kodowania Windows-1250 i średnika jako separatora. Przy pliku zapisanym w UTF-8 polskie znaki mogą się zepsuć. W generatorze ofert możesz zamiast CSV użyć pliku XLS lub XLSX, w którym kodowanie nie ma znaczenia.
Dlaczego po imporcie z hurtowni mam zdublowane produkty?
Import dopasowuje produkty po kolumnie ID lub Kod, a gdy nie znajdzie kodu, tworzy nowy produkt. Duplikaty powstają więc, gdy hurtownia zmieni kod albo dopisze do niego spacje. Używaj stałego identyfikatora dostawcy i sprawdzaj liczbę nowych produktów po każdym imporcie.
Dlaczego stany w EasyUploaderze rosną po każdym imporcie?
Najpewniej w kolumnie Stan są wartości ze znakiem plus. Według pomocy producenta plus sumuje stan z pliku ze stanem w programie. Przy pliku z dostępnością hurtowni podawaj stan bez znaku, żeby zastępował poprzednią wartość.
Co zrobić z produktami, które hurtownia wycofała?
Import aktualizuje tylko produkty obecne w pliku, więc wycofany towar może zostać w magazynie z ostatnim stanem. Porównaj listy kodów z poprzedniego i bieżącego pliku, a brakujące produkty dopisz ze stanem 0, żeby oferty przestały je sprzedawać.
Chcesz, żeby import z hurtowni przestał psuć stany na Allegro? Pokaż nam swój plik i proces podczas bezpłatnej konsultacji z Vinson - wskażemy, co poprawić albo czy czas na inny integrator.
