Migracja powiązań aukcji Allegro z produktami z Shopera

Migracja powiązań oznacza przypisanie każdej obsługiwanej oferty Allegro do właściwego produktu i wariantu w nowym sklepie lub systemie integrującym sprzedaż. Przeniesienie katalogu, zachowanie ofert i odtworzenie mapowań to odrębne czynności, których zakres zależy od narzędzi użytych w migracji.

W procesie występują trzy zbiory danych:

• Produkt sklepu zawiera między innymi nazwę, SKU, EAN, cenę i stan.
• Oferta Allegro jest rozpoznawana po identyfikatorze oferty i koncie sprzedawcy.
• Mapowanie wskazuje, który produkt lub wariant obsługuje daną ofertę.

SKU to własny kod produktu używany do identyfikacji towaru w katalogu. EAN to kod kreskowy produktu, który pomaga potwierdzić jego tożsamość, ale nie rozstrzyga każdego przypadku, na przykład zestawu albo wariantu bez osobnego kodu.

Przy standardowym imporcie katalogu z pliku CSV Shopera nie przenosisz mapowań Allegro, bo standardowy plik katalogowy nie jest eksportem relacji ofert zapisanych w zewnętrznym integratorze. Integrator może jednak udostępniać własny eksport i mechanizm odtworzenia powiązań, dlatego przed migracją sprawdź jego format oraz wymagane identyfikatory.

Zachowaj identyfikator oferty, konto Allegro, SKU, EAN, identyfikator i nazwę wariantu, status oferty oraz nazwę systemu zarządzającego ceną i stanem. Zasady łączenia kanału sprzedaży ze sklepem opisujemy szerzej w poradniku o integracji Allegro z WooCommerce.

Poprawne powiązanie potwierdza zgodność identyfikatora oferty z konkretnym produktem i wariantem, a nie samo podobieństwo nazw. Przed migracją porównaj SKU i EAN, a następnie sprawdź wynik kontrolowanej aktualizacji stanu.

Jeśli SKU i EAN wskazują różne towary, wstrzymaj automatyczne mapowanie i wyjaśnij rozbieżność. Zgodna nazwa nie rozstrzyga przypadku, w którym produkt ma kilka wariantów o podobnym opisie.

Standardowy import i eksport CSV Shopera nie obejmuje wariantów, atrybutów ani promocji produktów. Shoper wymaga zgodności nazw i kolejności pól profilu z plikiem oraz kodowania UTF-8; informacja pochodzi z dokumentacji Shopera sprawdzonej w październiku 2026 roku. CSV może więc pomóc w porównaniu części katalogu, ale nie stanowi pełnej kopii wariantów i mapowań z integratora.

Przed migracją przygotuj kopię katalogu, listę aktywnych ofert, eksport mapowań z integratora i spis systemów, które zmieniają ceny lub stany. Zachowaj nieedytowane pliki źródłowe, a kopie robocze oznacz datą i wersją.

Pobierz dane produktów Shopera dostępną dla sklepu metodą oraz raport powiązań z integratora. Ponieważ standardowy CSV Shopera pomija warianty, atrybuty i promocje, pozyskaj dane tych elementów osobno z panelu lub używanego integratora. Shoper opisuje zarządzanie wariantami w panelu w sekcji "Produkty > Warianty"; konkretne pola do eksportu zależą od konfiguracji sklepu.

Przygotuj również:

• Listę aktywnych i zakończonych ofert, które mają być obsługiwane po migracji.
• Listę produktów bez SKU, z powielonym SKU oraz z różnymi kodami w sklepie i integratorze.
• Strukturę wariantów wraz z wartościami cech i kodami wariantów.
• Dostęp do konta Allegro, Shopera i systemu docelowego.
• Informację, czy podczas przełączenia mogą wpływać nowe zamówienia.

Wykryj duplikaty, sortując eksport po SKU i EAN oraz sprawdzając powtarzające się wartości. Brakujące odpowiedniki oznacz osobno, zamiast dopasowywać je automatycznie po nazwie. Przy planowaniu obsługi kanału sprzedaży przyda się także poradnik o ofertach i zamówieniach na Allegro.

Nie edytuj jedynej kopii pliku i nie uruchamiaj równoległych importów na danych produkcyjnych. Przed importem sprawdź UTF-8 oraz zgodność nazw i kolejności kolumn z profilem CSV Shopera. W systemie takim jak Base sprawdź najpierw, czy eksport obejmuje identyfikator oferty, klucz produktu i dane wariantu oraz czy import docelowy potrafi te pola odczytać. Wdrożenie integracji z BaseLinkerem może obejmować przygotowanie mapowań, konfigurację synchronizacji i test zamówienia na podstawie danych próbnych.

Bezpieczna migracja prowadzi od eksportu relacji przez próbne mapowanie do testu zamówienia, a dopiero potem do przełączenia synchronizacji. Dokładne kroki importu zależą od integratora, ale każdy etap powinien kończyć się zapisem wyniku i listą rekordów wymagających decyzji.

1. Eksport: zapisz katalog, warianty, aktywne oferty oraz mapowanie z integratora. Oznacz źródło i datę każdego pliku.
2. Normalizacja: ujednolić zapis SKU i EAN bez zmieniania kodów, a następnie wyszukaj duplikaty, spacje na końcu i puste wartości.
3. Mapowanie: połącz ofertę z produktem przez potwierdzony klucz. Nie zatwierdzaj automatycznej relacji, gdy klucze wskazują różne produkty.
4. Próba: wybierz produkt prosty, wariant i rekord wymagający ręcznej decyzji. Użyj środowiska testowego, jeśli integrator je udostępnia, albo ogranicz próbę do uzgodnionej grupy ofert.
5. Kontrola: sprawdź cenę, stan, wariant i przejście zamówienia. Zapisz wynik dla każdej testowanej oferty.
6. Przełączenie: ustal moment zatrzymania zmian w starym systemie, zsynchronizuj ostatnie zamówienia i włącz docelowy kanał aktualizacji.

Przed importem potwierdź, że plik zawiera jedno oczekiwane mapowanie na ofertę, a nie kilka konkurencyjnych przypisań. Przed przełączeniem wskaż jeden system nadrzędny dla ceny i stanu. Po przełączeniu sprawdź kolejkę zamówień i logi synchronizacji, zanim wznowisz aktualizację całego katalogu.

Allegro udostępnia w REST API odczyt szczegółów oferty i operacje zmiany jej danych; w dokumentacji opisuje też przypisanie produktu do oferty przez `PATCH /sale/product-offers/{offerId}`. Bezpośrednia zmiana w API wymaga właściwej autoryzacji i ostrożności, ponieważ przypisanie produktu może aktualizować kategorię, parametry, opis i zdjęcia. W przypadku użycia Base albo innego integratora sposób wykonania operacji oraz obsługa wariantów zależą od funkcji tego systemu, więc przed próbą sprawdź jego dokumentację.

Nie każdy integrator pozwala wykonać próbę bez zmiany aktywnych danych. W takim przypadku ogranicz próbę do uzgodnionych ofert i wybierz okno operacyjne, w którym można szybko cofnąć zmianę.

Niejednoznaczne mapowanie zatrzymaj i rozstrzygnij ręcznie przed importem, ponieważ automatyczny wybór podobnego produktu może skierować zamówienia na błędny wariant. SKU jest użytecznym kluczem dopasowania, ale różne kody nie dowodzą ani tożsamości, ani odrębności produktów.

Ręczne mapowanie jest właściwe, gdy produkt zmienił kod, ma kilka podobnych wariantów, tworzy zestaw z wielu towarów albo nie ma EAN. Osoba zatwierdzająca zapisuje podstawę decyzji, na przykład zgodność cechy wariantu, dokumentację katalogu lub potwierdzenie właściciela asortymentu.

Nie przypisuj produktu wyłącznie dlatego, że jego nazwa przypomina tytuł oferty. Różnica między wariantami może dotyczyć jednego parametru, który zmienia sposób realizacji zamówienia.

Migrację uznaj za sprawdzoną dopiero wtedy, gdy oferta, produkt, stan i zamówienie wskazują tę samą pozycję oraz wariant. Komunikat o zakończeniu importu potwierdza wykonanie operacji, ale nie dowodzi poprawności wszystkich relacji.

Wykonaj kontrolę na wybranych produktach:

• Oferta: otwórz ofertę Allegro i porównaj produkt oraz wariant z mapowaniem w integratorze.
• Stan: zmień stan próbnego produktu w systemie nadrzędnym i sprawdź, czy aktualizacja dotyczy właściwej oferty.
• Cena: sprawdź kierunek synchronizacji oraz porównaj wartość przed i po aktualizacji.
• Wariant: zweryfikuj, czy zamówiony rozmiar lub kolor trafia do właściwej pozycji w sklepie.
• Zamówienie: sprawdź import zamówienia, status, dane produktu i zmianę stanu zgodnie z ustawieniami integracji.

Zapisz porównanie przed i po migracji: identyfikator oferty, SKU, wariant, cenę, stan i status zamówienia. Test wykonuj zgodnie z regułami konta i integratora, aby nie tworzyć przypadkowej sprzedaży ani dokumentu do realizacji.

Sygnały poprawnego importu obejmują zgodność liczby rekordów wejściowych i przetworzonych, brak błędów mapowania w logach, przypisanie ofert do oczekiwanych produktów oraz poprawny test aktualizacji. Część ofert może pozostać bez powiązania mimo prawidłowego zakończenia importu, dlatego raport błędów i lista nieprzypisanych ofert są osobnymi punktami odbioru.

Oferty najczęściej tracą poprawne powiązanie po zmianie SKU, spłaszczeniu wariantów do produktu głównego albo równoległym nadpisaniu mapowania przez kilka procesów. Objaw porównaj z logiem integracji i konkretną ofertą, zanim ponowisz import.

Ponowne uruchomienie importu bez sprawdzenia trybu aktualizacji może stworzyć duplikaty lub nadpisać właściwe dane. Najpierw zabezpiecz kopię, sprawdź dziennik zdarzeń i ustal, czy system dopasowuje produkty po SKU, EAN, ID czy innym polu.

Zleć migrację integratorowi, gdy mapowania są rozproszone, katalog ma wiele wariantów, sklep obsługuje bieżące zamówienia albo nie można bezpiecznie zatrzymać synchronizacji. Zakres prac zależy od jakości danych i możliwości eksportu, dlatego ocenę rozpocznij od próbki plików.

Przygotuj listę aktywnych ofert, przykładowy eksport produktów, raport mapowań, opis systemu zarządzającego ceną i stanem oraz planowany termin przełączenia. Dołącz problematyczne rekordy, na przykład produkt bez SKU, wariant z rozbieżnym kodem i duplikat.

Od wykonawcy oczekuj spisu założeń, zasad mapowania, listy odrzuconych rekordów i protokołu testów. Jeśli potrzebujesz wykonawcy do przygotowania mapowań, konfiguracji synchronizacji i testu zamówienia, zleć konfigurację integracji BaseLinker na podstawie danych próbnych.

• Automatyzacja obsługi sprzedaży na Allegro: od zamówienia do wysyłki
• Jak połączyć sklep Shoper z Empik Marketplace i obsługiwać zamówienia?
• Multichannel w e-commerce: jak połączyć sprzedaż we własnym sklepie i na Allegro?
• Allegro i WooCommerce: jak działa Wysyłam z Allegro i Smart?
• Import i eksport bazy danych MySQL przed migracją strony