↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Marketplace’y w Europie: co się importuje i jak je podłączyć

    Jak przyjmować zamówienia z ceneo.pl (Kup Teraz) w Elbuz

    15 min czytaniaZaktualizowano

    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

    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

    1. 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.
    2. Zapisz szablon i uruchom go ręcznie — dziennik pokaże, czy klucz został przyjęty i ile znaleziono zamówień.
    3. Otwórz kilka dokumentów i porównaj pozycje, kwoty, klienta i adres z panelem Ceneo.
    4. 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 CeneoPole dokumentu w Elbuz
    numer zamówienia dla klientaNumer dokumentu
    wewnętrzny identyfikator zamówieniaKlucz zewnętrzny (po nim zamówienie jest rozpoznawane ponownie)
    data utworzeniaData zamówienia
    kwota zamówienia i koszt dostawyKwota dokumentu, cena dostawy
    e-mail i telefon klientaE-mail, telefon
    imię, nazwisko, nazwa firmyDane odbiorcy
    adres, kod pocztowy, miasto, region, krajAdres dostawy
    sposób dostawyRodzaj dostawy
    sposób płatnościRodzaj płatności (tabela poniżej)
    komentarz klientaOpis zamówienia
    pozycje: nazwa, cena, ilość, kwotaWiersze 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 CeneoRodzaj płatności w Elbuz
    szybki przelewPłatność online
    płatność przy odbiorzeZa pobraniem
    karta kredytowaKarta płatnicza
    przelew bezpośrednio na konto sklepuPrzelew bankowy
    raty, płatność dzielonaKarta 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.

    Nowa karta pojawia się tylko na dolnej gałęzi, gdy pozycja nie znalazła karty ani po identyfikatorze z feedu, ani po nazwie.
    taknietaknietaknienietakPozycja zamówienia CeneoIdentyfikator z feedu zgadza sięz UUID karty?Wiersz dokumentu powiązany zkartąCzy jest karta o takiej samejnazwie?Identyfikator z feedu zgadza sięz kodem karty w Elbuz?Czy jest kategoria techniczna„Produkty - ceneo - nazwaszablonu”?Kategoria powstaje jako wyłączonai z zakazem eksportuKategoria zostaje bez zmian:zgoda na eksport nie jest kasowanaNowa karta w kategorii technicznejz ceną i ilością z wiersza,jedna na każdą inną nazwę
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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.

    Dwie górne notatki pokazują, gdzie przebieg się kończy, zanim dojdzie do zamówień. Dalej w pętli po pozycjach i dostawie Elbuz przechodzi tylko przez zamówienia, których jeszcze nie ma w bazie.
    CeneoElbuzPole „Token” jest puste lub kliknięto zatrzymanie — przebieg kończy się przed zapytaniemBrak dostępu — błąd w dzienniku, przebieg się kończyDokument z tym identyfikatorem już jest — zamówienie jest pomijaneloop[Każde zamówienie ze strony]loop[Strony listy, dopóki przychodzą zamówienia, nie więcej niż 5000 na przebieg]Już pierwsza strona jest pusta lub połączenie się nie udało — przebieg kończy się bez zapisówJeśli są nowe zamówienia — dokumenty i klienci są zapisywani, punkt startowy przechodzi na najnowsze z nichKlucz z pola „Token”Tymczasowy dostępNastępna strona zamówień od daty minus 12 godzin, od najnowszychStrona odpowiedziPozycje zamówieniaDane dostawy
    • Запит або дія
    • Відповідь
    • 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.

    Rozwinięty blok „Zaawansowane” z polem daty początkowej zamówień
    1Import zamówień począwszy od daty (RRRR-MM-DD)
    1. 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ą

    Częste problemy i ich rozwiązania
    Co widziszDlaczego tak jestCo 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
    Karta „Połączenie” okna ustawień importu ceneo.pl
    1Pole „Token”
    1. Pole „Token” — klucz dostępu z Twojego panelu Ceneo.

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo