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
- Trzy platformy — Newegg.com (USA), Newegg.ca (Kanada), Neweggbusiness.com (B2B), po jednym szablonie na każdą.
- Wiązanie produktów — Twoje pozycje na Newegg łączą się z kartami Elbuz po SKU.
- Zamówienia z potwierdzeniem — nowe zamówienia są oznaczane na platformie jako odebrane.
- Ceny i stany feedem — wynik przetwarzania w dzienniku.
- Nowe produkty — karta z obowiązkowymi właściwościami podkategorii albo oferta na gotowej karcie.
- Wysyłka i anulowanie — Twoim statusem zamówienia.
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”.
1
Seller ID2
SecretKey3
Platforma4
Magazyn stanów5
Klucz dewelopera Newegg (API Key)- Seller ID — identyfikator sprzedawcy z Seller Portal.
- SecretKey — tajny klucz sprzedawcy.
- Platforma — US, CA albo B2B; można wybrać z listy.
- Magazyn stanów — kod kraju magazynu, tylko Newegg.com.
- Klucz dewelopera Newegg (API Key) — klucz, którym podpisywane są zapytania do Newegg.
| Pole w szablonie | Co wpisać |
|---|---|
| Seller ID | Identyfikator sprzedawcy. Obowiązkowe |
| SecretKey (tajny klucz sprzedawcy) | Tajny klucz. Obowiązkowe |
| Platforma | US, CA albo B2B; przycisk „Wybierz z listy” wstawi kod. Puste — US |
| Magazyn stanów Newegg.com | Trzyliterowy 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 dzienniku | Co 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 Newegg | Jak trafia do dokumentu |
|---|---|
| cena pozycji | cena wiersza |
| rabat na zamówienie | rozkłada się na ceny pozycji proporcjonalnie do kwoty |
| dostawa | koszt dostawy dokumentu |
| podatek od sprzedaży | nie 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 Newegg | Co oznacza |
|---|---|
Unshipped | Niewysłane |
Partially Shipped | Wysłane częściowo |
Shipped | Wysłane |
Invoiced | Zafakturowane, zamknięte |
Voided | Anulowane |
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.
1
Seller ID2
SecretKey- Seller ID — ten sam co w szablonie importu.
- 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 dzienniku | Co 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 produktu | Co tworzy Elbuz | Czego potrzebuje produkt |
|---|---|---|
| dopasowana do podkategorii Newegg | nową kartę Newegg | nazwa, krótki i pełny opis, waga, zdjęcia (do 7) i obowiązkowe właściwości podkategorii |
| niedopasowana | ofertę na gotowej karcie Newegg | kod 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 do | Co wysyła Elbuz |
|---|---|
SHIPPED | Wysyłkę wszystkich jeszcze niewysłanych pozycji jedną paczką z numerem przesyłki i przewoźnikiem |
VOIDED | Anulowanie 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
| Co widzisz | Dlaczego tak jest | Co 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
- Jeśli chcesz dopasować kategorie do podkategorii Newegg: dopasowanie kategorii do marketplace’ów.
- Jeśli menedżer prowadzi zamówienia w Elbuz i ważne jest, co nadpisze przebieg: import zamówień przez API.
- Jeśli sprzedajesz też na Walmart lub Amazonie: integracja z Walmart, integracja z Amazon.
