Integracja z hurtownią XML i CSV: import cen, stanów i produktów
Hurtownia daje plik albo adres z feedem, a sklep potrzebuje poprawnych cen i stanów każdego dnia. Różnicę robią mapowanie pól, reguły marży i odporność na błędy w pliku.
Autor: Szymon Łakomy. Aktualizacja:
Co dzieje się z plikiem po drodze
Dane trafiają do sklepu, na przykład WooCommerce, albo do programu magazynowego, na przykład Subiekta. Droga jest podobna niezależnie od celu.
- Pobranie pliku lub odpowiedzi API o ustalonej porze, z zapisem kopii.
- Kontrola: czy plik się wczytuje, czy ma sensowną liczbę pozycji i czy ceny nie są zerowe.
- Mapowanie pól hurtowni, takich jak symbol, EAN, nazwa, cena zakupu i stan, na pola w sklepie.
- Reguły: marża, zaokrąglenia, kategorie i produkty do pominięcia.
- Zapis zmian tylko tam, gdzie coś się zmieniło, żeby nie obciążać sklepu.
- Raport: ile produktów dodano, zmieniono, wyłączono i odrzucono.
Mapowanie i reguły marży
| Element | Przykładowa reguła |
|---|---|
| Identyfikator produktu | EAN lub symbol hurtowni jako klucz, jeden nadrzędny, żeby nie tworzyć duplikatów |
| Cena zakupu | przeliczenie na cenę sprzedaży według progów, na przykład inna marża dla tanich i drogich pozycji |
| Kategorie | tabela przypisań z kategorii hurtowni do kategorii sklepu, nowe nieprzypisane trafiają do kolejki |
| Stan magazynowy | stan hurtowni pomniejszony o bufor, żeby nie sprzedawać ostatniej sztuki |
| Opisy i zdjęcia | tylko jeśli feed je zawiera i warunki pozwalają, a ubogie opisy można uzupełnić według zasad ze strony opisy produktów generowane przez AI |
Reguły marży są przykładowe. Ustalasz je Ty, a integracja je tylko stosuje.
Jak często odświeżać dane
Nie ma jednej odpowiedzi. Dla wielu sklepów ceny i stany raz dziennie wystarczają. Towar szybko znikający lub o zmiennej cenie wymaga częstszego odświeżania, o ile hurtownia aktualizuje feed tak często i pozwalają na to zasady jej serwera. Sprawdzam, jak naprawdę zmienia się plik, bo odpytywanie co chwilę nic nie daje.
Opóźnienie między stanem w hurtowni a stanem w sklepie oznacza ryzyko sprzedaży towaru, którego nie ma. Ustalamy z góry, co się wtedy dzieje: informacja do klienta, alternatywa albo anulowanie. Zamawianie towaru u dostawcy to osobny proces, opisany w automatyzacji zamówień do dostawców.
Błędy w feedach i jak je łapię
- Plik pusty lub urwany. Integracja nie nadpisuje danych i zgłasza problem, zamiast wyłączyć cały asortyment.
- Zmiana struktury pliku. Nowe lub przemianowane pola dają zgłoszenie błędu mapowania, a nie ciche, złe ceny.
- Nagły spadek liczby pozycji. Import zatrzymuje się i pyta człowieka.
- Kodowanie znaków i separatory. Polskie litery i średniki w CSV obsługuję po stronie importu.
- Ceny zerowe lub absurdalnie niskie. Blokada progowa zatrzymuje je przed publikacją.
Gdy hurtownia udostępnia API zamiast pliku, schemat jest podobny. Ogólne zasady łączenia systemów opisuje strona co to jest integracja API.
Najczęstsze pytania
Co jeśli hurtownia nie udostępnia pliku, tylko stronę z produktami?
Najpierw pytam hurtownię o feed lub API, bo to stabilniejsze. Pobieranie danych ze strony jest kruche i zależy od warunków serwisu, więc traktuję je jako ostateczność i mówię o ryzyku przed wyceną.
Czy mogę łączyć kilka hurtowni?
Tak. Każda hurtownia ma własne mapowanie, a reguły wyboru decydują, z której bierzesz cenę i stan, gdy ten sam produkt jest w kilku. Taki zakres wyceniam od około 2000 zł netto.
Czy nowe produkty z feedu pojawią się w sklepie same?
Jeśli tak zdecydujesz. Często lepiej, żeby nowe pozycje trafiały najpierw do kolejki z propozycją kategorii i ceny, a do oferty dopiero po akceptacji.
Jak często stany będą aktualizowane?
Tak często, jak często hurtownia odświeża feed i na ile pozwalają jej zasady. Dla wielu sklepów wystarcza raz dziennie, a dla towaru szybko znikającego ustalamy krótszy odstęp.
Powiązane strony
Chcesz, żeby ceny i stany z hurtowni aktualizowały się same?
Napisz, od jakiej hurtowni dostajesz dane i do jakiego sklepu lub programu mają trafiać.