Elbuz pobiera opłacone zamówienia z usługi „Kup Teraz” polskiej porównywarki cen ceneo.pl i umieszcza je we wspólnej kolejce z pozostałymi kanałami: ten sam magazyn, ta sama baza klientów, ci sami menedżerowie.
Kiedy to się przyda:
- Klienci składają zamówienia bezpośrednio na Ceneo — każde staje się dokumentem „Zamówienie klienta” ze statusem „Opłacono”.
- Feed dla Ceneo powstaje w Elbuz — pozycje zamówienia od razu znajdują Twoje karty po identyfikatorze z feedu.
- Menedżer sam prowadzi zamówienie dalej — kolejne uruchomienia nie ruszają już zaimportowanego dokumentu.
Od czego zacząć: weź klucz dostępu w panelu Ceneo i wklej go do szablonu typu „ceneo.pl”.
Co potrafi połączenie z Ceneo
- Połączenie jednym kluczem — tymczasowy dostęp Elbuz uzyskuje sam przy każdym uruchomieniu.
- Przeniesienie zamówienia — klient, adres, dostawa, rodzaj płatności, pozycje i komentarz.
- Dopasowanie pozycji według feedu — bez zgadywania po nazwie, jeśli feed powstaje w Elbuz.
- Zamówienia bez duplikatów — zaimportowane jest pomijane, praca menedżera nie jest nadpisywana.
Ceneo przynosi do Elbuz tylko zamówienia. Produkty idą w odwrotną stronę: przekazujesz je na platformę feedem z sekcji eksportu danych.
Co jest potrzebne od Ceneo
Potrzebny jest jeden klucz dostępu: wydaje się go w panelu sklepu, w ustawieniach usługi „Kup Teraz”, i wkleja w pole „Token” karty „Połączenie”. Pozostałych pól tej karty dla Ceneo się nie wypełnia.
Przy każdym uruchomieniu Elbuz przedstawia klucz, dostaje tymczasowy dostęp i z nim pobiera zamówienia. Niczego nie trzeba przechowywać ani przedłużać; spacje na początku i na końcu klucza Elbuz usuwa sam.
Dokumentacja platformy dla partnerów: Ceneo Developers.
Jak podłączyć krok po kroku
- Utwórz szablon typu „ceneo.pl” i wklej klucz w pole „Token”. Pola „Zamówienia” tu nie ma: ten typ importuje wyłącznie zamówienia.
- Zapisz szablon i uruchom go ręcznie — dziennik pokaże, czy klucz został przyjęty i ile znaleziono zamówień.
- Otwórz kilka dokumentów i porównaj pozycje, kwoty, klienta i adres z panelem Ceneo.
- Jeśli pozycje trafiły na Twoje karty, ustaw szablon w harmonogramie. Jeśli przyszły jako nowe karty, najpierw uporządkuj feed (dopasowanie pozycji).
Co przychodzi z zamówieniem
Ceneo zwraca zamówienie w częściach — listę, potem dla każdego pozycje i dane dostawy. Elbuz składa je w jeden dokument:
| Dane Ceneo | Pole dokumentu w Elbuz |
|---|---|
| numer zamówienia dla klienta | Numer dokumentu |
| wewnętrzny identyfikator zamówienia | Klucz zewnętrzny (po nim zamówienie jest rozpoznawane ponownie) |
| data utworzenia | Data zamówienia |
| kwota zamówienia i koszt dostawy | Kwota dokumentu, cena dostawy |
| e-mail i telefon klienta | E-mail, telefon |
| imię, nazwisko, nazwa firmy | Dane odbiorcy |
| adres, kod pocztowy, miasto, region, kraj | Adres dostawy |
| sposób dostawy | Rodzaj dostawy |
| sposób płatności | Rodzaj płatności (tabela poniżej) |
| komentarz klienta | Opis zamówienia |
| pozycje: nazwa, cena, ilość, kwota | Wiersze dokumentu |
Elbuz pobiera zamówienia „Kup Teraz”, za które płatność jest już potwierdzona. Dlatego status płatności od razu jest „Opłacono”, a do realizacji trafiają zamówienia, za które pieniądze już są.
Rodzaje płatności i dostawy
| Płatność w Ceneo | Rodzaj płatności w Elbuz |
|---|---|
| szybki przelew | Płatność online |
| płatność przy odbiorze | Za pobraniem |
| karta kredytowa | Karta płatnicza |
| przelew bezpośrednio na konto sklepu | Przelew bankowy |
| raty, płatność dzielona | Karta płatnicza — według reguły zapasowej dla wszystkich nierozpoznanych płatności |
Nie da się zmienić tego przypisania regułą: w karcie „Powiązane ustawienia” szablonu Ceneo jest tylko „Ustawienia harmonogramu”, przycisków dopasowania statusów i rodzajów płatności nie ma, a reguły innych szablonów nie działają na Ceneo. Rodzaj płatności poprawia się w samym dokumencie, w sekcji „Płatność” — kolejne uruchomienia tej poprawki nie nadpiszą.
Dostawa kurierska i InPost (paczkomaty) są rozpoznawane po nazwie i trafiają do odpowiednich przewoźników. Wszystkie pozostałe sposoby dostawy Ceneo trafiają jako „Odbiór osobisty”.
Jak pozycje znajdują Twoje karty
W pozycji Ceneo przekazuje identyfikator produktu z Twojego feedu i nazwę, bez kodu produktu. Jeśli feed dla Ceneo powstaje w Elbuz, pozycja od razu znajduje swoją kartę. Jeśli nie znajdzie jej po identyfikatorze, szuka po nazwie.
Przed podłączeniem zamówień sprawdź, czy feed dla Ceneo przekazuje stałe identyfikatory produktów i powstaje z tego samego katalogu. Wtedy pozycje nie będą tworzyć niepełnych kart w kategorii technicznej.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Kategoria techniczna: co z nią zrobić
Pozycja bez karty tworzy nową w kategorii technicznej „Produkty - ceneo - ‹nazwa Twojego szablonu›” na najwyższym poziomie drzewa. Kategoria powstaje jako wyłączona i z zakazem eksportu; jeśli później zezwolisz na eksport, kolejne przebiegi tego nie cofną.
- Cena nowej karty pochodzi z wiersza zamówienia, stan — to ilość z tego wiersza.
- Różne nazwy — każda ma własną kartę, takie same nazwy w jednym przebiegu — jedną wspólną.
- Karty można przenosić do własnych kategorii: wiersz dokumentu zachowuje powiązanie z kartą i przechowuje własną nazwę, cenę i ilość.
- Usunięta lub przemianowana kategoria wróci: Elbuz szuka jej po dokładnej nazwie na najwyższym poziomie.
Zanim usuniesz kategorię, przenieś z niej karty: kategorie techniczne i marki.
Co dzieje się z zamówieniem po imporcie
Każde zamówienie trafia jako niezatwierdzony dokument „Zamówienie klienta” ze statusem „Opłacono” i statusem płatności „Opłacono”. Import nie tworzy dokumentu wpływu pieniędzy: „Opłacono” to oznaczenie w samym zamówieniu.
Import nie zmienia stanów w kartach ani w magazynach. Jedyne, co przelicza w istniejących produktach, to liczba sprzedaży. Rezerwacja pojawia się dopiero po zatwierdzeniu zamówienia przy włączonej ewidencji magazynowej.
Zatwierdzone zamówienie Ceneo trzyma towar w rezerwacji, dopóki nie zmienisz jego statusu na końcowy albo nie zatwierdzisz na jego podstawie dokumentu „Dokument WZ (wydanie zewnętrzne)”. Szczegóły: rezerwacja i stan dostępny, wysyłka.
Zamówienie, które już jest w Elbuz, przy ponownym imporcie jest pomijane: duplikatu nie ma, ale zmiany z platformy też nie przychodzą. Dokument prowadzi Twój menedżer; co stało się z zamówieniem na Ceneo po imporcie, widać w panelu platformy.
Aktualizacja według harmonogramu
Elbuz łączy się z Ceneo według harmonogramu ustawianego przyciskiem „Ustawienia harmonogramu” w karcie „Powiązane ustawienia”. Zamówienia przychodzą opłacone i czekają na wysyłkę, więc sprawdzaj je kilka razy na godzinę. Jak tymczasowo wyłączyć szablon: wyłączyć szablon.
Każde uruchomienie prosi o zamówienia utworzone po poprzednim imporcie, z zapasem dwunastu godzin wstecz — na rozbieżność zegarów i opóźnienia platformy.
Ile zamówień w jednym przebiegu
Listę Elbuz pobiera stronami od najnowszych, ale nie więcej niż 5000 zamówień na przebieg; na każde nowe zamówienie idą jeszcze dwa zapytania — pozycje i dostawa. Po przebiegu punkt startowy przesuwa się na datę najnowszego zamówienia.
Zamówień, które nie zmieściły się w przebiegu i zostały utworzone ponad dwanaście godzin wcześniej niż najnowsze, następne uruchomienie już nie pobierze. Można je dociągnąć datą w sekcji „Zaawansowane” (scenariusz).
Przycisk „Zatrzymaj” przebieg Ceneo sprawdza tylko raz, na starcie; jeśli wymiana danych się zaczęła, przebieg dojdzie do końca.
- Запит або дія
- Відповідь
- loop — повторюється
- Примітка
Scenariusze
Przyjmować opłacone zamówienia „Kup Teraz” razem z pozostałymi kanałami
Co włączyć. Szablon typu „ceneo.pl”, klucz w polu „Token”, harmonogram przyciskiem „Ustawienia harmonogramu”, plakietka w nagłówku formularza — „Aktywny”.
Efekt. Nowe zamówienia trafiają jako dokumenty „Zamówienie klienta” ze statusem „Opłacono”. Już zaimportowane zamówienie nie zaktualizuje się ani nie zdubluje (po imporcie).
Żeby pozycje trafiały na Twoje karty, a nie do nowych
Co włączyć. Feed dla Ceneo, który powstaje w Elbuz i przekazuje jako identyfikator produktu identyfikator karty z Twojego katalogu.
Efekt. Pozycja znajduje kartę po tym identyfikatorze, a w przeciwnym razie — po nazwie. Jeśli nie znajdzie ani tak, ani tak, Elbuz utworzy nową w kategorii technicznej.
Dociągnąć zamówienia ze starszego okresu
Co włączyć. W sekcji „Zaawansowane” formularza szablonu wpisz datę w polu „Import zamówień począwszy od daty (RRRR-MM-DD)” i uruchom szablon ręcznie.
Efekt. Elbuz pobierze zamówienia od tej daty minus dwanaście godzin i utworzy dokumenty dla tych, których jeszcze nie ma. Po przebiegu w polu pojawi się data najnowszego. Jeśli w okresie jest ponad 5000 zamówień, najstarszych to uruchomienie nie pobierze.
1
Import zamówień począwszy od daty (RRRR-MM-DD)- Import zamówień począwszy od daty (RRRR-MM-DD) — data, od której (minus dwanaście godzin) Elbuz pobiera zamówienia.
Tymczasowo nie przyjmować zamówień z Ceneo
Co włączyć. Kliknij plakietkę statusu w nagłówku formularza, żeby pokazała „Wyłączony”.
Efekt. Harmonogram pomija szablon, ręczne uruchomienie działa. Po ponownym włączeniu import ruszy od daty ostatniego zamówienia minus dwanaście godzin, z tym samym limitem 5000.
Co zrobić, gdy zamówienia z Ceneo nie przychodzą
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Nie podano tokenu API” | Pole „Token” jest puste | Wklej klucz z panelu Ceneo (co jest potrzebne) |
| „Błąd autoryzacji w API. Sprawdź adres strony, login i hasło.” | Klucz skopiowano niecały albo został unieważniony; adresu, loginu i hasła w formularzu Ceneo nie ma. Zdarza się też, gdy platforma nie odpowiedziała | Skopiuj klucz od nowa; jeśli na pewno jest poprawny — uruchom szablon później |
| Zamówień nie ma, choć w panelu są | To przejścia z porównywarki cen do Twojego sklepu, a nie zamówienia „Kup Teraz” — w ich nie ma | Taka sprzedaż przychodzi z Twojej strony |
| Pozycje tworzą nowe karty | Identyfikatory w feedzie nie zgadzają się z kartami katalogu | Popraw feed, a nie import (dopasowanie pozycji) |
| Zmiany zamówienia na Ceneo nie przychodzą | Zaimportowane zamówienie jest pomijane, żeby nie nadpisać pracy menedżera | Porównuj zmiany z panelem Ceneo (po imporcie) |
| Zaimportowano nie to, co trzeba | Wszystko, co powstało, jest oznaczone nazwą szablonu | Dokumenty, karty i nowych kontrahentów wyfiltruj po „Źródło: nazwa” i usuń; zatwierdzonym najpierw cofnij zatwierdzenie (jak usunąć) |
Jak usunąć zaimportowane dane
- Zamówienia. Na liście dokumentów wyfiltruj wiersze po „Źródło: nazwa” i usuń je hurtowo. Zatwierdzone są pomijane: „Nie usunięto zatwierdzonych dokumentów (N). Najpierw anuluj zatwierdzenie.” Usunięte dokumenty leżą 30 dni w „Koszu dokumentów”.
- Karty. Leżą w kategorii technicznej z nazwą szablonu w kolumnie „Źródło: nazwa”.
- Klienci. Nowi kontrahenci mają nazwę szablonu w kolumnie „Źródło — nazwa”; znalezieni wśród istniejących po adresie e-mail lub telefonie tego oznaczenia nie dostają.
Usunięte zamówienie platforma zwróci ponownie, ale tylko w zakresie daty, od której idzie import; starszy okres dociąga się datą w „Zaawansowane”. Ogólny tryb: jeśli zaimportowano nie to, co trzeba.
Najczęstsze pytania
Czy można zaimportować produkty z Ceneo?
Nie. Produkty przekazujesz na Ceneo feedem, a stamtąd przychodzą zamówienia (dopasowanie pozycji).
Dlaczego wszystkie zamówienia są oznaczone jako opłacone?
„Kup Teraz” zwraca zamówienia z potwierdzoną płatnością, więc status płatności od razu jest „Opłacono” (co przychodzi).
Jaki rodzaj płatności dostają raty i płatność dzielona?
„Karta płatnicza” według reguły zapasowej. Właściwy rodzaj płatności ustawia się w dokumencie, w sekcji „Płatność” (rodzaje płatności).
Dlaczego dostawa trafiła jako „Odbiór osobisty”?
Elbuz rozpoznaje tylko dostawę kurierską i InPost; pozostałe sposoby Ceneo trafiają jako „Odbiór osobisty” (rodzaje dostawy).
Zamówienie przyszło — dlaczego stan się nie zmienił?
Import nie rusza stanu. Rezerwacja pojawia się po zatwierdzeniu zamówienia (po imporcie).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych → nowy szablon typu „ceneo.pl”
- Uprawnienia
- okno „Import danych” w uprawnieniach grup
- Co przygotować
- klucz dostępu z panelu sklepu na Ceneo; feed produktów dla Ceneo
1
Pole „Token”- Pole „Token” — klucz dostępu z Twojego panelu Ceneo.
Powiązane tematy
- Jeśli chcesz ustawić feed produktów dla Ceneo: szablony eksportu.
- Jeśli przyjmujesz zamówienia także z innych marketplace’ów: import zamówień przez API.
- Jeśli zamówienie trzeba wysłać i zdjąć ze stanu magazynu: zamówienie klienta.
- Jeśli sprzedajesz też na Allegro: podłączenie Allegro.
