Elbuz підключається до вашого магазину на Newegg (Newegg.com, Newegg.ca, Neweggbusiness.com) ключами продавця: забирає й підтверджує замовлення, прив'язує ваші товари за артикулом і відправляє на площадку ціни, залишки, нові товари й відвантаження.
Коли це знадобиться:
- Замовлення Newegg треба обробляти в Elbuz — вони приходять документами й підтверджуються на площадці.
- Ціни й залишки рахуєте в Elbuz — вивантаження відправляє їх фідом.
- Хочете виставити нові товари — Elbuz створить картку або пропозицію на готову картку Newegg.
З чого почати: вставте Seller ID і SecretKey у шаблон завантаження типу «Newegg» і запустіть завантаження каталогу.
Що вміє підключення Newegg
- Три площадки — Newegg.com (США), Newegg.ca (Канада), Neweggbusiness.com (B2B), по шаблону на кожну.
- Прив'язка товарів — ваші позиції на Newegg з'єднуються з картками Elbuz за артикулом.
- Замовлення з підтвердженням — нові замовлення позначаються на площадці отриманими.
- Ціни й залишки фідом — результат обробки в журналі.
- Нові товари — картка з обов'язковими властивостями підкатегорії або пропозиція на готову картку.
- Відвантаження й скасування — вашим статусом замовлення.
Де це і хто має доступ
- Меню
- Довідники → Операції → Завантаження даних → новий шаблон типу «Newegg»
- Інші входи
- Довідники → Операції → Вивантаження даних — шаблон того самого типу; підкатегорії — вікно зіставлення з маркетплейсами
- Право доступу
- вікно «Завантаження» у «Правах груп»
- Підготувати
- Seller ID, SecretKey і ключ розробника Newegg
Один шаблон — одна площадка. Продаєте і на Newegg.com, і на Newegg.ca — заведіть два шаблони з ключами кожної площадки.
Що взяти в Seller Portal
Seller ID і SecretKey видає кабінет продавця Newegg (Seller Portal), коли ви надаєте доступ інтеграції. Запити до Newegg підписуються ще й ключем розробника: впишіть його в поле «Власний ключ розробника». Без ключа завантаження зупиниться з повідомленням «Newegg: немає Seller ID, SecretKey або ключа розробника».
1
Seller ID2
SecretKey3
Площадка4
Склад залишків5
Власний ключ розробника- Seller ID — ідентифікатор продавця з Seller Portal.
- SecretKey — секретний ключ продавця.
- Площадка — US, CA або B2B; підставляється кнопкою «Обрати зі списку».
- Склад залишків — код країни складу, лише для Newegg.com.
- Власний ключ розробника — ключ, яким підписуються запити до Newegg.
| Поле у шаблоні | Що вписати |
|---|---|
| Seller ID | Ідентифікатор продавця. Обов'язкове |
| SecretKey (секретний ключ продавця) | Секретний ключ. Обов'язкове |
| Площадка | US, CA або B2B; кнопка «Обрати зі списку» підставить код. Порожньо — US |
| Склад залишків Newegg.com | Код країни складу з трьох літер. Лише для Newegg.com; порожньо — USA |
| Власний ключ розробника | Ключ розробника Newegg |
Валюта площадки — долари США для Newegg.com і Neweggbusiness.com, канадські долари для Newegg.ca. Ціни Elbuz не перераховує.
Опис методів, якими користується Elbuz: Newegg Marketplace API.
Як товари прив'язуються до Newegg
Завантаження каталогу не створює товарів в Elbuz, а лише прив'язує ваші позиції на Newegg до наявних карток. Newegg віддає перелік позицій звітом про залишки, у якому немає назв, — є ваш артикул (Seller Part #) і номер товару Newegg. Elbuz шукає картку, у якої артикул збігається з Seller Part #, і запам'ятовує зв'язок.
Звіт площадка готує кілька хвилин. Elbuz замовляє його й близько хвилини чекає:
| Що в журналі | Що це означає |
|---|---|
| «Newegg: замовлено звіт про залишки ‹номер›» | Звіт замовлено |
| «Newegg: звіт ‹номер› ще готується (‹стан›), результат — наступним запуском» | Хвилини не вистачило; наступний запуск забере той самий звіт |
| «Newegg: позицій у звіті: N, прив'язано до товарів: M, не знайдено за артикулом: K» | Результат. K більше нуля — у Elbuz немає карток із такими артикулами |
Позицію, не знайдену за артикулом, Elbuz пропускає. Впишіть картці артикул, як Seller Part # на Newegg, і запустіть завантаження ще раз.
Як приходять і підтверджуються замовлення
Замовлення лягає документом «Замовлення покупця», непроведеним. Перше завантаження бере замовлення за останні 30 днів. Далі — за датою замовлення з запасом у 7 днів: фільтра за датою зміни в Newegg немає, а статус старого замовлення міг змінитися. Наявне замовлення впізнається за номером і оновлюється.
Нове замовлення, після того як воно збереглося в Elbuz, підтверджується на площадці як отримане продавцем. Не вдалося — у журналі «Newegg: замовлення ‹номер› не підтверджено — ‹причина›». Підсумок — «Newegg: замовлень завантажено: N, підтверджено на площадці: M».
| Сума в замовленні Newegg | Як лягає в документ |
|---|---|
| ціна позиції | ціна рядка |
| знижка замовлення | розкладається на ціни позицій пропорційно сумі |
| доставка | вартість доставки документа |
| податок з продажу | не входить у суму: його збирає й сплачує сама площадка |
Позиції документа прив'язуються до товарів за Seller Part #. Скасовані позиції в документ не потрапляють, якщо в замовленні є інші.
Статуси замовлення
Статус площадки зіставляється з вашим кнопкою «Статуси замовлення» в картці «Повʼязані налаштування» шаблону завантаження: у колонку «Код (назва) на сайті (API)» навпроти свого статусу впишіть статус Newegg.
| Статус Newegg | Що означає |
|---|---|
Unshipped | Не відправлене |
Partially Shipped | Відправлене частково |
Shipped | Відправлене |
Invoiced | Виставлено рахунок, закрите |
Voided | Скасоване |
Для відправки на площадку зіставлення пишуть кодами SHIPPED і VOIDED — див. відвантаження. Що відбувається з проведеним замовленням і резервом, описано в статті імпорт замовлень через API.
Як ціни й залишки повертаються на Newegg
Зворотний напрямок — окремий шаблон вивантаження типу «Newegg» з двома полями: Seller ID і SecretKey, ті самі, що в шаблоні завантаження. Площадку, склад і ключ розробника вивантаження бере з шаблону завантаження з тим самим Seller ID.
1
Seller ID2
SecretKey- Seller ID — той самий, що в шаблоні завантаження.
- SecretKey — той самий секретний ключ.
Оновлюються товари, прив'язані до Newegg. Ціни й залишки йдуть одним фідом на запуск — до 10 000 рядків у файлі; для Newegg.com ціна й залишок ідуть двома фідами. Площадка обробляє фід кілька хвилин:
| Що в журналі | Що це означає |
|---|---|
| «Newegg: надіслано фід ‹номер› (‹тип›), рядків: N» | Фід пішов на площадку |
| «Newegg: фід ‹номер› ще обробляється (‹стан›), результат — наступним запуском» | Результат забере наступний запуск |
| «Newegg: фід ‹номер› оброблено — успішно: N, помилок: M» | Результат фіду |
| «Newegg: «‹назва›» (‹артикул›) відхилено: ‹причина›» | Площадка не прийняла рядок |
Ліміт фідів у Newegg рахується на годину, тому вивантаження раз на годину чи рідше — розумний розклад. На відмову через ліміт Elbuz чекає й повторює; не допомогло — «Newegg: перевищено ліміт запитів площадки, повторіть пізніше».
Нові товари на Newegg
З галочкою «Публікувати нові товари» товар без прив'язки йде на Newegg фідом нових товарів. Що саме створюється, залежить від того, чи зіставлено категорію товару з підкатегорією Newegg (вкладка Newegg у вікні зіставлення):
| Категорію товару | Що створює Elbuz | Що потрібно товару |
|---|---|---|
| зіставлено з підкатегорією Newegg | нову картку Newegg | назва, короткий і повний опис, вага, фото (до 7) і обов'язкові властивості підкатегорії |
| не зіставлено | пропозицію на готову картку Newegg | штрихкод UPC/EAN або код виробника (MPN) |
В обох випадках потрібні артикул (він стане Seller Part #, до 40 символів, без повторів), виробник, заведений на Newegg, і UPC/EAN або MPN. Товар іде як новий, ціна й залишок — із шаблону вивантаження.
Обов'язкові властивості підкатегорії Elbuz бере з атрибутів товару з тією самою назвою: властивість «Costume_Brand» знайде атрибут «Costume Brand» або «Brand», бренд — виробника товару. Значень, яких немає в товарі, Elbuz не вигадує.
Що бачите в журналі
- Чогось бракує — «Newegg: «‹назва›» — картку не створено, не вистачає: ‹поля›». Такий товар Elbuz повторить через добу: за цей час допишіть потрібне.
- Поки площадка обробляє новий товар, наступні запуски його пропускають: «Newegg: нові товари ще обробляються площадкою: N».
- Прийнято — «Newegg: товар «‹назва›» (‹артикул›) виставлено на продаж», товар прив'язано.
- За запуск — до п'яти фідів нових товарів; решта — «Newegg: ліміт фідів карток на запуск вичерпано, решта товарів (N) — наступним запуском».
Відвантаження й скасування
Галочка «Замовлення» в шаблоні вивантаження передає на Newegg дві події:
| Ваш статус зіставлено з | Що відправляє Elbuz |
|---|---|
SHIPPED | Відвантаження всіх ще не відправлених позицій однією посилкою з трек-номером і перевізником |
VOIDED | Скасування з причиною «неможливо виконати замовлення» |
- Трек-номер — поле «Сервіс доставки: номер» у картці «Доставка» документа (розгорніть «Більше полів»). Порожнє — «Newegg: у замовленні ‹номер› немає номера відправлення».
- Перевізник — код перевізника Newegg (UPS, FedEx, USPS…), зіставлений зі службою доставки кнопкою «Види доставки» шаблону завантаження. Без зіставлення — «Newegg: замовлення ‹номер› — зіставте службу доставки з перевізником Newegg у налаштуваннях доставки шаблону».
Кожна подія відправляється один раз. Замовлення, які на площадці вже відправлені, закриті чи скасовані, не відправляються. У журналі — «Newegg: замовлення ‹номер› → SHIPPED» і підсумок «Newegg: статусів замовлень передано: N, помилок: M».
Сценарії
Підключити магазин, який уже торгує на Newegg
Що ввімкнути. Шаблон завантаження з ключами й галочками «Товари» й «Замовлення». Переконайтеся, що артикули карток Elbuz збігаються з Seller Part # на Newegg, і запустіть завантаження двічі з перервою кілька хвилин, щоб забрати готовий звіт.
Що вийде. Позиції Newegg прив'язано до ваших карток, замовлення приходять документами. Далі шаблон вивантаження з галочкою «Товари» оновлює ціни й залишки, а з галочкою «Замовлення» — передає відвантаження.
Виставити нові товари
Що ввімкнути. Для власних товарів — зіставте категорії з підкатегоріями Newegg і додайте атрибути з назвами обов'язкових властивостей. Для товарів, які вже продаються на Newegg, достатньо штрихкоду чи MPN. У шаблоні вивантаження — «Публікувати нові товари».
Що вийде. Товари з повними даними підуть на Newegg, решта — переліком того, чого бракує, у журналі й повтором через добу.
Що робити, коли Newegg не віддає чи не приймає дані
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Newegg: немає Seller ID, SecretKey або ключа розробника» | Порожнє одне з трьох полів | Заповніть поля шаблону завантаження (що взяти в Seller Portal) |
| «…не знайдено за артикулом: K» | У Elbuz немає карток з артикулом, як Seller Part # на Newegg | Впишіть артикули й повторіть завантаження (прив'язка) |
| «…ще готується…» або «…ще обробляється…» | Площадка не встигла за хвилину | Нічого: результат забере наступний запуск |
| «Newegg: «…» — картку не створено, не вистачає: …» | У товару немає потрібних полів | Допишіть поля з переліку; Elbuz повторить через добу (нові товари) |
| «…зіставте службу доставки з перевізником Newegg…» | Служба доставки документа без коду перевізника Newegg | Зіставте її кнопкою «Види доставки» шаблону завантаження (відвантаження) |
Часті запитання
Запустив завантаження каталогу, а нових товарів в Elbuz не з'явилося — чому?
Звіт Newegg не містить назв, тому Elbuz товарів не створює, а лише прив'язує наявні за артикулом (прив'язка).
Чому сума замовлення менша, ніж заплатив покупець?
Податок з продажу збирає й сплачує сама Newegg, тому в суму документа він не входить (замовлення).
Продаю в США й Канаді — один шаблон чи два?
Два: у кожної площадки свої ключі й валюта (де це).
Мій товар уже продають інші на Newegg — чи треба описувати його заново?
Ні. Не зіставляйте його категорію з підкатегорією Newegg — Elbuz виставить пропозицію на готову картку за штрихкодом або MPN (нові товари).
Ціни в каталозі в гривнях — що піде на Newegg?
Те саме число, без перерахунку. Ціни у відборі шаблону вивантаження мають бути в доларах площадки (валюта).
Суміжні теми
- Якщо треба зіставити категорії з підкатегоріями Newegg: зіставлення категорій з маркетплейсами.
- Якщо менеджер веде замовлення в Elbuz і важливо, що перезапише прогін: імпорт замовлень через API.
- Якщо продаєте ще й на Walmart чи Amazon: підключення Walmart, підключення Amazon.