Produkty z hurtowni w Shoperze: import XML przez Apilo i co sprawdzić po imporcie
Hurtownia daje plik XML, Apilo robi z niego produkty w Shoperze i pilnuje stanów i cen. Ale sam wyłącza towar, którego hurtownia nie ma, a ten sam towar z dwóch hurtowni może zamienić w dwa produkty. Po pierwszym imporcie sprawdź kody, kategorie i zdjęcia.
Opisujemy to na podstawie pomocy Shopera i Apilo (stan z 2 listopada 2026). Konta Apilo ani hurtowni nie podłączaliśmy. Na naszym sklepie testowym sprawdziliśmy tylko to, co robi sam Shoper: import pliku, kod EAN, kategorie i zestawy.
Jak plik z hurtowni trafia do Shopera
Panel Shopera importuje pliki CSV (Import produktów z pliku CSV do Shopera). Plik XML od hurtowni pomoc Shopera radzi podłączyć do Apilo („Dropshipping: Integracja Apilo z hurtowniami”). Apilo ma gotowe połączenia z wieloma hurtowniami. Hurtownię spoza listy podłączysz bez dopłaty, jeśli daje plik XML w formacie Ceneo albo IOF. Listę hurtowni Shoper pokazuje na stronie „Gotowe integracje z hurtowniami”. W App Store Shopera są też osobne aplikacje do hurtowni.
Droga przez Apilo ma trzy kroki („Pobieranie produktów z hurtowni do Apilo”, „Import produktów z Apilo do Shoper”):
- Z hurtowni do Apilo. W Apilo wchodzisz w Towary i usługi → Hurtownie, wybierasz hurtownię i podajesz adres jej pliku. Tam też ustawiasz: dopisek przed kodami produktów, kategorie, narzut na cenę, co zrobić, gdy hurtownia usunie produkt, i jak liczyć małe stany. Pobranie może potrwać od kilkudziesięciu minut do kilku godzin, zależnie od liczby produktów.
- Z Apilo do Shopera. W Apilo pobierasz plik CSV – Shoper (z EAN) z Towary i usługi → Eksport. W Shoperze wgrywasz go w Produkty → Wszystkie → Więcej → Importuj, profilem „Dodawanie i aktualizacja produktów (z Kodem kreskowym)”. Nowe produkty możesz też wysłać z Apilo formularzem Sprzedaż → Shoper → Wystaw, do 50 naraz.
- Stałe aktualizacje. Najpierw Apilo musi poznać produkty, które są już w sklepie: w Towary i usługi → Produkty kliknij Import produktów/ofert → Platformy i zaimportuj oferty sklepu. Potem w Towary i usługi → Relacje produktów zaznacz produkty i włącz automatyczną aktualizację stanu, ceny i wznawiania.
Ten sam towar z dwóch hurtowni
W ustawieniach hurtowni w Apilo ustawiasz dopisek przed kodami produktów. Pomoc Shopera wyjaśnia, że dzięki niemu nie dojdzie do pomyłki, gdy ten sam produkt jest w kilku hurtowniach. Skutek: jeśli każda hurtownia ma swój dopisek, ten sam towar z dwóch hurtowni trafi do sklepu jako dwa produkty z różnymi kodami.
Jeśli obie hurtownie podają kod EAN, oba produkty dostaną ten sam numer. Shoper tego nie zatrzyma. A dla Google jeden numer to jeden towar. Na koncie Apilo tego nie sprawdzaliśmy — tak wynika z opisu w pomocy Shopera.
Produkt połączony z niewłaściwym towarem
Apilo łączy produkt w sklepie z produktem z hurtowni. Najpierw szuka po kodzie produktu, potem po kodzie EAN, a na końcu po nazwie. Pomoc Apilo radzi porównać nazwy po obu stronach, bo przy pomyłce w kodach połączenie będzie błędne („Relacje produktów”). Źle połączony produkt dostaje stan i cenę innego towaru.
Uważaj też na kody wklejane z arkusza. Może się w nich schować znak, którego nie widać, na przykład twarda spacja. Dla Shopera to wtedy inny kod — u nas w teście powstał przez to drugi produkt, choć oba kody wyglądały tak samo (Import produktów z pliku CSV do Shopera). Jak z takim kodem radzi sobie Apilo, nie sprawdzaliśmy.
Kod EAN z pliku hurtowni
Kod EAN z pliku hurtowni trafia do Shopera w pliku „CSV – Shoper (z EAN)”. Shoper sprawdza go przy imporcie:
- kod w złym formacie — Shoper pomija cały produkt. W dzienniku importu stoi wtedy
Field 'ean' is not valid: Wymagany jest poprawny kod kreskowy, a produktu w sklepie nie ma; - brak kodu — Shoper przyjmuje produkt bez ostrzeżenia, więc sam braków nie pokaże.
Jak po imporcie wypisać produkty bez kodu i z tym samym kodem: Import z Allegro do Shopera a kody EAN, część „Po imporcie”. Skąd wziąć brakujące numery: Kod EAN w Shoperze.
Wyprzedane w hurtowni, wyłączone w sklepie
Gdy włączysz stałe aktualizacje, „produkt wyprzedany z hurtowni zostanie wyłączony w sklepie”. Kiedy towar wróci do hurtowni, Apilo włączy produkt z powrotem (pomoc Shopera, „Import produktów z Apilo do Shoper”). Wyłączonego produktu nie da się kupić, nawet jeśli dobrze się sprzedawał.
Dwie rzeczy, na które trzeba uważać:
- Zestawy. Gdy wyłączysz składnik, Shoper wyłącza cały zestaw. Gdy włączysz składnik z powrotem, zestaw zostaje wyłączony — trzeba go włączyć ręcznie. Sprawdziliśmy to na naszym sklepie testowym, ale nie z Apilo. Zestaw z towarów z hurtowni może więc stać wyłączony, choć wszystkie składniki dawno wróciły.
- Małe stany. W Apilo możesz ustawić, że mały stan z hurtowni liczy się jako zero. Przykład z pomocy Shopera: 0–5 sztuk w hurtowni to 0 w sklepie. Produkt z kilkoma sztukami w hurtowni ma wtedy w sklepie zero i zwykle nie da się go kupić. Jak działają stany dostępności: Stany magazynowe i dostępność w Shoperze.
Kategorie po imporcie
Produkty z pliku Apilo trafiają, zależnie od ustawień, do jednej wspólnej kategorii albo do kategorii takich jak u hurtowni. Pomoc Apilo pisze wprost, że „obecnie w Apilo nie ma mapowania kategorii hurtowni / Allegro, a tymi dodanymi do Shoper” („Jak wysłać produkty z hurtowni do sklepu Shoper?”). Kategorie hurtowni nie połączą się więc same z Twoimi.
Po imporcie przejrzyj listę kategorii. W Shoperze dwie kategorie mogą mieć tę samą nazwę. U nas w teście import pliku założył drugą kategorię o tej samej nazwie, zamiast użyć istniejącej. Produkty ze wspólnej kategorii przenieś do swoich. Apilo nie nadpisze kategorii, nazwy, opisu ani zdjęć, które zmienisz w Shoperze (pomoc Apilo, tamże).
Opisy i zdjęcia od hurtowni
Pomoc Shopera radzi obejrzeć zdjęcia i opisy hurtowni, zanim zaczniesz z nią współpracę („Dropshipping – co wziąć pod uwagę podczas nawiązywania współpracy z hurtownią?”). Po imporcie przejrzyj kilka produktów i sprawdź:
- czy kilka produktów nie ma tego samego opisu, na przykład ten sam model w kilku kolorach;
- czy opis nie jest pusty albo za krótki;
- czy zdjęcia nie są za ciężkie albo za małe — od 31 stycznia 2027 Google wymaga co najmniej 500 × 500 pikseli (Zdjęcia produktów w Shoperze);
- czy to samo zdjęcie nie stoi w wielu produktach.
To, co poprawisz w Shoperze, zostanie — Apilo tych pól nie nadpisuje.
Co z tego sprawdza Merchlint
Merchlint, aplikacja do audytu katalogu z Shoper App Store, sprawdza cały katalog po imporcie, niezależnie od tego, skąd przyszły produkty:
- kody — brak kodu EAN (dokumentacja), ten sam EAN w dwóch produktach (dokumentacja), kody różniące się tylko niewidocznym znakiem (dokumentacja), niewidoczne znaki w kodzie albo nazwie (dokumentacja);
- kategorie — produkt poza kategoriami (dokumentacja);
- opisy — ten sam opis w kilku produktach (dokumentacja), za krótki opis (dokumentacja);
- zdjęcia — za ciężki plik (dokumentacja), zdjęcie, którego nie da się pokazać (dokumentacja), jedno zdjęcie w wielu produktach (dokumentacja), zdjęcie za małe dla Google (dokumentacja);
- wyłączone i niedostępne — produkty, które w ostatnich 12 miesiącach zarabiały, a dziś są wyłączone (dokumentacja) albo nie da się ich kupić (dokumentacja), z kwotą.
Kontrola zdjęcia za małego dla Google w sklepie, w którym Merchlint był już zainstalowany, rusza po zatwierdzeniu aktualizacji aplikacji. W sklepie aplikacja niczego nie zmienia, tylko odczytuje dane.
Bez instalacji aplikacji możesz użyć darmowego skanu. Sprawdza on plik, który Twój sklep udostępnia Google, i pokazuje w nim kody EAN, ceny 0 zł, zdjęcia, nazwy i opisy. Kwot nie pokaże, bo sprzedaży z zewnątrz nie widać.