Elbuz umieszcza gotowy plik pod stałym linkiem, który raz podajesz marketplace’owi, a zależnie od ustawień wysyła go też na FTP lub e-mailem do klienta; stary plik jest podmieniany dopiero po udanym zapisie nowego.
Kiedy to się przyda:
- Marketplace sam pobiera feed — link w kolumnie „Plik” nie zmienia się między przebiegami.
- Klient potrzebuje pliku na swoim serwerze — po przebiegu plik trafia na FTP lub SFTP.
- FTP nie przyjmuje pliku — kod odpowiedzi serwera w dzienniku wskaże przyczynę.
- Klient hurtowy czeka na cennik e-mailem — plik cennika idzie jako załącznik według szablonu newslettera.
Od czego zacząć: kolumna „Plik” na liście szablonów → „Kopiuj link”.
Co potrafi dostarczanie pliku
- Stały link — adres, który podajesz marketplace’owi; każdy przebieg umieszcza pod nim nowy plik.
- FTP i e-mail — dostarczenie pliku na serwer lub jako załącznik wiadomości.
- Nazwa pliku i kody FTP — dlaczego plik nie dotarł na serwer.
- Podmiana pliku — co leży pod linkiem w trakcie przebiegu i po awarii.
- Poprawienie błędu — jak podmienić błędny plik, który marketplace już pobrał.
Gdzie trafia plik
Gotowy plik jest najpierw zapisywany w folderze Twojego konta, a potem trafia tam, gdzie go skierujesz.
- Link. Adres gotowego pliku jest widoczny w kolumnie „Plik” na liście, obok jest przycisk „Kopiuj link” (po kliknięciu pojawia się komunikat „Link skopiowany”). To właśnie ten adres podajesz marketplace’owi.
- FTP. Działa, jeśli w „Ustawieniach FTP” wypełniono adres serwera i nazwę użytkownika. Tam też są port, hasło, przełącznik „SFTP (SSH File Transfer Protocol)”, „Ścieżka docelowa eksportu”, „Liczba wątków” i przycisk „Sprawdź połączenie”. Kliknij go przed pierwszym przebiegiem: w odpowiedzi zobaczysz „Połączenie nawiązane!” albo „Błąd: ‹odpowiedź serwera›”. Jeśli nie wypełniono wszystkich pól: serwera, portu, użytkownika i hasła, przycisk odpowie „Wypełnij pola!”.
- E-mail. Załącznik do wiadomości działa tylko w typie „Cennik (XLSX, CSV)” i tylko wtedy, gdy wypełniono „Szablon newslettera”. Załącznik można spakować do ZIP.
- Połączenie bezpośrednie. Typy z grupy w ogóle nie mają pliku — dane trafiają do serwisu marketplace’u zapytaniami.
Nazwę pliku ustawiasz w karcie szablonu i działają w niej trzy makra: {DATE} — dzisiejsza data, {DATETIME} — data z godziną, {TIME} — godzina. Przydaje się to, gdy marketplace lub klient chce osobnego pliku na każdy dzień. Ukośnik w nazwie zamieniany jest na kropkę, a rozszerzenie .php i jego odmiany program wymusza na .xml.
Po przebiegu program zapisuje rozmiar pliku i czas trwania — obie liczby widać na liście i w oknie podsumowania przy następnym uruchomieniu. Plik mniejszy niż 4 KB liczony jest jako 4 KB: na dysku i tak zajmuje blok.
Nazwa pliku i FTP: skąd biorą się błędy eksportu
Na FTP plik trafia pod tą samą nazwą co pod linkiem, do folderu z pola „Ścieżka docelowa eksportu”. Gdy eksport na FTP nie przechodzi, sprawdź w karcie szablonu pole „Nazwa pliku” i ustawienia FTP według tej listy:
- Litery łacińskie bez spacji. Program wstawia nazwę pliku do adresu FTP tak, jak jest, bez kodowania. Pisz ją literami łacińskimi, cyframi, kropką, myślnikiem i podkreśleniem:
feed_rozetka.xml, a nie „cennik rozetka.xml”. - Pusta nazwa to nie błąd. Wtedy używana jest standardowa nazwa typu eksportu, np.
export_elbuz.xmldla . - Podfolderu nie da się podać w nazwie. Ukośnik zamienia się na kropkę; folder podaje się tylko w „Ścieżce docelowej eksportu”, a ta zaczyna się od ukośnika:
/public_html/feeds. - Plik o takiej nazwie już istnieje — zostanie nadpisany, wersje nie są przechowywane. Potrzebny osobny plik na dzień — dodaj do nazwy
{DATE}.
Gdy plik nie dotarł na FTP, w dzienniku przebiegu zostaje kod odpowiedzi serwera — zwykle od razu widać po nim przyczynę, bez zgadywania:
| Kod | Co oznacza | Gdzie szukać |
|---|---|---|
| 226 | przesyłanie zakończone pomyślnie | wszystko w porządku, plik jest na serwerze |
| 530 | serwer nie wpuścił: login lub hasło nie pasują | dane w „Ustawieniach FTP”; na niektórych hostingach nazwę użytkownika pisze się razem z domeną |
| 550 | brak dostępu do folderu lub folder nie istnieje | pole „Ścieżka docelowa eksportu”: folder wymaga prawa zapisu; dla FTP program sam próbuje utworzyć brakujące foldery, dla SFTP folder musi istnieć |
| 552 | przekroczono limit miejsca na dysku | miejsce na hostingu |
| 425, 426 | kanał przesyłania się nie otworzył lub został zerwany | najczęściej tryb pasywny i zapora po stronie serwera |
Na połączenie z serwerem FTP program czeka 10 sekund, na przesłanie pliku — do 120 sekund. Serwer, który nie zdąży, daje w dzienniku wiersz „Error:” z przyczyną.
Kody zaczynają się od cyfry, która mówi najważniejsze: 2 — sukces, 4 — chwilowe niepowodzenie (warto powtórzyć), 5 — odmowa, która sama nie minie.
Wynik widać w dzienniku przebiegu w wierszu „Wyeksportowano pliki przez FTP: N z M”; jeśli przesłanie przez FTP się nie udało, za nim stoi „Error: ‹kod› ‹tekst›” — kod odczytaj z tabeli powyżej.
Dla SFTP nieudane logowanie zapisuje „Błąd logowania do serwera SFTP!” z przyczyną od serwera; jeśli logowanie się udało, a plik nie trafił na serwer, wiersza „Wyeksportowano pliki przez FTP” w dzienniku w ogóle nie będzie.
Co leży pod linkiem, gdy powstaje nowy plik
Eksport do pliku robi jedno: według szablonu tworzy plik z produktami i umieszcza go pod stałym linkiem. Marketplace sam pobiera ten plik przez link.
Przy takim eksporcie program nie wysyła marketplace’owi osobnych poleceń: ani „usuń produkt”, ani „wycofaj ze sprzedaży”. Wszystko, czego marketplace się od nas dowiaduje, jest zapisane w ostatnim pliku leżącym pod linkiem. Jakie produkty do niego trafiają — warunki wyboru szablonu.
Kiedy link prowadzi do nowego pliku
Nowy plik powstaje osobno, w folderze roboczym programu, porcjami (w szablonach XML po 500 produktów). Przez cały ten czas pod linkiem leży poprzedni plik. Gdy nowy plik jest gotowy, program zapisuje go w magazynie plików i dopiero po udanym zapisie link w szablonie prowadzi do nowego pliku.
Jeśli zapisanie nowego pliku się nie udało, dziennik pisze „Plik nie został przesłany do magazynu plików w chmurze. Poprzedni plik i link do niego pozostawiono bez zmian”, eksport kończy się wierszem „Eksport danych NIE został zakończony: plik nie został utworzony”, a „Link do pliku (#1)” i „Data eksportu” w szablonie pozostają poprzednie.
- Jeśli eksport zatrzymano przyciskiem „Zatrzymaj”, zatrzymuje się on po bieżącym produkcie. Niedokończony plik zostaje w folderze roboczym, a pod linkiem zostaje poprzedni.
- Jeśli warunek w szablonie zawiera błąd, plik nie jest publikowany i pod linkiem też zostaje poprzedni. Jeśli wybór nie dał żadnego produktu, plik nie jest publikowany w feedach XML (zwykłych i Google) ani w „Cenniku (XLSX, CSV)”, poza trybem „Eksportować wiersze z kategoriami, poniżej produkty + grupowanie”. Szablony prom.ua w formacie XLS i „1C (CommerceML2)” przy pustym wyborze publikują plik bez produktów, który zastępuje poprzedni.
- Jeśli w nazwie pliku w szablonie jest
{DATE},{DATETIME}lub{TIME}, nazwa, a z nią i link, zmienia się z każdym przebiegiem. Marketplace, który pobiera plik pod jednym adresem, potrzebuje nazwy bez tych wstawek. - W wersji chmurowej do linku po każdym eksporcie dopisywane jest
?uuid=z nową liczbą. Sam plik leży pod tym samym adresem, liczba tylko omija pamięć podręczną przeglądarki.
Co się dzieje z produktem, który wypadł z pliku
Po naszej stronie — nic, poza tym, że nie ma go w nowym pliku. Produkt zostaje w katalogu taki, jaki był. Co marketplace zrobi z pozycją, której nie ma już w pliku (ukryje, wycofa ze sprzedaży, usunie czy zostawi bez zmian), decyduje sam marketplace i program nie ma na to wpływu. Sprawdź zasady swojego marketplace’u.
- Jeśli marketplace ma zobaczyć produkt jako niedostępny, produkt musi zostać w pliku. W tym celu musi spełniać warunki wyboru, a jego status dostępności musi odpowiadać w ustawieniach dostępności szablonu wariantowi „niedostępny” (tam też ustawia się ilość, którą dostanie taki produkt).
- Jeśli produkt po prostu zostanie dezaktywowany, a w szablonie jest warunek „produkt aktywny”, nie dostanie oznaczenia „niedostępny”, tylko całkowicie zniknie z pliku.
- Jeśli produkt wrócił (znów go włączono lub znów spełnia warunki), pojawi się w pliku przy następnym eksporcie.
Jak po dzienniku poznać, że plik powstał
Przebieg eksportu widać w „Centrum operacji”. Plik powstał i trafił pod link, jeśli w dzienniku jest wiersz „Pobierz plik” z nazwą pliku, a ostatni wiersz to „Eksport danych zakończony”. Jeśli plik nie powstał lub magazyn plików go nie przyjął, ostatni wiersz to „Eksport danych NIE został zakończony: plik nie został utworzony”.
Po udanym przebiegu na liście szablonów aktualizują się „Data eksportu” i „Link do pliku (#1)”. Jeśli plik nie powstał, „Data eksportu” zostaje stara, a zmienia się tylko „Czas trwania”. Co oznacza każdy wiersz dziennika — w tabeli niżej.
Jak poprawić błędny eksport
Przycisku „przywróć poprzedni plik” nie ma: nowy plik zastępuje poprzedni, a program nie przechowuje kopii. Na błędny plik jest jeden sposób: usunąć przyczynę i wyeksportować jeszcze raz. Nowy plik zastąpi błędny pod tym samym linkiem.
- Jeśli do pliku trafiły nie te produkty lub jest ich mniej, niż trzeba, popraw warunki wyboru szablonu, opcje „Eksportuj do pliku (do sklepu)” w produktach i kategoriach, wybór sklepu lub magazynu. Przed ponownym uruchomieniem sprawdź liczby w oknie „Co zostanie wyeksportowane”.
- Jeśli produkty w pliku są właściwe, a błędne są ich dane (ceny, dostępność, opisy), popraw dane w katalogu i uruchom eksport ponownie.
- Jeśli szablon działa z opcją „Eksportować tylko nowe dane”, produkty z błędnego pliku mają już oznaczenie „Wyeksportowano” i same ponownie nie trafią do pliku. Trzeba je zmienić w katalogu lub zdjąć z nich oznaczenie „Wyeksportowano”, inaczej poprawka nie trafi do pliku.
- Co marketplace zdążył zrobić z błędnym plikiem, zanim pobrał poprawiony, zależy od marketplace’u: program nie kontroluje, kiedy marketplace ponownie czyta plik i jak przetwarza zmiany.
Aby błąd nie trafił do pliku następnym razem, przełącz reguły stop eksportu w tryb „Zatrzymaj eksport”. Jeśli filtru szablonu nie da się przeliczyć, dziennik pisze „Nie obliczono podsumowania przed startem…”, a reguły stop w takim przebiegu nie działają.
Scenariusze
Marketplace pobiera feed przez link
Co ustawić: w kolumnie „Plik” na liście szablonów kliknij „Kopiuj link” i wklej adres w panelu marketplace’u. Nazwę pliku w karcie szablonu zostaw bez {DATE}, {DATETIME} i {TIME}.
Efekt: każdy przebieg umieszcza pod tym samym linkiem nowy plik, a marketplace pobiera go według swojego harmonogramu. Czego nie będzie: dopóki nowy plik nie zostanie zapisany w magazynie plików, pod linkiem leży poprzedni.
Klient chce osobnego pliku na każdy dzień na swoim FTP
Co ustawić: w „Ustawieniach FTP” wypełnij serwer, użytkownika, hasło i „Ścieżkę docelową eksportu”, kliknij „Sprawdź połączenie”. Do nazwy pliku dodaj {DATE}.
Efekt: codziennie na serwerze pojawi się nowy plik z datą w nazwie, poprzednie zostają. Czego nie będzie: link z kolumny „Plik” też będzie się zmieniał z każdym przebiegiem — marketplace’owi, który pobiera plik pod jednym adresem, taka nazwa nie odpowiada.
Cennik dla klienta hurtowego e-mailem
Co ustawić: szablon typu „Cennik (XLSX, CSV)”, wypełnione pole „Szablon newslettera”; w razie potrzeby włącz pakowanie załącznika do ZIP.
Efekt: po każdym przebiegu plik trafi jako załącznik do wiadomości. Czego nie będzie: w innych typach szablonów załącznika do wiadomości nie ma.
Co pisze dziennik, gdy plik nie dotarł
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Wyeksportowano pliki przez FTP: 0 z 1 Error: …” w dzienniku przebiegu | Serwer nie przyjął pliku: dane logowania, ścieżka, prawo zapisu lub nazwa pliku ze spacjami czy cyrylicą | „Sprawdź połączenie” w „Ustawieniach FTP”, ścieżka od ukośnika, nazwa pliku literami łacińskimi (nazwa pliku i FTP) |
| „Eksport produktów 500 z …” | Plik powstaje: pierwsza liczba to liczba produktów już zapisanych, druga — ile wybrano łącznie. W szablonach XML wiersz pojawia się co 500 produktów i jeszcze raz na końcu | Nic, poczekaj na zakończenie |
| „Przesyłanie pliku do magazynu plików w chmurze” | Plik jest gotowy, program podmienia nim poprzedni pod linkiem | Nic, poczekaj na wiersz „Pobierz plik” |
| „Plik nie został przesłany do magazynu plików w chmurze. Poprzedni plik i link do niego pozostawiono bez zmian” | Plik powstał, ale magazyn plików go nie przyjął. Eksport nie został zakończony, pod linkiem został poprzedni plik | Uruchom eksport jeszcze raz |
| „Eksport danych NIE został zakończony: plik nie został utworzony” | Wybór nie dał żadnego produktu, warunek szablonu zawiera błąd, magazyn plików nie przyjął pliku albo eksport zatrzymano. Pod linkiem został poprzedni plik | Sprawdź liczby w podsumowaniu przed startem i warunki wyboru. Reguła stop lub konflikt harmonogramu w dzienniku — analiza uruchomienia |
Najczęstsze pytania
Eksport na FTP nie przechodzi — czy to może być błąd w nazwie pliku?
Może. Program wstawia nazwę pliku do adresu FTP tak, jak jest — nie jest stosowane, więc spacje i cyrylica to pierwszy podejrzany: zmień nazwę na łacińską, np. feed.xml. Kod w wierszu „Wyeksportowano pliki przez FTP: … Error:” wskazuje przyczynę: 530 — login lub hasło, 550 — folder lub prawo zapisu.
Czy stare wersje pliku są przechowywane?
Nie. Każdy przebieg zastępuje poprzedni plik, wersji „jak było w zeszłym tygodniu” nie ma. Potrzebujesz archiwum — eksportuj na FTP z {DATE} w nazwie pliku.
Dlaczego w kolumnie „Plik” niektórych szablonów jest pusto?
Szablony Elbuz Tunnel i bezpośrednie połączenia przez API w ogóle nie mają pliku: tunel zapisuje dane prosto do bazy sklepu, a API — zapytaniami do serwisu marketplace’u.
Czy można wysłać plik e-mailem z dowolnego szablonu?
Nie. Załącznik do wiadomości jest tylko w typie „Cennik (XLSX, CSV)” i tylko z wypełnionym „Szablonem newslettera”.
Dlaczego mały plik na liście waży 4 KB?
Plik mniejszy niż 4 KB liczony jest jako 4 KB: na dysku i tak zajmuje blok.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Eksport danych → kolumna „Plik”
- Inne wejścia
- karta szablonu, sekcja „Powiązane ustawienia” → „Ustawienia FTP”
- Uprawnienia
- okno „Szczegółowa konfiguracja szablonu eksportu”
- Przygotuj
- dla FTP — adres serwera, użytkownika, hasło i folder z prawem zapisu
Powiązane tematy
- Jeśli potrzebny jest ogólny obraz eksportu — Jak skonfigurować eksport produktów.
- Jeśli trzeba przeczytać cały dziennik przebiegu — Jak uruchomić eksport i odczytać dziennik.
- Jeśli plik wyszedł pusty — Dlaczego plik jest pusty, choć produkty są.
- Jeśli cennik dla klienta składa się z kolumn — Cennik dla klientów XLSX i CSV.
- Jeśli planujesz sprzedawać na marketplace’ach — co to daje Twojemu sklepowi.
