Як підключити Walmart до Elbuz: товари, замовлення й ціни фідами

Що вміє підключення Walmart

• Підключення своїми ключами — Client ID і Client Secret з Developer Portal.
• Завантаження товарів — назва, артикул (SKU), штрихкод, ціна, залишок, категорія.
• Замовлення — за останні 30 днів при першому запуску, далі лише зміни; нові підтверджуються на Walmart автоматично.
• Ціни й залишки назад на Walmart — одним фідом на прогін або окремими запитами, якщо товарів мало.
• Нові товари — офер на наявну картку за GTINЗагальна назва номерів штрихкодів товару — EAN, UPC та інших. Маркетплейси й Google за ним упізнають товар. або нова картка за зіставленим типом товару Walmart.

Де це і хто має доступ

Меню

Довідники → Операції → Завантаження даних → новий шаблон типу «Walmart»

Інші входи

Довідники → Операції → Вивантаження даних — шаблон для цін, залишків і новинок

Право доступу

вікно «Завантаження даних» у «Правах груп»

Підготувати

акаунт продавця Walmart Marketplace (США), Client ID і Client Secret

Один шаблон — один акаунт продавця. Ключі шаблону завантаження й шаблону вивантаження вставляються окремо, у кожен свої поля.

Де взяти ключі Walmart

Ключі API продавець створює сам у Walmart Developer Portal. Інтерфейс порталу лише англійською, тому назви пунктів нижче — англійські.

1. Відкрийте developer.walmart.com і увійдіть обліковим записом Seller Center.
2. Перейдіть у розділ API Keys (керування ключами) і виберіть ключі для робочого середовища — Production Keys.
3. Скопіюйте Client ID і Client Secret. Secret показується повністю тільки під час створення або скидання ключа.
4. У шаблоні «Walmart» вставте Client ID у поле «Client ID», а Client Secret — у поле «Client Secret». Збережіть шаблон.
5. Натисніть «Перевірити підключення». Якщо ключі правильні, з'явиться «Підключення працює. Walmart US».

1

Поле «Client ID»

2

Поле «Client Secret»

1. Поле «Client ID» — сюди вставляють Client ID з Developer Portal.
2. Поле «Client Secret» — секретна половина ключа, після збереження вона прихована.

Ключі з тестового середовища Walmart (Sandbox) до робочого кабінету не підходять: Elbuz звертається до робочого Marketplace API. Скинули чи перевипустили Client Secret у порталі — вставте новий у шаблон завантаження й у шаблон вивантаження, інакше обидва зупиняться з помилкою авторизації.

Що приходить у каталог

Elbuz забирає список ваших товарів на Walmart сторінками по тисячі, потім окремо питає залишок кожного SKU. Кожен товар лягає в каталог карткою і прив'язується до SKU — за цим ключем потім їздять ціни й залишки.

Опису, виробника, характеристик і фото Walmart у списку товарів не віддає. Галочки «Фото», «Виробники» й «Атрибути» в шаблоні Walmart нічого не додають. Заповніть ці поля в Elbuz або підтягніть з іншого джерела, наприклад з прайсу постачальника.

Ціна приходить у доларах і лягає в поле «Ціна» як є. Якщо основна валюта каталогу не долар, у картці опиниться доларова сума без позначки валюти.

Категорії

Полиця Walmart — це шлях, наприклад «Home / Kitchen». Elbuz шукає в дереві категорію з такою назвою, починаючи з найглибшої, і, якщо не знайшов, створює гілку «Home» → «Kitchen». Товар без полиці отримує категорію за назвою типу товару Walmart.

Товари зовсім без категорії лягають у службову «Товари - walmart». Вона створюється вимкненою й без участі у вивантаженнях, тож ці товари нікуди не поїдуть, доки ви не розкладете їх по своїх категоріях. Як безпечно прибрати службову категорію: службові категорії та бренди.

Що перезапише повторний прогін

Свою картку повторне завантаження знаходить за SKU: прив'язку Elbuz запам'ятав на першому прогоні. Товар, якого ще немає серед прив'язаних, шукається за назвою, і лише потім заводиться новий.

Виправили назву в Elbuz — наступний прогін каталогу поверне назву Walmart. Окремої галочки «не оновлювати назву» в шаблоні Walmart немає. Щоб назви площадки не приходили, є два шляхи:

• увімкніть перемикач «Не оновлювати» в картці товару, група «Захист під час імпорту», — прогін не змінить у картці нічого;
• після першого завантаження зніміть галочку «Товари» й лишіть тільки «Замовлення» — прив'язки до SKU збережуться.

Ціну від перезапису закриває перемикач «Фіксована ціна» в тій самій групі: решта полів оновлюється, ціна лишається вашою.

Товару, якого в прогоні не було, завантаження не торкається: він лишається з останньою ціною й залишком і не видаляється. Зняті з продажу позиції прибирайте руками.

Як приходять і підтверджуються замовлення

Перший прогін забирає замовлення, створені за останні 30 днів. Далі Elbuz бере лише змінене з минулого запуску, із запасом у дванадцять годин. Замовлення впізнається за номером Walmart (purchase order) і оновлюється, а не дублюється.

У документ «Замовлення покупця» потрапляють:

• номер замовлення покупця, дати створення й останньої зміни, статус Walmart;
• ім'я та прізвище отримувача, телефон, пошта покупця — це адреса-посередник Walmart, листи на неї пересилаються покупцю;
• адреса доставки — вулиця, місто, штат, індекс, країна;
• спосіб доставки Walmart (наприклад, Standard чи Express) — у полі «Сервіс доставки»;
• позиції за SKU з ціною й кількістю, валюта USD.

Автоматичне підтвердження на Walmart

Нове замовлення на Walmart має статус Created і чекає підтвердження продавця. Elbuz підтверджує такі замовлення сам, одразу після збереження в базі — тому підтвердженим ніколи не стане замовлення, яке не записалося.

У журналі підсумок виглядає так: «Walmart: замовлень завантажено: 12 (підтверджено на Walmart: 3)». Перше число — усі замовлення прогону, друге — нові, підтверджені саме зараз.

Статуси

Статус приходить кодом Walmart: Created, Acknowledged, Shipped, Delivered, Cancelled. Зіставте коди зі своїми статусами кнопкою «Статуси замовлення» в картці «Повʼязані налаштування». Без зіставлення нове замовлення лягає з першим статусом довідника, а наявному документу статус не змінюється.

1

Кнопка «Статуси замовлення»

2

Кнопка «Налаштування розкладу»

1. Кнопка «Статуси замовлення» — зіставлення статусів Walmart зі своїми.
2. Кнопка «Налаштування розкладу» — автоматичний запуск завантаження за розкладом.

Решта правил повторного прогону спільна з іншими майданчиками: ваш статус змінюється лише тоді, коли змінився статус на Walmart, адреса й позиції пишуться один раз, у проведений документ прогін не пише. Детальніше: що робить повторний прогін із замовленням. Резерв під замовлення з'являється після проведення документа (замовлення, залишок і резерв).

Як ціни й залишки повертаються на Walmart

Зворотний напрямок — окремий шаблон вивантаження типу «Walmart» з галочкою «Товари» в картці «Що вивантажувати». Ключі вставляються в його поля «Client ID» і «Client Secret». SKU товару Elbuz знає з завантаження каталогу, тому спершу один раз завантажте каталог з Walmart, потім налаштовуйте вивантаження.

Годинний ліміт фідів

Walmart приймає оновлення цін і залишків фідами — файлами з багатьма товарами — і дозволяє приблизно 10 таких фідів на годину. Тому Elbuz діє так:

Фід Walmart обробляє не одразу. Elbuz чекає результат близько 15 секунд. Не дочекався — у журналі рядок «фід … ще обробляється … результат заберемо під час наступного вивантаження», і наступний запуск спершу дочитає цей фід, а потім надішле новий.

Запускайте вивантаження Walmart не частіше ніж раз на 10 хвилин. Частіші запуски вичерпають ліміт, і новий фід Walmart відхилить. Нічого не втрачається: наступне вивантаження надішле актуальні ціни й залишки.

Ціна, валюта й націнка

Elbuz надсилає ціну як долари, округлену до центів, без перерахунку валюти. Ціна в гривнях чи євро поїде на Walmart тією самою цифрою, але в доларах.

Якщо каталог веде ціни не в USD, задайте поле ціни шаблону вивантаження формулою з курсом долара й потрібною націнкою — кнопка «Налаштування вивантаження полів» у картці «Повʼязані налаштування» шаблону вивантаження. У формулі доступний курс будь-якої валюти з довідника валют.

Залишок іде цілим числом, від'ємний — як нуль. Два товари з однаковим SKU в одному прогоні Walmart не приймає: другий пропускається з рядком «SKU … уже надіслано іншим товаром».

Знімати чи видаляти товари з Walmart Elbuz не вміє: товар, що випав із відбору шаблону, просто перестане отримувати оновлення. Щоб зупинити продаж, поставте нульовий залишок і дочекайтеся вивантаження або зніміть товар у Seller Center.

Публікація нових товарів

З галочкою «Публікувати нові товари» шаблон вивантаження виставляє на Walmart товари, які ще не прив'язані до SKU. Обов'язковий штрихкод: GTIN, EAN або UPC не коротший за 8 цифр. SKU на Walmart стає ваш «Артикул (SKU)», а якщо його немає — ID товару в Elbuz.

Що саме створиться, залежить від категорії товару:

Тип товару задається у вікні «Зіставлення категорій та атрибутів з маркетплейсами» (Довідники → Категорії → плитка «Зіставлення з маркетплейсами») на вкладці-чипі «Walmart», колонка «Тип товару Walmart». Довідник типів завантажується кнопкою «Завантажити довідник майданчика», коли в шаблоні завантаження Walmart уже є ключі. Загальні правила вікна: зіставлення категорій з маркетплейсами.

1

Чип «Walmart»

2

Колонка «Тип товару Walmart»

3

Заповнений тип у рядку категорії

1. Чип «Walmart» — показує колонки лише цього майданчика.
2. Колонка «Тип товару Walmart» — від неї залежить, чи піде нова картка.
3. Заповнений тип у рядку категорії: Home & Garden > Kitchen Appliances > Electric Kettles.

• Вага береться з поля «Вага» з урахуванням одиниці (кілограми чи грами) і перераховується у фунти — Walmart читає вагу у фунтах. Порожня вага — 1 фунт.
• Стан береться з поля «Стан товару»: «Новий» і «Уцінка» — новий, «Вживаний» — вживаний, «Відновлений» — відновлений.
• Кожен товар публікується окремою карткою, без об'єднання у варіації за кольором чи розміром.

Коли з'явиться результат

Публікація теж іде фідом, тож результат часто приходить лише з наступним вивантаженням. Товар прив'язується до SKU, тільки коли Walmart прийняв позицію; поки фід обробляється, повторно товар не надсилається. Підсумок у журналі: «Walmart: опубліковано нових товарів: N (помилок: M)».

Позицію, яку Walmart відхилив (найчастіше — не знайшов картку за GTIN), Elbuz повторює не частіше ніж раз на добу. Виправили штрихкод чи зіставили категорію — товар поїде на першому вивантаженні, коли мине доба.

Розклад і межі одного прогону

Миттєвих сповіщень Walmart не надсилає: Elbuz сам звертається до майданчика за розкладом, який задає кнопка «Налаштування розкладу». Орієнтир — замовлення кілька разів на годину, каталог раз на добу, вивантаження цін і залишків — не частіше ніж раз на 10 хвилин.

Пілюля «Активний» / «Вимкнений» знімає шаблон із розкладу, як і в інших джерел (вимкнути шаблон). Вивантаження — окремий шаблон зі своїм перемикачем.

Найдовше вантажиться каталог: на кожен SKU — окремий запит залишку. Скільки це триває у вас, показують колонка «Витрачено часу» у списку шаблонів і «Історія запусків» у шапці картки шаблону. Повтор обірваного прогону безпечний: товар знаходиться за SKU, замовлення за номером (якщо прогін обірвався).

Сценарії

1

Галочка «Товари»

2

Галочка «Замовлення»

1. Галочка «Товари» — завантажувати товари з цінами й залишками.
2. Галочка «Замовлення» — завантажувати замовлення з Walmart.

Перенести товари Walmart у Elbuz

Що ввімкнути. Заповніть «Client ID» і «Client Secret», перевірте підключення, у картці «Вибір даних для завантаження» залиште «Товари».

Що вийде. Кожен товар ляже карткою з назвою, SKU, штрихкодом, ціною в доларах, залишком і категорією за полицею Walmart. Опис, фото й характеристики додайте з іншого джерела.

Приймати замовлення й не пропускати підтвердження

Що ввімкнути. Галочку «Замовлення»; кнопкою «Статуси замовлення» зіставити коди Walmart зі своїми статусами, кнопкою «Налаштування розкладу» — запуски кілька разів на годину.

Що вийде. Нові замовлення ляжуть документами й одразу підтвердяться на Walmart. Скасування на Walmart змінить статус непроведеного документа; проведений лишиться як був.

Вести ціни в Elbuz і відправляти на Walmart

Що ввімкнути. Один раз завантажте каталог з галочкою «Товари» — він прив'яже картки до SKU. Далі в шаблоні завантаження лишіть тільки «Замовлення». Створіть шаблон вивантаження «Walmart» з галочкою «Товари», задайте ціну в доларах і розклад раз на 10–15 хвилин.

Що вийде. Зміни кожного прогону підуть одним фідом цін і одним фідом залишків. Прогін каталогу більше не перезаписуватиме ваші ціни цифрами з Walmart.

Виставити новинки

Що ввімкнути. У шаблоні вивантаження — «Публікувати нові товари». У товарів заповніть штрихкод і артикул. Для власних товарів, яких на Walmart ще немає, зіставте їхні категорії з типом товару Walmart.

Що вийде. Товари з наявною карткою стануть оферами на ній, решта піде повними картками на перевірку Walmart. Прив'язка з'явиться після того, як Walmart прийме позицію.

Що робити, коли Walmart не віддає чи не приймає дані

Часті запитання

Чи можна підключити Walmart без своїх ключів API?

Ні. Зараз підключення працює тільки ключами Client ID і Client Secret, які ви створюєте в Developer Portal (де взяти ключі).

Чому товари з Walmart прийшли без фото й опису?

Walmart не віддає їх у списку товарів. Заповніть опис і фото в Elbuz або підтягніть з прайсу постачальника (що приходить у каталог).

Ціни в каталозі в гривнях — на Walmart вони поїдуть у доларах?

Поїдуть тією самою цифрою, але як долари. Перерахуйте ціну формулою з курсом у шаблоні вивантаження (ціна й валюта).

Вивантаження пройшло, а ціна на Walmart ще стара. Чому?

Фід Walmart обробляє з затримкою, а сторінка товару оновлюється не миттєво. Результат фіду журнал покаже з наступним вивантаженням (годинний ліміт фідів).

Чи треба підтверджувати замовлення в Seller Center?

Ні, нові замовлення Elbuz підтверджує сам під час завантаження. Вручну — тільки якщо журнал написав «не вдалося підтвердити» (підтвердження).

Новинку відхилили — коли Elbuz спробує ще раз?

Не раніше ніж через добу після відмови. Виправте штрихкод або зіставте категорію з типом товару Walmart (результат публікації).

Суміжні теми

• Якщо потрібна загальна механіка завантаження — розклад, обрив, службові категорії: огляд завантаження даних.
• Якщо категорії ще не зіставлені з жодним майданчиком: зіставлення категорій з маркетплейсами.
• Якщо продаєте ще й на Amazon чи Kaufland: підключення Amazon, підключення Kaufland.
• Якщо приймаєте замовлення з кількох майданчиків: імпорт замовлень через API.