Plik XML hurtowni odzieży — jak importować i aktualizować katalog sklepu

Bluza damska BG SHAPE fango ze stójką i pełnym zamkiem, widok z przodu

Plik XML hurtowni odzieży jest źródłem danych katalogowych, które zgodne narzędzie może przenieść do Twojego sklepu internetowego. Sam plik nie tworzy harmonogramu aktualizacji, nie przekazuje zamówień i nie rezerwuje sztuk. Aby korzystać z niego bezpiecznie, uzyskaj dostęp, sprawdź pola, ustaw mapowanie i przetestuj import małej próbki przed uruchomieniem pełnego katalogu.

Bluza damska BG SHAPE fango ze stójką i pełnym zamkiem, widok z przodu — ilustracja poradnika plik XML hurtowni odzieży
Zdjęcie ilustracyjne kolekcji BG Brandenburg Couture.

XML, importer, harmonogram i integracja zamówień — cztery osobne elementy

ElementJego zadanieCzego sam nie zapewnia
Plik katalogowy XMLPrzekazuje zapisane w nim dane produktówUtworzenia kart w dowolnym sklepie ani automatycznej obsługi zakupu
ImporterOdczytuje plik i przypisuje dane do pól platformyPoprawnego mapowania bez konfiguracji i testu
Harmonogram aktualizacjiUruchamia wybrany import w ustalonych terminachDanych nowszych niż te, które są dostępne w źródle
Pełna integracja zamówieńObsługuje odrębnie uzgodniony proces przekazywania zamówieńAutomatycznego wynikania z samego pobrania XML

W BG Brandenburg Couture standardowe minimum zamówienia wynosi 5 dowolnych sztuk łącznie, również gdy korzystasz tylko z katalogowego XML. Zakupy od 1 sztuki dotyczą pełnej integracji na uzgodnionych warunkach. W tym modelu dostawa trafia do Ciebie jako partnera hurtowego; nie jest to klasyczny dropshipping do Twojego klienta. Ten poradnik dotyczy katalogu, a pełny proces opisujemy w poradniku integracji sklepu z hurtownią.

Jak rozpocząć korzystanie z katalogowego XML BG?

Zacznij od strony dostępu do pliku XML. Niezalogowany użytkownik trafia do logowania; dostęp B2B wiąże się z kontem firmy. Proces konta obejmuje rejestrację firmy, zatwierdzenie, ustawienie hasła z linku w e-mailu i logowanie. Jeżeli dopiero rozpoczynasz współpracę, przejdź przez rejestrację i uruchomienie konta hurtowego. Po zalogowaniu sprawdź dostępne informacje o pliku i zgłoszeniu.

Przy zgłoszeniu przygotuj dane firmy, adres sklepu, nazwę platformy i zakres potrzeb technicznych. Określ, czy chcesz pobrać dane raz, czy prowadzić późniejsze aktualizacje. Zakres konfiguracji uzgodnij z osobą, która konfiguruje Twój sklep. Przed wykorzystaniem materiałów ustal z BG zasady użycia zdjęć i opisów z katalogu.

Jeżeli otrzymasz adres pliku, login lub token, traktuj je jak dane dostępowe. Nie umieszczaj ich w publicznych instrukcjach, publicznych zgłoszeniach do wsparcia wtyczek, repozytoriach ani na zrzutach ekranu. Do demonstracji używaj osobnego, fikcyjnego pliku, bez tokenów, danych klientów i rzeczywistych cen hurtowych.

Plik XML hurtowni odzieży: co sprawdzić przed konfiguracją?

Nie zakładaj, że każdy XML ma te same nazwy pól albo taki sam sposób zapisu wariantów. Poniższe pozycje są listą do sprawdzenia w przypisanym pliku, a nie deklaracją schematu BG. Osoba konfigurująca importer powinna ustalić strukturę, znaczenie wartości i reguły aktualizacji.

ZakresPytanie do sprawdzeniaRyzyko błędnego mapowania
Produkt i wariantCo jest trwałym identyfikatorem produktu, a co wariantu?Duplikaty lub połączenie różnych rozmiarów w jedną sztukę
Nazwa i opisKtóre pola zawierają treść i w jakim formacie?Utrata formatowania, tabel lub własnego opisu
Kolor i rozmiarJak zapisano atrybuty i powiązanie wariantów?Nieprawidłowe warianty lub zdjęcia przy wyborze
ZdjęciaKtóry adres jest główny, jakie są kolejne i do czego należą?Zdjęcie niewłaściwego koloru albo niepełna galeria
Skład i wymiaryCzy dane są osobnymi polami czy częścią opisu? Jakie mają jednostki?Pominięcie tabeli albo zmiana znaczenia pomiaru
Cena i walutaJaka jest podstawa ceny oraz jednostka zakupu?Pomylenie ceny zakupu z ceną sprzedaży lub netto z brutto
DostępnośćCzy pole oznacza liczbę sztuk, status czy inną informację?Oferowanie niedostępnych wariantów lub ukrycie dostępnych
Brak rekorduCo znaczy zniknięcie produktu lub wariantu z pliku?Przypadkowe usunięcie karty albo pozostawienie starego stanu

Przykład demonstracyjny XML i mapowania

Poniższy XML jest całkowicie fikcyjny, nie jest schematem pliku BG i nie służy do konfiguracji produkcyjnego importu. Neutralne produkty A/B i ceny zostały wymyślone; nie są ofertą BG ani danymi pobranymi z katalogu. Pokazujemy tylko zasadę: produkt, jego wariant i jawnie nazwana podstawa ceny.

<catalog_demo>
  <product id="DEMO-A">
    <name>Produkt A</name>
    <variant id="DEMO-A-BLACK-M">
      <color>Czarny</color>
      <size>M</size>
      <purchase_price_net currency="PLN">50.00</purchase_price_net>
      <quantity_demo>2</quantity_demo>
    </variant>
  </product>
  <product id="DEMO-B">
    <name>Produkt B</name>
    <variant id="DEMO-B-ECRU-S">
      <color>Ecru</color>
      <size>S</size>
      <purchase_price_net currency="PLN">75.00</purchase_price_net>
      <quantity_demo>1</quantity_demo>
    </variant>
  </product>
</catalog_demo>

W tym przykładzie identyfikator wariantu może służyć do jego rozpoznania przy kolejnym imporcie, a cena zakupu netto jest osobnym polem. Nie ustawiaj jej automatycznie jako ceny detalicznej. Importer musi znać strukturę pliku, a jego reguły muszą pasować do sposobu przechowywania produktów i wariantów w Twoim sklepie.

Poniższe mapowanie dotyczy wyłącznie fikcyjnego XML powyżej. Nazwy pól docelowych zależą od platformy i importera.

Pole demonstracyjneMożliwe pole doceloweKontrola
product/@idZewnętrzny identyfikator produktuKlucz do rozpoznania tej samej karty przy aktualizacji
variant/@idZewnętrzny identyfikator wariantuOddzielony od ID produktu; nie nadpisuj własnego SKU bez świadomej decyzji
nameNazwa produktuZdecyduj, czy pobierać ją tylko przy tworzeniu karty czy również przy aktualizacji
color, sizeAtrybuty wariantuPrawidłowe grupowanie koloru i rozmiaru
purchase_price_netKoszt zakupu lub pole pomocniczeNie cena sprzedaży konsumentowi
quantity_demoDemonstracyjna ilość w źródleNie własny stan magazynu butiku i nie rezerwacja sztuk

Import produktów z XML: najpierw kopia testowa i mała próbka

  1. Zapisz kopię danych i ustal sposób przywrócenia sklepu. Test wykonaj na kopii, bez realnych zamówień i płatności.
  2. Wybierz próbkę z różnymi rozmiarami i kolorami oraz produktem pojedynczym. Jeżeli w próbce są niepełne dane, np. brak zdjęcia lub składu, sprawdź ich obsługę. Nie uzupełniaj braków wymyślonym parametrem.
  3. Przypisz pola do nazwy, opisu, identyfikatorów, atrybutów, zdjęć i innych potwierdzonych danych.
  4. Jeśli narzędzie to umożliwia, importuj jako wersje robocze. Sprawdź karty, warianty oraz liczby utworzonych i zmienionych rekordów przed dopuszczeniem do publikacji.
  5. Powtórz ten sam import. Nie powinien tworzyć kolejnych kopii tych samych produktów.
  6. W prywatnej kopii pliku próbki zmień jedną wartość, np. dostępność, i usuń jeden wariant. Zaimportuj ją do sklepu testowego i sprawdź, co zostało zmienione. Wynik ma odpowiadać ustalonym regułom, bez przypadkowego kasowania produktów.
  7. Dopiero po odbiorze ustal zakres przeniesienia na produkcję i osobno częstotliwość aktualizacji.

Nie zmieniaj tytułów, adresów URL produktów i własnych opisów sklepu przy każdym odświeżeniu bez potrzeby. W importerze rozdziel pierwsze utworzenie karty od późniejszego nadpisywania konkretnych pól. Zachowaj historię wyników i możliwość wskazania, co zmienił dany import.

Jednorazowy import a cykliczna aktualizacja

Import jednorazowy tworzy lub zmienia katalog na podstawie danych odczytanych w danym momencie. Kolejna zmiana w hurtowni nie przeniesie się automatycznie, jeśli narzędzie nie pobierze jej ponownie. Harmonogram ustala, kiedy importer próbuje odczytać źródło; nie dowodzi, kiedy źródło zostało odświeżone.

Zapytaj BG, jak często przygotowywane są dane źródłowe w pliku. Osobno ustal z osobą konfigurującą Twój sklep terminy uruchomienia importera i zachowanie przy błędzie pobrania. Zbyt stary plik, przerwany import lub puste źródło nie powinny bez ustalonej reguły masowo usuwać katalogu. Osobno rozstrzygnij produkty wycofane, wyprzedane i własne produkty butiku, które w ogóle nie pochodzą z tego pliku.

Nie obiecuj klientowi rezerwacji na podstawie samego odczytu XML. Nawet częsta aktualizacja katalogu nie oznacza przekazywania zamówienia ani potwierdzenia sztuki w hurtowni. Procedura zakupu i potwierdzania dostępności pozostaje odrębnym procesem. Sam katalogowy XML nie wysyła do BG zamówienia złożonego w Twoim sklepie. Bez osobno skonfigurowanego procesu zamówień sam składasz zamówienie w BG na standardowych zasadach. Dostępność i terminy podawane klientowi opieraj na rzeczywistym procesie zakupu, nie wyłącznie na odczycie katalogu.

Nazwy, zdjęcia, wymiary i warianty sprawdź według poradnika przygotowania karty produktu odzieżowego. Import zakończ kontrolą rzeczywistego widoku oferty.

Kontrola kart po imporcie

  • Nazwa, zdjęcia i wybrany kolor opisują ten sam produkt.
  • Rozmiar ma właściwe dane i nie został połączony ze stanem innego wariantu.
  • Skład i wymiary zachowały znaczenie, jednostki i czytelność na telefonie.
  • Własna cena sprzedaży ma prawidłową podstawę, walutę i konfigurację podatkową.
  • Zmiana dostępności i powtórny import zachowują się zgodnie z przyjętą regułą.
  • Opis, adresy URL produktów oraz ręcznie uzupełnione dane nie znikają przy odświeżeniu.

Przy redakcji informacji o fasonie i materiale wykorzystaj kryteria oceny jakości odzieży. Przy ustalaniu cech opieraj się przede wszystkim na opisie, specyfikacji i tabeli; zdjęcie ma rolę pomocniczą. Nie dopisuj parametrów lub certyfikatów tylko po to, by uzupełnić puste pole.

Czy WooCommerce sam importuje każdy XML?

Nie zakładaj tego na podstawie samej nazwy platformy. Wbudowany importer produktów opisany w dokumentacji WooCommerce dotyczy CSV. Obsługę konkretnego XML trzeba potwierdzić dla wybranego narzędzia, jego wersji, wariantów i wymaganych pól. Koszt narzędzia oraz jego limity sprawdź przed decyzją; samo udostępnienie katalogu nie potwierdza bezpłatnej obsługi każdej platformy.

Najczęstsze pytania o XML hurtowni odzieży

Czy plik XML automatycznie aktualizuje mój sklep?

Nie. Potrzebny jest zgodny importer, poprawne mapowanie i sposób uruchamiania kolejnych aktualizacji. Aktualność katalogu zależy również od przygotowania danych źródłowych i skutecznego zakończenia importu.

Czy import XML przekazuje zamówienia do BG?

Nie. Katalogowe dane produktów i pełna integracja zamówień to osobne zakresy. Sam import nie rezerwuje produktów, nie uruchamia dostawy i nie zmienia standardowego minimum zamówienia: 5 dowolnych sztuk łącznie.

Czy aktualizacja XML nadpisze moje własne opisy?

To zależy od importera i ustawień. Przed uruchomieniem zdecyduj, które pola mają być pobierane ponownie, a które chronione. Własne opisy i materiały często wymagają ochrony przed przypadkowym zastąpieniem treścią źródłową.

Przygotuj nazwę swojej platformy i listę danych, które chcesz przenosić. Następnie przejdź do dostępu do katalogowego pliku XML BG i ustal zakres konfiguracji dla własnego sklepu.

Autor: BG Brandenburg Couture · Aktualizacja:

JEŻELI CHCESZ POZNAĆ CENY PRODUKTÓW I DOKONAĆ ZAKUPU ZAREJESTRUJ SIĘ W NASZYM SKLEPIE