¶ Import towarów (xml) - transfer w Hummerce

Import towarów (xml) to transfer w panelu Hummerce, którym obsługa sklepu wymienia dane katalogu - towary, kategorie, ceny, dostępność i parametry - plikiem XML, jako alternatywa dla transferu towarów w formacie Excela. Format XML sprawdza się przy integracjach plikowych i przy danych, których nie da się wygodnie opisać w arkuszu (np. wiele wartości jednego parametru albo wartości różne dla poszczególnych widoków sklepu).

Stan na: aktualizacja 2026-09-29. Transfer jest częścią podstawowego mechanizmu transferów platformy - dostępny we wszystkich obecnych wersjach sklepu.

¶ Korzyści i zastosowania

Import i eksport towarów, ich kategorii, cen, dostępności i parametrów jednym plikiem XML - bez ręcznej edycji każdego towaru w panelu.
Format nadaje się do integracji plikowych z zewnętrznymi systemami (np. ERP, hurtownią danych), które generują dane w XML zamiast Excela.
Jeden zapis pliku obsługuje wiele wartości tego samego parametru (np. lista cech towaru) i wartości różne dla poszczególnych widoków sklepu - czego arkusz Excela nie opisuje wygodnie.
Nowy towar powstaje automatycznie, jeśli symbol z pliku nie istnieje jeszcze w sklepie - transfer nie wymaga wcześniejszego założenia towaru w panelu.
Dopasowanie kategorii, producenta i grupy towarowej może iść po własnym parametrze _transfer zamiast po symbolu - przydatne, gdy zewnętrzny system ma inne symbole niż Hummerce.

¶ Zasady działania

¶ Co można przenieść plikiem

Symbol towaru - pole obowiązkowe; po nim sklep rozpoznaje towar. Symbol spoza sklepu tworzy nowy towar.
Nazwa - osobna wartość dla każdego języka sklepu.
Kategoria główna - symbol kategorii; kategoria, która jeszcze nie istnieje, zostaje utworzona w kategorii głównej. Import nie usuwa istniejącej widoczności towaru w innych kategoriach.
Artykuł - symbol towaru nadrzędnego, gdy przenoszony towar jest podtowarem (wariantem).
Cena, waluta, stawka VAT - zgodnie z walutami i stawkami VAT zdefiniowanymi w sklepie; cena zapisuje się jako netto albo brutto, zależnie od bieżącego ustawienia sklepu lub towaru.
Producent i Grupa towarowa - dopasowanie po symbolu albo, jeśli producent/grupa mają ustawiony parametr _transfer, po tym parametrze (ma pierwszeństwo przed symbolem).
Dostępny, Widoczny, Kupowalny - wartości logiczne (tak/nie).
Dowolne inne parametry towaru - jako osobne wpisy w pliku, z możliwością wskazania języka i widoku, którego dotyczy wartość.

¶ Budowa pliku XML

Plik to lista obiektów - towarów - każdy w osobnym znaczniku z symbolem i datami utworzenia/modyfikacji. W środku obiektu:

atrybuty - pojedyncze pola towaru (np. widoczność, kategoria, cena, producent),
parametry (property) - wartości parametrów towaru, z możliwym językiem (locale) i widokiem (view); parametr z wieloma wartościami (np. lista cech) zapisuje się jako kolejne znaczniki wartości,
widoki - lista widoków, do których towar ma zostać przypisany, z trybem dodawania, zastąpienia albo usunięcia przypisania.

Skrócony przykład:

<extension>
  <object target="item" symbol="larch-cone" modified="2019-04-05 00:03:02" created="2014-12-28 23:54:52">
    <attribute name="visible" value="true" />
    <attribute name="category" value="cones" />
    <attribute name="producer" value="zielony-las" />
    <attribute name="price" value="39.00 PLN @ (23.00)" />
    <property symbol="_name" locale="pl">Szyszka modrzewiowa</property>
    <property symbol="_name" locale="en">Larch cone</property>
    <views updateMode="ADD">
      <view>default</view>
    </views>
  </object>
</extension>

Ten sam format (znacznik extension z obiektami object) obsługuje też transfery Typy parametrów (xml), Import drzewa lokacji (xml) i Strony statyczne (xml) - różni je tylko rodzaj obiektu (target) i lista dostępnych pól. Zasady wspólne dla wszystkich transferów (tryb testowy, praca w tle, ignorowanie błędów) opisuje Transfer danych - przegląd.

¶ Wersja

Transfer towarów w formacie XML jest częścią podstawowego mechanizmu transferów platformy - dostępny we wszystkich obecnych wersjach sklepu.

¶ Zależności

Plik XML w formacie zgodnym z tym transferem - przygotowuje go zewnętrzny system (np. ERP, hurtownia danych) albo eksport z samego sklepu jako wzorzec.
Waluty i stawki VAT użyte w pliku muszą być wcześniej skonfigurowane w sklepie.
Ogólne zasady transferów danych - Transfer danych - przegląd.

¶ Wdrożenie

Podstawowy format działa od razu, bez wdrożenia - transfer jest częścią standardu platformy.
Dopasowanie do niestandardowego pliku (inny układ pól niż standard platformy, plik z zewnętrznego systemu klienta) wymaga wdrożenia - zakres i czas wyceniamy indywidualnie po analizie przykładowego pliku.

¶ Ograniczenia

Plik XML przygotowuje się poza panelem - transfer nie ma kreatora ani podglądu budowy pliku, tylko import i eksport gotowego dokumentu.
Import ustawia kategorię główną towaru, ale nie usuwa jego widoczności w pozostałych kategoriach, do których był wcześniej przypisany poza plikiem.
Nie weryfikujemy zadania pod kątem zgodności z prawem (np. licencje przekazanych materiałów, RODO, regulamin sklepu).

¶ Potencjał rozwoju

Kreator lub podgląd zawartości pliku XML w panelu, bez konieczności przygotowywania go poza sklepem.
Czytelniejsze komunikaty o miejscu błędu w pliku przy imporcie.

¶ Najczęstsze pytania

Czym różni się transfer XML od transferu Excela dla towarów?
Oba przenoszą towary, ceny i parametry. XML lepiej radzi sobie z parametrami o wielu wartościach i wartościami różnymi dla poszczególnych widoków sklepu; Excel jest wygodniejszy do ręcznej edycji. Zobacz Import i eksport towarów (xls).

Czy plik XML może utworzyć nowy towar?
Tak, jeśli symbol z pliku nie istnieje jeszcze w sklepie.

Czy import kasuje widoczność towaru w innych kategoriach?
Nie. Import ustawia kategorię główną, ale nie usuwa istniejącej widoczności towaru w pozostałych kategoriach.

Czy transfer można przetestować przed zapisem zmian?
Tak, jak każdy transfer w Hummerce - tryb testowy sprawdza plik i wycofuje zmiany, bez zapisu w sklepie. Zobacz Transfer danych - przegląd.

Czy dopasowanie kategorii lub producenta można oprzeć na innym polu niż symbol?
Tak, przez parametr _transfer ustawiony na kategorii, producencie lub grupie towarowej - wtedy ma on pierwszeństwo przed symbolem.

¶ Powiązane

Transfer danych - przegląd - lista transferów i zasady wspólne (tryb testowy, praca w tle, raporty).
Import i eksport towarów (xls) - ten sam zakres danych w formacie Excela.
Asystent AI - serwer MCP - import i eksport tego samego formatu XML dostępne też jako narzędzia asystenta AI.

Chcecie zautomatyzować aktualizację katalogu plikiem XML z Waszego systemu? Umówcie bezpłatną prezentację.

¶ Szczegóły konfiguracji

¶ Dostęp w panelu

Uruchomienie transferu: menu Transfer danych -> Towary (xml) - wybór kierunku (import/eksport), pliku, trybu testowego i pozostałych opcji wspólnych dla transferów (Transfer danych - przegląd).

¶ REST API i MCP

MCP (Asystent AI - serwer MCP):
- ec2_extension_xml_write - generuje plik XML w tym formacie dla wskazanych towarów (i innych obiektów katalogu),
- ec2_extension_xml_import - importuje taki plik XML do sklepu,
- ec2_transfer_xml_spec - zwraca asystentowi AI pełną gramatykę formatu XML (i formatu parametrów), potrzebną do samodzielnego zbudowania poprawnego pliku.

¶ Parametry

Pole w transferze	Element/atrybut w XML
Symbol	atrybut `symbol`
Nazwa (per język)	`property symbol="_name"` z atrybutem `locale`
Kategoria główna	atrybut `category`
Artykuł (towar nadrzędny)	atrybut `article`
Cena	atrybut `price`
Producent	atrybut `producer`
Grupa towarowa	atrybut `itemGroup`
Dostępny	atrybut `available`
Widoczny	atrybut `visible`
Kupowalny	atrybut `buyable`
Dopasowanie po innym polu niż symbol	parametr `_transfer` (na kategorii, producencie lub grupie towarowej)