17.52. Интеграция с маркетплейсом СберМегаМаркет
СберМегаМаркет — онлайн-площадка Сбера, где продавцы (как интернет-магазины, так и розничные сети, и независимые офлайн-магазины) размещают свои товары, которые приобретаются покупателем напрямую у продавца, но через сайт СберМегаМаркет — своего рода торговый центр в интернете.
Для начала работы с маркетплейсом необходимо зарегистрироваться в качестве продавца на СберМегаМаркет и установить данный плагин интеграции в административном сайте.
Схемы работы
У СберМегаМаркет есть несколько схем работы с маркетплейсом («Витрина+Фулфилмент», «Витрина+Доставка», «Закажи и забери», «Доставка силами продавца»). Данный плагин поддерживает интеграцию по так называемой «стандартной» схеме («Витрина + Доставка»). Для корректной работы с другими схемами может потребоваться доработка.
Установка плагина
После установки плагина в административном сайте появится раздел: » Маркетплейсы » -> » СберМегаМаркет «.
Рис.17.52.1. Новый раздел в меню для СберМегаМаркет
Данный раздел содержит подразделы, связанные с основными задачами при работе со СберМегаМаркет (обновление остатков и цен, обработка заказов). При работе со СберМегаМаркет данные задачи выполняются в фоновом режиме и заходить в эти подразделы может потребоваться лишь при первоначальной настройке. В основном данные подразделы выполняют роль журналов (логов) выполнения той или иной задачи.
После установки плагина вам также станут доступны настройки плагина. Они сгруппированы таким образом, чтобы вы могли настроить интеграцию самостоятельно.
Настройки привязки товаров
После установки плагина следует первым делом настроить поле для привязки товаров.
Когда вы загружаете ассортимент товаров в СберМегаМаркет, то для каждого товара вы должны указать «код товара» / «артикул» в системе учета продавца, в нашем случае код товара в административном сайте. То есть «код товара» в СберМегаМаркет и в административном сайте должен совпадать — так устанавливается связь между товарами в административном сайте и товарами в СберМегаМаркет.
В СберМегаМаркет поле, содержащее «код товара», отображается как «Offer ID» или «Код товара продавца» (в зависимости от того в каком разделе смотреть, но это одно и то же значение).
Рис.17.52.2. Поле с кодом товара в СберМегаМаркет
В административном сайте поле, содержащее «код товара», указывается в настройках плагина в параметре «Поле для привязки товаров».
Рис.17.52.3. Настройка поля для привязки товаров
После установки плагина в параметре «Поле для привязки товаров» уже указано поле по-умолчанию: «Артикул (маркетплейсы)«. Данное поле создается автоматически и является стандартным полем привязки товаров для всех интеграций с маркетплейсами в нашей системе. Рекомендуем его не менять (оставить значение по-умолчанию), тогда на всех маркетплейсах у вас будет использоваться один и тот же «код товара».
Если по какой-то причине вы не можете использовать стандартное поле для привязки (например: у вас для каждого маркетплейса свои «коды товаров» и поле «Артикул (маркетплейсы) » уже используется для другого маркетплейса), то вы можете создать дополнительное поле для привязки товаров и выбрать его в настройках плагина в качестве поля для привязки. Дополнительное поле будет использоваться исключительно для СберМегаМаркет и не будет пересекаться с другими маркетплейсами.
Создать дополнительное поле привязки товаров, можно в настройках плагина в соответствующем разделе:
Рис.17.52.4. Создание дополнительного поля для привязки
Рис.17.52.5. Дополнительное поле для привязки создано
Заполнить для каждого товара значения («коды товара») в поле привязки можно как через стандартный редактор цен, так и через импорт (для массового заполнения).
Если у вас товары еще не загружены в СберМегаМаркет и вы планируете загружать их через товарный фид, то можно включить в настройках плагина автоматическую генерацию «кодов товаров», установив флаг «Генерировать ID предложения (артикул) автоматически«.
Рис.17.52.6. Флаг автоматической генерации кодов товаров
Если данный флаг включен, то при генерации товарного фида будут автоматически сформированы стандартные «коды товаров» вида «100270004277» и их значения будут записаны в поле привязки. Подробнее о генерации товарного фида далее в разделе «Настройка товарного фида».
Настройка товарного фида
Первый и обязательный шаг в работе с ассортиментом — загрузить товары в виде ссылки на файл в формате XML/YML или заполнить шаблон фида в формате Excel. Порядок заполнения и загрузки товарного фида вы найдете в ЛК СберМегаМаркет в разделе «Документация/Инструкции».
Вы можете настроить генерацию товарного фида в формате XML/YML. Для этого в настройках плагина предусмотрена отдельная группа параметров («Настройки товарного фида«).
Ссылки на товарный фид
Ссылки на товарный фид вы найдете в настройках плагина.
Рис.17.52.7. Ссылки на фид
Предусмотрено два вида ссылок на товарный фид:
Динамическая ссылка:
Данная ссылка генерирует товарный фид динамически (в момент обращения по ссылке). Это значит, что в товарный фид попадают самые актуальные данные. Данная ссылка удобна при небольшом количестве товаров, а так же для тестирования товарного фида в процессе его настройки. Не рекомендуется использовать на большом количестве товаров (более 1000)!
Статичная ссылка:
Данная ссылка указывает на файл товарного фида, предварительно сгенерированный и сохраненный на сервере. При обращении по данной ссылке фид не генерируется, а лишь отдает содержимое файла товарного фида, который хранится на сервере. Сам файл товарного фида обновляется при каждой публикации (для этого в настройках плагина должен быть включен флаг » Автоматическая генерация товарного фида при публикации «). Рекомендуется использовать статичную ссылку при большом количестве товаров (более 1000).
Обязательно выполните настройку и протестируйте товарный фид, перед тем как указывать ссылку на него в ЛК СберМегаМаркет! Проверить фид на корректность можно в ЛК СберМегаМаркет в разделе «Ассортимент» / «Проверка фида».
Описание параметров настройки товарного фида
Рис.17.52.8. Параметры настройки товарного фида
Выгружать в фид:
Данный параметр определяет какие товары будут выгружаться в товарный фид СберМегаМаркета:
- «Все товары» — в товарный фид выгрузятся все товары, которые есть в административном сайте (при условии, что товар не скрыт с витрины, у товара задана цена и основное фото);
- «Только отмеченные рубрики» — в товарный фид выгрузятся только товары из рубрик , отмеченных к выгрузке в СберМегаМаркет;
- «Только отмеченные товары» — в товарный фид выгрузятся только товары , отмеченные к выгрузке в СберМегаМаркет.
Обратите внимание! Товар не выгрузится в товарный фид, если у него не заполнено значение («код товара») в поле привязки. Следует либо заполнить значения в поле привязки самостоятельно, либо включить в настройках плагина флаг » Генерировать ID предложения (артикул) автоматически «, чтобы «код товара» сгенерировался автоматически.
Название магазина:
Необязательный параметр, но желательно его заполнить. Укажите, например, доменное имя вашего интернет-магазина (см. пример на скриншоте выше).
Название компании, владеющей магазином:
Необязательный параметр, но желательно его заполнить. Укажите название организации или ИП (см. пример на скриншоте выше).
Способ доставки, который используется для выгрузки условий доставки товаров (стоимость, сроки):
В товарном фиде можно указать параметры отгрузки офферов продавцом. Эти параметры будут применены ко всему ассортименту товаров. По-умолчанию при установке плагина создается фиктивный способ доставки «Условия доставки для СберМегаМаркет».
Рис.17.52.9. Условия доставки для СберМегаМаркет
При необходимости в настройках этого способа доставки вы можете указать параметры отгрузки:
- Сроки доставки (в днях);
- Время оформления заказа, до которого действуют сроки доставки.
Рис.17.52.10. Редактирование условий доставки СберМегаМаркет
Не выгружать остатки в фид:
Остатки можно передавать в СберМегаМаркет как через товарный фид, так и через API.
Включите данный флаг в настройках плагина, если планируете передавать остатки через API.
Идентификатор склада:
Скопируйте значение из ЛК СберМегаМаркет в разделе «Настройки» / «Доставка».
Рис.17.52.11. Идентификатор склада со СберМегаМаркет
Если в ЛК СберМегаМаркет у вас в поле «Идентификатор склада» стоит значение «0», то можно не указывать его в настройках плагина, т.к. это значение по-умолчанию. Также можно не указывать идентификатор склада, если вы будете обновлять остатки через АПИ.
Автоматическая генерация товарного фида при публикации :
Данный флаг активирует обновление статичного товарного фида при каждой публикации. Обязательно включите его, если в ЛК СберМегаМаркет вы используете статичную ссылку на товарный фид.
Как отметить товары / рубрики для выгрузки в СберМегаМаркет
В свойствах товара / рубрики необходимо включить флаг «Выгружать в СберМегаМаркет«.
Рис.17.52.12. Флаг выгрузки СберМегаМаркет
Проставить данный флаг массово большому количеству товаров можно через стандартный импорт.
Проставить данный флаг массово большому количеству рубрик можно используя действия с отмеченными рубриками. Отметьте необходимые рубрики в дереве каталога и выберите действие «Выгружать в СберМегаМаркет». Рубрики, выгружаемые в СберМегаМаркет, будут отмечены специальной меткой в дереве каталога.
Рис.17.52.13. Массовая установка флага выгрузки в рубриках
Исключение отдельных производителей из товарного фида
В плагине предусмотрена возможность исключить из выгрузки в СберМегаМаркет товары отдельных производителей. Например если вы отмечаете к выгрузке в СберМегаМаркет целые рубрики, но при этом требуется исключить из товарного фида товары конкретного производителя.
Для этого в справочнике производителей необходимо включить флаг «Не выгружать в Сбер» у соответствующего производителя. Товары такого производителя не будут попадать в товарный фид.
Рис.17.52.14. Исключение производителей из товарного фида
Настройка API
Данный блок параметров необходимо настроить если вы планируете работать со СберМегаМаркет через API. Настройка API выполняется одновременно в ЛК СберМегаМаркет и в административном сайте.
Важно! Вы не можете самостоятельно переключить режим работы на API — это делает сотрудник СберМегаМаркет после интеграционного тестирования. Вам нужно будет заполнить необходимые настройки API, а затем связаться с поддержкой СберМегаМаркет для прохождения интеграционного тестирования. После того как вы пройдете успешно интеграционное тестирование вас переключат на работу через API.
Настройки в административном сайте
Рис.17.52.15. Настройки API
ID личного кабинета:
Скопируйте значение из ЛК СберМегаМаркет в разделе «Настройки»/»Интеграция по API».
Авторизационный токен API:
Скопируйте значение из ЛК СберМегаМаркет в разделе «Настройки»/»Интеграция по API».
Обновлять остатки через API:
Включите данный флаг, если планируете обновлять остатки через API. Обратите внимание, если данный флаг включен, то следует включить также флаг » Не выгружать остатки в фид » в настройках товарного фида, чтобы остатки не передавались в товарном фиде!
Обновлять цены через API:
Включите данный флаг, если планируете обновлять цены через API.
Обновлять статусы заказов через API:
Данный флаг следует включить, если вы будете подтверждать заказы, комплектацию и отгрузку заказов через API (меняя статус заказа в административном сайте). Если же данные операции вы будете выполнять в ЛК СберМегаМаркет, то флаг можно не включать.
Важно! Для прохождения интеграционного тестирования данный флаг нужно обязательно включить, т.к. тестовые заказы требуется подтверждать через API. После прохождения интеграционного тестирования флаг можно будет выключить при необходимости (если подтверждать заказы будете через ЛК СберМегаМаркет).
Режим тестирования:
Данный флаг предназначен для работы с тестовой средой СберМегаМаркет. Он должен быть обязательно включен при прохождении интеграционного тестирования. Рекомендуем включить его сразу же после установки плагина и отключить только после успешного прохождения интеграционного тестирования (когда сотрудник СберМегаМаркет переключит ваш магазин на работу через API).
ID личного кабинета (тестовый):
Данный параметр вы получите у сотрудника СберМегаМаркет при прохождении интеграционного тестирования. Обязательно заполните его перед прохождением тестирования.
Авторизационный токен API (тестовый):
Данный параметр вы получите у сотрудника СберМегаМаркет при прохождении интеграционного тестирования. Обязательно заполните его перед прохождением тестирования.
Настройки в ЛК СберМегаМаркет
В ЛК СберМегаМаркет в разделе «Настройки»/»Интеграция по API» необходимо указать:
- URL к вашим сервисам для взаимодействия по API;
- Настройки авторизации.
Рис.17.52.16. Настройки API в СберМегаМаркете
Для этого скопируйте соответствующие значения из настроек плагина:
Рис.17.52.17. Данные для настроек API в СберМегаМаркете
Важно! После прохождения интеграционного тестирования рекомендуем сменить логин и пароль, чтобы не использовать в рабочей среде логин/пароль, которые использовались в тестовой среде. Нажмите кнопку «Сгенерировать новый логин/пароль» и пропишите новый логин/пароль в настройках авторизации в ЛК СберМегаМаркет.
Прочие настройки
Способ доставки по-умолчанию для новых заказов:
Задает способ доставки, с которым будут создаваться все заказы из СберМегаМаркет. Необязательный параметр.
ID покупателя по-умолчанию для новых заказов:
Все заказы из СберМегаМаркет создаются в административном сайте для одного покупателя, ID которого прописан в данном параметре. По-умолчанию при установке плагина создается специальный покупатель «Маркетплейс СберМегаМаркет» и все заказы создаются для этого покупателя.
Адрес электронной почты для уведомлений:
Укажите адрес электронной почты, на которую будут приходить уведомления, сообщения об ошибках, связанные со СберМегаМаркет.
Интеграционное тестирование
После того как у вас будет настроен товарный фид, загружен ассортимент товаров в СберМегаМаркет и выполнена настройка API, создайте обращение в службу поддержки СберМегаМаркет для прохождения интеграционного тестирования. В обращении укажите контактные данные сотрудника, который будет проходить тестирование вместе с поддержкой СберМегаМаркет. Обычно поддержка просит указать e-mail и Telegram (тестирование проходит в режиме реального времени с обсуждением в чате Telegram).
Не забудьте до начала тестирования прописать в настройках плагина параметры для тестовой среды, которые вы получите от поддержки СберМегаМаркет:
- ID личного кабинета (тестовый);
- Авторизационный токен API (тестовый) .
Работа с заказами через API
Обработка заказов СберМегаМаркет через API происходит в фоновом режиме.
В административном сайте для заказов из СберМегаМаркет используется отдельная группа статусов. При поиске заказов выбирайте правильную группу статусов, чтобы увидеть заказы из СберМегаМаркет.
Рис.17.52.18. Настройка статусов
Для каждого статуса в административном сайте указывается соответствующий ему статус в СберМегаМаркет. Соответствие статусов можно посмотреть/изменить в разделе административного сайта: «Маркетплейсы» / «СберМегаМаркет» / «Статусы заказов».
Рис.17.52.18. Настройка статусов
Т.е. когда вы в административном сайте присваиваете заказу какой-либо статус, то соответствующий ему статус будет передан в СберМегаМаркет. Статусы в СберМегаМаркет передаются не сразу, а в течение нескольких минут. При смене статуса в административном сайте дождитесь пока он передастся в СберМегаМаркет прежде чем устанавливать следующий статус.
В составе заказа предусмотрена возможность частичной отмены Лотов со стороны Продавца. Отметьте Лоты, которые не сможете отгрузить и сохраните изменения. Помните, что отмена со стороны Продавца негативно влияет на рейтинг магазина.
Рис.17.52.19. Отмена лотов и распределение по грузовым местам
Также вы можете распределить Лоты по нескольким грузовым местам (если заказ не помещается в одно грузовое место). Для этого укажите порядковый номер грузового места.
Обратите внимание, что отмена Лотов и распределение Лотов по грузовым местам выполняется до подтверждения комплектации!
!Все настройки вы можете выполнить самостоятельно, но при желании настройку могут выполнить наши специалисты «под ключ». По всем вопросам пишите в службу поддержки!
Требования к товарам
Мы стремимся к высокому качеству контента на нашем сайте, чтобы покупатель мог легко и быстро найти интересующие его товары и получить максимально полную информацию о них.
Именно поэтому мы выставляем определенные требования к описанию товаров для наших продавцов. Следуя рекомендациям, вы не только обеспечиваете быстрое прохождение модерации ваших товаров и их публикации на нашем сайте, а это, в свою очередь, способствует увеличению количества продаж.
Штрихкод производителя
Это ключевой параметр, по которому осуществляется поиск соответствий на сайте, производится сопоставление товара продавца и карточки Мегамаркет, предотвращается появление дублей одного и того же товара. У одного товара может быть одновременно несколько штрихкодов, для указания которых предусмотрено несколько полей. На этапе загрузки шаблона или сохранения карточки в интерфейсе система проверяет указанные штрихкоды на корректность. Система валидации Мегамаркет проверяет на соответствие штрихкодов следующим форматам: EAN 13, EAN 8, GTIN, ISBN.
При добавлении товара система валидации может уведомить, что загружаемая позиция с указанным штрихкодом уже существует (например, была заведена во время описания товара другим продавцом).
В таком случае, товар получит статус «Дубль».
Наведя курсор на ярлык со статусом «Дубль» в списке карточек или перейдя на детальную карточку товара, вы можете увидеть дублем какого товара она стала, и артикул Мегамаркет этого товара. По указанному коду вы можете осуществить склейку в разделе «Ассортимент» → «Сводка по ассортименту» «Подтверждение соответствия».
Товары без штрихкодов
Если вы хотите добавить товар, у которого отсутствует фактический штрихкод производителя или штрихкод не уникален (например, начинается с «2»), то в веб-интерфейсе создания карточки вы можете нажать галочку «Нет штрихкода», выбрать причину отсутствия штрихкода из списка, после чего сайт подскажет дальнейшие действия.
Код товара продавца (offer ID), Артикул товара
Код товара продавца (offer Id)
Это уникальный код товара в вашей системе, который вы передаете в фиде. На основе кода товара продавца осуществляется автоматическая «склейка» товара с карточкой на Мегамаркет после успешного прохождения товара этапа модерации. Если код товара продавца будет указан неправильно, например, вместо него будет указан штрихкод или артикул товара, то автоматическая склейка не произойдет, и вам придется осуществлять поиск соответствия вручную.
Код товара продавца НЕ должен содержать пробелы и запрещенные символы: # % ; ~ \ / . Ограничение по длине до 50 символов.
Offer id что это
Акция КиберЗима
Скидки до 40%, Улучшение тарифов
и бесплатные месяцы подписки
Реклама. ООО «Инсейлс Рус» ИНН 771484376 erid: 2Ranyma3Jrc
- Главная /
- Документация /
- Пользователям inSales /
- Товарные выгрузки /
- Выгрузка на Яндекс.Маркет (Произвольная выгрузка)
Оценки: 0
Остались вопросы?
Отправь тикет в техподдержку!
Еще нет своего магазина?
Создайте интернет-магазин на платформе inSales
Всё для продаж уже внутри!
Недавно просмотренные статьи
- О компании
- Контакты
- Тарифы
- Переезд на inSales
- Интернет-магазин «под ключ»
- Карта сайта
Каналы продаж
Возможности
По общим вопросам
Россия, звонок бесплатный
Отдел по работе с клиентами
Получение предложения по идентификатору
Возвращает ресурс предложения, соответствующий идентификатору предложения.
Предварительные требования
- Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с помощью автономных учетных данных приложения и приложения и пользователя.
- Идентификатор предложения.
C#
Чтобы найти определенное предложение по идентификатору, используйте коллекцию IAggregatePartner.Offers, установите страну или регион с вызовом ByCountry(), а затем вызовите метод ByID(). Затем вызовите метод Get() или Get Async( ).
// IAggretagePartner partnerOperations; // string countryCode; // string offerId; // retrieve the offer var offer = partnerOperations.Offers.ByCountry(countryCode).ById(offerId).Get(); Пример: тестовое приложение консоли. Проект: Класс PartnerSDK.FeatureSample: GetOffer.cs
Java
Пакет SDK для Java центра партнеров можно использовать для управления ресурсами Центра партнеров. Это проект с открытым исходным кодом, поддерживаемый сообществом партнеров и официально не поддерживаемый корпорацией Майкрософт. При необходимости вы можете получить помощь от сообщества или опубликовать проблему в GitHub.
Чтобы найти определенное предложение по идентификатору, используйте функцию IAggregatePartner.getOffers , установите страну или регион с вызовом функции byCountry(), а затем вызовите функцию byID( ). Затем вызовите функцию get( ).
// IAggretagePartner partnerOperations; // String countryCode; // String offerId; // Retrieve the offer Offer offer = partnerOperations.getOffers().byCountry(countryCode).byId(offerId).get(); PowerShell
Модуль PowerShell Центра партнеров можно использовать для управления ресурсами Центра партнеров. Это проект с открытым исходным кодом, поддерживаемый сообществом партнеров и официально не поддерживаемый корпорацией Майкрософт. При необходимости вы можете получить помощь от сообщества или опубликовать проблему в GitHub.
Чтобы найти определенное предложение по идентификатору, выполните команду Get-PartnerOffer и укажите параметры CountryCode и OfferId .
# $countryCode # $offerId Get-PartnerOffer -Country $countryCode -OfferId $offerId Запрос REST
Синтаксис запроса
| Метод | URI запроса |
|---|---|
| GET | /v1/offers/?country= HTTP/1.1 |
Параметр универсального кода ресурса
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| offer-id | guid | Y | Глобальный уникальный идентификатор, который соответствует предложению. |
| country-id | string | Y | Идентификатор страны или региона. |
Заголовки запросов
- Языковой стандарт , отформатированный в виде строки, является обязательным. Дополнительные сведения см. в статье о заголовках REST Центра партнеров.
Текст запроса
Пример запроса
GET https://api.partnercenter.microsoft.com/v1/offers/?country= HTTP/1.1 Authorization: Bearer Accept: application/json MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8 MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533 X-Locale: Connection: Keep-Alive Ответ REST
В случае успешного выполнения этот метод возвращает ресурс Предложения в тексте ответа.
Коды успешного выполнения и ошибок в ответе
Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. См. полный список кодов ошибок.
Пример ответа
HTTP/1.1 200 OK Content-Length: 1918 Content-Type: application/json MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533 MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8 Date: Mon, 23 Nov 2015 23:13:01 GMT < "id": "031C9E47-4802-4248-838E-778FB1D2CC05", "name": "Office 365 Business Premium", "description": "For businesses with 1 to 300 users that need the latest desktop version of Office, plus anywhere access to email, filesharing, and online conferencing.", "minimumQuantity": 1, "maximumQuantity": 300, "rank": 56, "uri": "/3c95518e-8c37-41e3-9627-0ca339200f53/Offers/031C9E47-4802-4248-838E-778FB1D2CC05", "locale": "en-us", "country": "US", "category": < "id": "SmallBusiness_Key", "name": "Small Business", "rank": 30, "locale": "en-us", "country": "US", "attributes": < "objectType": "OfferCategory" >>, "prerequisiteOffers": [], "isAddOn": false, "isAvailableForPurchase": true, "billing": "license", "isAutoRenewable": true, "product": < "id": "f245ecc8-75af-4f8e-b61f-27d8114de5f3", "name": "Office 365 Business Premium", "unit": "Licenses" >, "unitType": "Licenses", "links": < "learnMore": < "uri": "http: //g.microsoftonline.com/0BXPS00en/909", "method": "GET", "headers": [] >>, "attributes": < "objectType": "Offer" >>