↑↓ wybierzEnter otwórzEsc zamknij

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

    Jak podłączyć Newegg do Elbuz: zamówienia, ceny i stany, nowe produkty

    5 min czytaniaZaktualizowano

    Elbuz łączy się z Twoim sklepem na Newegg (Newegg.com, Newegg.ca, Neweggbusiness.com) kluczami sprzedawcy: pobiera i potwierdza zamówienia, wiąże Twoje produkty po SKU i wysyła na platformę ceny, stany, nowe produkty i wysyłki.

    Kiedy to się przyda:

    • Zamówienia z Newegg chcesz obsługiwać w Elbuz — przychodzą jako dokumenty i są potwierdzane na platformie.
    • Ceny i stany liczysz w Elbuz — eksport wysyła je feedem.
    • Chcesz wystawić nowe produkty — Elbuz utworzy kartę albo ofertę na gotowej karcie Newegg.

    Od czego zacząć: wklej Seller ID i SecretKey do szablonu importu typu „Newegg (US, CA, Business)” i uruchom import katalogu.

    Co potrafi integracja z Newegg

    Co pobrać z Seller Portal

    Seller ID i SecretKey wydaje panel sprzedawcy Newegg (Seller Portal), gdy udzielasz dostępu integracji. Zapytania do Newegg są podpisywane również kluczem dewelopera: wpisz go w pole „Klucz dewelopera Newegg (API Key)”. Bez klucza import zatrzyma się z komunikatem „Newegg: brak Seller ID, SecretKey lub klucza dewelopera”.

    Karta „Połączenie” szablonu importu Newegg
    1Seller ID
    2SecretKey
    3Platforma
    4Magazyn stanów
    5Klucz dewelopera Newegg (API Key)
    1. Seller ID — identyfikator sprzedawcy z Seller Portal.
    2. SecretKey — tajny klucz sprzedawcy.
    3. Platforma — US, CA albo B2B; można wybrać z listy.
    4. Magazyn stanów — kod kraju magazynu, tylko Newegg.com.
    5. Klucz dewelopera Newegg (API Key) — klucz, którym podpisywane są zapytania do Newegg.
    Pole w szablonieCo wpisać
    Seller IDIdentyfikator sprzedawcy. Obowiązkowe
    SecretKey (tajny klucz sprzedawcy)Tajny klucz. Obowiązkowe
    PlatformaUS, CA albo B2B; przycisk „Wybierz z listy” wstawi kod. Puste — US
    Magazyn stanów Newegg.comTrzyliterowy kod kraju magazynu. Tylko dla Newegg.com; puste — USA
    Klucz dewelopera Newegg (API Key)Klucz dewelopera Newegg. Obowiązkowe

    Waluta platformy to dolary amerykańskie dla Newegg.com i Neweggbusiness.com oraz dolary kanadyjskie dla Newegg.ca. Elbuz nie przelicza cen.

    „Aktywny” i „Zamówienia” są w nowym szablonie już włączone: 5 minut po zapisaniu kluczy Elbuz zacznie pobierać zamówienia z 30 dni i potwierdzać je na platformie. Statusy platformy Elbuz sam dopasowuje do Twoich po nazwie; co przyszło i jak zostało dopasowane, widać w oknie „Statusy zamówienia” szablonu. Chcesz najpierw sprawdzić — odznacz „Zamówienia”.

    Opis metod, z których korzysta Elbuz: Newegg Marketplace API.

    Jak produkty wiążą się z Newegg

    Import katalogu nie tworzy produktów w Elbuz, tylko wiąże Twoje pozycje na Newegg z istniejącymi kartami. Newegg oddaje listę pozycji w raporcie stanów, w którym nie ma nazw — jest Twoje SKU (Seller Part #) i numer produktu Newegg. Elbuz szuka karty, której SKU zgadza się z Seller Part #, i zapamiętuje powiązanie.

    Platforma przygotowuje raport kilka minut. Elbuz zamawia go i czeka około minuty:

    Co jest w dziennikuCo to oznacza
    „Newegg: zamówiono raport stanów ‹numer›”Raport zamówiony
    „Newegg: raport ‹numer› jest jeszcze przygotowywany (‹stan›), wynik — przy następnym uruchomieniu”Minuta nie wystarczyła; kolejne uruchomienie pobierze ten sam raport
    „Newegg: pozycji w raporcie: N, połączono z produktami: M, nie znaleziono po SKU: K”Wynik. K większe od zera — w Elbuz nie ma kart z takimi SKU

    Pozycję, której nie znaleziono po SKU, Elbuz pomija. Wpisz w karcie SKU takie jak Seller Part # na Newegg i uruchom import ponownie.

    Jak przychodzą i są potwierdzane zamówienia

    Zamówienie trafia do systemu jako niezatwierdzony dokument „Zamówienie klienta”. Pierwszy import pobiera zamówienia z ostatnich 30 dni. Później — według daty zamówienia z zapasem 7 dni: Newegg nie ma filtra po dacie zmiany, a status starego zamówienia mógł się zmienić. Istniejące zamówienie Elbuz rozpoznaje po numerze i aktualizuje.

    Zamówienia Elbuz sam pobiera i potwierdza co 5 minut, jeśli w szablonie zaznaczono „Zamówienia” i wpisano klucze. Robi to wspólne zadanie „Zamówienia z marketplace’ów” w oknie „Harmonogram zadań”, tam też zmienisz interwał. Harmonogram szablonu (przycisk „Ustawienia harmonogramu”) jest potrzebny tylko do wiązania katalogu — ustaw go rzadko, na przykład w nocy: dopóki trwa, przebieg zamówień jest pomijany do następnego.

    Nowe zamówienie po zapisaniu w Elbuz jest potwierdzane na platformie jako odebrane przez sprzedawcę. Jeśli się nie uda — w dzienniku pojawi się „Newegg: zamówienie ‹numer› nie zostało potwierdzone — ‹przyczyna›”. Podsumowanie — „Newegg: pobrano zamówień: N, potwierdzono na platformie: M”.

    Kwota w zamówieniu NeweggJak trafia do dokumentu
    cena pozycjicena wiersza
    rabat na zamówienierozkłada się na ceny pozycji proporcjonalnie do kwoty
    dostawakoszt dostawy dokumentu
    podatek od sprzedażynie wchodzi do kwoty: pobiera go i odprowadza sama platforma

    Pozycje dokumentu wiążą się z produktami po Seller Part #. Anulowane pozycje nie trafiają do dokumentu, jeśli zamówienie ma inne.

    Statusy zamówienia

    Status platformy Elbuz sam dopasowuje do Twojego — po kodzie lub nazwie, a nierozpoznany trafia jako „Nowy”. Doprecyzujesz to przyciskiem „Statusy zamówienia” w karcie „Powiązane ustawienia” szablonu importu: w kolumnie „Kod (nazwa) na stronie (API)” obok swojego statusu wpisz status Newegg.

    Status NeweggCo oznacza
    UnshippedNiewysłane
    Partially ShippedWysłane częściowo
    ShippedWysłane
    InvoicedZafakturowane, zamknięte
    VoidedAnulowane

    Do wysyłania na platformę dopasowanie zapisuje się kodami SHIPPED i VOIDED — zob. wysyłka. Co dzieje się z zatwierdzonym zamówieniem i rezerwacją, opisuje artykuł import zamówień przez API.

    Jak ceny i stany wracają na Newegg

    Kierunek odwrotny to osobny szablon eksportu typu „Newegg (US, CA, Business)” z dwoma polami: Seller ID i SecretKey, tymi samymi co w szablonie importu. Platformę, magazyn i klucz dewelopera eksport bierze z szablonu importu z tym samym Seller ID.

    Karta „Połączenie” szablonu eksportu Newegg
    1Seller ID
    2SecretKey
    1. Seller ID — ten sam co w szablonie importu.
    2. SecretKey — ten sam tajny klucz.

    Aktualizowane są produkty powiązane z Newegg. Ceny i stany idą jednym feedem na uruchomienie — do 10 000 wierszy w pliku; dla Newegg.com cena i stan idą dwoma feedami. Platforma przetwarza feed kilka minut:

    Co jest w dziennikuCo to oznacza
    „Newegg: wysłano feed ‹numer› (‹typ›), wierszy: N”Feed trafił na platformę
    „Newegg: feed ‹numer› jest jeszcze przetwarzany (‹stan›), wynik — przy następnym uruchomieniu”Wynik pobierze kolejne uruchomienie
    „Newegg: feed ‹numer› przetworzony — sukces: N, błędów: M”Wynik feedu
    „Newegg: «‹nazwa›» (‹SKU›) odrzucono: ‹przyczyna›”Platforma nie przyjęła wiersza

    Limit feedów w Newegg liczony jest na godzinę, więc eksport raz na godzinę lub rzadziej to rozsądny harmonogram. Po odmowie z powodu limitu Elbuz czeka i powtarza; jeśli to nie pomoże — „Newegg: przekroczono limit zapytań platformy, spróbuj później”.

    Nowe produkty na Newegg

    Feed nowych produktów zawiera do 3 000 wierszy, w jednym uruchomieniu idzie do 5 feedów; reszta pójdzie przy kolejnym uruchomieniu.

    Przy zaznaczonym polu „Publikuj nowe produkty” produkt bez powiązania trafia na Newegg feedem nowych produktów. Co dokładnie powstaje, zależy od tego, czy kategoria produktu jest dopasowana do podkategorii Newegg (zakładka Newegg w oknie dopasowania):

    Kategoria produktuCo tworzy ElbuzCzego potrzebuje produkt
    dopasowana do podkategorii Neweggnową kartę Neweggnazwa, krótki i pełny opis, waga, zdjęcia (do 7) i obowiązkowe właściwości podkategorii
    niedopasowanaofertę na gotowej karcie Neweggkod kreskowy UPC/EAN albo kod producenta (MPN)

    W obu przypadkach potrzebne są SKU (stanie się Seller Part #, do 40 znaków, bez powtórzeń), producent zarejestrowany na Newegg oraz UPC/EAN albo MPN. Produkt idzie jako nowy, cena i stan — z szablonu eksportu.

    Obowiązkowe właściwości podkategorii Elbuz bierze z atrybutów produktu o tej samej nazwie: właściwość „Costume_Brand” znajdzie atrybut „Costume Brand” albo „Brand”, a markę — z producenta produktu. Wartości, których produkt nie ma, Elbuz nie wymyśla.

    Co widzisz w dzienniku

    • Czegoś brakuje — „Newegg: «‹nazwa›» — karty nie utworzono, brakuje: ‹pola›”. Taki produkt Elbuz ponowi po dobie: w tym czasie uzupełnij brakujące dane.
    • Dopóki platforma przetwarza nowy produkt, kolejne uruchomienia go pomijają: „Newegg: nowe produkty są jeszcze przetwarzane przez platformę: N”.
    • Przyjęto — „Newegg: produkt «‹nazwa›» (‹SKU›) wystawiono na sprzedaż”, produkt jest powiązany.
    • Na uruchomienie — do pięciu feedów nowych produktów; reszta — „Newegg: wyczerpano limit feedów kart na uruchomienie, pozostałe produkty (N) — przy następnym uruchomieniu”.

    Wysyłka i anulowanie

    Pole „Zamówienia” w szablonie eksportu przekazuje na Newegg dwa zdarzenia:

    Twój status dopasowany doCo wysyła Elbuz
    SHIPPEDWysyłkę wszystkich jeszcze niewysłanych pozycji jedną paczką z numerem przesyłki i przewoźnikiem
    VOIDEDAnulowanie z przyczyną Unable to fulfill order (nie można zrealizować zamówienia)
    • Numer przesyłki — pole „Numer listu przewozowego” w karcie „Dostawa” dokumentu (rozwiń „Więcej pól”). Puste — „Newegg: zamówienie ‹numer› nie ma numeru przesyłki”.
    • Przewoźnik — kod przewoźnika Newegg (UPS, FedEx, USPS…) dopasowany do firmy kurierskiej przyciskiem „Rodzaje dostawy” szablonu importu. Bez dopasowania — „Newegg: zamówienie ‹numer› — dopasuj metodę dostawy do przewoźnika Newegg w ustawieniach dostawy szablonu”.

    Każde zdarzenie jest wysyłane raz. Zamówienia, które na platformie są już wysłane, zamknięte lub anulowane, nie są wysyłane. W dzienniku — „Newegg: zamówienie ‹numer› → SHIPPED” i podsumowanie „Newegg: przekazano statusów zamówień: N, błędów: M”.

    Scenariusze

    Podłączyć sklep, który już sprzedaje na Newegg

    Co włączyć. Szablon importu z kluczami i zaznaczonymi polami „Produkty” i „Zamówienia”. Upewnij się, że SKU kart w Elbuz zgadzają się z Seller Part # na Newegg, i uruchom import dwa razy w odstępie kilku minut, aby pobrać gotowy raport.

    Efekt. Pozycje Newegg są powiązane z Twoimi kartami, a zamówienia same przychodzą jako dokumenty co 5 minut. Dalej szablon eksportu z zaznaczonym polem „Produkty” aktualizuje ceny i stany, a z polem „Zamówienia” — przekazuje wysyłki.

    Wystawić nowe produkty

    Co włączyć. Dla własnych produktów — dopasuj kategorie do podkategorii Newegg i dodaj atrybuty o nazwach obowiązkowych właściwości. Dla produktów, które już są sprzedawane na Newegg, wystarczy kod kreskowy lub MPN. W szablonie eksportu — „Publikuj nowe produkty”.

    Efekt. Produkty z kompletnymi danymi trafią na Newegg, a dla reszty dziennik pokaże, czego brakuje, i Elbuz ponowi próbę po dobie.

    Co zrobić, gdy Newegg nie oddaje lub nie przyjmuje danych

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    „Newegg: brak Seller ID, SecretKey lub klucza dewelopera” Puste jedno z trzech pól Wypełnij pola szablonu importu (co pobrać z Seller Portal)
    „…nie znaleziono po SKU: K” W Elbuz nie ma kart z SKU takim jak Seller Part # na Newegg Wpisz SKU i powtórz import (wiązanie)
    „…jest jeszcze przygotowywany…” albo „…jest jeszcze przetwarzany…” Platforma nie zdążyła w ciągu minuty Nic: wynik pobierze kolejne uruchomienie
    „Newegg: «…» — karty nie utworzono, brakuje: …” Produkt nie ma wymaganych pól Uzupełnij pola z listy; Elbuz ponowi próbę po dobie (nowe produkty)
    „…dopasuj metodę dostawy do przewoźnika Newegg…” Firma kurierska dokumentu nie ma kodu przewoźnika Newegg Dopasuj ją przyciskiem „Rodzaje dostawy” szablonu importu (wysyłka)

    Najczęstsze pytania

    Po imporcie katalogu w Elbuz nie pojawiły się nowe produkty — dlaczego?

    Raport Newegg nie zawiera nazw, więc Elbuz nie tworzy produktów, tylko wiąże istniejące po SKU (wiązanie).

    Dlaczego kwota zamówienia jest niższa, niż zapłacił klient?

    Podatek od sprzedaży pobiera i odprowadza sama Newegg, więc nie wchodzi on do kwoty dokumentu (zamówienia).

    Sprzedaję w USA i Kanadzie — jeden szablon czy dwa?

    Dwa: każda platforma ma własne klucze i walutę (gdzie to jest).

    Mój produkt sprzedają już inni na Newegg — czy trzeba go opisywać od nowa?

    Nie. Nie dopasowuj jego kategorii do podkategorii Newegg — Elbuz wystawi ofertę na gotowej karcie po kodzie kreskowym albo MPN (nowe produkty).

    Ceny w katalogu są w złotych — co trafi na Newegg?

    Ta sama liczba, bez przeliczania. Ceny w wyniku filtrowania szablonu eksportu muszą być w dolarach platformy (waluta).

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Import danych → nowy szablon typu „Newegg (US, CA, Business)”
    Inne wejścia
    Słowniki → Operacje → Eksport danych — szablon tego samego typu; podkategorie — okno dopasowania do marketplace’ów
    Uprawnienia
    okno „Import danych” w „Uprawnieniach grup”
    Przygotuj
    Seller ID, SecretKey i klucz dewelopera Newegg

    Jeden szablon — jedna platforma. Sprzedajesz i na Newegg.com, i na Newegg.ca — utwórz dwa szablony z kluczami każdej platformy.

    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